Replicating Data From EC To ERP HCM Test Script
Replicating Data From EC To ERP HCM Test Script
2 Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3 Prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
4 Test Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
5 Test Procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
5.1 Hire an Employee. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
5.2 Replication Reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Replicate Organizational Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Replicate Employee Master Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Replicate Organizational Assignments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
5.3 Status Check of Replication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Status Check of Organizational Data Replication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Status Check of Employee Replication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Status Check of Staging Area for Organizational Objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Status Check of Staging Area for Employee Organizational Assignments. . . . . . . . . . . . . . . . . . .25
Analyze Application Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
5.4 Check Replicated Infotypes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
6 Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
7 Process Chains. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
This guide provides a test of scope item Replicating Data from Employee Central to ERP HCM for the SAP
Best Practices for SAP SuccessFactors Employee Central Integration with SAP ERP HCM Payroll solution.
Following this guide, you get a description how to replicate data from your new system of records, Employee
Central, to ERP HCM, which contains your payroll data. The replication needs to be done as soon as changes to
the data in Employee Central occur, because they must be replicated to ERP HCM to update the Infotypes.
• Hire an Employee
• Replication Reports
• Status Check of Replication
• Check Replicated Infotypes
The scope item Migrating Data from ERP HCM to Employee Central provides localized data. You can run this test
with any of the following countries:
This test consists of several process steps provided in the table below.
Report/Action/Trans
Process Step Business Role System action Expected Results
Hire an Employee Administrative Super SAP SuccessFactors Add New Employee An Employee has been
[page 10] User
Employee Central hired.
Replicate Organiza HR Administrator ERP HCM RH_SFIOM_ORG_OBJ_ The staging area tables
tional Data [page 14] REPL_QUERY are updated.
Replicate Employee HR Administrator ERP HCM EC The report for Repli
Master Data [page PAO_EE_ORG_REPL_Q cation for Employee
16] UERY Master Data has been
processed.
Replicate Organiza HR Administrator ERP HCM RH_SFIOM_PROC_EE_ The report for Replica
tional Assignments ORG_ASS_RPRQ tion for Organizational
[page 18] Assignments has been
processed.
Status Check of Or HR Administrator ERP HCM RH_SFIOM_RE The Status of the
ganizational Data Rep SET_QRY_ADM Queries for the Organ
lication [page 21] izational Objects has
been checked.
Status Check of Stag HR Administrator ERP HCM RH_SFIOM_VIEW_OR The Replication Re
ing Area for Organiza G_STRUC_RPRQ quests for Organiza
tional Objects [page tional Objects have
23] been displayed.
Status Check of Stag HR Administrator ERP HCM RH_SFIOM_VIEW_EE_ The Replication Re
ing Area for Employee ORG_ASS_RPRQ quests for Employee
Organizational Assign Organizational Assign
ments [page 25] ments have been dis
played.
This section summarizes all prerequisites for conducting the test in terms of systems, roles, and business
conditions.
System Access
System Details
ERP HCM Payroll Your system details, such as system ID and client.
SAP SuccessFactors Employee Your instance details, such as URL and Company ID.
Central
Roles
This test is conducted with the following permission roles, which must be assigned to the users. The
permission roles are pre-delivered.
ERP HCM Payroll HR Administrator A System Admin Role is re Test user: <userid>
quired. An example is:
Password: <password>
SAP_AIO_CUSTOMER_IT_AD
MIN-S
SAP SuccessFactors Employee Administrative Super SAP BestPractices Super Ad Test user: <userid>
Central User min
Password: <password>
Before this test can be conducted, the following business conditions must be met:
Business Condition
5. The managers in the Employee Central instance have corresponding users in the ERP HCM system.
The organizational structure and master data of your company have been created in your system during
implementation. The organizational structure reflects the structure of your company and includes the
company, cost center and location in the system. The master data reflects employee specific data.
Use your own master data or the following sample data to conduct this test.
Last Name
Gender
Position
City
State
Replicate Organiza Transformation Template SBP_OM_EC_ERP With this SAP Best Practices solution,
tional Data Group for Organizational we deliver a Transformation Template
Object Replication Group SBP_OM_EC_ERP which con
tains a specific set of mappings. This
mapping information is used when
transferring data between Employee
Central and ERP HCM.
Replicate Employee Transformation Template SBP_EE_EC_ERP With this SAP Best Practices solution,
Master Data Group for Employee we deliver a Transformation Template
Replication Group SBP_EE_EC_ERP which con
tains a specific set of mappings. This
mapping information is used when
transferring data between ERP HCM
and Employee Central.
Status Check of Or Transformation Template SBP_OM_EC_ERP With this SAP Best Practices solution,
ganizational Data Rep Group we deliver a Transformation Template
lication Group SBP_OM_EC_ERP.
Status Check of Em Transformation Template SBP_EE_EC_ERP With this SAP Best Practices solution,
ployee Replication Group we deliver a Transformation Template
Group SBP_EE_EC_ERP.
Note
The data replication described in this process is based on mappings that create the relationships between
fields in Employee Central and fields in ERP HCM. This Best Practices solution delivers these mappings, for
example: Value Mappings, Infotype Mappings, and BAdI Mappings.
Before executing the following process steps, we recommend verifying and possibly adapting the content
of the delivered Mappings.
Purpose
Prerequisites
You must have run through all Migration Reports described in Test Script Migrating Data from ERP HCM to
Employee Central.
A position for which the employee is to be hired has been created. The position must be assigned to your
country to be available in the New Hire wizard. Additionally, the position must have a status of Active on the
hiring date of the employee.
1. Log on Log on to the Employee Central instance as The Home page is displayed.
Administrative Super User.
2. Go to the Org Chart From the Home drop-down select Company The Org Chart: <your name> screen is
screen Info and go to the Org Chart tab. displayed.
3. Add New Employee On the Org Chart: <your name> screen, select You are directed to the My Employee File
application and the Add New Employee
the Add New Employee icon located on screen is displayed.
the top right of the screen.
4. Enter Identity Information In the Identity section fill in at least the manda
for new Employee tory fields.
Note
Hire Date: Normally, hiring data are en
tered for a successful candidate whose
employment starts in the future. Never
theless, to test the scope items delivered
in this SAP Best Practices solution imme
diately, we recommend using as a hire
date today's date or an earlier date.
Note
Show <#> more fields: To obtain the com
plete list of fields, you might need to select
the Show <#> more fields.
Note
Position: select your formerly created po
sition from drop-down. Several fields re
lated to organizational information and job
information will be auto-populated from
that position based on a propagation rule
configured in the instance.
11. Submit Data Choose Submit or Continue, both options have A success message is generated by the
system informing you about the hire date
the same result.
of the new employee. You may choose
to view the employee’s profile, add hiring
data to another new employee, or simply
return to the home page.
12. View Employee Profile Choose the View profile of <new employee You are directed to the Employee Files
name> link. page of the newly hired employee.
Note
Similar to the hiring process described above you may create data for scenarios such as:
• an employee's termination
• organizational or pay changes
• an employee's rehire
You can include the used data in the following replication process.
Following the next steps you will walk through the replication reports for employee and organizational data:
This is a procedure you only execute once. After setting up the replication the reports will run on their own and
only need to be triggered manually if errors occur.
Purpose
This report is used to replicate Organizational Objects such as Business Unit, Division, Department, Job
Classification and Position from Employee Central to ERP HCM.
Procedure
1. Log on Log on to the ERP HCM system as HR The SAP Easy Access page appears.
Administrator.
2. Go to Program Execution In the menu bar of the SAP Easy Access page The ABAP: Program Execution page ap
3. Enter Program Name Enter program The Create and Execute Organizational
RH_SFIOM_ORG_OBJ_REPL_QUERY and Object Replication Query report selection
choose Execute. appears.
5. Enter Selection Criteria EC Org. Object Type and EC Org. Object ID:
under Select Specific Ob Leave the values blank if you like to run
jects the replication report for all organizational ob
jects. If you like to restrict the object type
and/or organizational objects, then enter spe
cific values.
6. Enter Selection Criteria Change Date: You can restrict this selection to
under Select Objects with organization objects that were changed after
Data Changes After a specific date by specifying the date. If not,
leave the date blank.
7. Enter Selection Criteria Initiate Full Load: Enable this checkbox if you
under Initiate Full Load would like to trigger a full load manually. Trig
gering a full load resets the modified date to
January 1, 2000 and extracts all data changed
after this date.
10. Check Staging area Call up transaction Check the status of the update in the
SFIOM_VIEW_ORG_REQS to check the re Status Text column of the record. Mes
cords in the staging area. Choose the record sages triggered by the program are writ
line items to be processed and select Process ten to the standard application log. To
Selected Requests. check the messages, select the record
and select Application Log. You can also
call up transaction Analyze Application
Log (SLG1) to view the messages.
Purpose
This report creates and sends a query to replicate employee master data from Employee Central to ERP HCM.
Note
If you have set the related parameter in the configuration of Employee Master Data and Org. Assign. Query
(V_ECPAO_QRY_CFG) Customizing view, it also requests the transfer of the employees’ organizational
assignments (such as employee-department or employee-manager assignments) from Employee Central.
Access this Customizing Activity via: Personnel Management Integration Settings for SuccessFactors
Employee Central Business Integration Builder Employee Data Integration Define Parameters for
Employee Master Data and Org. Assignment Query
The query runs for all employees specified by the selection criteria, based on the Transformation Template
Group.
Usually, you schedule the program to run in the background as a batch job. You can use a suitable variant and
choose any time intervals that suit your specific requirements.
You can also run the program manually. This is described in the following section.
Prerequisites
You have established the required settings for the Business Integration Builder in Customizing.
Access these Customizing Activities via: Personnel Management Integration with SuccessFactors Employee
Central Business Integration Builder .
Procedure
1. Log on Log on to the ERP HCM system as HR The SAP Easy Access page appears.
Administrator.
2. Go to Program Execution In the menu bar of the SAP Easy The ABAP: Program Execution page appears.
3. Enter Program Name Enter program The Create and Execute Employee Master Data
ECPAO_EE_ORG_REPL_QUERY and Org. Assignment Query page appears.
and choose Execute.
Note
With this SAP Best Practi
ces solution, we deliver the
Transformation Template Group
SBP_EE_EC_ERP which con
tains a specific set of mappings.
This mapping information is used
when transferring data between
ERP HCM and Employee Central.
5. Enter Selection Criteria for External Employee ID: choose the ap
Select Specific Employees propriate employees from your Em
ployee Central instance.
Note
If the Person ID in Employee Cen
tral has leading zeros, make sure
to enter the full ID including all
leading zeros.
Note
Select this checkbox to transfer
extended information. We recom
mend selecting the check box.
8. Execute Report Choose Execute. The report is carried out in test mode.
9. Choose Back Choose Back. The report with its selection criteria appears
again.
10. Enter Selection Criteria for Test Mode: Unselect the checkbox.
Test and Logging
11. Execute Report Choose Execute. The report is carried out in production mode.
Purpose
Access this Customizing Activity via: Personnel Management Integration with SuccessFactors Employee
Central Business Integration Builder Employee Data Integration Define Parameters for Employee Master
Data and Org. Assignment Query.
The report in this section is used to process replication requests for organizational assignments in the staging
area and to post the results to the database in the ERP HCM system.
Organizational assignments replicated from Employee Central are first stored in the staging area in ERP HCM.
Based on the information in these replication requests, this program creates the employees' assignments or
relationships to managers, cost centers, organizational units, jobs, and positions in the ERP HCM system.
Usually, you schedule the program to be run in the background as a batch job. It is triggered whenever
replication requests are written to the staging area tables. In addition to the background jobs that are
registered on the events, we recommend that you schedule a periodical background job, which picks up all
replication requests that couldn't be processed yet.
You can also run the program manually. This is described in the following section.
• Managers
• Cost centers
• Departments
• Divisions
• Business units
• Job classifications
• Positions
Note
Prerequisites
The employees and managers themselves must have been previously replicated. In addition, the mapped cost
center organizational unit, job, and position must already exist in the ERP HCM system. The parameter to
replicate organizational assignment along with employee master data must have been set in the Configuration
of Employee Master Data and Org. Assign. Query (V_ECPAO_QRY_CFG) Customizing view.
Access this Customizing Activity via: Personnel Management Integration with SuccessFactors Employee
Central Business Integration Builder Employee Data Integration Define Parameters for Employee Master
Data and Org. Assignment Query.
1. Log on Log on to the ERP HCM system as HR The SAP Easy Access page appears.
Administrator.
2. Go to Program Execu In the menu bar of the SAP Easy The ABAP: Program Execution page appears.
tion Access page navigate to More System
3. Enter Program Name Enter program The Replicate Employee Org. Assignments from
RH_SFIOM_PROC_EE_ORG_ASS_RPRQ EC to ERP Org. Mgmt page appears.
and choose Execute.
Note
You can call up this program using
transaction SFIOM_PROC_ORG_ASS.
5. Execute Report Choose Execute. The relevant replication requests have been se
lected. After processing, the staging area tables
are updated.
Note
You can also execute organizational assign
ment requests from the staging area.
Following the next steps the HR Administrator checks if the employee and organizational data have been
replicated with the appropriate infotypes in the ERP HCM system.:
Purpose
This report checks the status of the queries for the Organizational Object, especially for the Transformation
Template Group SPB_OM_EC_ERP..
Prerequisites
Procedure
1. Log on Log on to the ERP HCM system as HR The SAP Easy Access page appears.
Administrator.
2. Go to Program Execution In the menu bar of the SAP Easy Access page The ABAP: Program Execution page ap
Note
You can call up this program using trans
action SFIOM_RESET_QRY_ADM.
4. Check Report Output Check if the status of the quer The status of the queries for the Organi
ies for Transformation Template Group zational Objects has been checked.
SPB_OM_EC_ERP is set to Successful.
Note
If the status is not successful mark the ap
propriate query and choose Delete Query.
Purpose
This report checks the status of the queries for the Employee Master Data and Org. Assignment, especially for
the Transformation Template Group SBP_EE_EC_ERP-
Prerequisites
Procedure
1. Log on Log on to the ERP HCM system as HR The SAP Easy Access page appears.
Administrator.
2. Go to Program Execution In the menu bar of the SAP Easy Access page The ABAP: Program Execution page ap
3. Enter Program Name Enter program The Reset Employee Master Data and
ECPAO_EE_ORG_RESET_QRY_ADM and Org. Assignment Query page appears.
choose Execute.
Note
You can call up this program using trans
action ECPAO_RESET_QRY_ADM.
4. Check Report Output Check if the status of the quer The status of the queries for the Em
ies for Transformation Template Group ployee Master Data and Org. Assignment
SBP_EE_EC_ERP is set to Successful. has been checked.
Purpose
Organizational Objects are replicated into a staging area in the ERP HCM system. This report displays
replication requests for organizational objects from Employee Central with the corresponding organizational
objects in the ERP HCM system (if available).
The program displays replication requests referring to the following Employee Central object types and their
corresponding ERP HCM object types:
Position Position
Prerequisites
Procedure
1. Log on Log on to the ERP HCM system as HR The SAP Easy Access page appears.
Administrator.
2. Go to Program Execution In the menu bar of the SAP Easy Access The ABAP: Program Execution page ap
Note
You can call up this program using transac
tion SFIOM_VIEW_ORG_REQS.
4. Check Report Output Select your EC Obj. ID. The replication requests for organiza
tional objects are displayed.
To manually process your selected replication
request, choose Process Selected Requests.
Purpose
Employee Organizational Assignments are replicated into a staging area in the ERP HCM system. With this
report you display the replication requests for employee organizational assignments from Employee Central.
Prerequisites
Procedure
1. Log on Log on to the ERP HCM system as HR The SAP Easy Access page appears.
Administrator.
2. Go to Program Execution In the menu bar of the SAP Easy Access page The ABAP: Program Execution page ap
3. Enter Program Name Enter program The Display Employee Org. Assignment
RH_SFIOM_VIEW_EE_ORG_ASS_RPRQ Replication Requests page appears.
and choose Execute.
Note
You can call up this program using trans
action SFIOM_VIEW_REQUESTS
4. Check Report Output Select your Employee ID. The replication requests for Employee
Organizational Assignments have been
To manually process your selected replication
displayed.
request, choose Process Selected Requests.
Purpose
This function is used to analyze the logs and their messages and to get more information about them.
Prerequisites
The report for replication of Organizational and Employee Data has run.
Procedure
1. Log on Log on to the ERP HCM system as HR The SAP Easy Access page appears.
Administrator.
2. Go to Analyze Application In the SAP Menu on the left side of the page The Analyze Application Log page ap
Log navigate to: pears.
Log
3. Enter Search Criteria In the Object field choose ECPAO_IN. The Analyze Application Log page ap
pears.
5. Check Report Output Check the log for errors. The Application Log to analyze the rep
lication of Organizational and Employee
If the navigation tree contains a line with a red
Data has been checked.
icon, a problem classified as very important
has occurred.
Purpose
The HR Administrator checks whether the employee and organizational data of the new hired employee is
replicated from Employee Central into the appropriate Infotypes in the ERP HCM system.
Prerequisites
An employee has been hired in Employee Central and the replication reports for employee and organizational
data have been run without errors.
Procedure
1. Log on Log on to the ERP HCM system as HR The SAP Easy Access page appears.
Administrator.
2. Go to Display HR Master In the SAP Menu on the left side of the page The Display HR Master Data screen is
Data navigate to SAP Menu Human Resources displayed.
3. Select Employee In the Personnel no. field use the value help to Infotypes with green check marks inform
search for the newly-hired employee. Choose about data stored in the system.
ENTER .
4. Check Infotype Organiza Select Infotype Organizational Assignment Organizational data of the new hired em
tional Assignment (IT0001). ployee has been checked in the ERP
HCM system.
Choose the Display icon to view the Info
type record.
Choose Back.
5. Check Infotype Personal Select Infotype Personal Data (IT0002). Personal data of the new hired employee
data has been checked in the ERP HCM sys
Choose the Display icon to view the Info tem.
type record.
Choose Back.
6. Check Infotype Addresses Select Infotype Addresses (IT0006). Address data of the new hired employee
has been checked in the ERP HCM sys
Choose the Display icon to view the Info tem.
type record.
Choose Back.
Note
Note
Additionally, you may check the relationships between the Organizational Objects for their correctness:
• Position – S
• Job – C
• Organizational Unit – O
For this call transaction PP01 and enter the correct Plan Version, Object Type and Object ID. Choose
infotype Relationships and then Overview.
This section describes a few common issues that can occur during replication testing, and how the errors can
be resolved.
Error
Reason
The error message IndVal of wage type 1001: No entry in table T510 for key <xyz> occurs due to an incorrect
combination of PayScale area/type/group in the Job Information.
Solution
Review the entries and value mapping entries for these fields. Additionally, review table T510 to check if the
wage types are relevant for these pay scale combinations.
Warning
Reason
The warning messages Subtype field <ABCDE> not mapped for Infotype <1234> occur because all fields
that are hardcoded directly in the field mapping tool and not explicitly mapped are treated as subtypes. The
process is the same for all cloned subtypes. Therefore, warning messages for all fields using subtypes occur.
Solution
This does not lead to any issues in migration or replication and can be ignored.
The process to be tested in this test script is part of a chain of integrated processes.
Preceding Processes
Before testing the activities in this process, you must have completed the following business process:
Migrating Data from ERP HCM to Em Migration of data from your former system of records, ERP HCM, to your new
ployee Central system of records, Employee Central with all necessary migration reports.
Succeeding Processes
After completing the activities in this test, you can continue testing the following business process:
Replicating Time Data from Employee Replication of time data from Employee Central to ERP HCM for the use of the
Central to ERP HCM payroll system.
Note
This test process is valid for country
United States only.
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.