Platform Translation

Platform Translation in Joget DX 8 allows administrators to manage and override system messages, providing flexibility to adapt interface language and terminology to suit specific organizational needs.

Managing system messages

System messages are typically stored in message bundle files, such as console.properties, located in:

Example from console.properties:

general.method.label.search=Search
general.method.label.create=Create
general.method.label.select=Select
general.method.label.unselect=Unselect

Adding or overriding messages

  1. Go to System Settings > Platform Translation.
  2. Use the Add Translation feature to add new messages or override existing ones.

You can also Import PO File from Joget's translate site at http://translate.joget.org/

Import translated messages into Joget's workflow

Let's take the Korean language as an example. After downloading the .po files, follow these steps to import the translated messages:

  1. Go to System Settings > Platform Translation.
  2. Click on the Import PO File button.
  3. Browse through the .po file that you downloaded, then upload it.
  4. Repeat for additional languages.

To enable the Korean language display, go to System Settings > General Settings, look for the System Locale option, and then select the relevant locale, which, for this example, is ko. Click the Submit button; the selected locale (language) will take immediate effect.

For other languages, see the corresponding locale 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, 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 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 into both of these platforms to use. The app reads and writes 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 helps you edit or migrate records you have already created on the Manage Messages screen to another Joget installation.

Download the demo app to export the system locale message records and import them into another Joget platform:

Additional resources

By leveraging Platform Translation in Joget, administrators can ensure system messages are seamlessly tailored to meet specific language and localization requirements.

Created by Julieth Last modified by Aadrian on Dec 13, 2024