How to...

MDG-M: Use the Data Import Framework with a CSV File

Applicable Releases:
EhP6, MDG 6.1

Version 2 February 2013

www.sap.com

Document History
Document Version 1.00 Description First official release of this guide

How to... MDG-M: Use the Data Import Framework with a CSV File

TABLE OF CONTENTS
1. 2. 3. 4. 4.1. 4.2. 4.3. BUSINESS SCENARIO .................................................................................................................... 4 BACKGROUND INFORMATION ...................................................................................................... 5 RECOMMENDATION FOR MATERIAL CREATION FROM CSV FILE .......................................... 6 DATA IMPORT FRAMEWORK USING CSV FILE ........................................................................... 7 File Converter Type ......................................................................................................................... 7 BAdI................................................................................................................................................... 8 Test.................................................................................................................................................. 11

How to... MDG-M: Use the Data Import Framework with a CSV File

1. BUSINESS SCENARIO SAP Master Data Governance for Material (MDG-M) provides business processes to find, create, change, and mark material master data for deletion. It supports the governance of material master data on a central hub and the distribution of material master data to connected operational and business intelligence systems. The processes are workflow-driven and can include several approval and revision phases, including collaboration between all users participating in master data maintenance. You can use the Import Master Data service to import files containing material and classification data to the Master Data Governance system. You can also import key and value mapping information. The data from these files can update existing master data records or create new ones using the options available in the Import Master Data service. This guide describes how to use the Data Import Framework to upload material data from a CSV-file using a BAdI for the file conversion.

How to... MDG-M: Use the Data Import Framework with a CSV File

2. BACKGROUND INFORMATION Documentation for Data Transfer in EhP6: http://help.sap.com/erp2005_ehp_06/helpdata/en/93/5497f5ad4d431c8492b45ba7f5edbb/content.htm Data transfer represents a collection of functions and features that enable you to move master data and mapping information between systems and clients. Examples of these systems include existing ERP systems and your Master Data Governance hub system. To transfer master data and mapping information, follow this process: 1. Export the master data and mapping information from the source system to an XML file. This file rests on your application server. 2. Copy the XML file from the application server of the source system to the application server of your target system. 3. Import the master data and mapping information to the target system.

The Master Data Governance for Material business functions support only the import and monitoring of material master data and key mapping information.

How to... MDG-M: Use the Data Import Framework with a CSV File

3. RECOMMENDATION FOR MATERIAL CREATION FROM CSV FILE 1. To change/create a small number of entities in staging, use the standard file upload function (USMD_FILE_UPLOAD) 2. Use the Data Import Framework (DIF) with converter to create a complete material in the staging area a. SAP Note for Example implementation: 1819039 b. Additional necessary SAP Note: 1780815 c. Note: All governance relevant entities are created for the given keys (plant, distribution chain, and so on.) d. This results potentially in a large maintenance status e. This can result in additional mandatory fields, for example, Weight UOM for the sales view. 3. Other alternatives such as a custom program using direct input or LSMW exist if you want to create a complete material in the active area. The following chapters describe the option 2 with the Data Import Framework (DIF).

How to... MDG-M: Use the Data Import Framework with a CSV File

4. DATA IMPORT FRAMEWORK USING CSV FILE Some configuration is necessary to use the Data Import Framework for uploading material data from a CSV file. Follow the steps shown in the screenshots below to define a new custom converter type and to create a BAdI implementation.

4.1. File Converter Type

How to... MDG-M: Use the Data Import Framework with a CSV File

4.2. BAdI

Enhancement Sport: MDG_FILECONVERTER BAdI Definition: BADI_MDG_FILECONVERTER BAdI Implementation (Example Implementation): SAP Note 1819039

How to... MDG-M: Use the Data Import Framework with a CSV File

How to... MDG-M: Use the Data Import Framework with a CSV File

Set the filter with your new converter type:

10

How to... MDG-M: Use the Data Import Framework with a CSV File

4.3. Test For testing you can use this .csv file:

To upload a .csv file use the standard UI for importing Master Data and select the custom converter to handle the CSV file.

11

How to... MDG-M: Use the Data Import Framework with a CSV File

If the end user loads the CSV file directly from the front end, his role must contain the configuration MDG_FILE_UPLOAD_CMP_CONF_ID.

12

www.sap.com

2013 SAP AG. All rights reserved. SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP BusinessObjects Explorer, StreamWork, SAP HANA, and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and other countries. Business Objects and the Business Objects logo, BusinessObjects, Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius, and other Business Objects products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of Business Objects Software Ltd. Business Objects is an SAP company. Sybase and Adaptive Server, iAnywhere, Sybase 365, SQL Anywhere, and other Sybase products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of Sybase Inc. Sybase is an SAP company. Crossgate, m@gic EDDY, B2B 360, and B2B 360 Services are registered trademarks of Crossgate AG in Germany and other countries. Crossgate is an SAP company. All other product and service names mentioned are the trademarks of their respective companies. Data contained in this document serves informational purposes only. National product specifications may vary. These materials are subject to change without notice. These materials are provided by SAP AG and its affiliated companies ("SAP Group") for informational purposes only, without representation or warranty of any kind, and SAP Group shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP Group 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.