sap how-to guide: develop a custom master data...
TRANSCRIPT
SAP COMMUNITY NETWORK scn.sap.com
© 2012 SAP AG 1
SAP How-To Guide: Develop a
Custom Master Data Object in SAP
MDG (Master Data Governance)
Applies to:
SAP Master Data Governance running on SAP ERP 6 EhP 6 Master Data Governance. The Guide can also be used within EhP5 with some restrictions mentioned in the guide. For more information, visit the Master Data Management homepage.
Summary
Many companies want to manage custom objects in a central Master data system to be able to harmonize this information across the landscape. Custom objects can be individual defined objects such as assets or locations. Custom objects are typically less complex master data object with a small and simple data model. They are often used as reference data in major objects such as material, suppliers and customers.
This How-To Guide describes the necessary steps to implement a custom object in SAP MDG. The guide is based on an object called “Location” and includes the following steps during the implementation phase:
- Create a new Data Model - Define a new Business Object and Activity - Create a custom User Interface - Process Modeling - Test of the custom object
The audience of this document can be customers, technology consultants and architects.
Author: Steffen Ulmer
Company: SAP AG
Created on: June 22, 2012
Version: 1.1
Author Bio
Steffen Ulmer is a SAP Principal Consultant who works at SAP (Schweiz) AG. In this role he has been a trusted advisor for several large enterprises on topics and product like: SAP NetWeaver Master Data Management, SAP BPM/BRM, SAP Business Object Information Steward, Web Dynpro Java development and SAP NetWeaver Portal. Presently he is working within the SAP
MDG Product Management Team on a study for cross system workflow monitoring and visualization.
SAP How-To Guide: Develop a Custom Master Data Object in SAP MDG (Master Data Governance)
SAP COMMUNITY NETWORK scn.sap.com
© 2012 SAP AG 2
Table of Contents
Introduction ......................................................................................................................................................... 3
Prerequisites ....................................................................................................................................................... 3
Scenario .............................................................................................................................................................. 3
High Level Requirements ................................................................................................................................ 4
Data Model ...................................................................................................................................................... 4
Governance process ....................................................................................................................................... 4
Implementation ................................................................................................................................................... 4
Definition of the Data Model, Business Object and Business Activity ............................................................ 5 Create new data model ................................................................................................................................................ 5
Define Business Object ................................................................................................................................................ 7
Create Business Activity .............................................................................................................................................. 8
Create User Interface ...................................................................................................................................... 9
Definition of Change Request Type & Workflow assignment ....................................................................... 16
Run and Test the MDG Custom Object ............................................................................................................ 19
Additional Information ....................................................................................................................................... 21
View generated Data Model .......................................................................................................................... 21
Display data in staging table ......................................................................................................................... 22
Delete a Data Model ..................................................................................................................................... 22
Appendix ........................................................................................................................................................... 23
Create a new data model in View Cluster of MDGIMG ................................................................................ 23
Related Content ................................................................................................................................................ 24
Copyright........................................................................................................................................................... 25
SAP How-To Guide: Develop a Custom Master Data Object in SAP MDG (Master Data Governance)
SAP COMMUNITY NETWORK scn.sap.com
© 2012 SAP AG 3
Introduction
SAP Master Data Governance is a Master Data Management solution within the Business Suite and is integrated into the ABAP Application Server of SAP. I already wrote several articles and How-To Guides in the SAP NetWeaver MDM space on the topics “Governance Process in MDM” or “How.To configure customer specific data model and corresponding processes”. You can see a list of these articles and blogs in my SDN profile.
I really think that lots of you will have similar requirements in a MDG based environments and lots of you want to develop custom objects and processes which are not (and cannot be) delivered within the standard content.
This document will describe how to develop a custom object in SAP MDG. It will show you in some very basic steps what you have to do to
Get your own data model into the system,
Configure your own User Interface with the FPM (Floor Plan Manager),
Reuse a preconfigured Business Workflow within your own Change Request Type and finally
How to test your new custom object.
It’s planned to release more of these MDG How-To guides and this article can be seen as the starting point or basic documentation. In following documents topics like “Configure individual UIs per workflow steps” and “Build a custom Search & Display UI” will be explained on top of the process which is developed in this guide.
Prerequisites
For this How-To Guide you should have access to a Sandbox of your MDG Hub Application Server with appropriate access rights. You need access to the MDG-Hub client and to the client in which you do the cross system configurations.
The ERP System must run on EhP (Enhancement Package) 6.
You need some basic understanding in:
SAP MDG
SAP Business Workflow
SAP Floorplan Manager (FPM)
Scenario
Let`s assume that you have already successfully implemented the SAP MDG standard objects such as Material, Suppliers, Financials and Customers. You are replicating this data to several ERP and None ERP System for the usage within transactional matters.
Your business department is generally happy with the solution but they have an issue with some of the reference data. Reference data is information which is used within master data objects itself or in transactions or programs as supporting information. In SAP NetWeaver MDM such data is typically stored in lookup tables. An example of such reference data is
- the list of plants which is used to assign a material or products to a physical facility, or - the list of countries which is used within many transactions and referenced in many data models.
Your business users identified that these lists of valid reference data is not harmonized within the landscape. This gap causes issues regarding data quality which ends up in inefficient business processes. A concrete example is the information object “location” which is a valid list of geographical places where the company can have plants, unloading points or just generally assets.
SAP How-To Guide: Develop a Custom Master Data Object in SAP MDG (Master Data Governance)
SAP COMMUNITY NETWORK scn.sap.com
© 2012 SAP AG 4
High Level Requirements
The business requests the following:
1. A central system in which the valid list of values for locations is managed, 2. A governance process to be able to carefully add or change location objects and 3. A web based application to enter and govern the data in a User Interface.
Data Model
The data model of the object location includes:
- Unique ID - Name of the location - Country - City - ZIP Code - Street (incl. House Number) - Description
The Unique ID and the Name are mandatory fields and must be entered.
Governance process
The governance process is as well simple and includes only a 3-Step approval. The following graphic explains the governance process on high level:
Implementation
This implementation process consists of the following main points:
1. Definition of the Data Model, Business Object and Business Activity 2. Creation of the User Interface 3. Definition of Change Request Type & Workflow assignment
Data Modeling in MDG is fundamentally different to what you might know from SAP NetWeaver MDM because MDG is built with ABAP technology and hence you can reuse all the data structures which are already defined in your Data Dictionary. Of course you can also define new elements in case you need to do so.
If you want to compare a MDG Data Model with a NetWeaver MDM Model, you can say that:
A MDG Data Model is like a repository in NW MDM .
Please notice that in MDG a Data Model is more like a namespace and you can create as much
Entities as you want within one data model. For instance you can create one data model which
includes more than 20 Entity Type of Type 1 or others. You do not have to create multiple data
models.
A MDG Entity Type is like a table in NW MDM
o SU Type 1 is like a Main table
Requestor: Enter location data
Data Steward: Review & Enrich
location data
Approver: Review & Approve
SAP How-To Guide: Develop a Custom Master Data Object in SAP MDG (Master Data Governance)
SAP COMMUNITY NETWORK scn.sap.com
© 2012 SAP AG 5
o SU Types 4 are dependent Entities on Type 1 as you might know it from a UML composition.
You can only maintain data in the context of a type 1 entity.
o Relationships are really relationships between data base tables.
MDG Entity Type Attributes are like fields of a table in NW MDM.
Most of the settings in this guide are done in the MDGIMG transaction which is the central entry point for the configurations in MDG.
Definition of the Data Model, Business Object and Business Activity
This guide is showing EhP6 functionality. It uses the newly introduced Configuration Workbench. You can do the same configurations in the “View Cluster” which is accessible through the MDGIMG transaction. If you use the View Cluster you can do the same in a EhP5 environment.
Create new data model
1. Start SAP GUI and login into cross system client
2. Start transaction MDGIMG
3. Start Configuration
Workbench
Attention: In EhP5 no
Configuration Workbench is
available. You should use
the View Cluster functionality
in Data Modeling to do the
data modeling.
4. Click on to create a new data model
* Please check the appendix Create a new data model in View Cluster of MDGIMG, If you want to create a new data model in the View Cluster
SAP How-To Guide: Develop a Custom Master Data Object in SAP MDG (Master Data Governance)
SAP COMMUNITY NETWORK scn.sap.com
© 2012 SAP AG 6
5. Enter Data Model and Description. Choose a data model of the customer namespace (e.g. ZK). Please remember this code since it will be used almost all the time within this guide.
Leave the Reuse Active Area empty.
Click on Save
6. If not already done: Go to Edit Mode
7. In this example we will only model one Entity Type.
Click on NEW and enter the 3 values:
Entity Type
SU Type
Data Element
SU Type 1 is for this main object type
The Data Element ORTID is an element which already exists in the Data Dictionary and which fits well to the requirements. (se11)
Data Element on this level
should be maintained and is
the KEY field of this table
8. Define new attributes like columns of the table. Typically reference to existing data dictionary entries
Click on Tab Attributes and use the New button to create the attributes. The attribute Data Element type can be checked in Data Dictionary
9. Save and activate Data
Model
SAP How-To Guide: Develop a Custom Master Data Object in SAP MDG (Master Data Governance)
SAP COMMUNITY NETWORK scn.sap.com
© 2012 SAP AG 7
Define Business Object
This step is still in the cross system client.
1. Start “Define Business
Objects”
2. New Entries & Enter the
Name for your Business
Object ZK_BO1
3. Save
SAP How-To Guide: Develop a Custom Master Data Object in SAP MDG (Master Data Governance)
SAP COMMUNITY NETWORK scn.sap.com
© 2012 SAP AG 8
Create Business Activity
This step is still in the cross system client.
1. Start Create Business
Activity
2. New Entries & Enter the
Name for your Business
Activity
3. Save
SAP How-To Guide: Develop a Custom Master Data Object in SAP MDG (Master Data Governance)
SAP COMMUNITY NETWORK scn.sap.com
© 2012 SAP AG 9
Create User Interface
This step is still in the cross system client.
In this step you will create a User Interface for the newly created Data Model. No coding is necessary for this step. You will use the SAP Floorplan Manager to configure a Web Dynpro ABAP UI on top of your Data Model. This basic How-To Guide will only cover the configuration of a simple UI.
1. Start Edit UI Configuration from the MDGIMG. The application will open in an Internet Browser Window.
2. Click on Create to start the
configuration
An additional pop up will
appear
3. Change Target
Configuration ID:
Change Target Configuration
ID to a custom name as
described on the screenshot
4. Click on Start Deep-Copy
button
5. Save as local object
In this How-To guide the
object is saved as a local
object.
The System will now copy
the template as the new
application
SAP How-To Guide: Develop a Custom Master Data Object in SAP MDG (Master Data Governance)
SAP COMMUNITY NETWORK scn.sap.com
© 2012 SAP AG 10
6. After success: Open the
configuration screen for the
outer application by clicking
on the link in the column
Target Configuration ID
A pop up will appear
7. Switch to Edit Mode and
Enter USMD Model: Click on
Edit and then do the
following changes:
Enter the USMD Model
Inspect the other setting while leaving them on the default setting
8. Click on Save on the upper
left hand side
9. Open the OIF Component
SAP How-To Guide: Develop a Custom Master Data Object in SAP MDG (Master Data Governance)
SAP COMMUNITY NETWORK scn.sap.com
© 2012 SAP AG 11
10. The system will display a
screen like the following one
11. Click on the left hand side:
NavigationNewVariant
12. Delete old variants:
The wizard has created 2
Variants by default: You
should delete these two
variants
13. Confirm the deletion
SAP How-To Guide: Develop a Custom Master Data Object in SAP MDG (Master Data Governance)
SAP COMMUNITY NETWORK scn.sap.com
© 2012 SAP AG 12
14. Open UIBB
15. Enter a name for the
Component like
ZK_Config_01. The system
will inform you that this
component does not yet
exists
Attention: In EHP5 you must
not use the component
FPM_FORM_UIBB_GL2.
You should use
FPM_FORM_UIBB instead.
16. Delete old UBB
17. Select a Form Component
SAP How-To Guide: Develop a Custom Master Data Object in SAP MDG (Master Data Governance)
SAP COMMUNITY NETWORK scn.sap.com
© 2012 SAP AG 13
18. Save
The error message is expected. You will create the configuration in the next steps
19. Configure UBB
20. In popup click on new
21. Enter a description and add to LOCAL OBJECT
Click on OK on pop up
22. Enable Attribute viewing
SAP How-To Guide: Develop a Custom Master Data Object in SAP MDG (Master Data Governance)
SAP COMMUNITY NETWORK scn.sap.com
© 2012 SAP AG 14
23. Scroll down and add a Element Group
24. Enter a name/ heading for the group and add a elements at Next Level within group
25. Select the attributes you want to see of Location
SAP How-To Guide: Develop a Custom Master Data Object in SAP MDG (Master Data Governance)
SAP COMMUNITY NETWORK scn.sap.com
© 2012 SAP AG 15
26. Configure the UI Element as you want using Floor Plan Manager
27. SAVE & Back to IDR
28. Save
SAP How-To Guide: Develop a Custom Master Data Object in SAP MDG (Master Data Governance)
SAP COMMUNITY NETWORK scn.sap.com
© 2012 SAP AG 16
Definition of Change Request Type & Workflow assignment
This step is client specific: Please login into the corresponding MDG-Hub client.
In this step you will do the process modeling for the new custom object. This How-To Guide uses a pre-defined workflow definition which is shipped with the MDG application itself.
The workflow WS75700040 has the following setup. (High Level diagram)
1. Start MDGIMG and Create
Change Request Type
2. Add new Entry & Enter
Details as mentioned
3. Create Entity Types
Select the new entry
and double click on
Entity Types
Enter the value
LOCATION
Enter the value
Enter/ Change Master Data
Review/ Enrich Master Data
Review and Approve Master Data (Read Only)
End
SAP How-To Guide: Develop a Custom Master Data Object in SAP MDG (Master Data Governance)
SAP COMMUNITY NETWORK scn.sap.com
© 2012 SAP AG 17
ZO_SU_APPL as
the Configuration
Name
Leave STANDARD
as the Message
Output
4. Enter Business Actity
Double click the
Business Activities
Enter ZKBA from the
previous step
5. Save, you will get the
following warning
SAP How-To Guide: Develop a Custom Master Data Object in SAP MDG (Master Data Governance)
SAP COMMUNITY NETWORK scn.sap.com
© 2012 SAP AG 18
6. Assign Processor to
workflow: In this step you
assign a single user to the
workflow steps. You may
enter your user to all the
steps.
Start the following view:
Assign Processor to Change
request Step (Simple
Workflow)
7. Add a 4 new entry:
Select button:
New Entries
You will enter your userId in
the field Agent ID. You can
also add organizations.
8. Save
SAP How-To Guide: Develop a Custom Master Data Object in SAP MDG (Master Data Governance)
SAP COMMUNITY NETWORK scn.sap.com
© 2012 SAP AG 19
Run and Test the MDG Custom Object
1. Add a new Favorites
entries to your SAP GUI:
2. Choose Web Dynpro
Application
3. Enter the values as shown
4. Double Click on Item: The
Application will be shown in
a popup
SAP How-To Guide: Develop a Custom Master Data Object in SAP MDG (Master Data Governance)
SAP COMMUNITY NETWORK scn.sap.com
© 2012 SAP AG 20
5. Choose Entity type and
enter a new UniqueId for
your location
Choose the only CR-Type
Click on Continue
6. Enter some example data
in the next form.
You can add Notes and
attachments as well
7. Open “Show My Change
Request”
8. Open the newly received
task
9. Continue with the approval
SAP How-To Guide: Develop a Custom Master Data Object in SAP MDG (Master Data Governance)
SAP COMMUNITY NETWORK scn.sap.com
© 2012 SAP AG 21
Additional Information
View generated Data Model
1. View generated tables:
Execute Report
USMD_DATA_MODEL in
se80
Enter Data Model
2. The generated tables are
displayed.
3.
SAP How-To Guide: Develop a Custom Master Data Object in SAP MDG (Master Data Governance)
SAP COMMUNITY NETWORK scn.sap.com
© 2012 SAP AG 22
Display data in staging table
1. Just double click on the
Physical Name and you will
get forwarded to the content
2. Alternative way:
Display table entries: se16,
enter technical table name
3. Execute
4. Inspect the result
Delete a Data Model
If you want to delete a Data model (and all dependent objects) you might do the following: 1. Act in the cross system client
2. MDGIMG General Settings Data Modeling Edit Data Model
3. Select the corresponding data model and delete the line. If this is not possible because of a active
version:
4. Open SE80 and run USMD_DELETE_DATA_MODEL. This will delete the active version and all
dependent objects (except UI Configurations)
5. Repeat Step3
6. Important: You must SAVE and EXIT the MDG IMG
SAP How-To Guide: Develop a Custom Master Data Object in SAP MDG (Master Data Governance)
SAP COMMUNITY NETWORK scn.sap.com
© 2012 SAP AG 23
Appendix
Create a new data model in View Cluster of MDGIMG
1. Start function Edit Data Model
2. Click on New Entries and create a new Data Model by entering a new Code and Description. Use for instance ZK
3. Save your data and go one level up in the navigation &
SAP How-To Guide: Develop a Custom Master Data Object in SAP MDG (Master Data Governance)
SAP COMMUNITY NETWORK scn.sap.com
© 2012 SAP AG 24
Related Content
Guide on SDN: How to Configure Data Replication for MDG Custom Objects (Flex Option)
Master Data Management homepage
SAP How-To Guide: Develop a Custom Master Data Object in SAP MDG (Master Data Governance)
SAP COMMUNITY NETWORK scn.sap.com
© 2012 SAP AG 25
Copyright
© Copyright 2012 SAP AG. 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 AG. The information contained herein may be changed without prior notice.
Some software products marketed by SAP AG and its distributors contain proprietary software components of other software vendors.
Microsoft, Windows, Excel, Outlook, and PowerPoint are registered trademarks of Microsoft Corporation.
IBM, DB2, DB2 Universal Database, System i, System i5, System p, System p5, System x, System z, System z10, System z9, z10, z9, iSeries, pSeries, xSeries, zSeries, eServer, z/VM, z/OS, i5/OS, S/390, OS/390, OS/400, AS/400, S/390 Parallel Enterprise Server, PowerVM, Power Architecture, POWER6+, POWER6, POWER5+, POWER5, POWER, OpenPower, PowerPC, BatchPipes, BladeCenter, System Storage, GPFS, HACMP, RETAIN, DB2 Connect, RACF, Redbooks, OS/2, Parallel Sysplex, MVS/ESA, AIX, Intelligent Miner, WebSphere, Netfinity, Tivoli and Informix are trademarks or registered trademarks of IBM Corporation.
Linux is the registered trademark of Linus Torvalds in the U.S. and other countries.
Adobe, the Adobe logo, Acrobat, PostScript, and Reader are either trademarks or registered trademarks of Adobe Systems Incorporated in the United States and/or other countries.
Oracle is a registered trademark of Oracle Corporation.
UNIX, X/Open, OSF/1, and Motif are registered trademarks of the Open Group.
Citrix, ICA, Program Neighborhood, MetaFrame, WinFrame, VideoFrame, and MultiWin are trademarks or registered trademarks of Citrix Systems, Inc.
HTML, XML, XHTML and W3C are trademarks or registered trademarks of W3C®, World Wide Web Consortium, Massachusetts Institute of Technology.
Java is a registered trademark of Oracle Corporation.
JavaScript is a registered trademark of Oracle Corporation, used under license for technology invented and implemented by Netscape.
SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP Business ByDesign, 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 S.A. in the United States and in other countries. Business Objects 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.