SAP Knowledge Base Article - Public

3261324 - General Display Name Troubleshooting

Symptom

This KBA discusses Troubleshooting tips for the General Display Name feature.

Details on how to enable this feature can be found here:

Starting from b2311 release, for new SAP SuccessFactors HXM Suite customers, the General Display Name feature is now enabled by default.

KBA Content:

Environment

  • SAP SuccessFactors HXM Suite:  General Display Name
  • SAP SuccessFactors Employee Central: General Display Name

Cause

Where is General Display Name Respected?

For the General Display Name feature there are some scenarios/UIs which only partially support General Display Name (with limitations) or fully support General Display Name but require your extra attention (with notes).
Please confirm if the UI you are having issue with, has any limitations or require extra attention by checking the following link:
Managing User Information: Important Notes About General Display Name Adoption

Resolution

Troubleshooting Non-EC Instances:

For non-EC instances, the General Display Name is taken from the DISPLAYNAME field in the Basic User/Employee Export File. The field is updated via import:  Managing User Information: Enabling the Adoption of General Display Name

NOTE: Removing the DISPLAYNAME completely in the UDF or in the system can't be done according to design. Although display name adoption is an Admin Opt-in, it only controls the whole BizX system applied with display name in all pages. The display name field will always be added to all users including UDF even if you don't use it.

If the field is not showing the correct values, then please follow the below steps:

  1. Carry out an Employee Export File
  2. Check the value stored in the DISPLAYNAME field
  3. If the value is not correct it has been updated via an import by another user in the system.
    You can check who else carried out Employee Imports via Scheduled Job Manager.
  4. To correct this issue, import the correct value in the DISPLAYNAME field for the user.

Please note if no value is maintained in the DISPLAYNAME field, the system calculates the value according to message key COMMON_USER_DISPLAY_NAME in company default locale. If there is no first name, middle name, and last name, the field value is set to Unknown.

Note: For a list of UIs that have limitations or require extra attention please check the following link:
Managing User Information: Important Notes About General Display Name Adoption

Troubleshooting EC Instances:

For EC Instance the General Display Name for a user is stored in the DISPLAYNAME field in the Basic User/Employee Export File.

This field is updated by the HRIS Sync which syncs the correct value based on General Display Name Settings.  The Sync will send the General Display Name based on your adopted method; you will be using either Legal Entity or People Profile Configuration for General Name Format.

  • General Display Name can be configured per legal entity, which means, as an administrator, you can configure name formats that meet the business needs and keep with the best practices of each legal entity.
  • General Display Name can be configured on the People Profile in Configure People Profile, with this option it is recommend that you enable the Admin Center > Company System and Logo Settings > Enable the name format selected in Configure People Profile to apply globally option. This will enforce the People Profile Name Format option for all users.

If you need to configure different name formats for different legal entities, don’t enable the option. If you expect to have a global name format for all legal entities, enable the option.

Please note: both of the above options rely on "Enable Name Format" being enabled via Manage Employee Central Settings and configured as per the guide: Implementing Name Formats

Confirming an issue with General Display Format Exists:

If the UI Supports General Display Name, to confirm if you have an issue with the General Display Format, first you must confirm what method you are using for Global Display Name.

  1. Navigate to Company System and Logo Settings
  2. Confirm if Enable the name format selected in Configure People Profile to apply globally is checked?
    1. If yes, the Name Format being used can be found in Admin Center > Configure People Profile > General Settings > Choose Name Format.
      Managing User Information: Configuring the Name Format Using People Profile
    2. If no, then the Name Format being used is from the employees Legal Entity.
      Check the users Legal Entity from their Job Information.
      In Manage Data, search for this Legal Entity and see which Name Format is being used.
      Managing User Information: Configuring the Name Format Using Legal Entity
    3. Carry out an Employee Export
    4. Check the value stored in the DISPLAYNAME field and compare with the expected output from the Name Format highlighted in step 2.
      1. If no issue can be seen with the comparison, then the General Display Name is working Correctly.
      2. If issues exist with the comparison, then the General Display Name please review the below section for more details.

Please note if no value is maintained in the DISPLAYNAME field, the system calculates the value according to message key COMMON_USER_DISPLAY_NAME in company default locale. If there is no first name, middle name, and last name, the field value is set to Unknown.

Note: For a list of UIs that have limitations or require extra attention please check the following link:
Managing User Information: Important Notes About General Display Name Adoption

Checking Why an Issue Occurred with the Sync of the General Display Name for EC Instances:

  • You have recently made a change to the Name Format used on either the Legal Entity or Configure People Profile or you have recently enabled/disabled the following setting: Admin Center > Company System and Logo Settings > Enable the name format selected in Configure People Profile to apply globally 
    • If this is the case, then a refresh of the General Display Name is required.
      This can be executed via Admin Center > Company System and Logo Settings.
    • Click the Refresh General Display Name button right under the Enable adoption of General Display Name option.
    • This will trigger a special iteration of the HRIS Sync Job which will update the DISPLAYNAME field only and sync the values based on your recent change.
  • The HRIS Sync has failed or not run-in recent days.
    • The General Display Name will only reflect changes to users’ names if the daily HRIS Sync is successfully running.
    • To resolve this issue, we recommend resolving the issues with the Daily HRIS Sync job. You may need to work with your Partner or Support to resolve this.
      2080730 - Employee Central: HRIS Sync - Troubleshooting Guide
  • Basic User Imports are occurring in your instance.

    • For Employee Central customers, we don’t prevent you from importing General Display Name.
    • If the General Display name is updated via Import this can cause it to appear incorrectly when compared to the configured Name Format. 
    • Please note that is you wish to update the values via import, and they differ to the Name Format the next time the HRIS Sync is triggered for those users the imported General Display Name will be overwritten by HRIS sync.
    • Based on this it is not recommended to import values into this field, but to rely on the HRIS Sync to set the values.
    • To resolve issues caused by import a refresh of the General Display Name is required.
      This can be executed via Go to Admin Center > Company System and Logo Settings.
      Click the Refresh General Display Name button right under the Enable adoption of General Display Name option.
      This will trigger a special iteration of the HRIS Sync Job which will update the DISPLAYNAME field only and update the value based on the configured Name Format.

FAQ:

What Happens if Name Format for Formal Name was already enabled, and General Display Name is now configured:

Any instance, which was already using the Name Format for Formal Name, can also implement General Display Name.

If both features are enabled, General Display Name will take precedent and the General Display Name value will be displayed on any UI that supports both features.

2297189 - Where in the UI is Name Format Respected

DISPLAYNAME field is Missing from Manage Business Configuration:

It is not required to configure the DISPLAYNAME field in Manage Business Configuration. However if you wish to change the label of the field that is displayed in the Employee Export file, this can be done via Manage Business Configuration.

The DISPLAYNAME field will only be visible in Manage Business Configuration after a Succession Data Model import has occurred after the 2H 2022 Release. This is required to refresh the hardcoded field logic where this field is stored.

How to check if the DISPLAYNAME field is Available in Manage Business Configuration:

  1. Navigate to Manage Business Configuration
  2. Expand the Employee Profile section
  3. Expand the Standard list
  4. Search for the displayName field
    • If the field shows in the list no other action is required
    • If the field does not show in the list, a Succession Data Model Import is required to be able to see the field so the label can be changed.
      If you have a Partner, they can do this for you, if not please create a support case with the Platform (Component) team to carry out the import.

3265384 - Standard elements introduced in 2H 2022 Release not available in Manage Business Configuration - SAP for Me

Can the DISPLAYNAME Column be removed from the UDF? 

The DISPLAYNAME Column will be added to the UDF for all instances as part of the 2H 2022 Release update. 
Removing the DISPLAYNAME completely in the UDF or in the system can't be done according to design. Although display name adoption is an Admin Opt-in, it only controls the whole BizX system applied with display name in all pages. The display name field will always be added to all users including UDF even if you don't use it.

Why are there Values in the DISPLAYNAME Column of the UDF Before we have Enabled General Display Name: 

As mentioned above the DISPLAYNAME Column is added the the UDF by the system. The column will also be pre-populated with values according to message key COMMON_USER_DISPLAY_NAME (first name, middle name, and last name) in company default locale. If there is no first name, middle name, and last name, the field value is set to Unknown.

The values will not be respected until the General Display Name feature is enabled.

Why is the "Name Format for General Display" Field/Assoication Already on Companies/Legal Entities in Manage Data Before we have Enabled General Display Name:

The "Name Format for General Display" Field/Assoication is added to Legal Entities in Manage Data as part of the 2H 2022 Release. This is done by system design to simplify the process if you choose to enable General Display Name. The field and any values you may added to the field will not be respected until the General Display Name feature is enabled.

Can You Store the DISPLAYNAME Value in a Field on User's Profiles? 

The DISPLAYNAME field can be added to a Live Profile User Information Block in Configure People Profile.

Does this general display name format configured for SuccessFactors mobile app too ?  

Yes, SuccessFactors mobile app also adopted General Display Name.

 Does display name translations supported in  EP profiles ?  

DISPLAYNAME is automatically enabled in the Succession Data Model. You can see this element in the Business Configuration UI, but your updates to the element in BCUI won't take effect.

https://help.sap.com/docs/SAP_SUCCESSFACTORS_PLATFORM/534356acc0ab4b0e8977ebfb2eb432f7/0597651b7c4249bb851f9ff33baf79cd.html

See Also

Keywords

General Display Name, Name Format, DISPLAYNAME, ECT-176085
, KBA , LOD-SF-PLT-UIM , Employee Import Issues , LOD-SF-EC , Employee Central , Problem

Product

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