Freigeben über

Grundlegende URI-Struktur und Pfad

  • Artikel

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:

  1. REST aspx Page URI The entry point to an .aspx page
  2. Speicherort der Arbeitsmappe Der Pfad zu der Arbeitsmappe
  3. Speicherort der Ressource Der Pfad zu der angeforderten Ressource in der Arbeitsmappe

Im Anschluss finden Sie das Konstrukt für die REST-URL zu einem bestimmten 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 folgende:

  1. REST-URI zur "ASPX"-Seite: http://<ServerName>/_vti_bin/ExcelRest.aspx
  2. Speicherort der Arbeitsmappe: /Docs/Documents/sampleWorkbook.xlsx
  3. 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 Zugreifen auf Ressourcen wie Diagramme, Tabellen, PivotTables und Bereiche mithilfe des im folgenden Screenshot gezeigten Ermittlungsmechanismus finden Sie unter Ermittlung in excel Services-REST-API.

Excel Services REST-Modell-URL

Markierungspfad

Nachfolgend sehen Sie die ASPX-Seite für den REST-Dienst in Excel Services:

http://<ServerName>/_vti_bin/ExcelRest.aspx

Für den Zugriff auf den REST-Dienst in Excel Services müssen Sie der URL http://<ServerName voranstellen>/_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')

Siehe auch

Konzepte