7.1.7 Localisation and Translation

Owned by Former user (Deleted)
Last updated: 2023-07-28 by Oksana Vinkarklina (Deactivated)
5 min read

 

Activate translation language settings

Important: Before you start translating, make sure to activate the 'translation language settings' for the language you're working on.

  1. In the Setup, go to Translation Workbench.

  2. Find "Translate language settings" in the menu.

  3. Look for your desired language (e.g., German) in the "Supported languages" column and click "Edit."

  4. Check the box in the "Active" column and remember to Save.

 

If you are using ADvendio in any other language than English or you like to change the English wording to something your users understand better, you can use the following Salesforce tools:

Translation Workbench

The Translation Workbench lets you specify languages you want to translate or override labels and translations for the ADvendio package. Everything from custom picklist values to custom fields can be translated so your users can use all of Salesforce in their language. You can manage translated values for any of the Salesforce-supported languages.

Translate

Navigate to Setup > Translation Workbench > Translate.

To get started in the Translation Workbench:

  1. Select a language.

  2. Select a setup component, for instance, Custom Field.

  3. If necessary, select an Object. For Instance, use Media Campaign as the object and Field Label or Help Text as the object.

  4. Double-click in the translation column to enter new values. You can tab to jump to the next row.

Override

Fields and help texts can also be overwritten by you if the original value should be stored but the displayed value should be the overwritten one.

To get started in the translation workbench:

  1. Navigate to Setup > Translation Workbench > Override.

  2. If you have items to override in more than one language, select a language.

  3. Select a setup component, for instance, Custom Field.

  4. If necessary, select an Object and Aspect.

  5. Double-click in the override column to enter new values. You can tab to jump to the next row.

Export

You can export three different kinds of text. 

  • Source - Produces one .stf file that contains all of the text that is translatable

  • Untranslated - Produces a set of files, by language, with text that is not yet translated

  • Bilingual - Produces a set of files by language that contain all of the text that is translatable

Salesforce translation files are exported in the UTF-8 encoding to support extended and double-byte characters. This encoding cannot be changed. Field labels can only be translated using max. 80 characters. The help text or description of a field can be translated using max. 255 characters. The import will fail if translations are too long or the csv/stf file has more columns than expected.

Bilingual

All language strings are exported to the object called Documents. For each language, a new file will be generated and all language files are stored in a zip file (Examples: Untranslated_de_2015-10-30 0231.sft, Untranslated_es_2015-10-30 0231.sft). If the suffix is changed from stf to csv, you are able to open the file with Open Office. 

Import

Before importing any file you have to make sure, that your CSV file is prepared with the right information. It is not possible to import a tab-separated file with different languages. Each import file should consist of only one correct language. Please make also sure, that the header of the file is prepared correctly with language code and type. For instance, the type bilingual is not allowed and there should also be only two columns. The first one should have the target label and the second one should have the correct translation.

 

 If the suffix is changed from csv to stf, you are able to import the translated labels:

  1. Create a separate file for each language you would like to import that contains only the key and the translation.

  2. The language attribute at the top of each file is required. The language attribute looks like this: Language = "en_US" and contains a valid language reference.

  3. To ensure correct handling of extended and double-byte characters, make sure your import files are saved in UTF-8 encoding before importing.

  4. If you are uploading multiple language files you can zip all of them together for easier import.

  5. Upload the file by navigating to Setup > Translation Workbench > Import and selecting your stf file (or zip).

  6. Click the button Import.

Translation of Objects and Tabs

Objects can be translated into different languages:

  1. Navigate to Setup > Customize > Tab Names and Labels > Rename Tabs and Labels and select the object that you want to translate.

  2. Choose the right language in the field Select Language.

  3. Scroll down to the related list Custom Tabs to translate an ADvendio object and click the button Edit.

  4. Enter the new tab names and field labels to display in the selected language.

  5. Click the button Save.

Translation of Custom Labels

To access Custom Labels:

  1. Go to Setup.

  2. From the User Interface drop-down menu, choose "Custom Labels."

  3. Search and select "Actions" as per the screenshot below:

 

 

Custom Labels can be translated into different languages:

  1. Navigate to Setup > Create > Custom Labels and select the custom label that you want to translate. 
     In most cases, the Category field on Custom Labels helps you to identify the Custom Label you need to translate.

  2. You can edit existing translations or create new ones:

    1. In the related list click the button New to create a new translation.

    2. In the related list click the button Edit to edit an existing translation.

  3. Enter the Translation Text and select a Language to create a new translation. The Language can not be changed for existing translations.

  4. Click the button Save.