SAP Knowledge Base Article - Public

2079986 - HRIS Sync - How does HRIS Sync map EC Job Relationships to system roles

Symptom

How does HRIS Sync map EC Job Relationships to system roles

Environment

Employee Central 2.0

Resolution

How are the Job Relationships mapped to system roles via HRIS Sync?

For the HRIS element: jobRelationsInfo, the HRIS field: relationship-type must be defined as a picklist in the Succession Data Model. In order to sync the known relationship types correctly into users' legacy tables, the dedicated external_codes for system relationship types are defined. The sync logic will regard the external_code for each known relationship type as a fixed value. The system will run the different sync logic (HR Manager/Matrix Manager /Custom Managers/Second Manager) based on the external_code.

The table below show the definition of external code for each known relationship type. It is fixed values in our system.

Picklist Label Picklist external_code  Basic User Data (EP) standard-element destination
HR Manager hr manager hrId
Custom Manager custom manager customManager
Second Manager second manager secondManager
Matrix Manager matrix manager matrixManager
Additional Manager additional manager  ---

 

FAQ

Q) Is it possible to remove the sync for certain roles?
A) Yes, if this is required, then you need to change the external_code value of the corresponding Job Relationship Type of the jobRelType picklist to something else (it must be unique and not an external_code from the above table).

Q) How many Job Relationships can I have?
A) You can have as many Relationship Types as you want, but the ones that you add can only be mapped to a system role IF the system role is available/supports it.

Q) Are there any roles which I can map multiple times (i.e. have multiple users the Matrix Manager)
A) For Matrix Manager and Custom Manager roles you can configure multiple Relationship Types assigned to these system roles to have multiple users assigned as a Matrix Manager or Custom Manager for 1 user. For example, if you need to assign users more than 1 Matrix Manager, you could have multiple Matrix Manager X relationship types in the picklist, using the same external code “matrix manager”. And all these can then be sync’ed to the Basic User Data file, as the Matrix Manager role supports multiple operators. For example -:

^picklistId OptionId minValue maxValue value status external_code parentOptionId en_US Destination System Role field
jobRelType ACTIVE hr manager HR Manager hrId
jobRelType ACTIVE second manager Second Manager secondManager
jobRelType ACTIVE additional manager Additional Manager -------
jobRelType ACTIVE matrix manager Matrix Manager matrixManager
jobRelType ACTIVE matrix manager Matrix Manager 1 matrixManager
jobRelType ACTIVE custom manager Custom Manager customManager
jobRelType ACTIVE custom manager Custom Manager 1 customManager

Q) How will the UserID's for Matrix Manager and Custom Manager be persisted to Basic User Data?
A) They will be added to the Basic User Data file with a pipe as a separator. For example, you set Matrix Manager 1, 2 and 3 (userID’s 1011343, 1011346, 1011351) in Relationship Information portlet in EC. The system will then synchronize these 3 UserID's to the Basic User Data file into the matrixManager (MATRIX_MANAGER) field in the following format -:
 
       1011343 | 1011346 | 1011351

This can also be done for the CUSTOM_MANAGER role.

 

WARNING:

  1. Please note that the roles HR Manager and Second Manager do not support multiple users being assigned to 1 role, so please do not create additional Relationship Types with the external_codes “hr manager” or “second manager” as this will cause undesired behavior and likely the wrong users sync’ed to the Basic User Data file.
  2. In the standard field (EP field) if you are using Element Permission you must grant that for the rule type who is updating the matrix manager field you have given WRITE permission, otherwise, the sync wont work.

 

TIPS:

  1. You you can have Relationship Types that do not have a Basic User Data association (like the "Additional Manager example above). You would create these like any other, but you would need to use a new & unique external_code.
  2. Note that these “custom” Relationship Types will not sync to the Basic User Data file (so long as the external_code field points to a custom external_code).

 

For more information please refer to the Employee Central Master handbook

Keywords

jobRelType, Job Relationships, Employee Central, EC, Relationship Type, hris sync, ec sync , KBA , sf employee central , LOD-SF-EC-HRS , HRIS Sync , LOD-SF-EC , Employee Central , How To

Product

SAP SuccessFactors HCM Core all versions