Obtention des plages à l'aide du flux Atom et du Fragment HTML
Cette rubrique décrit deux façons d'accéder aux plages flux Atom et un fragment HTML, à 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.
Accès à des plages
L'API REST dans Excel Services prend en charge deux mécanismes pour l'obtention des plages. Le premier est utilisé essentiellement pour permettre aux applications pour atteindre les données brutes d'un classeur, autrement dit, les chiffres bruts ou les valeurs d'un tableur. La seconde consiste à obtenir des fragments HTML à partir de l'intérieur d'un navigateur.
Comme décrit dans la rubrique Découverte dans Excel Services’API REST, l’URL REST de la page de modèle à l’aide de la découverte est la suivante :
http://<ServerName>/_vti_bin/ExcelRest.aspx/<DocumentLibrary>/<FileName>/model
Par conséquent, pour un classeur avec le nom de fichier sampleWorkbook.xlsx qui est enregistré dans http://<ServerName>/Docs/Documents/sampleWorkbook.xlsx, voici l'URI de la page modèle :
http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model
À l’aide du mécanisme de découverte décrit dans Découverte dans Excel Services’API REST, si vous cliquez sur le flux Ranges Atom sur la page du modèle sur le serveur ( http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model), une page affiche toutes les plages nommées dans le classeur. La sampleWorkbook.xlsx contient une plage nommée, SampleNamedRange, comme illustré dans la capture d'écran suivante :
Importante
[!IMPORTANTE] Vous pouvez également spécifier les plages arbitraires et pas seulement les plages renvoyés par la découverte. Signe deux-points « : » doit être remplacé par « | ». Par exemple, utilisez « A1 | G5 » plutôt que « A1 : G5 ».
Remarque
Les caractères tels que « ? » et « # » ne sont pas pris en charge. Pour référencer correctement les noms de feuille qui contiennent des caractères spéciaux, la recommandation de base est « voir ce que fait le client Excel » lorsque vous référencez une formule à une feuille avec des caractères spéciaux et suivez cet exemple.
Découverte de plage nommée REST Excel Services
Accès à des plages à l'aide d'un Atom flux
Si vous cliquez sur SampleNamedRange dans la page de détection de plage, vous accédez à l'URL suivante :
http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Ranges('SampleNamedRange')?$format=atom
Notez que, dans Internet Explorer, la page qui en résulte se présente comme une erreur, comme illustré dans la capture d'écran suivante.
Découverte de plage REST Excel Services à l'aide d'Atom
Internet Explorer ne peut pas afficher une seule entrée que élément de flux Atom. Mais affichant la source de la page suivant illustre le code XML figurant dans l'élément de flux :
<?xml version="1.0" encoding="utf-8"?>
<entry xmlns:x="http://schemas.microsoft.com/office/2008/07/excelservices/rest" xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservice" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns="http://www.w3.org/2005/Atom">
<title type="text">SampleNamedRange</title>
<id>http://ServerName/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Ranges('SampleNamedRange')</id>
<updated>2010-01-20T21:28:10Z</updated>
<author>
<name />
</author>
<link rel="self" href="http://ServerName/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Ranges('SampleNamedRange')?$format=atom" title="SampleNamedRange" />
<category term="ExcelServices.Range" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
<content type="application/xml">
<x:range name="SampleNamedRange">
<x:row>
<x:c>
<x:fv>Performance</x:fv>
</x:c>
<x:c>
<x:v>26</x:v>
<x:fv>26</x:fv>
</x:c>
<x:c />
</x:row>
<x:row>
<x:c>
<x:fv>Employment</x:fv>
</x:c>
<x:c>
<x:v>42</x:v>
<x:fv>42</x:fv>
</x:c>
<x:c />
</x:row>
<x:row>
<x:c>
<x:fv>Earnings And Job Quality</x:fv>
</x:c>
<x:c>
<x:v>22</x:v>
<x:fv>22</x:fv>
</x:c>
<x:c />
</x:row>
... XML truncated for brevity.
<x:row>
<x:c>
<x:fv>Innovation Assets</x:fv>
</x:c>
<x:c>
<x:v>43</x:v>
<x:fv>43</x:fv>
</x:c>
<x:c />
</x:row>
<x:row>
<x:c />
<x:c>
<x:fv>State</x:fv>
</x:c>
<x:c />
</x:row>
</x:range>
</content>
</entry>
L'élément de flux contient du code XML qui représente les données à l'intérieur de la plage. Voici les éléments XML d'intérêt :
<range> Élément range. Represents the container of the returned range.
<row> L’élément row. Represents each row in the range.
<c> Élément de cellule. Represents each cell in a row.
<fv> Élément de valeur mis en forme. Represents the value as it is formatted by Excel. Si la valeur est de type chaîne dans le classeur, l’élément de valeur mis en forme est le seul élément sous <c>.
<v> Élément value. Represents a number value. If the value in the cell is a number instead of a string, the value element contains that information.
Utilisation du format XML vous offre un moyen plus simple pour obtenir des données à partir d'une plage Excel afin que vous pouvez l'utiliser dans votre application.
Accès à des plages en utilisant HTML
Si vous examinez l’URL pour accéder à une plage nommée à l’aide du flux Atom, notez que la dernière partie de l’URL contient un paramètre appelé $format, qui est défini sur atom. Ce paramètre peut également prendre la valeur de html. Si vous remplacez la valeur htmlpar atom , l’URL retourne un fragment HTML au lieu d’un flux Atom. Vous trouverez ci-dessous un exemple d'URL :
http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Ranges('SampleNamedRange')?$format=html
Dans Internet Explorer, la page ressemble à la figure suivante.
Remarque
[!REMARQUE] Ce code HTML pouvant être consommé directement dans une IFRAME, ou elle peut être utilisée dans JavaScript pour créer une expérience plus transparente.
