People Finder V5.1

People Finder V5.1

Overview

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.
Multiple instances of the People Finder portlet appear on the pages of the Collaboration Center, so that users can find people in any context.
For information about working with the People Finder portlet, see the Help that is available from the portlet title bar.

Using the People Finder portlet

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

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

Using the portlet's configuration mode, you can 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.
For 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
n/a

JavaScript
n/a

<iframe>
No

Style sheets
Portal styles only

Software
This portlet has been tested on the following browsers:
Internet Explorer V5.5 and 6.0
Netscape V6.2
Mozilla V1.0

Accessibility
Yes

Server requirements

There are no special server requirements for the People Finder portlet.

Deployment/Installation

This portlet is installed automatically as part of WebSphere Portal installation.
Note: This portlet is not supported as a remote WSRP service.

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.
Language properties files are in the following location:

PORTAL_ROOT\shared\web-inf\lwppeoplefinder.jar

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 - Portlet Management. Use the portlet's Configuration mode to configure the People Finder. Use the Portal Administration - Portlets - Portlet Management task only for viewing parameters when troubleshooting portlet configuration.

Parameter Value
ConfigHelpURI
The location and name of the JSP containing topics launched from the Help icon in People Finder Configuration mode.

Default: /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 person links, Quick Search, Quick Search Results, Advanced Search, and Advanced Search Results.

Default: /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: /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: /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 the Person menu to display the action Find Person.
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.
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.

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: 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
Config_Active_Queries
Config_VisualSets
Config_Views
Config_QuerySets
Config_QueryViews
Config_UpdateInfo
Config_Complete
These parameters appear in the portlet after fields are specified in configuration mode.
Do not modify these parameters.

See also

Collaborative portlets
People Finder configuration mode
People Finder interaction with other portlets
WebSphere Member Manager and People Finder
Set up the Collaboration Center

Home | Support | Terms of use | Feedback

WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.

Minimum requirements for HTML
Markup level	HTML 4.01 Transitional
Java applet	n/a
JavaScript	n/a
<iframe>	No
Style sheets	Portal styles only
Software	This portlet has been tested on the following browsers: Internet Explorer V5.5 and 6.0 Netscape V6.2 Mozilla V1.0
Accessibility	Yes

Parameter	Value
ConfigHelpURI	The location and name of the JSP containing topics launched from the Help icon in People Finder Configuration mode. Default: /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 person links, Quick Search, Quick Search Results, Advanced Search, and Advanced Search Results. Default: /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: /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: /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 the Person menu to display the action Find Person. 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. 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.
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: 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 Config_Active_Queries Config_VisualSets Config_Views Config_QuerySets Config_QueryViews Config_UpdateInfo Config_Complete	These parameters appear in the portlet after fields are specified in configuration mode. Do not modify these parameters.