2576546 - Working with Manage Language Feature - Platform

SAP Knowledge Base Article - Public

2576546 - Working with Manage Language Feature - Platform

Symptom

A customer wants to change a label in a specific locale that is not available in Text Replacement functionality (KBA Link -Text Replacement: How to change words using replacement text 2089472). Is it possible to do? How?

Environment

BizX Platform

Reproducing the Issue

 Please reference configuration Guide for Further Guidance: Managing UI Labels in SAP SuccessFactors HCM Suite

Cause

When should Manage Languages be Used:

The manage language change requests typically arise in two situations:

● You want to change default values of UI text (e.g., system text) to better reflect your particular business practices and culture.

● There is an issue with system text (e.g., grammar, syntax, key terms). Manage Languages allows for a quicker turnaround while waiting for the system text to be updated in a subsequent patch or release

NOTE: You should still contact Customer Support so that we can address issues with system level text in future builds.

Resolution

You can use the Manage Languages tool from within the Admin Center to overwrite UI label values in any language (US English or any language that SAP SuccessFactors currently supports see KBA List of Supported Languages with Locales (BizX) 2269945)

The Manage Languages page allows you to activate and deactivate locales, create locales that you can upload custom label values to, and download both custom and default label values.

Prerequisites:

  1. Enable “Language Packs” option from Provisioning should be enabled on customers instance. If you do not have access to Provisioning, you may reach out to your implementation partner/s and consultants or please contact support team for assistance.
  2. Still in provisioning make sure the option "Enable Manage Languages tool" is enabled.
  3. Text Replacement” permission should be enabled in RBP Roles granted to an admin user. Go to Admin Center > Manage Permission Role > Administrator Permissions > Manage System Properties > Text Replacement.

Limitations:

  1. Value replacement limit: You can overwrite up to 10,000 values per locale using Manage Languages. The default replacement limit is set to 100 values, which you can manually increase up to 10,000 using the Update option at the bottom of the page.
  2. Custom language pack CSV file size limit: The CSV file size limit is 10 MB. If you try uploading a file, which is anything more than 10MB, the system will time out and the file will not be uploaded.
  3. Text substitution syntax: You need the text substitution syntax to replace a word throughout the system. Otherwise, each string that includes the string will need to be replaced through Manage Languages.

Steps:

  1. Go to Admin Center > Tool SearchManage Languages. From here, you will see the list of all language packs enabled for your instance.

        Lin1.PNG

     2. Under the Action column, click Add corresponding to the language pack you've chosen (sample is English US).

        Step 2.PNG

 

   3. It is required to enter a new name for the custom language pack (such as, English US Custom), and click OK. The custom language pack gets appended to the original language pack.

       Step 3.PNG

 

   4. Next, you need to download the CSV file of the original language pack that has all the default application UI labels, some of which you will customize. To download, select the checkbox next to the language (English US), scroll to the bottom of the page, and on the For Checked Items Above dropdown menu, select Download.

       Step 4.PNG

 

   5. Open the downloaded CSV file in any text editor (Notepad or Notepad++). It should be similar to the screenshot provided below. This file, which is the original CSV file, contains the entire list of key values (key) and their corresponding UI labels. For this sample, en_US (English US).

       Step 5.PNG

 

   6. From the entire list, you will need to select only those tokens which you wish to replace the text/label with. To know which tokens should be selected, you need to switch your Language to English Debug. If you do not have this language pack listed on your instance > Change Language, contact support for enablement.

       Step 6.PNG

 

   7. Go to the page where you would like to change the label. In this sample, we will be changing the label for Home Page from the Module Picker. Get the values inside the colon (sample in the screenshot is COMMON_HOME_TAB).

       Step 7.PNG

 

   8. You will need to create a new file where ONLY custom translations will be placed. To do this, you may open a new file in notepad/notepad ++ > Copy the header and remove the last value.

       For every token, it should be 1 line on the file as shown below. First value should be the token > Comma > New Translation. Both enclosed in double quotation marks. Refer to 2nd screenshot below.

       FROM ORIGINAL FILE SAMPLE:

       Step 8-1.PNG

       TO NEW FILE SAMPLE:

       Step 8-2.PNG

      All custom translations will be saved in a single file. Once done, save in .csv format.

 

   9. Go back to Admin Center > Manage Languages > Select Created Custom Language > Choose File > Select created file > Import.

       Step 9.PNG

 

  10. You should be able to receive a successful pop-up showing up that the upload is successful. Click Ok.

        Step 10.PNG

 

  11. Once done, try to logout, log back in and see if the translation updated. You might need to change language depending on what locale you have created a custom translation with.

Step 11.PNG

1802 Release Changes to Layout: Previously, the import language pack was a separate field on the top of the Manage Language page. It is now incorporated into the main table. The activation and deactivation of the language is now possible using a checkbox and select save at the bottom of the page.

ccCapture.PNG

In addition, the Action column was enhanced to allow the addition and removal of custom languages, as well as downloading the custom labels.

cust.png

See Also

Please reference configuration Guide for Further Guidance: Managing UI Labels in SAP SuccessFactors HCM Suite

Keywords

3 tier language pack, Text Replacement, Manage Languages, Label, Update, Text, Tier 2, Changes,  Language Pack, Custom Label, Custom Labels, Custom , KBA , LOD-SF-PLT-LAN , Issues with Translations (Language Issues) , LOD-SF-PLT , Foundational Capabilities & Tools , How To

Product

SAP SuccessFactors HCM Suite all versions