View source for Translation Workbench

'''Designer > Global Resources > Translation Workbench'''

The Translation Workbench makes it possible to deliver an application in multiple languages, by mapping words or phrases in a different language to the (default) English language labels. 
__TOC__
== About the Translation Workbench ==

By default, the platform user interface (UI) is labeled in English. In order to make the platform more usable for a global audience, these [[#Eligible Platform Elements|Eligible Platform Elements]] can be customized with language labels. These configurable platform elements are presented in a language that is more familiar to users, which improves their effectiveness. Any of the [[Supported Languages]] can be selected. The [[Audit Log]] will reflect language translation, if it has been implemented.

{{Enablefeature|Multiple Languages|Manage Tenant Capabilities}}
{{permissions|Manage Translation Workbench|View, Import or Export the translation tables}}

Although generally intended for localization of {{Type|}}s, the translation workbench can also be used to modify the labels associated with {{Type}}s.

Developers can specify Java-style i18n labels and default values for [[#Custom Labels|Custom Labels]].

Multiple languages can be enabled for a single platform tenancy. Individual users can select a default from the list of available languages.

:''Learn more:'' [[Language Translation]]

==Load the Translation Workbench==
In order to enable Multiple [[Language Translation]], language labels must first be loaded to the Translation Workbench. Two methods are available to load the Translation Workbench:
:;Manual Edit:Use this option to [[#Manual Edit|change language labels individually]]
:;Import and Export:Use this option for [[#Import and Export|mass changes to language labels]]

===Manual Edit===
To edit individual language translations:
#Click '''Designer > Global Resources > Translation Workbench'''
#Use the following options to navigate to the element of interest:
#;Language:Choose one of the available languages from the list.<br>(The choices are determined by the [[Company Information]] settings.)
#;Elements:Choose one of the  [[#Eligible Platform Elements|Eligible Platform Elements]] for editing
#::Type and Subtype:Optional, and are not presented with every Language + Element combination
#Click the '''[Edit]''' button
#Manually edit the Translated Display Label
#Click '''[Save]'''

===Import and Export===
To create a new language translation file in [http://en.wikipedia.org/wiki/Comma-separated_values CSV] format, follow this procedure:
:'''Step 1''': Export an existing language set.
:'''Step 2''': Change the language-designation for each entry in the file.
:'''Step 3''': Add the translated entries into the file using an external translation system.
:'''Step 4''': Re-Import the resulting file to create a new language option.

;Considerations:
*Translation Id is unique to each tenancy
*The import will fail if:
:*The order of the fields in the CSV file is changed
:*The Translation Id field is changed
*Objects have two records in the translation export file, where ''Item Type'' is ''Object Singular Label'' and ''Object Plural Label''

====Export Translation Entries====
To export an existing language to a file:
#Click '''Designer > Global Resources > Translation Workbench'''
#Click the [Export Translation Entries] button
#In the Translation Information section, select:
#;Language:Choose the language to export
#In the Email Address Section, select:
#;Email address:Enter an email address
#:A link to the CSV file is sent to this email address.

The contents of the CSV file can be translated to any desired language. It contains the labels for all [[#Eligible Platform Elements|Eligible Platform Elements]].

====Change Language Designation====
A typical language translation files can contain thousands of records. Here is part of one exported from the platform:

:{| border="0" cellpadding="5" cellspacing="0"
|
<syntaxhighlight lang="text" enclose="div">
Translation Id,Language,Item Type,Additional Info,Base Label,Translated Label
11eb24840b494736933dfea6ed13b50a,en,Object Singular Label,,Account,,
11eb24840b494736933dfea6ed13b50a,en,Object Plural Label,,Accounts,,

60ed42521fd54de5a24d294ee8494db9,en,Object Plural Label,,Active Employees,,
5f13c0b09d93427eb073a38c31146f68,en,Object Plural Label,,Benefits,,
443eeb61c2cf4e6da297bf80b09a5c2a,en,Object Plural Label,,Cases,,
58f403513d8d40bb9f0190cb0974add5,en,Object Singular Label,,Company,,
11ee93bca9f649ceadbee7a66ec163d4,en,Object Singular Label,,Compensation,,
c3d33c48ba104eefa2d56ae45f39c667,en,Object Plural Label,,Contacts,,

fa2d4a8bc6e24d4f8a3c6d2bcfcb6c1c,en,Section,Object:Contacts,Layout Name:Default Layout,Contact Information,,
da7d3db7e078419ebc583a1a4f061ea0,en,Section,Object:Contacts,Layout Name:Default Layout,Description Section,,
 . 
 .
 .
 
</syntaxhighlight>
|}

Note that the language-designation for each entry is "en" (English). When translating the language into Spanish, for example, you would do a search/replace to change each instance of ",en," to ",es,". (Adding the commas ensures that you don't make an unintended change.)

====Import Translation Entries====
To import the translation entries file:
#Click '''Designer > Global Resources > Translation Workbench'''
#Click the '''[Import Translation Entries]''' button, and complete the following information:
#;Language:Specify the language to import
#;Select the file to load:Click the '''[Browse]''' button to navigate to the file
#Click '''[Save]'''

==About Elements in the Translation Workbench==
Each language translation file contains these elements:
*Language
:*English (Default)
:*Other languages, as available
*Element
:*Type (of Element)
::*Subtype (of Element)


===Eligible Platform Elements===

To view translation entries, you choose Language, Element, type, and subtype, where the ''type'' and ''subtype'' options depend on the ''Element''. (In the example shown below, the type is "Objects", and the subtype is "Workflow".)

::[[File:translationworkbench.jpg|border|none]]

For each item, the following information is shown:
:*Name
:*Elements (Optional)
:*Default Display Label
:*Translated Display Label
:*Default Display Label (Plural), Translated Display Label (Plural) (Optional)

===Types and Subtypes===
::{| border="1" cellpadding="5" cellspacing="0"
!Element
!Type, Subtype
|-valign="top"
|Actions||Objects
|-valign="top"
|Applications|| 
|-valign="top"
|Custom Labels||Category
*Category Name
|-valign="top"
|Digital Signatures||Objects
|-valign="top"
|Enumerated Fields|| Objects  
|-valign="top"
|Fields|| Objects
|-valign="top"
|Forms|| Objects 
*Sections
*Quick Links
*Related Information
*Related Information Button Labels
|-valign="top"
|Global Picklists||Global Picklist
|-valign="top"
|Home Pages||Applications
*Label
*Widget Title
:*Pages
|-valign="top"
|Objects|
|-valign="top"
|Report Folders|| 
|-valign="top"
|Reports|| 
|-
|Sidebar
|
*Label
*Widget Title
:*Sidebars
|-valign="top"
|Validation||Objects
|-valign="top"
|Views||View Type
*Object Related Views
:*Objects
*Other Views
|-valign="top"
|Web Tabs
|
*Label
*Widget Title
:*Sidebars
|-valign="top"
|Workflows||Objects
* Workflow
|}

==Custom Labels==
{{:Custom Labels}}

==Custom Labels For Developers==
{{:Custom Labels For Developers}}
     

<noinclude>[[Category:Global Resources| 6]]</noinclude>
<noinclude>[[Category:Language Translation]]</noinclude>
<noinclude>[[Category:{{features}}]]</noinclude>