Utilice la actividad Recibir solicitud HTTP para configurar el Dispositivo de integración para que actúe como un escuchador de HTTP.
En la siguiente ilustración se muestra al Dispositivo de integración actuando como un escuchador de HTTP.
La actividad
Recibir solicitud HTTP es una actividad de iniciador.
Cuando en el Dispositivo de integración se despliega una orquestación que comienza con una actividad
Recibir solicitud HTTP, el Dispositivo de integración actúa como un escuchador de HTTP que espera solicitudes HTTP. Cuando se recibe una solicitud HTTP, se producen las siguientes acciones:
- Se inicia un trabajo de orquestación.
- La actividad Recibir solicitud HTTP procesa la solicitud HTTP entrante y correlaciona la solicitud HTTP con los parámetros de salida de la actividad.
- Los parámetros de salida se correlacionan con las variables de orquestación especificadas. Durante el tiempo de diseño en la tarea Correlacionar salidas de la Lista de comprobación, se define la correlación entre los parámetros de salida y las variables de la orquestación.
- Se procesan las actividades restantes en la orquestación. (En la representación gráfica de la orquestación, las actividades restantes son las actividades ubicadas en la parte derecha de la actividad Recibir solicitud HTTP).
De forma predeterminada, la descompresión se activa para la actividad
Recibir solicitud HTTP. Para obtener más información,
consulte
Descompresión con la actividad Recibir solicitud HTTP.
Adición de una actividad Recibir solicitud HTTP a la orquestación
- Cree o abra una orquestación. Se visualiza una representación gráfica de la orquestación.
- Seleccione el separador Actividades y expanda la carpeta HTTP.
- Arrastre la actividad Recibir solicitud a la orquestación.
- Seleccione la actividad. La Lista de comprobación se visualiza con la tarea Resumen activa en el panel de propiedades. El panel de propiedades se localiza debajo de la representación gráfica de la orquestación en el espacio de trabajo.
Crear, seleccionar o editar un punto final HTTP
- Pulse la tarea Elegir punto final de la Lista de comprobación y elija una de las siguientes acciones:
- Seleccione un punto final existente:
- Seleccione Examinar. Se mostrará el Explorador de proyectos.
- Seleccione un punto final existente y pulse Aceptar.
Salte al procedimiento "Configurar la actividad".
- Seleccione un punto final existente y edítelo:
- Seleccione Examinar. Se mostrará el Explorador de proyectos.
- Seleccione un punto final existente y pulse Aceptar.
- Pulse Editar. Se mostrará el panel Editar punto final.
- Cree un punto final. Seleccione Nuevo. Se mostrará el panel Crear punto final.
- Cree o edite un punto final HTTP, consulte Creación o edición de un punto final HTTP.
Configuración de la actividad
- Seleccione la tarea Configurar en la Lista de comprobación. Se mostrará el panel Configurar.
- Configure todos los campos y casillas de verificación en este panel, como se describe en la siguiente tabla:
Tabla 1. Campo |
Descripción |
URL (Vía de acceso después de nombre de host) |
Especifica la vía de acceso de recurso a través de la que el Dispositivo de integración escucha las solicitudes HTTP entrantes, por ejemplo: /mypath.
La serie que especifique en este campo debe excluir la serie http://,
el nombre de host y el número de puerto del Dispositivo de integración. El URL completo que utiliza el Dispositivo de integración para escuchar solicitudes HTTP entrantes se construye automáticamente a partir del nombre de host del Dispositivo de integración, el número de puerto especificado en el punto final HTTP y la vía de acceso especificada en este campo. Por ejemplo, si el URL completo a través del que el Dispositivo de integración escucha las solicitudes HTTP es http://myAR:myPort/myPath,
en este campo sólo necesita especificar la serie: /myPath. La vía de acceso especificada debe ser exclusiva para las actividades Recibir solicitud HTTP que se despliegan al mismo tiempo en el mismo Dispositivo de integración utilizando el mismo puerto. Nota: La vía de acceso a través de la que el Dispositivo de integración escucha las solicitudes HTTP entrantes es una serie de vía de acceso de recurso que se puede especificar y que no se corresponde con la vía de acceso al directorio real en el Dispositivo de integración.
|
Del tipo |
Especifica el tipo de mensaje esperado de la solicitud HTTP: Texto o Binario. |
Necesita respuesta |
Especifica si debe enviarse una respuesta al remitente de la solicitud. Nota: Si esta casilla de verificación está seleccionada, debe añadir y configurar una actividad Enviar respuesta HTTP en su orquestación.
|
Utilizar compresión/descompresión |
Especifica si la compresión/descompresión está activada o desactivada en el nivel de actividad. De forma predeterminada, el recuadro de selección Utilizar compresión/descompresión está seleccionado. Borre la casilla de verificación Utilizar compresión/descompresión para inhabilitar la descompresión para esta actividad. Para obtener más información, consulte Compresión con la actividad Enviar respuesta HTTP. |
Correlacionar la salida de la actividad
- Seleccione la tarea Correlacionar salidas en la Lista de comprobación. Los parámetros de salida de la actividad se mostrarán en el panel Desde actividad de la tarea Correlacionar salidas como se describe en la siguiente tabla:
Tabla 2. Parámetro de salida |
Descripción |
httpheaders |
Especifica la cabecera de la solicitud HTTP. |
body |
Especifica el cuerpo del mensaje de la solicitud HTTP. |
La siguiente tabla define los nodos del parámetro de salida opcional httpheaders. Tabla 3. Nodos del parámetro de salida httpheaders |
Descripción |
httpheaders/uri |
Especifica la vía de acceso de recurso de la solicitud entrante, por ejemplo: /myPath. |
httpheaders/method |
Especifica el tipo de solicitud HTTP. Para esta actividad, POST es el tipo de solicitud HTTP. |
httpheaders/otherHeaders/headerItem |
Especifica un elemento que contiene un conjunto de parámetros de cabecera HTTP como pares de nombre-valor. Se pueden especificar varios parámetros de cabecera HTTP en la solicitud HTTP, puesto que se trata de un nodo recurrente. |
httpheaders/otherHeaders/headerItem/name |
Especifica el nombre del parámetro de cabecera HTTP. |
ttpheaders/otherHeaders/headerItem/value |
Especifica el valor del parámetro de cabecera HTTP. |
- Cree una correlación entre el parámetro o parámetros de salida de la actividad y la variable o variables de la orquestación. Consulte Creación de una correlación para obtener instrucciones
generales sobre las correlaciones.
Nota: Para probar una orquestación que comienza con la actividad Recibir solicitud HTTP, puede utilizar el programa HTTP Post incluido en la instalación de Studio para enviar solicitudes HTTP al Dispositivo de integración de escucha durante el tiempo de ejecución. Puede acceder al programa HTTP Post
desde el menú de inicio seleccionando la opción . El URL que especifique en el URL del campo de conector entrante debe contener el URL completo, por ejemplo: http://myAR:myPort/myPath.