Abierto de navegación

La acción Enviar solicitud de servicio web Indica a Integration Service que envíe una solicitud HTTP a un servicio web (REST o SOAP).

You can configure the following properties for the Send Web Service Request action:

Acción

• Nombre: Especifica el nombre de la acción. Si lo desea, puede sustituir el nombre predeterminado escribiendo un nuevo nombre en este campo.

• Descripción: Permite guardar una descripción para la acción.

• Ejecutar acción: Permite especificar la frecuencia con la que quiera ejecutar la acción.

  • Siempre: Especifica que Integration Service ejecutará la acción cada vez que ejecute la integración.

  • Nunca: Especifica que Integration Service no ejecutará la acción cuando ejecute la integración.

  • Condicionalmente, en base a una variable: especifica que Integration Service ejecutará 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. Una vez que haya activado esta opción, puede crear la instrucción condicional en el cuadro de entrada.

    Controles del cuadro de entrada

    • Variable: Introduzca la variable que quiera utilizar como instrucción condicional. Alternativamente, puede añadir una variable para el valor de la instrucción condicional.

    • [Operador relacional]: Especifica el operador relacional que se utilizará para la instrucción condicional. Haga clic en el operador existente para abrir 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 el/los valor(es) que se utilizará(n) para la instrucción condicional. Algunos operadores, como Is null y Is not null, 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.

       

  • Con condiciones, en base a la expresión: Especifica las condiciones bajo las que Integration Service ejecutará la acción. Utilice esta opción para situaciones que requieran más de una instrucción condicional. Una vez que haya activado esta opción, puede crear la expresión condicional en el cuadro de entrada creando las instrucciones condicionales deseadas. 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. The default conditional joiner is And.

      Haga clic en la unión condicional existente para acceder al menú que le permitirá configurar su expresión condicional de una de las siguientes maneras:

      • Seleccione una unión condicional diferente: Las opciones del menú incluyen una lista de uniones condicionales. Seleccione la unión condicional 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: Disponible en el menú cuando el menú se haya abierto desde un subgrupo. Haga clic para eliminar el subgrupo.

      • Eliminarlo todo: Disponible en el menú cuando el menú se haya abierto desde el grupo de mayor nivel. Haga clic para eliminar todas las instrucciones condicionales (incluyendo subgrupos).

    • : Visible justo a la derecha de cada unión condicional de su expresión. Haga clic para añadir una declaración condicional para el grupo asociado con dicha unión.

    • : Visible cuando posiciona el cursor sobre una instrucción condicional existente. Haga clic para eliminar la declaración condicional.

    • Variable: Introduzca la variable que quiera utilizar como instrucción condicional. Alternativamente, puede añadir una variable para la instrucción condicional.

    • [Operador relacional]: Especifica el operador relacional que se utilizará para la instrucción condicional. Haga clic en el operador existente para abrir 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 el/los valor(es) que se utilizará(n) para la instrucción condicional. Algunos operadores, como Is null y Is not null, no requieren que se especifique ningún valor. En estas situaciones, se ocultará el campo Valor.

    • Tipo: Especifica si la declaración condicional evalúa un valor de texto o decimal.

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: Select the content-type to use for the web request. Disponible cuando haya seleccionado un método POST o PUT.

• Encabezados HTTP: Enter the HTTP header properties and values to be sent with the web request. You can select from a dictionary of HTTP header properties and values, or you can add a variable to specify the header property or value. You can also add a special character to the value you have entered.

Origen

• Datos de contenidos: Especifica el contenido que quiera enviar con un método HTTP de solicitud web POST o PUT. Disponible cuando haya seleccionado 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 haya seleccionado GET, DELETE o HEAD como Método.

  • Plantillas incrustadas:

    • Valor: Utilice el cuadro de entrada para escribir la plantilla que quiera que utilice la acción. Alternatively, you can add a variable to specify the template, or add a special character to the value you have entered.

    • Importar: Abre el cuadro de diálogo Abrir archivo para que pueda navegar y seleccionar el archivo que contiene el archivo de comandos deseado. 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.

  • Variable:

    • Variable: Escriba la variable que quiera utilizar como origen. Alternativamente, puede añadir una 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. For more information about supported cloud storage locations, see Administration Console's Cloud Storage Page.

    • Nombre de archivo: Especifica la ruta del archivo. Puede escribir la ubicación de la carpeta y el nombre del archivo, o hacer clic en Explorar para localizar y seleccionar el archivo deseado. Alternativamente, puede añadir una variable para especificar el archivo deseado, o añadir un carácter especial al valor que haya introducido.

    • Codificación de archivos: Especifica la codificación utilizada 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:

  • Anónimo: Allows any user to access the client without providing a user name and password.

  • Usar las actuales credenciales de Windows: Uses the current Windows user account to connect to the client.

  • Usar las credenciales especificadas: Uses the user name, domain, and password that you provide to connect to the client.

Respuesta

• Códigos de estado exitosos: Enables you to specify the status codes that you deem successful.

• Guardar respuesta del servicio web en la variable: Especifica la variable en la que quiera guardar la respuesta del servicio web. Enter the desired variable in the input box. Alternativamente, puede añadir una variable.

Opciones avanzadas

• Envolver contenido de origen en etiqueta de cuerpo SOAP: Specifies that the source content will be wrapped in a SOAP Body tag before being sent.

• Enviar tiempo de espera: Specifies the amount of time in seconds to wait for a response from the client before the action fails.

• Recuento de reintentos: Specifies the number of times to re-send the request if the action fails.

Probar Enviar solicitud de servicio web

• Prueba: Ejecuta la acción. El panel Mensaje indica si la acción se ha realizado con éxito o si ha fallado.

  Al hacer clic en el botón Prueba se ejecuta la acción, pero no la integración. Por lo tanto, la acción se ejecutará sin ningún dato de la integración que haya podido configurar para utilizarla conjuntamente con la acción. Para más información sobre cómo probar su integración, consulte Utilizar el panel Prueba.

Cuenta de usuario

• Heredar de la acción principal: Al activarla, 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, heredará las credenciales de la cuenta de usuario especificadas en la página de propiedades de la acción Agrupar inmediatamente superior.

• Especificar credenciales de usuario: Al activarla, la acción se ejecuta utilizando las credenciales especificadas.

Gestión de errores y diagnósticos

• Ignorar errores y continuar ejecutando acciones: Al activarla, especifica que en caso de que la acción falle, las demás acciones seguirán ejecutándose.

  Cuando esta propiedad no esté activada y la acción falle, el comportamiento resultante depende de los siguientes factores: Si ha especificado Secuencialmente para la propiedad Ejecutar acciones de la página Acciones o Agrupar jerárquica de la acción seleccionada, no se ejecutarán más acciones dentro del grupo. Si ha indicado En paralelo en la propiedad Ejecutar acciones de la página Acciones o Agrupar jerárquica de la acción seleccionada, las acciones del mismo grupo no se verán afectadas; los errores se ignoran y el resto de acciones del grupo se ejecutan con normalidad. Si la acción seleccionada está dentro de una acción Agrupar, no afectará a ninguna otra acción externa a dicha acción Agrupar.

• Reintentar si falla: Al activarla, especifica que en caso de que la acción falle, Integration Service intentará ejecutarlo de nuevo.

• Máximo reintentos: Especifica la cantidad máxima de veces que Integration Service volverá a intentar ejecutar la acción. Disponible al activar Reintentar si falla.

• Reintentar intervalo: Especifica el tiempo que Integration Service esperará después de que la acción haya fallado y antes de volver a ejecutarla. Disponible al activar Reintentar si falla.