Localizing the console

You can localize the following elements of the console :

• Elements of the GUI like the names of buttons, nodes, tabs, and so on.
• Balloon tips
• Instant Expert

The translations for these elements are saved in different files.

Localizing console includes:

Adding languages to the database

All available languages for localization are in a specific database table called Enumeration. When you want to add a new language to the console, you must add a new entry to the table.

1. Copy the following command and replace the four sample values in the second line with your information:

   INSERT    INTO Enumerations (EnumID, EnumGroup, EnumName, EnumValue)
           VALUES (<userinput>11905, 'AvailableLanguages', '_DB_LANGUAGE_NEWLANGUAGE_',   'NewLanguage'</userinput>);                       

   The four expressions represent:

   Expression	Value	Information
   EnumID	11905	Unique identifier for any option in the database. You can use any value between 11950 to 11999. If you add more than one language option make sure to use different EnumIDs.
   EnumGroup	AvailableLanguages	Type of the enumeration. In this case the value must always be AvailableLanguages.
   EnumName	_DB_LANGUAGE_NEWLANGUAGE	Keyword for the new language, for example, _DB_LANGUAGE_CHINESE.
   EnumValue	NewLanguage	Name of the language ( for example, Chinese). Do not use special characters such as ç orñ.

2. In the Enumeration table of your database, execute the modified command.
   The new language is added to your database. In the next step, you add a .locale files for your new language which contain the translations.

Creating localization files

Localization files are text files with the extension .locale . To add a new language you need to create three new .locale files.

1. On the device on which the Console is installed go to <BMC Installation Directory>/ui/console/jws.
2. Open the NumaraFootprintsAssetCore.jar file with a file archiver such as WinZip or WinRAR.
3. Extract its locales folder to the jws folder.
4. In the NumaraFootprintsAssetCore.jar file delete the locales folder and close it.

5. Open the locales folder and add the following line to each <Language> .locale file:
   _DB_LANGUAGE_NEWLANGUAGE_=LanguageValue
   To add Chinese as a new language, add:_DB_LANGUAGE_CHINESE_=Chinese to English.locale or _DB_LANGUAGE_CHINESE_=Chinois to Francais.locale.
    

   Language Valueis the value that will be displayed among the language options in the Preferences dialog, from which you select the language of the Console .

6. Duplicate a <Language>.locale file and rename it so that it matches EnumValue of your new language that you added to the database.
   To create a Chinese .locale file rename it to Chinese.locale.

7. Repeat the last step for <Language>Params.locale and <Language>_GuidedHelp.locale.

   If you don't create three new .locale files, the english .locale file will be used in place of the missing file.

8. Translate all translation values in the files (the expression to the right of the equal sign (=).
9. To verify your translations, launch a Console and select your newly added language from the Language drop-down list in the Preferences dialog.
   The Console displays in your new language.

You created the three required .locale files and localized the Console to a new language.