Customizing IAG language support

  • Article

Applies To: Intelligent Application Gateway (IAG)

Whale Communications Intelligent Application Gateway (IAG) 2007 supports multiple languages for text that appears in the windows and messages of IAG pages with which users interact, including logon and logoff pages, default portal home page, certified endpoint enrollment pages, and the file access application. Out-of-the-box support includes English (default), German, French, and Spanish. You can change the default text of the languages that are supported out-of-the-box, or you can add support for additional languages, as required.

This topic describes the following:

  • How to edit text of languages that are supported out-of-the-box

  • How to configure support for additional languages

  • How to enable users to select a language when connecting to IAG

Note the following before configuring default and custom languages:

  • Some of the strings contain variables, defined by %<num> or {<num>}. For example <String id="139">Failed to log on user %1</String>, where %1 is the user name.

  • Use CDATA if your string includes any of the following special characters: < > " ` & . For example:

    <String id="13"><![CDATA[If this prompt appears, <br>click "Yes" to install the components.]]></String>

  • In order to change specific application strings, that is, the application's name, description, and long description, as displayed on the portal homepage, add the following lines for each application you wish to change:

    <String id="Name_ApplicationID">Name</String>

    <String id="ShortDesc_ApplicationID">Description</String>

    <String id="LongDesc_ApplicationID">Long Description</String>

    You can copy the Application ID from the General tab of the Application Properties dialog box.

Editing out-of-the-box languages

This section describes how you can edit the text of the languages that are supported out-of-the-box: English, German, French, and Spanish.

To edit the text of an out-of-the-box language

  1. Copy the relevant file from the relevant Languages folder to the relevant Languages\CustomUpdate folder:

    • English: sample_default.xml

    • German: de.xml

    • French: fr.xml

    • Spanish: es.xml

  2. If you are editing strings in the English language, rename the file default.xml. No rename is required for the other languages.

  3. In the file you copied in step 1, edit the required strings by using a text editor that supports UTF-8, such as Notepad. Note that this file can be partial, including only the strings you wish to edit. Other strings will be taken from the default system pages.

Configuring support for additional languages

This section describes how you can configure support for languages that are not supported out-of-the-box.

To configure a custom language

  1. Copy the file sample_default.xml from the relevant Languages folder to the relevant Languages\CustomUpdate folder.

  2. In the file you copied in step 1, edit the required strings by using a text editor that supports UTF-8, such as Notepad. Note that this file can be partial, including only the strings you wish to edit. Other strings will be taken from the default English pages.

  3. Rename the file <Language_ID>.xml , where Language_ID is defined as follows:

    • If the user selects the language, that is, the Enable Users to Select Language check box is selected in the Authentication tab, <Language_ID> can be any string.

      For example: for Russian, name the file Russian.xml

    • If the language is automatically selected based on the browser definitions, that is, the Enable Users to Select Language check box is cleared in the Authentication tab, Language_ID must use the same language ID used by the browser. To see the browser's definition of languages, in Internet Explorer, on the Tools menu, select Internet Options, and then click Languages.

      For example: for Russian, the file must be named ru.xml   

  4. If required, repeat steps 1 through 3 for each additional language you wish to enable.

  5. Copy the Languages.xml file from the InternalSite\Languages folder to the InternalSite\Languages\CustomUpdate folder.

  6. Edit the file you copied in step 5 to include all the languages you defined in steps 1 through 4, by creating a <Language> tag for each language, using the following convention:

    <Language id=" Language_ID "> Language_Name </Language>

    Where:

    • Language_ID is the same Language_ID you used when naming the file containing the strings, in step 3.

    • Language_Name is the name that will be displayed to users in the Language selection box, in the login page, if the user is prompted to select a language.

    For example: for Russian, add the following line:

    <Language id="ru">Russian</Language>

Enabling users to select a language

To specify that client endpoints can select a language when accessing an IAG site, do the following.

To enable client endpoints to select a language

  1. In the IAG Configuration console, click the trunk for the relevant portal or published Web application.

  2. Next to Advanced Trunk Configuration, click Configure.

  3. On the Authentication tab, select Enable Users to Select Language.