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 sull'argomento seguente:For more information about the properties that you can set in SSISSSIS Designer, click the following topic:

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:

Editor attività Servizio Web (pagina Generale)Web Service Task Editor (General Page)

Usare la pagina Generale della finestra di dialogo Editor attività Servizio Web per specificare una gestione connessione HTTP e il percorso del file WSDL (Web Services Description Language) usato dall'attività Servizio Web, descrivere l'attività Servizio Web e scaricare il file WSDL.Use the General page of the Web Services Task Editor dialog box to specify an HTTP connection manager, specify the location of the Web Services Description Language (WSDL) file the Web Service task uses, describe the Web Services task, and download the WSDL file.

OpzioniOptions

HTTPConnectionHTTPConnection
Selezionare una gestione connessione nell'elenco o creare una nuova gestione connessione facendo clic su <Nuova connessione>.Select a connection manager in the list, or click <New connection…> to create a new 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.

Argomenti correlati: Gestione connessione HTTP, Editor gestione connessione HTTP (pagina Server)Related Topics: HTTP Connection Manager, HTTP Connection Manager Editor (Server Page)

WSDLFileWSDLFile
Consente di digitare il percorso completo di un file WSDL presente localmente nel computer o di trovare il file usando il pulsante Sfoglia (…) .Type the fully qualified path of a WSDL file that is local to the computer, or click the browse button (…) and locate this file.

Sezionare il file WSDL presente nel computer, se è già stato scaricato manualmente.If you have already manually downloaded the WSDL file to the computer, select this file. Se invece il file WSDL non è stato ancora scaricato, attenersi alla seguente procedura:However, if the WSDL file has not yet been downloaded, follow these steps:

  • Creare un file vuoto con l'estensione di file "wsdl".Create an empty file that has the ".wsdl" file name extension.

  • Selezionare questo file vuoto per l'opzione WSDLFile .Select this empty file for the WSDLFile option.

  • Impostare il valore di OverwriteWSDLFile su True per consentire al file vuoto di essere sovrascritto con il file WSDL effettivo.Set the value of OverwriteWSDLFile to True to enable the empty file to be overwritten with the actual WSDL file.

  • Fare clic su Scarica WSDL per scaricare il file WSDL effettivo e sovrascrivere il file vuoto.Click Download WSDL to download the actual WSDL file and overwrite the empty file.

    Nota

    L'opzione Scarica WSDL non è abilitato fino a quando non si fornisce il nome di un file locale esistente nella casella WSDLFile .The Download WSDL option is not enabled until you provide the name of an existing local file in the WSDLFile box.

    OverwriteWSDLFileOverwriteWSDLFile
    Consente di specificare se il file WSDL per l'attività Servizio Web può essere sovrascritto.Indicate whether the WSDL file for the Web Service task can be overwritten.

    Se si intende scaricare il file WSDL tramite il pulsante Scarica WSDL , impostare questo valore su True.If you intend to download the WSDL file by using the Download WSDL button, set this value to True.

    NomeName
    Consente di specificare un nome univoco per l'attività Servizio Web.Provide a unique name for the Web Service task. Tale nome viene utilizzato come etichetta nell'icona dell'attività.This name is used as the label in the task icon.

Nota

I nomi delle attività devono essere univoci all'interno di un pacchetto.Task names must be unique within a package.

DescriptionDescription
Consente di digitare una descrizione dell'attività Servizio Web.Type a description of the Web Service task.

Scarica WSDLDownload WSDL
Consente di scaricare il file WSDL.Download the WSDL file.

Questo pulsante non è attivato fino a quando non si fornisce il nome di un file locale esistente nella casella WSDLFile .This button is not enabled until you provide the name of an existing local file in the WSDLFile box.

Editor attività Servizio Web (pagina Input)Web Service Task Editor (Input Page)

Utilizzare la pagina Input della finestra di dialogo Editor attività Servizio Web per specificare il servizio Web, il metodo Web e i valori da fornire come input al metodo Web.Use the Input page of the Web Service Task Editor dialog box to specify the Web Service, the Web method, and the values to provide to the Web method as input. I valori possono essere immessi digitando direttamente le stringhe nella colonna Valore o selezionando le variabili nella colonna Valore.The values can be provided either by typing strings directly in the Value column, or by selecting variables in the Value column.

OpzioniOptions

ServizioService
Consente di selezionare un servizio Web nell'elenco da utilizzare per l'esecuzione del metodo Web.Select a Web service from the list to use to execute the Web method.

MetodoMethod
Consente di selezionare nell'elenco il metodo Web che l'attività deve eseguire.Select a Web method from the list for the task to execute.

WebMethodDocumentationWebMethodDocumentation
Digitare la descrizione del metodo Web oppure fare clic sul pulsante Sfoglia (…) e quindi digitare la descrizione nella finestra di dialogo Documentazione metodo Web .Type a description of Web method, or the click the browse button (…) and then type the description in the Web Method Documentation dialog box.

NomeName
Elenca i nomi degli input per il metodo Web.Lists the names of the inputs to the Web method.

TipoType
Elenca il tipo di dati degli input.Lists the data type of the inputs.

Nota

L'attività Servizio Web supporta unicamente i parametri dei tipi di dati seguenti: tipi primitivi come ad esempio valori integer e stringhe, matrici e sequenze di tipi primitivi ed enumerazioni.The Web Service task supports parameters of the following data types only: primitive types such as integers and strings; arrays and sequences of primitive types; and enumerations.

VariabileVariable
Selezionare le caselle di controllo per utilizzare le variabili per l'invio degli input.Select the check boxes to use variables to provide inputs.

ValoreValue
Se le caselle di controllo Variabile sono selezionate, selezionare le variabili nell'elenco per l'invio degli input. In caso contrario, digitare i valori da utilizzare negli input.If the Variable check-boxes are selected, select the variables in the list to provide the inputs; otherwise, type the values to use in the inputs.

Editor attività Servizio Web (pagina Output)Web Service Task Editor (Output Page)

Usare la pagina Output della finestra di dialogo Editor attività Servizio Web per specificare la posizione in cui archiviare il risultato restituito dal metodo Web.Use the Output page of the Web Service Task Editor dialog box to specify where to store the result returned by the Web method.

Opzioni staticheStatic Options

OutputTypeOutputType
Consente di selezionare il tipo di archiviazione da utilizzare per l'archiviazione dei risultati.Select the storage type to use when storing the results. Per questa proprietà sono disponibili le opzioni elencate nella tabella seguente.This property has the options listed in the following table.

ValoreValue DescriptionDescription
File ConnectionFile Connection Consente di archiviare i risultati in un file.Store the results in a file. La selezione di questo valore determina la visualizzazione dell'opzione dinamica File.Selecting this value displays the dynamic option, File.
VariabileVariable Consente di archiviare i risultati in una variabile.Store the results in a variable. La selezione di questo valore determina la visualizzazione dell'opzione dinamica Variabile.Selecting this value displays the dynamic option, Variable.

Opzioni dinamiche di OutputTypeOutputType Dynamic Options

OutputType = Connessione fileOutputType = File Connection

FileFile
Selezionare una gestione connessione file nell'elenco o fare clic su <Nuova connessione> per creare una nuova gestione connessione.Select a File connection manager in the list or click <New Connection…> to create a new connection manager.

Argomenti correlati: File Connection Manager, File Connection Manager EditorRelated Topics: File Connection Manager, File Connection Manager Editor

OutputType = VariabileOutputType = Variable

VariabileVariable
Selezionare una variabile nell'elenco oppure fare clic su <Nuova variabile> per crearne una nuova.Select a variable in the list or click <New Variable…> to create a new variable.

Argomenti correlati: Variabili di Integration Services (SSIS), Aggiungi variabileRelated Topics: Integration Services (SSIS) Variables, Add Variable

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.