Nodo ResetContentDescriptor

Utilice el nodo ResetContentDescriptor para solicitar que el mensaje vuelva a analizarlo con un analizador distinto.

Este tema contiene las secciones siguientes:

Finalidad

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:

  • 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 inicie el analizador.
  • Transforma el formato del mensaje en otro formato; por ejemplo, si el mensaje entrante tiene un formato de mensaje XML y el formato del mensaje saliente es CWF, el nodo ResetContentDescriptor no realiza ninguna reasignación de formato. Inicia 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 un nodo posterior 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 encuentra en el cajón Transformación de la paleta y está representado en el entorno de trabajo por 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 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.

La tabla siguiente muestra las propiedades normales del nodo ResetContentDescriptor.
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.

Configuración del 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.

  1. Opcional: en el separador Descripción, entre una Descripción corta, una Descripción larga o ambas cosas. En este separador también puede redenominar el nodo.
  2. En el separador Básicas:
    1. Para utilizar un analizador distinto asociado al mensaje, especifique el nuevo dominio en la propiedad Dominio de mensajes:
      • MRM
      • XML
      • XMLNS
      • XMLNSC
      • JMS
      • JMSStream
      • IDOC
      • MIME
      • BLOB

      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.

    2. Si el analizador MRM o IDOC ha de volver a analizar el mensaje, especifique las demás propiedades del modelo que deben asociarse al mensaje de entrada y seleccione el recuadro de selección de restablecimiento debajo de cada campo. Si el analizador ya está asociado al mensaje de entrada, especifique únicamente las propiedades que deben cambiarse.
      1. Defina el Conjunto de mensajes. Elija un valor de la lista de conjuntos de mensajes disponibles (se muestran el nombre y el identificador del conjunto de mensajes) y seleccione el recuadro de selección Restablecer conjunto de mensajes.
      2. Sólo para MRM, defina el nombre del identificador 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. Especifique el identificador exactamente como aparece en las propiedades de mensaje y seleccione el recuadro de selección Restablecer tipo de mensaje.
      3. Para MRM e IDOC, defina el Formato del mensaje. Esta propiedad especifica el formato físico del analizador. Puede seleccionar uno de los formatos de la lista (que indica los identificadores de los formatos que ha definido en el Conjunto de mensajes especificado anteriormente), y seleccione Restablecer formato del mensaje.

      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.

  3. En el separador Opciones de análisis :
    1. De forma predeterminada, Temporización de análisis está establecido en A petición con lo cual el análisis del mensaje se retrasa.

      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.

    2. Seleccione Utilizar analizador compacto MQRFH2C para la cabecera MQRFH2 si desea que se utilice el analizador MQRFH2C. Por omisión, este recuadro no está seleccionado, lo que significa que no se utiliza el analizador compacto.
    3. Si está usando el analizador XMLNSC, establezca valores para las propiedades que determinan el funcionamiento del analizador XMLNSC. Para obtener más información, consulte Manipular mensajes en el dominio XMLNSC.
  4. En el separador Validación, establezca las propiedades de validación si desea que el analizador valide el texto de los mensajes a partir del Conjunto de mensajes. (Si un mensaje se propaga al terminal de anomalías del nodo, no se valida.)

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

Terminales y propiedades

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 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 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 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 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 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.
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última actualización : 2009-02-16 13:53:44

ac04810_