Skip Headers
Oracle® Identity Manager Administrative and User Console Customization Guide
Release 9.0
B25943-01
  Go To Documentation Library
Home
Go To Table Of Contents
Contents
Go To Index
Index

Previous
Previous
 
Next
Next
 

8 Customizing Menus

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

  1. Identify the menu group or item that you want to customize. Then 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 file. The following table identifies the location of the xlWebAdmin.properties file for each supported application server.

    Application Server Location
    JBoss
    1. Extract xlWebApp.war from the EAR file located in JBOSS_HOME\server\default\deploy\XellerateFull.ear.
    2. Extract xlWebApp.war\WEB-INF\classes\xlWebAdmin.properties from the WAR file.

    3. Edit the xlWebAdmin.properties file.

    4. Repackage the WAR file.

    5. Repackage the EAR file.

    WebSphere The file is available in the location WS_HOME\installedApps\<cell_name>\Xellerate.ear\xlWebApp.war\WEB-INF\classes\xlWebAdmin.properties.
    WebLogic Admin Server: The file is available in the location WL_HOME\user_projects\domains\<domain_name>\XLApplications\XLXellerateFull.ear\ xlWebApp.war\WEB-INF\classes\xlWebAdmin.properties.

    Managed Server: The file is available in the location WL_Home\user_projects\domains\<domain_name>\<managed_server>\stage\Xellerate\ xlWebApp.war\WEB-INF\classes\xlWebAdmin.properties


  3. To modify a menu group, locate 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 ( - ). So 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. To modify a menu item, locate the properties of the menu item you want to change. 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 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 must create the correct entries in the system using the Form Information form in the Oracle Identity Manager Design Console. Next, you must add the corresponding new properties mentioned in step 4. 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. Then, you need to add the following properties to the xlWebAdmin.properties file using the class names specified in step 5:

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

    Whatever values you give on the right-hand side of the properties will be the values displayed on the screen.

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