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 utilizzare 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.
Riferimento al linguaggio 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 endpoint ReportService2005 e ReportService2006 sono deprecati in SQL Server 2008 R2. 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 utilizzato 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. |
<endpoint name>.asmx |
Nome dell'endpoint del servizio Web. |
Per ulteriori informazioni sul formato WSDL, vedere la specifica WSDL nel sito Web World Wide Web Consortium (W3C) all'indirizzo http://www.w3.org/TR/wsdl (informazioni in lingua inglese).
Vedere anche
Concetti
Altre risorse
Compilazione di applicazioni tramite servizio Web e .NET Framework