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:

 

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 ParameterPossible 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