Monitor Employee Replication Process
Monitor Employee Replication Process
1 Change History. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Learn about changes to the documentation for Employee Central Data Replication Monitor in recent releases.
1H 2023
Added We added information on the new func Mass Exporting Entries from the Data
tionality to mass export entries from the Replication Monitor [page 23]
Data Replication Monitor.
Changed We updated the documentation of per Granting Permissions for the Data Repli
missions to reflect some changed per cation Monitor [page 6]
mission requirements. Use the updated
page to adapt your role configuration ac
cordingly. In addition, we introduced two
checks in the Check Tool which can be
used to verify the permission related set
tings for the Data Replication Monitor.
2H 2022
Added We added the new employee data replica • Data Replication Monitor [page
tion status Awaiting Processing. 4]
• Selecting Data in Data Replication
Monitor [page 16]
• Taking Action from the Replication
Results in Data Replication Monitor
[page 18]
• New Status Added and Replication
Content Type Removed in the Data
Replication Monitor
Changed We updated the documentation of per Granting Permissions for the Data Repli
missions to reflect some changed per cation Monitor [page 6]
mission requirements. Use the updated
page to adapt your role configuration ac
cordingly. In addition, we introduced two
checks in the Check Tool which can be
used to verify the permission related set
tings for the Data Replication Monitor.
Use the Employee Central Data Replication Monitor with improved performance and a new interface to monitor
data replication from Employee Central to other systems.
Data Replication Monitor provides information about the successful, pending, awaiting processing, or failed status
of employee data replication between Employee Central and target systems.
Here's a table that shows what data can be replicated and to which target systems:
Make the required settings to show the Data Replication Monitor either on the home page or in the Admin Center
and to use it in data replication from Employee Central to Employee Central Payroll or SAP S/4HANA or SAP ERP.
Make the required settings in Provisioning to show the Data Replication Monitor tool in the Admin Center and to
have the monitor updated with the notifications and confirmations sent by the corresponding standard integration.
Procedure
1. Log on to Provisioning.
Remember
As a customer, you don't have access to Provisioning. To complete tasks in Provisioning, contact
your implementation partner or Account Executive. For any non-implementation tasks, contact Product
Support.
Next task: Granting Permissions for the Data Replication Monitor [page 6]
Give users the permissions they need to access the Data Replication Monitor and use it to monitor data replication
from Employee Central to target systems.
Prerequisites
• Make sure you've set up People Search as described at Configuring Role-Based Permissions to Allow Logged In
User to View Certain Employee Information in People Search Results.
• Make sure that the Data Replication Monitor user has the necessary permissions to display required
information in the Employee Profile. For more information, see User Permissions for Employee Central.
Context
The check The user has the required permissions to access the Data Replication Monitor and to perform necessary
actions. can be used to verify a specific user’s Data Replication Monitor-related permission setup.
Note
This check does currently not cover field permissions listed below under categories User Permissions
Employee Data and User Permissions Employee Central Effective Dated Entities for External Target
Populations (Onboardees). These need to be verified manually in Manage Permission Roles.
Procedure
Give users the following permissions to enable them to access all features provided by the tool:
Under Administrator Permissions, select the Employee Central Select the Employee Central Foundation OData API (read-only)
API category. permission.
Under Administrator Permissions, select the Metadata Select the Access to non-secured objects permission.
Framework category.
This permission allows a user to access information provided
by MDF objects (such as the Replication Target System) which
are not set to secured when viewing data replication records in
the Data Replication Monitor.
Under Administrator Permissions, select the Manage Hires Select the Include Inactive Employees in the Search permis
category. sion.
Under User Permissions, select the General User Permission Select the following:
category. • Live Profile Access
This permission allows a user to access the employee file
from records in Data Replication Monitor.
Under User Permissions, select the Employee Data category. Under Employment Details, select the View option for:
• Employment Details MSS
• Assignment Id External
Under User Permissions, select the Employee Central Effective Under Job Information, select the View Current option for these
Dated Entities category. fields:
• Company
• Country of Company
• Location
• Employee Class
• Pay Group
• Pay Group
These settings are required to ensure that the user can see all
expected records when using the respective filter options.
Recommendation
We recommend that you set the Employee Data Replication Status (EmployeeDataReplicationElement)
object to secured.
Note
If you have secured the Employee Data Replication Status (EmployeeDataReplicationElement) object in
the object definition, you can choose the Permission Category, for example SAP System Configuration, which
controls the category in the Permission Roles page. In the Permission Roles page, you can select the View and
Edit option to be able to reprocess and delete entries from the Data Replication Monitor.
If you have additionally secured one of the following objects in the object definition, you need to grant at least
View permission to your Data Replication Monitor role:
• Country/Region (Country)
• Employee Data Replication Confirmation (EmployeeDataReplicationConfirmation)
• Employee Data Replication Confirmation Error Message
(EmployeeDataReplicationConfirmationErrorMessage)
• Translations (GOLocalizedData)
• Legal Entity (LegalEntity)
• Picklist (PickList)
• Picklist Value (PickListValue)
• Replication Target System (ReplicationTargetSystem)
Note
If you use Onboarding, you need to set up two target populations for your Data Replication Monitor role to
ensure that all information is displayed correctly: one for regular employees and one external target population
for external Onboarding users.
If you want to use the Data Replication Monitor with full access to all records but have issues with name display
it is a best practice to set up a second role that grants access to all field permissions under category User
Permissions Employee Data with a target population of all employees (and all onboardees if relevant).
Next task: Restricting Administrator Access to the Employee Central Data Replication Monitor [page 9]
Related Information
Restrict access to the Data Replication Monitor to specific target groups, so that an admin can see data replication
records only for a specific group of employees. The check Target population doesn’t contain too many users. can be
used to verify a specific user’s Data Replication Monitor-related permission setup.
Procedure
1. Restricting Access to Data Replication Monitor by the Replication Target System [page 10]
Restrict access to specific data replication records in the Data Replication Monitor, by securing the
replication target system and defining role-based permissions based on it.
2. Restricting Access to Data Replication Monitor by Legal Entity (Country/Region or Company) [page 12]
Restrict access to specific data replication records in the Data Replication Monitor, by defining role-based
permissions based on the Legal Entity object.
Previous task: Granting Permissions for the Data Replication Monitor [page 6]
Next task: Configuring Target Systems for the Data Replication Monitor [page 14]
Restrict access to specific data replication records in the Data Replication Monitor, by securing the replication
target system and defining role-based permissions based on it.
Context
Example
Let's assume you grant administrators access to data replication records related to the replication target
systems SYS1 and SYS2, using the generic objects Employee Data Replication Status and Replication Target
System.
Procedure
These steps allow you to restrict access to data replication records with a specific target system. To also reduce
the list of values shown for the Replication Target System selection criterion in the Data Replication Monitor,
you need to secure the generic object Replication Target System as well. That is, repeat the same steps for
Replication Target System.
Note
You can also restrict access to the Data Replication Monitor by securing other generic objects, such as Pay
Group or Location. But this does not reduce the list of values shown for the corresponding selection criteria
Caution
As soon as you set an object definition to Secured, admins no longer have permission to see or change the
corresponding object. The object will be shown in the relevant permission roles, but no permissions will be
set for it. This also applies to existing permission roles. You need to explicitly grant the required permission
Note
This is the default category. If you selected another permission category when securing the generic
objects, the permissions are shown in this other category, not under Miscellaneous Permissions.
d. Select the View checkbox for Employee Data Replication Status and Replication Target System, then
choose Done.
e. Scroll down to Grant this role to... and choose Add.
f. Under Specify the target population for the other objects, you'll see the secured objects, Employee Data
Replication Status and Replication Target System.
g. For both objects, select Restrict target population to: and specify the replication target systems, such as
SYS1 and SYS2, then choose Done.
Results
An admin who is granted the permission role only sees data replication records for employees whose data is
replicated to one of the target systems SYS1 or SYS2. The dropdown list of the Target System selection criterion
only shows these two systems.
Task overview: Restricting Administrator Access to the Employee Central Data Replication Monitor [page 9]
Next task: Restricting Access to Data Replication Monitor by Legal Entity (Country/Region or Company) [page 12]
Restrict access to specific data replication records in the Data Replication Monitor, by defining role-based
permissions based on the Legal Entity object.
Context
Example
Let's assume you grant administrators access to data replication records created for employees in whose
employment information the country/region assignment is either United States (USA) or Germany (DEU).
The Data Replication Monitor selection criteria Country/Region and Company both refer to the MDF foundation
object Legal Entity. This object is secured by default. You can’t change this setting.
Caution
Restricting access to the Data Replication Monitor through target populations can severely impact the
performance of the UI. The larger the target population, the bigger the impact on the performance. Please avoid
checking the option Exclude Granted User from having the permission access to him/herself, when assigning
the role to a target population which includes Everyone. This would create a target population containing all
employees except the logged on user.
The check Target population doesn’t contain too many users. can be used to verify a specific user’s Data
Replication Monitor-related permission setup.
Procedure
Note
This permission requires the Access to Data Replication Monitor permission to be set.
3. Create a permission group to define the group of administrators that have restricted access to the Data
Replication Monitor.
a. Go to the Admin Center and choose the Manage Permission Groups tool.
b. Choose Create New and enter a group name.
c. Under Choose Group Members, define which group of people is to get access to the Data Replication
Monitor.
4. Create another permission group to define the target population the administrators have access to.
Note
The Job Information-Company-Country category is only available if permission group filters are
configured in your Succession Data Model in Provisioning as shown here:
<dg-filters>
<permission-group-filter>
<hris-element-ref refid="jobInfo">
[...]
<hris-field-ref refid="company"/>
<hris-field-ref refid="company" ref-field="countryOfRegistration"/>
[...]
</hris-element-ref>
</permission-group-filter>
</dg-filters>
Remember
As a customer, you don't have access to Provisioning. To complete tasks in Provisioning, contact your
implementation partner or Account Executive. For any non-implementation tasks, contact Product
Support.
5. Set up role-based permissions for the group of administrators and define the target population for them.
a. Go back to the Admin Center, choose the Manage Permission Roles tool, and select the permission role you
want to configure for restricted use of the Data Replication Monitor.
b. Grant access to the secured Legal Entity object.
1. Go to Permission Settings and choose Permission....
2. Go to Administrator Permissions and choose MDF Foundation Objects .
3. Select the View Current checkbox for Visibility of the Legal Entity object, then choose Done.
c. Grant the role to the group of administrators who are to get restricted access.
1. Go to Grant this role to... and choose Add.
2. In the first step, Define whom you want to grant this role permission to. Select the permission group you
created first, to define which group of people is to get access to the Data Replication Monitor.
3. In the second step, Specify the target population whom the above granted users have permission to
access, select the permission group you created second, to define the target population.
This step reduces the result list.
4. In the third step, Specify the target population for the other objects, you see Legal Entity. Select Restrict
target population to: and specify the countries/regions, such as United States and Germany, then
choose Done.
This step reduces the list of entries shown for the Country/Region dropdown.
Results
Administrators who are granted the permission role you just defined only see data replication records for
employees who have a job in one of the US or in Germany. For these admins, the dropdown list of the Country/
Task overview: Restricting Administrator Access to the Employee Central Data Replication Monitor [page 9]
Previous task: Restricting Access to Data Replication Monitor by the Replication Target System [page 10]
Enter the external codes of the Replication Target System objects you created in Employee Central for use in the
corresponding integrations when setting up the target systems for Employee Central Data Replication Monitor.
Procedure
In the Data Replication Monitor, specify exactly the same external code as you entered in either middleware or the
SAP S/4HANA or SAP ERP system when setting up the parameters for the corresponding replication process.
Previous task: Restricting Administrator Access to the Employee Central Data Replication Monitor [page 9]
Next task: Configuring the Data Replication Monitor using a Configuration Object [page 14]
Configure the Data Replication Monitor configuration by creating a Data Replication Monitor Configuration object.
Context
The Data Replication Monitor Configuration object helps you to change the default behavior for the Employee Class
and Pay Group filters in the DRM UI if required.
2. Select Create New Data Replication Monitor Configuration . If the object is secured, the administrative
user needs view/edit permissions for it.
3. Select the picklist to use as the target object for the Employee Class field. The system default is the
EMPLOYEECLASS picklist.
4. Select the target entity for the Pay Group Filter. The system default is for Compensation Information.
5. Save your settings.
Results
The Data Replication Monitor will consider the configurations made in the Data Replication Monitor Configuration
object instead of the standard settings.
Previous task: Configuring Target Systems for the Data Replication Monitor [page 14]
Use the options available in Employee Central Data Replication Monitor to view exactly the data you require.
Taking Action from the Replication Results in Data Replication Monitor [page 18]
Use the replication results to display additional information and take corrective action where necessary.
Context
You want to monitor data replications from Employee Central to designated target systems.
Procedure
Note
Use Ctrl+A to select all entries in the dropdown list in each filter.
Employees with active and inactive employment records found in the search are added to the
existing filters.
Note
• Replication Time
• All Until Now
• Last Week
• Last 24 Hours
Note
• Last Hour
• Last 15 Minutes
Instead of choosing any of the above, you can select Custom Range and enter date and time.
3. If you want to refine the data replication search further, choose Adapt Filters. There are Basic and Employee
filters. The search criteria is applied to person-based replication content types to persons with all employments
or to user-based replication content types with dedicated employments. Expand the Employee to choose the
filters you want from:
• Company
• Country/Region
• Employee Class
• Location
• Pay Group
4. When you've made all your selections, choose Go.
Use the replication results to display additional information and take corrective action where necessary.
Procedure
1. When you run the data replication report based on your required selections as described in the Selecting Data
in Data Replication Monitor [page 16] documentation, the system displays a list of the data that satisfies those
criteria. The list shows:
• Object Name
• Replication Content Type
• Status
That is, the status of the replication. Possible statuses are:
• Successful
• Pending
• Awaiting Processing
• Failed
• Messages
Take a look at step 3 below for more information on messages and what to do about them.
• Last Replicated
This field shows the date of the most recent replication for the object shown in this line.
• Replication Scheduled For
This field shows the date of the next scheduled replication for the object shown in this line.
2. You can adjust the display using the filters provided, which are the same filters you could choose from before
you ran the report. To make any adjustments, choose Adapt Filters, then make any changes and select Go. The
system then displays the data using the new filters.
3. You can take corrective action for any errors found by selecting the relevant message to show details of the
replication. In the resulting screen, select the right-pointing arrow next to the message text, then use the link to
access the tool you need to use to correct the error, for example, the Time Off Workbench or People Profile.
Action Description
Select All checkbox Select all loaded entries for mass reprocessing, deletion, or
export. To select more entries than shown, scroll down the
list to load more entries on the page and then reselect the
Select All checkbox.
Related Information
For certain errors, data replication is reprocessed automatically. You can also reprocess the replication manually.
Prerequisites
Users supposed to be able to reprocess records need to have the Edit permission for Employee Data Replication
Status if security based on RBP is added. The reprocessing is only for the replication content types Employee
Master Data, Employee Absence Data, Time Pay Components, and Planned Working Time
Automatic Reprocessing
There are certain errors that aren’t caused by incorrect employee data or faulty mapping logic. These errors
usually occur when data is locked or in correction phase. In these cases, the system automatically reprocesses the
replication.
Message type ID from incom Relevant for replication con Waiting time before next rep
Message ing confirmation message tent type lication run starts
Note
If the replication error comes from the SAP S/4HANA or SAP ERP system, the message type ID consists of the
SAP S/4HANA or SAP ERP message number and, in brackets, the SAP S/4HANA or SAP ERP message class.
For the errors that have a default waiting time of 60 minutes, you can override the default by setting a replication
time offset in the configuration of the Replication Target System object. There, you can enter the number of minutes
you want the resend of data to be delayed by when the payroll area is locked or in correction phase. If you don't set
a replication time offset in the configuration of the Replication Target System object, the default time offsets listed
in the table are used.
Overriding automatic rescheduling is only possible for errors that have a default waiting time specified in the
table, and only for the replication content types Employee Master Data, Employee Absence Data, Time Pay
Components, and Planned Working Time.
Manual Reprocessing
You can trigger a replication run for one or more employees in Data Replication Monitor. Select the employees and
choose Reprocess to reprocess selected items in the next replication run. A popup appears asking if you want to
ignore data correction lock in the replication target system. If you select Yes, the Scheduled Replication Time field is
set to the current time and the flag Allow Replication in Correction Phase is set to True for the respective employee
or employees. This means that the employee data is replicated to the target system, even if payroll is in correction
phase. In this case, the error message Payroll area in correction phase isn't generated.
If you select more than one record and choose Reprocess, you're shown a confirmation popup with information
about the records to be sent. You can still cancel manual reprocessing at this point.
Note
If you use combined replication of employee master data together with organizational assignments from
Employee Central to SAP S/4HANA or SAP ERP, triggering a replication run for one or more employees in
Data Replication Monitor also triggers organizational assignment replication for the employees in question.
But organizational assignment replication only happens, when the employees' master data was posted without
errors in the SAP S/4HANA or SAP ERP system.
You can also trigger a replication run for one or more employees (including their organizational assignments)
from the SAP S/4HANA or SAP ERP system, using the query program there.
You can delete entries you no longer need for monitoring from the Data Replication Monitor. For example, because
they were created during a test phase.
Prerequisites
To delete records, users need to have Delete Records from Data Replication Monitor permission granted. Only if
this permission is granted, the Delete option is shown in the standard view. In addition, they need to have the Edit
permission for Employee Data Replication Status if security based on RBP is added.
Select all records you want to delete in the result list and choose Delete. A message appears asking you Do you
really want to delete the selected records? If you confirm deletion, the selected records will immediately be deleted.
If you have selected more than ten records to be deleted, the records will immediately be flagged as Deleted and
will no longer be visible in the Data Replication Monitor. But deletion doesn't happen immediately in this case.
Instead, a background process is triggered, which will delete the records from the database in packages of 1000.
The system decides when the background process runs. Once it is started, it searches for all records that are
flagged as Deleted to delete them from the database. Once the background process has started to run, you can
check the status and download it in the Comma-Separated Values (CSV) format from job monitoring. To do this, go
to Admin Center and choose the Monitor Job tool.
Note
The numbers shown in the Monitor Job tool can differ from the number of records you've selected for deletion.
Here's why:
• The total number of deleted records might be smaller than the number of records you've selected for
deletion. This is because meanwhile another background process might already have run and deleted some
of the records.
• The total number of deleted records might also be higher than the number of records you originally
selected for deletion. This is because the background process picks up all records that are flagged as
Deleted. There might be other records for which deletion was triggered by another user.
If a deletion background process failed and records flagged as Deleted remain in the database, you can start a
deletion job manually, without triggering deletion from the Data Replication Monitor.
To do this, go to Provisioning for your instance and go to the Managing Job Scheduler section. From here, choose
Manage Scheduled Jobs, then Create New Job. Enter job name and job owner and choose the job type Employee
Data Replication Element Deletion, but don't select the Clean Up Orphaned Records from Data Replication Monitor
parameter. Then choose Create Job.
Remember
As a customer, you don't have access to Provisioning. To complete tasks in Provisioning, contact your
implementation partner or Account Executive. For any non-implementation tasks, contact Product Support.
You can export entries from the Data Replication Monitor to a spreadsheet for further processing.
Select all records you want to export in the result list and choose the Export to Spreadsheet icon. The selected
entries are exported to a spreadsheet program, for example, Microsoft Excel.
All columns and entries are shown in the spreadsheet, including ones not selected on the Data Replication Monitor
UI. The external ID column displays the person ID external separately, even though it is shown in the UI with
the object name. The error messages are also shown for each entry. You can use the standard functions of the
spreadsheet for further sorting and filtering, or adding custom columns for notes.
As a HR administrator, you can mass export entries from the Data Replication Monitor to a spreadsheet for further
processing.
Context
To mass export records, administrators need to have the Mass Export from Data Replication Monitor permission
granted. Use the path Permission Roles Permissions Manage Integration Tools Mass Export from Data
Replication Monitor . Only if this permission is granted, the options are displayed in the standard view.
Procedure
You can only export up to 10000 record results at once. Use the status filters on the Data Replication
Monitor to load relevant results.
Hyperlinks
Some links are classified by an icon and/or a mouseover text. These links provide additional information.
About the icons:
• Links with the icon : You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your agreements
with SAP) to this:
• The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.
• SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any
damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.
• Links with the icon : You are leaving the documentation for that particular SAP product or service and are entering an SAP-hosted Web site. By using such links,
you agree that (unless expressly stated otherwise in your agreements with SAP) you may not infer any product claims against SAP based on this information.
Example Code
Any software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax and
phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of example
code unless damages have been caused by SAP's gross negligence or willful misconduct.
Bias-Free Language
SAP supports a culture of diversity and inclusion. Whenever possible, we use unbiased language in our documentation to refer to people of all cultures, ethnicities, genders,
and abilities.
SAP and other SAP products and services mentioned herein as well as
their respective logos are trademarks or registered trademarks of SAP
SE (or an SAP affiliate company) in Germany and other countries. All
other product and service names mentioned are the trademarks of their
respective companies.