Nodo ResetContentDescriptor

Este tema contiene las secciones siguientes:

Finalidad

Utilice el nodo ResetContentDescriptor para solicitar que el mensaje lo vuelva a analizar un analizador distinto. Si el nuevo analizador es MRM, también puede especificar una plantilla de mensaje distinta (conjunto, tipo 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, con un nodo Compute), el nodo ResetContentDescriptor debe invocar el analizador 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 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:

  • Cambia el contenido del mensaje. Cambia las propiedades del mensaje para especificar la manera en que se analizará la corriente de bits la próxima vez que se invoque al analizador.
  • Convierte el mensaje de un formato a otro. Por ejemplo, si el mensaje de entrada tiene el formato de mensaje XML y el formato de mensaje de salida es CWF, el nodo ResetContentDescriptor no realiza ninguna reasignación de formato. Invoca el analizador para volver a crear la corriente de bits del mensaje XML de entrada, que conserva los códigos XML en el mensaje. Cuando, posteriormente, otro nodo vuelve a analizar el mensaje, los códigos XML no son válidos y el proceso de volver a analizar falla.

El nodo ResetContentDescriptor se representa en el entorno de trabajo con el siguiente icono:

Icono de nodo ResetContentDescriptor

Utilización de este nodo en un flujo de mensajes

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, por lo que en este caso se invoca 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.

La tabla siguiente muestra las propiedades normales del nodo ResetContentDescriptor.

Propiedad Valor
Dominio de mensajes MRM
Restablecer dominio de mensaje 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 invoca el analizador MRM cuando se vuelve a analizar el mensaje. El conjunto, el tipo y el formato de mensaje son los valores de plantilla de mensajes que definen el modelo de mensaje, y todos los recuadros 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 de árbol lógico) que, posteriormente, se pasa al analizador MRM. A continuación, el analizador MRM analiza la corriente de bits utilizando la plantilla de mensaje (Conjunto de mensajes, Tipo de mensaje y Formato del mensaje) especificada en este nodo ResetContentDescriptor.

Configuración del nodo ResetContentDescriptor

Una vez ha puesto una instancia del nodo ResetContentDescriptor en un flujo de mensajes, puede configurarlo. Pulse el botón derecho del ratón en el nodo en la vista de editor y pulse Propiedades. Aparecen las propiedades básicas del nodo.

Todas las propiedades obligatorias para las que ha de entrar un valor (las que no tienen definido un valor predeterminado) aparecen con un asterisco en el diálogo de propiedades.

Configure el nodo ResetContentDescriptor de la manera siguiente:

  1. Si desea un analizador distinto asociado al mensaje, especifique el nuevo dominio en Dominio de mensajes:
    • MRM
    • XML
    • JMSMap
    • JMSStream
    • MIME
    • BLOB

    También puede especificar un analizador definido por el usuario, si es adecuado.

    Seleccione el recuadro Restablecer dominio de mensaje.

  2. Si el analizador MRM debe volver a analizar el mensaje, especifique las otras propiedades del modelo que deben asociarse al mensaje de entrada y seleccione el recuadro Restablecer... debajo de cada campo. Si el analizador MRM ya está asociado al mensaje de entrada, sólo debe especificar las propiedades que van a cambiar.
    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. Entre el identificador del mensaje en Tipo de mensaje. Puede encontrar este identificador en las propiedades del mensaje en la vista de editor. El identificador del mensaje se especifica al crear el mensaje. Entre el identificador exactamente como aparece en las propiedades del mensaje.
    3. Entre el formato del mensaje en Formato de mensaje. De este modo se especificará el formato físico para el analizador MRM. Puede seleccionar uno de los formatos de la lista desplegable (que lista los identificadores de esos formatos que ha definido en el conjunto de mensajes especificado más arriba).

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

  3. Deje Conjunto de mensajes, Tipo de mensaje y Formato de mensaje en blanco si ha especificado el analizador XML, JMS, MIME o BLOB.
  4. Seleccione Validación en el navegador del diálogo de propiedades si desea que el analizador MRM valide el cuerpo de los mensajes contra el diccionario generado del conjunto de mensajes. (Si un mensaje se propaga al terminal de anomalías del nodo, no se valida.)

    Si desea ver más información detallada, consulte los apartados Validar mensajes y Propiedades de validación para mensajes del dominio MRM.

  5. Seleccione Descripción en el navegador del diálogo de propiedades para entrar una descripción corta, una descripción larga, o ambas.
  6. Pulse Aplicar para efectuar 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 eliminar todos los cambios que ha efectuado en las propiedades.

Terminales y propiedades

Los terminales del nodo ResetContentDescriptor se describen 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 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 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).

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

Propiedad O C Valor predeterminado Descripción
Dominio de mensajes No No   El dominio del mensaje asociado al mensaje que desea volver a analizar.
Restablecer dominio de mensaje No No seleccionado Indica si debe restablecerse el dominio del mensaje. Si selecciona el recuadro, se realizará esta acción.
Conjunto de mensajes No No   El conjunto de mensajes asociado al mensaje que desea volver a analizar.
Restablecer conjunto de mensajes No No seleccionado Indica si debe restablecerse el conjunto de mensajes. Si selecciona el recuadro, se realizará esta acción.
Tipo de mensaje No No   El tipo de mensaje asociado al mensaje que desea volver a analizar.
Restablecer tipo de mensaje No No seleccionado Indica si debe restablecerse el tipo de mensaje. Si selecciona el recuadro, se realizará esta acción.
Formato del mensaje No No   El formato de mensaje asociado al mensaje que desea volver a analizar.
Restablecer formato de mensaje No No seleccionado Indica si debe restablecerse el formato del mensaje. Si selecciona el recuadro, se realizará esta acción.

En la tabla siguiente se describen las propiedades de Validación del nodo ResetContentDescriptor. Consulte el apartado Propiedades de validación para mensajes del dominio MRM para obtener una descripción completa de estas propiedades.

Propiedad O C Valor predeterminado Descripción
Validar Ninguno Determina si se realiza la validación. Los valores válidos son Ninguno, Contenido, Contenido y valor y Heredar.
Acción para anomalía No Excepción Determina 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 Seleccionado Esta propiedad no se puede editar. La acción predeterminada, indicada por el recuadro de selección marcado, es que se incluyan las comprobaciones de restricción de valor básicas en la validación de Contenido y valor.
Arreglo No Ninguno Esta propiedad no se puede editar. Los valores válidos son Ninguno y Todos.

En la tabla siguiente se describen las propiedades de las Opciones de mensajes generales para el nodo ResetContentDescriptor.

Propiedad O C Valor predeterminado Descripción
Temporización del análisis No A petición Esta propiedad controla cuándo se analiza un mensaje de entrada. Los valores válidos son A petición, Inmediato y Completo.

Consulte Análisis a petición para obtener una descripción completa de esta propiedad.

Utilizar analizador compacto MQRFH2C para dominio MQRFH2 No No Falso Esta propiedad controla si se utiliza el Analizador compacto MQRFH2C, en lugar del analizador MQRFH2, para las cabeceras MQRFH2.

En la tabla siguiente se describen las opciones de analizador XMLNSC para el nodo ResetContentDescriptor.

Propiedad O C Valor predeterminado Descripción
Utilizar analizador compacto XMLNSC para dominio XMLNS No seleccionado No Inicio del cambioEsta propiedad le permite controlar si se utiliza el analizador compacto XMLNSC para mensajes en el dominio XMLNS. Tenga en cuenta que 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 RFH2 de entrada o el Dominio de las propiedades predeterminadas sea XMLNS.Fin del cambio
Modalidad de retención de contenido mixto No Ninguno Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensaje cuando encuentra texto mixto en un mensaje de entrada. Los valores válidos son Ninguno y Todos. Si se selecciona Todos, significa que se crean elementos para el texto mixto. Si se selecciona Ninguno, significa que el texto mixto se ignora y no se crea ningún elemento.
Modalidad de retención de comentarios No Ninguno Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensaje cuando encuentra comentarios en un mensaje de entrada. Los valores válidos son Ninguno y Todos. Si se selecciona Todos, significa que se crean elementos para los comentarios. Si se selecciona Ninguno, significa que se ignoran los comentarios y no se crean elementos.
Modalidad de retención de instrucciones de proceso No Ninguno Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensaje cuando encuentra instrucciones de proceso en un mensaje de entrada. Los valores válidos son Ninguno y Todos. Si se selecciona Todos, significa que se crean elementos para las instrucciones de proceso. Si se selecciona Ninguno, significa que se ignoran las instrucciones de proceso y no se crean elementos.

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

Propiedad O C Valor predeterminado Descripción
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.
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
ac04810_