Crear el modelo de mensaje

Este apartado 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 conjuntos de mensajes
  2. Tres archivos de definición de mensajes , uno para cada espacio de nombres usado en el ejemplo de Alquiler de Vídeos
  3. Un mensaje denominado Cliente

Utilice las siguientes instrucciones para crear las definiciones de mensajes. Existen instrucciones detalladas para algunos de los pasos siguientes; para acceder a ellos, pulse en el enlace que se facilita al final del paso.

  1. Vaya a la perspectiva de desarrollo de aplicaciones de intermediario.
  2. Cree un nuevo proyecto de conjunto de mensajes llamado Video Message Sets, que incluye un conjunto de mensajes llamado Video. Para ver las instrucciones, consulte el apartado Crear un proyecto de conjunto de mensajes.
    1. Seleccione el recuadro de selección Utilizar espacios de nombres.
    2. Seleccione las opciones para crear formatos físicos CWF, XML y TDS. Utilice los nombres por omisión (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.
  3. 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.
    1. Cree un archivo de definición de mensajes denominado Customer.
      La propiedad "No hay ningún espacio de nombres de destino" está seleccionada por omisión. Al pulsar Finalizar, aparece un archivo denominado Customer.mxsd en la vista Navegador de recursos, bajo Video > (valor por omisión).
    2. Cree un archivo de definición de mensajes denominado Address.
      Pulse en Usar URI de espacio de nombres. Escriba http://www.ibm.com.addressdetails en el campo URI de espacio de nombres y addr en el campo de prefijo del URI del espacio de nombres. Al pulsar Finalizar, se visualiza un espacio de nombres llamado com.ibm.www.addressdetails bajo el conjunto de mensajes Video en la vista Navegador de recursos. Se visualizará un archivo llamado Address.mxsd bajo "com.ibm.www.addressdetails".
    3. Cree un archivo de definición de mensajes denominado Borrowed.
      Pulse el botón de selección Utilizar URI de espacio de nombres. Escriba http://www.ibm.com.borroweddetails en el campo URI de espacio de nombres y brw en el campo de prefijo del URI del espacio de nombres. Al pulsar Finalizar, se visualiza un espacio de nombres llamado www.ibm.com.borroweddetails bajo el conjunto de mensajes Video en la vista Navegador de recursos. Aparecerá un archivo llamado Borrowed.mxsd debajo de "borroweddetails".
  4. Vea los valores del espacio de nombres para el conjunto de mensajes:
    1. En la vista Navegador de recursos, efectúe una doble pulsación en messageSet.mset para abrirlo.
    2. En el Editor de definición de mensajes, en la Jerarquía de propiedades, pulse Propiedades físicas > XML1. Ahora podrá ver los valores indicados en los pasos anteriores.
  5. Añada un nuevo mensaje, llamado Customer, al archivo de definición de mensajes Customer. Para obtener instrucciones, consulte Añadir un mensaje.
    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. Después, importe los nombres de espacios borroweddetails y addressdetails en el espacio de nombres por omisión. Esto es necesario 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 muestra una de las formas de crear un mensaje, aunque si añade los elementos y tipos en el orden aquí indicado verá más claramente 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, crea un elemento global llamado Address y, a continuación, un tipo complejo total. Después de ello, 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. Vaya a la perspectiva de desarrollo de aplicaciones de intermediario.
  2. En la vista Navegador de recursos, efectúe una doble pulsación en Address.mxsd para abrirlo.
  3. 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.
  4. En el Editor de definición de mensajes, resalte la fila en la que aparece Address. En la columna Tipo, pulse la célula que muestra el valor por omisión "string" hasta llegar a un menú desplegable de tipos disponibles. Seleccione Nuevo tipo complejo. Por omisión aparece seleccionada la propiedad "Crear un tipo complejo local".
  5. Pulse Aceptar. En la vista Esquema, debajo de Address aparece el tipo ANONYMOUS.

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 ANONYMOUS y pulse Añadir elemento local. Debajo de ANONYMOUS se añade un elemento denominado localElement1 de tipo string. Cambie el nombre de este elemento por HouseNo.
  2. En el Editor de definición de mensajes, resalte la fila en la que aparece HouseNo. En la columna Tipo, pulse la célula que muestra el valor por omisión "string" hasta llegar a un menú desplegable de 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 listados 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 por omisión

Para poder añadir los elementos Borrowed y Address (de los espacios de nombres borroweddetails y addressdetails respectivamente) al mensaje de cliente, debe importar los espacios de nombres borroweddetails y addressdetails en el espacio de nombre por omisión:

  1. Vaya a la perspectiva de desarrollo de aplicaciones de intermediario.
  2. En la vista Navegador de recursos, efectúe una doble pulsación en Customer.mxsd para abrirlo.
  3. En el Editor de definición de mensajes, pulse la pestaña Propiedades.
  4. 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.
  5. Expanda el árbol hasta encontrar Address.mxsd y pulse Finalizar.

Repita los pasos anteriores para Borrowed.mxsd.

Los archivos Address.mxsd y Borrowed.mxsd se muestran en Jerarquía de propiedades, bajo Importaciones. Efectúe una pulsación en ellos para ver los valores indicados anteriormente. El campo Prefijo muestra el valor especificado en el campo URI de espacio de nombres al crear el archivo de definición de mensajes. El campo Espacio de nombres muestra el valor especificado en el campo URI de 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. Vaya a la perspectiva de desarrollo de aplicaciones de intermediario.
  2. En la vista Navegador de recursos, efectúe una doble pulsación en Customer.mxsd para abrirlo.
  3. 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.
  4. Pulse el botón derecho del ratón en Grupos y pulse Añadir grupo. Añada un grupo denominado IdGroup.
  5. Pulse el botón derecho del ratón en Elementos y atributos y pulse Añadir elemento global. Añada los elementos listados en la tabla siguiente y cambie sus tipos como corresponda:
    1. En el Editor de definición de mensajes, pulse la pestaña Visión general.
    2. Resalte la fila en la que aparece el elemento.
    3. En la columna Tipo, pulse la célula que muestra el valor por omisión "string" hasta llegar a un menú desplegables de tipos disponibles y seleccione el tipo necesario. Además de los tipos simples (como string, integer o boolean), el menú también muestra los tipos complejos añadidos 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
  6. 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. Vaya a la perspectiva de desarrollo de aplicaciones de intermediario.
  2. En la vista Esquema, expanda Grupos.
  3. 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. Vaya a la perspectiva de desarrollo de aplicaciones de intermediario.
  2. En la vista Esquema, expanda Tipos.
  3. 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:
  4. 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 estas instrucciones. Es importante añadir las referencias en el orden en el que se muestran a continuación.

  1. Vaya a la perspectiva de desarrollo de aplicaciones de intermediario.
  2. En la vista Esquema, expanda Tipos.
  3. Pulse el botón derecho del ratón en CustomerType y pulse Añadir referencia de elemento. Añada referencias a los siguientes elementos: Este elemento addr:Address procede del espacio de nombres addressdetails. Si anteriormente no ha importado los nombres de espacios addressdetails y borroweddetails al espacio de nombres por omisión, este elemento no estará disponible para añadir a CustomerType. Esta referencia de elemento puede añadirse exactamente igual que cualquier otra referencia de elemento, aunque puede ver que tiene como prefijo el valor del URI del espacio de nombres establecido al crear el archivo de definición de mensajes Address.
  4. Pulse el botón derecho del ratón en CustomerType y pulse Añadir referencia de grupo. Añada una referencia al siguiente grupo:
  5. Pulse el botón derecho del ratón en CustomerType y pulse Añadir referencia de elemento. Añada una referencia al siguiente elemento:

Cuando haya terminado 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.

Icono de la página principal   Volver a la Página de presentación de ejemplos