Configure Translation in Manager

   MaestroThe UI design product.  |   Form Builder |  All versions This feature is related to all versions.

Journey Manager allows you to translate form's UI into another language, so a form user can switch between available languages, In which case, the form pulls a language file from a Manager server.

You can edit the languages in either Maestro or Manager. The later allows for different workflow options, such as loading a translation JSONJSON (JavaScript Object Notation) is an open standard file format and data interchange format that uses human-readable text to store and transmit data objects consisting of attribute–value pairs and arrays. file created by a third party. This JSON file is created for each language and is added to the form in Journey Manager via a form property, so the translation can be created and edited outside of Maestro.

When a form user switches between available languages, the form will pull a language JSON file from the server. This allows form builders the ability to edit the languages in either Maestro or Manager. Editing the language in Manager allows for improved workflow options, for example, a third party can create the translation file which can then be loaded into Manager without any extra workload for the original form builder.

The JSON file created for each language can be added to the form in Manager via a Form Property, or the language values can be entered directly into the Maestro editor. Translation language values can be created and edited outside of Maestro, however, when translation values are created and edited in Maestro, no Manager modifications are required. Using Maestro to enter translation values is beneficial as it automatically handles things like refactoring.

Even though the translation file is completed outside of Maestro, the form still needs to have the Select Language dropdown, with the correct options configured, and the new languages need to be created in the Translation window. In Maestro you will not enter any translation values as that will be done in the file outside of Maestro. Once the translation file has been created you need to create a form property for the JSON file.

To create a form property for the JSON file containing translation:

1. Open a form property and click New.
2. Enter the property name in the Name field, which needs to be in a specific format so the Select Language component can correctly match the JSON file with the selected option. The name should be locale-en.json, where "en" is the language ID used with the language was created in Maestro.
3. Select JSON from the Data Type dropdown list.
4. Provide the content of the translation file in the Value field or click Choose File to upload the file from your PC.
5. Click Save to update the changes.
6. Render the form and try the Select Language dropdown to verify the form content is translated correctly as per the JSON file.

Next, learn how to configure a new language in Maestro.