• Artikel

Zugriff auf die SOAP-API

Der Berichtsserver-Webdienst verwendet SOAP (Simple Object Access Protocol) über HTTP und agiert als Kommunikationsschnittstelle zwischen den Clientprogrammen und dem Berichtsserver. Der Webdienst verfügt über zwei Endpunkte (einen für die Berichtsausführung und einen für die Berichtsverwaltung) und besteht aus Methoden und einer Reihe komplexer Typenobjekte, anhand derer Sie auf die kompletten Funktionen von Reporting Services zugreifen können. Um den Dienst aufzurufen, müssen Sie auf die Reporting Services-WSDL (Web Services Description Language) verweisen.

Verweisen auf die Reporting Services-WSDL

Um einen Webdienst erfolgreich aufzurufen, müssen Sie wissen, wie auf den Dienst zugegriffen wird, welche Vorgänge der Dienst unterstützt, welche Parameter der Dienst benötigt und was der Dienst zurückgibt. WSDL stellt diese Informationen in einem XML-Dokument bereit, das von einem Computer gelesen oder verarbeitet werden kann.

Der Berichtsserver-Webdienst wird an zwei verschiedenen Endpunkten zur Verfügung gestellt. Der Name der WSDL-Datei ist für jeden Endpunkt anders. Der ReportService2005-Endpunkt enthält Methoden zum Verwalten von Objekten in einem Berichtsserver. Auf die WSDL für diesen Endpunkt wird über ReportService2005.asmx?wsdl. zugegriffen

  • Der ReportExecution2005-Endpunkt ermöglicht es Entwicklern, Berichte programmgesteuert in einem Berichtsserver zu verarbeiten und zu rendern. Auf die WSDL für diesen Endpunkt wird über ReportExecution2005.asmx?wsdl zugegriffen.

Die WSDL kann von Development Kits verwendet werden, die SOAP und Webdienste unterstützen, wie z. B. Microsoft.NET Framework-SDK.

Das folgende Beispiel zeigt das Format der URL zur Reporting Services-Verwaltungs-WSDL-Datei:

https://server/reportserver/ReportService2005.asmx?wsdl

In der folgenden Tabelle werden die einzelnen Elemente in der URL beschrieben.

URL-Element

Beschreibung

Server

Der Name des Servers, auf dem der Berichtsserver eingesetzt wird.

reportserver

Der Name des Ordners, der den XML-Webdienst enthält. Dieser wird während des Setups konfiguriert.

<endpoint name>.asmx

Der Name des Webdienst-Endpunkts.

Weitere Informationen über das WSDL-Format finden Sie in der WSDL-Spezifikation von W3C (World Wide Web Consortium) unter http://www.w3.org/TR/wsdl.