Descripción de adaptadores de servicio web

Los temas siguientes describen la funcionalidad del sistema con más detalle.

Importación de un WSDL

La configuración de un adaptador de servicio web comienza por la identificación del WSDL (el documento de lenguaje de descripción de servicio web usado para definir la interfaz) que proporcionará el sistema externo. Los pasos siguientes describen la funcionalidad de producto base incluida para permitir a un usuario importar un WSDL.

Navegue hasta la página Adaptador de servicio web en el modo de adición y seleccione el objeto de negocio base adecuado.
Introduzca un nombre de servicio web con significado y una descripción adecuada.
Indique la URL del WSDL indicado.
Pulse Importar para recuperar los detalles del WSDL. El sistema analiza los detalles del WSDL y rellena Nombre de servicio WSDL, Origen WSDL, Puerto WSDL, URL y una lista de Operaciones (métodos) definidos en el WSDL.
Determine qué operaciones deberían estar activas de acuerdo con los requisitos de negocio para invocar este servicio web. Las operaciones activas son aquellas que la implantación tiene planificado invocar desde el sistema. Estas requieren la generación de áreas de datos de solicitud y respuesta adecuadas para ellas. La sección siguiente proporciona información sobre ello.
Especifique el tipo de seguridad adecuado para configurar el que se usará al invocar este servicio web.
Pulse en Guardar.

En este punto, se crea un registro de adaptador de servicio web con el estado pendiente. El paso siguiente es generar las áreas de datos de solicitud y respuesta para las operaciones configuradas como activas.

Generación de áreas de datos de solicitud y respuesta

Cada operación activa para el adaptador de servicio web necesita un par de áreas de datos, solicitud y respuesta, que representen los mensajes XML de solicitud y respuesta para la operación.

El producto base proporciona los pasos para generar las áreas de datos de la manera siguiente:

Según se describe en la sección Importación de un WSDL anterior, las operaciones que figuran en el WSDL se generan para el adaptador de servicio web y el responsable de la implantación debe indicar qué operación se debe activar.
Después de guardar el adaptador de servicio web pendiente, la pantalla muestra una lista de todas las operaciones activas y para cada una incluye un botón Generar.
Después de pulsar Generar para una operación, aparece una ventana en la que pueden definirse los nombres de las nuevas áreas de datos de solicitud y respuesta. Pulse Guardar para generar las áreas de datos.

Las áreas de datos generadas proporcionan la API que el responsable de la implantación utilizará al implantar la llamada al servicio web en un algoritmo o servicio adecuado en el sistema. Las áreas de datos contienen la asignación adecuada de los elementos en los que el responsable de la implantación trabaja dentro del código que invoca los servicios web y las definiciones del WSDL.

Para facilitar la generación de las áreas de datos de solicitud y respuesta, el producto base invoca a un servicio de negocio especial utilizado para crear la asignación adecuada. El objeto de negocio se define como una opción de objeto de negocio en el objeto de negocio del adaptador de servicio web. Esto permite que una implantación proporcione un servicio de negocio personalizado para seguir mejorando la asignación de la solicitud y respuesta, según corresponda.

Nota:

Áreas de datos generadas. Se pueden editar y modificar las áreas de datos generadas después de crearlas. El responsable de una implantación puede cambiar los nombres de los elementos o eliminar elementos innecesarios si lo desea. El cambio manual de las áreas de datos generadas debe realizarse solo cuando es absolutamente necesario. Esto se debe a que el sistema no puede validar los cambios manuales y los problemas de las áreas de datos solo se detectarían en tiempo de ejecución.

Activación de los adaptadores de servicio web

Los objetos de negocio proporcionados por el paquete base para los adaptadores de servicio web incluyen un ciclo de vida útil sencillo de pendiente y activo. Configure el adaptador de servicio web y sus áreas de datos mientras el estado es Pendiente y actívelo cuando esté listo para la implantación en la funcionalidad de sistema adecuada.

Llamada de servicios web

Para llamar a un servicio web usando un adaptador de servicio web, el sistema incluye un servicio de negocio Emisor de servicios web (F1-InvokeWebService) que permite realizar una llamada a un servicio web. El programa que realiza la llamada es el responsable de obtener toda la información para rellenar correctamente los datos de solicitud que necesita la llamada al servicio web antes de llamar al servicio de negocio.

Nota:

Para obtener más información, consulte la descripción detallada del servicio de negocio.

Limitaciones

Los puntos siguientes resaltan las limitaciones asociadas con los tipos de servicios web que se soportan en el sistema:

Es posible que un documento WSDL contenga definiciones para varios servicios web. El sistema actualmente solo soporta un puerto o servicio por documento WSDL.
Un WSDL puede soportar varios patrones de mensaje. El sistema actualmente solo soporta solicitud/respuesta.