Grundlegende URI-Struktur und Pfad
In diesem Thema wird erläutert, wie Sie die URI-Struktur und den Pfad für die Befehle des REST-Diensts in Excel Services erstellen.
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.
Grundlegende URL-Struktur und Pfad
Die REST-API in Excel Services ermöglicht den Zugriff auf Ressourcen wie Diagramme, PivotTables, Tabellen und benannte Bereiche in einer Arbeitsmappe direkt über eine URL. Jede REST-URL in Excel Services besteht aus drei Teilen. Im Anschluss finden Sie die grundlegende Struktur der URL für den Zugriff auf die Ressourcen in der Arbeitsmappe:
- REST-URI zur ASPX-Seite Der Einstiegspunkt zu einer ASPX-Seite
- Speicherort der Arbeitsmappe Der Pfad zu der Arbeitsmappe
- Speicherort der Ressource Der Pfad zu der angeforderten Ressource in der Arbeitsmappe
Es folgt das Konstrukt für die REST-URL für ein bestimmtes Element in einer Arbeitsmappe:
http://<ServerName>/_vti_bin/ExcelRest.aspx/<DocumentLibrary>/<FileName>/<ResourceLocation>
Following is an example of how a REST URL in Excel Services looks with all three parts combined. In this example, the REST URL is accessing a workbook called "sampleWorkbook.xlsx" that contains a chart called "SampleChart":
http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Charts('SampleChart')
Die Arbeitsmappe ist in einer Dokumentbibliothek gespeichert. Der vollständige Pfad zur Arbeitsmappe ist http://<ServerName>/Docs/Documents/sampleWorkbook.xlsx.
Die drei Teile der REST-URL sind:
- REST-URI zur "ASPX"-Seite:
http://<ServerName>/_vti_bin/ExcelRest.aspx - Speicherort der Arbeitsmappe:
/Docs/Documents/sampleWorkbook.xlsx - Speicherort der Ressource:
/model/Ranges('nameOfTheNamedRange')
Zugriff unter Verwendung der Discovery-Benutzeroberfläche
Sie können auf das Diagramm auch unter Verwendung der Discovery-Benutzeroberfläche zugreifen. Informationen zum Zugriff auf Ressourcen wie Diagramme, Tabellen, PivotTables und Bereiche mithilfe des im folgenden Screenshot gezeigten Ermittlungsmechanismus finden Sie unter Ermittlung in Excel Services REST-API.
Markierungspfad
Nachfolgend sehen Sie die ASPX-Seite für den REST-Dienst in Excel Services:
http://<ServerName>/_vti_bin/ExcelRest.aspx
Um auf den REST-Dienst in Excel Services zugreifen zu können, müssen Sie der URL http://<ServerName voran stellen>/_vti_bin/ExcelRest.aspx.
Speicherort der Arbeitsmappe
The workbook location is the relative path to the workbook that has resources that you are interested in accessing. For example, assume that you have a workbook named sampleWorkbook.xlsx, saved to a trusted SharePoint document library. In this example, following is the path to the location of sampleWorkbook.xlsx:
http://<ServerName>/Docs/Documents/sampleWorkbook.xlsx
Sie nehmen den relativen Pfad zu der Arbeitsmappe ( Docs/Documents/sampleWorkbook.xlsx) und hängen diesen an den Markierungspfad an. Im Anschluss finden Sie die URL mit angehängtem Markierungspfad und angehängtem Speicherort der Arbeitsmappe:
http://<ServerName>/_vti_bin/ExcelRest.aspx
Speicherort der Ressource
Der Speicherort der Ressource ist der Pfad innerhalb der Arbeitsmappe zu dem gewünschten Element. Wenn Sie z. B. ein Diagramm abrufen möchten, wäre der Ressourcenspeicherort ähnlich /model/Charts('Chart 1')wie .
Um die vollständige URL zu erhalten, hängen Sie dieses an den Markierungspfad und den relativen Pfad zu der Arbeitsmappe an. Die vollständige Beispiel-URL sieht dann folgendermaßen aus: :
http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Charts('Chart 1')