Workforce integration from SAP SuccessFactors to Master Data Integration service – Part1


Introduction:

As part of the SAP Cloud Integration Strategy, SAP provides the SAP One Domain Model (ODM), a unified domain model for business objects distributed throughout different SAP applications. SAP One Domain Model focuses on the end-to-end Intelligent Enterprise business processes.

SAP One Domain Model helps establish out-of-the-box master data integration for SAP Intelligent Suite applications and lower the integration efforts for customers and partners.

SAP Master Data Integration (MDI) uses SAP One Data Model for out-of-the-box SAP integration and synchronize business objects across SAP Intelligent Suite. SAP Master Data Integration is a multi-tenant cloud service used to do master data distribution among SAP/Non-SAP product/services.

SAP%20Master%20Data%20Integration

SAP Master Data Integration

SAP Master Data Integration provides a central data model for consumption of a set of Workforce data across SAP systems. Workforce data is maintained in SAP SuccessFactors Employee Central and uploaded to SAP Master Data Integration, from which SAP S/4HANA or other applications can retrieve it for their own purposes.

The SAP One Domain Model is released on the SAP API Business Hub and structured by domains. The following picture shows the graphical view of Workforce entity. In this view we can see all relations between Workforce entity to other entities and other domain types.

SAP%20One%20Domain%20Model

SAP One Domain Model

This blog post provides the steps required to integrate Workforce data from SAP SuccessFactors to SAP Master Data Integration.

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%20MDI%20Instance

Create MDI 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 MDI service>

Instance Name: <User-definable>

Click on Next.

MDI%20Instance%20Basic%20Info

MDI Instance Basic Info

Configure instance parameters for your instance.

application: sfsf

businessSystemId: <User-definable. An identifier for the client>

writePermissions:

[ { "entityType": "sap.odm.workforce.WorkforcePerson" }
]

Click on Create.

MDI%20Instance%20Parameter

MDI Instance Parameter

Step2: Create a Service Key for service instance

Navigate to Services > Instances and Subscriptions and click Actions icon of the newly created service instance. Then click on Create Service Key.

Create%20Service%20Key

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%20Key%20Name

Service Key Name

Write down the uaa.clientid, uaa.clientsecret, uaa.url and the url of service key which will be used later.

Service%20Key%20Details

Service Key Details

Service%20Key%20Details

Service Key Details

Step3: Configuration steps for integrating Workforce data from SF EC to SAP MDI

Login to SAP SuccessFactors Employee Central and go to the Security Center page.

SF%20Security%20Center

SF Security Center

Maintain the OAuth configuration based on the Service key info of Master Data Integration service instance.

Configuration Name: <User-definable>

OAuth Type: OAuth 2.0

Grant Type: Client_Credentials

Client ID: <uaa.clientid of service key>

Client Secret: <uaa.clientsecret of service key>

Token URL: <uaa.url + /oauth/token>

Token Method: POST

Content-type: application/x-www-form-urlencoded

SF%20OAuth%20Configurations

SF OAuth Configurations

Navigate to the Business Scenarios page. Find the scenario “Workforce Replication from EC to SAP Master Data Integration” and activate the scenario.

SF%20Business%20Scenarios

SF Business Scenarios

Confirmation%20Info

Confirmation Info

Click the pen icon on the right to start configuring the settings.

Integration Name: <User-definable>

Description: <User-definable>

Destination Page Size: <By default, the value of the Destination Page Size is set to 100>

Workforce%20Replication%20from%20EC%20to%20SAP%20Master%20Data%20Integration%20-%20Options

Workforce Replication from EC to SAP Master Data Integration – Options

Configure filters and sorting. For initial load, no filters and sorting needed.

Workforce%20Replication%20from%20EC%20to%20SAP%20Master%20Data%20Integration%20-%20Filter%20and%20Sort

Workforce Replication from EC to SAP Master Data Integration – Filter and Sort

Configure destination settings.

Connection Name: <User-definable>

REST API URL: <url value of service key>

Authentication Type: OAuth

OAuth Configuration: <Create in Security Center above>

HTTP Method: POST

Source Page Size: <400 by default>

Enable Server Side Pagination: <Make sure it’s not selected>

Enable diagnostics for Run Now: <Select if only for trouble-shooting purpose>

Workforce%20Replication%20from%20EC%20to%20SAP%20Master%20Data%20Integration%20-%20Destination%20Settings

Workforce Replication from EC to SAP Master Data Integration – Destination Settings

Remain the setting by default.

Workforce%20Replication%20from%20EC%20to%20SAP%20Master%20Data%20Integration%20-%20Scheduling

Workforce Replication from EC to SAP Master Data Integration – Scheduling

Save and choose Run Now to start the integration. Refresh the latest runtime on the Refresh icon and click on it. Then you can access the integration center to monitor the integration.

Workforce%20Replication%20from%20EC%20to%20SAP%20Master%20Data%20Integration%20-%20Review%20and%20Run

Workforce Replication from EC to SAP Master Data Integration – Review and Run

Step4: 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%20MDO%20Instance

Create MDO Instance

Then navigate to Services > Instances and Subscriptions, you will find the Master Data Integration (Orchestration) has been subscribed.

MDO%20Instance

MDO 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%20Collections

Role Collections

Step5: 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.

MDO%20UI

MDO 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: <Select the businessSystemId that created in step 1>

Then Save and Activate it. After activation, the active model is replicated to the provider.

Manage%20Distribution%20Model

Manage Distribution Model

Manage%20Distribution%20Model

Manage Distribution Model

Manage%20Distribution%20Model

Manage Distribution Model

Step6: Use Postman to test the setup

The log API is the url value of service key + /v0/odm/2.0.0/log/sap.odm.workforce.WorkforcePerson

Postman

Postman

With this we have completed the Workforce Integration from SAP SuccessFactors to SAP Master Data Integration service. Please feel free to leave the comments with your feedback and thoughts.