Accessing the SOAP API

  • Artikel

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 WSDL für Reporting Services

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 einheitlichen Modus oder integrierten SharePoint-Modus. Auf die WSDL für diesen Endpunkt wird über ReportService2010.asmx?wsdl. zugegriffen.

Hinweis

Die Endpunkte ReportService2005 und ReportService2006 sind in SQL Server 2008 R2 (10.50.x) veraltet. 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. Sie können über ReportExecution2005.asmx?wsdl auf die WSDL dieses Endpunkts zugreifen.

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

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.
berichtsserver Der Name des Ordners, der den XML-Webdienst enthält. Dieser wird während des Setups konfiguriert.
<Endpunktname>.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.

Zugehöriger Inhalt

Erstellen von Anwendungen mit dem Webdienst und .NET Framework
Report Server Web Service (Report Server-Webdienst)