Este tema describe cómo crear una nueva definición de mensajes a partir de WSDL utilizando el
asistente para nuevo archivo de definición de mensajes en el área de trabajo.
Antes de
empezar:
Para realizar esta tarea, ha de 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 se le recomienda que:
- 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 definición de mensaje y, por último, este importa o incluye los archivos de definición de mensaje.
- Cuando cree un nuevo archivo de definición de mensaje de 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 compartan definiciones de esquema comunes, se le recomienda que las importe en proyectos de conjunto de mensajes diferentes 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 mensaje. Para poder mejorar la interoperatividad de los servicios Web, se le recomienda que evite una 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 sobregrabar 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 para
Nuevo archivo de definición de mensajes
pulsando Archivo > Nuevo > Archivo de definición de mensajes en el
menú del área de trabajo. Alternativamente, puede
abrir el asistente pulsando con el botón derecho del ratón en un archivo .wsdl importado previamente al área
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. Esto puede ser debido a que el campo tiene un valor obligatorio o a que no se utiliza como resultado de otros valores que ya ha 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
en el proyecto que contiene la definición de mensajes que ha intentado crear. El informe tiene un descriptor de archivo .wsdl.report.txt cuyo prefijo es el nombre que ha especificado para el nuevo archivo de definición de mensaje.
- Revise los mensajes que aparecen en la lista de tareas del
área 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.