Puede utilizar el asistente de Nuevo archivo de definición de mensajes en el
WebSphere Message Broker Toolkit para crear una nueva definición de mensajes desde un esquema XML.
Consejo: En
WebSphere Message
Broker Versión 8.0 y posteriores, los archivos de
esquema de modelo de mensaje contenidos en aplicaciones y bibliotecas son el
método preferido para modelar mensajes para la mayoría de formatos de datos. Los
conjuntos de mensajes son necesarios si utiliza los dominios MRM o IDOC.
Para obtener más información sobre el modelado de mensajes, consulte
Conceptos de modelado de mensajes. Para obtener información sobre cómo crear un esquema XML, consulte
Crear un archivo de esquema XML utilizando el asistente Nuevo modelo de mensaje.
Antes de empezar debe haber realizado las siguientes tareas:
Antes de empezar esta tarea, debe tener en cuenta los puntos siguientes:
- Si está importando una colección de archivos de esquemas XML relacionados, se le aconseja que utilice el mandato mqsicreatemsgdefs.
Esto importa todos los archivos de esquema XML en una sola operación y ajusta automáticamente las vías de acceso de importación e inclusión.
- Si el conjunto de mensajes al que está añadiendo el nuevo archivo de
definición de mensajes tiene una capa de formato físico XML, pero
no tiene soporte de espacio de nombres, el esquema importado se
modifica para eliminar los espacios de nombres. Por esta razón,
deberá habilitar el soporte de espacio de nombres antes de importar un esquema.
- Si el conjunto de mensajes al que está añadiendo el nuevo archivo de definición de mensajes
no tiene una capa de formato físico XML, pero
tiene soporte de espacios de nombres, sólo aparecerá
la información lógica en el modelo.
Por esta razón, deberá añadir la capa física al conjunto de mensajes antes de importar el esquema. Esto
asegura que el conjunto de mensajes se llena con las definiciones y los valores del esquema. El esquema XML no se modifica para eliminar
los espacios de nombres.
- Si el conjunto de mensajes al que está añadiendo el nuevo archivo de definición de
mensajes no tiene una capa de formato físico XML
y no tiene soporte de espacios de nombres, sólo aparecerá
la información lógica en el modelo y el esquema importado se modificará para eliminar
los espacios de nombres.
- Si está trabajando con un conjunto de mensajes que no tiene soporte de espacios de nombres,
deberá especificar las preferencias que se aplicarán al importar un esquema al conjunto de
mensajes. Estas preferencias le permiten especificar cómo trata el importador
determinadas construcciones de esquemas individuales. Puede rechazar el esquema si se encuentran
apariciones de la construcción o si modifica apariciones de la construcción. Si elige modificar, el importador modificará todas las apariciones de la construcción.
- La extensión del archivo de esquema XML debe ser .xsd en minúsculas.
Los pasos siguientes son necesarios para crear un archivo de definición de mensajes completamente nuevo o
sobrescribir el contenido de un archivo existente.
Para crear una definición de mensaje a partir de un archivo de esquema
XML:
- Vaya a la perspectiva
Desarrollo de aplicaciones de intermediario.
- Abra el asistente de Nuevo archivo de definición de
mensajes pulsando Archivo > Nuevo > Archivo de definición de
mensajes en el menú del WebSphere Message Broker Toolkit. Alternativamente, puede abrir el asistente pulsando el botón derecho del ratón en un archivo *.xsd
importado anteriormente al WebSphere
Message Broker Toolkit y pulsando Nuevo > Archivo de definición de
mensajes en el menú.
- En la lista de opciones visualizada, pulse Archivo de esquema XML para seleccionarlo y, a continuación, pulse
Siguiente.
- Siga los pasos restantes del asistente y proporcione los detalles según sea necesario. El tiempo de proceso para importar el esquema XML varia en función del tamaño y de la complejidad de dicho esquema. En un
esquema grande y complejo, puede tardar algún tiempo en importar el archivo, generar el archivo de registro y visualizar los avisos o
errores de lista de tareas.
Cuando haya finalizado la importación del esquema XML utilizando el asistente:
- Examine detenidamente el archivo de registro para ver si hay avisos
o errores en el informe que se crea al importar el archivo. Estos avisos y mensajes de error proporcionan información que indica si el
esquema no se ha podido importar o si era necesario modificarlo para permitirle que se importara satisfactoriamente.
Puede encontrar este
informe en la estructura de directorios log del proyecto que contiene la definición del mensaje
que ha intentado
crear. El informe tiene una
extensión de archivo .xsd.report.txt, con el
nombre que ha especificado para el nuevo archivo de definición de mensajes
como prefijo.
- Revise los mensajes que aparecen en la lista de tareas del WebSphere Message Broker Toolkit para comprobar si han aparecido
avisos o mensajes de error nuevos. Aunque puede haber importado un esquema perfectamente válido, la lista de tareas visualizará los avisos
o mensajes de error de los errores que existen en el archivo de definición de mensajes. Las siguientes situaciones son ejemplos de lugares en los que aparecen los mensajes:
- Si el esquema XML que está importando contiene construcciones xsd:key, xsd:keyref
y xsd:unique, aparecerán mensajes de aviso en la lista de tareas para indicarle que
no se soportan estas construcciones y que el intermediario las ignorará. Si prefiere suprimir estas construcciones, abra el archivo de definición de mensajes en el
Editor de definiciones de mensajes y suprima las construcciones como se describe en el
apartado Conjuntos de mensajes: suprimir objetos.
Al suprimir las construcciones también
se eliminan los mensajes de aviso de la lista de tareas. Si decide no suprimir las construcciones, éstas permanecerán en el modelo de
mensaje pero no se desplegarán en el intermediario ni se utilizarán con ninguna otra finalidad. Los mensajes de aviso permanecen en la
lista de tareas,
pero se podrá utilizar normalmente el modelo de mensaje.
- Si el esquema XML que va a importar contiene construcciones xsd:redefine, aparecerán mensajes de error en la lista de tareas para
indicarle que esta construcción no está soportada. Si pulsa el botón derecho del ratón en los
mensajes de error y selecciona
Arreglo rápido, puede elegir convertir las construcciones
xsd:redefine en construcciones xsd:include. De este modo también se suprimen los mensajes de error.
- Si el esquema XML que está importando contiene construcciones xsd:attribute que, a su vez, contienen un valor fijo y un valor
predeterminado, aparecerán mensajes de error en la lista de tarea para indicarle que dichas tareas no están soportadas. Sin embargo, el esquema seguirá importándose y el se utilizará el valor fijo, no el valor predeterminado. Los mensajes de error se pueden
ignorar.
- Si está importando una colección de archivos de esquema XML relacionados y el Editor de definiciones de mensajes no puede resolver los
enlaces entre dos de los archivos importados, aparecerán mensajes en la lista de tareas para indicar que no se pueden encontrar los tipos a
los que se hace referencia u otros objetos. Si ocurre esto, consulte el apartado Resolución de problemas al desarrollar modelos de mensajes para obtener
información adicional.