Set Up a New Language in Maestro

   MaestroPreviously known as Transact Maestro.  |   Form Builder |   v17.10 This feature was updated in v17.10.

To set up translation in Maestro, select Translation from the Maestro toolbar.

Languages are configured in the Translation window. The Translation window displays the default language for the open form. If more than one language is configured, you can use the dropdown at the top of the window to switch between languages.

The first column in the window shows the property path (keys) for objects within the form and the second column shows the labels as displayed based on the selected language (default language). You are not able to edit the default language in the Translation window, as it is directly derived from the form component properties. 

Create a New Language using the Maestro User Interface

To create a new language for a form using the Maestro user interface, follow these steps:

  1. Click New Language.
  2. Enter the language Label and Code.
  3. Enter a Label and language Code for the new language and click OK. The label is the name of the language and the code identifies the language, these values can be anything, they are simply identifiers for the new language.
  4. After clicking OK, the Translation window will display with three columns - Property path (keys), Default Value and the Translated Value to use when the language is selected.

  5. Enter the translated values into the Translated values column (for example Name translated to Spanish is nombre) and click Save.

Prior to Maestro v18.05, the View as JSON functionality is available in the Translation window. This functionality, which allows you to view the selected translation file in JSON format, was removed from Maestro v18.05 as translation files are stored as CSV files in that release.

The search box at the top of the window will allow you to search based on the Property Path. The Property Path matching the entered criteria will display in the window.

If you have a component selected when you click the Translation button, the list will scroll to the selected Property Path. The scroll position will remain as you switch between languages.

Once you have found the Property Path you want to translate you can enter the translated value in the third column. 

Once the language has been set up, configure the Maestro form with the select language dropdown component.