SharePoint Excel Services REST API介紹

Excel Services 中的 REST API 是 Microsoft SharePoint Server 2010 的新增項(xiàng)。利用 REST API，可通過 URL 直接訪問工作簿部件或元素。

一、REST 服務(wù)基于兩個要求：

用于定位網(wǎng)絡(luò)資源的尋址方案

用于返回這些資源的表示形式的方法

二、REST URL基本URI的三個組成部分是：

REST aspx 頁 URI：http:///_vti_bin/ExcelRest.aspx

工作簿位置：/Docs/Documents/sampleWorkbook.xlsx

資源位置：/model/Ranges('nameOfTheNamedRange')

三、API簡單應(yīng)用及示例：

1、單元格展示：

例：http://URL/_vti_bin/ExcelRest.aspx/DocLib1/ExcelTest.xlsx/model/Ranges('A1')

附：完整的Excel

2、圖表展示

例：特別說明” %E5%9B%BE%E8%A1%A8%201”==”圖表 1”的意思，經(jīng)過Url編碼

http://URL/_vti_bin/ExcelRest.aspx/DocLib1/ExcelTest.xlsx/Model/Charts('%E5%9B%BE%E8%A1%A8%201')

附：原來的Excel截屏

3、單元格范圍展示（Excel如上圖，范圍選擇不會展示出圖表）

例：http://URL/_vti_bin/ExcelRest.aspx/DocLib1/ExcelTest.xlsx/Model/Ranges('A1|M5')

特：Sheet2!A1%7CM5，標(biāo)下劃線部分，可以選擇工作表，半角感嘆號分隔；

4、單元格范圍展示并設(shè)置一個單元格的值

例：（原Excel如上面Excel所示）http://URL/_vti_bin/ExcelRest.aspx/DocLib1/ExcelTest.xlsx/Model/Ranges('Sheet2!A1%7CN5')?Ranges('Sheet2!N2')=88&Ranges('Sheet2!N3')=98

四、返回atom的XML格式

　　通過返回的XML文件，我們可以在代碼中進(jìn)行下一步的Coding，可以基于一個發(fā)布的Excel文件進(jìn)行統(tǒng)計(jì)、展示等。

例：（$format=atom參數(shù)）

http://URL/_vti_bin/ExcelRest.aspx/DocLib1/ExcelTest.xlsx/Model/Ranges('Sheet2!A1%7CN5')?Ranges('Sheet2!N2')=88&Ranges('Sheet2!N3')=98&$format=atom

右鍵查看源文件：

特：由于完整的XML代碼所占篇幅太多，所以只截取當(dāng)前屏幕，敬請見諒！

五、Excel Services REST API 中不受支持的功能

　　以下是 Excel Services REST API 中當(dāng)前不支持或未使用的多個重要功能的部分列表：

· 無浮動圖。如果一個范圍包含圖，并且您通過 REST 請求該范圍，則只會獲取該范圍。

· 無迷你圖，無圖標(biāo)條件格式。當(dāng)前不受支持。

· 無像素（理想 EWA）。REST 生成的 HTML 與 Excel Web Access 生成的 HTML 很相似。但 Excel Services REST API 無法訪問 Excel Web Access 可訪問的所有級聯(lián)樣式表 (CSS) 元素。Excel Services REST API 返回一個 HTML 片段。此 HTML 片段必須是自包含的。

· 表中不存在差異。當(dāng)以 Atom 的形式請求表以查看單元格或數(shù)據(jù)是列標(biāo)題、總計(jì)還是常規(guī)數(shù)據(jù)時，表中不會產(chǎn)生任何差異。也就是說，不存在指定單元格或數(shù)據(jù)是標(biāo)題、總計(jì)還是常規(guī)數(shù)據(jù)的差異。將平等對待表中的所有表單元格。

· URL 大小限制。URL 大小將限制在約 2000 個字符。這意味著，如果工作簿中有大量參數(shù)，則可能無法設(shè)置所有參數(shù)。特別是在工作簿位于文件夾結(jié)構(gòu)的較低位置時會出現(xiàn)此情況。

· 特殊字符。不支持如“?”和“#”這樣的字符。若要正確引用包含特殊字符的工作表名稱，則向帶特殊字符的工作表引用公式時，基本原則是“了解 Excel 客戶端執(zhí)行什么操作”，并遵循相應(yīng)示例。

結(jié)束語：

　　本文為參考MSDN的sdk文檔，做的簡單示例，如有疑問請參考附后的參考文獻(xiàn)；對于Excel Services REST API了解了一下，推翻了以前認(rèn)為Excel Services只能Web展示的印象，其實(shí)還可以基于這個功能，簡單開發(fā)一些新的應(yīng)用。