Portal Express, Version 6.0
Operating systems: i5/OS, Linux, Windows
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.
| 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.
To modify the information that appears, see Setting attributes for results columns. 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
The Directory Search portlet has been tested on and is compatible with all supported IBM® WebSphere® Portal Express platforms, as listed in Supported hardware and software.
Set 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.
| Minimum requirements for HTML | |
|---|---|
| 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 the specific Web browser software releases listed in the Supported Web browsers table under Software requirements in Supported hardware and software. |
| 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 Express installation.
This portlet is supported as a remote WSRP service.
Configure Directory Search
Directory Search uses the directory configured in WebSphere Portal Express. The directory is comprised of both of the following sets of user information:
- the IBM WebSphere Application Server User Registry
- either the Lookaside database of WebSphere Portal Express membership information, or a DB2 database.
Both sets of information are controlled by the Member Manager component. See Related information.
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.
Related concepts
Mapping LDAP attributes About people awareness
Related tasks
Collaborating in Document Manager Sending a link to a document
Related information
Member Manager