Enviar solicitud de servicio web |
La acción Enviar solicitud de servicio web envía una solicitud HTTP a un servicio web (REST o SOAP).
Puede configurar las propiedades de la acción Enviar solicitud de servicio web en las siguientes fichas.
Solicitud de servicio web
URL: Introduzca la URL del servidor web de destino. Alternativamente, puede añadir una variable para definir la URL.
Método: Seleccione el método HTTP de la solicitud web que quiera utilizar. Las opciones incluyen POST, GET, PUT, DELETE, o HEAD.
Tipo de contenidos: Seleccione el tipo de contenidos a utilizar para la solicitud web. Disponible cuando seleccione un método POST o PUT.
Encabezados HTTP: Introduzca las propiedades y valores del encabezado HTTP que quiera enviar con la solicitud web. Puede seleccionar de un diccionario de propiedades y valores de encabezado HTTP, o puede agregar una variable para especificar la propiedad o valor del encabezado. También puede añadir un carácter especial al valor que introduzca.
Origen
Datos de contenidos: Especifica el contenido que quiera enviar con un método HTTP de solicitud web POST o PUT. Disponible cuando seleccione POST o PUT como Método.
Hilo de secuencia: Especifica la cadena de la solicitud que quiera enviar con un método HTTP de solicitud web GET, DELETE o HEAD. Disponible cuando seleccione GET, DELETE o HEAD como Método.
Valor: Utilice el cuadro de entrada para indicar la plantilla que quiera que utilice la acción. Alternativamente, puede añadir una variable para especificar la plantilla o añadir un carácter especial al valor que haya introducido.
Importar: Abre el cuadro de diálogo Abrir archivo para que pueda navegar y seleccionar un archivo que contenga el archivo de comandos que quiere. El contenido del archivo se importa al cuadro de entrada Valor.
Exportar: Abre el cuadro de diálogo Guardar archivo para que pueda guardar el contenido del cuadro de entrada Valor como un archivo externo. Puede guardar el valor como un nuevo archivo, o sustituir el contenido de un archivo existente.
Editar valor incrustado : Abre el cuadro de diálogo Valor para donde puede editar el valor del origen incrustado.
Variable:
Variable: Escriba la variable que quiera utilizar como origen. Alternativamente, haga clic en para seleccionar una variable utilizada recientemente, o haga clic en Más variables para abrir el cuadro de diálogo Insertar variable.
Archivo externo:
Ubicación: Especifica el sistema de archivos donde se encuentra la carpeta de origen. Los sistemas o ubicaciones de archivos pueden incluir sistemas de archivos o recursos de red, Librarian, o una ubicación de almacenamiento en la nube compatible. Para obtener más información sobre las ubicaciones de almacenamiento en la nube compatibles, consulte la
Nombre de archivo: Especifica la ruta del archivo. Puede escribir la ubicación de la carpeta o el nombre del archivo, o hacer clic en Examinar para localizar y seleccionar el archivo que quiera. Alternativamente, puede añadir una variable para especificar el archivo o añadir un carácter especial al valor que haya introducido.
Codificación de archivos: Especifica la codificación que utiliza por un archivo de origen.
Variable de solicitud HTTP:
Nombre de variable: Especifica el nombre de la variable de solicitud HTTP que quiera utilizar como origen.
Valor: Especifica el valor para la variable de la solicitud HTTP.
Autenticación
Método: Especifica el método de autenticación que la acción utiliza para conectarse al cliente.
Anónimo: Especifica que cualquier usuario pueda acceda al cliente, sin tener que indicar ningún nombre de usuario ni contraseña.
Usar las actuales credenciales de Windows: Especifica que se utiliza la actual cuenta de usuario de Windows para conectarse al cliente.
Usar las credenciales especificadas: Especifica que el nombre de usuario, el dominio y la contraseña que indique se utilizarán para conectarse al cliente.
Respuesta
Códigos de estado exitosos: Especifica los códigos de estado que considera correctos.
Guardar respuesta a variable: Especifica la variable en la que quiera guardar la respuesta del servicio web. Introduzca el mensaje que desee en el cuadro de texto. Alternativamente, puede añadir una variable.
Opciones avanzadas
Envolver contenido de origen en etiqueta de cuerpo SOAP: Especifica que el contenido del origen se envuelva en una etiqueta de cuerpo SOAP antes de enviarlo. Disponible cuando seleccione POST o PUT como Método.
Enviar tiempo de espera: Especifica el tiempo en segundos que se esperará por una respuesta del cliente de correo antes de que la acción se considere fallida.
Recuento de reintentos: Especifica la cantidad de intentos para reenviar la solicitud que se realizarán en caso de que la acción falle.
Acción
Nombre: Especifica el nombre de la acción. Puede sustituir el nombre predeterminado escribiendo un nuevo nombre en este campo.
Descripción: Especifica una descripción para la acción.
Ejecutar acción: Especifica la frecuencia con la que quiere ejecutar la acción.
Siempre: Especifica que Integration Service ejecuta la acción cada vez que ejecute la integración.
Nunca: Especifica que Integration Service no ejecuta la acción cuando ejecute la integración.
Condicionalmente, en base a una variable: Especifica que Integration Service ejecuta la acción solo cuando una variable seleccionada cumple una condición específica. Utilice esta opción en situaciones en las que solo haya una condición que determine si la acción se ejecutará o no. Después de seleccionar esta opción, puede crear la instrucción condicional en el cuadro de entrada.
Controles del cuadro de entrada
Variable: Especifica la variable que quiera utilizar como instrucción condicional. Introduzca la variable en el cuadro de entrada. Haga clic en para ver una lista de variables utilizadas recientemente, o haga clic en Más variables para abrir el cuadro de diálogo Insertar variable.
[Operador relacional]: Especifica el operador relacional que se utilizará para la instrucción condicional. Haga clic en el operador existente para que se muestre una lista de operadores adicionales y seleccione el que quiera utilizar. Para obtener más información, consulte Operadores ralacionales. Los operadores disponibles en la lista dependen de si ha seleccionado Texto o Decimal para la opción Tipo.
Valor: Especifica los valores que se utilizarán para la instrucción condicional. Para añadir un valor, haga clic en , haga clic en <introducir un valor>, introduzca el valor que desee y, a continuación, pulse Enter
. Para eliminar un valor, utilice el botón secundario del ratón para hacer clic en él y, a continuación, haga clic en Eliminar. Algunos operadores, como Is blank y Is not blank, no requieren que se especifique ningún valor. En estas situaciones, el campo Valor no estará disponible.
Tipo: Especifica si la declaración condicional evalúa un valor de texto o decimal.
Condicionalmente, en base a una expresión: Especifica las condiciones bajo las que Integration Service ejecuta la acción. Utilice esta opción para situaciones que requieran más de una instrucción condicional. Cuando selecciona esta opción, puede crear la expresión condicional en el cuadro de entrada creando las instrucciones condicionales que desee. Cree y edite su expresión condicional en la ficha Vista del árbol. Haga clic en la ficha Vista del texto para ver una vista del texto de solo lectura de la expresión condicional.
Controles del cuadro de entrada (Ficha Vista del árbol)
[Unión condicional]: Especifica la unión condicional para las instrucciones condicionales del grupo. La unión condicional predeterminada es Y.
Haga clic en la unión condicional existente para mostrar un menú que le permite configurar su expresión condicional de una de las siguientes maneras:
And, Or, NotAnd, NotOr: Haga clic en la unión condicional de la lista que quiera utilizar como instrucción condicional. Para obtener más información sobre las uniones condicionales compatibles, consulte Uniones condicionales.
Añadir condición: Haga clic para añadir otra instrucción condicional para el grupo actual.
Añadir grupo: Haga clic para añadir un subgrupo de instrucciones condicionales para el grupo actual.
Eliminar grupo: Haga clic para eliminar el subgrupo. Disponible cuando se abre el menú desde un subgrupo.
Eliminarlo todo: Haga clic para eliminar todas las declaraciones condicionales (incluyendo subgrupos). Disponible cuando se abre el menú desde el grupo más alto.
: Añade una declaración condicional para el grupo asociado con dicha unión. Visible a la derecha de cada unión condicional de su expresión.
: Elimina la declaración condicional. Visible a la derecha de una expresión condicional existente cuando se señala la expresión.
Variable: Especifica la variable que quiera utilizar como instrucción condicional. Introduzca la variable en el cuadro de entrada. Haga clic en para ver una lista de variables utilizadas recientemente, o haga clic en Más variables para abrir el cuadro de diálogo Insertar variable.
[Operador relacional]: Especifica el operador relacional que se utilizará para la instrucción condicional. Haga clic en el operador existente para que se muestre una lista de operadores adicionales y seleccione el que quiera utilizar. Para obtener más información, consulte Operadores ralacionales. Los operadores disponibles en la lista dependen de si ha seleccionado Texto o Decimal para la opción Tipo.
Valor: Especifica los valores que se utilizarán para la instrucción condicional. Para añadir un valor, haga clic en , haga clic en <introducir un valor>, introduzca el valor que desee y, a continuación, pulse Enter
. Para eliminar un valor, utilice el botón secundario del ratón para hacer clic en él y, a continuación, haga clic en Eliminar. Algunos operadores, como Is blank y Is not blank, no requieren que se especifique ningún valor. En estas situaciones, el campo Valor no estará disponible.
Tipo: Especifica si la declaración condicional evalúa un valor de texto o decimal.
Cuenta de usuario
Heredar de la acción principal: Especifica que la acción hereda las credenciales de la cuenta de usuario especificada en la página de propiedades Acciones. Alternativamente, si la acción es parte de una acción Agrupar, hereda las credenciales de la cuenta de usuario que se especifican en la página de propiedades de la acción Agrupar inmediatamente superior.
Especificar credenciales de usuario: Especifica que la acción se ejecuta utilizando las credenciales especificadas.
Gestión de errores y diagnósticos
Ignorar errores y continuar ejecutando acciones: Especifica que en caso de que la acción falle, las demás acciones siguen ejecutándose. Cuando no se selecciona esta opción y la acción falle, el comportamiento resultante depende de varios factores, como son:
La acción está dentro de una Acción de grupo
Si ha especificado Secuencialmente para la propiedad Ejecutar acciones en la ficha Ejecución de la acción Agrupar, no se ejecutan más acciones dentro de esa Acción de grupo. No afecta a ninguna acción ajena a esta Acción de grupo.
Si ha especificado En paralelo para la propiedad Ejecutar acciones en la ficha Ejecución de la acción Agrupar, los errores se ignoran y se ejecutan las demás acciones de esa Acción de grupo. No afecta a ninguna acción ajena a esta Acción de grupo.
La acción no está dentro de una Acción de grupo
Si ha especificado Secuencialmente para la propiedad Ejecutar acciones de la ficha Ejecución de Acciones, no se ejecutan más acciones de la integración.
Si ha especificado En paralelo para la propiedad Ejecutar acciones de la ficha Ejecución de Acciones, los errores se ignoran y se ejecutan las demás acciones de la integración.
Reintentar si falla: Especifica que en caso de que la acción falle, Integration Service intenta ejecutarlo de nuevo.
Máximo de reintentos: Especifica la cantidad máxima de veces que Integration Service vuelve a intentar ejecutar la acción. Disponible cuando se haya seleccionado la opción Reintentar si falla.
Reintentar intervalo: Especifica el tiempo que Integration Service espera después de que la acción falle y antes de volver a ejecutarla. Disponible cuando se haya seleccionado la opción Reintentar si falla.