Structure et chemin d’accès de l’URI de base
Dernière modification : jeudi 8 avril 2010
S’applique à : SharePoint Server 2010
Cette rubrique explique comment construire la structure et le chemin d’accès URI pour les commandes de service REST dans Excel Services.
Structure et chemin d’accès de l’URL de base
L’API REST dans Excel Services vous offre la possibilité d’accéder à des ressources comme graphiques, tableaux croisés dynamiques, tables et plages nommées dans un classeur, directement via une URL. Chaque URL REST dans Excel Services est constituée de trois parties. Voici la structure de base de l’URL pour accéder aux ressources dans un classeur :
URI de page aspx REST Point d’entrée à une page .aspx
Emplacement du classeur Chemin d’accès au classeur
Emplacement de la ressource Chemin d’accès à la ressource voulue à l’intérieur du classeur
Voici la construction de l’URL REST vers un élément spécifique dans un classeur :
http://<ServerName>/_vti_bin/ExcelRest.aspx/<DocumentLibrary>/<FileName>/<ResourceLocation>
Voici un exemple d’URL REST dans Excel Services avec les trois parties combinées. Dans cet exemple, l’URL REST accède à un classeur appelé sampleWorkbook.xlsx contenant 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 d’accès complet au classeur est http://<ServerName>/Docs/Documents/sampleWorkbook.xlsx.
Les trois parties de l’URL REST sont :
URI de page aspx REST : 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 découverte
Vous pouvez également accéder au graphique en utilisant l’interface utilisateur de découverte. Pour savoir comment accéder à des ressources comme graphiques, tables, tableaux croisés dynamiques et plages en utilisant le mécanisme de découverte affiché dans la capture d’écran suivante, voir Découverte dans l’API REST d’Excel Services.
.gif "Excel Services REST - URL du modèle")
Chemin d’accès au marqueur
Voici la page aspx du 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 du préfixe http://<ServerName>/_vti_bin/ExcelRest.aspx.
Emplacement du classeur
L’emplacement du classeur est le chemin d’accès relatif au classeur contenant les ressources auxquelles vous voulez accéder. Par exemple, supposons que vous ayez un classeur nommé sampleWorkbook.xlsx, enregistré dans une bibliothèque de documents SharePoint approuvée. Dans cet exemple, le chemin d’accès au classeur sampleWorkbook.xlsx est :
http://<ServerName>/Docs/Documents/sampleWorkbook.xlsx
Vous ajoutez le chemin d’accès relatif au classeur (Docs/Documents/sampleWorkbook.xlsx) en suffixe du chemin d’accès au marqueur. L’URL avec le chemin d’accès au marqueur et en suffixe l’emplacement du classeur est :
http://<ServerName>/_vti_bin/ExcelRest.aspx
Emplacement de la ressource
L’emplacement de la ressource est le chemin d’accès à l’intérieur du classeur vers l’élément voulu. Par exemple, si vous voulez accéder à un graphique, l’emplacement de la ressource serait similaire à /model/Charts('Chart 1').
Pour obtenir l’URL complète, vous ajoutez ce dernier en fin du chemin d’accès au marqueur suivi du chemin d’accès relatif au classeur. L’URL complète de l’exemple est :
http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Charts('Chart 1')