Crear el modelo de mensaje
Este tema explica cómo crear el modelo de mensaje e incluye las
siguientes secciones:
- Crear las definiciones de mensajes
- Añadir elementos, tipos y grupos
Crear las definiciones de mensajes
Para crear las definiciones de mensajes, debe crear lo siguiente:
- Un proyecto de conjunto de mensajes y un conjunto de mensajes, consulte Proyectos de conjunto de mensajes y Visión general de conjuntosde mensajes en la documentación de WebSphere Message Broker.
- Tres archivos de definición de mensajes, uno para cada espacio de nombres que se utiliza en el ejemplo Alquiler de vídeos, consulte Archivos de definición de mensajes y Espacios de nombres en el modelo de mensaje en la documentación de WebSphere Message Broker.
- Un mensaje denominado Cliente.
Utilice las siguientes instrucciones para crear las definiciones de mensajes.
Se proporcionan enlaces para acceder a instrucciones más detalladas de algunos de los pasos siguientes al final de cada paso.
- Cree un nuevo conjunto de mensajes denominado Video, en un
proyecto de conjuntos de mensajes denominado Video Message Sets.
Para obtener instrucciones, consulte Crear un conjunto de mensajes
en la documentación de WebSphere Message Broker.
- Seleccione las opciones para crear formatos físicos CWF, XML y TDS.
Utilice los nombres predeterminados (CWF1, XML1 y TDS1).
Cuando
se utiliza el asistente para crear un nuevo proyecto de conjunto de mensajes, el asistente crea a la vez un nuevo conjunto de mensajes.
- Cree los siguientes archivos de definición de mensajes en el proyecto Video Message Sets.
Para obtener instrucciones, consulte Crear un archivo de definición de mensajes en la documentación de WebSphere Message Broker.
- Cree un archivo de definición de mensajes denominado Customer,
aceptando los valores predeterminados.
Cuando pulse Finalizar, aparecerá un
archivo llamado Customer.mxsd en la vista Desarrollo de intermediario, bajo
Video > (predeterminado).
- Cree un archivo de definición de mensajes denominado Address.
Pulse Utilizar espacio de nombres de
destino.
Escriba http://www.ibm.com.addressdetails en el campo Espacio de nombres,
y addr en el campo Prefijo.
Cuando pulse Finalizar, se visualizará un
espacio de nombres llamado com.ibm.www.addressdetails en la vista
Desarrollo de intermediario, bajo el conjunto de mensajes Video.
Se
visualizará un archivo llamado Address.mxsd bajo com.ibm.www.addressdetails.
- Cree un archivo de definición de mensajes denominado Borrowed.
Marque el botón de selección Utilizar espacio
de nombres de destino.
Escriba http://www.ibm.com.borroweddetails en el campo Espacio de nombres,
y brw en el campo Prefijo.
Cuando pulse Finalizar, se visualizará un
espacio de nombres llamado www.ibm.com.borroweddetails en la vista
Desarrollo de intermediario, bajo el conjunto de mensajes Video.
Aparecerá un archivo llamado Borrowed.mxsd debajo de "borroweddetails".
- Vea los valores del espacio de nombres para el conjunto de mensajes:
- En la vista Desarrollo de intermediario, efectúe una doble
pulsación en el archivo messageSet.mset para
abrirlo.
- En el editor de conjuntos de mensajes, en la Jerarquía
de propiedades, pulse XML1.
Expanda los
valores de Espacio de nombres.
Ahora podrá
ver los valores que ha indicado en los pasos anteriores.
- Añada un nuevo mensaje, llamado Customer, al archivo de definición de mensajes Customer.
Para obtener instrucciones, consulte Añadir un mensaje en la documentación de WebSphere Message Broker.
Se crea automáticamente un tipo complejo llamado ComplexType1 para el mensaje.
Cambie el nombre de este tipo complejo por
CustomerType.
Tenga en cuenta que no es necesario añadir mensajes a los demás archivos de definición de mensajes en este momento.
Los elementos de Address y Borrowed se añadirán al mensaje Customer en la siguiente sección.
Añadir elementos, tipos y grupos
Después de crear las definiciones de elementos, añada elementos, tipos y grupos a estas definiciones de mensajes.
Empiece añadiendo elementos, tipos y grupos a las definiciones de mensajes Address y Borrowed.
Importe los espacios de nombres borroweddetails y addressdetails al espacio de nombres predeterminado.
Esta acción es necesaria para después poder añadir los elementos Borrowed y Address al mensaje de definición de cliente.
Hay distintas formas en las que puede añadir tipos y elementos al mensaje y obtener el mismo resultado.
La secuencia aquí
especificada es una de las formas posibles de crear un mensaje, sin embargo, el ejercicio de añadir los elementos y tipos en el orden que se indica le puede ayudar a ver cómo se estructura el mensaje.
Añadir elementos y tipos al archivo de definición de mensajes Address
Para añadir elementos y tipos al archivo de definición de
mensajes Address, cree un elemento global llamado Address y, a
continuación, un tipo complejo total. A continuación puede añadir más elementos al archivo de definición de mensajes Address.
Para crear un elemento global llamado Address y un tipo complejo local:
- En la vista Desarrollo de intermediario, efectúe una doble
pulsación en Address.mxsd para abrirlo.
- En la vista Esquema, pulse el botón derecho del ratón en Elementos y atributos y pulse
Añadir elemento global.
Se añade un elemento denominado globalElement1, de tipo string.
Cambie el nombre de
este elemento por Address.
- En el editor Definición de mensaje resalte la fila que se muestra la Dirección, consulte Editor de definición de Mensajes en la documentación de WebSphere Message Broker.
En la columna Tipo, pulse la celda que muestra el valor
predeterminado string para ver un menú con los tipos disponibles.
Seleccione Nuevo tipo
complejo.
De forma predeterminada, aparece seleccionada la propiedad "Crear un tipo complejo local".
- Pulse Aceptar.
En la vista
Esquema, debajo de Address aparece el tipo {Local complexType}.
Ahora puede añadir más elementos a la definición de mensajes Address.
Cree los elementos listados en la siguiente tabla: Por ejemplo, para añadir HouseNo:
- Pulse el botón derecho del ratón en
{Local complexType} y pulse
Añadir elemento local.
Debajo de {Local complexType}
se añade un elemento denominado localElement1 de tipo string.
Cambie el nombre de este elemento por HouseNo.
- En el Editor de definiciones de mensajes, resalte la fila en la que aparece HouseNo.
En la columna Tipo, pulse la celda que muestra el valor predeterminado string para ver un menú con los tipos disponibles. Seleccione int.
Elemento |
Tipo |
HouseNo |
int |
Street |
string |
Town |
string |
Añadir elementos y tipos al archivo de definición de mensajes Borrowed
Para añadir elementos y tipos al archivo de definición de mensajes Borrowed, cree un elemento global llamado
Borrowed, cree un tipo complejo local y añada los elementos que se listan en la siguiente tabla.
Siga las instrucciones de la sección anterior.
Elemento |
Tipo |
VideoTitle |
string |
DueDate |
dateTime |
Cost |
decimal |
Importar los espacios de nombres borroweddetails y addressdetails en el espacio de nombres predeterminado
Para poder añadir los elementos Borrowed y Address (de los espacios de nombres borroweddetails y addressdetails) al mensaje de cliente, debe importar los espacios de nombres borroweddetails y addressdetails en el espacio de nombres predeterminado:
- En la vista Desarrollo de intermediario, efectúe una doble
pulsación en Customer.mxsd para abrirlo.
- En el Editor de definición de mensajes, pulse
Customer.mxsd y después pulse el separador Propiedades.
- En la Jerarquía de propiedades, pulse el botón derecho del ratón en Importaciones y pulse
Añadir Importación.
Se abre la ventana Selección de archivo de definición de mensajes para importarlo.
- Expanda el árbol hasta llegar a Address.mxsd y pulse Finalizar.
Repita los pasos anteriores para Borrowed.mxsd.
Los archivos Address.mxsd y Borrowed.mxsd se muestran en la Jerarquía de propiedades, bajo Importaciones.
Pulse Address.mxsd y Borrowed.mxsd para ver los valores.
El campo Prefijo muestra el valor que ha especificado en el campo Prefijo
al crear el archivo de definición de mensajes.
El campo Espacio de nombres
muestra el valor que ha especificado en el campo Espacio de nombres.
Añadir elementos, tipos y grupos al archivo de definición de mensajes Customer
Ahora debe añadir elementos, tipos y grupos al archivo de definición de mensajes Customer y, a continuación, añadir las referencias de elementos, atributos y de grupos a tipos y grupos.
Añadir elementos, tipos y grupos
Para añadir elementos, tipos y grupos:
- En la vista Desarrollo de intermediario, efectúe una doble
pulsación en el archivo Customer.mxsd para abrirlo y
pulse el separador Visión general.
- En la vista Esquema, pulse el botón derecho del ratón en
Tipos y pulse Añadir tipo
complejo.
Añada un tipo complejo denominado NameType.
- Pulse el botón derecho del ratón en Grupos y pulse Añadir grupo.
Añada un grupo denominado IdGroup.
- Pulse el botón derecho del ratón en Elementos y atributos y pulse Añadir elemento
global.
Añada los elementos que se listan en la tabla siguiente y cambie sus tipos como corresponda:
- En el Editor de definición de mensajes, pulse el separador Visión general.
- Resalte la fila en la que aparece el elemento.
- En la columna Tipo, pulse la celda que muestra el valor predeterminado
string para ver un menú con los tipos disponibles y seleccione
el tipo deseado.
Además de los tipos
simples (como string, integer o Boolean), el menú ahora contiene los tipos
complejos que ha añadido en el paso 3. Como resultado ahora puede cambiar
el tipo del elemento Name por NameType.
Para añadir NameType,
primero ha de seleccionar (More...) en el menú desplegable.
Elemento |
Tipo |
Title |
string |
FirstName |
string |
ID |
string |
PassportNo |
string |
DrivingLicenseNo |
string |
CreditCardNo |
string |
Nombre |
NameType |
Magazine |
boolean |
- Pulse el botón derecho del ratón en Elementos y atributos y pulse Añadir atributo
global.
Añada el siguiente atributo global:
Atributo global |
Tipo |
LastName |
string |
Añadir referencias a elemento, atributo y grupo
Para añadir referencias de elementos a IdGroup:
- En la vista Esquema, expanda Grupos.
- Pulse el botón derecho del ratón en IdGroup y pulse Añadir referencia de elemento.
Añada referencias a los siguientes elementos:
- PassportNo
- DrivingLicenseNo
- CreditCardNo
Para añadir las referencias a elementos y atributos a NameType:
- En la vista Esquema, expanda Tipos.
- Pulse el botón derecho del ratón en NameType y pulse Añadir referencia de elemento.
Añada referencias a los siguientes elementos, en el orden detallado a continuación:
- Title
- FirstName
- Pulse el botón derecho del ratón en NameType y pulse Añadir referencia de atributo.
Añada una referencia al atributo global llamado LastName.
La posición de LastName bajo NameType no es significativa porque es un atributo y, como tal, no se trata de la misma manera que los elementos que están en ejecución.
Para añadir referencias de elementos, atributos y grupos a CustomerType, siga las instrucciones siguientes.
Es importante añadir las referencias en el orden en el que se muestran a continuación.
- En la vista Esquema, expanda Tipos.
- Pulse el botón derecho del ratón en CustomerType y pulse Añadir referencia de elemento.
Añada referencias a los siguientes elementos:
El elemento addr:Address procede del espacio de nombres addressdetails.
Tiene este elemento disponible para añadirlo aCustomerType porque ya ha importado los espacios borroweddetails y addressdetails en el espacio de nombres predeterminado.
Puede añadir este elemento de referencia exactamente del mismo modo que cualquier otro elemento de referencia, pero puede ver que es el prefijo por el valor que establezca URI cuando se crea el archivo de definición de mensajes Address.
- Pulse el botón derecho del ratón en CustomerType y pulse Añadir referencia de grupo.
Añada una referencia al siguiente grupo:
- Pulse el botón derecho del ratón en CustomerType y pulse Añadir referencia de elemento.
Añada una referencia a los siguientes elementos:
- brw:Borrowed (este elemento procede del espacio de nombres borroweddetails)
- Magazine
Una vez que haya completado las tareas de esta página y haya
añadido todos los elementos, tipos y grupos necesarios a los archivos de
definición de mensajes, podrá
configurar el modelo de mensaje.
Volver a la página inicial del ejemplo