Customizing the Set of Available
Languages 
Use
Each user can have a default language assigned either by the user administrator or by the users themselves. When that user logs in, the system displays the content and user interface strings in that language, so far as it is available. If the selected language is not available, the system shows the default language. If no language is defined, the system uses the browser default language, so far as it is available. You change the language of a user account in the following applications:
● Portal personalization: In the portal, choose Personalize ® User Profile. You can change the language in which the portal is displayed for the your account on the General Information tab.
● Identity Management: On the General Information tab of a user profile, you can choose the language of the user account.
● Self registration: When new users register themselves, they can choose the language of their user account.
You may not use all the languages available in the NetWeaver application server for Java. For that reason, you can limit which languages are available to select.
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.
Procedure
You can substitute a default language bundle with a customized language bundle. This procedure includes the following sub tasks:
...
1. Retrieve the file containing the existing bundle.
2. Modify a copy of the bundle.
3. Upload the new bundle to the configuration store of the J2EE Engine.
Modified bundles stored in the configuration store take priority over the settings in the EAR archive. The modified bundles are not overwritten during an upgrade.
Retrieving the Language Bundles
...
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.
Modifying the Language Bundles
...
1. In each of the language bundles you extracted, delete all the languages you do not want to make available.
2. Save the modified languages_XX.properties files to any location, and for later reference remember where you stored the file.
3. 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 the Modified Language Bundles
Upload the language bundles into the configuration store of J2EE Engine as follows:
...
1. Shut down all cluster elements.
2. Start the Config Tool by executing <SAPJ2EEEngine_installation>\j2ee\configtool\configtool.bat.
3. Choose the symbol for Switch to configuration editor mode.
4. In the tree, navigate to cluster_data ® server ® persistent ®com.sap.security.core.ume.service.
5.
In the Display configuration tab, choose 
(Switch
between view and edit mode).
6. Click on com.sap.security.core.ume.service with the alternate mouse button and choose Create sub-node.
7. 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.
8. Repeat the above steps for bundles in all languages.
9. In the Create dialog box, choose Close window.
10. Restart all cluster elements.
Result
When users choose to change their user language (if self management or self registration is enabled), or when administrators edit a user profile, the modified list of languages is available for selection.
See also: