Aqtra Platform provides a built-in ability to support multiple UI languages available for an application built using the Platform.

The way multiple UI languages are supported is that instead of providing hard-coded text labels for component UI controls, application creator can define a common internal name (called a Translation Key), that will be dynamically switched to the appropriate locale using provided Localization strings translation mapping mechanism.

Here is how it is done.

Setup a Translation Key while configuring a UI for a Component

As you are adding your UI Controls to create a different forms for your Component, you now have an ability to setup a Translation Key instead of providing a hard-coded label. For example, in the screenshot below from our Tutorial #1 there is a button Save.

If we do not need a multi-language UI, we can just type our “Save” label in the Translation Value field. However, with localization capabilities, we can now provide a unified Translation Key that will be automatically translated to a proper button label based on a locale selected during application execution. Using this approach, our application can be easily extended without recoding to have UI in multiple languages.

To do that, we will need to:

• Type a name for a new Translation Key in the Translation Key field
• Two things can happen - either (B) there are key with such name that already exist, or this is a new key (A)
• (A) If this is a new key (no other key with such exact name exists), the pulldown list will say “no results found). Then you will need either click on “no results found” or press Enter key to add this new name as a Translation key. The name of the key will then be shown in Green frame, and after you save your component, the key becomes available to setup in Localization Strings area of Localizations section of Studio

• (B) If there are existing keys with such name, they will be shown in a pull down menu as you type (for example, if you have SaveButtonA and SaveButtonB keys, both will be shown as you type SaveButton). You can then select a translation key you want from the pulldown menu, as shown in screenshot below