Working with Translation CSV files for Individual Languages

   MaestroPreviously known as Transact Maestro.  |   Form Builder |  v18.05 This feature was introduced in v18.05.

Translation can be applied to Maestro forms in many ways. Maestro allows you to edit single translation files by downloading the CSV translation file, editing it, and uploading it back into the Maestro form. 

To download, edit and upload a single translation CSV file, follow the steps below:

  1. Open a form with multiple languages configured.
  2. Select Translation.
  3. Select a language using the language dropdown menu and click Download. The languages in this list are established from the languages configured in Maestro. Clicking Download will download the German CSV translation file (normally named locale-xx.csv though the name of the file is arbitrary) to your computer.
  4. Open the downloaded CSV file in any CSV editing tool (e.g. MS Excel).
    The screenshot below displays an example of a downloaded Translation CSV file. The first column represents the labels of the form, the second column contains the base language and the third column is where the translated language will display. If the translated language has not been entered yet, then the base language will appear as a placeholder in the third column and should be updated with the new language.
  5. Edit the CSV file by entering translated values into the third column. For example, Hello translated to German is Hallo.
  6. Note

    Maestro does not support multiple sheets in a single workbook, so when you edit the CSV file, it is recommended that you DO NOT create/use multiple sheets.

  7. Save the CSV file. The name of the file is not important but the file type (CSV) is.
  8. Note

    If your translation (language) uses non-ASCII characters, you need to "Save as" a UTF-8 CSV File.

    Note

    ASCII characters include the digits 0 to 9, lowercase letter a to z, uppercase letters A to Z, and punctuation symbols (e.g. %,$,*,&). More information on ASCII can be found at https://www.computerhope.com/jargon/a/ascii.htm

  9. Navigate back to the Translation Window (in Maestro) and click Upload.
  10. Navigate to the location of the saved CSV file on your computer and select it as an upload option.
    Selecting the CSV file will upload it to the opened form.
  11. Click Save to update the changes. It is recommended that you click Save to ensure your changes are saved in the form.