Nodo ResetContentDescriptor

Este tema contiene las siguientes secciones:

Finalidad

Utilice el nodo ResetContentDescriptor para solicitar que otro analizador vuelva a analizar el mensaje. Si el nuevo analizador es MRM, también puede especificar otra plantilla de mensaje (conjunto de mensajes, tipo de mensaje y formato). Este nodo no vuelve a analizar el mensaje, pero las propiedades que se establecen para este nodo determinan cómo se analiza el mensaje la próxima vez que se vuelve a analizar por el flujo de mensajes.

El nodo asocia la nueva información de analizador con la corriente de bits del mensaje de entrada. Si el mensaje ya se ha analizado para crear un árbol de mensajes y se ha modificado el contenido del árbol (por ejemplo, por un nodo Compute), el nodo ResetContentDescriptor debe invocar el analizador actual asociado con el mensaje para analizar el mensaje y volver a crear la corriente de bits.

Si el flujo de mensajes ha actualizado el mensaje antes de que lo reciba el nodo ResetContentDescriptor, debe asegurarse de que el contenido del mensaje modificado siga siendo válido para el analizador actual. Si no es así, el analizador genera un error cuando intenta volver a crear la corriente de bits a partir del árbol de mensajes y el nodo ResetContentDescriptor genera una excepción. Por ejemplo si se ha añadido un nuevo campo a un mensaje en el dominio de MRM y el campo no está en el modelo, no se puede volver a crear la corriente de bits.

El nodo ResetContentDescriptor no:

  • Cambia el contenido del mensaje. Cambia las propiedades del mensaje para especificar la forma en la que la corriente de bits se analizará la próxima vez que se invoque el analizador.
  • Convierta el mensaje de un formato a otro. Por ejemplo, si el mensaje de entrada tiene el formato de mensaje XML y el formato del mensaje de salida es CWF, el nodo ResetContentDescriptor no hace ningún reformateo. Invoca el analizador para volver a crear la corriente de bits del mensaje XML de entrada, que mantiene los códigos XML en el mensaje. Cuando un nodo subsiguiente vuelve a analizar el mensaje, los códigos XML no son válidos y el análisis falla.

El nodo ResetContentDescriptor se representa en el área de trabajo por el icono siguiente:

Icono de nodo ResetContentDescriptor

Utilización de este nodo en un flujo de mensajes

A continuación se describe un ejemplo de cómo se utiliza este nodo. Suponga que desea pasar del dominio BLOB al MRM y viceversa. El formato de un mensaje de entrada puede ser desconocido cuando entra un flujo de mensajes, por lo tanto se invoca el analizador BLOB. A continuación en el flujo de mensajes, puede decidir que el mensaje se predefina como un mensaje en el dominio de MRM y puede utilizar el nodo ResetContentDescriptor para establecer los valores correctos que se utilizarán cuando un nodo subsiguiente del flujo de mensajes analice el mensaje.

La siguiente tabla muestra las propiedades del nodo ResetContentDescriptor.

Propiedad Valor
Dominio del mensaje MRM
Restablecer dominio de mensaje Seleccionada
Conjunto de mensajes DH53CU406U001
Restablecer conjunto de mensajes Seleccionada
Tipo de mensaje m_MESSAGE1
Restablecer tipo de mensaje Seleccionada
Formato del mensaje CWF
Restablecer formato de mensaje Seleccionada

El dominio de mensajes se establece en MRM y se invoca el analizador MRM la siguiente vez que se analiza el mensaje. El formato, el tipo y el conjunto de mensajes son los valores de la plantilla de mensajes que definen el modelo de mensajes y todos los recuadros de selección de restablecer están seleccionados porque es necesario cambiar todas las propiedades.

El nodo ResetContentDescriptor hace que el analizador BLOB asociado con el mensaje de entrada construya la corriente de datos física del mensaje (no la representación del árbol lógico del mismo) que más adelante se pasa al analizador MRM. El analizador MRM pasa la analizador mediante la plantilla de mensaje (conjunto de mensajes, tipo de mensaje y formato del mensaje) especificada en el nodo ResetContentDescriptor.

Configuración del nodo ResetContentDescriptor

Después de transferir una instancia del nodo ResetContentDescriptor a un flujo de mensajes, puede configurarla. Pulse el botón derecho del ratón en el nodo en la vista de editor y pulse Propiedades. Se visualizan las propiedades básicas de nodo.

Todas las propiedades obligatorias para las que se debe entrar un valor (las que no tienen definido un valor por omisión) se marcan con un asterisco en el diálogo de propiedades.

Configure el nodo ResetContentDescriptor como se describe a continuación:

  1. Si desea asociar otro analizador al mensaje, especifique el nuevo dominio en Dominio del mensaje:
    • MRM
    • XML
    • JMSMap
    • JMSStream
    • BLOB

    También puede especificar un analizador Definido por el usuario, si procede.

    Seleccione el recuadro Restablecer dominio de mensaje.

  2. Si el analizador MRM va a volver a analizar el mensaje, especifique las otras propiedades del modelo que se van a asociar con el mensaje de entrada y seleccione el recuadro Restablecer... debajo de cada campo. Si el analizador MRM ya está asociado con el mensaje de entrada, sólo deberá especificar las propiedades que van a modificarse.
    1. Entre el conjunto de mensajes en Conjunto de mensajes. Elija un valor de la lista desplegable de conjuntos de mensajes disponibles (se muestran el nombre y el identificador del conjunto de mensajes).
    2. Especifique el identificador del mensaje en Tipo de mensaje. Este identificador puede encontrarse en las propiedades del mensaje en la vista del editor. El identificador del mensaje se ha especificado al crearlo. Escriba el identificador exactamente a como aparece en las propiedades del mensaje.
    3. Indique el formato del mensaje en Formato del mensaje. Esto especifica el formato físico del analizador MRM. Puede seleccionar uno de los formatos de la lista desplegable (que lista los identificadores de los formatos definidos en el conjunto de mensajes especificado anteriormente).

    Estas propiedades establecen el dominio, conjunto, tipo y formato que desea en la cabecera del mensaje que desea pasar a través del nodo ResetContentDescriptor. Sin embargo, esto sólo ocurre si ya existen cabeceras adecuadas. Si el mensaje no tiene una cabecera MQRFH2, el nodo no la crea.

  3. Deje en blanco las opciones Conjunto de mensajes, Tipo de mensaje y Formato del mensaje si ha especificado el analizador XML, JMS o BLOB.
  4. Seleccione Descripción en el navegador del diálogo de propiedades para entrar una descripción breve, una descripción larga o ambas.
  5. Pulse Aplicar para realizar los cambios en el nodo ResetContentDescriptor sin cerrar el diálogo de propiedades. Pulse Aceptar para aplicar los cambios y cerrar el diálogo de propiedades.

    Pulse Cancelar para cerrar el diálogo y descartar todos los cambios realizados en las propiedades.

Terminales y propiedades

Los terminales de nodo ResetContentDescriptor se describen en la tabla siguiente.

Terminal Descripción
Terminal de entrada Terminal de entrada que acepta un mensaje para que el nodo lo procese.
Terminal de anomalías Terminal de salida al que se direcciona el mensaje si el nodo detecta un error.
Terminal de salida Terminal de salida al que se direcciona el mensaje si las propiedades identifican un nuevo analizador.

En las siguientes tablas se describen las propiedades del nodo; la columna con la cabecera O indica si la propiedad es obligatoria (marcada con un asterisco en el diálogo de propiedades si se debe entrar un valor cuando no se ha definido ningún valor por omisión), la columna con la cabecera C indica si la propiedad es configurable (se puede cambiar el valor cuando se añade el flujo de mensajes al archivo bar para difundirlo).

Las propiedades básicas del nodo ResetContentDescriptor se describen en la siguiente tabla.

Propiedad O C Valor por omisión Descripción
Dominio del mensaje No No   El dominio de mensajes asociado con el mensaje que desea volver a analizar.
Restablecer dominio de mensaje No Sin seleccionar Si se debe restablecer el dominio de mensajes. Si selecciona el recuadro, se lleva a cabo la acción.
Conjunto de mensajes No No   El conjunto de mensajes asociado con el mensaje que desea volver a analizar.
Restablecer conjunto de mensajes No Sin seleccionar Si se debe restablecer el conjunto de mensajes. Si selecciona el recuadro, se lleva a cabo la acción.
Tipo de mensaje No No   El tipo de mensaje asociado con el mensaje que desea volver a analizar.
Restablecer tipo de mensaje No Sin seleccionar Si se debe restablecer el tipo de mensaje. Si selecciona el recuadro, se lleva a cabo la acción.
Formato del mensaje No No   El formato del mensaje asociado al mensaje que desea volver a analizar.
Restablecer formato de mensaje No Sin seleccionar Si se debe restablecer el formato del mensaje. Si selecciona el recuadro, se lleva a cabo la acción.

Las propiedades de descripción del nodo ResetContentDescriptor se describen en la siguiente tabla.

Propiedad O C Valor por omisión Descripción
Descripción corta No No   Breve descripción del nodo.
Descripción larga No No   Texto que describe la utilidad del nodo en el flujo de mensajes.

Conceptos relacionados
Flujos de mensajes
Analizadores
Diseño de mensajes

Tareas relacionadas
Cómo decidir los nodos que utilizar
Manejo de errores en flujos de mensajes