SimpleOne supports multilanguage localization. You can add the language you need and translate the interface elements accordingly. In the out-of-the-box SimpleOne solution, two languages are available: Russian and English.
You can localize the following elements:
You can upload translations into the system, set up links between the localized version and the original version.
Role required: admin.
Add a language
To add a new language, follow the steps below:
- Navigate to System Localization → Languages.
- Click New and fill in the fields.
- In the Language field, specify the language code of localization. You can write no more than two symbols. Then fill in the Name field.
- Click Save or Save and exit.
Now you can refer to this Language (sys_language) table to build your localization. The language will also appear in the Preferences menu.
Localize interface elements
Before starting the localization, check that all necessary languages are created in the Languages (sys_language) table.
You can localize fields of the Translated Text type in two ways:
- by creating a record in System Translations table.
- by switching the system language.
To add new translations, complete the steps below:
- Open the record for which you need to add a translation.
- Navigate to the Related Lists area.
- On the Translations tab, click New and fill in the fields.
- Click Save or Save and exit to apply the changes.
Another way to add localization via System Translations is the following:
- Navigate to System Localization → System Translations.
- Click New and fill in the fields.
- Click Save or Save and exit.
In this case, add the record ID manually.
System Translation form fields
Field | Mandatory | Description |
---|---|---|
Column | Y | Specify the column name containing the field that you need to translate. |
Language | Y | Specify the language of the translation. |
Value | N | Add the translation of the original value. |
Record | Y | A unique ID number of the record. It is filled in automatically, if you translate via Related Lists of the record. If the ID field is empty, type the ID of the record. |
To localize elements by switching the system language, perform the following steps:
- Open the record you need to translate.
- In the Preferences menu, change the language of the system to the localized one.
- Enter a new translation.
- If the system language is English, type the new value in English.
- Click Save or Save and exit to apply the changes.
In the Related Lists area, select the Translations tab to check if the translation is saved correctly.
Choice list localization
The localization of choice list options differ from the localization of any field of the Translated Text. To localize a choice list, complete the steps below:
- Navigate to System Settings → Choice Options.
- Click New and fill in the fields.
- Click Save or Save and exit to apply the changes.
Translated choice option form fields
Field | Mandatory | Description |
---|---|---|
Table | Y | Specify the table to which this choice option is related. Select the same table for the translated version as for the original one. |
Column | Y | Specify the column to which this choice option is related. Select the same column for the translated version as for the original one. |
Title | Y | Add the translation of the source option. |
Language | Y | Specify the language code (ru, en, and so on). Languages records are stored in the Languages (sys_language) table. |
Value | Y | Type the same value as specified for the source option. Do not enter the translation in this field. Value can be used in the business logic. It is not displayed in the interface. |
Order | Y | Enter the number to define the option order in the choice list. |
Repeat these steps for other choice options.
If some choice options were not fully localized, choice lists with untranslated options will display English values by default, regardless of the current user locale.
To avoid such situations, use caution when adding option values to your choice lists.
Localize messages
To localize such elements as welcome messages, informational or warning messages, some other kinds of messages, and also condition operators, you will need two tables:
- the Source Messages (source_message) table – contains original messages in English.
- the Messages (message) table – contains localized messages in the user's languages (Russian, German, etc).
source_message
Field | Mandatory | Description |
---|---|---|
Message | Y | The text of the message. |
message
Field | Mandatory | Description |
---|---|---|
Source message | Y | Specify the source message that needs a translation. |
Language | Y | Specify the language code (ru, en, and so on). |
Translation | Y | Ass a translated message. |
These two tables are bound by ID. It means that every message in the Source Messages table has a unique ID, and its translated version in the Messages table has the same ID.
For example, the "Login" record in the Source Messages table has ID 15596431050000002, as well as the "Логин" record has in the Messages table.
To add new translations of the message via Source Messages, complete the steps below:
- Navigate to System Localization → Source Messages.
- Open the necessary record.
- Open the Messages tab in the Related Lists area.
- Click New and fill in the fields.
- Click Save or Save and exit.
You can also see the translated variants of any message in the Messages table.
There is another way to localize a message. To do so, complete the following steps:
- Navigate to System Localization → Messages.
- Click New and fill in the fields. In the Source Message field, you should specify the exact message you need to localize.
- Click Save or Save and exit.
Do not change original messages in the Source Messages table. It can cause malfunction on the instance. If you need to make changes in any source message, create a copy of it in the Messages table with the necessary text and fill in the Language field with the en value.
Edit translations
Interface elements
There are two ways to edit translated elements of the table. To edit any record via the Related Lists area, follow these steps:
- Navigate to the record you need to edit.
- In the Related Lists area, open the Translations tab.
- Find the translation that needs editing, change the Value field.
- Click Save or Save and exit.
There is another way to edit the translation via the System Translations table.
To perform the editing, complete the steps below:
- Navigate to System Localization → System Translations.
- Open the record that requires changes and edit it.
- Click Save or Save and exit.
Choice options
The steps for editing the translation of choice options is similar to creating translations.
To edit the translation of choice options, take the following steps:
- Navigate to System Settings → Choice Options.
- Open the necessary record and edit the Title field.
- Click Save or Save and exit.
Messages
Since the two tables Source Messages (source_message) and Messages (message) are bound by the same ID, you can edit flash messages, condition operators in both of them.
To make changes via the Messages (message) table, complete these steps:
- Navigate to System Localization → Messages.
- Open the necessary message or operator and edit the Translation field value.
- Click Save or Save and exit.
To edit the translation via the Source Messages (source_message), take the following steps:
- System Localization → Source Messages.
- Open the necessary message.
- In the Related Lists, open the Messages tab and find the translation you need. Edit the Translation field value.
- Click Save or Save and exit.
- No labels