Utilice el nodo ResetContentDescriptor para solicitar que el mensaje vuelva a analizarlo con un analizador distinto.
Este tema contiene las secciones siguientes:
Si especifica MRM como nuevo analizador, también puede especificar una plantilla de mensaje distinta (conjunto de mensajes, tipo de mensaje y formato de mensaje). Este nodo no vuelve a analizar el mensaje, pero las propiedades que establece para este nodo determina cómo se analiza el mensaje cuando el flujo de mensajes lo vuelve a analizar.
El nodo asocia la información del nuevo analizador con la corriente de bits del mensaje de entrada. Si el mensaje ya se ha analizado para crear un árbol de mensaje y el contenido del árbol se ha modificado (por ejemplo, mediante un nodo Compute), el nodo ResetContentDescriptor deberá volver a crear la corriente de bits desde el árbol de mensaje llamando al analizador actual.
Si el flujo de mensajes ha actualizado el mensaje antes de que lo reciba el nodo ResetContentDescriptor, asegúrese de que el contenido del mensaje modificado siga siendo válido para el analizador actual. Si el contenido no es válido, el analizador genera un error cuando intenta volver a crear la corriente de bits a partir del árbol de mensaje, y el nodo ResetContentDescriptor genera una excepción. Por ejemplo, si ha añadido un nuevo campo a un mensaje en el dominio MRM y el campo no está presente en el modelo, el proceso de volver a crear la corriente de bits falla.
El nodo ResetContentDescriptor no:
El nodo ResetContentDescriptor se encuentra en el cajón Transformación de la paleta y está representado en el entorno de trabajo por el siguiente icono:
Para obtener un ejemplo sobre cómo utilizar este nodo, supongamos que desea realizar un intercambio entre los dominios BLOB y MRM. Es posible que el formato de un mensaje de entrada sea desconocido cuando entra en un flujo de mensajes y, por lo tanto, se inicia el analizador BLOB. Posteriormente, en el flujo de mensajes, puede decidir que el mensaje está predefinido como un mensaje en el dominio MRM y, entonces, puede utilizar el nodo ResetContentDescriptor para establecer los valores correctos a utilizar cuando un nodo posterior del flujo de mensajes vuelve a analizar el mensaje.
Propiedad | Valor |
---|---|
Dominio de mensajes | MRM |
Restablecer dominio de mensajes | Seleccionado |
Conjunto de mensajes | DH53CU406U001 |
Restablecer conjunto de mensajes | Seleccionado |
Tipo de mensaje | m_MESSAGE1 |
Restablecer tipo de mensaje | Seleccionado |
Formato del mensaje | CWF |
Restablecer formato de mensaje | Seleccionado |
El Dominio de mensajes está establecido en MRM y se el analizador MRM se inicia cuando se vuelve a analizar el mensaje. El Conjunto de mensajes, Tipo de mensaje y el Formato del mensaje son los valores de plantilla que definen el modelo de mensaje, y todos los recuadros de selección de restablecimiento están seleccionados porque deben cambiarse todas las propiedades.
El nodo ResetContentDescriptor hace que el analizador BLOB asociado al mensaje de entrada cree la corriente de bits física del mensaje (no su representación lógica en árbol) que, posteriormente, se pasa al analizador MRM. Después, el analizador MRM analiza la corriente de bits utilizando la plantilla del mensaje (Conjunto de mensajes, Tipo de mensaje y Formato del mensaje) especificada en este nodo ResetContentDescriptor.
Cuando haya colocado una instancia del nodo ResetContentDescriptor en un flujo de mensajes, podrá configurar el nodo. Para ver más información, consulte el apartado Configurar un nodo de flujo de mensajes. Las propiedades del nodo se visualizan en la vista Propiedades, Para visualizar las propiedades del nodo en el diálogo Propiedades, efectúe una doble pulsación en el nodo o pulse con el botón derecho del ratón sobre el nodo y pulse Propiedades.
Todas las propiedades obligatorias para las que debe especificar un valor (las que no tienen un valor predeterminado definido) están marcadas con un asterisco.
También puede especificar un analizador definido por el usuario, si es adecuado.
Asimismo, debe seleccionar el recuadro de selección Restablecer dominio de mensajes.
Esta propiedades establecen los valores del dominio de mensajes, conjunto de mensajes, tipo de mensaje y formato del mensaje en la cabecera del mensaje que desee pasar a través del nodo ResetContentDescriptor. Sin embargo, estas acciones sólo se realizan si ya existen cabeceras adecuadas. Si el mensaje no tiene una cabecera MQRFH2, el nodo no la creará.
Deje Conjunto de mensajes, Tipo de mensaje y Formato de mensaje en blanco si ha especificado el analizador XML, JMS, MIME o BLOB.
Si cambia este valor por Inmediato, el análisis parcial se altera temporalmente y se analizan y validan todos los elementos de mensaje, excepto los tipos complejos con una composición de Elección o Mensaje que no se pueden resolver en ese momento. Si cambia este valor a Completo, el análisis parcial se altera temporalmente y se analiza y valida todo lo contenido en el mensaje; los tipos complejos con una composición de Elección o Mensaje que no se pueden resolver en ese momento producen una anomalía de validación.
Para obtener más información, consulte Análisis a petición.
Si desea ver información más detallada, consulte los apartados Validar mensajes y Propiedades de validación.
Los terminales del nodo ResetContentDescriptor 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 direcciona el mensaje si el nodo detecta un error. |
Out (de salida) | El terminal de salida al que se direcciona el mensaje si las propiedades identifican un nuevo analizador. |
Las tablas siguientes describen las propiedades de nodo. La columna con la cabecera O indica si la propiedad es obligatoria (marcada con un asterisco 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 BAR para desplegarlo).
En la tabla siguiente se describen las propiedades de descripción del nodo ResetContentDescriptor.
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Nombre de nodo | No | No | El tipo de nodo | El nombre del nodo. |
Descripción corta | No | No | Descripción breve del nodo. | |
Descripción larga | No | No | Texto que describe el propósito del nodo en el flujo de mensajes. |
En la tabla siguiente se describen las propiedades básicas del nodo ResetContentDescriptor.
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Dominio de mensajes | No | No | El dominio de mensajes asociado al mensaje que desea volver a analizar. | |
Restablecer dominio de mensajes | Sí | No | No seleccionado | Si selecciona el recuadro de selección de restablecimiento, la propiedad Dominio de mensajes se restablece. En este caso, si no selecciona un valor para la propiedad dominio de mensajes, el valor de la propiedad Dominio de mensajes es BLOB. |
Conjunto de mensajes | No | No | El conjunto de mensajes asociado al mensaje que desea volver a analizar. | |
Restablecer conjunto de mensajes | Sí | No | No seleccionado | Si selecciona el recuadro de selección de restablecimiento, la propiedad Conjunto de mensajes se restablece. En este caso, si no selecciona un valor para la propiedad Conjunto de mensajes, el valor de la propiedad Conjunto de mensajes está en blanco. |
Tipo de mensaje | No | No | El tipo de mensaje asociado al mensaje que desea volver a analizar. | |
Restablecer tipo de mensaje | Sí | No | No seleccionado | Si selecciona el recuadro de selección de restablecimiento, la propiedad Dominio de mensajes se restablece. En este caso, si no selecciona un valor para la propiedad Tipo de mensaje, el valor de la propiedad Tipo de mensaje está en blanco. |
Formato del mensaje | No | No | El formato de mensajes asociado al mensaje que desea volver a analizar. | |
Restablecer formato de mensaje | Sí | No | No seleccionado | Si selecciona el recuadro de selección de restablecimiento, la propiedad Formato de mensaje se restablece. En este caso, si no selecciona un valor para la propiedad Formato de mensaje, el valor de la propiedad Formato de mensaje está en blanco. |
Las propiedades de análisis del nodo ResetContentDescriptor se describen en la siguiente tabla.
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Temporización del análisis | No | No | A petición | Esta propiedad controla cuándo se analiza el mensaje reanalizado.
Los valores válidos son A
petición, Inmediato
y Completo. Si desea ver una descripción completa de esta propiedad, consulte Análisis a petición. |
Utilizar analizador compacto MQRFH2C para dominio MQRFH2 | No | No | No seleccionado | Esta propiedad controla si se utiliza el Analizador compacto MQRFH2C, en lugar del analizador MQRFH2, para las cabeceras MQRFH2. |
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 aparecerán bajo XMLNSC en los nodos que estén conectados al terminal de salida cuando la cabecera MQRFH2 de entrada o el Dominio 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 el mensaje reanalizado. 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 los comentarios | No | No | No seleccionado | Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensaje cuando encuentra comentarios en el mensaje reanalizado. 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 las 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 el mensaje reanalizado. 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. |
Las propiedades de validación del nodo ResetContentDescriptor se describen en la siguiente tabla. Para ver la descripción completa de estas propiedades, consulte Propiedades de validación.
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Validar | No | Sí | Ninguna | Esta propiedad controla si tiene lugar la validación. Los valores válidos son Ninguna, Contenido, Contenido y valor y Heredar. |
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 y valor o Contenido. Los valores válidos son Rastreo de usuario, Anotaciones de error locales, Excepción y Lista de excepciones. |
Incluir todas las limitaciones de valor | No | No | Seleccionado | Esta propiedad no se puede editar. Si selecciona este recuadro, se incluyen las comprobaciones de restricción de valor básicas en la validación de Contenido y valor. |
Arreglo | No | No | Ninguna | Esta propiedad no se puede editar. Los valores válidos son Ninguna y Todos. |