Localization

IFS Web Client supports many supported languages in a single site. If there are more than one active language configured for the site, then a list of all "active" languages will be displayed in the logon page (if available) and in the language selection page.

Read more about the domain Localization.

Contents

Runtime Translations

Java translations are done at runtime. When an user accesses the website for the first time, the runtime translations are read from the database.  The entry "dic_path" in the webclientconfig.xml file points out to a directory (default WEB-INF\translation), it can be used to override the translations read from the database.

Language specific data should be included separately for each language in the <language> section of the webclientconfig.xml file. All languages deployed in the database will be set as "active" in web client by the IFS Installer by default. They can be deactivated (at least one should be active) is desired.

Following shows the section for English(<en>) Language. Data formats (which are in bold) are not included in the configuration file by default. IFS Web Client reads these values from the Locale. But still you can override these values by including them as shown below.

<language>
  <en>
    <description>English</description>
    <deactivate>N</deactivate>
    <decimal_separator>.</decimal_separator>
    <group_separator>,</group_separator>
    <week_start_day>0</week_start_day>
    <integer>
      <mask>###,###,###,###,###</mask>
    </integer>
    <money>
      <mask>###,###,###,##0.00</mask>
    </money>
    <datetime>
      <mask>yyyy-MM-dd HH:mm:ss</mask>
    </datetime>
    <time>
      <mask>HH:mm</mask>
    </time>
    <date>
      <mask>yyyy-MM-dd</mask>
    </date>
    <number>
      <mask>###,###,###,##0.##</mask>
    </number>
    <graph>
      <fonts>
         <default_face>Arial</default_face>
      </fonts>
    </graph>
    <export_navigator_charset>iso-8859-1</export_navigator_charset>
    
    <direction>LTR</direction>
  </en>
</language>
Parameter Name What it does
description Language description shown in the language list.
deactivate (Y/N) Tells whether this language is active or not.
decimal_separator Decimal separator to be used in all number values.
group_separator Group/Thousand separator to be used in all number values.
week_start_day Starting day of week in the Date/Time Picker. 0-6(Sun-Mon).
integer/mask Format mask for all Integer values.
money/mask Format mask for all Money values.
datetime/mask Format mask for all Date-Time values.
time/mask Format mask for all Time only values.
date/mask Format mask for all Date only values.
number/mask Format mask for all Number values.
graph/fonts Font face to be used in graphs.
export_navigator_charset Character set to be used when exporting the Tree Navigator.
direction Direction of the Language (RTL or LTR)

NOTE: If the language description has UTF-8 characters then the file MUST always be saved as UTF-8.

The above parameter values are used by IFS Web Client while displaying data in pages. 

In addition to the format mask you can specify the DECIMAL SEPARATOR and GROUP SEPARATOR (thousands separator). By default the IFS Web Client will apply this feature for all the numeric type fields (Integer, Money, Number).

When you specify the format MASKS you should always use comma (',') for group separator and dot ('.') for decimal separator regardless of what you have set to the DECIMAL SEPARATOR and GROUP SEPARATOR entries in the webclientconfig.xml. when displaying in the field, the correct group and thousand separators given in webclientconfig.xml  will be used .  

If no group separator has been specified in the configuration file then IFS Web Client will read the group separator from the Locale. If you want to enter "space" as the group separator type SPACE. To remove the group separator simply remove the group separator from the format mask (i.e. ######.##).

If the user has set format masks etc for his/her own user profile then these values will have higher priority over the setting given in the configuration file.


 

Adding Right To Left (RTL) Languages

IFS Web Client Framework provides the core functionally required for the usage of Right To Left (RTL) languages. You have to set the <direction> property of the relevant language in the webclientconfig.xml file, as RTL and have to create the relevant stylesheet (CSS) file. Although IFS Web Client Framework currently does not release translations for any RTL language, Farsi language (language code “fa”) is included in the webclientconfig.xml as well as stylesheets (Styles-fa.css) as a reference.

 

Localization to Double Byte Languages

Visit Localization to Double Byte Languages if you are about to localize IFS Web Client to any double byte language such as Japanese.