Querying Employee Master Data and Organizational Assignments from SAP SuccessFactors Employee Central

The following is the recommended approach! New configurable approach; configurable organizational assignment: In the new ECS4HCM add-on, customers can configure what data is replicated from Employee Central to reflect the organizational assignments of the employees in the SAP S/4HANA system.

Previous (nonconfigurable) approach; classical org. assignment: In the PA_SE_IN add-on, the replication of organizational assignments wasn’t configurable. The way how position relationships were created in the SAP S/4HANA system was hard-coded. All additional or deviating logic could be influenced only by implementing a Business Add-In (BAdI).

With the configurable organizational assignment, you can:

• Configure the standard (hard coded) relations between employee position and assigned objects and also other SAP S/4HANA relations and SAP S/4HANA custom relations.
• Map the Employee Central object IDs from standard fields and also from customer fields.
• Fill extra fields (such as PROZT) of relations from customer fields.
• Configure a flexible org. hierarchy.
• Configure any kind of job relationships.
• Copy sample content for the standard organizational assignment relations.
• With the new configurable organizational assignment, organizational assignment BAdIs are no longer called.
• "Reduced organizational assignment" constants to exclude relations are no longer considered. Instead, only those HRP1001 relations that are not written by the generic organizational object replication must be configured.

The settings for the query report are configured per transformation template group through the customizing activity Define Parameters for Employee Master Data and Org. Assignment Query:

• Restrict data replication to: Company, country/region, employee class, type of workforce.
• Decide whether the query only transfers employments whose company and country/region assignment matches the defined company and country/region filters.
• Include organizational assignments into the replication.
• Prevent replication of organizational assignments for employees with specific employment statuses.
• Specify the target system of the data replication that DRM is to monitor.
• Specify to use the external cost center ID instead of the internal cost center ID for the mapping.
• Enable the replication of multiple job events per day.
• Enable the replication of multiple compensation events per day (only available for Brazil.)
• Enable notifications being created for the Employee Central Data Replication Monitor.
• Disable confirmations being sent to the Employee Central Data Replication Monitor.

The query program Create and Execute Employee Master Data and Org. Assignment Query (ECPAO_EE_ORG_REPL_QUERY) creates and sends a query to replicate employee master data from SAP SuccessFactors Employee Central to the SAP S/4HANA system.

Transformation template group (mandatory):

• The query runs for all employees specified by the selection criteria, based on the transformation template group that is entered on the selection screen and based on the configuration stored for this transformation template group.
• Which data is queried from Employee Central depends on which transformation templates are contained in the template group.
• The earliest transfer date of the transformation template group defines the full transmission start date (FTSD) to be used for data replication.

External employee ID (optional):

• Entering specific IDs triggers a full load for the employees in question.
• To improve the performance, only a maximum number of 500 employees can be selected at a time.

Change date (optional):

• Employees whose master data (or organizational assignments if applicable) was changed after this date are queried.
• The change date must not be more than three months in the past and must be before the last modified date. If a change date is entered, the last modified date is reset to this change date.

Enable payload logging (optional):

• With this option, extended information is transferred to the process log in the middleware.
• This completes the options of the query program Create and Execute Employee Master Data and Org. Assignment Query.

The SAP S/4HANA system creates a replication request for each employee in the staging area when a replication run contains new or updated data for this employee. Writing replication requests to the staging area triggers the event SAP_SFIOM_EE_ORGAS_RPPQ_CREATED in the SAP S/4HANA system.

The processing program Process Employee Replication Requests (ECPAO_RPRQ_EE_PROCESSING) is used to process replication requests from the staging area for employee master data and employee organizational assignments replicated from SAP SuccessFactors Employee Central. The processing program can be scheduled as a regular background job that is registered on the triggered event.

The processing program can also run in dialog mode to process a specific set of replication requests:

• External employee ID: Enter external employee IDs to process the requests of one or more specific employees.
• Include failed requests: Select this checkbox to process the latest request of employees although it has the status Failed.
• Parallel processing: Keep the default setting to process multiple packages with replication requests in parallel.
• Server group name: Select a server group if server groups are used for specific purposes in the system. If a specific server group is not selected, the program uses all available work processes on all server groups.
• Sequential processing: To process packages one after the other instead of in parallel, select this option.