2315295 - Employee Central - HRIS Sync

This is a collection of useful Knowledge Base Articles related to HRIS Sync.

Before opening an case with Product Support

Please be sure that before you open a support case with Product Support, you have performed the following sanity checks on your configuration/data - bearing in mind most issues are due to a configuration issue -:

• Check that the field configuration for the fields you are synchronizing from and to, is correct according to the Employee Central Master implementation handbook. If the field is a picklist or Object related field, ensure that the related picklist/object is configured correctly on the source but not defined on the target
• Has the configuration changed recently?
• Can the recent change be un-done and if so, please try revert any recent changes and see whether the problem persists?
• Can the issue be reproduced for just 1 or multiple users?
• If the issue is reproducible for all users it is still likely to be a configuration issue.
• If it seems to be related to 1 or a small user population - the next step is to check and verify that the data is correct. 

Sync Mapping Configuration - It is always best practice to check and verify that the field you have enabled for a particular hris-element is valid for that element. Please refer to the "Data Object Tables" handbook under the section "Reference Information" which details what fields are supported, and how the field should be configured. Some of the more common issues encountered are due to trying to re-purpose delivered fields to do something else. Please note - the following is a list of things you should not do when configuring fields

• Do not add a custom sync mapping to your configuration that already exists as a Hard-Coded (pre-delivered) sync mapping
• Do not configure an Object field to use a picklist - for example do not add a picklist to the field "company" in the jobInfo hris-element - this is not supported and not best practice
• Has a sync mapping been changed? If so, have you run a Full HRIS Sync to ensure all current data is correctly synchronized?

Data Issues - A lot of common issues are due to sync-mapping configurations that have been changed recently, or, the configuration of a source field has changed recently. This commonly leads to Data issues which could possibly cause the HRIS Sync to fail.

• Has there been a configuration change to Source or Destination fields?
• Have you run an Person and Employment Export Ad Hoc report to verify the data is correct?

Checked the FAQ below?

 

 

Tips & Tricks

Below are some tips and tricks recommended by Product Support, which you should consider first before opening a Support case

Index

• HRIS Sync Fundamentals
• HRIS Sync Concepts
• HRIS Sync Troubleshooting Tips and Tricks
• Open a Support case



HRIS Sync Fundamentals

Please click here, and review the chapter "Human Resources Information System (HRIS) Synchronization" in the Employee Central Implementation Handbook. The chapter includes the following sections that should be reviewed in detail -:

• Triggering HRIS Sync
• Set Up of Sync Framework
• HRIS Sync Job

Also please review the section "Keeping the User Directory and Org Chart Up to Date" from the Employee Central Implementation Handbook - click here

The review the quick reference KBAs, which are must know information about how HRIS Sync works and behaves -:

• 2511923 - Employee Central: What is Effective Dating?
• 2080728 - Employee Central: What is HRIS Sync?
• 2505747 - HRIS Sync - HRIS Sync Job - Order in which Elements are Synchronized
• 2172427 - HRIS Sync - Data Synchronization From EC to EP - Hard Coded Sync Mappings
• 2510653 - HRIS Sync: What Value is sent depending on Source / Destination Field Configuration

 



HRIS Sync Concepts

General

• 2512570 - HRIS Sync: How to create a HRIS Sync job
• 2080065 - What is a Full HRIS Sync? - Employee Central
• 2080114 - How to force a sync of an Employee’s EC data
• 2080813 - HRIS Sync: Import & API upsert considerations - Employee Central
• 2308595 - HRIS Sync: Timezone Offset for Processing HRIS Sync
• 2505526 - HRIS Sync: How does HRIS Sync translate Employment Status in EC to STATUS in EP

Configuration Concepts

• 2079986 - HRIS Sync: HRIS Sync - How Does HRIS Sync Map EC Job Relationships to System Roles
• 2512762 - Employee Central - Compensation Info HRIS Sync
• 2360653 - Employee Central - Addresses HRIS Sync
• 2505319 - Employee Central - Phone Info HRIS Sync 
• 2507071 - Employee Central - Email Info HRIS Sync
• 2506989 - Employee Central - Corporate Address HRIS Sync 
• 2507221 - Employee Central - Home Address HRIS Sync
• 2510530 - Employee Central - Job Info HRIS Sync
• 2512703 - Employee Central - Biographical Info HRIS Sync
• 2512669 - Employee Central - Personal Info HRIS Sync

Configuration Related Issues

• How to sync EC Date fields to User Data File String fields
• How to sync Employee Central data to Userinfo Element Fields
• How to ensure the correct Time Zone is synchronized to Employee Profile
• Configuring a sync-mapping from an EC field to username (EP)
• Additional Job Relationships - Employee Central

Integrations and Downstream Impact

• 2507190 - HRIS Sync: Downstream Impacts
• 2080650 - How to enable Manager Transfer for Performance Manager forms - Employee Central
• 2080013 - How to Manage Families & Roles and Competency Mappings - Employee Central
• 2509058 - HRIS Sync: Why not to use Performance Management Document Transfer when Employee Central is enabled
• 2509201 - HRIS Sync: How does the HRIS Sync impact Compensation Management

 



HRIS Sync Troubleshooting Tips and Tricks

Most of the issues you will encouner with the HRIS Sync will be data related issues (invalid data types or null/blank data being passed to EP fields). Below are some techniques/examples you can use to troubleshoot HRIS Sync issues, before looking to reach out to the team/Nexus/Engineering for answers :

• 2080730 - HRIS Sync - Troubleshooting Guide
• 2092931 - Employee Central: Some users do not Synchronize via HRIS Sync and do not appear in Ad Hoc and ORD Reports (IS_EC_SYSTEM_OF_RECORD)
• 2584658 - HRIS Sync - How to Check if a User is an EC User using the Integration Center
• 2174070 - HRIS Sync - Invalid Manager – Users cannot log in to instance due to "Invalid Manager" error message on login

 

 

Job Failure due to Execution Limit: 

If the job fails due to execution limitations it will detail the following error in the Job Details:

• job failed because it exceeded the daily scheduling threshold for execution

If a job fails due to this job execution guardrails, it is recommended to review the configuration of the job and adjust the recurrence to ensure it complies with the job execution guardrails detail in the WNV: ECT-207756: More Employee Central Jobs on Job Scheduler in Scheduled Job Manager

To do this please ensure you have the required permission to access Scheduled Job Manager from the Admin Center.

This requires you have the permission:

• Administrator > Admin Center Permissions >  Monitor Scheduled Jobs
• Administrator > Admin Center Permissions > Manage Scheduled Jobs

Different job types might have additional module-specific permission controls. Check module guides to know all the details, please review the links with the "Related Information" of the WNV page for links to each of these relevant jobs: ECT-207756: More Employee Central Jobs on Job Scheduler in Scheduled Job Manager

Steps to change the recurrence of a job:

1. Ensure you have the required permission detailed above 
2. Navigate to Scheduled Job Manager
3. Select "Job Scheduler" Tab 
4. Filter for the desired Job Type
5. For the desired job select Actions> Cancel 
6. Once the job is canceled select Actions> Edit 
7. Adjust the recurrence to comply with the job execution guardrails
8. Ensure all required fields are filled out 
9. Submit

When opening a support case, please ensure that you have worked through sanity checking your configuration using the article "2080730 - HRIS Sync: Troubleshooting Guide" and if you then still need to raise an case, please follow the guidance at the end of the article to do so.

 

• 2315109 - Employee Central - Tips & Tricks from Support

Implementation, FAQ, HRIS Sync, Synchronization, Employee Central 2.0 , KBA , LOD-SF-EC-HRS , HRIS Sync , LOD-SF-EC , Employee Central , How To

SAP SuccessFactors Employee Central all versions ; SAP SuccessFactors HCM Suite all versions