SAP Knowledge Base Article - Public

2328243 - HRIS Sync: Configuring a sync-mapping from an EC field to username (EP)

Symptom

Customer has a requirement to allow end users or system administrators to change their username via an EC portlet

Image/data in this KBA is from SAP internal systems, sample data, or demo systems. Any resemblance to real data is purely coincidental. 

Environment

Employee Central - Hris sync

Resolution

SAP SuccessFactors does not support (nor does it recommend) configuring this for you customer instance, as the UI does not truly support the mapping, although mapping does work.

Please be aware that though this does add some value to a customers configuration, it will also potentially bring issues where you specify a username that is already assigned to another user, and a suitable message is not returned by the UI (i.e. a generic error will be given).

 Example code:

<hris-mapping >

        <hris-field-ref refid="person-id-external"/>

        <standard-element-ref refid="username"/>

      </hris-mapping>

Facts

It is possible to add a custom sync-mapping to the Succession Data Model configuration, to synchronize a STRING value to the "username" field in Employee Profile, allowing an employees username to be changed via EC UI.

Here are a few FAQs about configuring this solution:

  • IMPORTANT: The EC UI does not currently handle the scenario where the specified username already exists (ending in an Application Error). This is due "username" being a unique value in the system. If a non-unique value is entered in EC, it will not synchronize to EP and the value in the field (on EC side) will revert with an appication error.
  • The mapping will support only STRING fields, for example a custom-string field
  • The mapping is only support for specific hris-elements (see below)
  • Invalid HRIS Sync Mapping Configuration "HRIS Sync Job Failure" (see 2336779)

Example: 2336779): Configure username as destination field

username should be unique. If there is duplicated custom-string2 values, hris sync job will fail. Below configuration will cause job failure. 

<hris-element-ref refid="personInfo">

<hris-mapping >

<hris-field-ref refid="custom-string2"/>

<standard-element-ref refid="username"/>

</hris-mapping>

</hris-element-ref>

</hris-sync-mappings>

<hris-element-ref refid="emailInfo">
<hris-mapping entity-type="B" >
<hris-field-ref refid="email-address"/>
<standard-element-ref refid="username"/>
</hris-mapping>
</hris-element-ref>

 

Which elements can this be configured for?

If you require to configure this mapping, it must be configured using only one of the following 3 hris-elements -:

  • Personal Information
  • E-mail Information
  • Biographical Information

NOTE: Job Information is confirmed as not supported

See Also

 2080730 - Employee Central: HRIS Sync - Troubleshooting Guide

2336779 - Invalid HRIS Sync Mapping Configuration " HRIS Sync Job Failure"

Keywords

HRIS Sync, Synchronization, Username, Employee Central sync, standard-element, sync, user-name, username, ec, "errorId=null, timestamp=null, errorMessage=Cannot read property 'split' of null, errorName=TypeError", Cannot read property 'split' of null, Cannot read property split of null,userid , KBA , LOD-SF-EC-HRS , HRIS Sync , LOD-SF-EC-PER , Person Data (All Person Data Types) , Problem

Product

SAP SuccessFactors HXM Core all versions