Utilice el nodo ResetContentDescriptor para solicitar que el mensaje vuelva a analizarlo un analizador distinto.
Este tema contiene las secciones siguientes:
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:
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:
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 | 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.
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.
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.
Estas acciones sólo se realizan si existen cabeceras adecuadas. Si el mensaje no tiene una cabecera MQRFH2, el nodo no la creará.
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 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 | 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. |
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 | Sí | 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 | Sí | 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 | Sí | 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 | Sí | 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. |
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. |