Oracle® Identity Manager Globalization Guide Release 9.0 Part Number B32149-01 |
|
|
View PDF |
System-defined components in Oracle Identity Manager have been globalized and translations for these items are provided with the release. User-defined extensions to fields, forms, and other elements in Oracle Identity Manager user interface require manual configuration to support globalization. You can optionally customize style sheets for the administration console.
This chapter discusses the following topics:
Oracle Identity Manager consists of the following components:
The Oracle Identity Manager installer.
Oracle Identity Manager Administrative and User Console: This is the main application used by administrators and users.
Oracle Identity Manager Design Console: System administrators use the Design Console to create metadata extensions.
Diagnostic Dashboard: System administrators use the dashboard to find and troubleshoot issues with an Oracle Identity Manager installation.
Remote Manager. A lightweight network server that enables you to integrate with target systems whose APIs do not have the ability to communicate over a network, or that have network awareness but are not secure.
Connectors. Used to integrate Oracle Identity Manager with specific third-party applications, such as Microsoft Exchange or Novell eDirectory.
The following system properties support globalization for a single language in the current release and will support multilingual globalization in future:
user.language: Oracle Identity Manager uses this property for back-end activities, for example, for automatic e-mail generation when sending email to users. You set this property during installation, when you select a language. In future releases, this setting will be in user preferences, and there will be no system-wide language setting.
For displaying data in a browser, Oracle Identity Manager localizes the data based on the value of the accept-language
parameter in the HTTP header sent by the browser. The Oracle Identity Manager application localizes all responses into this language.
user.region: As with user.language
, Oracle Identity Manager uses this setting for back-end processes, for example, sending email to users.
See Also: Oracle Identity Manager Design Console Guide for information on how to set theuser.language and user.region system properties |
Formatting of dates, times, and so on, that Oracle Identity Manager displays in the Web browser is based on the locale setting of the Web browser. This setting affects the following:
Date and time formats for input and output
Numeric formats for input and output
Sorting of text strings according to region or country requirements
Order of name components (first name and last name)
When you run the Oracle Identity Manager installation program, you are first prompted to select a language. All screens and messages in the installer are then localized based on the selected language.
See also: Appendix A, "Oracle Identity Manager Installation Language Support and Restrictions" for restrictions on the inputs that you provide during installation |
Oracle Identity Manager Administrative and User Console has been globalized and translated into the supported languages for the release. You can configure additional translated strings for user-defined data, you can clear the cache when you add user-defined data, and you can customize locale-specific style sheets.
The rest of this section discusses the following topics:
Oracle Identity Manager stores localized versions of text strings that appear in the user interface in resource bundles.
All messages that appear in the Administrative and User Console are localized in property files. The following files are the basis for translation into the supported languages:
WEB-INF\classes\xlWebAdmin.properties
WEB-INF\classes\xlRichClient.properties
These files contain basic user interface text that is not configurable by the user or administrator.
In this release, the elements in these properties files have been translated into French and Japanese. When sending information to the browser, Oracle Identity Manager depends on the browser's language setting. For example, if the browser language setting is French, Oracle Identity Manager uses the French language property files xlWebAdmin_fr.properties
and xlRichClient_fr.properties
to localize the content.
The file WEB-INF\classes\xlDefaultAdmin.properties
contains properties that do not need translation, including the following:
Menu link actions
Image paths
Delimiters and separators
Other special characters and numbers
Web layer configuration properties
Oracle Identity Manager metadata is populated in the database during installation. For example, there are system-created users, organizations, processes, resources, and so on. The following applies to metadata and metadata extensions that you configure after installation:
Most system metadata is configured and stored in English in the database.
After Oracle Identity Manager fetches data from the database and the data reaches the Web tier, Oracle Identity Manager locates resource bundles that contain the localized strings for the data.
Note: You cannot modify system metadata. However, you can create resource bundles for metadata extensions that you configure in the Design Console. The syntax for specifying the resources and properties in the resource bundle property file is similar to that for the default bundles. The following sections provide details on this topic. |
You can configure locale-specific text strings in resource bundles for user-defined data. As described in the Oracle Identity Manager Design Console Guide, you usually create user-defined lookups, fields, forms, and so on in the Design Console. In this release, you can also configure localized versions of user-defined fields for display in the Administrative and User Console. This section describes how to localize user-defined data using custom resource bundles in the following topics:
How Does Oracle Identity Manager Determine Which Lookup Fields to Localize?
Clearing the Cache for Custom and Connector Resource Bundles
You configure resource bundles for localized user-defined data in a folder named customResources
in the Oracle Identity Manager home directory, as follows:
<OIM_HOME>\xellerate\customResources
This folder contains the following files:
customDefaultResources.properties—Defines all custom properties that do not require translation
customResources.properties—Contains English language property translations
customResources_ja.properties—Contains Japanese language property translations
customResources_fr.properties—Contains French language property translations
The following procedures describe how to localize user-defined items that are used by the Administrative and User Console interface.
To add user-defined field labels and form field labels:
Construct the resource string for the label, using the following syntax:
global.udf.<udf_column_name>=<Text to display in the user interface>
For example, you could define the following key for a column named UD_USER_USERNAME
:
global.udf.UD_USER_USERNAME = First Name
Replace white space in any value in the resource bundle key with a hyphen (-).
To add a user-defined Lookup field:
Construct the resource string for the Lookup field, using the following format to define the key:
global.<lookup_code>.<encode_data>=<Value to appear in the user interface>
For example, you would create the following keys for a lookup code of myuser.status
for a lookup column named UD_USER_STATUS
with lookup-encoded values of Active
, Disabled
and Deleted
:
global.myuser.status.Active=Active global.myuser.status.Disabled=Disabled global.myuser.status.Deleted=Deleted
Replace white space in any value in the resource bundle key with a hyphen (-).
To add columns to a form using FormMetaData.xml
, construct the column, using the following syntax:
global.<lookup_code>.<encode_data>=<column to appear in the user interface>
The following default challenge questions are localized automatically in Oracle Identity Manager:
What is the name of your pet?
What is the city of your birth?
What is your favorite color?
What is your mother's maiden name?
If you add custom challenge questions to the Oracle Identity Manager Design Console, then you must add corresponding properties to the custom resource bundles to localize the question text in the supported languages.
For example, you may add the following new challenge question: What is your favorite sport?. To localize this text, you must add properties to the customResources.properties, customResources_fr.properties, and customResources_ja.properties files file in the following format:
global.Lookup.WebClient.Questions.question-text=value
You must replace any white spaces in the question text with a hyphen (-). For example, to localize the What is your favorite sport? challenge question in French, you add the following property to the customResources_fr.properties file:
global.Lookup.WebClient.Questions.Which-is-your-favorite-sport? = Quel est votre sport favori?
To modify the text of the default challenge questions, you must also add corresponding properties to the custom resource bundles. For example, to modify the text of the What is your favorite color? question from American to British spelling, you must add the following new property in the customResources.properties file:
global.Lookup.WebClient.Questions.What-is-your-favorite-color?=What is your favourite colour?
To modify the the text of the default challenge questions for English, French, and Japanese locals, you must add properties for the modified questions to the customResources.properties, customResources_fr.properties, and customResources_ja.properties files file.
When a user clicks a lookup field in Oracle Identity Manager Administrative and User Console, Oracle Identity Manager first examines the locale-specific resource bundle for translated values. If the resource bundle does not contain any translated values for the lookup field, then the default values in the Oracle Identity Manager database are used. For example, if a locale-specific resource bundle does not contain the following keys for a lookup code of myuser.status
for a lookup column named UD_USER_STATUS
, then the default values of Active, Disabled, and Deleted in the Oracle Identity Manager database are used:
global.myuser.status.Active=Active User global.myuser.status.Disabled=Disabled User global.myuser.status.Deleted=Deleted User
If a resource bundle does not contain translated values for all of the keys in a lookup code, the missing keys will be skipped. For example, if a locale-specific resource bundle contains the following keys for a lookup code of myuser.status
for a lookup column named UD_USER_STATUS
, then the Disabled status will not display:
global.myuser.status.Active=Active User global.myuser.status.Deleted=Deleted User
If a resource bundle contains any translated values for a lookup key, Oracle Identity Manager only searchs the resource bundle for additional translated values. The default values in the Oracle Identity Manager database are used only if a resource bundle does not contain any translated values for a lookup key.
A connector is a combination of Oracle Identity Manager resource objects, process definitions, adapters, forms, and executable code that can be used for provisioning and reconciliation with a target application. You configure resource bundles for localized user-defined connector data in a folder named connectorResources
in the Oracle Identity Manager home directory, as follows:
<OIM_HOME>\xellerate\connectorResources
You can configure and localize the following for a connector:
The response code description
The process task response codes
Attribute names in the target system, if they are used as input for operations that are coded for the connector
Field labels on forms
Response strings for provisioning operations in the target system that are used by the business logic of the connector
When you configure a new response code, response code description, lookup, form field, or user defined field for a connector, you create a corresponding resource bundle in the following folder:
<OIM_HOME>/xellerate/connectorResources
Note: In a clustered deployment, you must make the same changes in all nodes in the cluster. |
To add localized text for response codes and response code descriptions:
Format the keys using the following syntax:
<process name>.<task name>.<response code>=<Response code value to appear in the administrative user interface>
Create two keys for each response code: one for the localized response code, and one for the localized response code description.
For example, you can create keys similar to the following:
MyApplication.Create-User.CONNECTION_ERROR=Connection Error MyApplication.Create-User.CONNECTION_ERROR.description=Error connecting to MyApplication Server MyApplication.Create-User.PASSWORD_MISMATCH=Password Mismatch MyApplication.Create-User.PASSWORD_MISMATCH.description=Password and Confirm Password fields do not match MyApplication.Create-User.PASSWORD_INSUFFICIENT=Password Is Insufficient MyApplication.Create-User.PASSWORD_INSUFFICIENT.description=Password must be at least 5 characters
Where the process name is MyApplication
, the task name is Create-User
, and the response codes are CONNECTION_ERROR
, PASSWORD_MISMATCH
, and PASSWORD_INSUFFICIENT
.
Replace all white spaces in a process name, task name, or response code with a hyphen (-).
To localize user-defined field labels and form field labels:
Format the keys using the following syntax:
global.udf.<udf_column_name>=<Field label value to be displayed on the administrative console user interface>
For example, you can create keys similar to the following for columns named USR_UDF_LANGUAGE
and USR_UDF_COUNTRY
:
global.udf.USR_UDF_LANGUAGE = User's Language global.udf.USR_UDF_COUNTRY = User's Country
Replace white spaces in any of the values in the resource bundle key with a hyphen (-)
To add a user-defined Lookup field to search by column and code:
Construct the resource string for the Lookup field, using the following format to define the key:
global.<lookup_code>.<encode_data>=<Value to be displayed in the user interface>
For example, you would create the following keys for a lookup code of myuser.status
for a lookup column named UD_USER_STATUS
with lookup-encoded values of Active
, Disabled
and Deleted
:
global.myuser.status.Active=Active global.myuser.status.Disabled=Disabled global.myuser.status.Deleted=Deleted
Replace white spaces in any of the values in the resource bundle key with a hyphen (-).
By default, property files do not support multibyte characters. To use multibyte characters in a property file, you must encode the property file with Sun Microsystem's native2ascii
internationalization tool. For more information on the native2ascii
internationalization tool, visit the Sun Developer Network at
Oracle Identity Manager caches resource bundles that are located in the following directories:
<OIM_HOME>\xellerate\customResources <OIM_HOME>\xellerate\connectorResources
You should clear the cache when adding a new resource bundle file to the connectorResources
directory or changing an existing resource bundle file in connectorResources
or customResources
. In a clustered deployment you should clear the cache on all the nodes of cluster if they are not on the same subnet.
Note: The following procedure refers to the cache categoriesCustomResourceBundle and ConnectorResourceBundle . See the following file for information about the other content categories:
<OIM_home>/xellerate/config/xlConfig.xml
|
To clear the server cache, run one of the following utilities, depending on your operating system:
OIM_HOME\xellerate\bin\PurgeCache.bat OIM_HOME/xellerate/bin/PurgeCache.sh
By default, the PurgeCache utility removes the content for all categories from the server cache. Perform the following steps to modify the PurgeCache utility to purge specific connector or custom resource bundles:
Change to the Oracle Identity Manager bin directory by running one of the following commands, depending on your operating system:
cd \OIM_HOME\xellerate\bin cd /OIM_HOME/xellerate/bin
Run one of the following commands to copy the PurgeCache utility, depending on your operating system:
copy PurgeCache.bat PurgeCache2.bat cp PurgeCache.sh PurgeCache2.sh
Open the PurgeCache2.bat or PurgeCache2.sh file in a text editor, depending on your operating system
Locate the following line:
com.thortech.xl.cache.PurgeCache All
Change the preceding line to one of the following:
com.thortech.xl.cache.PurgeCache ConnectorResourceBundle com.thortech.xl.cache.PurgeCache CustomResourceBundle
Use All
to remove content in all the categories from server cache.
Save and close the file.
Run one of the following utilities, depending on your operating system:
PurgeCache2.bat PurgeCache2.sh
Oracle Identity Manager encodes all user input in the Web client as UTF-8.
The Design Console sends Unicode data to the Oracle Identity Manager Server using the UCS-2 encoding supported by JAVA.
Oracle Identity Manager encodes HTML pages according to the character set used by the locale. When displaying Web pages, browsers require the page encoding to use specific fonts and character set mapping tables. Applications require the page encoding to process input data from HTML forms.
To specify the page encoding for HTML pages, Oracle Identity Manager does the following:
Chooses a page encoding
Encodes the HTML content
Specifies the HTML pages using the encoding name
The rest of this section discusses the following topics:
For single-language and multi-language applications, Oracle Identity Manager specifies the encoding for HTML pages in the Content-Type
HTTP header in a Java Server Page (JSP). Oracle Identity Manager uses the contentType
page directive with a charset
value of utf-8
, as in the following example:
<%@ page contentType="text/html; charset=utf-8" %> This will be used in the common files web\layouts\tjspClassicLayout.jsp, web\pages\FilterErrorPage.jsp web\layouts\tjspPopUpLayout.jsp
In the preceding example, the ContentType
HTTP header ensures that all communication between a Web client and server uses UTF-8 encoding.
Note: UTF-8 supports all languages. |
Oracle Identity Manager specifies character encoding in HTML page headers as follows:
<meta http-equiv="Content-Type" content="text/html;charset=utf-8">
Oracle Identity Manager generates HTML forms that enable users to provide input. For both POST and GET requests on Microsoft Internet Explorer browsers, Oracle Identity Manager encodes user input based on the encoding of the form, for example, if a form uses UTF-8 encoding, the browser returns UTF-8-encoded user input.
The browser uses different methods for passing input in a POST request and passing input in a GET request:
For POST requests, the browser passes input as part of the request body.
8-bit data is allowed.
For GET requests, the browser passes input as part of a URL.
The input is an embedded query string where every non-ASCII byte is encoded as %
XX
, where XX
is the hexadecimal representation for the binary value of the byte.
This is called URL Encoding.
Text strings often expand when they are translated from English to most European languages. A translated English sentence is an average of 30-40% longer in a European language, and a particular work can be as much as 200% longer. For Asian languages, text may shrink 30-50%.
When you configure and localize user-defined elements in the user interface, be sure that menu items, icon names, and so on, do not adversely affect the display of the Web-based administrative console after translation.
Note: You localize user-defined elements in resource bundles. See "Localizing User-Defined Data Using Custom Resource Bundles" and "Localizing a Connector Using Resource Bundles" for details. |
Font size, family, face, and formatting in bold, italic, oblique, and so on, are locale-sensitive. For example, smaller font sizes can be hard to read in Asian languages, and some Asian languages use formatting such as bold and italic sparingly or not at all. It is a best practice to define styles on a per-locale basis. Locale-specific style sheets enable you to provide different font sizes, turn bold or italic on or off, and so on, depending on the locale. The style sheet selection mechanism can also fall back to a default style sheet if there is no style sheet for a specific locale.
Oracle Identity Manager uses language-specific style sheets. Locale-specific information in a CSS file includes classes that must be modified for each language in the language-specific style sheets. The CSS files are loaded dynamically based on the client browser language settings.
The JSPs inherit the following language-specific properties from the language-specific style sheet:
Font names, font size in terms of width, height in pixels, and so on.
Alignments for languages that read right-to-left as well as languages that read left-to-right.
This is known as bidirectional language support. Note that this release only supports Japanese and French. Bidirectional support is not currently implemented.
Direction of text for bidirectional language support.
Note that this release only supports Japanese and French. Bidirectional support is not currently implemented.
Oracle Identity Manager uses the following JSP files:
tjspClassicLayout.jsp
tjspPopupLayout.jsp
The following code in the jsp pages controls the locale:
<% java.util.Locale locale = (java.util.Locale)session.getAttribute(org.apache.struts.Globals.LOCALE_KEY); String languageFile = application.getRealPath("/css/Xellerate_" + locale.getLanguage() + ".css"); String css_file = "css/Xellerate_" + locale.getLanguage() + ".css"; if(locale.getCountry() != null && locale.getCountry().equals("")==false){ languageFile = application.getRealPath("/css/Xellerate_" + locale.getLanguage() + "_" + locale.getCountry() + ".css"); css_file = "css/Xellerate_" + locale.getLanguage() + "_" + locale.getCountry() + ".css"; } try{ File f = new File(languageFile); if(!f.exists() || !f.isFile() || !f.canRead()){ css_file = "css/Xellerate.css"; } }catch(Exception e){ css_file = "css/Xellerate.css"; } %> <link rel="stylesheet" href="<%=css_file%>" type="text/css" />
The style classes Outlines
and popupOutline
control horizontal text expansion. These elements have default values in the style sheet. In the following, the width
value can be modified to other %
values to expand or shrink the overall width.
.Outlines { BORDER-BOTTOM: #666666 1px solid; BORDER-LEFT: #666666 1px solid; BORDER-RIGHT: #666666 1px solid; BORDER-TOP: #666666 1px solid; WIDTH: 130%; } .popupOutline{ WIDTH: 100%; }
For generic vertical expansion, the corresponding style sheet file modifies the value for PADDING-BOTTOM
in the TD
class located near the top of the file, as follows:
td{ PADDING-BOTTOM:2px !important; }
The default values in the style sheet is adequate for most situations, but you can modify the 2px
value.
To override the behavior from the first addition and use no padding, you can add the following to the end of the xellerate.css file:
.noBottomPadding { PADDING-BOTTOM:0px !important; }
In addition to the general control of vertical spacing in the preceding example, you can control vertical expansion of tables that are created by the Table Generator by modifying table cell height, as follows:
.object_list_table TD { HEIGHT: 28px; }
You can also control the height of lookup windows, as follows:
.popupOutline TD{ HEIGHT: 28px; }
The Table Generator code automatically truncates field values if they exceed the length specified in the property global.property.tableColumnSize
in the property file xlDefaultAdmin.properties
.
The global.property.tableColumnSize
property is set to –1 by default to prevent truncation. In general, text should not be truncated, but you can change the value of this property. If you update xlDefaultAdmin.properties
, you must redeploy the application running the patch_appserver script from the <XL_HOME>/xellerate/setup directory, where appserver is the name of your application server. For example, if you are using WebLogic, this file is called patch_weblogic.
Date and time formats are locale-sensitive, based on the locale set in the browser. Users can input dates using a calendar control that displays localized dates. For example, for United States English the user can enter June 15, 2006 and for French the user can enter 15 juin 2006. Date and time values are stored in the back-end repository in the same way for all locales.
The only exception are searches based on Date type fields. Users must always enter the date in the format MM-DD-YYYY in these fields.
Oracle Identity Manager displays numeric strings using the regional settings of the browser. For example, the number 547567567 appears as 547,567,567 for the en_US locale.
Oracle Identity Manager formats the number only at the time of displaying the data. Users must enter data in numeric fields in a standard format.
In many languages, such as U.S. English, the first name is displayed before the last name. However, in some locales such as Japan, the last name is usually displayed before the first name. This section describes how Oracle Identity Manager displays names according to locale. It contains these topics:
Many tables in the Web application display First Name and Last Name columns. For example, the Manage Users page contains tables of this type. The user locale determines the ordering of these columns, for example, displaying the first name column before the last name column.
The first name and last name, and possibly the middle name, can be displayed together as a full name. For example, string Welcome System Administrator can appear in a page header.
The first name, middle name, last name can be displayed as separate form fields and text strings on a page. For example, the Create User page contains form fields and the User Detail page contains text. However, Oracle Identity Manager does not automatically reorder name fields on forms according to locale. Instead, you must manually configure the order of name fields on each form by modifying the FormMetaData.xml file. See Oracle Identity Manager Administrative and User Console Customization Guide for information on how to modify the FormMetaData.xml file.
Oracle Identity Manager does not automatically reorder name fields according to locale for either Report Input pages or Report Display pages. However, you can manually configure the order of name fields for each type of page. To manually configure the order of name fields on Report Input pages, you must reorder the <InputParameter>
tags in the report XML data. To manually configure the order of name fields on Report Display pages, you must reorder the <ReturnColumn>
tags in the report XML data. See Oracle Identity Manager Audit Report Developer's Guide for information on how to modify report XML data.
The local-part and domain name portions of an e-mail address are restricted to ASCII letters, numbers, underscores, hyphens, and periods. The domain identifier portion of an e-mail address is restricted to ASCII letters and numbers.
Although Oracle Identity Manager supports non-ASCII passwords, for security reasons some input method editors cannot be used to enter passwords in Internet Explorer. An input method editor (IME) is a program that is used for entering characters that are not available on a computer's keyboard. For example, on a computer with a standard Western keyboard, you would use an IME to enter characters from a language such as Japanese. Similarly, on a computer with a Japanese keyboard, you would use an IME to enter characters from English or another Western language. Other browsers such as Firefox do not restrict the entering of passwords with an IME. If the IME you are using prevents you from entering passwords in a browser, you can always cut and paste a password into a password field or use a localized keyboard to enter password characters.
When using a Japanese keyboard, you cannot use kanji characters in a password. Instead, passwords must be composed of hiragana or katakana characters that are available on the keyboard.
Data sorting for most Web pages in the Oracle Identity Manager Administrative and User Console is handled by the Web tier, according to the Web browser's locale settings. However, the sort order for the following Administrative and User Console pages is determined by the Oracle database server:
The Manage User page
The Track Request page
The My Requests page when the Raised by Me option is selected
The Oracle database server uses the NLS_SORT
and NLS_COMP
parameter values to determine sorting and comparison methods. Refer to Oracle Database Globalization Support Guide in the Oracle Database documentation set to determine the default values for the NLS_SORT
and NLS_COMP
parameters for your installation, and to determine the appropropriate values for these parameters based on your linguistic requirements. Setting these parameters to values other than BINARY
will have performance implications because BINARY
sorts and comparisons are the fastest. Oracle recommends starting initially with the default values (as listed in the Oracle Database Globalization Support Guide) and then adjusting the values according to your needs.
Oracle Identity Manager includes a create_logon_trigger.sql script that you can use to change the values assigned to the NLS_SORT
and NLS_COMP
parameters. This script is located in the \installServer\Xellerate\db\oracle directory on the installation CD-ROM.
Perform the following steps to change NLS_SORT
and NLS_COMP
parameters to nondefault values for your Oracle Identity Manager database:
Type the following command at a command prompt to start Oracle SQL*Plus:
sqlplus /nolog
Use the following syntax to connect to the target Oracle instance as SYS
user with SYSDBA
role.
CONNECT SYS/sys_password@db_instance AS SYSDBA
For example, the following statement connects with a system account of SYS
with a password of mypassword
to a database named oimdb
:
CONNECT SYS/mypassword@oimdb AS SYSDBA
Open the create_logon_trigger.sql script in a text editor, and specify the desired values for the NLS_SORT
and NLS_COMP
parameters. Be sure to refer to Oracle Database Globalization Support Guide in the Oracle Database documentation set to determine the appropriate values for your environment. By default, the create_logon_trigger.sql script assigns a value of BINARY
to both parameters.
Run the create_logon_trigger.sql script. This script creates a database trigger that is fired each time a connection is established with the database.
Stop the Oracle Identity Manager server.
Restart the database instance.
Restart Oracle Identity Manager.
For any column of data that you can sort, Oracle Identity Manager determines the locale of the user and bases the sorting method on the locale. By default, all columns in the Oracle Identity Manager Administrative and User Console are translated. The xlDefaultAdmin.properties file identifies all default columns and their possible values. For example, consider the User Status column. The xlDefaultAdmin.properties file contains the following property for the User Status column:
global.resultSet.Users.Status=Active|Disabled|Deleted |Disabled Until Start Date|Locked
The property name is in the form global.resultSet.ColumnMetaData. The ColumnMetaData portion of the property name represents the metadata name of the column or the actual column name if no metadata is associated with the column. Spaces in the property name are represented by tildes (~). For example, the metadata for the User Status column is Users.Status.
Translated property values for default columns are stored in the xlWebAdmin.properties files, which are located in the OIM_HOME/webapp/xlWebApp.war file. The xlWebAdmin.properties files are named xlWebAdmin_en_US.properties for U.S. English deployments, xlWebAdmin_fr.properties for French deployments, and xlWebAdmin_ja.properties for Japanese deployments. For the User Status column, the xlWebAdmin_en_US.properties contains the following property values:
global.resultSet.Users.Status.Active=Active global.resultSet.Users.Status.Disabled=Disabled global.resultSet.Users.Status.Deleted=Deleted global.resultSet.Users.Status.Disabled~Until~Start~Date=Disabled Until Start Date global.resultSet.Users.Status.Locked=Locked
In comparison, the xlWebAdmin_fr.properties contains the following French property values. Notice that some of the values contain Unicode to represent French characters.
global.resultSet.Users.Status.Active=Actif global.resultSet.Users.Status.Disabled=D\u00E9sactiv\u00E9 global.resultSet.Users.Status.Deleted=Supprim\u00E9 global.resultSet.Users.Status.Disabled~Until~Start~Date=D\u00E9sactiv\u00E9 jusqu'\u00E0 la date de d\u00E9but global.resultSet.Users.Status.Locked=Verrouill\u00E9
To translate custom columns, you must edit the custom resource files and update the translation data structures, as described in the following topics:
To translate custom columns, you edit the custom resource files, which are described in "Localizing User-Defined Data Using Custom Resource Bundles". As an example of how to translate custom columns, consider a custom report containing a column named GROUP MEMBERSHIP TYPE that can be assigned one of two values: Direct or Indirect. You must perform the following steps to translate the values of the GROUP MEMBERSHIP TYPE column:
Open the following file in a text editor:
OIM_HOME/xellerate/customResources/customDefaultResources.properties
Add to the customDefaultResources.properties the following property definition and values for the GROUP MEMBERSHIP TYPE column:
global.resultSet.GROUP~MEMBERSHIP~TYPE=Direct|Indirect
Open in a text editor the custom resource file representing the locale for which you want to translate the column values. For example, the path and file name for the French custom resource file is as follows:
OIM_HOME/xellerate/customResources/customResource_fr.properties
Add to the customResource_fr.properties file the following French property values for the GROUP MEMBERSHIP TYPE column:
global.resultSet.GROUP~MEMBERSHIP~TYPE.Direct=Direct global.resultSet.GROUP~MEMBERSHIP~TYPE.Indirect=Indirect
Repeat the preceding steps for each language into which you want to translate property values for custom columns.
Note: If a column name is an alias, Oracle Identity Manager converts it to uppercase. Property names are case-sensitive, so be sure to specify the correct case for column names in the property files. Do not change the lettercase for column names that already contain column metadata, such asUsers.User Status . |
To translate custom columns, Oracle Identity Manager creates translation data structures containing custom resource information. For the columns to be translated correctly, you must refresh the translation data structures whenever you change any of the existing resource bundle files in the customResources directory. To update the translation data structures:
Open the following URL in a Web browser:
http://host:port/xlWebApp/XellerateBootstrapServlet
In the preceding URL, host and port refer to the domain name (or IP address) and port where Oracle Identity Manager is running. You should see a message confirming that the custom resource properties were successfully updated.
Clear the server cache for the CustomDefaultBundle
cache category by following the instructions in "Clearing the Cache for Custom and Connector Resource Bundles".
As described in the Oracle Identity Manager Administrative and User Console Guide, system administrators can configure reports of user entitlements and users who are allocated to resources. You can convert static fields in a report to selection lists. These selection lists are known as Lookup fields. For example, fields such as user type, status, and so on can be represented as sets of lookup values. You can create and modify lookup values on input pages of a report and in results pages where there is support for filtering of results.
You customize the appearance of a report by editing the report metadata XML in the REP_XML_META
column content in REP
table. This table resides in the database schema that is used for Oracle Identity Manager installation. To access the contents of REP_XML_META column in the REP table, you can use a commercial tool, for example, TOAD.
The following is an example of creating a report field as a set of lookup values:
<InputParameter name="struseremptype_in" parameterType="varchar2" order="11" fieldType="Combobox" allowedValues="Lookup.Users.Role" fieldLabel="report.userResourceAccess.label.employeeType" required="false" />
In the preceding example, the fieldType
is set to Combobox
. This setting configures the field as a list of selectable values. The allowedValues
attribute is set to a lookup code named Lookup.Users.Role
. The lookup code populates the field with data.
The following is an example of modifying a report results filter page. This example configures the User field as a lookup field with a set of selectable values:
<ReturnColumn name="Users.Role" label="report.userResourceAccess.label.employeeType" position="SectionHeader" filterColumn="false" filterColumnName="usr.usr_emp_type" filterType="Combobox" filterLookupKey="Lookup.Users.Role" />
In the preceding example, the filterColumn
attribute is set to false, fieldType
is set to Combobox
and filterLookupKey
is set to a lookup code named Lookup.Users.Role
. The lookup code populates the field with data.
If you add values for a lookup code in the Design Console, you must create corresponding entries in the following file for each locale you support:
customResorces\custombundle_<lang>_<Country>.properties
For example, you would add a user role in the Lookup.Users.Role
lookup code using the naming conventions:
global.<lookup_code>.<decode_data>=<unicoded_decodedata_string>
See also: "Localizing User-Defined Data Using Custom Resource Bundles" for examples of creating a resource string |
This section discusses the following topics:
The following fields do not support special characters:
User Login
Group Name
Organization Name
Resource Name
Process Name
Request Number
Column Label
Task Name
The following are the special characters that are not supported in the preceding fields:
Semicolon ( ; )
Pound ( # )
Forward slash ( / )
Percent ( % )
Equals sign ( = )
Bar ( | )
Plus sign ( + )
Comma ( , )
Back slash ( \ )
Double quotes ( " )
Less than ( < )
Greater than ( > )
At runtime, Oracle Identity Manager generates email messages that are localized in the language you selected during installation.
As described in the Oracle Identity Manager Design Console Guide, the Process Management folder provides System Administrators with tools for creating and managing Oracle Identity Manager email templates. The Email Definition form enables you to create templates for email notifications.
The predefined email templates are localized in the supported languages. In the Email Definition form of the Design Console, if you search for a template with a particular name, the returned template contains all configured languages. You can edit all language versions of the template.
Note: In Oracle Identity Manager Administrative and User Console, some of the text in the notes field on the task details page displays in English. This occurs for task instances with the following task names:
|
The Design Console is not localized. All static strings and messages appear in English. However, the Design Console can handle native language input, and it can output data as Unicode-encoded strings.
The restriction on the types of data encoding supported on the various attributes is discussed in Appendix B, "Oracle Identity Manager Application Language Support and Restrictions".
The Diagnostic Dashboard application generates HTTP responses using the language setting of the Web client browser.
The Deployment Manager exports and imports data using UTF-8 encoding. If you exported a file using an older release of Oracle Identity Manager, and the data in the export file does not use UTF-8 encoding, you must convert the file to UTF-8 encoding before re-importing it into the current version of the Deployment Manager.
Some Oracle Identity Manager connectors provide connectivity to provisionable target systems. These adapters handle language-specific character string data for the supported language. The strings can have multi-byte character encoding. The adapters pass data from Oracle Identity Manager to the targets using UCS-2 Unicode encoding in the JAVA layer. This data can be converted to either UTF-8 or native character sets, depending on the target system or target system-specific native code.