Troubleshooting Data Replication from SAP SuccessFactors Employee Central

You must have permission to access the ECPAO_IN_QUAR transaction. The permission is included in the template role that we provide for a user who is to analyze the replication and troubleshoot it if necessary: SAP_HR_ECPAO_ANALYSIS.

You can use the Identify to Exclude from Processing (ECPAO_IN_EE_EXCP) transaction to find the employee for whom the exception occurred.

With the Exclude Employees from Processing (ECPAO_IN_QUAR) transaction, you can exclude an individual employee for whom an exceptional error occurred from processing in SAP S∕4HANA. The other employees can be processed and their data can be updated in the corresponding infotypes.

1. Go to the Exclude Employees from Processing (ECPAO_IN_QUAR) transaction in your SAP S∕4HANA system to run the Temporarily Exclude Employees from Processing of Replicated Data (ECPAO_MNTN_ECPAO_IN_QUAR) program.

   The program calls the Employees Temporarily Excluded from Productive Processing (ECPAO_IN_QUAR) view.

2. Choose New Entries.
3. Choose the value help (for example, by pressing the F4 key).
4. Search for the external employee ID from Employee Central.
5. Double-click the person GUID found to copy it to the view.

   We use the person GUID because it is unique.

6. Save your entries.

When you try to process the replication request of an employee whose person GUID has been added to the Employees Temporarily Excluded from Productive Processing view, the request gets the status Failed. The application log displays a corresponding error message. The replication requests of the other employees can be processed as usual.

Analyze and fix the problem. You can, for example, process the replication request for the employee in question again in the staging area to find out more about what caused the exception and how to solve it. After you've fixed the error, go to the ECPAO_IN_QUAR transaction again (or go to the ECPAO_IN_EE_EXCP transaction) and remove the employee's person GUID from the Employees Temporarily Excluded from Productive Processing view to enable the processing of their data again.

We don’t recommend parallelizing data replication from Employee Central because parallelization wouldn’t improve the performance significantly.

It would be a possible approach to parallelize data replication by triggering the same integration process multiple times from the SAP S∕4HANA system and defining appropriate selection parameters to make sure that each of these process instances transfers a different set of data. But because the middleware sends the data asynchronously to the SAP S∕4HANA system, SAP S∕4HANA rather than the middleware is the limiting factor.

We recommend that you use the default setting of 400 configured in the middleware. If you want to change the package size, we recommend that you don't send very small packages because this generates numerous inbound calls to your SAP S∕4HANA system. A large number of calls can interfere with the processing queue, thus impacting the performance.

We don’t recommend trying to achieve a real-time integration by using very short replication cycles (such as replicating every minute). If you need to replicate a specific employee immediately, use push replication.

If you replicate different types of data from Employee Central to your SAP S∕4HANA, we recommend that you schedule the replication processes with the same interval but with different timelines to avoid running multiple replication processes at the same time.

Define the schedule for replication of organizational objects by object type, based on how frequently changes are being made in Employee Central.

We don’t recommend that you have server-side paging disabled in SAP SuccessFactors Provisioning. Employee master data and organizational assignment replication uses the CompoundEmployee API to request data from Employee Central. The API uses server-side paging to optimize the performance if large amounts of data need to be read.

We recommend that you use as few transformation template groups as possible. Combine as many entities as possible in one template group. For replication of organizational objects, you can use the filtering to differentiate between entities if necessary. This configuration reduces the number of subsequent queries being sent by the SAP S∕4HANA system.

You can disable sending confirmations for replicated employees from SAP S∕4HANA to Employee Central during the initial load. You can enable the confirmations again when the initial load is complete and you switch to delta replication.

To disable confirmations, go to Customizing for the Business Integration Builder and choose Employee Data→ Configuring the Selection of Employee Data for Replication→ Define Parameters for Employee Master Data and Org. Assignment Query. Then select the No Confirmation checkbox. Even if confirmations are disabled, you can analyze errors that occur during the initial load using the application log in the SAP S∕4HANA system.

We recommend that you disable extended logging in the middleware. Enable extended logging only if there is a problem with analyzing the issue during the replication.

Before using the check tool, complete the following steps:

1. Enable Metadata Framework.
2. Assign Access Check Tool and Allow Configuration Export to your role in Role-Based Permissions (RBP).
   • Access Check Tool authorizes users to access the tool.
   • Allow Configuration Export authorizes users to attach configuration information to a ticket.
3. Some checks have a quick fix, which can be used to immediately correct any issues found by that check. If you want to use the Quick Fix feature for the checks that have it, assign the Allow Check Tool Quick Fix permission.

Refer to Guided Answers for the Check Tool for a guided navigation through the available check tool checks and more information on each check.

The SAP SuccessFactors check tool helps you identify and resolve issues when your system doesn’t work as you expect. When you run the check tool, you can see the list of issues in your configuration or data, the severity of each issue, and the solution or recommendation to address the issue.

Use the check tool to perform the check in Employee Central for any configuration issues that might impact the integration process.

To access the check tool from the SAP SuccessFactors Admin Center page, complete the following steps:

1. Go to Admin Center.
2. In the tools search field, type Check Tool.
3. In Application, select EC ERP Replication.
   Note

   All Applications runs checks in all your applications.

   You see the checks for the application you selected. The description for each check describes the situation you hope to find in running the check. For example, in running the check Employee Central Position Management feature is enabled, you hope to find that the Position Management Switch is indeed enabled.

4. To run all checks, select the checkbox in the top left-hand side of the table. To run some checks but not others, select the check you wish to run.
   Note

   To understand what a check does, right click the Check ID. The system then displays some information on the check.

5. Click Run Checks to check your applications for the checks you selected.