Localize Applications

Apply localization and adapt your applications and their content to a specific locale. You can make your applications usable for a new locale by translating the content from the source language to the language used in the locale.

By default all applications are created in English. You can add language resources (locales) and then localize process and form elements by providing localized strings. When the application is published and viewed by users, the published content displays labels in the localized language based on the users’ browser language setting.

You can localize your application components such as process and form elements, human task titles and outcomes from the Localization page. The Localization editor provides a consolidated and editable view of all your default and translated resources. Its interface allows you to manage all your localization resources from one place.

Apart from the Localization editor, you can apply localization to specific application components from within those components. For example, you can also localize form field labels in the Form editor.

See Localize Web Forms.

See Localize Processes.

Topics

• Add Locale
• Work with the Localization Editor
• Add Dynamic Parameters to Task Titles

Add Locale

You can add locales to adapt your process applications to specific geographical markets.

1. In the Application home pane, click Localization.

   The Localization page opens and you see all the available language resources (locales) specified for the application.

   Note that initial setting for the locale of any newly created application is English. The initial setting doesn’t derive from the browser’s locale, nor does adding a language to the application’s options change the application’s initial language setting.

2. Click Show/Hide right pane (3 dots) to open the General Properties pane.
3. Click the Add Locales link.
4. In the Add Locale dialog box use the shuttle controls to add the languages you want to support in the application.

   
   Description of the illustration add-locale.png

5. Click OK.

   This action adds the selected languages to the application’s set of language resources. Once a language has been added, you can localize content for that language.

Work with the Localization Editor

The localization editor provides a consolidated interface to manage all your default and translated resources.

Click a locale (language resource) in the Localization page, for example English, to open it in the Localization editor. The localization editor’s central canvas has the following columns: Component, Element, Property, Default Text, and Translation. There is a search field and a filter field at the top left. You can filter by component to display elements related to either Form or Process. Use the search field to find and display a specific element.

Column	Description
Component	The component of the application. For example, Form or Process.
Element	The element of the particular component. For example, the First Name control of a form.
Property	The property of the form or process element. For example, Label of a particular form field or the Title of a process within the application.
Default Text	The text that has to be localized.
Translation	The localized version of the default text.

There are four icons (on the top right) that enable you to complete different tasks in the editor.

Icon	Description
Maximize	Expands the central pane with the five columns (Component, Element, Property, Default Text, and Translation).
Save Changes	Applies and saves the changes done in the Translation column.
Show/Hide Duplicates	Shows or hides duplicate rows. Note that changes done to one row will be applied to all duplicate rows, when they are collapsed.
Show Columns	Displays the columns selected in the drop-down menu. Click the drop-down menu to select the columns that are to be displayed.

To localize contents of an application:

1. Click Localization in the Application home pane.
2. In the Localization page, select a locale in which you want to localize.

   If a locale is not available, add it to the page. See Add Locale.

   All the application components of the selected locale gets displayed in editor.

3. Enter the translated text in the Translation column of the selected row of the Process or Form component.
4. Click Save Changes.
5. If you have applied localization to form components, preview the form to see the localized form field labels.

   
   Description of the illustration localization-preview-form.png

Add Dynamic Parameters to Task Titles

You can add dynamic parameters to task titles and localize them in runtime.

1. Select the human task in the process flow. Click the options menu and then click Open Properties from the menu.
2. In the implementation pane, add dynamic parameters (for example: {0}, {1}) to the task's title, and then click the editing icon.

   
   Description of the illustration tasktitle-dynamic-param.png

3. In the Define Title Arguments dialog box, specify the value to be passed. Enter the value directly in the Value field.

   
   Description of the illustration define-title-arg.png

4. Optionally, click the expression editor icon to open and use the editor to specify an expression. In the Expression Editor, select the expression to insert from Data Objects or Operators. Click Insert Into Expression, and then click Validate to verify the expression. Click OK.
5. Click OK to save the arguments and close the Define Title Arguments dialog box.