SAP Hybris Cloud for Customer – Import Attachments with the Data Workbench

Hi C4C community,

This blog post explainins how to import attachments with the Data Workbench. Please make yourself familiar with the SAP Hybris Cloud for Customer Data Workbench User Guide and the Data Workbench FAQ before you start with the import of attachments with the Data Workbench.

Steps to perform

1. Navigate to the WCView Import in WoC Data Workbench and select option Import Attachment.

Select an object for which you want to import attachments and download the manifest file for the selected object.

2. Rename the downloaded file to manifest.csv and save it in a folder where the attachments are located that you want to upload.

3. Open the downloaded file in MS Excel to maintain the records.

The header of the CSV file is clubbed in the first column. In order to split it to the columns, select the first column and select function Text to Columns in the Data tab.

4. In the first step of the wizard select file type Delimited, and select Comma as delimiter in the second step. Confirm the wizard by pressing Finish.

Recommendation: Excel tries to interpret your data and apply a format accordingly. In most cases when you are dealing with upload file, you don’t want any formatting. To avoid that, I recommend to select all cells (by clicking on the upper left corner), select option Format Cells in the context menu (right click on any selected cell) and select Category Text in the first tab.

5. Now you can fill the manifest file with the data for your attachments, 1 record per attachment.

Check the Data Workbench User Guide for details on how to use the fields […]ExternalKey and […]InternalID.

TypeCode: Type of the attachment. TypeCode for type Standard Attachment is 10001. If you want to use one of the other type available for Account attachments, check the list of attachment type codes at the end of the blog post.

AttachmentName: Name shown in the attachment list in C4C.

MimeType: Media type of the attachment file. You can check and maintain the list of allowed MIME types in your C4C tenant in the business configuration activity Allowed MIME Types for Document Upload.

Path: Path to the attachment file relative to the manifest file in the archive, with “/” as path separator.

Example: In my example the attachment file “1000290_attachment1.jpg” is in a subfolder “Files” relative to the manifest file. Therefore I need to specify  the path as “Files/1000290_attachment1.jpg”. If the file would reside next to the manifest file, I would need to specify the path as “1000290_attachment1.jpg”.

6. Once all records are maintained, save the file in a CSV format.

In many cases Excel delimits the values in CSV files with a semicolon, but for the Data Workbench the delimiter must be comma. Therefore open the saved file with an text editor (e.g. Notepad), replace all semicolons by commas and save the file.

Note: Name of the manifest file must be “manifest.csv”.

7. Create a zip archive containing the manifest file and the attachments.

Important: The size if the zip archive must not exceed 100 MB, and size of each attachment must not exceed 10 MB.

8. Navigate again to the WCView Import in Worcenter Data Workbench and select option Import Attachment, select the object for which you downloaded the manifest file in step 1 go to the next step.

Upload the zip archive and review the sample records.

9. In the next step you can change the task name of the import run and trigger the import.

10. The import runs asynchronously. In order to check the status of the import, navigate to the WCView Monitor.

Once the import run is completed, the status changes from In Process to Finished. You need to refresh the view manually, by pressing the Refresh button.

Inthe list you see the total number of records, successfully uploaded and erroneous records in the import run. In case of errors, you can click on the number to get a list of errors. For details check Data Workbench User Guide.

11. The last step is a spot check if the import really worked. Navigate to the attachments section of the object you specified in the manifest file and check if the file is uploaded correctly and has the specified name.

Available Attachment Type Codes

Note: Many type codes can be used only for specific objects. Check in the object if the used type codes are permitted for the object. Otherwise the import will run into an error. In the error CSV file, which you can download from the monitor, you can check the processing error and correct your manifest file.

You can lookup the list in your C4C development tenant with the Repository Explorer in the Cloud Applications Studio (PDI), Data Type: DocumentTypeCode (Namespace http://sap.com/xi/AP/Common/GDT)