Directory Search

The Directory Search portlet is a common embedded component that allows users to select names of people and groups.

Directory Search is different from People Finder in two ways:

• Users use Directory Search as part of a task, such as sending a document link to other people with access to the same document library. Users can select the name(s) Directory Search finds and use that selection in the next step of their task.

• Users can search for groups as well as people.

Directory Search is supported as a remote WSRP service, and is available from all calling applications.

Use the Directory Search portlet

Directory Search opens in a window set to use the "no skin" skin so that it appears without a title bar. The portlet provides common controls for searching for people and groups.

Table 1. Portlet controls

Control	Description
Search for	The field where users enter all or part of a name for retrieval from the directory. Users can search for person names only, group names only, or person names and group names.
Search results	The list of names (persons and groups) that match the search text. By default, the application context and the type of directory determine the information that is displayed in the columns of the search results list. You can configure the search results to show information in three columns. Users can use the third column to distinguish between people whose name information in the first and second columns is identical.

Test assumptions

This portlet has been tested on and is compatible with all supported platforms, as listed in the WebSphere Portal detailed system requirements.

Setting up Directory Search

For Directory Search, make sure your environment meets the following client and server requirements.

Client requirements

This portlet supports browsers capable of rendering HTML markup. The following table provides detailed information.

Table 2. Minimum requirements for HTML

Item	Description
Markup level	HTML 4.01 Transitional
Java applet	No
JavaScript	Yes
<iframe>	No
Style sheets	Portal styles only
Software	The Directory Search portlet is compatible with specific Web browser software releases. For details, refer to the WebSphere Portal hardware and software requirements.
Accessibility	Yes

Server requirements

There are no special server requirements for the Directory Search portlet.

Deployment/Installation

This portlet is installed automatically as part of WebSphere Portal installation.

This portlet is supported as a remote WSRP service.

Configure Directory Search

Directory Search uses the directory configured in WebSphere Portal. The directory is comprised of both of the following sets of user information:

• the IBM WAS User Registry

• either the Lookaside database of WebSphere Portal membership information, or a DB2 database.

Both sets of information are controlled by the Member Manager component. In the Information center, see Configuring > Configuring security > Planning > Authentication > Member Manager.

The directory applies the byName query defined in Member Manager when retrieving person or group names The byName query uses cn when retrieving a group name, and at least one of the following attributes when retrieving a person name:

• cn

• givenName

• sn

• DisplayName

For detailed information. refer to the attribute definition and mapping files and the configuration property files described in Member Manager documentation.

Configuration parameters

There are no configuration parameters for this portlet.

Parent topic:

Finding users

Related information

WebSphere Portal detailed system requirements

---