Managing the Profiles search operation
Use Profiles configuration settings to control how the search operation displays search results.
Before you begin
To edit configuration files, you must use the IBM® WebSphere® Application Server wsadmin client. See Starting the wsadmin client for information about how to start the wsadmin command-line tool.
Procedure
- Start the wsadmin client from the following
directory of the system on which you installed the Deployment Manager:
where app_server_root is the WebSphere® Application Server installation directory and dm_profile_root is the Deployment Manager profile directory, typically dmgr01.app_server_root\profiles\dm_profile_root\bin
You must start the client from this directory or subsequent commands that you enter do not execute correctly.
- Start the Profiles Jython script interpreter.
- To configure the Profiles search operation, use the following
command:
ProfilesConfigService.updateConfig(property, value)
where- property is one of the editable Profiles configuration properties.
- value is the new value with which you want to set that property.
The following table displays information regarding the search property and the type of data that you can enter for it.
Table 1. Profiles search properties Property Description search.maxRowsToReturn Determines the maximum number of Profiles database rows returned by a name search operation.
This property takes an integer value. The default value is 250. You can increase the number, but do not specify a number larger than 500. Doing so causes search operations to fail entirely. Do not specify 0 unless you want no results to be returned.
The keyword and directory search operations do not have this limit.
search.pageSize Determines the number of returned rows to place on a results page. This property takes an integer value. The default value is 10.
search.firstNameSearchEnabled Determines if search by first name only is enabled. By default, this setting is set to false.
This property takes a Boolean value.
Note: Enabling this setting negatively impacts the performance of the Search by > Name function available in the Profiles user interface.nameOrdering.enabled When this property is set to true, names must be entered as (FirstName LastName) or (LastName, FirstName). By default, it is set to false.
Note: When only a single word is entered, that word is treated as the LastName value during search.This property takes a Boolean value.
For example:
ProfilesConfigService.updateConfig("search.pageSize","20")
- To specify the default sorting key to use for displaying
search results, you must edit properties in the profiles-config.xml file
manually as follows.
- After making changes, you must check the configuration files back in, and you must do so during the same wsadmin session in which you checked them out for the changes to take effect. See Applying property changes in Profiles for information about how to save and apply your changes.