Endpoint servizio Web ReportServer

  • Articolo

Il servizio Web ReportServer fornisce diversi endpoint per la gestione di un server di report e l'esecuzione e l'esplorazione dei report.

Endpoint di gestione

Per la gestione degli oggetti in un server di report sono disponibili tre endpoint, ReportService2005, ReportService2006 e ReportService2010. L'endpoint ReportService2005 viene utilizzato per la gestione degli oggetti in un server di report configurato per la modalità nativa. L'endpoint ReportService2006 viene utilizzato per la gestione degli oggetti in un server di report configurato per la modalità integrata SharePoint. L'endpoint ReportService2010 unisce le funzionalità di ReportService2005 e ReportService2006 e può gestire gli oggetti in un server di report configurati per la modalità nativa o per la modalità integrata SharePoint.

Importante

Quando un server di report è configurato per la modalità integrata SharePoint, le API di ReportService2005 restituiscono un errore rsOperationNotSupportedSharePointMode. Se il server di report è configurato per la modalità nativa, le API di ReportService2006 restituiscono un errore rsOperationNotSupportedNativeMode. In modo analogo, se le API specifiche della modalità in ReportService2010 vengono utilizzate in modalità non previste, restituiranno gli errori corrispondenti.

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.

Se il server di report è configurato per la modalità nativa o la modalità di integrazione di SharePoint, è possibile accedere al file WSDL per l'endpoint di gestione usando uno degli URL seguenti:

https://<Server Name>/ReportServer/ReportService2010.asmx?wsdl

Per altre informazioni, vedere Accesso all'API SOAP.

Endpoint di esecuzione

L'endpoint ReportExecution2005 consente agli sviluppatori di personalizzare in modo semplice le fasi di elaborazione e rendering dei report da un server di report sia in modalità nativa che in modalità integrata SharePoint. L'endpoint include le classi e i metodi disponibili nelle versioni precedenti del servizio Web ReportServer. Al servizio Web ReportServer sono inoltre stati aggiunti numerosi nuovi metodi e classi esposti tramite l'endpoint di esecuzione.

È possibile accedere al codice WSDL per l'endpoint di gestione utilizzando l'URL seguente:

https://<Server Name>/ReportServer/ReportExecution2005.asmx?wsdl

Se il server di report è configurato per la modalità integrata SharePoint, è possibile accedere al codice WSDL utilizzando l'URL seguente:

https://<Server Name>/<Site Name>/_vti_bin/ReportServer/ReportExecution2005.asmx?wsdl

Per altre informazioni, vedere Accesso all'API SOAP.

Endpoint proxy di SharePoint

Quando un server di report è configurato per la modalità integrata SharePoint ed è stato installato il componente aggiuntivo Reporting Services, nel server SharePoint viene installato un set di endpoint proxy. Gli endpoint proxy rappresentano l'API principale per lo sviluppo di soluzioni di report quando un server di report è configurato per la modalità integrata SharePoint. Quando si sviluppano con gli endpoint proxy, il componente aggiuntivo Reporting Services gestisce lo scambio di credenziali tra il server SharePoint e il server di report in modalità autenticazione dell'account attendibile. Quando si sviluppano negli endpoint del server di report, l'applicazione chiamante deve gestire lo scambio di credenziali in modalità autenticazione dell'account attendibile. Nella tabella seguente sono elencati gli endpoint installati con il componente aggiuntivo Reporting Services.

Endpoint proxy Descrizione
ReportService2006 Fornisce le API per la gestione di un server di report configurato per la modalità integrata SharePoint.

Nota: questo endpoint è deprecato in SQL Server 2008 R2 (10.50.x).
ReportService2010 Fornisce le API per la gestione di un server di report configurato per la modalità nativa o la modalità integrata SharePoint.
ReportExecution2005 Fornisce le API per l'esecuzione e la navigazione dei report.
ReportServiceAuthentication Fornisce le API per l'autenticazione degli utenti rispetto a un server di report quando l'applicazione Web SharePoint è configurata per l'autenticazione basata su form.

Di seguito sono riportati alcuni URL di esempio che consentono di fare riferimento agli endpoint proxy in un sito di SharePoint.

https://<Server Name>/<Site Name>/_vti_bin/ReportServer/ReportService2010.asmx  

https://<Server Name>/<Site Name>/_vti_bin/ReportServer/ReportExecution2005.asmx  

https://<Server Name>/<Site Name>/_vti_bin/ReportServer/ReportServiceAuthentication.asmx

Contenuto correlato

Compilazione di applicazioni tramite servizio Web e .NET Framework