Tarea Servicio webWeb Service Task

Se aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions) sí SSIS Integration Runtime en Azure Data FactorySSIS Integration Runtime in Azure Data Factoryyes SSIS Integration Runtime en Azure Data FactorySSIS Integration Runtime in Azure Data FactorySe aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions) sí SSIS Integration Runtime en Azure Data FactorySSIS Integration Runtime in Azure Data Factoryyes SSIS Integration Runtime en Azure Data FactorySSIS Integration Runtime in Azure Data Factory

La tarea Servicio web ejecuta un método de servicio web.The Web Service task executes a Web service method. Puede usar la tarea Servicio web para los siguientes objetivos:You can use the Web Service task for the following purposes:

  • Escribir en una variable los valores devueltos por un método de servicio web.Writing to a variable the values that a Web service method returns. Por ejemplo, puede obtener la temperatura más alta del día con un método de servicio web y luego usar ese valor para actualizar una variable que se utiliza en una expresión que establece un valor de columna.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.

  • Escribir en un archivo los valores devueltos por un método de servicio web.Writing to a file the values that a Web service method returns. Por ejemplo, se puede escribir una lista de potenciales clientes en un archivo y luego utilizar el archivo como origen de datos en un paquete que limpia los datos antes de que se escriban en una base de datos.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.

Archivo WSDLWSDL File

La tarea Servicio web usa un administrador de conexiones HTTP para conectarse al servicio web.The Web Service task uses an HTTP connection manager to connect to the Web service. El administrador de conexiones HTTP se configura independientemente de la tarea Servicio web y se hace referencia a él en la tarea.The HTTP connection manager is configured separately from the Web Service task, and is referenced in the task. El administrador de conexiones HTTP especifica la configuración de proxy del servidor, como la dirección URL del servidor, las credenciales para obtener acceso al servidor de servicios web y la duración del tiempo de espera.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. Para obtener más información, vea Administrador de conexiones HTTP.For more information, see HTTP Connection Manager.

Importante

El administrador de conexiones HTTP solo es compatible con la autenticación anónima y la autenticación básica.The HTTP connection manager supports only anonymous authentication and basic authentication. No es compatible con la autenticación de Windows.It does not support Windows Authentication.

El administrador de conexiones HTTP puede apuntar a un sitio web o a un archivo de Lenguaje de descripción de servicios web (WSDL).The HTTP connection manager can point to a Web site or to a Web Service Description Language (WSDL) file. La dirección URL del administrador de conexiones HTTP que apunta a un archivo WSDL incluye el parámetro ?WSDL ; por ejemplo, https://MyServer/MyWebService/MyPage.asmx?WSDL.The URL of the HTTP connection manager that points to a WSDL file includes the ?WSDL parameter: for example, https://MyServer/MyWebService/MyPage.asmx?WSDL.

El archivo WSDL debe estar localmente disponible para configurar la tarea Servicio web mediante el cuadro de diálogo Editor de la tarea Servicio web que proporciona el Diseñador SSISSSIS .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.

  • Si el administrador de conexiones HTTP apunta a un sitio web, el archivo WSDL se debe copiar manualmente en un equipo local.If the HTTP connection manager points to a Web site, the WSDL file must be copied manually to a local computer.

  • Si el administrador de conexiones HTTP apunta a un archivo WSDL, el archivo se puede descargar desde el sitio web en un archivo local mediante la tarea Servicio web.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.

El archivo WSDL enumera los métodos que ofrece el servicio web, los parámetros de entrada que requieren los métodos, las respuestas que devuelven los métodos, y cómo comunicarse con el servicio 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.

Si el método usa parámetros de entrada, la tarea Servicio web requiere valores de parámetros.If the method uses input parameters, the Web Service task requires parameter values. Por ejemplo, un método de servicio web que recomienda el largo de los esquíes que debe comprar de acuerdo con su altura requiere que se proporcione su altura como parámetro de entrada.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. Los valores de parámetros se pueden proporcionar mediante cadenas que se definen en la tarea o mediante variables definidas en el ámbito de la tarea o en un contenedor principal.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. La ventaja de utilizar variables es que permiten actualizar dinámicamente los valores de parámetros mediante configuraciones de paquetes o scripts.The advantage of using variables is that they let you dynamically update the parameter values by using package configurations or scripts. Para obtener más información, vea Variables de Integration Services (SSIS) y Configuraciones de paquetes.For more information, see Integration Services (SSIS) Variables and Package Configurations.

Muchos métodos de servicio web no usan parámetros de entrada.Many Web service methods do not use input parameters. Por ejemplo, un método de servicio web que obtiene los nombres de los presidentes nacidos en el mes en curso no requiere un parámetro de entrada porque el servicio web puede determinar localmente cuál es el mes en curso.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.

Los resultados del método de servicio web se pueden escribir en una variable o un archivo.The results of the Web service method can be written to a variable or to a file. El administrador de conexiones Archivo se utiliza para especificar el archivo o para proporcionar el nombre de la variable en la que se deben escribir los resultados.You use the File connection manager either to specify the file or to provide the name of the variable to write the results to. Para más información, vea Administrador de conexiones de archivos e Variables de Integration Services (SSIS).For more information, see File Connection Manager and Integration Services (SSIS) Variables.

Mensajes de registro personalizados disponibles en la tarea Servicio webCustom Logging Messages Available on the Web Service Task

La siguiente tabla contiene las entradas del registro personalizadas que puede habilitar para la tarea Servicio web.The following table lists the custom log entries that you can enable for the Web Service task. Para obtener más información, vea Registro de Integration Services (SSIS).For more information, see Integration Services (SSIS) Logging.

Entrada del registroLog entry DescripciónDescription
WSTaskBeginWSTaskBegin La tarea inició el acceso a un servicio web.The task began to access a Web service.
WSTaskEndWSTaskEnd La tarea completó un método de servicio web.The task completed a Web service method.
WSTaskInfoWSTaskInfo Información descriptiva acerca de la tarea.Descriptive information about the task.

Configuración de la tarea Servicio webConfiguration of the Web Service Task

Puede establecer propiedades a través del Diseñador de SSISSSIS o mediante programación.You can set properties through SSISSSIS Designer or programmatically.

Para obtener más información acerca de las propiedades que puede establecer en el Diseñador SSISSSIS , haga clic en el tema siguiente:For more information about the properties that you can set in SSISSSIS Designer, click the following topic:

Para obtener más información sobre cómo establecer estas propiedades en el Diseñador SSISSSIS , haga clic en el siguiente tema:For more information about how to set these properties in SSISSSIS Designer, click the following topic:

Configuración mediante programación de la tarea Servicio webProgrammatic Configuration of the Web Service Task

Para obtener más información sobre cómo establecer estas propiedades mediante programación, haga clic en uno de los temas siguientes:For more information about programmatically setting these properties, click one of the following topics:

Editor de la tarea Servicio web (página General)Web Service Task Editor (General Page)

Use la página General del cuadro de diálogo Editor de la tarea Servicio web para especificar un administrador de conexiones de HTTP, especificar la ubicación del archivo de Lenguaje de descripción de servicios web (WSDL) que usa la tarea Servicio web, describir la tarea Servicios web y descargar el archivo 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.

OpcionesOptions

HTTPConnectionHTTPConnection
Seleccione un administrador de conexiones de la lista o haga clic en <New connection...> para crear uno.Select a connection manager in the list, or click <New connection...> to create a new connection manager.

Importante

El administrador de conexiones HTTP solo es compatible con la autenticación anónima y la autenticación básica.The HTTP connection manager supports only anonymous authentication and basic authentication. No es compatible con la autenticación de Windows.It does not support Windows Authentication.

Temas relacionados: Administrador de conexiones HTTP, Editor del administrador de conexiones HTTP (página Servidor)Related Topics: HTTP Connection Manager, HTTP Connection Manager Editor (Server Page)

WSDLFileWSDLFile
Escriba la ruta de acceso completa de un archivo WSDL local del equipo, o bien haga clic en el botón Examinar (…) y busque el archivo.Type the fully qualified path of a WSDL file that is local to the computer, or click the browse button (...) and locate this file.

Si ya ha descargado manualmente el archivo WSDL en el equipo, seleccione este archivo.If you have already manually downloaded the WSDL file to the computer, select this file. Sin embargo, si el archivo WSDL todavía no se ha descargado, siga estos pasos:However, if the WSDL file has not yet been downloaded, follow these steps:

  • Cree un archivo vacío que tenga la extensión ".wsdl".Create an empty file that has the ".wsdl" file name extension.

  • Seleccione este archivo vacío para la opción WSDLFile .Select this empty file for the WSDLFile option.

  • Establezca el valor de OverwriteWSDLFile en True para permitir que el archivo vacío se sobrescriba con el archivo WSDL real.Set the value of OverwriteWSDLFile to True to enable the empty file to be overwritten with the actual WSDL file.

  • Haga clic en Descargar WSDL para descargar el archivo WSDL real y sobrescribir el archivo vacío.Click Download WSDL to download the actual WSDL file and overwrite the empty file.

    Nota

    La opción Descargar WSDL no se habilita hasta que se proporciona el nombre de un archivo local existente en el cuadro WSDLFile .The Download WSDL option is not enabled until you provide the name of an existing local file in the WSDLFile box.

OverwriteWSDLFileOverwriteWSDLFile
Indica si el archivo WSDL de la tarea Servicio web se puede sobrescribir.Indicate whether the WSDL file for the Web Service task can be overwritten.

Si piensa descargar el archivo WSDL utilizando el botón Descargar WSDL , establezca este valor en True.If you intend to download the WSDL file by using the Download WSDL button, set this value to True.

NombreName
Proporcione un nombre único para la tarea Servicio web.Provide a unique name for the Web Service task. Este nombre se utiliza como etiqueta en el icono de tarea.This name is used as the label in the task icon.

Nota

Los nombres de tarea deben ser únicos en un paquete.Task names must be unique within a package.

DescripciónDescription
Escriba una descripción de la tarea Servicio web.Type a description of the Web Service task.

Descargar WSDLDownload WSDL
Descarga el archivo WSDL.Download the WSDL file.

Este botón no se habilita hasta que se proporciona el nombre de un archivo local existente en el cuadro WSDLFile .This button is not enabled until you provide the name of an existing local file in the WSDLFile box.

Editor de la tarea Servicio web (página Entrada)Web Service Task Editor (Input Page)

Use la página Entrada del cuadro de diálogo Editor de la tarea Servicio web para especificar el servicio web, el método web y los valores que se deben proporcionar como entrada para el método 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. Los valores se pueden proporcionar mediante la especificación directa de cadenas o la selección de variables en la columna Valor.The values can be provided either by typing strings directly in the Value column, or by selecting variables in the Value column.

OpcionesOptions

ServicioService
Seleccione en la lista un servicio web para ejecutar el método web.Select a Web service from the list to use to execute the Web method.

MétodoMethod
Seleccione en la lista un método web para la tarea que se va a ejecutar.Select a Web method from the list for the task to execute.

Documentación del método webWebMethodDocumentation
Escriba una descripción del método web, o bien haga clic en el botón Examinar (…) y escriba una descripción en el cuadro de diálogo Documentación del método 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.

NombreName
Muestra los nombres de las entradas del método web.Lists the names of the inputs to the Web method.

TipoType
Muestra los tipos de datos de las entradas.Lists the data type of the inputs.

Nota

La tarea Servicio web solo admite parámetros de los tipos de datos siguientes: tipos primitivos tales como enteros y cadenas; matrices y secuencias de tipos primitivos, y enumeraciones.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.

VariableVariable
Active las casillas para utilizar variables que proporcionen entradas.Select the check boxes to use variables to provide inputs.

ValorValue
Si las casillas de Variable están activadas, seleccione las variables de la lista para proporcionar entradas; en caso contrario, escriba los valores que se usarán en las entradas.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 de la tarea Servicio web (página Salida)Web Service Task Editor (Output Page)

Use la página Salida del cuadro de diálogo Editor de la tarea Servicio web para indicar dónde desea almacenar el resultado devuelto por el método 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.

Opciones estáticasStatic Options

OutputTypeOutputType
Seleccione el tipo de almacenamiento que desea usar para almacenar los resultados.Select the storage type to use when storing the results. Esta propiedad presenta las opciones indicadas en la siguiente tabla.This property has the options listed in the following table.

ValueValue DescripciónDescription
Conexión de archivosFile Connection Almacene los resultados en un archivo.Store the results in a file. Si selecciona este valor, se mostrará la opción dinámica Archivo.Selecting this value displays the dynamic option, File.
VariableVariable Almacene los resultados en una variable.Store the results in a variable. Si selecciona este valor, se mostrará la opción dinámica Variable.Selecting this value displays the dynamic option, Variable.

Opciones dinámicas de OutputTypeOutputType Dynamic Options

OutputType = Conexión de archivosOutputType = File Connection

ArchivoFile
Seleccione un administrador de conexiones de archivos de la lista o haga clic en <New Connection...> para crear uno.Select a File connection manager in the list or click <New Connection...> to create a new connection manager.

Temas relacionados: Administrador de conexiones de archivos, Editor de administrador de conexiones de archivosRelated Topics: File Connection Manager, File Connection Manager Editor

OutputType = VariableOutputType = Variable

VariableVariable
Seleccione una variable de la lista o haga clic en <New Variable...> para crear una.Select a variable in the list or click <New Variable...> to create a new variable.

Temas relacionados: Variables de Integration Services (SSIS), Agregar variableRelated Topics: Integration Services (SSIS) Variables, Add Variable

Vídeo How to: Call a Web Service by Using the Web Service Task (SQL Server Video) (Procedimiento para llamar a un servicio web con la tarea Servicio web [vídeo de SQL Server]), en technet.microsoft.com.Video, How to: Call a Web Service by Using the Web Service Task (SQL Server Video), on technet.microsoft.com.