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
- 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 conjuntos de mensajes
- Tres archivos de definición de mensajes
, uno para cada
espacio
de nombres
usado en el ejemplo de Alquiler de Vídeos
- 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.
- Vaya a la perspectiva de desarrollo de aplicaciones de
intermediario.
- 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.
- Seleccione el recuadro de selección Utilizar espacios de nombres.
- 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.
- 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.
- 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).
- 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".
- 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".
- Vea los valores del espacio de nombres para el conjunto de mensajes:
- En la vista Navegador de recursos, efectúe una doble pulsación en messageSet.mset para abrirlo.
- 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.
- 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:
- Vaya a la perspectiva de desarrollo de aplicaciones de
intermediario.
- En la vista Navegador de recursos, 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
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".
- 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:
- 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.
- 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:
- Vaya a la perspectiva de desarrollo de aplicaciones de
intermediario.
- En la vista Navegador de recursos, efectúe una doble pulsación en Customer.mxsd para abrirlo.
- En el Editor de definición de mensajes, pulse la pestaña 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 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:
- Vaya a la perspectiva de desarrollo de aplicaciones de
intermediario.
- En la vista Navegador de recursos, efectúe una doble pulsación en Customer.mxsd para abrirlo.
- 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 listados en la tabla siguiente y cambie sus tipos como corresponda:
- En el Editor de definición de mensajes, pulse la pestaña Visión general.
- Resalte la fila en la que aparece el elemento.
- 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 |
- 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:
- Vaya a la perspectiva de desarrollo de aplicaciones de
intermediario.
- 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:
- Vaya a la perspectiva de desarrollo de aplicaciones de
intermediario.
- 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:
- 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.
- Vaya a la perspectiva de desarrollo de aplicaciones de
intermediario.
- 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:
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.
- 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 al siguiente elemento:
- brw:Borrowed (este elemento procede del espacio de nombres borroweddetails)
- Magazie
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.
Volver a la Página de presentación de ejemplos