Select language:

Process documentationConfiguring Master Data Governance for Material

 

To use SAP Master Data Governance (MDG) for material, you need to carry out the steps described below.

Prerequisites

Business Function

You have activated the following business functions:

  • Master Data Governance, Generic Functions (MDG_FOUNDATION)

  • Master Data Governance for Material (MDG_Material)

When you activate the MDG_Material business function the system activates the Material (MM) data model. Before continuing with system configuration, open transaction SFW5 and check if the activation has been completed by choosing Switch Framework Logs from the Goto menu and selecting the corresponding entry.

Set Up Workflow

To use the rule-based workflow processes of MDG for material, you have defined general settings for SAP Business Workflows in Customizing for SAP NetWeaver under   Application Server  Business Management  SAP Business Workflow  . Remember to regenerate the authorization profile of SAP_ALL or include USMD* authorization objects into the authorization for the user WF-Batch.

To activate the workflow features, use the semi-automated configuration in transaction SWU3. You can also access these settings in Customizing under   SAP NetWeaver  Application Server  Business Management  SAP Business Workflow  Maintain Standard Settings  

For further information see the documentation for the Configuration activity. Note the following when maintaining the settings:

  • When configuring the RFC destination you need superuser authorization to create the default WF-BATCH user.

  • Regenerate the authorization profile for SAP_ALL or include the USMD* authorization objects into the authorizations of the user WF-Batch.

  • For the Check Entries from HR Control Tables section you may need to execute report RHSOBJCH in transaction SE38 and keep the default settings.

  • Maintain the prefix numbers for the standard objects.

  • You do not need to maintain the Web Server and Guided Procedures Gateway.

Set Up Search

You must have installed and connected Enterprise Search either in embedded form or as central search engine service in order to use master data governance for material. If you are not on NetWeaver SAP_BASIS 7.02 SP06, implement the SAP note 1502296.

Adjust Profile Parameters

Ensure that the profile parameter size for the Shared Objects Memory is the correct. To check this setting run transaction RZ11 and verify that the value for parameter abap/shared_objects_size_MB is between 200 and 300 megabytes.

If you want to use the SAP NetWeaver Business Client with single sign on, ensure that the parameters login/create_sso2_ticket and login/accept_sso2_ticket are set correctly.

Use transaction RZ11 to check that the host name is fully qualified for parameter icm/host_name_full.

Number Ranges

You need to ensure that number ranges for the following objects are available. Check with transaction SNRO.

Object

Interval Number

From Number

To Number

MDG_BS_MAT

01

0000000000000001

9999999999999999

USMD_CRIDX

1

000001

999999

USMD_CREQ

01

000000000001

999999999999

DATLDLOGID

01

10000002

99999999

User Roles

In order to successfully conduct the next steps in the configuration process, you must have the following user roles assigned in PFCG:

  • SAP_BC_TREX_ADMIN

  • SAP_QAP_ESH or SAP_ESH_LOCAL_ADMIN if it is not available.

  • SAP_MDGM

It is recommended that you create a second user with SAP_MDGM authorization, for testing the workflow processes

Process

This process describes the minimal set of customizing steps and recommended check activities required to do the following:

  • Create materials

  • Change materials

  • Mark materials for deletion

  • Process multiple materials

You run the settings for this process in Customizing under   Cross-Application Components  Processes and Tools for Enterprise Applications  Master Data Governance  .

You may encounter an error that states that a Web Dynpro service is not active. To resolve this error copy the path of the service, then open transaction SICF to search for it. In the Maintain Service screen select the entry and from the Service/Host menu select Activate.

  1. Activate the Data Model MM

    Check (or enhance) and activate the MM data model including temporary IDs for internal number handling.

    1. Check whether you can use the data model delivered by SAP for managing your material master data with MDG for material.

      Activate the delivered data model MM in Customizing for Master Data Governance under   General Settings  Data Modeling  Edit Data Model  .

    2. Assign an internal key.

      To support internal key assignment, run the activity in Customizing for Master Data Governance under   General Settings  Data Modeling  Define Prefixes for Internal Key Assignment  .

      Example: If you create new entries with the following values, all temporary IDs are prefixed with $ and an internal sequence number.

      • Data Model: MM

      • Entity Type: MATERIAL

      • Prefix: $

      Note Note

      For MDG for material, authorizations cannot be defined here. Instead, the existing back-end authorizations are reused.

      For more information, see Customizing under   Logistics – General  Material Master  Tools  Maintain Authorizations and Authorization Profiles  .

      Other customizing activities in data modeling are only relevant for the material domain if your data model needs to be enhanced. For more information, see Enhancement of Master Data Governance Content and Extending the Data Model for Master Data Governance for Material.

      End of the note.
  2. Activate Business Configuration Set

    Run this activity in Customizing for Master Data Governance under   Master Data Governance for Material  Import Predefined Change Request Types  .

    To start, choose Activate and keep the default settings.

  3. Verify UI Modeling (Optional)

    Activities on UI configuration are only relevant if the data model has been enhanced.

    Verify the pre-delivered UI configurations for the data model MM in Customizing for Master Data Governance under   General Settings  UI Modeling  Edit UI Configuration  .

    For data model MM, verify the following values:

    • Data Model: MM

    • The following UI configurations:

      • MDG_MM_APP_BS_DEL_GEN – Single processing for deletion

      • MDG_MM_APP_BS_MAT_GEN – Single processing of an entity

    Verify the pre-delivered print forms that are assigned to the data model MM in Customizing for Master Data Governance under   General Settings  UI Modeling  Assign Print Forms for Single Processing  .

    For data model MM, verify the following values:

    • UI configuration: MDG_MM_APP_BS_MAT_GEN

    • Entity Type: MATERIAL

    • Print Form: MDG_MM_MATERIAL_PDF

  4. Set Up of Search

    There are two types of search options available:

    • Embedded Search (included in SAP NetWeaver on a local system)

    • SAP NetWeaver Enterprise Search (run centrally)

    Embedded Search is limited to indexing and searching within a single SAP system (single SAPSID). If you want to extend the reach of searches across two or more systems, use SAP NetWeaver Enterprise Search. In production scenarios with heavy data load it is mandatory to install a separate TREX instance that is used exclusively by Embedded Search for performance and sizing reasons. For installation information for TREX 7.1 see SAP note 1249465.

    Embedded Search

    If you want to use Embedded Search, run the following activity in Customizing for SAP NetWeaver under   Search  Embedded Search  .

    SAP delivers the following two standard templates for MDG for material, which are located in SAP_APPL. You need to activate these templates and prepare them for indexing.

    • Material (MATERIAL) – for the active data residing on the standard tables MA* and related objects

    • Material Template for MDG (MDG_MATERIAL) – for the inactive material data linked to the MDG change requests

    If you are not familiar with TREX (or TREX is not yet activated), proceed as follows to make the basic settings:

    1. Create TREX_RFC user.

      If the TREX_RFC user is not available, create it with the required roles as mentioned in the SAP note 766516 for the target system.

    2. Connect to the TREX installation.

      During TREX installation, you created an RFC-destination for the TREX. Run transaction SM59 in the TCP/IP connections section to verify that it exists and can be linked. Link the ABAP system to this TREX destination.

      For more information, see Customizing for SAP NetWeaver under   Search  Embedded Search  Set TREX Destination  .

      Alternatively, you can run report ESH_ADM_SET_TREX_DESTINATION.

    3. Create and index the connectors.

      Open the Connector Administration Cockpit in Customizing for SAP NetWeaver under   Search  Embedded Search  Modeling, Administration, and Monitoring  Open Administration Cockpit  . Make the following settings:

      1. To open the Template Modeler, select the Template Modeler link.

      2. Locate the MATERIAL and MDG_MATERIAL templates. The templates are part of the SAP_APPL software layer. Once you have located the templates you need to create the connectors for the Enterprise Search.

        You need to create the connectors starting from the highest software layer, for example EA_APPL or PLM_WUI. If the template for Master Data Governance does not exist you need to create it using the instructions given in Verify Data Quality and Search Settings.

      3. To create a search connector for the corresponding templates, from the Actions menu choose Create Connector. Create the connector using the MATERIAL template first and wait for the job to complete before creating the connector using the MDG_MATERIAL template.

      4. Go back to the Administration Cockpit and choose Create. Select the new software component and search for the template MATERIAL. Once you have located the template, create the connector for the Enterprise Search. Create the connector using the MATERIAL template first and wait for the job to complete before creating the connector using the MDG_MATERIAL template.

      5. The two connectors Material and Material Template for MDG are now visible with the status preparing and or prepared. Select the Material connector and from the Actions menu select Schedule Indexing. On the new screen choose Show Input Form. Next, choose the option for immediate indexing and the recurrence period. You can also activate real-time indexing if the sizing, parameters, and performance of the system allow for this. Select all object types and choose the Copy Settings button. This copies the default settings from the input form to all object types. The status of the connector is changed to Indexing.

      Once indexing is complete the two connectors should have the status Active.

    4. Ensure authorization indexing. Enterprise Search requires its own authorizations. Authorizations for all MDG users must be indexed on the Enterprise Search system. Every new or changed user is written as an entry into the table ESH_AU_USR_UPD that contains the user IDs that have been changed since the last indexing of the technical object type USER_AUTHORITY.

      The object type USER_AUTHORITY needs to be regularly scheduled for indexing on the Enterprise Search system. The object type USER_AUTHORITY can be found in the connector Material.

    5. Use the report ESH_TEST_SEARCH to verify the search function. In the Search Scope section, enter a Connector ID. Next, enter Default in the Request field and execute the report.

      • The connector MATERIAL returns the active material master data.

      • The connector MDG_MATERIAL returns the inactive material master data. At least one active change request of type MAT* needs to exist with materials assigned to it, otherwise you will get a message that the search provider MDG_MATERIAL does not exist during the search and in the duplicate check of any change request where this is relevant.

    For more information about TREX, see Configuration of the TREX Security Settings.

    Search Engine Service

    If you are running a central SAP NetWeaver Enterprise Search system and you connect other SAP NetWeaver systems with Embedded Search to the central system, follow the steps as described in Customizing for SAP NetWeaver under   Search  Search Engine Service  .

  5. Verify Data Quality and Search Settings (Optional)

    This step is relevant if you have defined your own search application. In the delivered standard, the SAP NetWeaver Enterprise Search is used for MDG for material.

    In this step, you can verify the following:

    • Existence of entry ES and that Free Text and Fuzzy settings are activated

      This entry cannot be removed or deactivated (E-class entry delivered by SAP). You can verify these settings in Customizing for Master Data Governance under   General Settings  Data Quality and Search  Define Search Applications  .

    • Configuration of the duplicate check

      The configuration for the duplicate check is only relevant for material if the customer has defined their own search application as outlined in the previous step.

      You can configure this check in Customizing for Master Data Governance under   Data Quality and Search  Define Search Applications  Configure Duplicate Check for Entity Types  .

    • Generation of the search object connector templates

      The following template for the inactive staging area should already be generated, if not, you can create the search object connector templates in Customizing for Master Data Governance under   General Settings  Data Quality and Search  Create Search Object Connector Templates  .

      When you run this Customizing activity, enter the following values:

      • Software Component: SAP_APPL

      • Business Object Type: 194

      • Search Object Connector Template: MDG_MATERIAL

      • Template Description: Material template for MDG

      When the message appears that the template already exists, you can cancel the activity.

    • Assignment of the delivered (or generated) search object connector templates

      You must ensure that for business object type 194 Material, the delivered (or generated) search object container MDG_MATERIAL and software component SAP_APPL is assigned.

      You do this in Customizing for Master Data Governance under   General Settings  Data Quality and Search  Assign Search Object Connector Templates to Object Types  .

  6. Configure Change Request Settings

    Depending on your company’s requirements you might want to adjust and enhance the default change request values.

    The following information describes the minimal settings for a basic governance process. For more information about each customizing activity, see the relevant documentation for that customizing activity.

    1. Review and/or define which statuses the change requests can have, and which processing options are enabled for those statuses. Optionally, you can add new statuses to be used in the change request types.

      For more information, see Customizing for Master Data Governance under   General Settings  Process Modeling  Change Requests  Edit Statuses of Change Requests  .

      The following statuses are required for the SAP standard process. If you only activate Master Data Governance for Material, you should maintain the missing ones manually:

      Status Value

      Description

      Permitted Processing

      00

      To Be Evaluated

      Change of Object List

      01

      To Be Considered and Approved

      Change of Object List

      02

      Changes to Be Executed

      Execution of Changes

      03

      To Be Revised

      Change of Object List

      04

      Final Check to Be Performed

      No Processing

      05

      Final Check Approved

      No Processing

      06

      Final Check Rejected

      No Processing

      07

      Activation Failed

      No Processing

      08

      Approved; to Be Replicated

      No Processing

      09

      Dependent Data to Be Processed/Approved

      Execution of Changes

      10

      To Revise: Perform Changes

      Execution of Changes

      11

      Process Errors After Activation

      Execution of Changes

      12

      Approved, Contact Person to be Processed

      No Processing

      30

      To Be Revised with Changes

      Execution of Changes

      99

      No Status Set

      No Processing

    2. Check that the following business activities are in your system and that they are assigned to the default data model MM.

      • MAT1 Create Material

      • MAT2 Process Material

      • MAT3 Display Material

      • MAT6 Mark Material for Deletion

      • MATA Process Multiple Materials

      • MATB Import Material

      For more information, see Customizing for Master Data Governance under   General Settings  Process Modeling  Change Requests  Create Business Activity  .

    3. Create new change request types for data model MM, or validate after import using business configuration set (BC-Set).

      For more information, see Customizing for Master Data Governance under   General Settings  Process Modeling  Change Requests  Create Change Request Type  .

      The following table shows the change request types for data model MM. Only the relevant columns are included.

      Change Request Type

      Data Model

      Description

      Single Object

      Main Entity Type

      Workflow

      MAT01

      MM

      Create Material

      Yes

      MATERIAL

      WS60800086

      MAT02

      MM

      Change Material

      Yes

      MATERIAL

      WS60800086

      MAT06

      MM

      Mark Material for Deletion

      Yes

      MATERIAL

      WS60800086

      MAT0A

      MM

      Edit Multiple Material

      No

      MATERIAL

      WS60800086

      MAT0B

      MM

      Import Material

      No

      MATERIAL

      WS60800086

      The following settings should exist in the substructures of the change request types:

      • MAT01

        • Entity type: MATERIAL

        • UI Config: MDG_MM_APP_BS_MAT_GEN

        • Msg. Output: W Issue Error Messages as Warnings

        • Business Activity: Create Material (MAT1)

      • MAT02

        • Same as for MAT01

        • Business Activity: Process Material (MAT2)

      • MAT06

        • Same as for MAT01

        • UI Config: MDG_MM_APP_BS_DEL_GEN

        • Business Activity: Mark Material for Deletion (MAT6)

      • MAT0A

        • Same as for MAT01

        • UI Config: <leave emtpy>

        • Msg. Output: W Issue Error Messages as Warnings

        • Business Activity: MATA Process Multiple Materials

      • MAT0B

        • Same as for MAT01

        • UI Config: <leave emtpy>

        • Msg. Output: W Issue Error Messages as Warnings

        • Business Activity: MATB Import Material

    4. Optionally, you can define priorities, reasons, or rejection reasons for change requests. You can enter codes and a short description to tag or classify your change requests. These codes can be used later for change request analytics (process quality analysis). They also can be used to influence the workflow-driven processes. For example, depending on the priority of a change request, you can mark it for special processing.

      Perform the following activity in Customizing for Master Data Governance under   General Settings  Process Modeling  Change Requests Define Priorities / Reasons / Rejection Reasons for Change Requests  .

    5. Optionally, you can define print forms for change requests. By default, the form USMD_EDITION_CREQUEST is used. This is relevant only if your own or multiple print forms are required.

      For more information, see Customizing for Master Data Governance under   General Settings  Process Modeling  Change Requests Define Print Form for Change Requests  .

  7. Configure Workflow Tasks

    As a prerequisite you have made the necessary general settings for workflows and defined the organizational plan in Customizing for SAP NetWeaver under   Application Server  Business Management  SAP Business Workflow  . Then you need to ensure that the active type linkages for Material (BUS2250) are set correctly. Follow the instructions in Customizing for MDG under   General Settings  Process Modeling  Workflow  Activate Type Linkage  . The flag Linkage Activated must be selected and the flag Enable Event Queue must be deselected.

    The standard workflow template used by Master Data Governance for material is WS60800086.

    In order to ensure the general assignment of processors using the rule-based workflow, run the following activity in Customizing for Master Data Governance under   General Settings  Process Modeling  Workflow  Configure Workflow Tasks  .

    1. Go to application component CA-MDG-AF and choose Assign Agents.

    2. All tasks (denoted by TS*) that are not set as Background Task need to be set to General Task. To do so, select the task, choose Attributes and change to General Task. In particular, ensure you do this for the Dialog Processing (TS 60807954) task.

    Make sure to do this in particular for the Dialog Processing (TS 60807954) task.

    Alternative procedure using the generic workflow maintenance transaction:

    1. Run transaction SWDD

    2. In the Workflow field, enter the workflow template WS60800086, the highest version is automatically chosen.

    3. In the Navigation area go to step 000073 Dialog Processing and select it.

    4. In the Task Properties area, choose Agent Assignment for Task. Choose the Agent Assignment for Task button.

    5. On the next screen select Dialog Processing and choose the Attributes button.

    6. In the Task popup select General Task and choose Transfer.

    7. Return to the Task Properties list and verify that the status icon beside Agent Assignment is green or yellow.

  8. Set Up the Rule-Based Workflow

    MDG for material uses advanced workflow capabilities by combining the SAP Business Workflow with the SAP Business Rule Framework plus (BRFplus) tool. This section describes how to activate and load the necessary settings for BRFplus.

    Check that the steps for Rule-Based Workflow are imported by the BC-Set by running the following activity in Customizing:    General Settings  Process Modeling  Workflow  Rule-based Workflow  Define Steps for Rule-Based Workflow  .

    The following are the default steps required for all change request types:

    Type of Change Request

    Change Request Step

    Keys

    Successful Validation Required

    Description

    MAT01

    0

    Empty

    Empty

    Processing

    MAT01

    90

    Empty

    Checked

    Final Check

    MAT01

    91

    Empty

    Empty

    Activation

    MAT01

    92

    Empty

    Empty

    Revision

    MAT01

    93

    Empty

    Empty

    Validation

    MAT01

    95

    Empty

    Empty

    Revision Processing

    MAT01

    99

    Empty

    Empty

    Complete

    Due to technical restrictions further settings currently cannot be included in the BC-Set processing therefore the following steps need to be executed manually:

    1. Check for existing decisions tables and generate the decision tables and rules for each change request type either in Customizing or by running the system transaction USMD_SSW_RULE. If this step is not possible, go to step 2, otherwise go to step 3.

    2. Export the content from client 000 and import it into your hub client.

    3. Maintain your content in the decision tables, reflecting your governance process. You can use the pre-delivered SAP content as a starting point.

    More detail on these steps is available below.

    To activate and load the necessary settings for BRFplus proceed as follows:

    1. Check for existing decisions tables and generate the decision tables and rules for each change request type in Customizing under   General Settings  Process Modelling  Workflow  Rule-Based Workflow  Configure Rule-Based Workflow  

      Enter the change request types one after the other and choose the Start button. After reviewing the decision tables you can leave this step without any further activities. If you get an error that the object is not available, proceed to the next step, otherwise skip to step 3. You can also makes these settings using the transaction USMD_SSW_RULE.

    2. Export the content from client 000 and import it into your hub client.

      1. Call transaction BRFplus in the 000 client

      2. To switch to Expert mode from the Workbench menu choose User Mode.

      3. Search for the object USMD_SSW_CATA_MAT01 using the Workbench menu by choosing Open Object. Use the following values to search:

        • Object Type CA: Catalog

        • Name: USMD_SSW_CATA_MAT*

      4. From the search result select USMD_SSW_CATA_MAT01

      5. To export the content from client 000, right-click on the application in the repository (not the catalog entry) to open the context menu and choose   Tools  XML Export  

      6. Choose Include Referenced Objects, generate the XML file, and download it. To Import the content into your MDG main client run the BRFplus transaction, from the Tools menu choose XML Import, select your XML file, and choose Upload File.

      7. Repeat these steps for all relevant change request types including:

        • MAT01 Create Material

        • MAT02 Process Material

        • MAT06 Mark Material for Deletion

        • MAT0A Process Multiple Materials

        • MAT0B Import Material

      The structure import will also include the values in the three pre-delivered decision tables. For testing the standard workflow configuration you need to copy and activate the two entries in the DT_USR_AGT_GRP_MATXX from user ANZEIGER to one or two existing user IDs in your system.

    3. Maintain your content in the decision tables, reflecting your governance process. You can use the pre-delivered SAP content as a starting point.

      Note Note

      If you extend the BRFplus decision tables make sure that the status of the final step is set to 05 Final Check Approved or 06 Final Check Rejected.

      End of the note.

      The following are the minimal settings for the relevant change request types.

      • DT_SINGLE_VAL_MAT01

      • DT_NON_USER_AGT_GRP_MAT01

      • DT_USER_AGT_GRP_MAT01

      DT_NON_USER_AGT_GRP_MAT01 and DT_SINGLE_VAL_MAT01 contain the automated steps and follow-up logic used by the BRFplus. The follow-up logic can either result in an automated step or in a user task that will be made visible as a workflow.

      The users involved in the Master Data Governance process need to be included in table DT_USER_AGT_GRP_MAT01 so that they can receive and execute the workflow tasks. Maintain agents (for example the users or organizations in the Portal Content and Portal Role Assignment sections of this document) for all change request types and their associated workflow steps. Each condition alias that appears in the DT_SINGLE_VAL_MAT01 table needs at least one processor, either automatic or user (group). Therefore, for all non-automated steps at least one entry needs to exist in DT_USER_AGT_GRP_MAT01.

      Conduct this maintenance for all relevant change request types. Further details on the workflow concepts can be found here. The following change request types appear in the standard delivery: MAT01, MAT02, MAT06, MAT0A.

      The following step types exist:

      Step Type

      Short Description

      1

      Check

      2

      Approve

      3

      Process

      4

      Revise

      5

      Activate

      The following agent types exist:

      User Agent Type

      Short Description

      US

      User

      O

      Organizational Unit

      C

      Job

      S

      Position

      AG

      Role

      SU

      Special User (Initiator/Last-Step User)

      The following is the standard content pre-delivered by SAP:

      DT_SINGLE_VAL_MAT01/2/6/A/B

      Previous Step

      Previous Action

      Condition Alias

      New Step

      New Change Request Status

      00

      No value

      1

      90

      02 (Changes to be executed)

      90

      09 (Activate)

      2

      91

      02

      90

      10 (Send for Revision)

      3

      95

      02

      91

      31 (Activation Successful)

      4

      99

      05 (Final Check Approved)

      91

      <>31 (Activation failed)

      5

      90

      11 (Failure)

      92

      No value

      6

      99

      06 (Final Check Rejected)

      95

      07 (Request Again)

      7

      90

      02

      95

      08 (Undo)

      8

      92

      02

      DT_USER_AGT_GRP_MAT01/2/6/A/B

      COND_ALIAS

      AGENT_GROUP

      STEP_TYPE

      USER_TYPE

      USER_VALUE

      1;5;7

      001

      5 (Activate)

      US

      ANZEIGER

      3

      001

      4 (Revise)

      US

      ANZEIGER

      DT_NON_USER_AGT_GRP_MAT01/2/6/A/B

      COND_ALIAS

      AGENT_GROUP

      PROCESS_PATTERN

      2

      001

      06 (Activation (Bypass Snapshot))

      4;6

      001

      99 (Complete (Sub-)Workflow)

      8

      001

      08 (Roll back change request)

      Notes

      • It is necessary to activate your new entries for each of the three decision tables.

      • The quickest way to allow users to participate in any workflow step for testing purposes is to copy the two default entries in the DT_USER_AGT_GRP_MAT01/2/6/A tables and change the entries as follows:

        • User Type: AG (Role)

        • User Value: SAP_MDGM (The MDGM role of PFCG/SU01)

      • If the system cannot find a processor for your change requests check the background steps of the change request's workflow log to see if a work item with the description Set Status x for Change Request y is in process or in error. If this is the case regenerate the authorization profile of SAP_ALL or include USMD* authorization objects into the authorization for the user WF-Batch.

  9. Set Up Mass Data Load

    Mass data load allows you to transfer master data between systems. These systems can be clients or your main Master Data Governance (MDG) system. The first step of a mass data load is the extraction of the master data to an IDoc-XML file, which you can save locally or on your application server. In the second step, you load the data into your central MDG system. During the load step you can decide if you want the new master data to appear directly in the active area, or if you want to work with change requests and load the data to the staging area.

    Data Extraction from Source System

    To be able to extract material master data, you need to configure the logical system for IDoc-XML extraction to the application server file system. The steps are as follows:

    1. Create an XML-file port

      Use transaction WE21 to create an XML-file port for IDoc processing. Ensure that you have network access from your local client to the directory configured in the XML-file port. Enter the port name, description, and the physical directory. Enter the function module EDI_PATH_CREATE_CLIENT_DOCNUM. On the Outbound Trigger tab enter the RFC destination LOCAL_EXEC.

    2. Create Logical System

      Open transaction SALE and then go to   Basic Settings  Logical Systems   to create a new logical system.

    3. Maintain Distribution Model

      Open transaction SALE and then go to   Modeling and Implementing Business Processes  Maintain Distribution Model and Distribute Views  . You can also use transaction BD64 for this.

      1. Switch to change mode and choose Create Model View to create a new entry. Enter a short text and a technical identifier.

      2. Choose Add Message Type for the newly created model. Enter a logical source system name and a destination system name and choose the message types MATMAS and CLFMAS.

    4. Create Partner Profile

      Run transaction SALE and then go to   Partner Profiles  Generate Partner Profiles  . Alternatively you can use transaction BD82.

      1. Select the newly created model using the input help for the technical name and then select the logical destination system.

      2. Enter the authorized user and the following values:

        • Version: 3

        • Pack.Size: 100

        • Output Mode: Immediate Transfer

        • Inbound. Processing: Immediately

      3. Choose Execute. You can ignore the port error that appears.

    5. Call transaction WE20 and make the following settings:

      1. Open the Partner Type LS folder and select the partner profile you created above.

      2. Update the message types MATMAS and CLFMAS in the Outbound Parameters section. The Receiver Port is the XML-file port from the first step above. In the Basic Type field enter MATMAS05 for MATMAS and CLFMAS02 for CLFMAS.

    6. Test creation of IDOC XML

      1. Generate the IDoc-XML for material using the transaction BD10.

      2. Check the newly generated IDocs using transaction WE02 or BD87. You can use the receiver port as the filter criteria in the Partner Port field.

      3. Use transaction AL11 to find the XML files on the directory of your XML-file port.

      4. To download the file for analysis purposes to local directory use transaction CG3Y.

    Data Import into Target System (MDG Hub)

    The IDoc-XML files contain the following fields in the header section:

    Field Name

    Field Description

    Value

    SNDPRT

    Partnertyp

    LS

    SNDPRN

    Sender Partner Number

    Defined in step 3 below.

    SNDPOR

    Sender Port

    Defined in step 1 below.

    RCVPRT

    Partnertyp

    LS

    RCVPRN

    Receiver Partner Number

    Defined in step 3 below.

    RCVPOR

    Receiver Port

    Defined in step 1 below.

    To be able to import iDoc-XML files the following set up activities need to be carried out:

    1. Use transaction IDX1 to create two ports in the IDoc adapter, one for sending and the other for receiving. Enter the port, client, description, and RFC destination for each port. Both ports should have the RFC destination of the MDG hub. Check that the port names match the names in your IDoc-XML file for the SNDPOR and RCVPOR, see table above for details.

    2. In transaction WE21 enter the receiver XML port using the same name as in step 1 above. Enter the port name under the folder XML File, and enter a description and a physical directory. In the function module field enter EDI_PATH_CREATE_CLIENT_DOCNUM. On the Outbound:Trigger tab, in the RFC destination field, enter LOCAL_EXEC.

    3. In transaction BD54 enter the sender and receiver partner numbers as logical system names.

    4. 4. In transaction FILE create the logical file name. Enter a Logical File and a Name. In the Physical File field enter <PARAM_1>. In the data format field enter BIN. In the Application Area field enter CA. In the Logical Path field enter the logical file path.

    5. In transaction AL11 make sure that the IDoc-XML files are stored under the logical path and that there are no other files stored in that directory. Double-click on the path to view the existing iDoc-XML file. You can use transaction CG3Z to copy a local IDoc-XML file to the path.

    6. To test the file import, run programRMDG_FILE_UPLOAD_BG. Enter your directory/logical file and a filter that matches the names of the files to be imported. You can choose to import to the active area, the staging area, or the active area with the provision that data with errors is sent to the staging area. If you are uploading to the staging area you need to choose a change request type. Use the input help in the Material Change Request Type field to select the change request type.

      To load data into the active area without governance processes, in the Persistence Choice field select 2 – Active Area. To import data into the staging area with governance processes in the Persistence Choice field select 1 - Staging Area and enter a change request type. To import data to the active area with the provision that data with errors is sent to the staging area in the Persistence Choice field select 3 - Active Area with Errors Sent to Staging. The system will generate a change request that has to be processed in order to load the data into the active area.

      Note Note

      For high volumes of data you should schedule the program RMDG_FILE_UPLOAD_BG during times of low system activity. Be aware that you can run parallel processes with files from multiple directories to shorten the overall load time.

      End of the note.

      Review the file import using the log found in the application log. (Transaction SLG1) Use the object MDG_FILE_UPLOAD to find your data.

  10. Set Up Data Replication

    For MDG for material, replication of master data from the MDG hub to the connected systems and clients is currently done exclusively using Application Link Enabling (ALE), in order to minimize the effort for the customers in upgrading the connected systems.

    For more information, see in Customizing under   Application Server  IDoc Interface / Application Link Enabling (ALE)  SAP Business Workflow  .

    The following process describes briefly the minimal settings required for the two main message types MATMAS and CLFMAS.

    1. Verify logical systems

      Run transaction SALE and choose   Basic Settings  Logical Systems  . Both clients (source and target) need to be defined as logical systems and need to be assigned to the relevant clients.

    2. Check communication

      Run transaction SALE and choose   Communication  Created RFC Connections  . The target partner system has to be defined here as an ABAP connection with a connection type of 3 and with same name as the target logical system. Perform a connection test.

    3. Maintain distribution model

      1. Run transaction SALE (Display ALE Customizing) and choose   Modeling and Implementing Business Processes  Maintain Distribution Model and Distribute Views  . Alternatively, run transaction BD64 (Maintenance of Distribution Model).

      2. In change mode, create a new model.

        Choose the Create Model View pushbutton. Enter a short text and a technical name.

      3. Choose the Add Message Type pushbutton for the newly created model.

      4. Enter names for the logical source and destination systems and choose message type MATMAS.

    4. Create partner profile.

      1. Run transaction SALE and choose   Partner Profiles  Generate Partner Profiles  . Alternatively, run transaction BD82 (Generate Partner Profiles).

      2. Select the newly created model and in the Partner System field, enter the logical destination system.

      3. Enter the ALE-User (the default value is ALEREMOTE) and the following values, and execute.

        Field

        Value

        Version

        3

        PackSize

        100

        Output Mode

        Transfer IDoc immediately

        Inb. Parameters: Processing

        Trigger Immediately

      4. To verify your settings, run transaction WE20 and from the Partner Profiles menu, choose Partner Type LS. Verify that Partner type LS is the logical destination system.

      5. In the detail screen, the chosen message type MATMAS must appear.

    5. Distribute model view to receiving system.

      1. Run transaction SALE and choose   Modeling and Implementing Business Processes  Maintain Distribution Model and Distribute Views  . Alternatively, run transaction BD64.

      2. Select the new model and choose   Edit  Model view  Distribute  .

      3. Verify that the correct receiving system is marked and choose Enter.

      4. Verify within the receiving system that the model view was created.

    6. Create partner profile (in the receiving client).

      1. Run transaction SALE and choose   Modeling and Implementing Business Processes  Partner Profiles  Generate Partner Profiles  . Alternatively, run transaction BD82.

      2. Select the distributed model.

      3. Enter the ALE-User, and the following values, and execute.

        Field

        Value

        Version

        3

        PackSize

        100

        Output Mode

        Transfer IDoc immediately

        Inb. Parameters: Processing

        Trigger Immediately

        Note Note

        If the protocol contains the error Port could not be created this can be ignored.

        End of the note.
      4. Check that the correct process code is being used. To do this go to the details for the inbound parameter message types and in Inbound Options check that the parameter Process Code is MATM.

      Follow the above steps add the message type CLFMAS to the model. The process code in WE20 Inbound Details has to be CLFM. You can test the distribution using transaction BD10. Verify the results in the receiving client using transaction BD87.

    7. Repeat this procedure for message type CLFMAS.

      Note Note

      In the Configuration activity Define Technical Settings for Business Systems SAP recommends that you select the checkbox Status System Filter for the Material business object. This ensures that if an object instance was previously sent to a target system, it continues to be sent in the future, independent of filter settings.

      End of the note.
  11. Define Value Mapping

    The elements for possible value mapping are predelivered.

    If required, you can define value mapping for elements such as, UoM, industry sector, material type, and others in Customizing for Master Data Governance under   General Settings  Value Mapping  .

  12. Define Key Mapping

    If you are working with multiple connected systems and did not consolidate the material keys during the initial load phase, key mapping may be required.

    You can define the system-specific mappings for the key value of the supplier in Customizing for Master Data Governance under   General Settings  Key Mapping  .

    The mapping definitions of the key mappings are conducted by any authorized user using the business transaction from the portal or the corresponding back-end transaction.

  13. Choose where you want to run SAP Master Data Governance

    You can run SAP Master Data Governance in either of the following environments:

    • SAP NetWeaver Portal

    • SAP NetWeaver Business Client

    SAP NetWeaver Portal

    The SAP NetWeaver Portal content for MDG for material is part of the standard delivery for the SAP Business Suite and is delivered with SAP enhancement package 5 for SAP ERP 6.0 and software component BP ERP MDGM 1.50.

    You must implement the following business packages using Java Support Package Manager (JSPM) in your SAP NetWeaver Portal.

    • Business Package for Material Governance 1.50 (BPERPMDGM)

    • Business Package for Common Parts 1.51 (BPERP5COM)

    • Business Package for Financial MDM 1.51 (BPERPFINMDM)

    The system alias for BPERPMDGM, BPERPMDGS and MPERPFINMDM is SAP_FMDM, so it means it will point to the same backend system. This backend system has to be created in the portal as system object and the system alias SAP_FMDM has to be assigned to it.

    Once activated, you must assign and personalize the role Material Master Data Manager in the portal as follows:

    1. Logon to the portal.

    2. Choose Delegated User Administration.

    3. Enter your User ID and choose the Go pushbutton.

    4. Mark the line of your user and Modify.

    5. Select the Assigned Roles tab.

    6. Enter Material as the search criteria.

    7. Select role Material Master Data Manager.

    8. Click Add and save.

    After assigning the user role you need to log off and log on again to the portal.

    SAP NetWeaver Business Client

    If you are running SAP Master Data Governance on the SAP NetWeaver Business Client (and not on the SAP NetWeaver Portal), you need to create, define, or configure the role for the Business Client in the SAP ERP system. To do so, perform the following steps in the SAP ERP system:

    To assign and personalize the role Material Master Data Manager (SAP_MDGM) proceed as follows:

    1. On the SAP Easy Access screen, choose   Tools  Administration  User Maintenance  Role Administration  Roles   or alternatively, run transaction PFCG (Role Maintenance). Choose role SAP_MDGM.

      This role ensures that the necessary steps can be started without using the SAP NetWeaver Portal. This can be used for testing or if the portal is inactive.

      Assign and personalize the role SAP_MDGM to your users. In the role SAP_MDGM on the Personalization tab, edit the Personalization Key SAP Master Data Governance (R_FMDM_MODEL): Define the standard model MM and the related UI configuration.

    2. Verify the setting of the authorization objects within the roles and restrict them if required.

    3. On the SAP Easy Access screen, choose   Tools  Administration  User Maintenance  Users  . Run transaction SU01 (User Maintenance) and assign the Material Master Data Manager role (SAP_MDGM) for application to the MDG user.

  14. Final Steps

    SAP recommends to regenerate the data model again at the end of these setup steps to ensure clear code generation.

    Note Note

    Before you can run Master Data Governance services like Display Material, you need to assign the data model MM to your user. Alternatively, the user administrator can maintain the following Personalization Parameter for your user profile: SAP Master Data Governance R_FMDM_MODEL.

    End of the note.

Result

The system is configured for MDG for material. In addition, if data load has been done, mass changes and distribution to other systems can also be executed.

More Information

Was this page helpful to you?