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 Message - You may add your own message key value into your App.


Add Messages And PO Files


Related Documentation

Manage Messages

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/7.0-SNAPSHOT/wflow-consoleweb/src/main/resources

Excerpt of console.properties
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 Message.

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:

  1. Navigate to System Settings > Manage Messages.
  2. Click on the "Import PO File" button.
  3. Browse through for the .po file that you downloaded, then upload it.
  4. Repeat steps 3 and 4 for the rest of the .po files.

To enable the Korean language display, navigate to System Settings > System Setup, 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

Message

Builder Advanced Tools > i18n Internationalization




More info: Manage Messages

  • No labels