Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Current »

Localization

Agiloft supports international language localization.  To fully translate the interface requires interaction with two files: the first applies to system properties and is server-wide; the other is knowledgebase-specific text.

Localization does not include the ability to translate record data.

All system text is held in a single file; the system-wide localization controls the general program text, such as the text within setup wizards, error messages, and so on. A second file controls the terms specific to each knowledgebase, such as the names of tables, field labels, input instructions, and header text.

Changing knowledgebase-specific text can be done by users with system admin privileges in the knowledgebase, and is KB-specific.

Changing the system properties file on requires server-level admin access to the installation directory. We recommend contacting our support team to assist you.

Downloading the translation files

To download the localization files:

  1. Go to Setup > Localization.
  2. On the Language tab, select the target language from the drop-down. Click Next.
  3. On the Table tab, Table Tree at the top to create a translation file for all the tables in the system. Table names appear in red when there is no available translation. To translate the text in a specific table, highlight the table name you wish to translate. Click Next.
  4. On the Options tab, choose whether to exclude previously translated text. Click Next.
  5. The Translate tab now shows two files for download: language.txt and GUI2_xx.properties, where xx is the java locale for the selected language.

The language.txt file (e.g., Swedish.txt as pictured here) holds the knowledgebase text; GUI2_xx.properties contains the system or program text.

Localizing the User Translation File

There are two ways to localize the user translation file in a knowledgebase: you can manually translate each named object, or use the localization file containing all custom text. The text is stored in a file

Translating the entire knowledgebase

To translate all knowledgebase text at once, you can download a single localization file, translate it, and upload it back to the knowledgebase.

The localization file is a property file. It contains 'key=value' pairs, where the key refers to a specific item like a field name, and the value is the localized field name value.  The localization file is stored in UTF-8 encoding and can be edited in any program that supports that encoding.

  1. Download the translation file for the target language.
  2. Edit the language.txt file and translate each value. See (translation tips page)
  3. Upload the translated file to the knowledgebase.

The localization file will be stored in your knowledgebase only, and does not interfere with other knowledgebases on the same server. It will remain in the knowledgebase after reimport and when copying the knowledgebase.

If you want all new knowledgebases created on your server to include the localization file, translate the default Demo Knowledgebase. New knowledgebases are created by based on the Demo template.

Uploading the translation file

After the file is translated, follow these steps to upload it to a knowledgebase:

  1. Go to Setup > Localization.
  2. On the Language tab, select the target language from the drop-down.
  3. Navigate to the Translate tab.
  4. Click Browse... to find and select your file, then click Upload.
  5. Save your changes.

Translating as you go

You can translate an individual item with the following steps. As an example, we'll translate the People table label into French:

  1. Select the target language from the Language menu drop-down in the upper right.
  2. Navigate to the appropriate setup wizard.
  3. Enter the translated value for the label.
  4. Save your changes.

You can use this method to relabel a table, field, label, choice field item, admin description, etc.  The changes you make are stored and kept in the appropriate language file for the knowledgebase.

Localizing the System Properties File

System properties are server-wide and stored in the GUI2.properties file. You can download the file through the Setup menu of any knowledgebase.

See Localization file tips for help, or contact support.

Send your localized GUI2.properties file to Agiloft Support after translation so we can include it in a future release build. If you upload a customized file directly into your system, the next system update will overwrite it.

Related articles

  • No labels