Policy Server Guides › Policy Design Guide › Customizing Registration Services › Search Customization › Modify the Search Fields

Previous Topic: Search Customization

Next Topic: Change the Search Attributes
Modify the Search Fields

The JSP page that enables administrators to search for users in their directory is manage_data.jsp. It includes search fields in which administrators can specify search criteria. For example, you can select an attribute, such as uid, and specify a value for that attribute.

You can modify the fields that appear on the search page by modifying manage_data.jsp, which is installed in the samples\dmspages directory where Registration Services is installed.

Note: If you created additional pages directories for specific registration spaces, modify the manage_data.jsp page in the appropriate directories.

Each field in the search page is controlled by a parameter in manage_data.jsp.

Note: The display of the # Records per Page field is set in profile_search_init.jsp.

The section of manage_data.jsp that controls the display of these fields resembles the following:

             boolean searchFixedRoot = true;
             String searchRoot = (String)request.getAttribute("orgpath");
             boolean searchNoFilter = false;
             boolean searchNoFilterLines = false;
             boolean searchFixedFilterLines = false;
             boolean searchNoScope = false;
             int searchScope = 1;
             int searchDisplayColumn = 0;
%>

The following table describes the parameters in the previous section of manage_data.jsp.

Parameter

Description

searchObject

Used by DMS.

searchFixedRoot

Determines whether or not the Search Root field is writable.

This boolean can have the following values:

true (default)—Makes the Search Root field Read Only. Users cannot modify the search root manually.

false—Makes the Search Root field writable. Administrators can manually enter the search root where they would like to begin a search.

searchRoot

Determines the search root that Registration Services uses. The searchRoot parameter is paired with an expression that retrieves the current organization’s DN. If no current organization is selected, the DN of the highest organization for which the administrator has privileges is used.

searchNoFilter

Controls the display of the Filter field. The Filter field enables administrators to manually enter search parameters. This boolean can have the following values:

true—Removes the Filter field from the search page.

false (default)—Adds the Filter field to the search page.

searchNoFilterLines

Controls the display of the Where and Is fields. The Where field allows administrators to select an attribute to search. The Is field enables administrators to specify a value for the selected attribute.

This boolean can have the following values:

true—Removes the Where and Is fields from the search page.

false (default)—Adds the Where and Is fields to the search page.

searchFixedFilterLines

Controls the display of the #Filters field and the And and Or radio buttons. The #Filters field enables administrators to specify the number of filters that they want to set. The And radio button joins multiple search filters. The Or radio button causes Registration Services to search for results that match at least one of the search filters.

This boolean can have the following values:

true—Removes the #Filters field and the And and Or radio buttons from the search page.

false (default) —Adds the #Filters field and the And and Or radio buttons to the search page.

searchNoScope

Controls the display of the 1 Level and N Level radio buttons. These buttons determine how many levels of the directory the administrator wants to search.

This boolean can have the following values:

true—Removes the 1 Level and N Level radio buttons from the search page.

false (default) —Adds the 1 Level and N Level radio buttons to the search page.

Note: If you remove these radio buttons, Registration Services will perform N-level searches, unless you change the value of searchScope.

searchScope

Controls the default scope for searches. The values for this parameter are:

2—sets the default search scope to n-levels

1 (default)—sets the default search to one level

More information:

Customize the Results Per Page