Attività Servizio WebWeb Service Task

L'attività Servizio Web esegue un metodo di servizio Web.The Web Service task executes a Web service method. È possibile utilizzare l'attività Servizio Web per gli scopi seguenti:You can use the Web Service task for the following purposes:

  • Scrivere in una variabile i valori restituiti da un metodo di servizio Web.Writing to a variable the values that a Web service method returns. È ad esempio possibile ottenere la temperatura massima del giorno da un metodo di servizio Web e quindi utilizzare tale valore per aggiornare una variabile utilizzata in un'espressione che imposta il valore di una colonna.For example, you could obtain the highest temperature of the day from a Web service method, and then use that value to update a variable that is used in an expression that sets a column value.

  • Scrivere in un file i valori restituiti da un metodo di servizio Web.Writing to a file the values that a Web service method returns. È ad esempio possibile scrivere in un file un elenco di potenziali clienti e utilizzare tale file come origine dei dati in un pacchetto che pulisce i dati prima che vengano scritti in un database.For example, a list of potential customers can be written to a file and the file then used as a data source in a package that cleans the data before it is written to a database.

File WSDLWSDL File

Per connettersi al servizio Web l'attività Servizio Web utilizza una gestione connessione HTTP,The Web Service task uses an HTTP connection manager to connect to the Web service. configurata separatamente, a cui viene fatto riferimento dall'attività Servizio Web.The HTTP connection manager is configured separately from the Web Service task, and is referenced in the task. La gestione connessione HTTP specifica le impostazioni proxy del server, quali l'URL del server, le credenziali per l'accesso al server dei servizi Web e la durata del timeout.The HTTP connection manager specifies the server proxy settings such as the server URL, credentials for accessing the Web services server, and time-out length. Per altre informazioni, vedere Gestione connessione HTTP.For more information, see HTTP Connection Manager.

Importante

La gestione connessione HTTP supporta solo l'autenticazione anonima e l'autenticazione di base.The HTTP connection manager supports only anonymous authentication and basic authentication. Non supporta l'autenticazione di Windows.It does not support Windows Authentication.

La gestione connessione HTTP può puntare a un sito Web o a un file WSDL (Web Service Description Language).The HTTP connection manager can point to a Web site or to a Web Service Description Language (WSDL) file. L'URL di una gestione connessione HTTP che punta a un file WSDL include il parametro ?WSDL , ad esempio http://MyServer/MyWebService/MyPage.asmx?WSDL.The URL of the HTTP connection manager that points to a WSDL file includes the ?WSDL parameter: for example, http://MyServer/MyWebService/MyPage.asmx?WSDL.

Affinché sia possibile configurare l'attività Servizio Web tramite la finestra di dialogo Editor attività Servizio Web di Progettazione SSISSSIS , il file WSDL deve essere disponibile localmente.The WSDL file must be available locally to configure the Web Service task using the Web Service Task Editor dialog box that SSISSSIS Designer provides.

  • Se la gestione connessione HTTP punta a un sito Web, il file WSDL dovrà essere copiato manualmente in un computer locale.If the HTTP connection manager points to a Web site, the WSDL file must be copied manually to a local computer.

  • Se la gestione connessione HTTP punta a un file WSDL, l'attività Servizio Web potrà scaricare il file dal sito Web a un file locale.If the HTTP connection manager points to a WSDL file, the file can be downloaded from the Web site to a local file by the Web Service task.

    Nel file WSDL sono elencati i metodi offerti dal servizio Web, i parametri di input richiesti dai metodi, le risposte restituite dai metodi e la modalità con cui comunicare con il servizio Web.The WSDL file lists the methods that the Web service offers, the input parameters that the methods require, the responses that the methods return, and how to communicate with the Web service.

    Se il metodo utilizza parametri di input, l'attività Servizio Web richiederà i valori dei parametri.If the method uses input parameters, the Web Service task requires parameter values. Un metodo che determina la lunghezza consigliata degli sci da acquistare in base alla statura del cliente, ad esempio, richiede l'immissione della statura in un parametro di input.For example, a Web service method that recommends the length of skis you should purchase based on your height requires that your height be submitted in an input parameter. I valori dei parametri possono essere specificati mediante stringhe definite all'interno dell'attività oppure tramite variabili definite nell'ambito dell'attività o di un contenitore padre.The parameter values can be provided either by strings that are defined in the task, or by variables defined in the scope of the task or a parent container. Il vantaggio dell'utilizzo di variabili consiste nella possibilità di aggiornare dinamicamente i valori dei parametri mediante script o configurazioni di pacchetto.The advantage of using variables is that they let you dynamically update the parameter values by using package configurations or scripts. Per altre informazioni, vedere Variabili di Integration Services (SSIS) e Configurazioni di pacchetto.For more information, see Integration Services (SSIS) Variables and Package Configurations.

    Molti metodi di servizi Web non utilizzano parametri di input.Many Web service methods do not use input parameters. Un metodo di servizio Web che ottiene i nomi dei presidenti nati nel mese corrente, ad esempio, non richiede parametri di input, perché è in grado di determinare il mese corrente localmente.For example, a Web service method that gets the names of presidents who were born in the current month would not require an input parameter because the Web service can determine the current month locally.

    I risultati del metodo di servizio Web possono essere scritti in una variabile o in un file.The results of the Web service method can be written to a variable or to a file. Per specificare il file o il nome della variabile in cui scrivere i risultati, è necessario utilizzare una gestione connessione file.You use the File connection manager either to specify the file or to provide the name of the variable to write the results to. Per altre informazioni, vedere Gestione connessione File e Variabili di Integration Services (SSIS).For more information, see File Connection Manager and Integration Services (SSIS) Variables.

Messaggi di registrazione personalizzati disponibili nell'attività Servizio WebCustom Logging Messages Available on the Web Service Task

Nella tabella seguente sono elencate le voci di log personalizzate che è possibile attivare per l'attività Servizio Web.The following table lists the custom log entries that you can enable for the Web Service task. Per altre informazioni, vedere registrazione di Integration Services (SSIS).For more information, see Integration Services (SSIS) Logging.

Voce di logLog entry DescriptionDescription
WSTaskBeginWSTaskBegin Indica che l'attività ha iniziato ad accedere a un servizio Web.The task began to access a Web service.
WSTaskEndWSTaskEnd Indica che l'attività ha completato un metodo per il servizio Web.The task completed a Web service method.
WSTaskInfoWSTaskInfo Offre informazioni descrittive sull'attività.Descriptive information about the task.

Configurazione dell'attività Servizio WebConfiguration of the Web Service Task

È possibile impostare le proprietà tramite Progettazione SSISSSIS o a livello di codice.You can set properties through SSISSSIS Designer or programmatically.

Per ulteriori informazioni sulle proprietà che è possibile impostare in Progettazione SSISSSIS , fare clic su uno degli argomenti seguenti:For more information about the properties that you can set in SSISSSIS Designer, click one of the following topics:

Configurazione dell'attività Servizio Web a livello di codiceProgrammatic Configuration of the Web Service Task

Per ulteriori informazioni sull'impostazione di queste proprietà a livello di codice, fare clic su uno degli argomenti seguenti:For more information about programmatically setting these properties, click one of the following topics:

Video sulla Procedura: Chiamata a un servizio Web tramite l'attività Servizio Web (video di SQL Server)sul sito technet.microsoft.com.Video, How to: Call a Web Service by Using the Web Service Task (SQL Server Video), on technet.microsoft.com.