Descripción de Adaptadores de Servicio Web

Los temas siguientes describen con mayor detalle la funcionalidad del sistema.

Importación de un WSDL

La configuración de un Adaptador de Servicio Web se inicia con la identificación del WSDL (el documento de lenguaje de descripción del servicio Web que se utiliza para definir la interface) que proporciona el sistema externo. Los pasos siguientes describen la funcionalidad de producto base proporcionada para autorizar a un usuario a importar un WSDL.

  • Navegue a la página Adaptador de Servicio Web en modo de adición y seleccione el objeto de negocio base apropiado.
  • Ingrese un Nombre de Servicio Web significativo y descripciones apropiadas.
  • Proporcione el URL del WSDL determinado.
  • Haga click en Importar para recuperar los detalles del WSDL. El sistema analiza los detalles de WSDL y completa las opciones Nombre de Servicio de WSDL, Origen de WSDL, Puerto de WSDL, URL y una lista de Operaciones (métodos) definida en el WSDL.
  • Determine qué Operaciones deben estar activas según los requerimientos de negocios para invocar este servicio Web. Las operaciones activas son aquellas que la implementación planifica invocar desde el sistema. Éstas requieren que se generen áreas de datos de solicitud y respuesta apropiadas para ellas. La sección siguiente proporciona más información al respecto.
  • Especifique el Tipo de Seguridad apropiado para configurar el tipo de seguridad a utilizar cuando se invoque este servicio Web.
  • Haga click en Grabar.

En este punto, se crea un registro de adaptador de servicio Web con 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 requiere 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 pasos para generar las áreas de datos, tal como aparece a continuación:

  • Tal como se describe en la sección Importación de un WSDL anterior, las operaciones listadas en el WSDL se generan para el adaptador de servicio Web y el implementador debe indicar qué operación activar.
  • Después de grabar el adaptador de servicio Web pendiente, el despliegue lista todas las operaciones activas y para cada una incluye un botón Generar.
  • Una vez que haga click en Generar para una operación, aparece una ventana en la que se pueden definir los nombres de las nuevas Áreas de Datos de Solicitud y Respuesta. Haga click en Grabar para generar las áreas de datos.

Las áreas de datos generadas proporcionan la API para que el implementador la utilice al implementar la llamada de servicio Web en un algoritmo o servicio apropiado en el sistema. Las áreas de datos contienen el mapeo adecuado desde los elementos con los que el implementador trabaja en el código que invoca los servicios web y las definiciones de WSDL.

Para facilitar la generación de las áreas de datos de solicitud y respuesta, el producto base invoca un servicio de negocios especial que se utiliza para crear el mapeo adecuado. El servicio de negocios se define como una opción de objeto de negocios en el objeto de negocios Adaptador de Servicio Web. Esto autoriza que una implementación proporcione un servicio de negocios personalizado para mejorar adicionalmente el mapeo de solicitud y respuesta, cuando así corresponda.

Nota:

Áreas de datos generadas. Es posible editar y modificar las áreas de datos generadas una vez creadas. Un implementador puede cambiar los nombres de los elementos y remover los elementos innecesarios, si así se desea. Sólo se debe cambiar las áreas de datos generados a mano cuando sea absolutamente necesario. Esto es porque el sistema no puede validar los cambios manuales y los problemas con las áreas de datos únicamente se podrían detectar durante la ejecución.

Activación de Adaptadores de Servicio Web

Los objetos de negocio proporcionados por el paquete base para los adaptadores de servicio web incluyen un ciclo de vida simple de Pendiente y Activo. Configure el adaptador de servicio web y sus áreas de datos cuando su estado sea Pendiente y actívelo cuando esté listo para implementación en la funcionalidad del sistema adecuada.

Invocación de Servicios Web

Para realizar una llamada a un servicio Web mediante el uso de un adaptador de servicio Web, el sistema ha proporcionado un servicio de negocios Despachador de Servicio Web (F1-InvokeWebService) para ejecutar una llamada de servicio Web. El programa de llamada es responsable de recuperar toda la información para completar correctamente los datos de solicitud que requiere la llamada de servicio Web antes de invocar el servicio de negocios.

Nota:

Consulte la descripción detallada del servicio de negocios para obtener más información.

Limitaciones

Los puntos siguientes realzan las limitaciones asociadas con los tipos de servicios Web que soporta el sistema:

  • Es posible que un documento WSDL contenga definiciones para diversos servicios Web. El sistema actualmente soporta sólo un puerto o servicio por documento WSDL.
  • Es posible que un WSDL soporte múltiples patrones de mensaje. El sistema actualmente soporta sólo solicitud / respuesta.