People Finder Version 5.02

The People Finder portlet is the primary application of Collaboration Center.

The Collaboration Center is included with WebSphere Portal Express Plus only.

For information about working with the People Finder portlet, see the Portlet Help that is available from the portlet title bar.

The People Finder portlet provides both quick search and advanced search options for locating people and information about people. Once found, a person is visible to other users as a person link that indicates online presence and displays a menu of instant messaging and other options. Clicking a person link displays the Person Record, including the person's business card information followed by administrator-defined fields organized in sections, for example, Contact Information, Current Job, and Background. The portlet also provides a view of the person's place in the organizational context. In the Organization View, users can display the person's reporting structure: that is, the employees the person manages, if any, and the person's management chain.

General users work with the People Finder portlet using the following features, which appear in one or more views of the portlet:

Quick Search and Quick Search Results, including Business Card fields

Advanced Search and Advanced Search Results

Person record, including Business Card fields

Organization view, including Business Card fields

Portlet security

To use the People Finder portlet, users must be granted access to the hidden page provided by the DeployCollabCenterPortlets.xml file that is added to the portal when the Collaboration Center is installed. The page is a portal resource.

For more information on the DeployCollabCenterPortlets.xml file, see Install Collaboration Center components, and for more information on granting users access to the hidden page, see Resource Permissions portlet.

Test assumptions

The People Finder portlet has been tested on and is compatible with all supported WebSphere Portal platforms, as listed in Supported hardware and software .

Set up the People Finder

Use the portlet's configuration mode, administrators or designers specify the fields that they want to appear in the People Finder portlet. The fields that are available for selection in Configuration mode are based on the WebSphere Member Manager (WMM) schema. The defined People Finder fields then become available for selection in the remaining portlet configuration tasks, by which the administrator or designer specifies the content and format of the People Finder views. Administrators install, configure, and deploy the People Finder portlet in the portal as they do other portlets.

Before you install People Finder, make sure your portal 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	TBD
JavaScript	TBD
<iframe>	No
Style sheets	Portal styles only
Software	This portlet has been tested on the following browsers: Internet Explorer Version 5.5 and 6.0 Netscape Version 6.2 Mozilla Version 1.0
Accessibility	Yes

Server requirements

The People Finder portlet requires WebSphere Portal Version 5.0.2.

Deployment/Installation

See the WebSphere Portal Help and Information Center for more information about installing portlets.

National language support for People Finder fields

All fields of the People Finder portlet must have associated language strings defined in each language property file, PeopleFinderUI_<language_code>.properties. The field names are the names of the corresponding attributes in WebSphere Member Manager.

For each People Finder field, three strings are required:

One string for the field's name, which is the attribute name

One string for the field's long name

One string for the field's description as it appears in the tasks of People Finder configuration mode

Example:

displayName = Name

displayName_Long = Preferred Name

displayName_Desc = Display name

The resource key for each field refers to the appropriate language property file, web-inf/nls/PeopleFinderUI_<language-code>.properties. Foreign language translations of People Finder fields must be stored in the appropriate language property file. For more information, see Language support.

Configuration parameters

The following configuration parameters are available in this portlet.

Do not modify any configuration parameter values for the People Finder portlet using the Portal Administration task Portal Administration - Portlets - Manage Portlets. You must use the portlet's Configuration mode to configure the People Finder. Use the Portal Administration - Portlets - Manage Portlets task only for viewing parameters when troubleshooting portlet configuration. For more information, see the troubleshooting topics for the People Finder in Troubleshooting.

Parameter	Value
ConfigHelpURI	The location and name of the JSP containing topics launched from the Help icon in People Finder Configuration mode. Default value: /help/pfind_config.jsp
SearchHelpURI	The location and name of the JSP containing topics launched from the Help icon in the Person Record view of the People Finder. Topics in this JSP include Help for people links, Quick Search, Quick Search Results, Advanced Search, and Advanced Search Results. Default value:/help/pfind_view_search_for_people.jsp
PersonRecordHelpURI	The location and name of the JSP containing topics launched from the Help icon in the Person Record and Organization view of the People Finder. Default value: /help/pfind_view_display_person_info.jsp
c2a-nls-file	The name of the file that stores National Language Support resource bundles for People Finder click-to-action (C2A) methods.
c2a-action-description	The location and name of the Web Description Language file for People Finder click-to-action (C2A) methods. Default value: /wsdl/PeopleFinderC2A.wsdl The People Finder portlet publishes the following C2A methods: FindPersonByName FindPersonByEmailAddress ShowPersonRecordByMemberID ShowOrgViewByMemberID Portlets that provide source objects of type PersonNameType and EmailAddrType will support the FindPersonByName and FindPersonByEmailAddress methods when those portlets are on the same page as the People Finder. Both methods cause a person menu to display the action Find Person. Clicking Find Person on the person menu causes the People Finder to execute a quick search. Portlets that provide source objects of the type memberUniqueId will support the ShowPersonRecordByMemberID method when the portlets are on the same page as the People Finder portlet. When called, this method causes the person menu to display the Show Person Record action. Clicking Show Person Record on the person menu opens the Person Record in a maximized People Finder. Portlets that provide the source objects of the type memberUniqueId will support the ShowOrgViewByMemberID method when the portlets are on the same page as the People Finder. This method requires the Organization View to be enabled for the People Finder. When called, this method causes the person menu to display the Show in Organization View action. Clicking Show in Organization View on the person menu opens the Organization View in a maximized People Finder.
Config_ResultSetLimit	Specifies the number of search results to be returned by Quick Search and Advanced Search. The value specified for this parameter appears in People Finder configuration mode, Configuration Basics, the Search Results field. Default value: 40
Config_RecursionSetLimit	Specifies the maximum number of recursions performed by search and retrieval on the manager attribute for a given person. The limit of recursions performed on the manager attribute determines the number of managers above the found person that appear in the Organization View.
Config_ActiveFields	Appears in the portlet after fields are specified in configuration mode. Do not modify this parameter.
Config_Active_Queries	Appears in the portlet after fields are specified in configuration mode. Do not modify this parameter.
Config_VisualSets	Appears in the portlet after fields are specified in configuration mode. Do not modify this parameter.
Config_Views	Appears in the portlet after fields are specified in configuration mode. Do not modify this parameter.
Config_QuerySets	Appears in the portlet after fields are specified in configuration mode. Do not modify this parameter.
Config_QueryViews	Appears in the portlet after fields are specified in configuration mode. Do not modify this parameter.
Config_UpdateInfo	Appears in the portlet after fields are specified in configuration mode. Do not modify this parameter.
Config_Complete	Appears in the portlet after fields are specified in configuration mode. Do not modify this parameter.