URI des ressources pour l'API REST Excel Services
Vous pouvez lier aux entités directement à l'aide de l'API REST dans Excel Services.
Remarque
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.
URL de base REST
Voici un exemple d'URL REST pour un élément spécifique dans un classeur.
http://<ServerName>/_vti_bin/ExcelRest.aspx/<DocumentLibrary>/<FileName>/<ResourceLocation>
Une URL relative de REST repose sur l'URL de base REST. Voici un exemple d'URL de REST de base à un classeur spécifique.
http://<ServerName>/_vti_bin/ExcelRest.aspx/<DocumentLibrary>/<FileName>
Par exemple, si vous avez un classeur nommé « sampleWorkbook.xlsx » dans la bibliothèque de documents suivants :
http://<ServerName>/Docs/Documents/sampleWorkbook.xlsx
L'URL de REST de base pour le classeur est la suivante :
http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx
URI de ressources
Le tableau 1 montre toutes les ressources accessibles dans l'API REST Excel Services. Pour accéder à une ressource particulière, ajoutez l'emplacement de la ressource à l'URL de REST base à un classeur.
Tableau 1. Ressources accessibles dans l’API REST Excel Services
| Emplacement de la ressource | Format | Exemple | Remarques |
|---|---|---|---|
| / modèle |
Atom (par défaut) |
/ modèle |
Renvoie un flux avec les ressources pris en charge par l'API REST Excel Services de Atom. Les ressources prises en charge sont des plages, des graphiques, des tableaux et des tableaux croisés dynamiques. |
| / modèle |
workbook |
/ modèle ? $format = classeur |
Il s'agit du classeur. Les formats de classeur pris en charge sont xlsx, xlsb et xlsm. |
| Plages/modèle / |
Atom (par défaut) |
Plages/modèle / ? $format = atom |
Un flux Atom qui listis toutes les plages nommées dans le classeur. |
| /Model/Ranges('[name]') |
HTML (par défaut) |
/model/Ranges('MyRange')?$format=html |
Un fragment HTML pour la plage demandée. |
| /Model/Ranges('[name]') |
Atom |
/model/Ranges('MyRange')?$format=atom |
Une entrée Atom qui contient la représentation XML des données au sein de la plage. |
| / modèle/graphiques |
Atom (par défaut) |
Graphiques/modèle / ? $format = atom |
Un flux Atom qui répertorie tous les graphiques dans le classeur. |
| /Model/Charts('[name]') |
Image (par défaut) |
/model/Charts('MyChart')?$format=image |
Une image du graphique. L'image est au format PNG Portable Network Graphics (). |
| / modèle/Tables |
Atom (par défaut) |
Tables/modèle / ? $format = atom |
Un flux Atom qui répertorie toutes les tables disponibles dans le classeur. |
| /Model/tables('[name]') |
HTML (par défaut) |
/model/Tables('MyTable')?$format=html |
Un fragment HTML pour la table demandée. |
| /Model/tables('[name]') |
Atom |
/model/Tables('MyTable')?$format=atom |
Une entrée Atom qui contient la représentation XML des données dans la table. |
| /model/PivotTables |
Atom (par défaut) |
/model/PivotTables?$format=atom |
Un flux Atom qui répertorie tous les tableaux croisés dynamiques disponibles dans le classeur |
| /model/PivotTables('[Name]') |
HTML (par défaut) |
/model/PivotTables('MyPivotTable)?$format=html |
Un fragment HTML du tableau croisé dynamique demandé. |
| /model/PivotTables('[Name]') |
Atom |
/model/PivotTables('MyPivotTable')?$format=atom |
Une entrée Atom qui contient une représentation XML des données contenues dans les tableaux croisés dynamiques. |
Remarque
[!REMARQUE] Excel Services limite le nombre de plages que vous pouvez inclure dans une URL à 10. Si vous incluez des plages de plus de 10 dans une URL, vous obtiendrez une erreur indiquant que le service n'est pas disponible.