Servicios Web (Web Services)
De
<keywords content="keywords">Invocar servicios web, Servicios Web, webservice, Web Service, web service, interfaz, integracion</keywords>
Contenido |
Invocando servicios externos desde Bizagi
Introducción
Bizagi presenta una capa de integración que permite la integración con sistemas existentes (externos a Bizagi) a nivel de proceso.
Esta capa de integración cumple con los principios de la arquitectura orientada a servicios (SOA), que permite la invocación de servicios web-based (basados en protolos web), tales como servicios web estándar (SOAP) o servicios REST.
Estos servicios basados en protocolos web, son disponibilizados como métodos web a través de una URL, ya sea en una ubicación de la red interna (intranet) o en una ubicación externa a la misma (internet).
El siguiente diagrama ilustra este concepto:
A través de esta funcionalidad y posibilidad, es posible enviar información de negocio desde un proceso en Bizagi como datos de entrada para la invocación del servicio externo.
Seguidamente, la información de respuesta de este servicio es automáticamente actualizada en Bizagi (de vuelta en el modelo de datos del proceso).
El intercambio de información entre Bizagi y el sistema externo, se realiza a través de XML estándar. De esta manera, la integración es posible de manera independiente de la plataforma o tecnología, o el lenguage de programación utilizado en la implementación del servicio basado en protocolos web.
Para configurar ya sea una invocación a un servicio web SOAP, o una invocación a un servicio REST, Bizagi ofrece el asistente gráfico para una configuración rápida, sin la necesidad de programación!
Tenga en cuenta que Bizagi también permite configurar una integración a nivel de datos (hacia un repositorio existente).
Vea mayor información sobre los posibles tipos de integración en un proyecto Bizagi.
Acerca del asistente de interfaces
El asistente de interfaces se activa desde el paso 6 del asistente de proceso, y éste presenta 4 pasos guiados para la configuración de la invocación al servicio basado en protocolos web.
Dicho asistente, provee opciones adicionales para incluir ajustes manuales a las transformaciones XML (para usuarios avanzados), y provee soporte a los 2 tipos de invocaciones: de servicios Web SOAP, o de servicios REST.
Si desea consultar la información relacionada a la invocación de servicios REST desde Bizagi, revisar el artículo Cómo invocar un servicio REST desde Bizagi.
Cómo invocar un servicio web SOAP desde Bizagi
En el siguiente ejemplo y sus secciones, abordaremos cómo invocar un servicio web SOAP desde Bizagi:
Lo que debe hacer en Bizagi
Para configurar la invocación al servicio Web SOAP, se realizan los siguientes pasos:
1. Resolver URL de Servicio Web
2. Determinar los parámetros de entrada
3. Determinar los parámetros de salida
4. Configurar el Manejo de Errores
Ejemplo
En los siguientes pasos , utilizaremos como ejemmplo el proceso de solicitud de vacaciones ("Vacation Request"), en el cual un empleado realiza la solicitud de vacaciones donde se consulta inicialmente el número de dias disponibles con los que cuenta.
Para esta configuración, ir al paso sexto del asistente de proceso y hacer clic en la opción de Definir interfaces ("Define interfaces").
Una vez que se encuentre en la vista de "definición de interfaces" del proceso, haga clic en la tarea automática donde se invocará el servicio web externo. Nótese que cuando el proceso se muestra desde esta vista (en este paso), solo las tareas de servicio (automáticas) son resaltadas o habilitadas.
En la imagen a continuación, la tarea automática para el ejemplo es la de "Verificar dias disponibles" (Verify Available Vacation Days), en la cual Bizagi obtendrá del sistema externo, ese número de dias vacacionales para el empleado.
Al hacer clic en la tarea automática, el asistente de interfaces se abrirá.
Para una guía más detallada sobre el uso de este asistente, referirse al ejemplo usando el asistente para invocar servicios web.
Resolver URL de Servicio Web
En este primer paso la URL del servicio web se especifica, y se selecciona el método a invocar.
|
Nota: Para esta configuración desde el asistente de interfaces, primero seleccionamos SOAP como el tipo de servicio: 
|
Determinar los parámetros de entrada
Para cada uno de los parámetros requeridos para establecer comunicación con el sistema externo, el ayudante desplegará las opciones para obtener esta información del modelo de datos usando XPATH.
Nótese que existen mas posibilidades para facilitar el mapeo en las funciones y opciones especiales para el mapeo de datos usando servicios web.
Determinar los parámetros de salida
Dependiendo en el tipo de datos retornado en el Método Web, es posible guardar la respuesta en un XPath dado.
Nótese que existen mas posibilidades para facilitar el mapeo en las funciones y opciones especiales para el mapeo de datos usando servicios web.
Configurar el Manejo de Errores
Para una interface, al menos tiene configurarse qué hacer si la invocación del servicio Web falla. Adicionalmente existe la posibilidad para validar y respuesta de error, y configurar una acción, dependiendo de la variable que el servicio Web retorne.
|
Alerta: Bizagi guarda la configuración de su invocación y el mapeo, incluso si después se cambia el método del web service (su firma de definición tiene parámetros diferentes o nuevos). De igual manera, se recomienda revisar la configuración de invocación de su servicio web y revisar la asignación de los nuevos parámetros. . |
Temas Relacionados y Avanzados
- Ejemplo Usando el Ayudante para Invocar Servicios Web
- Opciones Avanzadas para Invocar un Servicio Web
- Administración de Interfaces
- Interacción con Bizagi vía SOA
- Integración de Bizagi con teléfonos inteligentes
- Funciones y opciones especiales para el mapeo de datos usando servicios web
<comments />
