• 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.

Die Berichtsserver-Webdienste werden an drei unterschiedlichen Endpunkten verfügbar gemacht. Der Name der WSDL-Datei ist für jeden Endpunkt anders. Der ReportService2010-Endpunkt enthält Methoden zum Verwalten von Objekten auf einem Berichtsserver im systemeigenen Modus oder integrierten SharePoint-Modus. Auf die WSDL für diesen Endpunkt wird über ReportService2010.asmx?wsdl. zugegriffen.

HinweisHinweis

Der ReportService2005-Endpunkt und der ReportService2006-Endpunkt sind in SQL Server 2008 R2 als veraltet markiert. Der ReportService2010-Endpunkt schließt die Funktionen beider Endpunkte ein und beinhaltet zusätzliche Verwaltungsfunktionen.
  • Der ReportExecution2005-Endpunkt ermöglicht es Entwicklern, Berichte programmgesteuert auf 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/ReportService2010.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.