Share via


Tarea Servicio web

La tarea Servicio web ejecuta un método de servicio web. Puede usar la tarea Servicio web para los siguientes objetivos:

  • Escribir en una variable los valores devueltos por un método de servicio web. 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.

  • Escribir en un archivo los valores devueltos por un método de servicio web. 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.

La tarea Servicio web usa un administrador de conexiones HTTP para conectarse al servicio web. El administrador de conexiones HTTP se configura independientemente de la tarea Servicio web y se hace referencia a él en la tarea. 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. Para obtener más información, vea Administrador de conexiones HTTP.

Nota importanteImportante

El administrador de conexiones HTTP solo es compatible con la autenticación anónima y la autenticación básica. No es compatible con la autenticación de Windows.

El administrador de conexiones HTTP puede apuntar a un sitio web o a un archivo de Lenguaje de descripción de servicios web (WSDL). La dirección URL del administrador de conexión HTTP que apunta a un archivo WSDL incluye el parámetro ?WSDL; por ejemplo, http://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 SSIS.

  • Si el administrador de conexiones HTTP apunta a un sitio web, el archivo WSDL se debe copiar manualmente en un equipo local.

  • 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.

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.

Si el método usa parámetros de entrada, la tarea Servicio web requiere valores de parámetros. 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. 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. La ventaja de utilizar variables es que permiten actualizar dinámicamente los valores de parámetros mediante configuraciones de paquetes o secuencias de comandos. Para obtener más información, vea Variables de Integration Services y Configuraciones de paquetes.

[!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.

Muchos métodos de servicio web no usan parámetros de entrada. 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.

Los resultados del método de servicio web se pueden escribir en una variable o un archivo. 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. Para obtener más información, vea Administrador de conexión de archivos y Variables de Integration Services.

Mensajes de registro personalizados disponibles en la tarea Servicio web

La siguiente tabla contiene las entradas del registro personalizadas que puede habilitar para la tarea Servicio web. Para obtener más información, vea Implementar el registro en paquetes y Mensajes personalizados para registro.

Entrada del registro

Descripción

WSTaskBegin

La tarea inició el acceso a un servicio web.

WSTaskEnd

La tarea completó un método de servicio web.

WSTaskInfo

Información descriptiva acerca de la tarea.

Configurar la tarea Servicio web

Puede establecer propiedades a través del Diseñador SSIS o mediante programación.

Para obtener más información acerca de las propiedades que puede establecer en el Diseñador SSIS, haga clic en uno de los temas siguientes:

Para obtener más información sobre cómo establecer estas propiedades en el Diseñador SSIS, haga clic en el siguiente tema:

Configurar la tarea Servicio web mediante programación

Para obtener más información sobre cómo establecer estas propiedades mediante programación, haga clic en uno de los temas siguientes:

Icono de Integration Services (pequeño) Manténgase al día con Integration Services

Para obtener las más recientes descargas, artículos, ejemplos y vídeos de Microsoft, así como soluciones seleccionadas de la comunidad, visite la página de Integration Services en MSDN o TechNet:

Para recibir notificaciones automáticas de estas actualizaciones, suscríbase a las fuentes RSS disponibles en la página.