8 Customizing Menus

This chapter describes how to customize the menus in the Oracle Identity Manager Administrative and User Console.

To customize the menus in the Console:

1. Identify the menu group or item that you want to customize and obtain the class name of the menu group or item by using the Form Information form in the Oracle Identity Manager Design Console.

   For example, the class name for the Request New Resources item on the My Resources menu is My Resources.Request New Resources. This name is stored in the database WIN table. The corresponding menu item shows that the menu group code is My Resources and the menu item code is Request New Resources.

2. Open the xlWebAdmin.properties or xlDefaultAdmin.properties files. The following table identifies the locations of the files for each supported application server.

   Table 8-1 Location of xlWebAdmin Properties and xlDefaultAdmin.properties Files

   Application Server	Location
   OC4J	Files are available in OC4J_HOME\product\10.1.3.1\OracleAS_1\j2ee\home\applications\Xellerate\xlWebApp\WEB-INF\classes.
   JBoss	Extract xlWebApp.war from the EAR file located in JBOSS_HOME\server\default\deploy\XellerateFull.ear. Extract xlWebApp.war\WEB-INF\classes\xlWebAdmin.properties and xlWebApp.war\WEB-INF\classes\xlDefaultAdmin.properties from the WAR file. Edit the xlWebAdmin.properties file or xlDefaultAdmin.properties file. Repackage the WAR file. Repackage the EAR file.
   WebSphere	Files are available in WS_HOME\installedApps\<cell_name>\Xellerate.ear\xlWebApp.war\WEB-INF\classes.
   WebLogic	Admin Server: The files are available in WL_HOME\user_projects\domains\<domain_name>\XLApplications\XLXellerateFull.ear\ xlWebApp.war\WEB-INF\classes. Managed Server: The files available in WL_Home\user_projects\domains\<domain_name>\<managed_server>\stage\Xellerate\xlWebApp.war\WEB-INF\classes

   
   

3. To modify a menu group, locate in the xlWebAdmin.properties file the property name for the menu group that you want to customize. Each menu group has a single property associated with it, which represents the display label.

   The property name for the menu group display label has the form menuGroup.menu group code with the spaces replaced by hyphens ( - ). For example, for a menu group with code My Resources, the property name is menuGroup.My-Resources. Modify the value assigned to the property to the label you want to display.

4. Each menu item has two properties associated with it: the menu item display label property and the menu item link property, which identifies the target page that opens when a menu item is selected. The menu item display label property is defined in the xlWebAdmin.properties file and the menu item link property is defined in the xlDefaultAdmin.properties file.

   The property name for a menu item display label has the form menuItem.menu group code.menu item code with the spaces replaced by hyphens. This means that a menu item with the code Request-New-Resources under a menu group with the code My-Resources has a property name of menuItem.My-Resources.Request-New-Resources. The menu item link property is in the form menuItem.menu group code.menu item code.link.

5. To create new menu items or groups, you first create the correct entries in the system using the Form Information form in the Oracle Identity Manager Design Console. Next, you add the corresponding new properties mentioned in step 7. For each new menu group, one new property is required, and for each new menu item, two new properties are needed.

   For example, suppose you want to add a new menu group with the code 'My Links' and two new menu items under it, with codes 'Favorites' and 'Non-Work Links'. You must create two new entries in the system using the 'Form Information' form in the Oracle Identity Manager Design Console with the class names 'My Links.Favorites' and 'My Links.Non-Work Links'. The class names you use can be anything; the instances here are just examples. The labels that are displayed do not depend on these names.

6. Add the following properties to the xlWebAdmin.properties file by using the class names specified in step 8:

   menuGroup.My-Links=My Links
   menuGroup.My-Links.Favorites=Favorites
   menuGroup.My-Links.Non-Work-Links=Non-Work Links
   
   

7. Add the following properties to the xlDefaultAdmin.properties file by using the class names specified in step 8:

   menuGroup.My-Links.Favorites.link=favorites.do?myfavorites
   menuGroup.My-Links Non-Work-Links.link=nonworklinks.do?nonworklinks
   
   

Keep in mind that in order to change the menu group or item names, only the xlWebAdmin.properties and xlDefaultAdmin.properties files should be changed. No change is required to the database or code.