Customizing the Set of Available Languages 

Use

By default a long list of the most common languages appears for selection when you change the language of a user account in the following applications:

·        Portal personalization: In the portal, when you choose Personalize and then Portal Language, you can change the language in which the portal is displayed for your user account.

·        UME personalization: When you call up the UME administration console, choose UM Home, and then choose Modify, you can change your user profile and can change the language in which applications are displayed for your user account.

·        UME administration console: When you create a user or search for a user, you can choose from a list of languages.

·        Self registration: When users register themselves as new users, they can choose the language of their user account.

As NetWeaver is not available in all languages, you may want to customize the list of languages to display only languages for which a translation is available in your installation.

The following procedure describes how to customize the list of languages displayed for selection. The list of languages to display are defined in language bundles which are shipped in an EAR archive in the User Management Engine. The bundles are called languages_XX.properties, where XX is the language for which the bundle contains the translation.

Each language bundle contains a translation of the list of available languages. The language bundle languages_en.properties contains the English translation of the list of languages, for example:

de=German en=English zh=Chinese

languages_de.properties contains the German translation, for example:

de=Deutsch en=Englisch zh=Chinesisch

In this example, users that are logged on in English or German would be able to choose from the languages German, English, and Chinese when they choose to personalize their user profile.

You can substitute a default bundle with a customized one by:

...

       1.      Retrieving the file containing the existing bundle

       2.      Modifying a copy of the bundle as required

       3.      Uploading the new bundle to the configuration store of J2EE Engine

Modified bundles stored in the configuration store have priority over the texts in the EAR file and will not be overwritten during an upgrade

Procedure

Retrieval

...

       1.      On the file server, navigate to:

<installation-drive>:\usr\sap\<SID>\<Instance_ID>\SDM\root\origin\sap.com\ com.sap.security.core.admin\SAP AG\<version_number>

where <version_number>is the highest version number in the directory.

       2.      From com.sap.security.core.admin.630.ear, extract the file com.sap.security.core.useradmin.war.

       3.      From the extracted com.sap.security.core.useradmin.war file, extract the bundles of the languages you want to make available; for example, if you want German, English, and Chinese to be the only languages provided, extract the bundles languages_de.properties, languages_en.properties, and languages_zh.properties.

       4.      Copy the extracted bundle locally and make all your modifications in this copy.

Modification

       5.      In each of the language bundles you extracted, delete all the languages you do not want to make available.

       6.      Save the modified languages_XX.properties files to any location, and for later reference remember where you stored the file.

       7.      Delete from com.sap.security.core.useradmin.war all languages_XX.properties files for languages that will not be used.

In this example, you would delete all of the languages_XX.properties files except for languages_de.properties, languages_en.properties, and languages_zh.properties.

Uploading

Upload the language bundles into the configuration store of J2EE Engine as follows:

       8.      Shut down all cluster elements.

       9.      Start the Config Tool by executing <SAPJ2EEEngine_installation>\j2ee\configtool\configtool.bat.

   10.      Choose the symbol for Switch to configuration editor mode.

   11.      In the tree, navigate to cluster_data ® server ® persistent ®com.sap.security.core.ume.service.

   12.      In the Display configuration tab, choose  (Switch between view and edit mode).

   13.      Click on com.sap.security.core.ume.service with the alternate mouse button and choose Create sub-node.

   14.      In the displayed Create dialog box:

                            a.      Choose File-entry as the type of entry.

                            b.      Choose Upload, browse to the file you created, and choose Open.

The text of your file is displayed in the Text field.

                            c.      Choose Create.

A new entry, languages_XX.properties, appears under the node com.sap.security.core.ume.service in the Config Tool.

   15.      Repeat the above steps for bundles in all languages.

   16.      In the Create dialog box, choose Close window.

   17.      Restart all cluster elements.

Result

When users choose to change their user language in the personalization functions, or when administrators create new users, the modified list of languages is available for selection.