3 Customizing Text

This chapter describes how to customize the descriptive text and labels that appear on the pages of the 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, such as 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 discusses the following topics:

• Files to Modify

• Customizing Descriptive Text and Labels

3.1 Files to Modify

To customize the text in the Administrative and User Console, you edit the xlWebApp\WEB-INF\classes\xlWebAdmin.properties file or the locale-specific properties file.

3.2 Customizing Descriptive Text and Labels

The text displayed in the console is stored in the xlWebAdmin.properties file. For any label, procedural instruction, or error message that you want to edit, perform the following steps:

1. Access the JSP page in which the text is displayed.

2. Reference the property associated with the text.

3. Lookup the 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, such as GLOBAL messages. These properties are also divided by type-specific labels, such as messages, buttons, and labels, to organize the groups of the properties.The properties that control the text that is displayed in more specific contexts of the product functionality, such as create user and self-registration, are listed in sections labeled in a function-specific manner, such as MANAGE USER labels.

The width of the 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 file, or locale-specific file such as xlRichClient_jp.properties for Japanese, contains a property named global.workflowRenderer.labelWidthFactor. This property is used in the conversion of label text from pixel length to character length. To modify the width of labels in the Workflow Visualizer, modify the integer value that is assigned to this property. A higher integer will increase label widths, and a lower integer will decrease them.

See Also:

The "Accessing Administrative and User Console Customization Files" section for details on how to access the xlWebAdmin.properties file.