SAP Knowledge Base Article - Public

2395445 - Default Locale | How to control the user language in SuccessFactors

Symptom

  • How can I change the default locale/language for new users without the need to specify it in the UDF file?
  • The Default locale is changing to a Random locale. Why is this occurring?
  • How do we set the Default Language before the user logs in?

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

Environment

SAP SuccessFactors HXM Suite

Reproducing the Issue

  1. Navigate to Admin Center > Update User Information > Employee Import > Import the User Directory File with Default Locale column left blank;
  2. Navigate to Admin Center > Update User Information > Employee Export > Export the User Directory File
  3. The Default Locale of the newly imported users is en_US. 

Cause

When a new user is added to an instance, their default locale is set to en_US by default if the default locale column is left blank, when importing the User Directory File.

Resolution

This is an expected behavior and the SuccessFactors Platform will replace with the Default Locale if this field was populated with an invalid Locale. 

  • For customers without Employee Central:
    • The Default Locale will remain as en_US for newly added users if the Default Locale column is left blank. 
  • For Employee Central customers:
    • The new user's default language will be the same as the Default Language setting for your company via the backend in Provisioning. Please contact your implementation partner to have your default language set.
      • see: 3115662 - Is It Possible to Map Custom-String field to EP standard Field defaultLocale
  • We do not recommend below configuration because it may cause some data issue

    DEFAULTLOCALE in custom sync mapping:

     <hris-element-ref refid="personalInfo">
          <hris-mapping>
            <hris-field-ref refid="custom-string3"/>
            <standard-element-ref refid="defaultLocale"/>
          </hris-mapping>
        </hris-element-ref>
      </hris-sync-mappings>

    Important: Please note that if personalInfo.custom-string3 is emptyen_US will be the default value.

    Example:

    • EC Field: custom-string3= NO Record or Empty
    • The system will default: EP standard-element-ref refid="defaultLocale  =  en_US
    • Result: This expected behavior.

To set the Default Language, it is possible to populate the Default_Locale column at the UDF file through these steps:

  1. Navigate to Admin Center > Update User Information > Employee Export > Export the User Directory File
  2. Populate the Default_Locale column in the UDF file with the correct locale
  3. Navigate to Admin Center > Update User Information > Employee Import > Import the User Directory File

IMPORTANT: Enabling Employee Central and setting a Default Locale after the initial import of users will not alter language/default locale for existing users. Meaning they'll still be set to en_US. To change this you will need to reimport them with the desired Default Locale specified.

NOTE: The company default language also affects the default language of other places where localization is applicable. For example, when you create a new Rating Scale or a new Route Map, you have to enter the value in default language locale first which is your Company default language, then you can add translation in other locales.

See Also

  • 2269945 - List of Supported Languages with Locales (BizX)
  • 3115662 - Is It Possible to Map Custom-String field to EP standard Field defaultLocale
  • 2380278 - How to set the Default Locale for a User in the Add New Employee Wizard
  • 2395445 - Default Locale | How to control the user language in SuccessFactors
  • 2269945 - List of Supported Languages with Locales (BizX)

Keywords

SF , success factors , EC , Default Locale , Employee Import , UDF , basic import , PLA-8503 , KBA , LOD-SF-PLT-MNG , Manage user Issues , LOD-SF-EC-HRS , HRIS Sync , How To

Product

SAP SuccessFactors HXM Suite all versions