Lync自定义状态球webpart for SharePoint2010

原文link: http://blogs.msdn.com/b/uksharepoint/archive/2010/05/07/office-communicator-integration-presence-in-a-custom-webpart-for-sharepoint-2010.aspx

       最近，我尝试在自定义Web部件中加入Lync状态球，发现它有点棘手，所以我想分享一些经验。我认为这对于在SharePoint 2010中新加入的社区功能来说，具备整合任何WebPart或其他自定义界面，是开发人员必须具备的。
        在SHAREPOINT中我们该如何做呢？

        每当一个用户的名字是在标准的SharePoint界面中显示，如果用户已安装的Lync2010（老版本是Office Communicator），该名称将显示Lync2010的“状态球(pawn/presence icon)

 

       使用“状态球”时，除了用户的名称，还有他们的个人资料页面的超链接。这会有所不同，取决于用户是否设置了主体“用户配置文件服务应用程序（User Profile Service Application）”。如果用户有一个配置文件，那么超链接将根据我的网站将重定向到用户的个人资料页。如果用户没有配置文件，超链接将重定向到SharePoint Foundation的“用户信息（User Information）”页。站点中的所有用户都拥有一个“用户信息”页面，如果他们同时还有一个用户配置文件，那么“计时器作业（timer job）”将从配置文件中设置同步，从而将用户信息同步到用户信息页面上去。

      使“状态球”正常工作的关键部分是用户的SIP地址，这一般就是他们的IM地址（这不一定是与电子邮件地址相同）。当一个用户无论是添加在SharePoint的网站或拥有自己的个人资料进口，SIP地址将从来自AD中的信息制定Lync2010中的信息，并向下同步到本地网站的“用户信息”页面。

 “状态球”是如何在HTML方面运行的？

“状态球”基本上是一个拥有onload函数"IMNRC('[user's SIP Address]')"的IMG元素。这是一个加载在页面上的Office客户端脚本。

用户的名称上的超链接只是一个简单的一个元素，它重定向到"/_layouts/userdisp.aspx?ID=[User's local user information list item ID]"。这userdisp.aspx页会重定向到用户的个人资料页，前提是如果他们有一个配置文件，如果没有就只会显示用户信息列表项中的基本信息。

如何获取SIP地址？

这时你会发现，“状态球”的功能依赖用户的SIP地址。要获得的SIP地址，你需要从本地的网站（SPWeb要具体且精确）中的SiteUserInfoList里面获得用户的用户信息列表条目，在每一个Web站点中基本上都存在这样一个隐藏SPList。

你可以很方便的从“SPWeb.SiteUserInfoList'这个列表中获取到这个属性。这代表用户信息列表的SPList对象。从这里你只需要找到代表你想显示的用户的对象，。要做到这一点的最好办法是通过ID（列表项的ID）调用SPWeb.SiteUserInfoList.GetItemById([int User's ID])，当然你也可以使用多种其他方法使用SPQuery进行查询。

在大多数情况下，你可能会从SPFieldUserValueCollection得到'person'字段类型的字段信息。如果是这样的话，你可以使用SPFieldUserValue.LookupId得到User Information list 的条目ID。

让我们把它们揉在一起...

下面的示例代码是一个方法，接受一个SPFieldUserValueCollectionh和SPSite作为输入参数，返回一个能够显示并链接到他们的个人资料显示每个条目的“状态球”功能的HTML代码段。这将在SharePoint上呈现默认的“状态球”功能。你还可以以延用ALT标签功能元素。

然后，我只需添加HTML到一个HtmlWriter或一个TableCell.Text属性，把我的情况显示在屏幕上。

我已经采取了一些额外的步骤加入ID和ALT标记，并尽量使代码更具可读性，但我敢肯定你有更好的想法：

public string GetPresenceHTMLFromUVC(SPSite thisSite, SPFieldUserValueCollection uvc)
{
StringBuilder html = new StringBuilder("");
using (SPWeb thisWeb = thisSite.RootWeb)
{
foreach (SPFieldUserValue uv in uvc)
{
string sipAddress = "";
//获取SIP 地址，如果它存在的话
SPListItem user = thisWeb.SiteUserInfoList.GetItemById(uv.LookupId);
if (user["SipAddress"] != null)
{
sipAddress = user["SipAddress"].ToString();
}
//为当前用户构建HTML片段并加入到完整的HTML片段当中
html.Append(String.Concat(
"<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();
}