Ruolo di SOAP in Reporting ServicesThe Role of SOAP in Reporting Services

Il servizio Web ReportServer utilizza la messaggistica SOAP (Simple Object Access Protocol) per inviare comandi basati su testo in una rete.The Report Server Web service uses Simple Object Access Protocol (SOAP) messaging to send text-based commands over a network. Questi comandi sono in formato di testo XML e vengono inviati nel World Wide Web utilizzando HTTP.These commands take the form of XML text that is sent over the World Wide Web using HTTP. Grazie all'utilizzo di SOAP come protocollo di comunicazione, il servizio Web ReportServer consente alle applicazioni e ai componenti di scambiare dati con il server di report utilizzando un'infrastruttura aperta molto diffusa.By using SOAP as its communication protocol, the Report Server Web service allows applications and components to exchange data with the report server using an open and widely accepted infrastructure. Lo standard SOAP è definito nel sito www.w3.org/TR/SOAP (informazioni in lingua inglese).The SOAP standard is defined at www.w3.org/TR/SOAP.

Qualsiasi applicazione client può essere utilizzata come client SOAP a condizione che supporti SOAP e che sia in grado di inviare richieste SOAP.Any client application can act as a SOAP client as long as it is SOAP-aware and can send SOAP requests. Gestione report è un client SOAP.Report Manager is one such SOAP client. Questo client fornisce un'interfaccia per il database del server di report in cui vengono archiviati tutti i report e il contenuto correlato ai report.It provides an interface to the report server database in which all reports and report-related content is stored. Gli utenti finali possono utilizzare l'applicazione per esplorare e gestire report e cartelle nello spazio dei nomi del server di report.End users can use the application to browse through and manage reports and folders in the report server namespace. Gestione report è basato sull'infrastruttura del servizio Web ReportServer.Report Manager is built on the Report Server Web service infrastructure.

Un server di report funge da server SOAP, un servizio che supporta SOAP in grado di accettare le richieste dai client SOAP e di creare risposte appropriate.A report server acts as a SOAP server, a SOAP-aware service that can accept requests from SOAP clients and create appropriate responses. Il server gestisce le richieste e restituisce al client risposte codificate.The server handles the requests and sends encoded responses back to the client.

I messaggi SOAP in Reporting ServicesReporting Services possono avere formati diversi, a seconda del tipo di richiesta effettuata dal client.SOAP messages in Reporting ServicesReporting Services take many different forms, depending on the type of request made by the client. Nell'esempio seguente viene rappresentata una semplice richiesta client SOAP per la rimozione di un elemento dal database del server di report.The following example represents a simple SOAP client request to remove an item from the report server database.

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">  
    <soap:Body>  
        <DeleteItem xmlns="http://www.microsoft.com/sql/ReportingServer">  
            <item>/Samples/Report1</item>  
        </DeleteItem>  
    </soap:Body>  
</soap:Envelope>  

SOAP richiede che i messaggi di essere inserita in un busta elemento, con la maggior parte del messaggio all'interno di un corpo elemento.The SOAP itself requires that messages be put into an Envelope element, with the bulk of the message inside a Body element. In questo esempio il corpo contiene una chiamata al metodo DeleteItem che accetta un parametro stringa che rappresenta il percorso dell'elemento da eliminare.In this example, the body contains a call to the DeleteItem method, which takes a string parameter representing the path of the item to delete. È possibile creare un MicrosoftMicrosoft .NET Framework.NET Framework classe proxy client che incapsula tutte le operazioni SOAP nei metodi.You can create a MicrosoftMicrosoft .NET Framework.NET Framework client proxy class that encapsulates all SOAP operations into methods. Nell'esempio MicrosoftMicrosoft Visual C#Visual C# metodo rappresenta l'esempio SOAP riportato in precedenza.The following MicrosoftMicrosoft Visual C#Visual C# method represents the SOAP example given earlier.

public void DeleteItem(string item);  

La risposta dal server può essere simile alla seguente:The response from the server might look like the following:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">  
    <soap:Body>  
        <DeleteItemResponse xmlns="http://www.microsoft.com/sql/ReportingServer" />  
    </soap:Body>  
</soap:Envelope>  

Il metodo DeleteItem non restituisce alcun valore, pertanto viene restituita una risposta vuota.The DeleteItem method has no return value, so an empty response is returned.

Vedere ancheSee Also

L'accesso all'API SOAP Accessing the SOAP API
Gestione report ( Modalità nativa SSRS ) Report Manager (SSRS Native Mode)
Server di Report di Reporting Services Reporting Services Report Server
Servizio Web ReportServerReport Server Web Service