How to internationalize your Apps?
From the App perspective, you can use the App Message Hash Variable to make sure that your app is internationalized.Introduction
Messages is used to manage customised locale messages and is particularly useful when you need to use a custom label in your forms, for adhering to certain locale.
After managing your messages here, see Hash Variable - App Message to append the i18n labels in your app.
Managing messages at Application level should only be done if you need to use custom messages that are not applicable to other applications.
Figure 1: Properties & Export - Message
Import PO File- Import a .po file to the App.
Generate PO File- Generate a .po file of selected locale in the App.
Add New Key- You may add your own message key value into your App.
Form Builder
This is a new feature in Joget DX 8.
Accessing it through the form builder is a new feature in DX 8.
Import PO File- Import a .po file to the App.
Generate PO File- Generate a .po file of selected locale in the App.
Deleting The Messages
There are two options to delete the i18n messages in your Form Advance Tools:
- Empty or delete the translation property field values and then click the Save button, Joget will delete the message record from the "app_message" database table.
- Use a database manager to delete the records - use this SELECT SQL query to display the records: SELECT * FROM app_message WHERE appId='crm' // Change the appId to your app's ID
Add Messages And PO Files
Related Documentation
Builder Advanced Tools > i18n Internationalization
You can also refer to Hash Variable - App Message (Internationalization)
How to set up the platform to support internationalization?
Joget Workflow supports multi-language from platform perspective as well as from the user perspective. To ensure that you have the language files, please download from https://translate.joget.org and import the respective language files into your installation.Introduction
In this section, one can manage and override the system's message.
Most of the message bundle files can be located in https://github.com/jogetworkflow/jw-community/tree/8.0-SNAPSHOT/wflow-consoleweb/src/main/resources
general.method.label.search=Search general.method.label.create=Create general.method.label.select=Select general.method.label.unselect=Unselect
You may add in new message or override existing message key value by clicking on Add Translation.
You can also Import PO File from Joget's translate site at http://translate.joget.org/
Figure 1: System Settings - Manage Messages
How to Import Translated Messages Into Joget Workflow
Let's take the Korean language as an example. After downloading the .po files, follow these steps to import the translated messages:
- Navigate to System Settings > Platform Translation.
- Click on the "Import PO File" button.
- Browse through for the .po file that you downloaded, then upload it.
- Repeat steps 3 and 4 for the rest of the .po files.
To enable the Korean language display, navigate to System Settings > General Settings, look for the System Locale option, then select the relevant locale which, for this example, is ko. Click on the "Submit" button; the selected locale (language) will take immediate effect.
For other languages, please refer to the corresponding locale as written above.
Setting the locale on the fly
You may append the parameter named "_lang" to override the current locale that you are seeing. For example, you can set the locale to Chinese by setting "_lang=zh_CN".
To reset, simply set the parameter "_lang" value to empty.
How To Copy Message Records To Another Joget Platform
If you need to migrate Manage Messages records from one platform to another, you can use this demonstration app APP_export_import_edit_message_dx_kb.jwa to export the system locale message records and import them into another Joget platform (for example from Joget Cloud to your Joget On-Premise). Just import the app in both of these platforms to use. The app read and write to the System Locale Message database table ( jwdb.wf_resource_bundle_message ) using JDBC ( SQL syntax is based on MySQL, so do change as required for MSSQL/ORACLE or PostgreSQL ). This app is not designed to read or write the ".po" or ".properties" file. The app just helps you edit or migrate records you have already created in the Manage Messages screen to another Joget installation.
Related Documentation
Builder Advanced Tools > i18n Internationalization
More info: Manage Messages