SAP NetWeaver Quick Starter Guide

Master Data Management: Quick Starter for Collaborative Material Master Data Creation

Applicable Releases: SAP NetWeaver Master Data Management 7.1

Topic Area: Enterprise Information Management Capability: Master Data Management

Version 1.0 May 2010

 Copyright 2010 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, Outlook, and PowerPoint are registered trademarks of Microsoft Corporation. IBM, DB2, DB2 Universal Database, OS/2, Parallel Sysplex, MVS/ESA, AIX, S/390, AS/400, OS/390, OS/400, iSeries, pSeries, xSeries, zSeries, z/OS, AFP, Intelligent Miner, WebSphere, Netfinity, Tivoli, Informix, i5/OS, POWER, POWER5, OpenPower and PowerPC are trademarks or registered trademarks of IBM Corporation. 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 Sun Microsystems, Inc. JavaScript is a registered trademark of Sun Microsystems, Inc., used under license for technology invented and implemented by Netscape. MaxDB is a trademark of MySQL AB, Sweden. SAP, R/3, mySAP, mySAP.com, xApps, xApp, SAP NetWeaver, 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 in several other countries all over the world. 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. These materials are provided as is without a warranty of any kind, either express or implied, including but not limited to, the implied warranties of merchantability, fitness for a particular purpose, or non-infringement. SAP shall not be liable for damages of any kind including without limitation direct, special, indirect, or consequential damages that may result from the use of these materials. SAP does not warrant the accuracy or completeness of the information, text, graphics, links or other items contained within these materials. SAP has no control over the information that you may access through the use of hot links contained in these materials and does not endorse your use of third party web pages nor provide any warranty whatsoever relating to third party web pages. SAP NetWeaver How-to Guides are intended to simplify the product implementation. While specific product features and procedures typically are explained in a practical business context, it is not implied that those features and procedures are the only approach in solving a specific business problem using SAP NetWeaver. Should you wish to receive additional information, clarification or support, please refer to SAP Consulting. Any software coding and/or code lines / strings (Code) included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or grossly negligent. Disclaimer Some components of this product are based on Java. Any code change in these components may cause unpredictable and severe malfunctions and is therefore expressively prohibited, as is any decompilation of these components. Any Java Source Code delivered with this product is only to be used by SAPs Support Services and may not be modified or altered in any way.

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

Typographic Conventions
Type Style Example Text Description Words or characters quoted from the screen. These include field names, screen titles, pushbuttons labels, menu names, menu paths, and menu options. Cross-references to other documentation Example text Emphasized words or phrases in body text, graphic titles, and table titles File and directory names and their paths, messages, names of variables and parameters, source text, and names of installation, upgrade and database tools. User entry texts. These are words or characters that you enter in the system exactly as they appear in the documentation. Variable user entry. Angle brackets indicate that you replace these words and characters with appropriate entries to make entries in the system. Keys on the keyboard, for example, F2 or ENTER.

Icons
Icon Description Caution Note or Important Example Recommendation or Tip

Example text

Example text

<Example text>

EXAMPLE TEXT

Table of Contents
1. 2. 3. General Description.........................................................................................................1 Business Scenario ..........................................................................................................1 Prerequisites....................................................................................................................3 3.1 3.2 4. System Requirements Installation ..........................................................................3 Trusted Connections .................................................................................................6

Configuring the Quick Starter Environment ...................................................................6 4.1 Introduction ...............................................................................................................6

5. 6.

How to Extend the MDM Quick Starter and Develop a Customized Process.............. 24 Story Flow ......................................................................................................................31 6.1 6.2 6.3 6.4 6.5 6.6 New Material Request .............................................................................................32 Enrich and Approve ................................................................................................34 Review and Confirm................................................................................................36 Creation of Material in ECC.....................................................................................36 Finalizing the MDM Creation Process......................................................................39 Notification.............................................................................................................. 39

Master Data Management: Quick Starter for Collaborative Material Master Data Creation

1.

General Description

SAP NetWeaver Master Data Management (MDM) Quick Starter (QS) packages are preconfigured, packaged solutions that are intended to enable MDM customers to rapidly deploy and implement a working scenario for master data management processes on top of MDM and in some cases on top of SAP NetWeaver Business Process Management (BPM). This QS package provides the relevant content for a collaborative creation process for material master data based on MDM and BPM. It serves as a starting point and can be easily tailored to suit specific business needs. Technically MDMs functionality is exposed as Web services and web-based data goverenance user interfaces which are combined in a logical process flow using BPM. The Quick Starter solution for Collaborative Material Master Data Creation consists of the following elements: Preconfigured BPM process (flow) Custom Web Dynpro components (for example, Enrich and Approve user interface) that use standard MDM Web Dynpro components (for example MDM Item Details Web Dynpro component). Request form Preconfigured MDM Web Services (for example, CreateMaterial) Portal Roles (Business User, Data Steward) Data model based on the standard MDM Material data model Enterprise Service Call (for example, Material Creation)

2.
...

Business Scenario

Consider that a Business User requires a new material for further processing in the supply chain. The following would be the overall process carried out: 1. The following initial steps are carried out by the Business User: a. Checks if a specific material record exists in the ERP Central Component (ECC) system. b. If not, he enters the details of a new material request using a new material request form. c. Searches the MDM repository to check if a similar record exists. d. If the record doesnt already exist in the central repository, he submits the new material creation request. (This triggers the records actual creation in MDM). 2. The material creation request appears in the Universal Worklist (UWL) inbox of a designated Data Steward. 3. The Data Steward can either: Enrich and approve the request The Data Steward runs specific validations and enriches and edits the material record with missing information. At this point, the high quality record is available in the central MDM system.

May 2010 1

Master Data Management: Quick Starter for Collaborative Material Master Data Creation When the Data Steward submits the approval, the Business User who initially made the request is notified of the available data and receives a new task, Review and Confirm in his UWL inbox. Rejects the request In this case the created material in MDM is rolled back. Notification that the request has been rejected and the reason appears in the Business Users UWL inbox. 4. The Business User reviews the changes made by the Data Steward and either rejects or confirms the changes. 5. If the changes are rejected, the Data Steward receives the Enrich and Approve task again in his UWL inbox. 6. If the changes are confirmed, a series of automatic activities creates the material record in the ECC. 7. If the material record creation in ECC fails, the Data Steward receives the Enrich and Approve task again in his UWL inbox. A description of each error appears in the Errors pane. 8. If the material record creation in ECC is successful, a series of automated activities updates the materials ECC remote key and checks in the MDM material record.

May 2010 2

Master Data Management: Quick Starter for Collaborative Material Master Data Creation

the Dat a Stewa rd c an also r eject the req uest, the n th e cr eate d m ateri al in MDM is rolle d ba ck, a nd th e Busin ess Use r g ets Noti ficatio n

3.

Prerequisites

This section covers the necessary installations required prior to configuring and running the MDM Quick Starter for Collaborative Material Master Data Creation. Installation is done according to the relevant installation and configuration guides. Links to the relevant guides are provided below.

3.1

System Requirements Installation

Required/ Optional Required File Name More Information For more information, see Installing SAP NetWeaver Composition Environment (CE) 7.1 EHP1 SP04 on page 5.

Deploy the following components into your SAP NetWeaver Application Server Java (AS Java): Component SAP NetWeaver Composition Environment (CE) 7.1 Enhancement Package 1 SP04 (including Business Process Management (BPM), SAP NetWeaver Developer Studio, and the SAP NetWeaver Portal) SAP NetWeaver Master Data Management (MDM) 7.1 SP4: Master Data Server (MDS) MDM Console MDM Data Manager MDM Import Manager MDM Syndicator Master Data Import Server (MDIS) Master Data Syndication Server (MDSS) Required Required Required Optional Optional Optional Optional

For more information, see http://service.sap.co m/installmdm71 Installation and Upgrade choose the installation guide according to the platform that you are using (for example, Windows or Unix).

May 2010 3

Master Data Management: Quick Starter for Collaborative Material Master Data Creation

Component SAP NetWeaver MDM Web Dynpro Framework 7.1 SP4

Required/ Optional Required

File Name MDMJAVAWDFRWK04 _x.SCA

More Information For more information, see http://service.sap.co m/installmdm71 Development and Customization MDM Web Dynpro Components Guide. Refer to sections: Installing the MDM Web Dynpro Environment Deploying MDM Web Dynpro Components

SAP NetWeaver MDM Web Services Generator 7.1 SP4

Required

MDMWEBSERVICES0 4_x.SCA

For more information, see http://service.sap.co m/installmdm71 MDM Web Services Guide Installation and Deployment (design time)

SAP NetWeaver MDM Web Services Runtime 7.1 SP4

Required

MDMWEBSERVRUNT0 4_x.SCA

For more information, see http://service.sap.co m/installmdm71 MDM Web Services Guide Installation and Deployment (runtime)

SAP NetWeaver MDM Java Connector 7.1 SP4

Required

MDMJAVAAPI04_ xxx.SCA

For more information, see http://service.sap.co m/installmdm71 Development and Customization MDM Java and .NET API Getting Started Getting Started with Java API Installing and Referencing the MDM Connector. For more information, see the section below this table. For demonstrations or proofof-concept (POC) purposes, you can use the SAP ES Workplace (you will need to register on the SAP Developer Network (SDN) at: http://sdn.sap.com/ir j/sdn/soareg)

SAP Enhancement Package 4 for SAP ECC 6.0 (Enterprise Services)

Required

May 2010 4

Master Data Management: Quick Starter for Collaborative Material Master Data Creation

Installing SAP NetWeaver Composition Environment (CE) 7.1 EHP1 SP04

Any customer with a valid SAP Service Marketplace User ID license can download the SAP NetWeaver Composition Environment (CE) from the SAP Service Marketplace (SMP) as follows:
...

1. Log on to the SAP Software Distribution Center (SWDC) at http://service.sap.com/swdc. 2. From the navigation tree on the left, choose Download Application Group 3. From the main page navigate to SAP NetWeaver Installations and Upgrade - Entry by

SAP NETWEAVER.

4. Select the SAP EHP1 for SAP NW CE7.1 application. 5. Choose the installation according to the platform that you are using (for example, Windows or Unix). Note Links to the installation documentation can be found on the Info page below the application name. You can also download a Preview Version from SAP Developer Network (SDN) at http://www.sdn.sap.com/irj/sdn Downloads EHP1 for SAP NetWeaver Composition Environment 7.1 - Preview Version. The direct link is: EHP1 for SAP NetWeaver Composition Environment 7.1 - Preview Version Note Update to the highest Support Package (SP) Installing SAP NetWeaver Developer Studio (NWDS) If not already available, download and install a NWDS matching the SAP NW CE EHP1 installation above. Any customer with a valid SAP Service Marketplace User ID license can download the NWDS from the SAP Service Marketplace (SMP) as follows:
...

1. Log on to the SAP Software Distribution Center (SWDC) at http://service.sap.com/swdc. 2. From the navigation tree on the left, choose Download Entry by Application Group 3. From the main page, navigate to SAP NetWeaver Support Packages and Patches -

SAP NETWEAVER.

4. Select the SAP EHP1 for SAP NW CE7.1 application. 5. Navigate to Entry by Component 6. Choose #OS independent. 7. Choose a NWDS application that matches the SAP NW CE EHP1 installation above. Note Links to the installation documentation can be found on the Info page below the application name. NWDS Update Site CE7.11.

SAP Enhancement Package 4 for SAP ECC 6.0 (Enterprise Services)

...

1. Log on to the SAP Software Distribution Center (SWDC) at http://service.sap.com/swdc. 2. From the navigation tree on the left, choose Download Support Packages and Patches Support Packages and Patches - Entry by Application Group.

May 2010 5

Master Data Management: Quick Starter for Collaborative Material Master Data Creation 3. Continue navigating on the main web page as follows: SAP Application Components ERP SAP ERP Enhance Package EHP4 FOR SAP ERP 6.0 SAP

3.2

Trusted Connections

The SAP NetWeaver Application Server Java user must also exist as an MDM User (defined in the MDM Console).You can authenticate a session by using a trusted connection between the server where the MDM Java API is deployed, and the server where MDM is running. For more information on how to define a trusted connection, see http://service.sap.com/installmdm71 Development and Customization Dynpro Components Guide Defining a Trusted Connection MDM Web

4.
4.1

Configuring the Quick Starter Environment

Introduction

This section contains the necessary steps required to configure and run the MDM Quick Starter for Collaborative Material Master Data Creation. Make sure that your Quick Starter package contains the following: Component MDM Quick Starter (QS) Material Repository File Name MDM_QS_Material_Repository_7.1SP4.a2a More Information Unarchive this file and load it on to your MDS. The MDM QS Material repository is based on the Material MDM Business Content repository. For more information about the Material repository, see https://websmp104.sapag.de/installmdm71 MDM Business Content Material SAP Note 1355137

May 2010 6

Master Data Management: Quick Starter for Collaborative Material Master Data Creation

Component MDM Quick Starter

File Name MDMBPMMATE04_x.sca

More Information Deploy the MDM Quick Starter SCA file into your SAP NetWeaver Application Server Java (AS Java). This SCA file contains the following: An MDM Material Quick Starter Process Development Component (DC) A custom MDM Web Dynpro Development Component A stand-alone MDM Web Dynpro Development Component running on the Portal

MDM Quick Starter Web Service

MDM_QS_Material_WS_7.1SP4.ear

Deploy this MDM Quick Starter EAR file into your SAP NetWeaver Application Server Java (AS Java). The file contains the MDM Web Service which was generated from the MDM Web Service Generator on top of the Material MDM Business Content repository. See step 8 below

MDM Web Dynpro Configuration XML file Portal Content

MDM_QS_Material_WDCONFIG_7.1SP4.xml

MDM_QS_Material_EP_Content_7.1SP4.epa

See step 1 below

Step 1: Importing the MDM Quick Starter Portal Content Archive File Info This step adds the Request Form to a Portal page.
...

1. Log on to the SAP NetWeaver Portal as Administrator. 2. In the Portal, navigate to System Administration Transport. Import.

3. In the Portal Catalog, navigate to Transport Packages

4. Import the following file: MDM_QS_Material_EP_Content_7.1SP4.epa. A new Material folder is created in the Portal. 5. To view the folder, in the Portal, choose Content Administration and then navigate in the Portal Catalog to Portal Content Content Provided by SAP packages MDM QuickStarter Material.

May 2010 7

Master Data Management: Quick Starter for Collaborative Material Master Data Creation Note If you want to change the sort order so that the Home tab is the first Top Level Navigation (TLN) entry point, you can modify the Sort Order Priority property for the Home workset, which you can find at: pcd:portal_content/com.sap.pct/every_user/general/worksets/com.sa p.uwl.home_core_ws Step 2: Create MDM Quick Starter (QS) Roles Info Each Quick Starter role enables the user to carry out specific functions during the administrative and creation process.
... ...

1. Log on to the SAP NetWeaver Administrator (NWA) with Administrator permissions. 2. Navigate to Configuration Management Identify Management.

3. Create the following roles in the User Management Engine (UME): MDM_Process_SuperUser This role includes the following: Administrator for the material creation pool MDM WS Generator user MDM WD Configurator user MDM_Business_User Owner of the Business User lane MDM_Data_Steward Owner of the Data Steward lane

Step 3: Assign Actions for the MDM QS Roles Info This step defines specific permissions for each QS role.

May 2010 8

Master Data Management: Quick Starter for Collaborative Material Master Data Creation

Action MDM_Material_Creation_Request

Description Permission to view the Request New Material Form

Roles MDM_Process_SuperUser MDM_Business_User

MDM_WD_CONFIGURATOR

Permission to configure Web Dynpro components using the MDM Web Dynpro Configurator Permission to generate MDM Web services using the MDM Web Service Generator

MDM_Process_SuperUser

MDM_WS_Generator

MDM_Process_SuperUser

Step 4: Assign Roles to Users User All MDM QS Users Assigned Role Every User Core Role BPEM End User MDM QS Super User MDM_Process_SuperUser

May 2010 9

Master Data Management: Quick Starter for Collaborative Material Master Data Creation

User MDM QS Business User

Assigned Role MDM_Business_User Master Data Management Note This role is automatically created when the transport package is imported. See step 1 above. Tip To search for the Master Data Management role, enter the following search term: *requester

May 2010 10

Master Data Management: Quick Starter for Collaborative Material Master Data Creation Step 5: Assign the SAP_BPM_SuperAdmin role to the default SAP NetWeaver Guest User Info To enable the Web service call to start the BPM process, assign the SAP_BPM_SuperAdmin role to the default SAP NetWeaver Guest user (see screen capture below)

Step 6: Create Users in MDM Info This step is carried out so that a trusted connection can be established. Create the same user in the MDM Console as created in the UME. (see step 4). Step 7: Create an MDM Destination Info You create an MDM destination from which the MDM Web Dynpro components can retrieve MDM Server communication details. For more information on how to create an MDM destination, see http://service.sap.com/installmdm71 Development and Customization Dynpro Components Guide Creating a Destination for the MDM Repository. The direct link is: Creating a Destination for the MDM Repository Take note of the following steps: In the General Data step, the Destination Name is MDM_QS_Material. MDM Web

May 2010 11

Master Data Management: Quick Starter for Collaborative Material Master Data Creation

In the Logon Data step, enter your MDM server and repository names.

Step 8: Import the MDM Web Dynpro Configuration Info You use the MDM Web Dynpro configuration to define the MDM Web Dynpro runtime user interfaces (for example, the Enrich and Approve human activity). 1. Log on to the MDM Web Dynpro Components Configuration Manager with your MDM QS Super User role. 2. Import the MDM QS Material configuration. The name of the file is: MDM_QS_Material_WDCONFIG_7.1SP4.xml. For more information, see http://service.sap.com/installmdm71 Customization MDM Web Dynpro Components Guide Transporting. The direct link is: Transporting. May 2010 12 Development and

Master Data Management: Quick Starter for Collaborative Material Master Data Creation

Step 9: Create Communication Profiles Info By creating Communication Profiles, you provide runtime configuration settings so that the various systems can communicate with one another.
... ...

1. Log on to the SAP NetWeaver Administrator (NWA) page with Administrator permissions. 2. Navigate to SOA Management 3. Select Communication Profiles. 4. Choose New to open the New Profile wizard. 5. Create a new Communication Profile for each of the following: MDM Web Services MDM QS BPM SAP ECC Enterprise Services Technical Configuration System Connections.

May 2010 13

Master Data Management: Quick Starter for Collaborative Material Master Data Creation 6. Enter the following values in each of the steps: MDM Web Services Step 1: General Enter MDM_WS as the Profile Name and enter a Profile Description. Step 2: Security Select None as the Authentication method. Step 1: General

Step 2: Security

MDM QS BPM Step 1: General Enter MDM_QS_BPM_WS as the Profile Name and enter a Profile Description. Step 2: Security Select None as the Authentication method. Step 2: Security See screen capture above (for MDM Web Services) Step 1: General

May 2010 14

Master Data Management: Quick Starter for Collaborative Material Master Data Creation SAP ECC Enterprise Services Step 1: General Enter SAP_ES as the Profile Name and enter a Profile Description. Step 2: Security Select all the authentication options. Step 1: General

Step 2: Security

7. Choose Finish. Step 10: Create Provider Systems Info The Provider Systems specify the policies of communication between the systems that are defined as Communication Profiles above.
...

1. Log on to the SAP NetWeaver Administrator (NWA) page with Administrator permissions. 2. Navigate to SOA Management 3. Select Provider Systems. 4. Choose New to launch the New Provider System wizard. Technical Configuration System Connections.

May 2010 15

Master Data Management: Quick Starter for Collaborative Material Master Data Creation 5. Create a provider system for: MDM BPM Web Service Note This Web service starts the MDM Material Creation Process. MDM Web Service SAP ECC Create Material Basic Data Enterprise Service SAP ECC Change Material Basic Data Enterprise Service 6. Enter the following values in each of the steps: MDM BPM Web Service Step 1: Provider System Select the Java radio button. Enter QSS as the System Name. Enter the name of your Web Application Server as the Host. Enter a system description. Step 2: Metadata User Do not enter any values in this step. Step 3: Communication Profile Enter MDM_QS_BPM_WS as the Profile Name. Step 4: Services Search Settings Select Single Service. Enter the following WSDL URL: http://<AS JAVA server name>:<http port>/mdm/bpem/demosapcom2 Fmdm2Fqs2Fmaterial2Fproces s2FPool2FMaterialCreation6 ab68d036d4c26e856f16b9b594 55176?wsdl&mode=ws_policy Step 4: Services Search Settings Step 1: Provider System

Step 3: Communication Profile

May 2010 16

Master Data Management: Quick Starter for Collaborative Material Master Data Creation MDM Web Service Step 1: Provider System Select the Java radio button. Enter MDM as the System Name. Enter the name of your Web Application Server as the Host. Enter a system description. Step 2: Metadata User Do not enter any values in this step. Step 3: Communication Profile Enter MDM_WS as the Profile Name. Step 4: Services Search Settings Select Single Service. Enter the following WSDL URL: http://<Your SAP AS JAVA name>:< Your SAP AS JAVA httpport>/MDM_Material/HTT PNone?wsdl&style=document& mode=ws_policy SAP ECC Create Material Basic Data Enterprise Service Step 1: Provider System Select the ABAP radio button. Enter ES1 as the System Name. Enter the Host, Client, and Installation Number of your ECC. Enter a System Description. Step 2: Metadata User Enter User Name and Password Step 3: Communication Profile Enter SAP_ERP_ES as the Profile Name. Step 4: Services Search Settings Select Single Service. Enter the correct WSDL URL for Create Material Basic Data ES for your ESS system. Steps 1 and 3: Steps 1 and 3:

May 2010 17

Master Data Management: Quick Starter for Collaborative Material Master Data Creation SAP ECC Change Material Basic Data Enterprise Service Step 1: Provider System Same as above for Create Material Basic Data with the following changes:. In step 1, enter ES2 as the System Name. In step 4, enter the correct WSDL URL for Change Material Basic Data ES for your ESS system.

Step 11: Define a User Name and Password for ECC Enterprise Services 1. Log on to the SAP NetWeaver Administrator (NWA) page with Administrator permissions. 2. Navigate to SOA Management Management. 3. Choose the Maintenance tab. 4. Choose New to open the New User Account wizard. 5. Complete the wizard as follows: Step 1 General The name of the ECC is ECC_ES_Material. Application and Secnario Communication User Account

May 2010 18

Master Data Management: Quick Starter for Collaborative Material Master Data Creation Step 2 Credentials Choose WebService Security and Systemkey for both Web Service Security and for HTTPs.

6. Choose the Assignment tab. 7. Choose New to open the New User Account Assignment wizard. 8. Complete the wizard as follows: Step 1: User Account Choose the User Account that you created in step 5 above.

May 2010 19

Master Data Management: Quick Starter for Collaborative Material Master Data Creation Step 2: Provider Choose the ES1 provider system for the Create Material Basic Data and then repeat this step and choose ES2 provider system for the Change Material Basic Data.

Step 12: Configure a Proxy Info Configure a proxy so that you can call services outside of your Intranet. (For example, if your ECC is located outside of your Intranet). 1. Log on to the SAP NetWeaver Administrator (NWA) page with Administrator permissions. 2. Navigate to SOA Management 3. Choose the HTTP Proxy tab. 4. Enter the proxy Host and Port names. May 2010 20 Technical Configuration SOA Middleware Global Settings.

Master Data Management: Quick Starter for Collaborative Material Master Data Creation 5. Check Bypass proxy server for local addresses.

6. Choose Save. 7. Choose the WS Navigator tab. 8. Enter an asterisk (*) in the Allowed Hosts field. Note This enables you to use the Web service test page to call a Web service outside of the Intranet.

9. Choose Save. Step 13: Assign a Provider System to the MDM BPM Material DC Info For the material creation process to call MDM Web services and Enterprise Service calls, you need to assign the correct Provider System (communication policies) for each Service Group.
...

1. Log on to the SAP NetWeaver Administrator (NWA) page with Administrator permissions. 2. Navigate to SOA Management Communication. Application and Scenario Communication Application

3. Select demo.sap.com/MDM-BPM-MATERIAL-SAMPLE from the list of configurations at the top of the screen.

May 2010 21

Master Data Management: Quick Starter for Collaborative Material Master Data Creation 4. Choose Edit and assign the following Service Groups to the correct Provider System: Service Group MDM_Material Create_Material_Basic_Data_ES Change_Material_Basic_Data_ES Provider System MDM ES1 ES2

5. Select the Service Group and choose Assign Provider System. 6. Choose the relevant Provider System from the popup window. 7. Choose OK. 8. Save your settings. 9. Refresh and check that all configured Service Groups are in a Processed state.

Step 14: Assign a Provider System to the MDM QS Stand-Alone Web Dynpro DC Note To start the BPM process for the stand-alone Web Dynpro application, you need to assign the correct Provider System (communication policies). 1. Log on to the SAP NetWeaver Administrator (NWA) page with Administrator permissions. 2. Navigate to SOA Management Communication. May 2010 22 Application and Scenario Communication Application

Master Data Management: Quick Starter for Collaborative Material Master Data Creation 3. Select demo.sap.com/MDM~qs~material~standalone~wd from the list of configurations at the top of the screen. 4. Choose Edit and assign the following Service Groups to the correct Provider System: Service Group MaterialCreationProcessSG MdmMaterialCreationSG Provider System QSS MDM

5. Select the Service Group and choose Assign Provider System. 6. Choose the relevant Provider System from the popup window. 7. Choose OK. 8. Save your settings. 9. Refresh and check that all configured Service Groups are in a Processed state.

Step 15: Define the MDM Web Service User

...

1. Log on to the SAP NetWeaver Administrator (NWA) page with Administrator permissions. 2. Navigate to Configuration Management 3. Choose the Applications tab. 4. Highlight the MDM_Material_ENTAPP application in the Details pane. 5. Choose WS.RunTime.Mdm.User from the Extended Details pane. May 2010 23 Infrastructure Java System Properties.

Master Data Management: Quick Starter for Collaborative Material Master Data Creation 6. Choose Modify. 7. Define the MDM password for the assigned MDM user name. 8. Choose Save As.

5.

How to Extend the MDM Quick Starter and Develop a Customized Process

You can extend the MDM Quick Starter Material implementation and create your own customized implementation. The MDM Quick Starter release contains the source code, so you can import the source code into your local workspace and continue developing the MDM Material process on top of the MDM Quick Starter release. To import the MDM Quick Starter source code, follow these steps: Step 1: Import the SCA File
...

1. In the SAP NetWeaver Developer Studio (NWDS), choose the Development Infrastructure perspective as follows: Window Open Perspective Other Development Infrastructure.

2. In the Component Browser choose the LocalDevelopment node. 3. Import the software component to your LocalDevelopment development track as follows: a. In the context menu of the LocalDevelopment track, choose Import SC to open the Import SC from File screen.

May 2010 24

Master Data Management: Quick Starter for Collaborative Material Master Data Creation b. Locate the SCA file using the Browse button.

c. Choose Finish. The import is complete. You can see the components with the SC technical name that have been created, under the node.

May 2010 25

Master Data Management: Quick Starter for Collaborative Material Master Data Creation 4. To work with the imported components, you need to create a new project for each of the Development Components. From the context menu of each development component, choose Sync/Create Project.

5. Repeat this step for each DC in the table below: Development Component Name mdm/qs/material/custom/wd Type Web Dynpro Description Contains two kinds of Web Dynpro components: Custom A Web Dynpro component consisting of an Enrich and Approve BPM activity wrapped in an MDM Item Details Web Dynpro component Notification A Web Dynpro component for a notification activity

May 2010 26

Master Data Management: Quick Starter for Collaborative Material Master Data Creation

Development Component Name mdm/qs/material/functions/ear

Type Enterprise Application EJB Module

Description Contains the mdm/qs/material/functions/ ejb module Contains EJBs, consumed in the BPM mapping process as ejb functions Contains the MDM material creation processes Contains the security action definition for the material request form Contains the stand-alone Web Dynpro component, which is the material requester form

mdm/qs/material/functions/ejb

mdm/qs/material/process mdm/qs/material/standalone/secu rity mdm/qs/material/standalone

Process Composer UME Permissions Web Dynpro

Step 2: Solve the Dependency Errors

6. Choose the Development Infrastructure perspective. 7. In the context menu of the LocalDevelopment node, choose Import SC.... 8. Start the wizard by locating the MDMJAVAAPI04_xxx.SCA SCA file, using the Browse button. 9. Choose Finish.

May 2010 27

Master Data Management: Quick Starter for Collaborative Material Master Data Creation

10. Repeat steps 7-10 for the MDMJAVAWDFRWK04_x.SCA file.

May 2010 28

Master Data Management: Quick Starter for Collaborative Material Master Data Creation 11. Refresh the LocalDevelopment node to see the added SCA file.

12. Highlight the MDM-BPM-MATERIAL-SAMPLE SCA and select the Dependencies tab in the Component Properties perspective. 13. Choose Add. 14. Select the MDM_JAVA_API and MDM_JAVA_WD_FRAMEWORK SCAs from the popup window. 15. Choose Finish.

The dependencies are set and you can start your custom implementation on top of the MDM Quick Starter implementation.

May 2010 29

Master Data Management: Quick Starter for Collaborative Material Master Data Creation

May 2010 30

Master Data Management: Quick Starter for Collaborative Material Master Data Creation

6.

Story Flow

The story flow is outlined in the following process diagram:

May 2010 31

Master Data Management: Quick Starter for Collaborative Material Master Data Creation

6.1

New Material Request

User Interface
This step consists of a custom wrapper application (New Material Request Form) that includes the following elements: Embedded MDM Item Details Web Dynpro component MDM Search popup page (when choosing Search on the UI). The popup page consists of MDM Search, Result Set, and Item Details Web Dynpro components. A custom Use as template button was added to the search page. An application consisting of a Notes area The above mentioned MDM Web Dynpro components are configured in the MDM Web Dynpro Configurator and can be adapted to suit any business scenario. For example, you can choose which fields to display on the user interface of the Web Dynpro component (you choose from a list of fields in the MDM repository). For more information, see http://service.sap.com/installmdm71 Components Guide. MDM Web Dynpro

May 2010 32

Master Data Management: Quick Starter for Collaborative Material Master Data Creation Note When the request is submitted, an MDM validation is run in the background. If the Business User has chosen not to enter values in all the fields specified in the validation, a list of validation errors appears on the New Material Request Form. Either the Business User can enter values in these fields, or he can choose Save with errors and continue with the material creation request without entering values in the fields.

Procedure
A request for new material is initiated by the Business User as follows:
...

1. Log on to the SAP NetWeaver Portal with the user name and password defined for the Business User role. Tip Instead of logging on to the portal, you can run the New Material Request Form as a stand-alone application using the following URL: http://<AS JAVA Server Name>:<HTTPPort>/webdynpro/dispatcher/ demo.sap.com/mdm~qs~material~standalone~wd/Standalone?SAPtestId=2 2. Before you create a new request, first search the MDM repository to check if a similar record exists. If so, you can choose Use as template to copy the values of the similar record to your New Material Request Form. CAUTION Not all field values of the similar record are copied over only those that belong to the configured display fields on the New Material Request Form. All other field values are ignored. 3. Choose Edit next to each field to change a value or enter a new value for your material request. The popup window for each field includes a list of values that exist in the MDM repository. 4. Complete the New Material Request Form (either from scratch or with the modifications of the copied record). 5. Enter a reason for the request in the Notes area on the right. This step is mandatory. 6. Choose Submit Request to initiate the BPM process.

May 2010 33

Master Data Management: Quick Starter for Collaborative Material Master Data Creation

Functionality
When the Business User chooses Submit Request, the following actions are triggered:
...

1. A record is created as a checked out as new record in the MDM repository. 2. A Web service call from the wrapper application initiates a BPM process with the request data. 3. The BPM engine moves the process to the first task and a new BPM work item is added to the Data Stewards UWL inbox.

6.2

Enrich and Approve

User Interface
This step consists of a custom wrapper application that uses the MDM Web Dynpro Search, Result Set, and Item Details components as used components. The user interface consists of: An embedded MDM Item Details Web Dynpro component with configured Approve, Reject, and Search buttons. An MDM Search popup page (when choosing Search on the UI) consisting of MDM Search, Result Set, and Item Details Web Dynpro components. A custom Use as template button was added to the search page. A Notes area and an Errors area.

May 2010 34

Master Data Management: Quick Starter for Collaborative Material Master Data Creation

Procedure
The Enrich and Approve step is carried out by the Data Steward as follows:
...

1. Open your UWL inbox to see the submitted New Material Request Form. 2. Open the task to see the Enrich and approve new MDM material screen. 3. Review the request note and the material details. 4. If required, enrich the data (edit and save) as follows: Search the MDM repository to check if a similar record exists. If so, you can choose Use as template to copy the values of the similar record to the New Material Request Form and update the values accordingly. Choose Edit next to each field to change a value. The popup window for each field includes a list of values that exist in the MDM repository. 5. Save your changes. 6. Choose Validate to run the configured validations as well as a mandatory field check. Note The validations are configured in the MDM Web Dynpro Configurator. For more information, see http://service.sap.com/installmdm71 MDM Web Dynpro Components Guide Configuring an Item Details Component. 7. Choose one of the following buttons: Approve Reject Before choosing Reject, enter a reason for rejection by opening the Notes link in the BPM standard task bar. BPM standard task bar

Cancel t he c reat e new ma teri al re quest or A ppr ove st ep, s ave c han ges and mov e the re ques t to t he next BPM step for revi ew by req uesto r. Cancel t he c reat e new ma teri al re quest or A ppr ove st ep, s ave c han ges and mov e the re ques t to t he next BPM step for revi ew by req uesto r.

Funtionality
When the Data Steward chooses Approve the following actions are triggered: 1. A validation is run in the background (all configured validations and mandatory fields). 2. If the task is successfully completed, and the record is valid, the BPM engine moves the process to the next task and a new BPM task (Review and Confirm) is added to the Business Users UWL inbox. When the Data Steward chooses Reject, the following actions are triggered:
...

1. An automated step is triggered using an MDM Web Service Rollback operation. 2. The material request which was originally checked out as new is rolled back and the record is deleted from the MDM repository. May 2010 35

Master Data Management: Quick Starter for Collaborative Material Master Data Creation 3. The BPM process is terminated. 4. A notification in the form of a task is sent to the Business Users UWL inbox for further review.

6.3

Review and Confirm

User Interface
This step consists of a custom Web Dynpro wrapper application, with an MDM Web Dynpro Item Details component in read-only mode.

Procedure
This step is carried out by the Business User:
...

1. Review the changes made by the Data Steward. 2. Confirm or Reject the changes.

Functionality
If the Business User chooses Confirm, the BPM process moves to the next step. If the Business user chooses Reject, the Data Steward once again receives the Enrich and Approve task in his UWL inbox.

6.4

Creation of Material in ECC

If the creation in ECC fails, the Data Steward once again receives the Enrich and Approve task in his UWL inbox. In the Errors pane on the right side of the screen a description of all the errors appears. If the creation of the material in ECC is successful, a series of automated activities calls MDM Web Services, which updates the material ECC remote key and checks in the MDM material record. If one of the Web Service calls fails, the Data Steward receives the Enrich and Approve task in his UWL inbox with a list of errors in the Errors pane.

May 2010 36

Master Data Management: Quick Starter for Collaborative Material Master Data Creation The series of automated steps include: MDM Web Services for retrieving data from the MDM repository Enterprise Services for creating the material in ECC

MDM Web Services:

MDM Web Services are use to retrieve the record information from the repository including lookup record IDs. For each lookup field defined, MDM Web services are intiated to obtain the relevant lookup record codes. In the Quick Starter example, this has been defined for the following four lookup tables: MDM_UNITS (base unit) MDM_MATERIAL_TYPES MDM_INDUSTRY_SECTOR MDM_UNITS ( height, width, length unit)

Enterprise Services
The Enterprise Services (ES) are used for creating the material in ECC. There are two Enterprise Service calls: Create Basic Data May 2010 37

Master Data Management: Quick Starter for Collaborative Material Master Data Creation Creates the Material with values for the following fields: Description Material Type Industrial Sector Base Unit Change Basic Data Updates the Material with values for the following fields: Width Height Length Unit of Width / Height / Length If the material creation is a success, the Enterprise Service response includes the newly created records remote key.

May 2010 38

Master Data Management: Quick Starter for Collaborative Material Master Data Creation

6.5

Finalizing the MDM Creation Process

The final MDM creation process consists of the following three automated steps using MDM Web services: Join Check Out Update Key Mapping Check In

6.6

Notification

The Business User who initially made the request is notified of the available data and receives a notification in his UWL inbox.

May 2010 39