通过

基本 URI 结构和路径

  • 项目

本主题介绍了如何为 Excel Services REST 服务命令构造 URI 结构和路径。

注意

Excel Services REST API 适用于本地 SharePoint 和 SharePoint 2016。 对于 Office 365 教育版、商业版和企业版帐户，请使用属于 Microsoft Graph 终结点的 Excel REST API。

基本 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 访问名为"sampleWorkbook.xlsx"的工作簿，其中包含一个名为"SampleChart"的图表：

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')

另请参阅

概念