Accesso all'API SOAP
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.