Introducción
Bizagi ofrece un Conector de servicios Web, que forma parte de su capa de integración, para simplificar la configuración de integraciones con servicios web externos. Este conector soporta tanto servicios web SOAP como servicios REST.
Este artículo se centra en la integración con servicios REST externos. Para obtener información sobre la integración con servicios web SOAP, consulte Invocar servicios Web (SOAP).
|
La versión 11 introdujo una potente funcionalidad para integraciones B2B basada en servicios REST conocida como Conectores de Bizagi.
Se recomienda utilizar Conectores de Bizagi porque proporcionan opciones de extensibilidad adicionales, como soporte para encabezados y autenticación OAuth.
Para obtener más información, consulte Conectores de Bizagi. |
Integración con servicios RESTful
La siguiente imagen ilustra cómo Bizagi se integra con servicios RESTful mediante su Conector de servicios Web:
El intercambio de información entre Bizagi y un sistema externo se realiza mediante estructuras XML estándar. Este enfoque hace que la integración sea independiente de las plataformas, tecnologías y lenguajes de programación utilizados para implementar el servicio.
Antes de continuar, es útil comprender las principales características de los servicios REST y cómo difieren de los servicios web SOAP tradicionales. Ambos enfoques son ampliamente utilizados en integraciones de aplicaciones y ninguno pretende reemplazar al otro.
Servicios REST comparados con servicios web SOAP
Los servicios REST se adoptaron ampliamente como una alternativa eficiente para acceder a información desde aplicaciones web y móviles.
Los ejemplos típicos incluyen:
•Servicios geográficos y de mapas.
•Servicios de información web general.
•Servicios de redes sociales.
•Servicios de tipos de cambio.
•Servicios meteorológicos.
•Servicios de precios de productos.
Los servicios REST exponen información como recursos que pueden consumirse a través de HTTP o HTTPS.
Los servicios web SOAP siguen un enfoque diferente. Se utilizan comúnmente en arquitecturas orientadas a servicios (SOA) e integraciones empresariales, donde las definiciones de servicios y las estructuras de comunicación están definidas de manera más formal.
La configuración de una integración SOAP o REST difiere de las siguientes maneras.
Servicios SOAP
Al invocar un servicio web SOAP, el sistema consumidor puede interpretar y utilizar la definición del servicio.
Esta definición se proporciona mediante un WSDL (Web Services Description Language), que describe las estructuras de entrada y salida esperadas del servicio.
Servicios REST
Al invocar un servicio REST, normalmente no existe una definición del servicio disponible que un sistema consumidor pueda interpretar automáticamente.
Como resultado, usted debe comprender la documentación del servicio, definir las entradas requeridas y configurar cómo se procesa la respuesta.
Acerca de los servicios REST
Los servicios REST soportan cuatro métodos HTTP que se utilizan para interactuar con recursos.
Acción |
Método HTTP |
|---|---|
Crear |
POST |
Leer |
GET |
Actualizar |
PUT |
Eliminar |
DELETE |
Los pasos de configuración en el Asistente de Interfaces de Bizagi varían ligeramente según el método HTTP seleccionado.
Al utilizar POST o PUT, se debe enviar información adicional al recurso. Por lo tanto, se requiere un paso de configuración adicional para definir dicha información.
Los métodos descritos en este artículo utilizan Autenticación Básica.
Prerrequisitos
Dado que los servicios REST suelen estar expuestos a través de Internet, es importante revisar la documentación del servicio antes de intentar configurar la integración.
La documentación debe especificar:
•Los parámetros de entrada esperados.
•La estructura de la respuesta del servicio.
•Los métodos HTTP soportados.
Las API de servicios REST generalmente proporcionan descripciones de sus estructuras de entrada y salida, junto con ejemplos que muestran cómo consumir recursos mediante GET, POST, PUT y DELETE.
Para obtener información sobre opciones adicionales de configuración de REST, como la definición del content-type, consulte Opciones de configuración en los servicios REST
Lo que necesita hacer en Bizagi
Puede invocar un servicio REST externo desde cualquier Actividad de un Proceso de Bizagi.
Para configurar la invocación, utilice el Asistente de Interfaces para definir la información enviada desde Bizagi y cómo la respuesta devuelta por el servicio externo actualiza los datos del proceso.
El proceso de configuración consta de los siguientes pasos:
1.Crear una invocación de interfaz.
2.Especificar el tipo de servicio, la URL y el método.
3.Mapear los parámetros de entrada del servicio para los métodos POST y PUT.
4.Mapear la respuesta devuelta por el servicio externo.
5.Configurar el manejo de errores opcional.
Ejemplo
Los siguientes ejemplos muestran cómo invocar servicios REST:
•Para los métodos GET y DELETE, consulte Ejemplo para métodos de obtención de información.
•Para los métodos POST y PUT, consulte Ejemplo para métodos de colocación de información.
Después de completar estos ejemplos, comprenderá cómo invocar un servicio REST desde Bizagi.
Consideraciones
Bizagi conserva la configuración de una invocación y sus mapeos incluso si el servicio web externo cambia posteriormente.
Si el servicio web externo cambia su definición o introduce parámetros nuevos o modificados, debe revisar la configuración en Bizagi Studio para determinar si la invocación debe reconfigurarse.
Se recomienda revisar la configuración del servicio y verificar que todos los mapeos sigan siendo válidos para cualquier parámetro nuevo o modificado.
También puede optar por administrar sus interfaces de Pruebas o Producción si se realizan cambios en los sistemas externos, como mover el servidor que hospeda el servicio web externo.
Last Updated 8/27/2026 2:59:11 PM