You manage multiple languages in Service Apps apps using keywords.

• Each keyword is associated with text information in the app. This information can be translated into all of the languages supported by the app.
• You can add a keyword to a widget's text field using the Translation tag... advanced tag or the Translation Tags Picker. Its label will then be dynamically displayed in the app based on the logged-in user's language.
• You can add a keyword to certain messages of data sources.
• Keywords are listed in a CSV file specific to each app. You manage this file using a dedicated data source called Translation and the translation editor.

Example

The CSV file associated with this example uses the following keywords.
       

Notes

• The CSV file must be encoded in CSV UTF-8 to avoid any conflict with accents and special characters.

• All templates available in the Service Apps template library are shipped with a multilingual file containing the translations of all text information in the six main languages: English, French, Portuguese, Spanish, German and Italian.
  • These translations are maintained by EasyVista for all templates.
  • Modifications made to the template's CSV file for a version upgrade will not be propagated to any existing app created with this template.

• When you create an app using one of the templates from the template library, it will automatically inherit the multilingual file of that template.
  • You can modify the translations provided in the six main languages.
  • You can add other languages supported by your app in columns L1 to L6, provided you already configured these languages in Service Manager.
  • You can add or delete keywords.

• When you create a new app with no content, no multilingual CSV file will be associated with it.
  • If you want to create a multilingual CSV file, you can download the template below. The template contains the relevant column headers.
             CSV file template

• Keywords in the CSV file are available for all app pages.

• You can add keywords to any data entry or descriptive field in a widget.
  • In the HTML Code, Label, Header/Footer properties used for entering HTML code, you can add keywords using a dedicated advanced tag in the text editor.
  • For descriptive properties where HTML code cannot be entered, e.g. page names, chart titles or legends, messages of data sources, you can add keywords using the Translation Tags Picker. 

• Keyword labels appear in the following format, #[TRANSLATION.<keyword>]# in the widget's text editor. They are displayed in the logged-in user's language in the Design pane of the graphic editor and in execute mode.

Caution

• You must not modify the column headers of the CSV file. The headers are mandatory for the translation process.
• When you modify the name of a keyword in the CSV file, this modification will not be propagated to the app. You must modify the name in all widgets using the keyword.  See the procedure.
• If you delete the CSV file, text information in the app will no longer be translated. Instead, it will be replaced by the #[TRANSLATION.<keyword>]# instructions.

Naming convention for keyword names

• Keyword names must be in the lower case.
• Keyword names must not contain any spaces. If required, use the underscore _.

  example  Keyword: creation_date instead of creation date

• They must not contain any special characters.

Best Practice

• Save a backup of the CSV file before making any modification to its contents. If required, you can upload the backup file to revert back to the earlier version.
• Use the advanced tag, Translation Tags, in the text editor or the Translation Tags Picker to avoid introducing errors in the #[TRANSLATION.<keyword>]# instruction associated with the relevant keyword.
• You must avoid making modifications, as much as possible, to the names of keywords once they are used in the app. This is because modifications are not automatically propagated to the widgets where keywords are used.

• If you want to create a multilingual CSV file, you can download the template below. The template contains the relevant column headers. You can then add your list of keywords and labels for each of the languages supported by your app.
           CSV file template

Screens description

Translation data source

Multilingual management is based on a dedicated data source called Translation which is used to retrieve keywords from the CSV file (comma-separated values in structured text format). Once you upload it, all keywords will be available for the entire app.

Access: Click  in the Objects pane of the graphic editor.

CSV Data Editor: Used to open the translation editor for translating keyword labels into different languages.

• If no CSV file is associated with the app, the words, No Translation will appear instead of the Edit Translation button.
   

CSV Upload/Update Time: Date on which the CSV file was last uploaded or modified.

ChooseFile

Export Translation: Used to save the CSV file on the local machine so that you can modify it easily. You can then upload it again to the app. All text information in the app will automatically be refreshed.

Remove Translation: Used to delete the CSV file.

Translation editor

The translation editor enables you to check translated keyword labels easily in all of the languages used in Service Manager. You can then correct them if required, without opening the CSV file in Excel.

Access: Click Edit Translation in the CSV Data Editor section

Note: The modifications you make in the table will be integrated when you click OK.

KeyWord: Column containing all keywords listed in the CSV file.

Columns en, fr, sp, po, it, de: Translations in the six main languages: English, French, Portuguese, Spanish, German and Italian, for all templates.

Columns L1 to L6: Columns available for translations in six additional languages.

Add New Row: Used to add a row for a new keyword at the bottom of the table.

Delete Row: Used to delete the row selected in the table from the CSV file.
Note: You can select several adjacent rows.

Download CSV: Used to download the table displayed on screen.
Note: Unlike the download performed when you click the Export Translation button, the file you download here will contain all modifications made to the table even if they have not yet been validated.

Other functionalities

• Use the search field to filter keywords.
  • The search will run as soon as you enter the first character.
  • The search for the string of characters entered will be run on all columns.
           
• Double-click a column header to sort keywords based on this column. You can sort a column in ascending alphabetical order (A to Z)  or descending alphabetical order (Z to A) .
• To modify the contents of a cell, double-click it or click inside the cell and press the <F2> key.

Translation Tags Picker

The Translation Tags Picker enables you to enter keywords in a descriptive field, e.g. page name, chart title, text displayed by default in a search field (Search Placeholder), etc.
Note: Unlike HTML fields, only one keyword can be selected in a descriptive field.

Access: Click  next to the descriptive property.

Item Label: Keyword to be applied to the descriptive field.
 

Other functionalities

• Use the search field to filter keywords.
  • The search will run as soon as you enter the first character.
  • The search for the string of characters entered will be run on all keywords.
           
• Click  to unselect the keyword.
         

Procedure: How to translate an app

Step 1 (optional): Select a multilingual CSV file.

Note: If you created your app using a template from the template library, a CSV file will automatically be associated with the app.

1. Open the graphic editor.

2. Click  in the Objects pane.
The Properties Inspector of the Translation data source will appear.

3. Click the Choose A File field and select the CSV file. You can also click and drag the CSV file to this field.
All keywords in the file will be available for the entire app.

Step 2 (optional): Modify the contents of the CSV file.

Note: If you created your app using a template from the template library, translations in the six main languages will automatically be loaded.

1. Click Edit Translation in the CSV Data Editor section to open the translation editor.
The CSV file will appear.

2. Make the required modifications.

Modify the translations of a keyword

• Double-click the cell to be modified.
  or
  Click inside the cell and press the <F2> key.
• Translate the keyword into the relevant language.
   

Add a keyword

• Click Add New Row.
  A new row will be added at the bottom of the table.
• Enter the keyword in the KeyWord column.
• Translate the keyword into each of the languages supported by your app.
   

Delete a keyword

• Click the row containing the keyword to be deleted.
• Click Delete Row.
   

3. Click OK to save your changes.
The translation editor will close.

Step 3: Place keywords in the app's widgets.

1. Enable the widget where you want to insert a keyword.
The Properties Inspector will appear.

2. Follow the procedure below based on the type of field where you want to insert a keyword.

Place a keyword in a descriptive field