Lync自定义状态球webpart for SharePoint2010

ls0398

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

　　你可以很方便的从“SPWeb.SiteUserInfoList'这个列表中获取到这个属性。这代表用户信息列表的SPList对象。从这里你只需要找到代表你想显示的用户的对象，。要做到这一点的最好办法是通过ID（列表项的ID）调用SPWeb.SiteUserInfoList.GetItemById([int User's>　　在大多数情况下，你可能会从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(

　　"　　, sipAddress
　　, "\">"

　　, "　　, sipAddress

　　, "')\" ShowOfflinePawn=\"1\" style=\"padding-right: 3px;\">　　, sipAddress

　　, "\">　　, sipAddress
　　, "\"/>"
　　, "　　, sipAddress
　　, "\">"
　　, uv.User.Name
　　, ""
　　));
　　}
　　}
　　return html.ToString();
　　}