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

Para crear las definiciones de mensajes, debe crear lo siguiente:

  1. 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.
  2. 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.
  3. 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.

  1. 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.
    1. 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.
  2. 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.
    1. 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).
    2. 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.
    3. 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".
  3. Vea los valores del espacio de nombres para el conjunto de mensajes:
    1. En la vista Desarrollo de intermediario, efectúe una doble pulsación en el archivo messageSet.mset para abrirlo.
    2. 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.
  4. 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:

  1. En la vista Desarrollo de intermediario, efectúe una doble pulsación en Address.mxsd para abrirlo.
  2. 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.
  3. 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".
  4. 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:

  1. 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.
  2. 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:

  1. En la vista Desarrollo de intermediario, efectúe una doble pulsación en Customer.mxsd para abrirlo.
  2. En el Editor de definición de mensajes, pulse Customer.mxsd y después pulse el separador Propiedades.
  3. 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.
  4. 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:

  1. 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.
  2. 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.
  3. Pulse el botón derecho del ratón en Grupos y pulse Añadir grupo. Añada un grupo denominado IdGroup.
  4. 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:
    1. En el Editor de definición de mensajes, pulse el separador Visión general.
    2. Resalte la fila en la que aparece el elemento.
    3. 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
  5. 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:

  1. En la vista Esquema, expanda Grupos.
  2. Pulse el botón derecho del ratón en IdGroup y pulse Añadir referencia de elemento. Añada referencias a los siguientes elementos:

Para añadir las referencias a elementos y atributos a NameType:

  1. En la vista Esquema, expanda Tipos.
  2. 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:
    1. Title
    2. FirstName
  3. 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.

  1. En la vista Esquema, expanda Tipos.
  2. 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.
  3. Pulse el botón derecho del ratón en CustomerType y pulse Añadir referencia de grupo. Añada una referencia al siguiente grupo:
  4. 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:

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