Symptom
- I want to update the username for some users.
- When I try to update a username via employee import the change does not apply.
- When I try to update a username via employee profile, the username does not change, it remains the same.
Environment
- SAP SuccessFactors HXM Suite
- SAP SuccessFactors Employee Central
Resolution
The username field is stored in the basic user field/employee export file, and below are some details about it:
- It is used to sign in and generally mapped from the Person ID for EC customers on initial hire.
- It can be different from the User ID and Person ID, but for simplicity it is often the same value.
- The system automatically assigns another username and user ID for employees that have a concurrent employment or another global assignment or were rehired to a new employment.
- Username can and should be used for single sign-on (SSO). Please View: 2493579 - Employee Central: Person/User IDs Used Within Employee Central - SuccessFactors Employee Profile.
- It can contain dots and @ symbols.
Username for Employee Central (EC) enabled instance:
- Username is not handled as standard in Employee Central, but some customer configurations do capture a Username value in EC and synchronize it to EP.
- You can check this by exporting the Succession Data Model, scrolling to the bottom section “sync-mappings” and see if any of the mappings point to the standard-element “username”. If they do, then the username should be maintained in the relevant EC portlet instead.
- Please note this is not a recommend HRIS Sync Mapping
- If a customer does not have a HRIS Sync Mapping, EC is not involved in this process at all.
How to change the username:
For non-EC enabled instance
- Employee Import > Download template > Import UDF template with the username info.
For EC enabled instance
- Employee Data Import > Import Employee Data with 'Basic User Data' option
NOTE: If you maintain the Username field on an Employee Profile portlet and are unable to change the value via the UI please try to Update the value via an Import. Username should not be edited from the People Profile UI, as it may lead to inconsistent behaviour and application errors. Refer to article 2686245 for further information, and check the note in the people profile Help Portal section covering permissions on employee data.
- For errors when you try to import the updated file, please refer to KBA 3339626 - The username exists in the system - SAP for Me.
- If you are still unable to update the username via import please reach out to the Platform Support Team (LOD-SF-PLT) as they provide support on the import process for both EC and non-EC enabled instances.
See Also
- 2495643 - SuccessFactors User IDs - Clarifying the Different IDs - SAP for Me
- 3339626 - The username exists in the system - SAP for Me
- 2088065 - Legacy Purge - Data Retention Management - SAP for Me
- 2392076 - User Permanent or Hard Purge feature - SAP for Me
- 2615360 - DRTM Master Data Purge for Inactive Users - SAP for Me
Keywords
username, - 27, 27, update username, can't update username, modify username, Failed to add/update, basic import, username , KBA , LOD-SF-PLT-UIM , Employee Import Issues , LOD-SF-EC , Employee Central , LOD-SF-EP , People Profile , How To