Este tema describe cómo crear una nueva definición de mensaje a
partir de WSDL utilizando el asistente de Nuevo archivo de definición de
mensajes en el entorno de trabajo.
Antes de empezar:
Para realizar esta tarea, debe
haber completado las siguientes tareas:
Antes de
empezar esta tarea, deberá tener en cuenta los puntos siguientes:
- Para garantizar la máxima interoperatividad de los servicios Web deberá:
- Utilice el estilo de documento WSDL siempre que sea posible
- Cuando el uso del estilo rpc de WSDL sea necesario, utilice la codificación literal
- Cuando el uso del estilo rpc con la codificación SOAP sea necesario, asegúrese de que las definiciones de la operación WSDL estén calificadas mediante un atributo de espacio de nombres válido.
- Las definiciones WSDL se puede dividir opcionalmente en varios archivos. La disposición
típica será una en la que un archivo de definición de servicio de nivel superior importa
un archivo de enlace, el archivo de enlace importa un archivo de interfaz y, por último,
éste importa o incluye los archivos de definición de esquema.
- Cuando cree un nuevo archivo de definición de mensajes desde un archivo
WSDL, el archivo WSDL debe estar presente en el proyecto de conjunto de
mensajes. Si el WSDL se divide en varios archivos como se ha descrito anteriormente, entonces puede importar el archivo de definición de servicio de nivel superior o el archivo de enlace. En este caso, el archivo que importe y cualquier otro archivo al que haga referencia utilizando una ubicación relativa debe estar en el espacio de trabajo antes de que se ejecute la importación WSDL.
- Cuando importe dos o más archivos WSDL que comparten definiciones de esquema comunes,
deberá importarlos en proyectos de conjunto de mensajes independientes
para evitar la posibilidad de colisiones de nombres.
- Debe añadir una capa de formato físico XML y habilitar el soporte de
espacio de nombres para el conjunto de mensajes al que está añadiendo el
nuevo archivo de definición de mensajes.
Para
mejorar la interoperatividad de los servicios Web, deberá evitar la personalización innecesaria
de la capa de formato físico XML para mensajes que participan en procesos de servicios Web.
Importante: Tenga en cuenta que la extensión del archivo debe ser .wsdl en minúsculas.
Los pasos siguientes describen cómo crear un archivo de
definición de mensajes completamente nuevo y también como sobrescribir el
contenido de un archivo existente.
Para crear una definición de
mensaje de un archivo o archivos WSDL:
- Vaya a Perspectiva de Desarrollo de aplicaciones de
intermediario.
- Abra el asistente de Nuevo archivo de
definición de mensajes pulsando Archivo > Nuevo >
Archivo de definición de mensajes en el menú del
entorno de trabajo. Alternativamente, puede abrir el asistente pulsando el botón derecho
del ratón en un archivo
.wsdl importado
anteriormente al entorno de trabajo y
pulsando Nuevo > Archivo de definición de
mensajes en el menú.
- En la lista de opciones visualizadas, pulse Archivo WSDL para seleccionarlo y luego pulse Siguiente.
- Siga los pasos restantes del asistente y rellene los detalles según sea necesario.
Nota: - Es posible que diferentes paneles y opciones estén sujetos a los valores que haya establecido en el asistente por lo que es posible que no siempre aparezcan.
- Algunos campos del asistente pueden estar desactivados. Probablemente esto se debe a que
el campo tiene un valor obligatorio, el campo tiene sólo un valor posible o
no se utiliza debido a otros valores que ya se han establecido.
Cuando haya completado la importación WSDL utilizando el asistente:
- Compruebe detenidamente si hay errores en el informe que se ha creado
al importar el archivo. Puede encontrar este informe en el directorio
log del proyecto que contiene la definición
de mensaje que ha intentado crear. El informe tiene un descriptor de
archivo <nombre-archivo-wsdl>.wsdl.report.txt,
donde <nombre-archivo-wsdl> es el nombre de la
definición de WSDL que está importando.
- Revise los mensajes que aparecen en la lista de tareas del
entorno de trabajo para
comprobar si han aparecido avisos o errores nuevos.
Nota: Cualquier definición de mensaje de sobre SOAP (Envelope) o codificación SOAP se añade automáticamente al conjunto de mensajes durante la importación. Si es necesario, también puede importarlos manualmente mediante el asistente de nuevo archivo de definición de mensajes seleccionando la nueva opción Mensaje suministrado por IBM.