Lync自定义状态球webpart for SharePoint2010
2015-06-04 10:26
190 查看
原文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)
![](http://img1.51cto.com/attachment/201111/104759471.jpg)
使用“状态球”时,除了用户的名称,还有他们的个人资料页面的超链接。这会有所不同,取决于用户是否设置了主体“用户配置文件服务应用程序(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();
}
最近,我尝试在自定义Web部件中加入Lync状态球,发现它有点棘手,所以我想分享一些经验。我认为这对于在SharePoint 2010中新加入的社区功能来说,具备整合任何WebPart或其他自定义界面,是开发人员必须具备的。
在SHAREPOINT中我们该如何做呢?
每当一个用户的名字是在标准的SharePoint界面中显示,如果用户已安装的Lync2010(老版本是Office Communicator),该名称将显示Lync2010的“状态球(pawn/presence icon)
![](http://img1.51cto.com/attachment/201111/104759471.jpg)
使用“状态球”时,除了用户的名称,还有他们的个人资料页面的超链接。这会有所不同,取决于用户是否设置了主体“用户配置文件服务应用程序(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();
}
相关文章推荐
- 用CSS代码来判断浏览器是Firefox、IE6、IE7的网页特效代码
- 从WSS3.0/MOSS2007升级至SPS2010后的UI升级与降级
- 如何使用本地账户“完整”安装 SharePoint Server 2010
- php之道
- 程序员技术月刊
- Nginx_Lua
- 学习笔记 - 批处理1
- js判断undefined null Nan
- Android 实现记住用户名和密码的功能
- [Erlang]Shell中数据对齐输出
- Unity 序列帧动画
- Linux 文件系统
- vc++笔记十一
- numpy user guide 笔记
- 判断一个字符串是否含有相同字符
- 黑马程序员-博客 (2) 流程控制与数组
- crontab命令
- innodb数据库批量转换表引擎为MyISAM
- 程序员如何规避吃青春饭?【转载】
- Effective Java(第二版) 记录上