Antes de empezar:
Para completar esta tarea, debe
haber completado las tareas siguientes:
Además, antes de empezar esta tarea, tenga en cuenta los puntos siguientes:
- Para crear un nuevo archivo de definición de mensajes de un esquema XML, el archivo
de esquema ya debe estar en el área de trabajo,
por ejemplo en el proyecto de conjuntos de mensajes. Esto le permite seleccionar el
archivo de esquema en el asistente Nuevo archivo de definición de mensajes.
Para obtener información sobre cómo añadir archivos al espacio de trabajo, consulte la sección Importación de sistemas de archivos al área de trabajo.
- 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 ningún soporte de espacio de nombres, el esquema importado
se modifica para eliminar espacios de nombres. Por consiguiente, es
recomendable que habilite soporte para espacios de
nombres antes de importar un esquema. Para obtener más información sobre cómo
habilitar soporte para espacios de nombres, consulte la sección Creación de un conjunto de mensajes.
- Si el conjunto de mensajes al que está añadiendo un nuevo archivo de definición de mensajes no tiene una capa de formato
físico XML, pero tiene soporte para espacio de nombres,
sólo aparece la información lógica en el modelo. El esquema XML no se modifica para eliminar
los espacios de nombres. Puede añadir la capa física al conjunto de mensajes antes o después
de importar el esquema XML pero es recomendable que añada
la capa física antes de importar un esquema.
Para obtener información sobre cómo añadir un formato físico XML, consulte la sección Adición de un formato físico XML.
- Si el conjunto de mensajes al que está añadiendo un nuevo archivo de definición de mensajes no tiene una capa de formato
físico XML y no tiene soporte para el espacio de nombres,
sólo aparece 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 tiene soporte para espacio
de nombres, debe especificar las preferencias que se aplican cuando importa un
esquema al conjunto de mensajes. Estas preferencias le permiten especificar cómo trata
el importador determinadas construcciones de esquemas concretas. Puede rechazar el esquema
si se encuentra con apariciones de la construcción o modifica apariciones de la
construcción. Si opta por modificar, el importador modifica todas las apariciones
de la construcción. Para obtener más información sobre cómo definir estas preferencias, consulte la sección Configuración de preferencias de conjuntos de mensajes.
Observe que la extensión del archivo debe
ser .xsd en minúsculas.
Los siguientes pasos se refieren a cómo crear un nuevo archivo de definición de mensajes totalmente nuevo y también a cómo sobrescribir el contenido de un archivo existente.
Para crear un nuevo archivo de definición de mensajes a partir de un archivo de esquema XML
- Vaya a la perspectiva Desarrollo de aplicaciones de intermediario.
- Abra el asistente Nuevo archivo de definición de mensajes
pulsando Archivo > Nuevo > Archivo de definiciones de mensajes en el menú del área de trabajo. O bien, puede abrir el asistente pulsando el
botón derecho del ratón en un archivo*.xsd anteriormente
importado al área de trabajo y pulsando Nuevo > Archivo de definiciones de mensajes en el menú.
- En la lista de opciones visualizadas, pulse Archivo de esquema XML
para seleccionarlo y, a continuación, pulse Siguiente.
- En la lista visualizada de archivos del área de trabajo, pulse el
archivo de esquema XML que desea importar y, a continuación, pulse Siguiente. Si ha
abierto el asistente que se describe en el paso 3 anterior, el archivo
*.xsd que ha pulsado con el botón
derecho del ratón ya está seleccionado cuando aparece la siguiente página.
- En la lista de conjuntos de mensajes que aparece en Conjuntos de mensajes,
pulse el conjunto de mensajes de destino para el archivo de definición de mensajes que está
creando. El campo Nombre de archivo de definición de mensajes
se rellena automáticamente con un nombre de archivo por omisión basado en el nombre del
archivo que está importando. Si es preciso, puede cambiar el nombre del archivo
por omisión visualizado por un nuevo nombre de su elección.
- Opcional: Si desea sustituir el contenido por un archivo de definición de mensajes existente efectúe lo siguiente:
- Escriba el nombre del archivo existente en el campo Nombre
de archivo de definición de mensajes.
- Seleccione el recuadro de selección Sobrescribir el contenido
del archivo existente sin avisos. El archivo existente se sobrescribe sin que
se visualice un aviso.
- Pulse Siguiente. El esquema XML
está validado.
- Opcional: En la lista visualizada de elementos globales, seleccione los recuadros de selección para los elementos globales (basados
en tipos complejos globales) desde los que desea crear mensajes. Utilice los
botones Seleccionar todo y Deseleccionar todo
para seleccionar todos los elementos globales de la lista o ningún elemento global de la lista.
Consejo: Sólo son visibles los elementos basados en tipos complejos globales.
Cualquier otro elemento global no es visible.
- Opcional: Si el conjunto de mensajes de destino para el archivo de definición de mensajes que está creando no tiene habilitado el soporte para el espacio de nombres, tiene la posibilidad de pulsar Siguiente.
De esta manera se presenta una ventana que le permite añadir espacios de nombres.
- Pulse Finalizar. Se crea el
archivo de definición de mensajes del esquema XML y se abre en el editor
de definiciones de mensajes.
- Cuando haya completado el esquema XML utilizando el asistente, compruebe
cuidadosamente si hay errores en el informe que se ha creado cuando se importó el
archivo. Puede encontrar este informe en el directorio de anotaciones
en el proyecto que contiene la definición de mensajes que ha intentado crear.
El informe tiene la extensión de archivo *.xsd.report.txt,
precedido por el nombre que ha especificado para el nuevo archivo de definición de mensajes.
Tras importar los archivos de esquema XML, revise los mensajes
que aparecen en la lista de tareas del área de trabajo para
comprobar si ha aparecido algún aviso u error nuevo. A continuación se listan
ejemplos de situaciones en las que aparecen mensajes:
- Si el esquema XML que está importando contiene las construcciones xsd:key, xsd:keyref
y xsd:unique, aparecen mensajes de aviso en la lista de tareas para indicarle
que estas construcciones no están soportadas y el intermediario hará caso
omiso de ellas. Si prefiere suprimir estas construcciones, abra el archivo de
definición de mensajes en el editor de definiciones de mensajes y suprima las
construcciones que se describen en la sección Supresión de objetos.
Al suprimir estas construcciones también se suprimirán los mensajes de aviso de la lista de tareas.
Si decide no suprimir las construcciones, seguirán en el modelo de mensaje pero no se
difundirán al intermediario ni se utilizarán para ningún otro fin. Los
mensajes de aviso en la lista de tareas permanecerán, pero podrá utilizar
el modelo de mensaje con normalidad.
- Si está importando una colección de archivos de esquemas XML y el editor de
definiciones de mensajes no puede resolver los enlaces entre dos de los archivos
importados, aparecen mensajes en la lista de tareas indicando no se pueden encontrar
dichos tipos referenciados ni ningún otro objeto. Si esto se produce, consulte la sección Problemas cuando se desarrollan modelos de mensajes para obtener información más detallada al respecto.