This article will cover the steps required to add another language to Autoform DM.

This is currently only available via manual translation and configuration, as Autoform DM is only shipped with an English language set. Anyone implementing support for another language will be required to do their own translations.

Identify locale

Identify the locale code for the specific language required. For example, if you want to provide a German translation, the locale would be "De". A list of locale codes can be found at https://developer.chrome.com/webstore/i18n#localeTable.

For the rest of this guide, we will refer to locale "De"; however, wherever you see this locale you should substitute your required locale.

Translate files

You will need to provide file translations for each of the .properties files containing display text.

The files within pdm_app_module.ear that should be translated are:

logging-service-*.jar/pdm-logging.properties
system-reporting-*.jar/ApplicationResources.properties
web-common-*.jar/ImportDocumentApplicationResources.properties
web-*.war/applet/DocImport.jar/AppletResources.properties
web-*.war/WEB-INF/classes/ApplicationResources.properties
web-*.war/WEB-INF/classes/pdm-logging.properties
web-integrations-*.war/applet/DocImport.jar/AppletResources.properties
web-integrations-*.war/WEB-INF/classes/ApplicationResources.properties

In order to translate the files, you must:

1. Make a copy of the original .properties file.

2. Rename the copy with your desired locale using the format: <resource_name>_<locale>.properties, for example: ApplicationResources_de.properties.

3. Translate the copy as desired

.4. Add the copy to the .ear file alongside the original.

For example when translating to German:

login.username=Username login.password=Password

Becomes:

login.username=Benutzername login.password=Passwort

Update server locale

For Autoform DM to configure the changes, the server it is running on must be configured with the desired locale. 

On Windows follow these steps:

1. Navigate to Region & Language Settings

2. Set your Country or region to the correct region, for example, Germany

3. Add a language for that region, for example, Deutsch (Deutschland) and set it as the default

When you next restart Autoform DM, the regions should be configured correctly for the server and display the correct language.