Configuration files and descriptions

Configuration files define the appearance of ISIM self-service user interface. The following tables list the file names and describe their roles in the customization of IBM Security Identity Manager.

File Name File Description
SelfServiceUI.properties
  • Controls the layout of the user interface (banner, footer, navigation bar, toolbar), the number of pages that display, and the number of search results returned.

  • Configures the items available in the "Search By" box for user search in the self-service interface.
  • Enables direct access to the Expired Password change screen and bypass the self-service login page under certain conditions. The property key that allows these actions is ui.directExpiredChangePasswordEnabled.
SelfServiceScreenText.properties Provides the text on the self-service user interface.
SelfServiceScreenText_language
.properties
Provides the language-specific text on the self-service user interface. By default this file is SelfServiceScreenText_en.properties, which contains the English language bundle.
SelfServiceHomePage.properties Defines the sections of the self-service user interface home page and the order in which they occur.
SelfServiceHelp.properties Defines the links to html help pages on the self-service user interface. The html files are in the WAS_PROFILE_HOME\installedApps\node_name\ITIM.ear\itim_self_service_help.war directory. We can redirect help by modifying the information in this file.
SelfServiceScreenTextKeys
.properties

Provides label keys on the self-service user interface. This file can be used to assist with customization of screen text by providing a template to develop labels and instructions.

The file contains labels that are set to the key name. For instance, password_title=password_title. For customization and development purposes. we can copy this file to SelfServiceScreenText_language.properties, where language is a language suffix that is not installed. We can then switch your browser locale from your current language to the unused language. Restart the web application to navigate through the pages and see the label keys instead of the value text. By switching your browser locale, we can then toggle between keys and values. When customization is complete, we can then copy and rename the file to the language suffix to use, for example SelfServiceScreenText_en.properties, to finalize changes.

File Name File Description
loginBanner.jsp Contains the content of the banner on the self-service login page.
loginFooter.jsp Contains the content of the footer on the self-service login page.
loginToolbar.jsp Contains the content of the toolbar on the self-service login page.
Home.jsp Contains the content of the self-service home page.
banner.jsp Contains the content of the self-service banner.
footer.jsp Contains the content of the self-service footer.
nav.jsp Contains the content of the self-service navigation bar.
toolbar.jsp Contains the content of the self-service toolbar.

File Name File Description
calendar.css CSS file containing the styles used for calendar widgets.
customForm.css CSS file containing the styles used to lay out custom forms for left to right language orientation.
customForm_rtl.css CSS file containing the styles used to lay out custom forms for right to left language orientation.
dateWidget_ltr.css CSS file containing the styles used for date widgets for left to right language orientation.
dateWidget_rtl.css CSS file containing the styles used for date widgets for right to left language orientation.
enduser.css CSS file that contains main CSS styles for left to right language orientation.
enduser_rtl.css CSS file that contains main CSS styles for right to left language orientation.
time.css CSS file containing the styles used for time widgets.
widgets.css CSS file containing the styles used for other widgets for left to right language orientation.
widgets_rtl.css CSS file containing the styles used for other widgets for right to left language orientation.

Parent topic: Self-service user interface customization