Enabling Languages and Locales

By default, Web Central enables only the single language that matches the server's operating system locale. For example, if your locale is “fr-FR”, Web Central enables French. Loading fewer languages at start-up speeds the start-up process.

Out-of-the-box Localized Archibus

Without customization, Archibus can appear in these languages if the locale is set to these languages:

• French

• Italian

• German

• Spanish

• Dutch

• Chinese

• Japanese

Additionally, if you set the French, Italian, German, or Spanish locale, you will receive a translated version of Archibus Help.

Enabling Languages

You can enable multiple languages if you have users that speak different languages or if you wish to switch between languages. To do so:

1. Edit the WEB-INF\config\context\compatibility\afm-config.xml configuration file.
2. Change the “enabled” attribute for each language that you want to support to “true” rather than “auto.”
3. Additionally, you may need to do the following:

• If you are using Web Central, set the Localeoption for each user to the proper language using the System / Archibus Administrator / Add or Edit Users form. When each user logs in, Web Central will appear in the language specified for this user. Users can also set the Locale from the My Profile command.

• If you are using the Smart Client, use the Preferences command within Smart Client to change the preferred language, then restart the Smart Client. The program will now appear in the language you chose.
• If you are using Chinese on Microsoft SQL Server, remember you need to load the Chinese version of the database (e.g. Schema\mssql\MsSql_Schema.MDF or Projects\Hq\mssql\hq_zh-cn.mdf rather than schema.mdf or hq.mdf). You do not need to do this for Oracle as this database contains all languages in UTF-8 encoded form.

Enabling Locales

All users can change their Locale from their My Profile form. For instance, they can change from "English (United States)" to "English (United Kingdom)", "French (France)", or "French (Canadian)". Doing so lets the user choose both the language they prefer as well as the other locale conventions, such as the area, date, and default local currency.

To enable a locale, the Archibus Administrator must enable the language corresponding to the locale in web-inf\config\context\compatibility\afm-config.xml. For instance, to enable the "French (France)" [fr_FR] and "French (Canadian)" [fr_CA] locales, the Archibus administrator must set the French (fr) entry in the <languages /> tag to enabled="true".

If you need a locale for a language that you do not have installed, such as "Korean" [ko_KR], you can still enable that language. Any or all missing strings will just default to their English equivalent.

Archibus ties together locale and language information in this way so that the Archibus Administrator can centrally administrate consistent language and locale features for all users. With these features, users can have the language and locale they prefer with one selection; however, all users -- regardless of language, locale, locale date format, local units, etc. -- can enter data that correlates consistently on the central server.

See also: Adding Languages and Locales to the afm-config.xml File

The Locale and Translated Archibus Help

Archibus Help is available in English, French, Spanish, German, and Italian. If you enable these locales and access online help from Web Central or Smart Client, you automatically receive the online help in the language for that locale; the helpExtension section of afm-config.xml is set for the language of the locale. For a language such as Dutch, Archibus does not provide translated help; therefore, it uses helpExtension="".

<language

   isoLanguage="es"

   enabled="auto"

   dbExtension="es"

   helpExtension="es"/>

<language

   isoLanguage="nl"

   enabled="true"

   dbExtension="nl"

   helpExtension=""/>

With helpExtension=””, Web Central looks for the online help in the archibus_help directory, which is English by default.

The default behavior is for Web Central to look for online help at the appropriate URL on archibus.com, such as:

• https://help.archibus.com/user_en/archibus.htm (English)
• https://help.archibus.com/user_de/archibus.htm (German)
• https://help.archibus.com/user_es/archibus.htm (Spanish)
• https://help.archibus.com/user_fr/archibus.htm (French)
• https://help.archibus.com//user_it/archibus.htm (Italian)

If you prefer that Web Central access online help from your network, see:

• Installing Archibus Web Central with Apache Tomcat

Note: Archibus System Management Help is available only in English.