Tarea Servicio Web
Actualizado: 17 de julio de 2006
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 conexión HTTP para conectarse al servicio Web. El administrador de conexión HTTP se configura independientemente de la tarea Servicio Web y se hace referencia a él en la tarea. El administrador de conexión 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 conexión HTTP.
El administrador de conexión 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 señala 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 conexión HTTP apunta a un sitio Web, el archivo WSDL se debe copiar manualmente en un equipo local.
- Si el administrador de conexión 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 sólo admite parámetros de los tipos de datos siguientes: tipos primitivos 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 conexión 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 inicios de sesión 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:
- Editor de la tarea Servicio Web (página General)
- Editor de la tarea Servicio Web (página Entrada)
- Editor de la tarea Servicio Web (página Salida)
- Página Expresiones
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:
Vea también
Conceptos
Tareas de Integration Services
Crear un flujo de control de paquetes
Ayuda e información
Obtener ayuda sobre SQL Server 2005
Historial de cambios
| Versión | Historial |
|---|---|
17 de julio de 2006 |
|
14 de abril de 2006 |
|