Translating And Customising UI Labels

How to translate and customize the user-facing text in Kaptio Travel

Custom labels are used for page titles and text and some button labels as well as error messages.

Salesforce supports the following:

  • A default value
  • Optional translated values for multiple languages

How to view and edit the existing custom labels used in Kaptio Travel

  1. In Kaptio Travel, click Setup in the top right hand corner of your screen.Force.com Home Page ~ Salesforce - Enterprise Edition - Google Chrome 2017-07-04 15.40.42.png
  2. Under Create, click Custom Labels and the following screen will appear:None ~ Salesforce - Enterprise Edition - Google Chrome 2017-07-04 15.43.12.png
  3. As you may have multiple applications within your org, you might see custom labels that are not related to Kaptio Travel.
  4. Click on a Name you wish to translate.and the following screen will appear:Custom Label_ ffhttp_gsheets_NullSheet ~ Salesforce - Enterprise Edition - Google Chrome 2017-07-04 15.45.12.png
  5. Under Translations, click New and the following screen will appear:New Translation ~ Salesforce - Enterprise Edition - Google Chrome 2017-07-04 15.47.27.png
  6. On the New Translation screen, under Language, select the relevant language from the dropdown menu.
  7. In the Translation Text box, enter the translated text in that language.
  8. Click Save and you will be redirected to the Translation Details screen where you can now see the new translation text you have entered in the Translation Information section.

How to translate Object field labels and help text

Custom objects include field labels and help text that you may wish to localize or customize.

Salesforce supports the following:

  • A master (default) value
  • An override value
  • Optional translated values for multiple languages
How to translate object text
  1. In Kaptio Travel, click Setup in the top right hand corner of your screen.Force.com Home Page ~ Salesforce - Enterprise Edition - Google Chrome 2017-07-04 16.03.35.png
  2. Under Administer, expand the Translation Workbench options and click Translate. The following screen will appear:Translation Workbench_ Translate ~ Salesforce - Enterprise Edition - Google Chrome 2017-07-04 16.04.58.png
  3. Under Language, select your org’s language from the dropdown menu.
  4. Under Setup Component, select Button and Link Label, Custom Field or Layout Section from the dropdown menu.
  5. Under Object, select the object that has the labels you wish to translate.
  6. Under Aspect, select Field Label or Help Text from the dropdown menuThis action will display a list of the values that you can edit:Translation Workbench_ Translate ~ Salesforce - Performance Edition - Google Chrome 2017-07-04 16.19.30.png
  7. To edit a value, double-click on that field in the table and enter the text.
  8. Once you have edited all relevant details, click Save.

NOTE: You can find more information on the the various Kaptio Travel custom objects in the setup menu under Create and Objects.

How to translate using Translation Workbench export and import

As an alternative to translating text in the Salesforce UI, you can export a file of translatable text, translate it offline, and import it back into Salesforce in the desired new language. You can edit the export/ import file in a text editor. For more detailed information, refer to the Translation Workbench Salesforce documentation..

How to export a file of text to be translated
  1. In Kaptio Travel, click Setup in the top right hand corner of your screen.Export Page ~ Salesforce - Enterprise Edition - Google Chrome 2017-07-04 16.32.25.png
  2. Under Administer, expand the Translation Workbench options and click Export. 
  3. Select Source to customize, or one of the other options to translate.
  4. Click Export. This action exports a file containing all the custom labels and custom object text that you can then customize as desired.
How to import a file containing the translated label values
  1. In Kaptio Travel, click Setup in the top right hand corner of your screen.File “Import Page ~ Salesforce - Enterprise Edition - Google Chrome 2017-...” - Google Chrome 2017-07-04 16.36.36.png
  2. Click Choose File and select the file to import.
  3. Click Import.

Customizing with Translation Workbench override

How to override the master value of a text field:

  1. In Kaptio Travel, click Setup in the top right hand corner of your screen.Translation Workbench_ Override ~ Salesforce - Enterprise Edition - Google Chrome 2017-07-06 09.53.17.png
  2. Under Administer, expand the Translation Workbench options and click Override. 
  3. Under Package, select Kaptio Travel from the picklist.
  4. Under Language, select English.
  5. Under Setup Component, select Button and Link Label or Custom Field from the picklist.
  6. Under Object, select the object that has the labels you wish to override.
  7. Under Aspect, select Field Label or Help Text from the dropdown menuThis action will display a list of the values that you can edit:Translation Workbench_ Override ~ Salesforce - Performance Edition - Google Chrome 2017-07-06 10.11.21.png
  8. To edit a value, double-click on that field in the table and enter the text.
  9. Once you have edited all relevant details, click Save.

Known limitations

The Salesforce labels and translation feature have the following limitations:

  • The maximum length for object field labels is 40 characters
  • The maximum length for custom labels is 1000 characters
  • The maximum of 5000 custom labels per org. This is the combined maximum for Kaptio Travel and any other application you may have installed.