Chemin d'accès et la Structure des URI de base
Cette rubrique explique comment construire la structure et le chemin d’accès de l’URI pour les commandes du service REST dans Excel Services.
Notes
L’API REST Excel Services s’applique à l’environnement local SharePoint et SharePoint 2016. Pour les comptes Office 365 Éducation, Business et Entreprise, utilisez les API REST Excel qui font partie du point de terminaison Microsoft Graph.
Structure et chemin d’accès des URL de base
L'API REST dans Excel Services vous donne la possibilité d'accéder aux ressources telles que des graphiques, des tableaux croisés dynamiques, des tableaux et des plages nommées dans un classeur directement via une URL. Chaque URL REST dans Excel Services est construite de trois parties. Voici la structure de base de l'URL pour accéder aux ressources dans un classeur :
- REST aspx URI de la Page Le point d'entrée vers une page .aspx
- Emplacement du classeur Le chemin d'accès au classeur
- Emplacement de la ressource Le chemin d'accès à la ressource demandée à l'intérieur du classeur
Vous trouverez ci-dessous la construction de l'URL REST pour un élément spécifique dans un classeur :
http://<ServerName>/_vti_bin/ExcelRest.aspx/<DocumentLibrary>/<FileName>/<ResourceLocation>
Vous trouverez ci-dessous un exemple de l'aspect d'un URL REST dans Excel Services avec tous les trois parties combinées. Dans cet exemple, l'URL de REST accède à un classeur nommé « sampleWorkbook.xlsx » qui contient un graphique appelé « SampleChart » :
http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Charts('SampleChart')
Le classeur est stocké dans une bibliothèque de documents. Le chemin complet du classeur est http://<ServerName>/Docs/Documents/sampleWorkbook.xlsx.
Les trois parties de l'URL de REST sont les suivants :
-
URI de page REST aspx :
http://<ServerName>/_vti_bin/ExcelRest.aspx -
Emplacement du classeur:
/Docs/Documents/sampleWorkbook.xlsx -
Emplacement de la ressource:
/model/Ranges('nameOfTheNamedRange')
Accès à l’aide de l’interface utilisateur de la découverte
Vous pouvez également accéder le graphique à l'aide de l'interface utilisateur de la détection. Pour savoir comment accéder à des ressources telles que des graphiques, des tableaux, des tableaux croisés dynamiques et des plages à l’aide du mécanisme de découverte illustré dans la capture d’écran suivante, voir Découverte dans l’API REST Excel Services.
Chemin d’accès du marqueur
Voici la page aspx pour le service REST dans Excel Services:
http://<ServerName>/_vti_bin/ExcelRest.aspx
Pour accéder au service REST dans Excel Services, vous devez faire précéder l’URL de http://<ServerName>/_vti_bin/ExcelRest.aspx.
Emplacement du classeur
L'emplacement du classeur est le chemin d'accès relatif au classeur qui a que vous êtes intéressé par l'accès à des ressources. Par exemple, supposons que vous disposez d'un classeur nommé sampleWorkbook.xlsx, enregistré dans une bibliothèque de documents SharePoint approuvée. Dans cet exemple, voici le chemin d'accès à l'emplacement du sampleWorkbook.xlsx :
http://<ServerName>/Docs/Documents/sampleWorkbook.xlsx
Vous prendre le chemin d'accès relatif au classeur ( Docs/Documents/sampleWorkbook.xlsx) et annexiez le chemin d'accès du marqueur. Voici l'URL avec l'emplacement de chemin d'accès et le classeur marqueur ajouté :
http://<ServerName>/_vti_bin/ExcelRest.aspx
Emplacement de la ressource
L'emplacement de la ressource est le chemin d'accès au sein du classeur à l'élément que vous demander. Par exemple, si vous souhaitez obtenir un graphique, l’emplacement de la ressource est similaire à /model/Charts('Chart 1').
Pour l'URL complète, vous ajoutez ce pour le chemin d'accès de marqueur et le chemin d'accès relatif au classeur. Voici l'URL complète d'exemple :
http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Charts('Chart 1')