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.

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.

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.

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.