Toegang tot de SOAP-API

De Report Server Webservice gebruikt Simple Object Access Protocol (SOAP) via HTTP en fungeert als communicatieinterface tussen clientprogramma's en de rapportserver. De webservice biedt twee eindpunten - één voor rapportage en één voor rapportbeheer - en bestaat uit methoden en een set complexe typeobjecten die u kunt gebruiken om toegang te krijgen tot de volledige functionaliteit van Reporting Services. Om de dienst te bellen, moet u de Reporting Services Web Services Description Language (WSDL) raadplegen.

Raadpleeg de Reporting Services WSDL

Om een webservice succesvol aan te roepen, moet je weten hoe je toegang krijgt tot de service, welke operaties de service ondersteunt, welke parameters de service verwacht en wat de service teruggeeft. WSDL biedt deze informatie in een XML-document dat door een computer kan worden gelezen of verwerkt.

De Report Server Webservices zijn beschikbaar op drie verschillende eindpunten. De naam van het WSDL-bestand is per eindpunt verschillend. Het ReportService2010 eindpunt bevat methoden voor het beheren van objecten in een Report Server in zowel native als SharePoint-geïntegreerde modus. De WSDL voor dit eindpunt wordt benaderd via ReportService2010.asmx?wsdl.

Note

De ReportService2005 en ReportService2006 endpoints zijn verouderd in SQL Server 2008 R2 (10.50.x). Het ReportService2010 eindpunt bevat de functionaliteiten van beide eindpunten en bevat aanvullende beheerfuncties.

  • Het ReportExecution2005 endpoint stelt ontwikkelaars in staat om programmatisch rapporten te verwerken en te renderen in een Report Server. De WSDL voor dit eindpunt wordt benaderd via ReportExecution2005.asmx?wsdl.

WSDL kan worden gebruikt door ontwikkelkits die SOAP en webservices ondersteunen, zoals de Microsoft .NET Framework SDK.

Het volgende voorbeeld toont het formaat van de URL naar het Reporting Services management WSDL-bestand:

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

De volgende tabel beschrijft elk element in de URL.

URL-element Description
server De naam van de server waarop de rapportserver is geïnstalleerd.
Reportserver De naam van de map die de XML-webservice bevat. Dit wordt tijdens de installatie ingesteld.
<endpoint name.asmx> De naam van het webservice-eindpunt.

Voor meer informatie over het WSDL-formaat, zie de World Wide Web Consortium (W3C) WSDL-specificatie op http://www.w3.org/TR/wsdl.