Accesso all'API SOAP

  • Articolo

Il servizio Web ReportServer utilizza SOAP (Simple Object Access Protocol) tramite HTTP e funge da interfaccia di comunicazione tra i programmi client e il server di report. Il servizio Web fornisce due endpoint, uno per l'esecuzione dei report e uno per la gestione dei report ed è costituito da metodi e un set di oggetti di tipo complesso che è possibile usare per accedere alle funzionalità complete di Reporting Services. Per chiamare il servizio, è necessario fare riferimento al linguaggio WSDL (Web Services Description Language) di Reporting Services.

Fare riferimento a WSDL di Reporting Services

Per chiamare correttamente un servizio Web, è necessario sapere come accedere al servizio, quali operazioni sono supportate dal servizio, quali parametri sono previsti dal servizio e cosa viene restituito dal servizio. WSDL fornisce queste informazioni in un documento XML che può essere letto o elaborato da un computer.

I servizi Web ReportServer sono esposti in tre endpoint diversi. Il nome del file WSDL è diverso per ogni endpoint. L'endpoint ReportService2010 contiene metodi per la gestione di oggetti in un server di report in modalità nativa o in modalità integrata SharePoint. È possibile accedere al linguaggio WSDL per questo endpoint tramite ReportService2010.asmx?wsdl.

Nota

Gli ReportService2005 endpoint e ReportService2006 sono deprecati in SQL Server 2008 R2 (10.50.x). L'endpoint ReportService2010 include le funzionalità di entrambi gli endpoint e contiene caratteristiche di gestione aggiuntive.

  • L'endpoint ReportExecution2005 consente agli sviluppatori di elaborare a livello di programmazione i report e di eseguirne il rendering in un server di report. È possibile accedere al linguaggio WSDL per questo endpoint tramite ReportExecution2005.asmx?wsdl.

WSDL può essere usato dai kit di sviluppo che supportano SOAP e i servizi Web, ad esempio Microsoft .NET Framework SDK.

Nell'esempio seguente viene illustrato il formato dell'URL del file WSDL di gestione di Reporting Services:

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

Nella tabella seguente sono descritti gli elementi dell'URL.

Elemento URL Descrizione
server Nome del server in cui viene distribuito il server di report.
reportserver Nome della cartella contenente il servizio Web XML. Questo nome viene configurato durante l'installazione.
<nome endpoint>.asmx Nome dell'endpoint del servizio Web.

Per altre informazioni sul formato WSDL, vedere la specifica WSDL nel sito Web World Wide Web Consortium (W3C) all'indirizzo http://www.w3.org/TR/wsdl.

Contenuto correlato