Add a new language

Service Request Catalog is delivered in 8 supported language versions (and a further 8 language versions that are not supported and not updated as of Service Request Catalog 9.51), which can meet most localization requirements. However, if you wish to add additional languages, you can do so on your own by using the following procedure. To do this, you must modify the following two areas:

  • The resource files that are located in the following directory:

    [release war]\resources\client and [release war]\resources\server.

    All resources, messages, and user interface labels are stored in these properties files.

  • Service Manager Server: The resources for configurable items, such as catalog items, user options, and checkout panels are stored here.

Configuration steps

In this example, we convert the current language of Service Request Catalog to Italian.

Add a new language into mlu.properties

  1. Find resource under [release war]\resources\mlu.properties.

  2. Add the language code for key "supportedLanguages":

        supportedLanguages=US,DE,IT,FR,ES,JP,BRAZILIAN,ZH,NL,KO,RU,CS,HU,PL,AR,HE
  3. Add the following lines for the new language:

        IT.languageId=ITALIAN
        IT.localeLanguage=it
        IT.localeCountry=IT
        IT.displayName=Italiano
    
  • If you do not care about using the country code for Italian, just put IT as the language code, and all resource files must be appended as follow: 

    abc it.properties

  • If you do wish to put the country code ( for example Switzerland (CH)) as the localeCountry for this language, then all resource properties files must be appended as follow: 

    abc it_CH.properties

Create a folder for Italian

If you do not care about using the country code for Italian, create a new folder under [release war]\resources\client\ named it as it.

If you do wish to put the country code, as the localeCountry for this language, create a new folder under [release war]\resources\client\ named it as it_CH.

Copy all client resource files

  1. Copy all resource files from the [release war]\resources\client\en folder to the folder that you created in the previous step.
  2. Append “_it” or "_it_CH" to each client resource file, according to your decision in the previous step.

Copy all server resource files

  1. Copy all server resource files from the [release war]\resources\server\en to the folder the you created previously.
  2. Append “_it” or "_it_CH" to each server resource file, according to your decision.

Translate each properties file

  1. Translate the property files by hand.

    Please heed those files that are marked by the “DO NOT TRANSLATE THIS FILE” statement; similarly, there are several lines in the files that are marked “DO NOT TRANSLATE." If you are not sure what lines should be translated or not, you can compare the existing files between a non-English version and the English version.

Localize the resources in Service Manager

Service Manager provides extensive language support. For details on how to localize Service Manager, refer to SM_Open_L10N_UG.pdf.

Restart Tomcat

  1. Restart Tomcat, and then navigate to Service Request Catalog.
  2. Set the Browser Language Preference in Service Request Catalog.