Freigeben über


Verwenden der Excel Services 2010-REST-API

SharePoint-Schnellstartbanner
Erste Schritte mit der Webentwicklung in SharePoint 2010: Informationen zum Zugreifen auf Elemente und Arbeiten mit Daten in einer Kalkulationstabelle mithilfe der Excel Services-REST-API.

Letzte Änderung: Donnerstag, 27. Januar 2011

Gilt für: Excel Services | Office 2010 | SharePoint Foundation 2010 | SharePoint Server 2010 | Visual Studio 2010

Inhalt dieses Artikels
Ermitteln von Elementen in einer Arbeitsmappe
Abrufen verschiedener Elemente in unterschiedlichen Formaten
Ändern von Datenwerten
Nächste Schritte

Die Excel Services 2010-REST-API ist ein neues Programmierframework, mit dem Sie auf einfache Weise Daten und Objekte in einer Kalkulationstabelle ermitteln und darauf zugreifen können. Wenn Sie eine URL schreiben können, können Sie die REST-API verwenden. Die REST-API kann demnach von Nicht-Entwicklern verwendet werden, weist aber Funktionen auf, die sie für professionelle Entwickler zu einem sehr leistungsfähigen Tool machen. In diesem Szenario finden Sie mehrere Beispiele, wie Sie mit der REST-API auf Objekte zugreifen und mit Dateien in einer Arbeitsmappe auf einer SharePoint 2010-Website arbeiten. Für dieses Szenario müssen Sie die folgenden Schritte ausführen:

  • Ermitteln von Elementen in einer Arbeitsmappe

  • Abrufen verschiedener Elemente in unterschiedlichen Formaten

  • Ändern von Datenwerten

Bei diesem Szenario wird davon ausgegangen, dass eine Arbeitsmappe mit dem Namen Sales_Report.xlsx vorhanden ist, die in einer Dokumentbibliothek auf einer SharePoint 2010-Website gespeichert ist. Die Arbeitsmappe enthält zwei Bereiche, ein Diagramm, eine Tabelle und eine PivotTable.

Ermitteln von Elementen in einer Arbeitsmappe

Für diese Aufgabe ermitteln Sie mithilfe der REST-API verschiedene Objekte in der Beispielarbeitsmappe. Dabei wird davon ausgegangen, dass die Arbeitsmappe im Verzeichnis http://myserver/mywebsite/shared%20documents/Sales_Report.xlsx gespeichert ist.

So ermitteln Sie Elemente in der Arbeitsmappe

  1. Öffnen Sie die Website mit der Arbeitsmappe in einem Browser.

  2. Fügen Sie der URL im Adressfeld des Browsers _vti_bin/ExcelRest.aspx/ nach dem Websitenamen hinzu, sodass die URL ähnlich wie im folgenden Beispiel aussieht.

    http://myserver/mywebsite/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx

  3. Fügen Sie nach dem Namen der Arbeitsmappe das Wort Model hinzu. Die URL sollte wie im folgenden Beispiel aussehen.

    http://myserver/mywebsite/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx/Model

  4. Drücken Sie die EINGABETASTE. Nach ein paar Sekunden wird im Browser eine Seite ähnlich wie in Abbildung 1 in einem ATOM-Feedformat angezeigt.

    Abbildung 1. Von der REST-API zurückgegebene Webseite

    Von der REST-API wird diese Webseite zurückgegeben

Derzeit ermöglicht die REST-API den Zugriff auf Bereiche, Diagramme, Tabellen und PivotTables. Die REST-API gibt Elemente in den folgenden Formaten zurück:

  • Bild

  • HTML

  • ATOM-Feed

  • Excel-Arbeitsmappe

Abrufen verschiedener Elemente in unterschiedlichen Formaten

Für diese Aufgabe schreiben Sie URLs im REST-API-Format, mit denen verschiedene Elemente zurückgegeben werden. Sie können die zurückgegebenen Elemente in Webseiten, Blogs und Wikis verwenden; Live-Diagramme als verknüpftes Bild in ein Word 2010-Dokument, eine PowerPoint 2010-Präsentation oder eine Outlook 2010-E-Mail einbetten; Mash-ups erstellen, von denen Excel Services zur Berechnung, Diagrammerstellung und als Datenquelle verwendet werden.

So rufen Sie Elemente aus der Arbeitsmappe ab

  1. Öffnen Sie einen Webbrowser, geben Sie im Adressfeld die folgende URL ein, und drücken Sie dann die EINGABETASTE.

    http://myserver/mywebsite/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx/Model/Ranges

    Die in Abbildung 2 dargestellte Webseite wird angezeigt. Beachten Sie, dass die Namen von vier benannten Bereichen angezeigt werden.

    Abbildung 2. Bereichsauflistungen

    Bereichsauflistungen

  2. Fügen Sie im Adressfeld des Browsers unmittelbar nach dem Wort Ranges Folgendes an die URL an, und drücken Sie die EINGABETASTE. Dadurch werden die RegionalSalesSummary-Bereichsdaten als HTML angezeigt (siehe Abbildung 3).

    ('RegionalSalesSummary')?$format=HTML

    Abbildung 3. Zusammenfassung regionaler Umsatzzahlen

    Zusammenfassung von regionalen Umsatzzahlen

  3. Es ist ebenso einfach, Diagramme und Tabellen zu ermitteln und darauf zuzugreifen. Geben Sie die folgende URL im Browser ein, und achten Sie darauf, dass das ResellerSalesChart-Diagramm als Bild angezeigt wird (siehe Abbildung 4).

    http://myserver/mywebsite/_vti_bin/ExcelRest.aspx/Sales%20Reports/Sales_Report.xlsx/Model/Charts('ResellerSalesChart')?$format=image

    Abbildung 4. ResellersSalesChart-Diagramm

    ResellersSalesChart-Diagramm

  4. Neben benannten Bereichen können Sie auch reguläre Bereiche zurückgeben. Mit der folgenden URL wird der Bereich A1 bis D4 in Tabelle2 zurückgegeben.

    http://myserver/mywebsite/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx/Model/Ranges(‘Sheet2!A1|D4’)?$format=HTML

    Beachten Sie, dass Sie den Doppelpunkt bei der A1-Schreibweise für Bereiche durch einen senkrechten Strich ersetzen müssen.

Ändern von Datenwerten

Mit der REST-API können Werte in der Arbeitsmappe geändert werden. Diese Änderungen betreffen nur die Werte, HTML-Renderinginformationen oder Diagramme, die von der REST-API für diesen speziellen Zweck zurückgegeben werden. Diese Änderungen werden nicht in der Arbeitsmappe gespeichert und haben keine Auswirkungen auf andere REST-API- oder Excel Web Access-Browsersitzungen. Für diese Aufgabe schreiben Sie eine URL, mit der die Umsatzzahlen für den Wiederverkäufertyp "Einzelhandelskette" (Retail Chain) von 167.690 $ in 0 $ geändert werden, um die Auswirkungen auf ResellerSalesChart zu prüfen. Vor der Änderungen sieht das Diagramm (und der Wert "Einzelhandelskette") wie in Abbildung 5 aus.

Abbildung 5. "ResellerSalesChart" vor der Änderung

'ResellerSalesChart' vor der Änderung

So ändern Sie Datenwerte in einem Diagramm

  1. Ändern Sie die URL im Browser wie folgt, drücken Sie die EINGABETASTE, und überprüfen Sie die Änderung des Werts "Einzelhandelskette" (Retail Chain) in Abbildung 6.

    http://myserver/mywebsite/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx/Model/Charts('ResellerSalesChart')?Ranges(‘Sheet2!D7')=0.0

    Abbildung 6. "ResellerSalesChart" nach der Änderung

    'ResellerSalesChart' nach der Änderung

  2. Mithilfe der folgenden URL können Sie auch Werte in unterschiedlichen Zellen platzieren.

    http://myserver/mywebsite/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx/Model/Charts('ResellersSalesChart')?Ranges(‘Sheet2!D7')=0.0&Ranges('FiscalYear')=2011

  3. Darüber hinaus können Sie Werte in unterschiedlichen Zellen platzieren und die Formatierung dafür festlegen, indem Sie die folgenden URLs verwenden:

    http://myserver/mywebsite/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx/Model/Charts('ResellerSalesChart')?Ranges(‘Sheet2!D7')=0.0&Ranges('FiscalYear')=2011?$format=HTML

    http://myserver/mywebsite/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx/Model/Charts('ResellerSalesChart')?Ranges(‘Sheet2!D7')=0.0&?format=HTML&Ranges('FiscalYear')=2011

    http://myserver/mywebsite/_vti_bin/ExcelRest.aspx/Shared%20Documents/Sales_Report.xlsx/Model/Charts('ResellerSalesChart')?$format=HTML&Ranges(‘Sheet2!D7')=0.0&Ranges('FiscalYear')=2011

Nächste Schritte