People Finder interaction with other portlets
Other portlets can use the People Finder by applying either one of the following techniques provided by WebSphere Portal:
People Finder methods for Collaborative Portlets
The following Collaborative Portlet methods enable the People Finder to be used in another type of portlet as long as an instance of the second portlet type is deployed to the same page with the People Finder:
- ShowPersonRecordByMemberID
Property Name: memberID
Property Description: Unique Identifier for a member object in WebSphere Member Manager, whose Person Record should be displayed.
Property Type: memberUniqueId
Property Java Type: java.lang.String
Property Direction: IN
Property Namespace: http://www.ibm.com/wps/c2a/annapolis/PeopleFinder
- ShowOrgViewByMemberID
Property Name: memberID
Property Description: Unique Identifier for a member object in WebSphere Member Manager, whose Organization View should be displayed.
Property Type: memberUniqueId
Property Java Type: java.lang.String
Property Direction: IN
Property Namespace: http://www.ibm.com/wps/c2a/annapolis/PeopleFinder
- FindPersonByName
Property Name: personName
Property Description: Value to search with the byName query of the WebSphere Member Manager member object.
Property Type: PersonNameType
Property Java Type: java.lang.String
Property Direction: IN
Property Namespace: http://www.ibm.com/wps/c2a/annapolis/PeopleFinder
- FindPersonByEmailAddress
Property Name: emailAddr
Property Description: Value to search for in ibm-primaryEmail attribute of the WebSphere Member Manager member object.
Property Type: EmailAddrType
Property Java Type: java.lang.String
Property Direction: IN
Property Namespace: http://www.ibm.com/wps/c2a/annapolis/PeopleFinder
For more information about using these People Finder methods, see Parameter definitions and values in People Finder Version 5.0, specifically the parameter definition for c2a_action_descriptor.
For complete information about Collaborative Portlet functionality, refer to the WebSphere Portal Information Center topics for Developing portlets, Cooperative portlets.
Property Name: memberID
To support Collaborative Portlet methods, the attribute memberUniqueID must be defined for the property memberID. However, any of the following values can be used:
- memberDN
- LDAP DN (if WebSphere Member Manager is based on LDAP)
- any valid entry for unique byName search value
- ibm-personAwarenessIdentity
URL addressability
The Person tag uses URL addressability to communicate with the People Finder if the People Finder is not on the current page of the portal. Other Collaboration Center portlets can use URL addressability to programmatically integrate People Finder features. For example, other portlets can display links for Show Person Record and Show in Organization View actions and thereby access People Finder functionality in their application contexts. Clicking Show Person Record (or Show in Organization View) displays the Person Record (or the Organization View) inside the People Finder, which is launched as a pop-up window.
The following table lists the required URL parameters and possible values for implementing URL actions in portlets:
URL Parameter Possible Values URLAction URLShowPersonRecord
URLShowOrgView
URLMemberID WebSphere Member Manager memberUniqueIdentifier of the person whose Person Record or Organization View is to be displayed.
Alternatively, the following WebSphere Member Manager attributes:
- memberDN
- any valid input for byName query
a valid entry of ibm-PersonAwarenessIdentifier attribute.
For more information about URL addressable portlets, refer to the topics for Developing portlets.
See also
- People Finder Version 5.02
- Planning
- Install Collaboration Center components
- Configure WebSphere Portal to use Collaboration Center portlets
- Troubleshooting
- WebSphere Member Manager and People Finder