FAQs Data Workbench SAP Hybris Cloud for Customer PUBLIC

Transcription

1 FAQs Data Workbench SAP Hybris Cloud for Customer PUBLIC

2 Table of Contents FAQS DATA WORKBENCH Why is it mandatory to select a template or an object? Can I map my ID key to the Internal ID key in SAP Hybris Cloud for Customer? Why am I unable to use a template for an extended business object? I imported data for an object but Unable to See Any Status in the Monitor view? Why do I see the error Please upload a valid CSV file in the required format? I have data in a spreadsheet. Any recommendation on how I should create a CSV file? Can I delete an existing task from the Monitor view? Why are my uploads for complete Business Objects failing? How can I assign an object to a business user? Why am I unable to see my custom object in Update workcenter view? Why do I get this error during data file upload Error occurred processing the CSV file? How do I resolve this error during data export One or more filter conditions or values exceeds the permissible limits? How do I resolve this error during data file upload Upload error; Unsupported file format? Why do I get this error in the imported error log file Record not created; Parent external key not found? Why do I get this error during data file upload for import Upload error; Remove ObjectID header in CSV file and retry? After modifying the exported CSV data file using MS Excel, the Data Workbench tools reports format validation errors; how can these errors be avoided? How to migrate new set of data into the system using Data Workbench work center? How to update/modify the existing records in the system using Data Workbench work center? How to check the status of import/export in Data Workbench work center? How to upload attachments using Data Workbench work center? What is the file size limit when we upload a zip file for attachments in Data Workbench work center? How to re-use the file which has failed during the import? How the date format should be filled in CSV file while importing? How to delete Task from Monitor View? How to download the file which has value as 001 or 002 in any of the fields while exporting? How to export Attachments using Data Workbench work center? Is it possible to Delete the mapping between Source and Target fields while Importing the file? Why can't all users view All Tasks under Monitor view in Data Workbench work center? Is it possible to Uncheck or Nullify the Checkbox field for a given Business Object using Data Workbench work center? What is the timespan of files on the Monitor Tab? What is the functionality of Ignore Blank Values and Update Blank Values in Update view in Data Workbench work center? Is there any Timeout parameter for files which run longer than expected? How to download Code List Mapping Template?

3 34. Why "Use Existing Account" Field is Missing While Creating Leads Through Data Workbench? Why there is no objects are available in Import tab? What is the usage of External Key in Data Workbench? Can External key field be left as blank for Import scenario in Data Workbench? How to retrieve External Keys for an Object if you forgotten the External Key which you have used in Import? How can specific records be deleted? How to manage multiple CSV in a ZIP as part of full BO import? How to handle large data volumes for data migration?

4 FAQS DATA WORKBENCH 1. Why is it mandatory to select a template or an object? The template or the object defines the data that is imported into SAP Hybris Cloud for Customer. For example, if you want to import customer data, then you either choose the Customer object or the Customer template. The system pre-validates the files with metadata check. For example, if you choose a Customer template and then choose an Order CSV file, you will receive an error, and will not be able to proceed with the import. 2. Can I map my ID key to the Internal ID key in SAP Hybris Cloud for Customer? We recommend that you do not map any columns from the CSV file to internal ID key. 3. Why am I unable to use a template for an extended business object? There can be two situations where extensions have been made: You have added more fields to your CSV file. These fields may or may not be available in the standard object in SAP Hybris Cloud for Customer You have extended SAP s standard business object with new fields. In both these situations, you cannot use an existing template. If there are any changes to the fields on SAP Hybris Cloud for Customer or in the CSV files, you must create a new template, or modify existing template along with all required mappings, from Data Workbench Templates work center view. 4. I imported data for an object but Unable to See Any Status in the Monitor view? Ideally, you should see a success or failure status for each import. At times, there might be a delay. Wait for a few minutes, and then click Refresh in the Monitor view. If the status still does not appear, create a support incident. 5. Why do I see the error Please upload a valid CSV file in the required format? This can happen, if the: Order of the fields in the CSV file does not match the order of the fields in the SAP Hybris Cloud for Customer object Field names have a space in the CSV file Open the CSV file, check the order of the fields, and remove any spaces in the column headings, and retry importing data. 6. I have data in a spreadsheet. Any recommendation on how I should create a CSV file? The key requirement is to have your data in CSV file with UTF-8 encoding. UTF-8 format ensures that files containing non-english characters and special characters are secured in its original form, and do not get converted into special characters. Let us assume that you have your data in a Microsoft Excel spreadsheet. Save the spreadsheet in the Comma delimited CSV format, using File Save As menu option. Files are usually saved in ANSI format. To ensure that your CSV file is saved with UTF-8 encoding, follow the steps described in the Technical section under Basic Checklist (in the Data Workbench User Guide chapter). 4

5 7. Can I delete an existing task from the Monitor view? Tasks which are in Finished status, can be deleted from the Monitor view. To delete, select the task and click Remove. 8. Why are my uploads for complete Business Objects failing? You may be using an older metadata template for upload. Please use the latest one. 9. How can I assign an object to a business user? OData Service has the workcenter view assigned at the entity level. The key user must assign the same workcenter view to the business user. 10. Why am I unable to see my custom object in Update workcenter view? Your custom object may not be marked as updatable in your metadata. Please ensure the metadata for your custom object in OData Service is sap:updatable="true". Note: Only nodes which are creatable or updatable are available in Import or Update respectively. In Import template, only creatable or updatable fields are available. Only filterable properties are available in Export. 11. Why do I get this error during data file upload Error occurred processing the CSV file? This error occurs if the CSV data file MIME type is other than following supported: text/comma-separated-values text/csv application/csv application/excel application/vnd.ms-excel application/vnd.msexcel text/plain 12. How do I resolve this error during data export One or more filter conditions or values exceeds the permissible limits? Reduce the export filter conditions, and export data 13. How do I resolve this error during data file upload Upload error; Unsupported file format? The CSV data file should be UTF-8 encoded 14. Why do I get this error in the imported error log file Record not created; Parent external key not found? This error occurs, if the parent external key maintained for business object sub-node record is not present in the parent node data file. 5

6 15. Why do I get this error during data file upload for import Upload error; Remove ObjectID header in CSV file and retry? This error occurs if the exported data file is uploaded for import; instead the exported data file should be uploaded by selecting import operation as Update. 16. After modifying the exported CSV data file using MS Excel, the Data Workbench tools reports format validation errors; how can these errors be avoided? Follow these steps if modifying records in CSV data file using MS Excel application: 1) Open MS Excel and select Data tab in the menu bar. 2) Inside the Data tab, clock on From Text option, select the desired file from the file system and click on the Import button. 3) On the Step 1 of Text Import Wizard click on the radio button Delimited, select Unicode(UTF-8) from the File origin drop down and tick the checkbox My data has headers. Now click the Next button. 4) On the step 2 screen, select the delimiter for you file and click on the Next button. Note: The delimiter for a file exported form Data Workbench is comma. 5) On the step 3 screen of the wizard, in the Data preview section, with the help of Shift key on the keyboard, select all the columns. After the whole data preview section is highlighted from the selection, click on the Text radio button in Column data format section and Click on the Finish button. 6) After clicking finish, the import dialog will appear. Please select the first cell of the excel sheet (as indicated in screenshot below) and click the Ok button. 7) To save this document after making changes, click on File in the tool bar, then click on the save button. After selecting a desired directory and file name, select CSV UTF-8 option in the type drop down under the file name option and click on save button. 17. How to migrate new set of data into the system using Data Workbench work center? To import new data into the system please follow the below steps 2. Select Import 3. Select any Object 4. Select Download CSV file Add the data in the template then follow the below steps 2. Select Import 3. Select any Object 4. Select Next 5. Upload the template 6. The fields would be auto-mapped by the tool as you have selected an object template file. You need to review the mapping before proceeding to next import step. 7. Select Import 6

7 18. How to update/modify the existing records in the system using Data Workbench work center? To update the existing data in system, please follow the below steps 2. Select Export View 3. Select any Object 4. Select Next 5. Select Export Data Add the values which needs to be modified/updated in the template and then follow the below steps 2. Select Update 3. Select the Object 4. Select Next 5. Upload the template 6. Select Import 19. How to check the status of import/export in Data Workbench work center? You can check the status of your import and export by following the below steps 2. Go to Monitor View In this view, you can check the progress/status of the file and also you can download the respective exported file. 20. How to upload attachments using Data Workbench work center? To upload attachment please follow the below steps 2. Select Import view 3. Select Import Attachment 4. Select the respective Object 5. Select Download manifest file You can then fill the template with the path where the attachments are kept and then copy the template to the same folder and then zip the folder Note: Please make sure you name of the template as manifest.csv 2. Select Import view 3. Select Import Attachment 4. Select the respective Object 5. Select Next 6. Upload the zip file 7. Select Import 7

8 21. What is the file size limit when we upload a zip file for attachments in Data Workbench work center? The size of the zip file should not exceed more than 100 MB and size of each attachment in it should not exceed 10MB. 22. How to re-use the file which has failed during the import? You can download the file from Monitor view and remove the first column Row ID and last column which contains Error and then you can Import the file again using Import view. 23. How the date format should be filled in CSV file while importing? The date format should be filled in YYYY-MM-DDTHH:MM format. 24. How to delete Task from Monitor View? You can select the respective Task and then you can select Remove. 25. How to download the file which has value as 001 or 002 in any of the fields while exporting? When you open the file with MS Excel, the leading zeros will be truncated. So, you can open it in any standard text file to keep the leading zeros. 26. How to export Attachments using Data Workbench work center? It is not possible to Export Attachment for any object using Data Workbench work center. You can only Import new attachments for an object using the Import View. 27. Is it possible to Delete the mapping between Source and Target fields while Importing the file? You can Delete the mapping between Source and Target fields by following the below steps OR 1. Select the link between the Source and Target fields 2. Right Click 3. Select Delete 1. Select the link between the Source and Target fields 2. Select Delete button in your keyboard 28. Why can't all users view All Tasks under Monitor view in Data Workbench work center? Only Key Users have access to All Tasks in Monitor view under Data Workbench work center. 8

9 29. Is it possible to Uncheck or Nullify the Checkbox field for a given Business Object using Data Workbench work center? Nullify/Unchecking of the Checkbox field for a given Business Object, is possible using Update operation available for Import of Individual Objects, under Data Workbench work center and Import work center view. In the exported data file, leave the values for the object field blank, and select update mode Update Blank Values. 30. What is the timespan of files on the Monitor Tab? The file will automatically disappear from Monitor view after Three months 31. What is the functionality of Ignore Blank Values and Update Blank Values in Update view in Data Workbench work center? Ignore Blank Values: Once you choose this option it will ignore all the blank values provided for a specific field in the csv file and these fields will not be impacted after import. Update Blank Values: Once you choose this option it will accept all the blank values provided for a specific field in the csv file and these will be updated after import. 32. Is there any Timeout parameter for files which run longer than expected? Yes, its 6 hours. If any file which crosses 6 hours, then the status of the file changes to Interrupted 33. How to download Code List Mapping Template? Code List mapping template can be downloaded only during file processing in mapping screen. 34. Why "Use Existing Account" Field is Missing While Creating Leads Through Data Workbench? There is no such separate flag in Data Workbench, you can just use the Account ID / Contact ID and then it will use the one which is available in the system. 35. Why there is no objects are available in Import tab? The Data Workbench uses the assignment of the view ITS_KEYUSERCHANGELOG to differentiate between business users and key users. If a user is not assigned to that view, then the user is identified as a Business User. Business Users can only perform Imports via templates, when Key Users have all the options available. If you don't want to assign the work center view ITS_KEYUSERCHANGELOG to certain users, you can create Templates using a Key User from the "Template" work center view in Data Workbench, this template can then be used by other users to perform data imports. 36. What is the usage of External Key in Data Workbench? External Keys should be provided in the Import template for each Import Object in Data Workbench. External Keys should be kept as unique for each record during Import scenario for a specific object. 9

10 37. Can External key field be left as blank for Import scenario in Data Workbench? You can keep the External Key field can be kept as blank for the Import scenario. We always recommend you to fill External Key field during Import scenario is because then it will easier for you to Import sub objects using the External Key of Parent Object Example: You have imported Account with External Key using the Object Accounts and now if your requirement is to Import Account Team for that specific Account then you can use the External Key in the field AccountExternalKey to import the records easily. 38. How to retrieve External Keys for an Object if you forgotten the External Key which you have used in Import? The Import task will be available in the Monitor view for 3 months and after that it will be deleted. We would always recommend you keep the original files locally which you have used in Import so that you can have a track of all the External Keys used. 39. How can specific records be deleted? To delete specific records in SAP Hybris Cloud for Customer system, first export data by providing relevant filters, add an additional header ToBeDeleted at end of the exported CSV data file, and mark the records to be deleted as true. Submit this modified file for Update operation from Import work center view. 40. How to manage multiple CSV in a ZIP as part of full BO import? 1. Select the object and download the metadata ZIP file and save in local file system 2. Extract files from ZIP file in local file system 3. The folder CodeList contains code list property values for all relevant code list properties for this object. The folder FieldDefinition, contains meta information of business object nodes. The folder Templates contains template CSV files for each business object node; For data import, data should be entered in these template files. 4. It is mandatory to fill the ExternalKey column for all template files, & also the parent ExternalKey for sub-node template files, along with business data. Note: If the parent external key is either not maintained or wrongly maintained, the record will be unprocessed. 5. The template CSV files for which data is maintained, should be archived in a ZIP file. 6. This ZIP file can now be uploaded for data import. 41. How to handle large data volumes for data migration? Data Workbench tool allows import of data file size of 10MB and maximum 50K records; For data migration beyond 50K records or if the data file size exceeds 10MB, the data from legacy system should be split into multiple data files and imported using data workbench. To achieve high performance throughput, recommendation is to import maximum 2 data files at a time. 10

11 SAP SE or an SAP affiliate company. All rights reserved. No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP SE or an SAP affiliate company. The information contained herein may be changed without prior notice. Some software products marketed by SAP SE and its distributors contain proprietary software components of other software vendors. National product specifications may vary. These materials are provided by SAP SE or an SAP affiliate company for informational purposes only, without representation or warranty of any kind, and SAP or its affiliated companies shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP or SAP affiliate company products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty. In particular, SAP SE or its affiliated companies have no obligation to pursue any course of business outlined in this document or any related presentation, or to develop or release any functionality mentioned therein. This document, or any related presentation, and SAP SE s or its affiliated companies strategy and possible future developments, products, and/or platform directions and functionality are all subject to change and may be changed by SAP SE or its affiliated companies at any time for any reason without notice. The information in this document is not a commitment, promise, or legal obligation to deliver any material, code, or functionality. All forward-looking statements are subject to various risks and uncertainties that could cause actual results to differ materially from expectations. Readers are cautioned not to place undue reliance on these forward-looking statements, and they should not be relied upon in making purchasing decisions. SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP SE (or an SAP affiliate company) in Germany and other countries. All other product and service names mentioned are the trademarks of their respective companies. See for additional trademark information and notices.