Utilice el nodo HTTPRequest para interactuar con un servicio web.
El nodo HTTPRequest interactúa con un servicio web utilizando todo o parte del mensaje de entrada como la solicitud que se envía a ese servicio. También puede configurar el nodo para crear un mensaje de salida a partir del contenido del mensaje de entrada, aumentado por el contenido de la respuesta del servicio web, antes de propagar el mensaje a los siguientes nodos del flujo de mensajes.
En función de la configuración, este nodo construye una solicitud HTTP o HTTP sobre SSL (HTTPS) a partir del contenido especificado del mensaje de entrada, y envía esta solicitud al servicio web. El nodo recibe la respuesta del servicio web y analiza la respuesta para incluirla en el árbol de salida. El nodo genera cabeceras HTTP si su configuración las necesita.
Puede utilizar este nodo en un flujo de mensajes que contenga o no un nodo HTTPInput o HTTPReply.
El nodo HTTPRequest maneja los mensajes en los siguientes dominios de mensaje:
El nodo HTTPRequest se encuentra en el cajón HTTP de la paleta y está representado en WebSphere Message Broker Toolkit mediante el siguiente icono:
El URL tiene el formato http://<dirección>[:<puerto>]/<función>; por ejemplo, http://localhost:7080/request. Este URL se puede especificar estáticamente en los parámetros del nodo HTTPRequest como un campo en el propio mensaje, o como un campo en el entorno local. Los datos que se envían al servicio web pueden ser el árbol de mensaje completo, o una parte del mismo, según se especifique en las propiedades del nodo HTTPRequest.
Los datos deben estar en formato CCSID 1208 para la mayoría de las solicitudes. La respuesta puede sustituir al mensaje de entrada, o se puede insertar en el árbol de mensajes; la ubicación se especifica en los parámetros del nodo HTTPRequest. El dominio para la respuesta es XMLNS. Si la solicitud se realiza satisfactoriamente, la HTTPResponse se inserta al principio del árbol de mensajes, la respuesta se coloca en la ubicación especificada del árbol, y la solicitud se propaga al terminal Out (de salida). Si el nodo HTTPRequest no puede emitir la solicitud, se inserta una Lista de excepciones en el árbol de mensajes y el árbol se propaga al terminal Failure (de anomalías).
Set OutputRoot.XMLNS.error850 = CAST(InputRoot.XMLNS.error.BLOB as CHAR CCSID 850);
Para obtener información sobre HTTP, consulte Protocolo
de transferencia de hipertexto - HTTP/1.1.
Para obtener más información sobre los códigos de retorno HTTP, consulte Códigos de respuesta HTTP.Puede especificar un intervalo de tiempo de espera, de modo que si la solicitud tarda más qie la duración especificada, la solicitud se propaga al terminal Anomalías con un mensaje apropiado. Para cada solicitud que el nodo HTTPRequest procesa, éste abre una conexión y luego la cierra cuando se devuelve la respuesta. Si se especifica el tiempo de espera, el socket se cierra una vez transcurrido el intervalo. Este cierre asegura que una solicitud reciba solamente la respuesta correcta y que todos los datos de respuesta para una solicitud que ha excedido el tiempo de espera se descarten.
Puede utilizar el proxy HTTP para direccionar una solicitud a través de un sitio intermedio. Puede ejecutar herramientas como un proxy para ver la solicitud y la respuesta, y por consiguiente depurar sus flujos. El destino HTTP es tal como lo ve el proxy; si especifica el destino HTTP de localhost, y el proxy HTTP se está ejecutando en otro sistema, la solicitud se direcciona al sistema de proxy remoto, no al sistema desde el que se emitió la solicitud original.
El nodo HTTPRequest se puede utilizar en cualquier flujo de mensajes que tenga que enviar una solicitud HTTP. El ejemplo más común es un flujo de mensajes que invoca un servicio web.
Para obtener más información sobre servicios web, consulte Proceso de mensajes de servicio web.
El nodo interactúa directamente con un servicio externo utilizando TCP/IP; por consiguiente, puede experimentar los tipos de error siguientes:
Si el nodo detecta estos errores, genera una excepción, llena la lista de excepciones con la información de error recibida y dirige el mensaje de entrada sin modificar al terminal de anomalías.
La respuesta se produce como un mensaje BLOB porque el nodo no puede determinar en qué formato estará la respuesta. Si no ha configurado este nodo para que maneje la redirección, los mensajes con un código de estado de redirección (3xx) también se manejan del mismo modo.
El nodo HTTPRequest trata los códigos de estado de la serie 100 como una respuesta 'continuar', descarta la respuesta actual y espera otra respuesta del servidor web.
Los códigos de estado de la serie 200 se tratan como solicitud correcta, los valores de los diversos separadores del nodo determinan el formato del mensaje de salida que se genera y la respuesta se direcciona al terminal de salida del nodo.
Los códigos de estado de la serie 300 son para redirección. Si se selecciona la propiedad Seguir la redirección HTTP(s), el nodo reenvía la solicitud al nuevo destino especificado en la respuesta que se recibe. Si la propiedad Seguir la redirección HTTP(s) no está seleccionada, los códigos se tratan como un error, tal como se describe en Utilización del nodo HTTPRequest para emitir una solicitud a un servicio web. Para obtener más información sobre los códigos de retorno HTTP, consulte Códigos de respuesta HTTP.
Los códigos de estado de las series 400 y 500 son errores y se tratan como se describe en Utilización del nodo HTTPRequest para emitir una solicitud a un servicio web. Para obtener más información sobre los códigos de retorno HTTP, consulte Códigos de respuesta HTTP.
Si selecciona el mensaje de entrada Sustituir mensaje de entrada por respuesta de servicio web o Sustituir entrada con error, la cabecera del mensaje de entrada (la cabecera que pertenece al mensaje cuando llega al terminal In (de entrada) del nodo HTTPRequest) no se propaga con el mensaje que sale del nodo HTTPRequest. Sin embargo, si se especifica una de las propiedades que especifica una ubicación en el árbol de mensajes, las cabeceras del mensaje de entrada se propagan.
La cabecera HTTPResponse, que contiene las cabeceras que devuelve el servicio web remoto, es la primera cabecera del mensaje (después de Propiedades) que se propaga desde el nodo. Esta acción se adopta independientemente de las opciones que se seleccionen. Por lo tanto, para que la respuesta del nodo HTTPRequest se transfiera a una cola WebSphere MQ, manipule las cabeceras de forma que un MQMD sea la primera cabecera (después de Propiedades).
Si está sustituyendo el mensaje de entrada por una respuesta, puede copiar el MQMD del mensaje de entrada en el árbol de entorno antes del nodo HTTPRequest y, a continuación, volver a copiarlo en el árbol de mensajes después del nodo HTTPRequest. Si está especificando una ubicación para la respuesta, con el fin de mantener cabeceras de mensajes de entrada existentes, deberá mover o eliminar la cabecera de respuesta HTTP para que el MQMD sea la primera cabecera.
SET OutputRoot = InputRoot;
SET OutputRoot.HTTPResponseHeader = NULL;
SET OutputRoot = InputRoot;
DECLARE HTTPHeaderRef REFERENCE TO OutputRoot.HTTPResponseHeader;
DETACH HTTPHeaderRef;
ATTACH HTTPHeaderRef TO OutputRoot.MQMD AS NEXTSIBLING;
Cuando haya colocado una instancia del nodo HTTPRequest en un flujo de mensajes, podrá configurar el nodo; consulte el apartado Configurar un nodo de flujo de mensajes. Las propiedades del nodo se visualizan en la vista Propiedades.
Todas las propiedades obligatorias, para las que se debe entrar un valor, están marcadas con un asterisco.
Configure el nodo HTTPRequest:
Las dos primeras opciones proporcionan métodos dinámicos para establecer un URL para cada mensaje de entrada cuando éste pasa a través del flujo de mensajes. Para usar de estas opciones, incluya un nodo Compute en el flujo de mensajes, antes del nodo HTTPRequest, para crear e inicializar el valor necesario.
La tercera opción proporciona un valor que es fijo para cada mensaje recibido en este nodo. Establezca esta propiedad para que contenga un valor predeterminado que se utilice si los demás campos no se han creado o contienen un valor nulo. Si uno de los campos contiene un valor, se ignora el valor de esta propiedad. La propiedad URL de servicio web debe contener un URL válido o el despliegue falla. Asegúrese de que el valor que establece en X-Original-HTTP-URL o LocalEnvironment.Destination.HTTP.RequestURL es también un URL válido; si no lo es, el nodo utiliza el valor predeterminado de la propiedad URL de servicio web.
Si un URL empieza con http://, el nodo de solicitud realiza una solicitud HTTP al URL especificado. Si el URL empieza con https://, el nodo de solicitud realiza una solicitud HTTP sobre SSL (HTTPS) al URL especificado, utilizando los parámetros especificados en el separador SSL del nodo.
Si, como valor de la propiedad Versión HTTP, selecciona 1.1, también podrá seleccionar Habilitar el mantenimiento de activado de HTTP/1.1.
También puede especificar un analizador definido por el usuario, si es adecuado.
Para que el mensaje de error del servicio web se incluya en el mensaje de salida con parte del contenido del mensaje de entrada, deseleccione Sustituir entrada con error y establezca la propiedad Ubicación del mensaje de error. Si deselecciona esta propiedad, el nodo copia el mensaje de entrada en el mensaje de salida y escribe el mensaje de error del servicio web encima del contenido del mensaje de salida en la ubicación especificada (el mensaje de entrada mismo no se modifica).
Puede entrar cualquier referencia de campo ESQL válida, incluyendo expresiones dentro de la referencia, y nuevas referencias de campo (para crear un nodo en el árbol de mensajes para la respuesta). Por ejemplo, entre:
OutputRoot.XMLNSC.ABC.DEF
o Environment.WSError
Si selecciona Sustituir entrada con error, se ignora esta propiedad.
Para que el mensaje de solicitud contenga un subconjunto del mensaje de entrada, deseleccione Utilizar todo el mensaje de entrada como solicitud y establezca la propiedad Ubicación del mensaje de solicitud en el árbol.
Puede entrar cualquier referencia de campo ESQL válida, incluidas expresiones dentro de la referencia. Por ejemplo, entre:
InputRoot.XMLNSC.ABC
Si selecciona Utilizar todo el mensaje de entrada como solicitud, esta propiedad se ignora.
Cuando se analiza el contenido del árbol de mensajes adecuado para crear una corriente de bits, se utilizan las propiedades de mensaje (Dominio del mensaje, Conjunto de mensajes, Tipo de mensaje y Formato del mensaje) asociadas al texto del mensaje de entrada y almacenadas en la carpeta Propiedades.
Para que el mensaje de respuesta del servicio web se incluya en el mensaje de salida con parte del contenido del mensaje de entrada, deseleccione Sustituir mensaje de entrada por respuesta de servicio web y establezca la propiedad Ubicación del mensaje de respuesta en el árbol. Si deselecciona esta propiedad, el nodo copia el mensaje de entrada en el mensaje de salida y escribe el mensaje de respuesta del servicio web encima del contenido del mensaje de salida en la ubicación especificada (el mensaje de entrada mismo no se modifica).
Puede entrar cualquier referencia de campo ESQL válida, incluyendo expresiones dentro de la referencia, y nuevas referencias de campo (para crear un nodo en el árbol de mensajes para la respuesta). Por ejemplo, entre:
OutputRoot.XMLNSC.ABC.DEF
o Environment.WSReply
Si selecciona Sustituir mensaje de entrada por respuesta de servicio web, se ignora esta propiedad.
Cuando se analiza la corriente de bits de respuesta para crear el contenido del árbol de mensajes, se utilizan las propiedades de mensaje (Dominio del mensaje, Conjunto de mensajes, Tipo de mensaje y Formato del mensaje) que ha especificado en las propiedades de Análisis de mensajes de respuesta del nodo.
Si no desea que el nodo genere una HTTPRequestHeader para el mensaje de solicitud, deseleccione Generar cabeceras HTTP predeterminadas. Para controlar el contenido de la HTTPRequestHeader que se incluye en el mensaje de solicitud, incluya un nodo Compute que añada una HTTPRequestHeader al mensajes de entrada antes de este nodo HTTPRequest en el flujo de mensajes, y deseleccione este recuadro de selección.
El nodo HTTPRequest también añade las cabeceras de servicio web que aparecen en la tabla siguiente, con los valores predeterminados, si éstos no están ya en la HTTPRequestHeader o la HTTPInputHeader.
Cabecera | Valor predeterminado |
---|---|
SOAPAction | "" (serie vacía) |
Content-Type | text/xml; charset=ccsid del cuerpo de mensaje A no ser que el mensaje de entrada esté en el dominio JSON, en el que el valor predeterminado es: application/json; charset=ccsid del cuerpo de mensaje |
Host | El nombre de host al que se envía la solicitud. |
El nodo HTTPRequest también añade la cabecera opcional Content-Length con el valor calculado correcto, aunque este valor no esté presente en la HTTPRequestHeader o la HTTPInputHeader.
Si desea ver información más detallada, consulte Validar mensajes y Propiedades de validación.
Conecte el terminal Out (de salida), Error (de errores) o Failure (de anomalías) de este nodo a otro nodo de este flujo de mensajes para procesar posteriormente el mensaje, procesar errores o enviar el mensaje a un destino adicional. Si no conecta el terminal de errores, el mensaje se elimina. Si no conecta el terminal de anomalías, el intermediario proporcionará un proceso de errores predeterminado, consulte Manejar errores en flujos de mensajes.
Los terminales del nodo HTTPRequest están descritos en la siguiente tabla.
Terminal | Descripción |
---|---|
In (de entrada) | El terminal de entrada que acepta un mensaje para que lo procese el nodo. |
Failure (de anomalías) | El terminal de salida al que se dirige un mensaje si se ha detectado una anomalía durante su proceso en el nodo. |
Out (de salida) | El terminal de salida al que se direcciona el mensaje si representa la finalización satisfactoria de la solicitud de servicio web y si se requiere proceso adicional dentro del flujo de mensajes. |
Error | El terminal de salida al que se dirigen los mensajes que incluyen un código de estado HTTP que no está entre 200 y 299, incluidos los códigos de redirección (3xx) si no ha establecido la propiedad Seguir la redirección de HTTP(s). |
Las tablas siguientes describen las propiedades del nodo. La columna con la cabecera O indica si la propiedad es obligatoria (marcada con un asterisco en el panel si tiene que entrar un valor cuando no hay definido ningún valor predeterminado); la columna con la cabecera C indica si la propiedad es configurable (puede cambiar el valor cuando añade el flujo de mensajes al archivo de intermediario para desplegarlo).
Las propiedades de Descripción del nodo HTTPRequest están descritas en la siguiente tabla.
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Nombre de nodo | No | No | El tipo de nodo, HTTPRequest | El nombre del nodo. |
Descripción corta | No | No | Descripción breve del nodo. | |
Descripción larga | No | No | Texto que describe la finalidad del nodo en el flujo de mensajes. |
Las propiedades básicas del nodo HTTPRequest se describen en la siguiente tabla.
Propiedad | O | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
URL de servicio web | Sí | Sí | El URL del servicio web. Debe proporcionarlo en el formato
http://nombre_host[:puerto]/[vía_acceso]
donde
|
URLSpecifier | |
Tiempo de espera de solicitud (seg) | Sí | Sí | 120 | Tiempo, en segundos, que un nodo espera la respuesta del servicio web. El rango válido es de 1 a (231)-1. No se puede entrar un valor que represente una espera ilimitada. El tiempo de espera puede tardar un segundo más que el valor especificado. | timeoutForServer |
Las propiedades de valores HTTP del nodo HTTPRequest se describen en la siguiente tabla.
Propiedad | O | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
Ubicación de proxy HTTP(S) | No | Sí | Servidor proxy al que se envían solicitudes. Este valor debe estar en el formato nombre_host:puerto. | httpProxyLocation | |
Seguir la redirección HTTP(S) | No | No | No seleccionado | Si selecciona el recuadro, se siguen las redirecciones. Si lo deselecciona, no se siguen las redirecciones. | |
Versión de HTTP | No | Sí | 1.0 | Versión de HTTP a utilizar para las solicitudes. Los valores válidos son 1.0 y 1.1. | httpVersion |
Habilitar el mantenimiento de activado de HTTP/1.1 | No | Sí | Seleccionado (si Versión HTTP es 1.1) | Utilice el mantenimiento de activado de HTTP/1.1 | enableKeepAlive |
Método HTTP | No | No | POST | El método HTTP. Los valores válidos son POST, GET, PUT, DELETE y HEAD. De forma predeterminada, el nodo HTTPRequest utiliza el método HTTP POST cuando se conecta al servidor web remoto. HEAD se utiliza para determinar si está disponible un servicio; por ejemplo, puede utilizarlo un asignador de red que intenta averiguar qué servidores están activos y disponibles, y envía las cabeceras correctas (incluyendo content-length) pero no datos del cuerpo. | |
Usar compresión | No | Sí | None | Esta propiedad controla si el contenido de la
solicitud HTTP está comprimido. Puede seleccionar las opciones none, gzip, zlib (deflate) y deflate. Si la solicitud está comprimida, la cabecera
Content-Encoding se establece para indicar que el contenido está
comprimido. zlib (deflate) representa la combinación RFC 1950 + RFC 1951. deflate representa RFC 1951 únicamente. |
requestCompressionType |
Las propiedades de SSL del nodo HTTPRequest se describen en la siguiente tabla.
Propiedad | O | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
Protocolo | No | Sí | SSL | Protocolo SSL a utilizar al realizar una solicitud HTTPS. | protocolo |
Cifrados SSL permitidos | No | Sí | Lista separada por comas de cifrados a utilizar al realizar una solicitud SSL. El valor predeterminado de una Serie vacía significa que hay que utilizar todos los cifrados disponibles. | allowedCiphers | |
Habilitar comprobación de nombre de host de certificado SSL | No | Sí | No | Esta propiedad especifica si el nombre de host del servidor que está recibiendo la solicitud debe coincidir con el nombre de host en el certificado SSL. | hostnameChecking |
Alias de clave de autenticación de cliente SSL | No | Sí | "" (serie vacía) | Esta propiedad especifica un alias de autenticación SSL para el lado del cliente de una conexión HTTP. Tomar el valor predeterminado, significa elegir automáticamente la primera clave adecuada. | keyAlias |
En la tabla siguiente se describen las propiedades de Análisis de mensajes de respuesta del nodo HTTPRequest.
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Dominio de mensajes | No | No | BLOB | Dominio que se utiliza para analizar el mensaje. Si el campo está en blanco, el valor predeterminado es BLOB. |
Modelo de mensaje | No | No | Deseleccionado | Nombre o ubicación del archivo de esquemas de modelos de mensaje en el que se define el mensaje. Esta lista se llena con todos los archivos de esquemas de modelos de mensajes disponibles para el Dominio de mensajes que ha seleccionado. |
Mensaje | No | No | Deseleccionado | Nombre o ubicación de la raíz de mensaje dentro del archivo de esquemas de modelos de mensaje. Esta lista se llena con todos los mensajes disponibles que se han definido en el Modelo de mensaje que ha seleccionado. |
Formato físico | No | No | Deseleccionado | Nombre del formato físico del mensaje. Si está utilizando el analizador MRM o IDOC, seleccione el formato físico del mensaje de entrada de la lista. Esta lista incluye todos los formatos físicos que ha definido para este modelo de mensaje seleccionado. Si establece la propiedad Dominio de mensajes en DataObject, puede establecer esta propiedad en XML o IDoc ALE de SAP. Establezca esta propiedad en IDoc ALE de SAP cuando tenga que analizar una corriente de bits desde un origen externo y generar un árbol de mensajes. |
Las propiedades de Opciones de análisis del nodo HTTPRequest están descritas en la tabla siguiente.
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Temporización del análisis | No | No | A petición | Esta propiedad controla cuándo se analiza un mensaje de respuesta. Los valores válidos son A petición,
Inmediato y
Completo. Para obtener una descripción completa de esta propiedad, consulte Análisis a petición. |
Crear árbol utilizando los tipos de datos de esquema XML | No | No | No seleccionado | Esta propiedad controla si el analizador XMLNSC crea elementos de sintaxis en el árbol de mensajes con tipos tipos de datos tomados del esquema XML. Esta propiedad sólo se puede seleccionar si se establece la propiedad Validar del separador Validación en Contenido o Contenido y valor. |
Utilizar analizador compacto XMLNSC para dominio XMLNS | No | No | No seleccionado | Esta propiedad controla si el analizador compacto XMLNSC se utiliza para mensajes en el dominio XMLNS. Si establece esta propiedad, los datos del mensaje de respuesta aparecerán bajo XMLNSC en los nodos que estén conectados al terminal de salida cuando la cabecera MQRFH2 de entrada o el Dominio de las propiedades de Análisis de mensajes de respuesta sea XMLNS. |
Retener el contenido mixto | No | No | No seleccionado | Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensaje cuando encuentra texto mixto en un mensaje de respuesta. Si selecciona el recuadro, se crean elementos para el texto mixto. Si deselecciona el recuadro, el texto mixto se ignora y no se crea ningún elemento. |
Retener comentarios | No | No | No seleccionado | Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensaje cuando encuentra comentarios en un mensaje de respuesta. Si selecciona el recuadro, se crean elementos para los comentarios. Si deselecciona el recuadro, los comentarios se ignoran y no se crea ningún elemento. |
Retener instrucciones de proceso | No | No | No seleccionado | Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensaje cuando encuentra instrucciones de proceso en un mensaje de respuesta. Si selecciona el recuadro, se crean elementos para las instrucciones de proceso. Si deselecciona el recuadro, las instrucciones de proceso se ignoran y no se crea ningún elemento. |
Elementos opacos | No | No | Espacio en blanco | Esta propiedad se utiliza para especificar una lista de elementos en el mensaje de respuesta que se analizan opacamente por el analizador XMLNSC. El análisis opaco sólo se realiza si la validación no está habilitada (es decir, si la propiedad Validar está establecida en Ninguno); las entradas que se especifiquen en Elementos opacos se omiten si la validación está habilitada. |
Las propiedades de Manejo de errores del nodo HTTPRequest se describen en la siguiente tabla.
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Sustituir entrada con error | No | No | Seleccionado | Si selecciona este recuadro, el contenido del mensaje de entrada se sustituye por el contenido del mensaje de error. Si lo deselecciona, debe especificar Ubicación del mensaje de error. |
Ubicación del mensaje de error | Sí | No | OutputRoot | La ubicación de inicio en la que se almacenan los elementos analizados de la corriente de bits de error del servicio web. Esta propiedad toma la forma de una referencia de campo ESQL. |
Las propiedades Avanzadas del nodo HTTPRequest están descritas en la siguiente tabla.
Propiedad | O | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
Utilizar todo el mensaje de entrada como solicitud | No | No | Seleccionado | Si selecciona este recuadro, todo el cuerpo del mensaje de entrada se pasará al servicio web. Si deselecciona este recuadro, debe seleccionar Ubicación del mensaje de solicitud en el árbol. | |
Ubicación del mensaje de solicitud en el árbol | Sí | No | InputRoot | La ubicación de inicio desde la que se crea la corriente de bits para enviar al servicio web. Esta propiedad toma la forma de una referencia de campo ESQL. | |
Sustituir mensaje de entrada por respuesta de servicio web | No | No | Seleccionado | Si selecciona este recuadro, el mensaje de respuesta del servicio web sustituye la copia del mensaje de entrada como el contenido del mensaje de salida que se crea. Si deselecciona este recuadro, debe seleccionar Ubicación del mensaje de respuesta en el árbol. | |
Ubicación del mensaje de respuesta en el árbol | Sí | No | OutputRoot | La ubicación de inicio en la que se almacenan los elementos analizados de la corriente de bits de respuesta del servicio web. Esta propiedad toma la forma de una referencia de campo ESQL. | |
Generar cabeceras HTTP predeterminadas desde entrada | No | No | Seleccionado | Si selecciona este recuadro, se genera una HTTPRequestHeader. Si lo deselecciona, en el mensaje de entrada debe haber una HTTPRequestHeader válida. | |
Aceptar respuestas comprimidas por omisión | No | Sí | No seleccionado | Esta propiedad indica si el nodo de solicitud maneja
respuestas comprimidas de manera predeterminada. Si la cabecera de la solicitud no acepta una cabecera
Accept-Encoding y esta opción está seleccionada, el nodo establecerá la cabecera Accept-Encoding en "gzip, deflate" y
descomprimirá todas las respuestas comprimidas que se reciban.
Si el mensaje propagado al nodo Request incluye un cabecera Accept-Encoding, el flujo de mensajes o la aplicación cliente debe manejar las respuestas comprimidas. Por lo tanto, seleccionar esta opción no tiene ningún efecto en este caso. |
acceptCompressedResponses |
Las propiedades de validación del nodo HTTPRequest se describen en la siguiente tabla.
Para ver una descripción completa de estas propiedades, consulte Propiedades de validación.
Propiedad | O | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
Validar | No | Sí | Ninguna | Esta propiedad controla si tiene lugar la validación. Los valores válidos son Ninguno, Contenido y valor, Contenido y Heredar. | validateMaster |
Acción para anomalía | No | No | Excepción | Esta propiedad controla qué sucede si falla la validación. Sólo puede establecer esta propiedad si establece Validar en Contenido o Contenido y valor. Los valores válidos son Rastreo de usuario, Anotaciones de error locales, Excepción y Lista de excepciones. |
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Sucesos | No | No | Ninguno | Los sucesos que se han definido para el nodo se visualizan en este separador. De forma predeterminada, no se define ningún suceso de supervisión en ningún nodo en un flujo de mensajes. Utilice Añadir, Editar y
Suprimir para crear, cambiar o suprimir sucesos de supervisión para el nodo; consulte Configuración de orígenes de sucesos de supervisión utilizando propiedades de supervisión para obtener detalles. Puede habilitar e inhabilitar sucesos que se muestran aquí seleccionando o deseleccionando el recuadro Habilitado. |
Valor | Descripción |
---|---|
RequestURL | Altera temporalmente la propiedad
URL de servicio web en el nodo. Por ejemplo:
|
Timeout | Altera temporalmente la propiedad
Tiempo de espera de solicitud (segundos)
en el nodo. Por ejemplo:
|
TimeoutMillis | Altera temporalmente la propiedad
Tiempo de espera de solicitud (segundos)
en el nodo. Por ejemplo: se escribe
Esta propiedad define el tiempo de espera en milisegundos. El valor de TimeoutMillis altera temporalmente el valor de
Timeout si se han establecido los dos valores. |
ProxyURL | Altera temporalmente la propiedad Ubicación de proxy
HTTP(S) del nodo. Por ejemplo:
|
RequestLine.RequestURI | Altera temporalmente RequestURI,
que es la vía de acceso después del URL y el puerto. Por ejemplo:
|
RequestLine.HTTPVersion | Altera temporalmente la propiedad
Versión de HTTP en el nodo. Por ejemplo:
|
KeepAlive | Altera temporalmente la propiedad
Habilitar el mantenimiento de activado de HTTP/1.1
en el nodo. Por ejemplo:
|
RequestLine.Method | Altera temporalmente la propiedad
Método HTTP en el nodo. Por ejemplo:
|
SSLProtocol | Altera temporalmente SSLProtocol.
Por ejemplo:
Los valores válidos son: SSL, SSLv3 y TLS. |
SSLCiphers | Altera temporalmente la propiedad
Cifrados SSL permitidos en el nodo. Por
ejemplo:
|
ProxyConnectHeaders | Especifica cabeceras adicionales que se utilizan si la solicitud de salida es una conexión SSL a través de un
proxy. Estas cabeceras adicionales se envían con una solicitud CONNECT inicial al proxy. Por ejemplo, cuando utiliza SSL puede enviar información de autenticación proxy a un servidor proxy. Puede enviar varias cabeceras, pero cada una de ellas debe estar separada por un retorno de carro y un salto de línea (ASCII 0x0D 0x0A), de acuerdo con RFC2616; por ejemplo:
Este valor sólo se utiliza si la solicitud es una solicitud SSL a través de un servidor proxy. Para enviar información de autenticación proxy para una solicitud no SSL, especifique las cabeceras individuales en la carpeta HTTPRequestHeader, tal como se muestra en el siguiente ejemplo:
|
UseFolderMode | Establece UseFolderMode. Se utiliza para la
generación de corriente de bits; para ciertos analizadores, esto cambia la corriente
de bits de salida. Por ejemplo:
|
QueryString | Permite los valores de los parámetros de serie de consulta de salida. Cada parámetro se debe establecer de forma individual. Por ejemplo:
Los valores
ESQL anteriores dan como resultado la siguiente serie de consulta que se va a codificar (en función de http://tools.ietf.org/html/rfc3986) y se envían con la solicitud de salida:
Si el
URL de destino ya tiene un parámetro de consulta (o más de uno), los parámetros adicionales que se especifiquen se añadirán a la lista existente. |
QueryStringCCSID | Especifica que, antes de la codificación, los parámetros de serie de consulta se deben convertir en un juego de caracteres que no sea el predeterminado, que es UTF-8. En primer lugar, los parámetros de serie de consulta se convierten en el CCSID especificado antes de que la serie resultante se codifique, según RFC3986.
Por ejemplo:
El ESQL anterior da como resultado que los parámetros QueryString que convierten en la página de códigos 943 antes de codificarlos. Nota: los parámetros de serie de consulta deben contener datos en Unicode. |
Compression | Altera temporalmente la propiedad
Usar compresión del nodo. Por ejemplo:
Para establecer un tamaño mínimo (en bytes)
en el que aplicar la compresión, utilice la siguiente alteración temporal:
|
WrittenDestination = (
HTTP = (
RequestURL = 'http://127.0.0.1:7800/HTTPFLOW' (CHARACTER)
Compression = (
OriginalSize = 53 (INTEGER)
CompressedSize = 71 (INTEGER)
)
)
)