Skip to Content

Translations in Jitterbit App Builder

Overview

App Builder's Translations feature allows developers to adapt their applications for international markets. By adding supported languages and configuring translation bundles, you can deliver a fully localized application to end users without having to rebuild it. App Builder supports a wide range of languages, enabling you to deliver localized applications to a global audience.

Translations are organized into bundles. A bundle is a collection of translation keys and their corresponding values for each supported language, linked to one or more applications and their associated data sources. At runtime, App Builder determines the user's preferred language and retrieves the appropriate translation from the bundle.

To speed up the translation process, App Builder integrates with the Babel service, which automatically generates translations for your bundle's keys across all supported languages.

Quick setup

The following steps describe the minimum configuration needed to add translation support to an application.

  1. Go to the IDE. In the Deploy section, click Language Translations.

  2. On the Supported Languages tab, click + Language and select the language to add. Click to save. App Builder begins fetching translations for the new language from the Babel service.

  3. On the Bundles tab, click + Bundle, enter a name and description, and click to save. Then click + Application in the Applications panel and select your application. This also adds any data sources linked to that application.

    Note

    New applications are automatically added to the default Site bundle. To use a dedicated bundle instead, you must first remove the application from the Site bundle before adding it to the new one. Creating a dedicated bundle per application is recommended to avoid conflicts when promoting translations across environments.

  4. On the Phrases tab, select your application and review the translation keys in the Phrases panel. Modifying a key here updates the corresponding control name, label, event message, or validation message directly in the app.

  5. On the Process tab, click Process next to your bundle to fetch translations from the Babel service. This runs as a background job. Refresh the page after a minute or two to see the results in the Chart By Status panel.

For a detailed description of each tab and its options, see the IDE Language Translations page.

Translators role

Users that are members of the Translators role have permission to edit translations. Members of this role can access the Language Translations page and modify translation values directly, without requiring developer-level access to the IDE.

To assign a user to the Translators role, see Roles-based security.

Change your language

App Builder displays content in the language configured for your user account. To change it:

  1. Open the Action drawer and click View User Profile.

  2. In the Language field, select your preferred language. Only languages that have been added on the Supported Languages tab of the Language Translations page are available.

  3. Refresh the page for the change to take effect.

Enable data translation

By default, App Builder translates UI strings such as control names, labels, and messages. You can also enable translation at the data layer so that database columns, business logic expressions, and templates are also translated when displayed to users.

Database columns

To mark a database column as translatable:

  1. Go to the App Workbench, click Tables, and select a table. Double click a string column to open the Column dialog.

  2. In the Advanced section, select the Translatable checkbox.

  3. Click Save. The column appears in the Translatable Columns panel on the Phrases tab of the Language Translations page.

Note

Only columns with a String logical data type are translatable (including Email and URL, which are string-based). If the column already contains data, you must also fetch translations for the new values by processing the bundle or using Fetch App Builder Translations on the Supported Languages tab.

Business logic expressions

To mark a business logic expression as translatable:

  1. Go to the App Workbench, click Rules, and open a rule's edit screen. On the Columns tab, select an expression column to open the Column dialog.

  2. Click More, then select Edge Case. A new dialog opens. In the Business Layer section, select the Translations checkbox.

  3. Click Save.

Note

Only expression columns are translatable at the business logic layer. Columns that reference a table column directly are translated at the database layer instead.

Templates

For information on enabling translations for templates, see Translation templates.