Using the Staging Area for Organizational Object Replication Requests

Access the staging area for organizational objects replicated from Employee Central using the staging area viewer to:

• View detailed information.
• Analyze errors.
• Check the payload of requests.
• Simulate the processing.
• Process selected requests manually.

In the setup phase of the replication, for example, errors can occur frequently. You can analyze these errors with the staging area viewer, then run the replication again. Then analyze again, and so on, until the replication runs successfully and you can start regular processing of the data in SAP S∕4HANA.

You must have permissions to access the View Org Object Replication Requests (SFIOM_VIEW_ORG_REQS) transaction and the staging are table and to edit personnel data. The permissions are included in the template role that we provide for the processing user: SAP_HR_SFIOM_PROCESSING.

Change the selection to define which replication requests are to be shown in the staging area viewer for organizational objects replicated from Employee Central.

When called for the first time, the staging area viewer shows the latest replication request that has the status Open, Pending, or Failed for each organizational object that has been replicated to the SAP S∕4HANA system.

1. Go to the View Org Object Replication Requests (SFIOM_VIEW_ORG_REQS) transaction in your SAP S∕4HANA system.
2. Choose Change Selection.
3. Select the statuses you wish to see in the Replication Status field.
4. Enter object types and IDs if you’re interested in one or more specific organizational objects.
5. Change the number of days if you’re interested in a specific time frame.
6. Select All Reqs. for Selected Objects to view not only the latest, but all existing requests for an organizational object.

To view all objects that had a replication request within the last five days, don't enter any IDs. Remove all values from Replication Status and enter 5 in the Message Younger Than (Days) field.

To view specific objects only if they had a replication request within the last five days, enter the object type and IDs of the objects you're interested in. Remove all values from Replication Status and enter 5 in the Message Younger Than (Days) field.

To process replication requests from the staging area viewer, you must have permissions to access the View Org Object Replication Requests (SFIOM_VIEW_ORG_REQS) transaction and the staging area table. To process replication requests from the Replication Request Monitor, you must have permissions to access the SFIUI_A_REPL_REQ_MONITOR Web Dynpro application. In both cases, you also need the permission to edit HR data. The permissions are included in the template role that we provide for the processing user: SAP_HR_SFIOM_PROCESSING.

Organizational object replication requests are processed in the background so that the updates contained in them are stored in the SAP S∕4HANA infotypes in a timely manner. But you can also trigger the processing manually so that you don't have to wait for the next scheduled program run.

You can process requests manually from the staging area viewer or from the Replication Request Monitor.

Locking of the staging area is done by object type. While a specific object type, such as Business Unit, is processed, all Business Unit-related requests are locked. You can't process any Business Unit requests manually from the staging area at this point in time. But the other object types, such as Department, aren't affected by this lock. You can process a Department request manually, even while processing of Business Unit requests is currently running in the background.

1. To process replication requests from the staging area viewer, go to the View Org Object Replication Requests (SFIOM_VIEW_ORG_REQS) transaction in your SAP S∕4HANA system.
2. Select one or more entries.

   You can select multiple replication requests by holding down the Ctrl key as you select entries in the list.

3. Choose Process Selected Requests to trigger the processing of the organizational objects.
4. To process replication requests from the Replication Request Monitor, go to the SFIUI_A_REPL_REQ_MONITOR Web Dynpro application.

   This Web Dynpro application is assigned to the role menu of the SAP_HR_SFIOM_PROCESSING role. You can also add it to the SAP SuccessFactors user interface using the Configure Custom Navigation admin tool in Employee Central. This tool allows you to add hyperlinks to various locations in the SAP SuccessFactors UI, enabling users to navigate from that location to the specified URL. The URL to add is: <protocol><host name>/sap/bc/webdynpro/sap/sfiui_a_repl_req_monitor. For more information about the tool, refer to Managing Custom Navigation Links.

5. Select a request or multiple requests and choose Process Requests.

After you've triggered the actual processing, the system runs the processing program directly for the selected requests, without asking for confirmation. Processed replication requests disappear from the results list.

To run the program in dialog mode, you must have permissions to access the Delete Org Obj Replication Requests (SFIOM_DEL_ORG_REQS) transaction and the staging are table. The permissions are included in the template role that we provide for the processing user: SAP_HR_SFIOM_PROCESSING.

There are several approaches to cleaning up the staging area for organizational object replication requests:

• Automatic deletion: When replication requests have been processed successfully in the staging area, they get the status Successful. When a newer request is processed for the same object, an existing request with one of the statuses Open, Pending, or Failed gets the status Outdated. Along with the processing of the latest request, to free up memory space, the SAP S∕4HANA system deletes replication requests of processed objects with the status Successful or Outdated that were last modified 30 days ago or earlier.

• Manual deletion of individual requests: You can delete selected replication requests manually from the staging area viewer.

• Deletion in bulk (which we describe here): You can clean up the staging area table to remove requests with the status Successful or Outdated in bulk that the deletion during processing isn't able to cover. You can also delete requests with other statuses, depending on your requirements. If you do this, keep in mind that your SAP S∕4HANA system may no longer be in sync with Employee Central.

You can run the Delete Organizational Object Replication Requests (RH_SFIOM_DEL_ORG_STRUC_RPRQ) program in dialog mode to delete specific requests.

The default selection criteria define that the program is to perform a test run for the deletion of all replication requests with the following:

• Status Successful, Failed, or Outdated
• Created before the first day of the preceding month
• Last modified one week before today or earlier

You can also schedule the deletion program to run regularly in the background and delete replication requests with the status Successful or Outdated.

1. Go to the Delete Org Obj Replication Requests (SFIOM_DEL_ORG_REQS) transaction in your SAP S∕4HANA system to run the deletion program in dialog mode.
2. Optional: Specify a time frame for deletion depending on the creation date or the last modified date of the request or both of the dates.
3. Optional: Select the statuses for which you want to delete replication requests in the Replication Status field.
4. Select the object types for which you want to delete replication requests.
5. Optional: Enter object IDs if you want to delete the requests of one or more specific objects.
6. Select the Test Mode checkbox to perform a test run.
7. Check the list of replication requests that will be deleted according to your selection criteria.

   You can sort and filter the list.

8. Go back and perform another test run if you're not satisfied with the result.
9. Deselect the Test Mode checkbox to perform a productive run when you're satisfied with the result of the test run.

   The system shows an overview of how many entries were deleted and with which status.

10. Optional: Create a suitable variant for the Delete Org Obj Replication Requests program if you want to adjust the selection criteria for background processing.
11. Go to the Define Job (SM36) transaction in your SAP S∕4HANA.
12. Schedule the Delete Org Obj Replication Requests program (or your program variant) as a regular background job with the Date/Time start condition.
13. Select Periodic Job for the job to repeat.