Compartir a través de

Ruta de acceso y estructura URI básico

Este tema explica cómo construir la estructura URI y la ruta de acceso para los comandos de servicio de REST en Excel Services.

Nota:

La API de REST de Excel Services se aplica a SharePoint y a SharePoint 2016 local. Para las cuentas de Office 365 Educación, Empresa y Enterprise, use las API de REST de Excel que forman parte del punto de conexión de Microsoft Graph.

Ruta de acceso y estructura básica de dirección URL

La API de REST en Servicios de Excel da la posibilidad de tener acceso a recursos como gráficos, tablas dinámicas, tablas y rangos con nombre en un libro directamente a través de una dirección URL. Cada dirección URL de REST en Servicios de Excel se construye de tres partes. Siguiente es la estructura básica de la dirección URL para tener acceso a los recursos de un libro:

  1. URI de página del resto aspx El punto de entrada a una página .aspx
  2. Ubicación del libro La ruta de acceso al libro
  3. Ubicación de recursos La ruta de acceso al recurso solicitado dentro del libro

La siguiente es la construcción de la dirección URL de REST a un elemento específico de un libro:

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

Siguiente es un ejemplo del aspecto de una dirección URL de REST en Servicios de Excel con las tres partes que se combinan. En este ejemplo, la dirección URL de REST tiene acceso a un libro llamado "sampleWorkbook.xlsx" que contiene un gráfico llamado "SampleChart":

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

The workbook is stored in a document library. La ruta de acceso completa al libro es http://<ServerName>/Docs/Documents/sampleWorkbook.xlsx.

Las tres partes de la dirección URL de REST son:

  1. URI de página de REST aspx: http://<ServerName>/_vti_bin/ExcelRest.aspx
  2. Ubicación del libro: /Docs/Documents/sampleWorkbook.xlsx
  3. Ubicación de recursos: /model/Ranges('nameOfTheNamedRange')

Acceso mediante la interfaz de usuario de descubrimiento

También puede tener acceso al gráfico mediante la interfaz de usuario de descubrimiento. Para obtener información sobre cómo acceder a recursos como gráficos, tablas, tablas dinámicas e intervalos mediante el mecanismo de detección que se muestra en la siguiente captura de pantalla, consulte Detección en la API REST de Excel Services.

Dirección URL de modelo de REST de Servicios de Excel

Ruta de marcador

Siguiente es la página aspx para el servicio de resto en Servicios de Excel:

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

Para acceder al servicio REST en Excel Services, debe prefase la dirección URL con http://<ServerName>/_vti_bin/ExcelRest.aspx.

Ubicación de libros

La ubicación del libro es la ruta de acceso relativa al libro con el que está interesado en tener acceso a los recursos. Por ejemplo, suponga que tiene un libro denominado sampleWorkbook.xlsx, guardado en una biblioteca de documentos de SharePoint confianza. En este ejemplo, la siguiente es la ruta a la ubicación de sampleWorkbook.xlsx:

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

Seguir la ruta de acceso relativa para el libro ( Docs/Documents/sampleWorkbook.xlsx) y anexarla a la ruta de acceso de marcador. Siguiente es la dirección URL con la ubicación de ruta de acceso y libro de marcador anexada:

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

Ubicación de recursos

La ubicación del recurso es la ruta de acceso dentro del libro en el elemento que se solicita. Por ejemplo, si desea obtener un gráfico, la ubicación del recurso sería similar a /model/Charts('Chart 1').

Para la dirección URL completa, anexa a la ruta de acceso de marcador y la ruta de acceso relativa al libro. Siguiente es la dirección URL de ejemplo completo:

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

Vea también

Conceptos