Scelta tra accesso con URL e SOAP in Reporting ServicesChoosing between URL access and SOAP in Reporting Services

QUESTO ARGOMENTO SI APPLICA A:THIS TOPIC APPLIES TO: sìSQL Server Reporting Services (2016)SQL Server Reporting Services (2016) noSQL Server Reporting Services (2017)SQL Server Reporting Services (2017) noServer di report di Power BIPower BI Report ServerQUESTO ARGOMENTO SI APPLICA A:THIS TOPIC APPLIES TO: sìSQL Server Reporting Services (2016)SQL Server Reporting Services (2016) noSQL Server Reporting Services (2017)SQL Server Reporting Services (2017) noServer di report di Power BIPower BI Report Server

L'integrazione di Reporting ServicesReporting Services nelle applicazioni personalizzate può risultare complessa.Integrating Reporting ServicesReporting Services into custom applications can be challenging. La complessità non è tuttavia dovuta al modello di programmazione o alle API, ma alle numerose modalità di integrazione disponibili.The challenge, however, is not the complexity of the programming model or APIs, but the many possible ways to integrate it. Reporting ServicesReporting Services è stato progettato interamente come piattaforma di sviluppo e, in quanto tale, offre flessibilità di programmazione. was designed from the ground up as a developer platform, and as such, it is built with programming flexibility in mind. Alla flessibilità è associata l'esigenza di prendere decisioni importanti relativamente all'integrazione delle funzionalità di navigazione e gestione dei report di Reporting ServicesReporting Services nelle applicazioni aziendali esistenti.With flexibility comes the need to make important decisions about integrating Reporting ServicesReporting Services report navigation and management functionality into your existing business applications.

Nota

A partire da SQL Server 2017 Reporting Services, è disponibile l'accesso all'API REST per lo sviluppo di soluzioni.Starting with SQL Server 2017 Reporting Services, REST API access is available for developing solutions. L'accesso all'API SOAP è stato deprecato.SOAP API access has been deprecated. Per altre informazioni, vedere Sviluppare con le API REST per Reporting Services.For more information, see Develop with the REST APIs for Reporting Services.

È possibile integrare Reporting ServicesReporting Services nelle applicazioni personalizzate in due modi, ovvero tramite l'accesso con URL e l'API SOAP di Reporting Services.There are two ways to integrate Reporting ServicesReporting Services into custom applications: URL access and the Reporting Services SOAP API. La modalità da utilizzare dipende da diversi fattori.Which to use depends on several factors. In alcuni casi, l'integrazione di Reporting ServicesReporting Services nelle applicazioni aziendali personalizzate richiede l'uso dell'accesso con URL e di SOAP.In some cases, integrating Reporting ServicesReporting Services into your custom business applications requires the use of both URL access and SOAP. È necessario porsi le domande seguenti:You should ask the following questions:

  • Quali tipi di funzionalità di creazione di report aziendali sono necessari?What type of enterprise reporting functionality do you or your end users require? È necessario disporre di un modo semplice per avviare e navigare tra i report oppure sono necessarie caratteristiche di gestione del server di report più avanzate per la soluzione aziendale personalizzata?Do you need a simple way to launch and navigate reports, or do you need more advanced report server management features from your custom business solution?

  • In quale tipo di ambiente operano in genere gli utenti?In which type of environment do your users typically operate? L'applicazione aziendale è un'applicazione Web o un'applicazione Windows?Is your business application a Web application or a Windows application? Con quanta facilità gli utenti finali possono passare da un ambiente Win32 a un ambiente Web?How easily can your end-users switch from a Win32 environment to a Web environment? Quale tipo di controllo è necessario sull'ambiente in cui i report vengono eseguiti e gestiti?What type of control do you need over the environment in which reports are run and managed?

    Dopo aver risposto alle domande precedenti, è possibile scegliere come integrare Reporting ServicesReporting Services nella propria infrastruttura IT.Once you have answered the previous questions, you can decide how to integrate Reporting ServicesReporting Services into your IT infrastructure. In genere, l'accesso con URL è preferibile per la visualizzazione e la navigazione di singoli report.Typically, URL access is preferred for viewing and navigating individual reports. L'accesso con URL consente di navigare tra i report in modo semplice e rapido senza l'overhead del servizio Web.URL access enables you to freely and quickly navigate reports without the overhead of the Web service. L'accesso con URL, inoltre, è attualmente l'unica tecnica di programmazione che utilizza la versione completa del Visualizzatore HTML per la navigazione dei report, che include la barra degli strumenti dei report.In addition, URL access is currently the only programming technique that uses the full HTML Viewer for report navigation, which includes the report toolbar. L'accesso con URL garantisce inoltre prestazioni migliori rispetto a SOAP in quanto consente di ignorare il marshalling delle richieste SOAP da e verso il server.In addition, URL access provides better performance than SOAP because it bypasses the marshalling of SOAP requests to and from the server. Negli scenari di integrazione in cui è necessario poter accedere in modo rapido e semplice ai report con gli strumenti predefiniti di visualizzazione e navigazione, l'accesso con URL rappresenta la scelta migliore.In integration scenarios that require quick and easy access to reports with built-in tools for viewing and navigation, URL access is the better choice.

Nota

L'accesso con URL al server di report supporta il Visualizzatore HTML e la funzionalità estesa della barra degli strumenti dei report.Report server URL access supports HTML Viewer and the extended functionality of the report toolbar. L'API SOAP non supporta questo tipo di report visualizzabile.The SOAP API does not support this type of rendered report. Se si esegue il rendering dei report usando l'API SOAP, progettare e sviluppare una barra degli strumenti dei report personalizzata.If you render reports using the SOAP API, design and develop your own report toolbar.

Per altre informazioni sulla barra degli strumenti dei report, vedere Visualizzatore HTML e barra degli strumenti dei report.For more information about the report toolbar, see HTML Viewer and the Report Toolbar.

Per altre informazioni sull'accesso con URL, vedere Accesso con URL.For more information about URL access, see URL Access.

L'accesso con URL è utile per la visualizzazione dei report, ma non fornisce le funzionalità di gestione degli spazi dei nomi e dei report che possono essere essenziali per qualsiasi scenario aziendale di creazione di report.URL access is useful for viewing reports, but it does not provide the report and namespace management functionality that can be essential to any enterprise reporting scenario. In questo caso, è consigliabile utilizzare le ampie e ricche funzionalità dell'API SOAP di Reporting Services.In this case, the broad and rich functionality of the Reporting Services SOAP API is recommended. Con l'API SOAP è possibile gestire e distribuire report, creare pianificazioni, configurare le proprietà del server, gestire lo spazio dei nomi del server di report, creare sottoscrizioni e altro ancora.With the SOAP API you can manage and deploy reports, create schedules, configure server properties, manage the report server namespace, create subscriptions, and more. L'API SOAP espone il set completo di funzionalità di gestione in Reporting ServicesReporting Services.The SOAP API exposes the complete set of management functionality in Reporting ServicesReporting Services. L'API SOAP può consentire inoltre la visualizzazione e la navigazione dei report tramite il metodo Render dell'API.The SOAP API can also enable report viewing and navigation through the Render method of the API. La visualizzazione dei report tramite l'API SOAP non consente tuttavia l'abilitazione delle funzionalità di visualizzazione predefinite della barra degli strumenti dei report, né la gestione automatica dell'interattività dei report consentite dall'accesso con URL.However, viewing reports through the SOAP API does not enable the built-in viewing functionality of the report toolbar, nor does it automatically handles the report interactivity that URL access provides.

Per altre informazioni sull'API SOAP di Reporting Services, vedere Servizio Web ReportServer.For more information about the Reporting Services SOAP API, see Report Server Web Service.

Nella maggior parte dei casi, l'accesso con URL e le chiamate SOAP sono entrambi necessari per soddisfare le esigenze in materia di creazione di report.In the majority of cases, URL access and SOAP calls are both required to meet your reporting needs. SOAP viene utilizzato durante la connessione iniziale al database del server di report e la visualizzazione dell'elenco di report disponibili in un'interfaccia utente, mentre l'accesso con URL viene utilizzato per l'effettivo accesso e la navigazione dei singoli report.SOAP is used when initially connecting to the report server database and presenting the available list of reports in a user interface and URL access is used to actually access and navigate individual reports.

Per un esempio di uso dell'accesso con URL in combinazione con il servizio Web per offrire funzionalità di creazione di report integrate, vedere SQL Server Reporting Services Product Samples (Esempi del prodotto SQL Server Reporting Services).For an example of combining URL access and the Web service to provide integrated reporting, see SQL Server Reporting Services Product Samples.

Altre domande?More questions? Visitare il forum su Reporting ServicesTry asking the Reporting Services forum