Zugreifen auf die SOAP-API
Letzte Änderung: Mittwoch, 24. März 2010
Gilt für: SharePoint Server 2010
Excel-Webdienste verwendet SOAP (Simple Object Access-Protokoll) über HTTP und dient als Kommunikationsschnittstelle zwischen Clientprogrammen und Excel Services. Der Webdienst besteht aus Methoden und einer Reihe komplexer Objekte, mit denen Sie auf die gesamten Funktionen von Excel-Webdienste zugreifen können. Zum Aufrufen dieses Diensts müssen Sie Web Services Description Language (WSDL) von Excel-Webdienste verwenden.
Verwenden von WSDL
Für den erfolgreichen Aufruf eines Webdiensts müssen Sie wissen, wie auf den Dienst zugegriffen wird, welche Vorgänge von dem Dienst unterstützt werden, welche Parameter von dem Dienst erwartet werden und was von dem Dienst zurückgegeben wird. WSDL stellt diese Informationen in einem XML-Dokument bereit, das von einem Computer gelesen oder verarbeitet werden kann.
Der Zugriff auf WSDL für den Endpunkt von Excel-Webdienste erfolgt über ExcelServices.asmx?wsdl. WSDL kann von Development Kits verwendet werden, die SOAP und Webdienste unterstützen, wie z. B. das Microsoft .NET Framework SDK.
Im folgenden Beispiel wird das Format der URL zur WSDL-Datei von Excel-Webdienste gezeigt:
http://<server>/<customsite>/_vti_bin/excelservice.asmx?WSDL
Wenn keine benutzerdefinierte Website vorhanden ist, kann temporär die folgende URL verwendet werden:
http://<server>/_vti_bin/excelservice.asmx?WSDL
Es wird empfohlen, eine benutzerdefinierte Website zu erstellen und dann die URL, die die benutzerdefinierte Website enthält, im URL-Format zu verwenden.
In der folgenden Tabelle werden die einzelnen Elemente in der URL beschrieben.
URL element |
Description |
|---|---|
server |
Der Name des Servers, auf dem Microsoft SharePoint Server 2010 bereitgestellt wird. |
customsite |
Eine benutzerdefinierte SharePoint Server 2010-Website, die vom Serveradministrator erstellt wird. |
<endpointname>.asmx |
Der Name des Webdienstendpunkts. Für Excel-Webdienste ist dies ExcelService.asmx. |
Weitere Informationen zum WSDL-Format finden Sie in der WSDL-Spezifikation des World Wide Web Consortium (W3C) unter http://www.w3.org/TR/wsdl.
Siehe auch
Aufgaben
Schritt 1: Erstellen des Webdienst-Clientprojekts
Schritt 2: Hinzufügen eines Webverweises
Schritt 3: Zugreifen auf den Webdienst