最近,我嘗試在自定義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();
}