In IBM® Lotus® Quickr™, Lotus software components provide the
People Finder portlet and the Person tag component that supports awareness
in your Lotus Quickr places.
The Person tag in Lotus Quickr is no longer provided by the Lotus®
Collaborative Services Java API. It is supported by the Live Object Framework,
The People Finder portlet continues to use the PeopleService object
of the Collaborative Services API.
Lotus Quickr includes people awareness features, so that people's
names can appear as hyperlinks that allow users to contact people with
whom they might want to work.
Wherever person links appear, users can click the link to display
a menu of actions for collaborating (contacting and working) with the person
named by the link. If you, as administrator, have also configured a Lotus
Sametime server to work with Lotus Quickr, person links indicate whether
a person is active, away, offline, or in a Do Not Disturb state.
For details on the implementation of the Person tag, and instructions
on customizing the tag for Lotus Quickr applications that you develop,
see the Live
Object Framework overview in the Lotus Quickr 8.1 information
contact information on person links
When users click a person link, the Person menu displays a set
of contact information about the selected person (such as telephone number)
that you can configure through the CSEnvironment.properties file. You can
specify the Member Manager attributes corresponding to fields you want
to display in the person link contact information, and control the order
in which the items of information appear.
Perform the following actions:
- Modify the CSEnvironment.properties file as described in Editing
the CSEnvironment.properties file.
- Locate the CS_SERVER_PERSONTAG.businessCardItems property.
- Modify the string after the property with valid Member Manager
attributes separated by commas (,). The items appear when a person link
is clicked, top to bottom, in the same order in which you type them.
- Save the properties file.
- Restart the Portal server.
Default attributes are:
Member Manager attributes valid for including in person link contact information
Lotus Sametime chat features
You can make a Lotus Sametime Chat link available from the Person
menu in Lotus Quickr by integrating a Lotus Sametime server to support
Once the Lotus Quickr server is configured to recognize the Lotus
Sametime server, the Chat command is supported by an applet called STLinks.
The applet loads automatically in all supported browsers except Mozilla;
you can copy some files across servers to support that browser.
the page source for awareness configuration
In a browser, determine whether awareness provided by the Lotus®
Sametime® server and the STLinks applet is properly configured by examining
the page source.
When a user logs into Lotus Quickr, the Lotus Collaborative Services
checks the CSEnvironment.properties file on the Lotus Quickr server to
see whether IBM Lotus Sametime is configured. If it is, Collaborative Services
authenticates the user with the Lotus Sametime server, and builds the STLinks
applet into the user's browser.
The STLinks applet handles all awareness in Lotus Quickr. If a
portlet is enabled to show awareness, it sends names to show awareness
to STLinks. Then STLinks contacts the Lotus Sametime server directly to
determine the user's status (active, away, do not disturb, or not online),
and passes this information back to the portlet to display the user's status
in the portlet.
If the STLinks applet has loaded properly, information appears
in the source of all pages in Lotus Quickr.
Perform the following steps:
- Log into Lotus Quickr (with single sign-on enabled, logging into
Lotus Quickr also authenticates you as a user of the Lotus Sametime server).
- Select View > Source. If you see the following
information in the source, the STLinks applet is loaded:
If the STLinks applet has not loaded, see the following technote
for several tests you can perform to troubleshoot the issue:
Technote 1163790: Troubleshooting Sametime Awareness in WebSphere®
You can also use Search at IBM Support to find technotes by number.
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 the Show Profile link in the drop-down person card that
appears when users hover over a live name displays the Profile, a page
including the person's business card information followed by administrator-defined
fields organized in sections, for example, Contact Information, Current
Job, and Background. People Finder 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.
The People Finder portlet appears when users click the Find a
User link that appears at the bottom of any Lotus Quickr page when the
back-end server is J2EE.
People Finder is supported as a remote WSRP service.
up People Finder
Using the portlet's configuration mode, administrators can specify
the fields that they want to appear in the People Finder portlet. The fields
that are available for selection when configuring the portlet are based
on the Member Manager 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 more information about system requirements and configuring, using,
and testing the People Finder portlet, see PeopleFinder
in the Lotus Quickr 8.1 information center.
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 place location.
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 uses the directory configured in Lotus Quickr.
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 Lotus Quickr membership information,
or a DB2 database.
Both sets of information are controlled by the Member Manager component.
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:
For more information about system requirements and configuring,
using, and testing the Directory Search portlet, see Directory
Search in the Quickr 8.1 information center.
online awareness for a custom portlet
In a custom portlet, you can provide online awareness for users
of the portlet.
Online awareness is provided by a new AJAX-compatible version
that works with the Live Object Framework. Both awareness and pop-up menus
on objects within a custom portlet can be provided. See the Live
Object Framework overview in the Lotus Quickr 8.1 information
center to gain an understanding of how to use the framework.
< Previous |