10 Customizing Search Pages

When using the Administrative and User Console to manage items in the systems (users, groups, and so on) the first page a user sees is a search page. For example, when a user clicks on the Manage Users link, the Manage Users page appears with four drop-down menus for searching for users. You can customize the number of drop-down menus, and what the items in the drop-down menus are. When the search results display, you can determine the size of the results table (the maximum number of rows displayed on each page). After a user selects an item from the results table, a detail page appears (User Detail, Group Detail, and so on). The detail page contains an additional details drop-down menu. You can customize the items in these drop-down menus.

Customizing Drop-Down Menu Item Content

Use the Java Client to change the look up codes for search pages and additional details. To customize drop-down menus:

1. Log in to the Java Client.

2. Open the Lookup Definition form (Xellerate Administration > Lookup Definition).

3. Search to locate the desired lookup definition.

   
   

   Hint: For your search criteria, use lookup.webclient* search to find the search pages, or *additional_details to find the additional details.

   
   

4. Make the desired changes to the lookup codes to set the options displayed in the drop-down menu for each search page.

   • The Code Key is the meta data for each column.

   • The Decode value is what is displayed in the Administrative and User Console.

   • The order the items appear in the Code Key list are the order they appear in the Administrative and User Console drop-down list. If you delete an entry and add it back in, it appears last in the list.

5. Save your changes.

Customizing the Number of Drop-down Menu Items and Search Results

Edit the xlWebAdmin.properties file to change the number of drop-down menus, and the maximum number of search results on each page. See the Accessing Administrative and User Console Customization Files section for details on how to access the xlWebAdmin.properties file and how to redeploy the EAR file.

To set the number of drop-down menus:

1. Open the xlWebAdmin.properties file.

2. Locate the property from the following table, and edit is as desired.

   Properties that determine the number of drop-down menus that appear on a search page.

   Property Name	Default	Page
   global.property.numsearchuserfields	4	Search Users
   global.property.numsearchaccesspolicyfields	2	Access Policies
   global.property.numsearchresourcefields	3	Search Resources
   global.property.numsearchgroupfields	1	Search groups
   global.property.numsearchopentaskfields	2	My Open Tasks

   
   

3. To change the maximum number of search results on each page, change the value of the property global.displayrecordNum.value to the desired value (the default is 10).

4. Save the file.

5. Redeploy the EAR file.