Configuration Adjustments

Set the Default Database Language

If you have set up Metadata Server to provide multilingual databases to your users, you may wish to set the default database language. This is the language that will be used automatically if the user does not choose a language.

This step is only required for SuperCROSS. SuperWEB2 automatically selects an appropriate default language based on the list of accepted languages sent by the user's browser. See Multilingual and Localisation Support for more details.

The default language is controlled by a setting in the metadata.config.xml configuration file, located in the SuperCROSS program data directory (by default C:\ProgramData\STR\SuperCROSS).

To change the setting:

1. Open metadata.config.xml in a text editor.

2. Locate the following section:

   XML

           <KEY name="Default">
               <STRING name="Desc">desc</STRING>
               <STRING name="Language">en</STRING>
               <STRING name="Link">link</STRING>
               <STRING name="Name">name</STRING>
           </KEY>

3. Change the Language setting to the code for your preferred default language. For example:

   XML

           <KEY name="Default">
               <STRING name="Desc">desc</STRING>
               <STRING name="Language">de</STRING>
               <STRING name="Link">link</STRING>
               <STRING name="Name">name</STRING>
           </KEY> 

4. Save your changes.
5. Restart Metadata Server, the SuperWEB2 service and SuperCROSS (as applicable) to apply the change.

Set the Language Display Names

When Metadata Server is set up, SuperCROSS allows users to change the table language by selecting from the File > Table Language menu. The names of the table languages displayed in SuperCROSS are defined in the SuperCROSS metadata.config.xml file, located in C:\ProgramData\STR\SuperCROSS by default.

Make sure SuperCROSS is not running. Every time you close SuperCROSS it writes out its current metadata configuration to metadata.config.xml. If you edit the file while SuperCROSS is running, the changes will not be picked up by the client and when you subsequently close SuperCROSS your changes will be overwritten by the old settings from the client.

Make a backup copy of this file before making any changes.

Open the SuperCROSS metadata.config.xml file in a text editor, and locate the language map section, which will be similar to the following:

<KEY name="Lang-Map">
    <STRING name="ar">Arabic</STRING>
    <STRING name="cy">Welsh</STRING>
    <STRING name="de">German</STRING>
    <STRING name="en">English</STRING>
    <STRING name="fr">French</STRING>
    <STRING name="it">Italian</STRING>
</KEY>

This section lists all the available languages that can appear in the File > Table Language menu in SuperCROSS.

A language will appear in that menu and be available for the user to select if both of the following are true:

• The language is listed in the language map section of the SuperCROSS metadata configuration file.
• Columns for the language exist in the metadata database.

Update this section so that it includes a <STRING> element for each language that you have set up in your metadata database.

• Use the name parameter to specify the language code that you used in metacolumns.txt when you set up your metadata database.
• Use the text within the <STRING> element to control the text that will be displayed on the menu in SuperCROSS.

The supplied version of metadata.config.xml has all the language names in English. You may wish to change these so that the language names are in the individual languages, and show the English language name in brackets. For example:

<KEY name="Lang-Map">
    <STRING name="ar">العربية (Arabic)</STRING>
    <STRING name="cy">Cymraeg (Welsh)</STRING>
    <STRING name="de">Deutsch (German)</STRING>
    <STRING name="en">English (English)</STRING>
    <STRING name="fr">Français (French)</STRING>
    <STRING name="it">Italiano (Italian)</STRING>
</KEY>

When you have finished making changes, save and close metadata.config.xml.

It is not necessary to configure the language display names for the drop-down list in SuperWEB2. SuperWEB2 automatically sets the language names based on the language code. For this reason, if you are using SuperWEB2 you must use the correct two character ISO 639-1 language codes when setting up your metadata database.