最近,我尝试在自定义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/p_w_picpaths/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();
}