3 Customizing Text

This chapter describes how to customize the descriptive text and labels that appear on the pages of your Oracle Identity Manager Administrative and User Console. It also describes how to edit the error messages that appear under the specific conditions that generate them.

You can customize the following text:

• Descriptions of procedures (for example, instructional text)

• Labels for pages

• Labels for fields within pages

• Labels that appear on buttons

• Labels for links to other pages

• Copyright dates and information

This chapter contains these topics:

• Files to Modify

• Customizing Descriptive Text and Labels

Files to Modify

To customize text, you edit the xlWebApp\WEB-INF\classes\xlWebAdmin.properties file (or the locale-specific properties file).

Customizing Descriptive Text and Labels

The text the client displays is contained in the xlWebAdmin.properties file. For any label, procedural instruction, or error message that you want to edit, Oracle recommends that you do the following:

1. Access the JSP page in which that text appears.

2. Reference the property associated with that text.

3. Lookup that property name in the xlWebAdmin.properties file.

Properties that control the text on more than one page, or that are associated with multiple product functionalities, are listed in one of the GLOBAL sections of the file, for example, GLOBAL messages. These properties are also divided by type-specific labels—for example, messages, buttons, labels—to better organize the groups of the properties.The properties that control the text that appears in more limited contexts of the product functionality—for example, create user, self-registration—are listed in sections labeled in a function-specific manner, for example, MANAGE USER labels.

The widths of labels in the Workflow Visualizer are calculated by converting pixel lengths to character lengths. An incorrect conversion can result in truncated text or extra white space surrounding the label. The xlRichClient.properties, xlRichClient_jp.properties, and xlRichClient_fr.properties files contain a property named global.workflowRenderer.labelWidthFactor that is used in the conversion of label text from pixel length to character length. To modify the widths of labels in the Workflow Visualizer, modify the integer value that is assigned to this property. A higher integer will increase label widths while a lower integer will decrease them.

See Also: "Accessing Administrative and User Console Customization Files" for details on how to access the xlWebAdmin.properties file.