WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Nodo ResetContentDescriptor

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

Este tema contiene las secciones siguientes:

Finalidad

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.

Si especifica MRM como el nuevo analizador, también puede especificar una plantilla de mensaje distinta (conjunto de mensajes, tipo de mensaje y formato de mensaje). Si especifica DFDL como el nuevo analizador, también puede especificar una Ubicación de esquema y una Raíz de documentos diferentes. Este nodo no vuelve a analizar el mensaje, pero las propiedades que establece para este nodo determinan cómo se analiza el mensaje cuando el flujo de mensajes lo vuelve a analizar.

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.
  • Convierte el mensaje de un formato a otro; por ejemplo, si el mensaje entrante tiene un formato de mensaje XML y el formato del mensaje saliente es binario, el nodo ResetContentDescriptor no realiza ninguna reasignación de formato. Inicia el analizador para volver a crear la corriente de bits del mensaje XML entrante, 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 análisis falla.

El nodo ResetContentDescriptor se encuentra en la bandeja Construcción de la paleta y está representado en el WebSphere Message Broker Toolkit 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 DFDL
Restablecer dominio de mensajes Seleccionado
Modelo de mensaje MyMessageModel
Restablecer modelo de mensaje Seleccionado
Mensaje m_MESSAGE1
Restablecer mensaje Seleccionado
Formato físico  
Restablecer formato físico Seleccionado

El Dominio de mensajes está establecido en DFDL y se el analizador DFDL se inicia cuando se vuelve a analizar el mensaje. Modelo de mensaje y 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 valor de la propiedad Modelo de mensaje se proporciona de forma automática.

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.

En la Versión 6.1, no necesita incluir un nodo ResetContentDescriptor después de un nodo XSLTransform en el flujo de mensajes para establecer el Dominio de mensajes, Conjunto de mensajes, Tipo de mensaje y Formato del mensaje del mensaje generado por el nodo XSLTransform. El nodo XSLTransform realiza esa función.

Configuración del nodo ResetContentDescriptor

Cuando haya colocado una instancia del nodo ResetContentDescriptor en un flujo de mensajes, podrá configurarlo. Para obtener más información, consulte Configurar un nodo de flujo de mensajes.Las propiedades del nodo se visualizan en la vista 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 renombrar 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:
      • DFDL
      • XMLNSC
      • DataObject
      • JSON
      • BLOB
      • MIME
      • MRM
      • JMSMap
      • JMSStream
      • XMLNS

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

      También debe marcar el recuadro de selección Restablecer dominio de mensajes.

      Si deja la propiedad Dominio de mensajes en blanco y no marca el recuadro de selección Restablecer dominio de mensajes, no se restablecerá el dominio. Si deja en blanco la propiedad Dominio de mensajes y marca el recuadro de selección Restablecer dominio de mensajes, el valor predeterminado es BLOB.

    2. Si el analizador MRM, XMLNSC 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 marca un recuadro de selección para una propiedad y no ha especificado ningún valor para esa propiedad, el valor de la propiedad se restablece en blanco. O bien, si ha especificado un valor para dicha propiedad, la propiedad no está en blanco. Si no selecciona el recuadro de selección de restablecimiento, el valor para dicha propiedad se hereda del mensaje de entrada. Si el analizador ya está asociado al mensaje de entrada, especifique únicamente las propiedades que deben cambiarse.
      1. Defina el Modelo de mensaje. Elija un valor en la lista de modelos de mensaje disponibles (se muestra el nombre y el identificador del modelo de mensaje) y marque el recuadro de selección Restablecer modelo de mensaje.
      2. Para los dominios MRM y DFDL, defina el nombre del mensaje en Mensaje. Escriba el nombre y marque el recuadro de selección Restablecer mensaje.
      3. Para MRM e IDOC, defina el Formato físico. Esta propiedad especifica el formato físico del analizador. Puede seleccionar uno de los formatos de la lista (que incluye los nombres de los formatos que ha definido en el Modelo de mensaje especificado previamente) y seleccione Restablecer formato físico.

      Estas acciones sólo se realizan si existen cabeceras adecuadas. Si el mensaje no tiene una cabecera MQRFH2, el nodo no la creará.

  3. En el subseparador 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.

      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 la finalidad del nodo en el flujo de mensajes.

En la tabla siguiente se describen las propiedades básicas del nodo ResetContentDescriptor.

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 BLOB 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.
Modelo de mensaje No No   El nombre o ubicación del archivo de esquema de modelo de mensaje en el que está definido el mensaje que desea volver a analizar. Esta lista se llena con todos los archivos de esquema de modelo de mensaje disponibles.
Restablecer modelo de mensaje No No seleccionado Si marca el recuadro de selección de restablecimiento, la propiedad Ubicación de esquema se restablece. En este caso, si no selecciona un valor para la propiedad Ubicación de esquemael valor de la propiedad Ubicación de esquema está en blanco.
Mensaje No No   El nombre o ubicación de un elemento global que modela un documento de datos entero y está incluido en su archivo de esquema de modelo de mensaje. Esta lista se llena con todos los mensajes disponibles que se han definido en el Modelo de mensaje que ha seleccionado.
Restablecer mensaje No No seleccionado Si marca el recuadro de selección de restablecimiento, la propiedad Raíz de documentos se restablece. En este caso, si no selecciona un valor para la propiedad Raíz de documentos, el valor de la propiedad Raíz de documentos está en blanco.
Formato físico No No   No es necesario seleccionar el formato físico del mensaje que desea volver a analizar si utiliza el dominio DFDL. El formato físico del mensaje está definido en el archivo de esquema DFDL que ha seleccionado.
Restablecer formato físico No No seleccionado Si marca el recuadro de selección de restablecimiento, la propiedad Formato físico se restablece. En este caso, si no selecciona un valor para la propiedad Formato físico, el valor de la propiedad Formato físico está en blanco.

Las propiedades de Opciones 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 solicitud Esta propiedad controla cuándo se analiza el mensaje reanalizado. Los valores válidos son A solicitud, Inmediato y Completo.

Si desea ver una descripción completa de esta propiedad, consulte Análisis a petición.

Utilizar analizador compacto MQRFH2C para cabecera MQRFH2 No No No seleccionado Esta propiedad controla si se utiliza el analizador compacto MQRFH2C, en lugar del analizador MQRFH2, para las cabeceras MQRFH2.
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 se visualizará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 mensajes 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 mensajes 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 mensajes 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.
Elementos opacos No No Espacio en blanco Esta propiedad se utiliza para especificar una lista de elementos del mensaje reanalizado que el analizador XMLNSC deba analizar de forma opaca. El análisis opaco sólo se realiza si la validación no está habilitada (es decir, si el valor de 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 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 Propiedad de mandato mqsiapplybaroverride
Validar No Ninguna Esta propiedad controla si tiene lugar la validación. Los valores válidos son Ninguno, Contenido, Contenido y valor 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 y valor o Contenido. Los valores válidos son Rastreo de usuario, Anotaciones de error locales, Excepción y Lista de excepciones.  
Las propiedades de supervisión del nodo se describen en la siguiente tabla.
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.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 16:58:21


Tema de referenciaTema de referencia | Versión 8.0.0.5 | ac04810_