Typical customizations include:
Creating a custom message catalog
Changing Default Strings in the Identity Manager User Interface Home Page
You must create a custom message catalog to override any string that is defined in the default message catalog. For example, if you want to rename Identity Manager, you must create a custom catalog and change the following definition:
PRODUCT_NAME=Identity Manager
The following entries also control the display of the product name:
LIGHTHOUSE_DISPLAY_NAME=[PRODUCT_NAME] LIGHTHOUSE_TYPE_DISPLAY_NAME=[PRODUCT_NAME] LIGHTHOUSE_DEFAULT_POLICY=Default [PRODUCT_NAME] Account Policy
See Chapter 8, Customizing Message Catalogs for detailed information about creating a message catalog.
A typical customization to the home page involves adding a custom list of links to tasks or resources that users frequently access in your environment. These quick links offer a shortcut through the product interface to frequent destinations.
Add links to the list in index_quickLinks.jsp.
Uncomment the list section by removing the surrounding <%-- and --%> tags.
Save the file. You do not need to restart your application server.
Imported the following XML file:
<?xml version=’1.0’ encoding=’UTF-8’?> <!DOCTYPE Configuration PUBLIC ’waveset.dtd’ ’waveset.dtd’> <Configuration name=’AltMsgCatalog’> <Extension> <CustomCatalog id=’AltMsgCatalog’ enabled=’true’> <MessageSet language=’en’ country=’US’> <Msg id=’UI_BROWSER_TITLE_PROD_NAME_OVERRIDE’>Override Name</Msg> </MessageSet> </CustomCatalog> </Extension> </Configuration> |
Add the following line to the System Configuration object within the <Configuration><Extension><Object> element:
<Attribute name=’customMessageCatalog’ value=’AltMsgCatalog’/> |
Add the following line:
<msg id=’UI_NAV_FOOT_LOG’>mytext{0}</msg> |
Save change and restart your application server.
To change the default Login page title and subtitle and welcome message, change the following entries in the custom message catalog:
UI_LOGIN_TITLE
UI_LOGIN_TITLE_TO_RESOURCE
UI_LOGIN_WELCOME2
To change this text, follow the procedure for extracting and editing the WPMessages_en.properties file detailed in Changing the Default “Logged in as” Text.
The following text lists the default message catalog settings:
UI_LOGIN_IN_PROGRESS_TITLE=Log In (In Progress) UI_LOGIN_CHALLENGE=Enter Your {0} Password UI_LOGIN_CHALLENGE_INFO=You are required to enter the password you logged into [PRODUCT_NAME] with before the requested action can be completed. UI_LOGIN_TITLE_LONG=[PRODUCT_NAME] LogIn UI_LOGIN_WELCOME=Welcome to the Sun [PRODUCT_NAME] system. Enter the requested information, and then click <b>Login</b>. UI_LOGIN_WELCOME2=Welcome to the Sun [PRODUCT_NAME] system. Enter your user ID and password, and then click <b>Login</b>. If you can’t remember your password, click <b>Forgot Your Password?</b> UI_LOGIN_TITLE=Log In UI_LOGIN_TITLE_TO_RESOURCE=Log In to <b>{0}</b> |
You can change the background image by editing customStyle.css as follows:
div#loginFormDiv { background: url(.../images/other/login-backimage2.jpg) no-repeat; margin-left: -10px; padding: 0px 0px 280px; height: 435px;
You can now replace the product name string in the browser title bar with a localizable string of your choice.
Import the following XML file:
<?xml version=’1.0’ encoding=’UTF-8’?> <!DOCTYPE Configuration PUBLIC ’waveset.dtd’ ’waveset.dtd’> <Configuration name=’AltMsgCatalog’> <Extension> <CustomCatalog id=’AltMsgCatalog’ enabled=’true’> <MessageSet language=’en’ country=’US’> <Msg id=’UI_BROWSER_TITLE_PROD_NAME_OVERRIDE’>Override Name</Msg> </MessageSet> </CustomCatalog> </Extension> </Configuration> |
Using the Identity Manager IDE, load the System Configuration object for editing. Add the following line inside the <Configuration><Extension><Object> element:
<Attribute name=’customMessageCatalog’ value=’AltMsgCatalog’/> |
Also in the System Configuration object, you must change ui.web.browserTitleProdNameOverride to true.
Save this change to the System Configuration object, and restart your application server.
The Identity Manager User Interface home page provides a “dashboard” area that summarizes basic information about the logged-in account, including the default strings listed in the following table.
All attributes belong to the ui.web.user.dashboard object.
Table 7–2 Default Settings of ui.web.user.dashboard Object
Default Configuration Object Setting |
Description |
---|---|
displayLoginFailures |
Displays the number of unsuccessful password or authentication question login attempts if a maximum login attempts value has been configured in an account’s account policy. |
displayPasswordExpirationWarning |
Displays messages related to password expiration if password policy is applied to an account. |
displayApprovals displayAttestationReviews displayOtherWorkItems displayRemediations |
Enable the display of the following work item types for all users: Approvals, Attestations, Remediations, and Other. Note: Even if the configuration object is true for a particular type, the interface string may not appear based on the permissions granted to a user for his account. |
displayRequests |
Specifies the number of outstanding requests for role, group, or resource updates for an account |
displayDelegations |
Displays a string that indicates that the user has defined an approval delegation. Options include enabled or disabled. |
By default, the value of the preceding configuration objects is set to true, and these strings will appear in the Identity Manager User Interface. To suppress the display of any string, set it to false in the System Configuration object.
You can edit the System Configuration object through the Identity Manager IDE. For general information about the System Configuration object, see Chapter 10, Editing Configuration Objects
In the Identity Manager User Interface, the horizontal navigation bar is driven by the End User Navigation User form in enduser.xml. The userHeader.jsp, which is included in all Identity Manager User Interface pages, includes another JSP named menuStart.jsp. This JSP accesses two system configuration objects:
ui.web.user.showMenu. Toggles the display of the navigation menu on and off. The default value is true.
ui.web.user.menuLayout. Determines whether the menu is rendered as a horizontal navigation bar with tabs (the default value is horizontal) or as a vertical tree menu (vertical).
The CSS style classes that determine how the menu is rendered are defined in style.css.
If you implement custom JavaScript functions in the end user navigation bar (tabs), you must use endUserNavigation to reference that form (for example, document.forms['endUserNavigation'].elements).
Display attributes typically specify the following basic font display characteristics.
Table 7–3 Font-related Display Characteristics
Display Attribute |
Description |
---|---|
family |
For example, Helvetica or Arial |
size |
Specified in point size (for example, 14 point) |
weight |
Unspecified indicates normal weight. When specified, typically bold |
color |
Typically specified as black (title -- font-family, font-size, font-weight, color |
Certain components can be further defined by additional characteristics. For example, buttons can be defined with a background color. The alignment of the text and button label is another characteristic.
To edit, copy from styles.css and paste into customStyle.css. Then, modify the selected setting in customStyle.css.
The following entry represents the default settings for each page title:
.title { font-family: Arial, Helvetica, sans-serif; font-size: 16pt; font-weight: bold; color: C;