Translations

Tab “Translations”

Tab Translations, available in the form editor, enables adding translations for the form, composite components and business components. Here you can also add keys overriding the default form content (details in chapter Platform translation keys).

This tab also allows adding or modifying validator messages associated with components (details in chapters Composite validations and Script validators).

Figure 1. Form editor window - “Translations” tab

---

Editing a key and values

After selecting a cell in the table, you can edit both the key and the translation values for individual languages.

For multiline values, the edit field will automatically expand to show the full content.

Figure 2. Editing translations

---

Deleting a key

To delete an entire translation row, click the icon on the right side of the given key.

Figure 3. Deleting translation key

After deleting the key, a notification with the option to undo the operation will appear at the bottom of the screen.

Figure 4. Notification with option to undo key deletion

---

Adding a key

It is possible to add a translation for any form element displaying text - titles, descriptions, labels, validation messages, and content returned by external services.

Keys corresponding to validation error messages are added automatically when a validator is added. The exception is script validators, for which the key must be added manually.

To add a new key, use the button Add key located above the language columns.4

Figure 5. Button used to add a new translation key

Clicking adds an empty row, in which at least the key name must be filled in (column KEY). If the field remains empty, the system will automatically assign the name:

• empty

• empty.copy

• empty.copy1 and subsequent ones, if needed.

Figure 6. Row after adding a key and not filling in its name

---

Selecting the default language (tag)

The default language can be set in the table header. This option is available only while editing the process.

The default language is Polish.

To set a language as default, click the star icon next to the language code. A yellow star indicates the currently selected default language.

Figure 7. Selecting the translation language

---

Filtering empty translations

To hide keys without translations, click the icon in column KEY.

The active filter is indicated by a crossed-out “eye” symbol . Additionally, information about the number of hidden keys is displayed .

---

Searching translations

The search works both by key names and by translation values.

Figure 8. Searching translations

If no results are found, the following message is displayed:

We did not find the key or translation: ${szukanyTekst}

At this point, the user is also offered a suggestion to add a new key. After adding the key, the search field is automatically cleared.

---

Adding and editing languages

To add a new language, click the add new column button located on the right side of the table.

Illustration 9. Button for adding a new translation language

The language name (tag) can be changed by clicking its header.

Language code should comply with the ISO 639, written in lowercase. The list of supported codes is available at: https://www.oracle.com/technetwork/java/javase/java8locales-2095355.html

---

Determining the language used when opening the form

When taking up a form to fill in, the system determines the language in the following order:

1. The “locale” parameter in the URL

If the input address contains the locale parameter, and the template contains translations for the given language, then that language will be used.

Example:

https://url.eximee/webforms/ek/index.html?locale=en

---

2. Browser accepted languages (Accept-Language)

If the URL parameter is not available, and in the Webforms configuration the parameter:

server/locale/browserLocaleAllowed = true

then the system will take the language from the header Accept-Language, provided that the template has appropriate translations.

Example:

https://url.eximee/webforms/ek/index.html
Accept-Language: pl-PL,pl;q=0.9,en-US;q=0.8,en;q=0.7,en-gb;q=0.6,fr-FR;q=0.4,fr;q=0.3,es-CO;q=0.2,es;q=0.1

---

3. Default template language

If none of the above conditions is met, the default template language, set in Eximee Designer, is used.