Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
In diesem Thema werden zwei Methoden zum Zugreifen auf Bereiche beschrieben: Atom-Feed und HTML-Fragment unter Verwendung der REST-API in Excel Services.
Hinweis
Die Excel Services-REST-API kann in lokalen Bereitstellungen von SharePoint und SharePoint 2016 verwendet werden. Verwenden Sie für Office 365 Education-, Business- und Enterprise-Konten die Excel-REST-APIs, die Bestandteil des Microsoft Graph-Endpunkts sind.
Zugreifen auf Bereiche
Die REST-API in Excel Services unterstützt zwei Mechanismen zum Abrufen von Bereichen. Mit dem ersten Mechanismus können Anwendungen in erster Linie auf die Rohdaten einer Arbeitsmappe zugreifen, d. h., die Rohzahlen oder -werte in einem Arbeitsblatt. Mit dem zweiten Mechanismus kann in einem Browser auf HTML-Fragmente zugegriffen werden.
Wie im Thema Ermittlung in Excel Services-REST-API beschrieben, lautet die REST-URL zur Modellseite, die die Ermittlung verwendet, wie folgt:
http://<ServerName>/_vti_bin/ExcelRest.aspx/<DocumentLibrary>/<FileName>/model
Für eine Arbeitsmappe mit dem Dateinamen sampleWorkbook.xlsx, die im Ordner http://<ServerName>/Docs/Documents/sampleWorkbook.xlsx gespeichert ist, lautet der URI zur Modellseite wie folgt:
http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model
Wenn Sie auf der Modellseite auf dem Server ( ServerName>) auf den In Excel Services-REST-API "Ermittlung in Excel Services" beschriebenen Ermittlungsmechanismus klicken, wird eine Seite angezeigt,<http:// auf der alle benannten Bereiche in der Arbeitsmappe angezeigt werden./_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model The sampleWorkbook.xlsx contains one named range, SampleNamedRange, as shown in the following screen shot:
Wichtig
Sie können auch beliebige Bereiche angeben, nicht nur die von der Suche zurückgegebenen Bereiche. Der Doppelpunkt „:“ muss durch „|“ ersetzt werden. Verwenden Sie z. B. „A1|G5“ anstelle von „A1:G5“.
Hinweis
Zeichen wie "?" und "#" werden nicht unterstützt. Um ordnungsgemäß auf Blattnamen zu verweisen, die Sonderzeichen enthalten, gilt die Grundregel "Feststellen, was der Excel-Client macht", wenn Sie in einer Formel auf ein Blatt mit Sonderzeichen verweisen, und diesem Beispiel folgen.
Ermittlung benannter Excel Services REST-Bereiche
Zugreifen auf Bereiche mithilfe eines ATOM-Feeds
Wenn Sie auf der Bereichsermittlungsseite auf SampleNamedRange klicken, navigieren Sie zur folgenden URL:
http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Ranges('SampleNamedRange')?$format=atom
Beachten Sie, dass wie im folgenden Bildschirmfoto dargestellt die resultierende Seite in Internet Explorer fehlerhaft aussieht.
Ermittlung von Excel Services REST-Bereichen mithilfe von ATOM
In Internet Explorer kann ein ATOM-Feedelement mit einem einzelnen Eintrag nicht angezeigt werden. Beim Anzeigen des Quellcodes der Seite ist jedoch das XML des Feedelements sichtbar:
<?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>
Das Feedelement enthält XML für die Daten innerhalb des Bereichs. Die folgenden XML-Elemente sind interessant:
<range> Das Range-Element. Stellt den Container des zurückgegebenen Bereichs dar.
<row> Das Row-Element. Stellt die einzelnen Zeilen im Bereich dar.
<c> Das Zellelement. Stellt die einzelnen Zellen in einer Zeile dar.
<fv> Das formatierte Wertelement. Represents the value as it is formatted by Excel. Wenn der Wert in der Arbeitsmappe vom Typ string ist, ist das formatierte Wertelement das einzige Element unter <c>.
<v> Das Value-Element. Stellt einen Zahlenwert dar. Wenn der Wert in der Zelle keine Zeichenfolge, sondern eine Zahl ist, enthält das Wertelement diese Information.
Die Verwendung von XML stellt eine einfachere Möglichkeit für den Zugriff auf Daten in einem Excel-Bereich dar. Sie können diese Methode deshalb in Ihrer Anwendung verwenden.
Zugreifen auf Bereiche mithilfe von HTML
Wenn Sie sich die URL für den Zugriff auf einen benannten Bereich mithilfe des Atom-Feeds ansehen, beachten Sie, dass der letzte Teil der URL einen Parameter namens $formatenthält, der auf atomfestgelegt ist. Dieser Parameter kann auch den Wert von htmlannehmen. Wenn Sie den atom Wert in htmländern, gibt die URL ein HTML-Fragment anstelle eines Atom-Feeds zurück. Es folgt ein Beispiel für die URL:
http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Ranges('SampleNamedRange')?$format=html
In Internet Explorer sieht die Seite ähnlich wie in der folgenden Abbildung aus.
Hinweis
Dieser HTML-Code kann in einem IFRAME-Element direkt genutzt werden. Sie können ihn aber auch in JavaScript verwenden, um ein nahtloses Arbeiten zu ermöglichen.
