In the previous Blog Post: Workforce integration from SAP SuccessFactors to Master Data Integration service – Part1 I have described how to integrate Workforce data from SAP SuccessFactors to Master Data Integration.
This blog post I will provide the steps required to integrate Workforce data from SAP Master Data Integration to SAP S/4HANA Cloud.
Process:
Step1: Create SAP Master Data Integration service instance:
Login to Business Technology Platform (BTP) subaccount. Then navigate to Services > Service Marketplace and select Master Data Integration.
Select Create in the top-right corner.
Create Master Data Integration Instance
Enter basic info for your instance.
Service: SAP Master Data Integration
Plan: sap-integration
Runtime Environment: Cloud Foundry
Space: <Any option from the dropdown list. The chosen space is not relevant for Master Data Integration service>
Instance Name: <User-definable>
Click on Next.
Master Data Integration Instance Basic Info
Configure instance parameters for your instance.
application: s4
businessSystemId: <User-definable. An identifier for the client>
writePermissions:
[
{
"entityType": "sap.odm.workforce.WorkforcePerson"
}
]Click on Create.
Master Data Integration Instance Parameter
Step2: Create a Service Key for service instance
Navigate to Services > Instances and Subscriptions and create Service Key for newly created service instance.
Create Service Key
Provide a Service key name.
Service Key Name: <User-definable. It is recommended to indicate the date of creation in the service key name>
Service Key Name
Write down the systemId, uaa.clientid, uaa.clientsecret, uaa.url and the uri of service key which will be used later.
Service Key Details
Service Key Details
Step3: Setup Communication Arrangement for Communication scenario SAP_COM_0594
Login to SAP S/4HANA Cloud and go to the Communication Arrangements page.
Create a Communication Arrangement for Communication scenario SAP_COM_0594 – SAP Master Data Orchestration Integration.
Create Communication Arrangement
Create a new Communication System.
Create Communication System
Provide a Communication System name.
System Name: <User-definable>
Communication System Name
The created Communication System will be like below:
Communication System
Create Communication User for Inbound Communication of this newly created Communication System.
Create Communication User
Create Communication User
Maintain the User Name and Password and click Create.
Communication User Details
Select the newly created Communication User.
Add Communication User
The created Communication Arrangement will be like below.
Write down the url of MDO_ORCHESTRATIONADMIN_0001 service which will be used later.
Communication Arrangement
Step4: Create Destination for Master Data Orchestration
Login to Business Technology Platform (BTP) subaccount. Navigate to Connectivity > Destinations.
Click New Destination and enter basic info for the destination.
Name: <User-definable>
Type: HTTP
URL: <The url of above MDO_ORCHESTRATIONADMIN_0001 service>
Proxy Type: Internet
Authentication: BasicAuthentication
User: <User name of above created Communication User>
Password: <Password of above created Communication User>
Additional Properties:
MDIInstanceId: <systemId of above created service key>
MDOConsumer: true
MDOProvider: true
Create Destination
Check connection for this Destination.
Check Connection
Step5: Setup Communication Arrangement for Communication scenario SAP_COM_0659
Login to SAP S/4HANA Cloud. Create Communication User.
Create Communication User
Maintain the User Name and Password and click Create.
Communication User Details
Create Communication System.
Create Communication System
Provide a Communication System name.
System Name: <User-definable>
Communication System Name
Technical Data:
Host Name: <host part of the value of the uri of the service key>
Business System: MDI
Auth. Endpoint: <host part of the value of the uaa.url of the service key + /authorize>
Token Endpoint: <host part of the value of the uaa.url of the service key + /oauth/token>
Ensure that the checkbox Inbound Only is not selected.
Communication System Details
Scroll down to Users for Inbound Communication section and add the above created System User.
Communication System Details
Scroll down to Users for Outbound Communication section and click Add button.
Communication System Details
Enter detailed information for the Outbound User:
Authentication Method: OAuth 2.0
OAuth 2.0 Client: <uaa.clientid of service key>
Client Secret: <uaa.clientsecret of service key>
Outbound User Details
Create a Communication Arrangement for Communication scenario SAP_COM_0659 – SAP Master Data Integration.
Communication System: <above created Communication System>
OAuth 2.0 Client ID: <uaa.clientid of service key>
Communication Arrangement
Step6: Subscribe to Master Data Orchestration
Master Data Orchestration provides a UI where you can create a distribution model specifying the configuration according to which master data is replicated from provider to consumer.
Login to Business Technology Platform (BTP) subaccount and navigate to Services > Service Marketplace.
Select Master Data Integration (Orchestration) and click on Create. Inside the dialog, choose the standard plan and click on Create once more.
This step will create the MasterDataOrchestrationAdmin and MasterDataOrchestrationDisplay role templates automatically.
Create Master Data Orchestration Instance
Then navigate to Services > Instances and Subscriptions, you will find the Master Data Integration (Orchestration) has been subscribed.
Master Data Orchestration Instance
Navigate to Security > Role Collections. Create a Role Collection and add MasterDataOrchestrationAdmin and MasterDataOrchestrationDisplay roles. Then enter the data for users to who should have access to SAP Master Data Orchestration subscription in the Users section.
Role Collections
Step7: Create a distribution model in Master Data Orchestration
Navigate to Services > Instances and Subscriptions. Click Go to Application icon beside the Master Data Integration (Orchestration) to access the Master Data Orchestration UI.
Master Data Orchestration UI
Click Manage Distribution Model tile and click on Create.
Model: <User-definable>
Business Object Type: (sap.odm.workforce.WorkforcePerson)
Mode: Pull
Package Size:1
Provider Interface: MDI_LOG_WORKFORCE_PERSON
Provider: MDI
Consumer: <businessSystemId of the service instance>
Then Save and Activate it.
Manage Distribution Model
Manage Distribution Model
Manage Distribution Model
After activation, press the replicate button to trigger initial replication.
Replicate Distribution Model
You can also use postman to check the WorkforcePerson data.
The log API is the uri value of service key + /v0/odm/3.0.0/log/sap.odm.workforce.WorkforcePerson
Postman
With this we have completed the Workforce Integration from SAP Master Data Integration service to SAP S/4HANA Cloud. Please feel free to leave the comments with your feedback and thoughts.
