Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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:
- URI de página del resto aspx El punto de entrada a una página .aspx
- Ubicación del libro La ruta de acceso al libro
- 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:
-
URI de página de REST aspx:
http://
<ServerName>/_vti_bin/ExcelRest.aspx
-
Ubicación del libro:
/Docs/Documents/sampleWorkbook.xlsx
-
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.
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')