Introducción
Existen dos tipos de conectores: Asistidos REST y Personalizados, como se indica en Crear conectores.
Esta sección presenta una guía de pasos de alto nivel que se deben considerar cuando se desean crear conectores asistidos REST.
Antes de comenzar
Es muy importante que primero se tenga conocimiento del API del sistema o aplicación externa a la que desea conectarse.
Ponga especial cuidado al tipo de autenticación que el API de esa aplicación externa soporta.
Esto significa, que usted deberá consultar la documentación oficial de dicho aplicación externo antes de comenzar con el desarrollo de un conector.
La información acerca del tipo de autenticación soportada le proporcionará una indicación para determinar si puede crear un conector de tipo Asistido REST, o si por el contrario, es necesario un conector de tipo Personalizado.
Para mayor información sobre cuándo crear un conector Personalizado, consulte los Métodos de autenticación y conectores tipo REST.
Bizagi tiene una opción de configuración de Proxy disponible para conectar con servicio externos tal como conectores asistidos REST.
Pasos para crear conectores Asistidos REST
Al crear un conector de tipo Asistido REST, los siguientes son los pasos generales a considerar:
1.Asegúrese de tener una cuenta válida con acceso autorizado a su aplicación externa desde otras aplicaciones (p.e, un nombre de usuario y contraseña válida, además de tokens de acceso u otras configuraciones en su aplicación externa).
2.Utilice el Hub de Integración para crear un nuevo conector de tipo REST.
3.Usted puede configurar un base URI para todas las acciones. El Base URI es un parámetro personalizable que puede ser configurado en Bizagi Studio, donde puede personalizar la URL para cada ambiente. Por ejemplo, usted puede definir el Base URI de cada ambiente de la siguiente manera:
•Ambiente de desarrollo: https://dev-api.com/services/data
•Ambiente de pruebas: https://test-api.com/services/data
•Ambiente de producción: https://prod-api.com/services/data
Si quiere configurar un Base URI, habilite este campo y escriba el Base URI donde están los servicios que utilizará.
|
Si las acciones del conector se encuentran en URLs diferentes, no utilice esta opción |
4.Cree al menos una acción y especifique las propiedades de esa acción.
|
En este paso es fundamental que define la URL de servicio (con los parámetros query string que apliquen), el método HTTP de invocación (GET/POST/PUT/PATCH/DELETE), su codificación (content type), y si la acción utiliza autenticación o no. |
5.Defina las entradas según sean necesarias para su conector y sean soportadas por el API de su sistema/aplicación externa.
6.Defina las salidas según sean necesarias para su conector y sean soportadas por el API de su sistema/aplicación externa.
|
En este paso usted podrá definir la estructura de los mensajes de error también. |
7.Si lo desea, puede probar su conector utilizando el botón de Test.
8.Cuando esté listo, guarde el conector.
Una vez que tenga el conector como archivo .bizc, siga los pasos de su instalación para probarlo desde Bizagi Studio, como se describe en Instalar y configurar conectores.
Last Updated 1/3/2024 11:46:29 AM