Preparing a Localization Dictionary

To prepare a localization dictionary for another language, use one of existing Self Service Portal localization dictionaries as a template. Localization dictionaries are stored in the Alloy Navigator Express installation folder, typically at the following path:

C:\Program Files\Alloy Software\Alloy Navigator Express 8\
System\WebAppsTemplates\SSP\localization

If you have an existing Self Service Portal instance, you can also find localization dictionaries in the localization folder under the folder where your SSP files are stored:

[PhysicalPathToSSP]\localization

NOTE: For instruction on viewing the physical path of Self Service Portal installation folder, see Physical Path to Self Service Portal Files.

The localization dictionary is a JSON file which include local attributes and localization dictionary entries.

Formats

Local attributes are the values of the Formats key which is structured as follows:


{

  "Formats": {

    "Id": "es-ES",

    "Description": "Spanish - Spain, International Sort",

    "NumberGroupSeparator": ".",

    "NumberDecimalSeparator": ",",

    "NumberGroupSeparatorDisplay": ".",

    "NumberDecimalSeparatorDisplay": ",",

    "ShortDatePattern": "d/m/Y",

    "ShortDatePatternDisplay": "dd/MM/yyyy",

    "ShortTimePattern": "G:i:s",

    "ShortTimePatternDisplay": "H:mm:ss",

    "DurationFormat": "%HH% h %NN% min",

    "DurationFormatLessHour": "%N% min"

  },

The Formats key takes its values from the nested object consisting of key-vlaue pairs defining local attributes.

NOTE:The language-region pair code in the id key must be a valid Windows Language Code Identifier (LCID). You can find the list of available language codes at https://msdn.microsoft.com/en-us/library/cc233965.aspx.

Terms

Localization dictionary entries are the values of the Terms key which is structured as follows:


  "Terms": [

    {

    "key": "ERROR.MSG_PASSWORD_VALIDATION_FAILED_1",

    "text": ""

    },

    //...

    {

    "key": "TICKETS.FORMS.CUSTOM_798.FORM.CAPTION",

    "text": "Agregar una nota"

    },

    //...

    {

    "key": "ACCOUNT.MSG_LOGIN_EXISTS",

    "text": "Ya existe un usuario con este nombre."

    }

  ]

}

The Terms key takes its values from the nested array consisting of a number of objects. Each object defines a localization dictionary entry and structured as follows:


    {

    "key": "INTERFACE_ELEMENT",

    "text": "LOCALIZED_INTERFACE_ELEMENT"

    },

Where

  • key value defines a interface element (field, message, caption, text, etc.) that you want to localize.
  • text value defines a localized version for the interface element.

For example, the object below defines the localized title of the Announcements page in the SSP:


    {

    "key": "ANNOUNCEMENTS.PAGE_TITLE",

    "text": "Anuncios"

    },

NOTE: The keys for the fields that have the same localized version for all forms begin with "FIELDS.COMMON">.

The name of the localization dictionary file for the new language must be in the following format:

<LCID>.json

Example: tr-TR.json