Posts Tagged ‘Presence Indicator’

How to Display Presence Indicator in Custom Webparts

March 21, 2012 4 comments

SharePoint Server 2010 gives the ability to identify the status of co-works or site members if they online , busy, or away by integrating with Presence Indicator Information concept.  smart tag appears next to the user name to display the user status .

The key piece of information to make the presence work is the user’s SIP Address which is basically their IM address (This is not always the same as email address). When a users is either added to a site in SharePoint or has their profile imported, the SIP Address will be drawn from Active Directory which is where OCS stores it and placed into the SIP address field in either the user’s profile which will in turn synchronise down to the site’s local ‘User Information’ page.

The pawn is basically an IMG element which has “IMNRC(‘[user’s SIP Address]’)” for the onload function. This will user client-side script that is part of Office to load the presence pawn on the page.

The hyperlink on the user’s name is just a simple A element which redirects to “/_layouts/userdisp.aspx?ID=[User’s local user information list item ID]”. This userdisp.aspx page will then redirect to the user’s main profile page if they have a profile, otherwise it will display the basic information that the user information list item stores.

How to get the SIP Address?

Hopefully you’ll have spotted by now that the presence pawn relies on the user’s SIP Address. To get the SIP address you need to get the user’s User Information list item from the local site’s (SPWeb to be precise) SiteUserInfoList which is basically a hiddenSPList that is in every web.

There is a handy property to get you to this list called ‘SPWeb.SiteUserInfoList’. This will give you an SPList object which represents the User Information list. From here you just need to find the item that represents the user you wish to display. The best way to do this is via their ID (the ID of the list item) by calling SPWeb.SiteUserInfoList.GetItemById([int User’s ID]), however you can also use a variety of other methods which use SPQuery or match a specific field to a value.

In most scenarios, you may be getting the user information from a SPFieldUserValueCollection which is basically the field type that is used for ‘Person’ fields. If this is the case you can use SPFieldUserValue.LookupId to get the ID of the user’s User Information list item.

Putting it all together

This code sample is a method that accepts an SPFieldUserValueCollection and SPSite as inputs and returns back the HTML for displaying each entry in the SPFieldUserValueCollection with the presence pawn and link to their profile. This will be presented exactly as SharePoint presents it by default. This could be extended to use ALT tags in the IMG and A elements.

I then simply add the HTML to an HtmlWriter or in my case a TableCell.Text property to display it on screen.

I’ve take a few extra steps here by adding ID and alt tags and trying to make the code readable, but I’m sure you get the idea:

public string GetPresenceHTMLFromUVC(SPSite thisSite, SPFieldUserValueCollection uvc)
StringBuilder html = new StringBuilder(“”);
using (SPWeb thisWeb = thisSite.RootWeb)
foreach (SPFieldUserValue uv in uvc)
string sipAddress = “”;
//Get the sip address if it exists
SPListItem user = thisWeb.SiteUserInfoList.GetItemById(uv.LookupId);
if (user[“SipAddress”] != null)
sipAddress = user[“SipAddress”].ToString();
//construct the html for this user and add to overall html
“<div id\”PresenceLink”
, sipAddress
, “\”>”
, “<img border=\”0\” height=\”12\” src=\”/_layouts/images/imnhdr.gif\” onload=\”IMNRC(‘”
, sipAddress
, “‘)\” ShowOfflinePawn=\”1\” style=\”padding-right: 3px;\” id=\”PresencePawn”
, sipAddress
, “\” alt=\”presence pawn for ”
, sipAddress
, “\”/>”
, “<a href=\””
, thisWeb.Url
, “/_layouts/userdisp.aspx?ID=”
, uv.LookupId
, “\” id=\”ProfileLink”
, sipAddress
, “\”>”
, uv.User.Name
, “</a></div>”
return html.ToString();