Translations

Translation definitions allow customization of all labels used across the platform, as well as adding new language support.

Translation UI

Translations can be defined with the following configurations:

• ID: Unique identifier for the translation domain (e.g. common, product)

• Entries: List of translations for the given domain

  • Key: Unique identifier for the translation key (e.g. save)

  • [locale]: Matching translation for a specific locale (e.g. key=save, enUS=Save)

Error Messages

A special translation entry with id "error" is used for mapping errors received in API responses to rich content displayed on the user interface.

If the received error includes an error code in response such as standard Rierino error codes, a translation entry with "CODE_[CODE]" key allows display of given message in error pop-ups. If no such entry is found, "message" field in error response is used as the message to display (which can refer to a dictionary entry as well).

In both cases, the final message is also allowed to use Handlebars templates, for populating custom Markdown formatted error messages using "detail" field in error response, such as:

**Validation Errors:**
{{#each errors}}
* {{getText title}}: {{getText message}}
{{/each}}

A special "getText" helper is available on these templates, allowing localization of data labels for current user language.