通过

基本 URI 结构和路径

  • 项目

上次修改时间： 2010年4月8日

适用范围： SharePoint Server 2010

本主题说明如何在 Excel Services 中为 REST 服务命令构造 URI 结构和路径。

基本 URL 结构和路径

利用 Excel Services 中的 REST API，您能够直接通过 URL 访问工作簿中的图表、数据透视表和命名区域等资源。Excel Services 中的每个 REST URL 都由三部分构成。下面是可用来访问工作簿中资源的 URL 的基本结构：

  1. REST aspx 页 URI  .aspx 页的入口点

  2. 工作簿位置  工作簿的路径

  3. 资源位置  工作簿内部的请求资源的路径

下面是指向工作簿中特定元素的 REST URL 的构造：

http://<ServerName>/_vti_bin/ExcelRest.aspx/<DocumentLibrary>/<FileName>/<ResourceLocation>

以下示例显示 Excel Services 中合并了所有三部分后的 REST URL 的外观。在此示例中，REST URL 访问包含"SampleChart"图表的名为"sampleWorkbook.xlsx"的工作簿：

http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Charts('SampleChart')

该工作簿存储在文档库中。该工作簿的完整路径是 http://<ServerName>/Docs/Documents/sampleWorkbook.xlsx。

REST URL 的三个组成部分是：

  1. REST aspx 页 URI：http://<ServerName>/_vti_bin/ExcelRest.aspx

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

  3. 资源位置：/model/Ranges('nameOfTheNamedRange')

使用发现用户界面进行访问

您还可以通过使用发现用户界面来访问图表。若要了解如何通过使用以下屏幕快照中所示的发现机制访问图表、表、数据透视表和范围等资源，请参阅 在 Excel Services REST API 中发现。

Excel Services REST 模型 URL

标记路径

下面是 Excel Services 中的 REST 服务的 aspx 页：

http://<ServerName>/_vti_bin/ExcelRest.aspx

若要访问 Excel Services 中的 REST 服务，URL 必须以 http://<ServerName>/_vti_bin/ExcelRest.aspx 开头。

工作簿位置

工作簿位置是指包含您有兴趣访问的资源的工作簿的相对路径。例如，假定您有一个名为 sampleWorkbook.xlsx 的工作簿，保存到受信任的 SharePoint 文档库中。在此示例中，下面是 sampleWorkbook.xlsx 所在位置的路径：

http://<ServerName>/Docs/Documents/sampleWorkbook.xlsx

采用该工作簿的相对路径 (Docs/Documents/sampleWorkbook.xlsx) 并将其追加到标记路径。下面是追加了标记路径和工作簿位置的 URL：

http://<ServerName>/_vti_bin/ExcelRest.aspx

资源位置

资源位置是指工作簿内部指向所请求元素的路径。例如，如果要获取图表，则资源位置应类似于 /model/Charts('Chart 1')。

对于完整 URL，应将此路径追加到工作簿的标记路径和相对路径。下面是完整 URL 示例：

http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Charts('Chart 1')

请参阅

概念

Excel Services REST API 的资源 URI

在 Excel Services REST API 中发现