Un conector por dentro

Llegado a este punto el lector puede llegado a la conclusión que un conector no es diferente a un proyecto de JavaScript cualquiera, pero Bizagi oculta mucha esencia de lo que se trata desarrollar para brindarle un proceso más amigable a aquellos que no cuentan con tanta familiaridad con el tema.

Es por lo anterior que el editor de conectores de Bizagi no ofrece un ambiente muy amigable para un desarrollador por las siguientes razones:

• La mantenibilidad está comprometida al no poder controlar la estructura del proyecto.

• No se cuenta con un linter para indicar de errores o malas prácticas.

• No se cuenta con un debugger, por ende cada vez que el desarrollador necesite testear la funcionalidad del conector, tendría que usar el software de Bizagi Studio y manualmente asegurarse de una perfecta ejecución.

• La refactorización es más costosa debido a que no existe ningún beneficio que un IDE cualquiera nos podría ofrecer.

El lector posiblemente se haya dado cuenta que los conectores tienen una extensión llamada .bizc (lo más probable que sea por "Bizagi Connector"). Dicha extensión es únicamente reconocida por Bizagi Studio y sucede que estos archivos tienen un parecido con archivos .zip. Para dar una imagen clara, uno puede cambiarles la extensión a .zip y descomprimirlos.

Hagamos el ejemplo con el conector de Imgur que acabamos de realizar.

Una vez hecho eso se puede extraer usando cualquier clase de software de compresión. Podemos revisar el interior del directorio y encontraremos una estructura genérica para todos los conectores de Bizagi.

Cómo ya no estamos limitados en la edición por el editor de conectores, podemos importar este directorio en nuestro IDE favorito y trabajar de la misma manera que se haría una aplicación de node.js.

.
|- actions______________________________# Directorio con las acciones. (Los archivos están en kebab-case).
|- auth_________________________________# Directorio necesario para el conector.
|- def  
|   |-- connector.json__________________# Definición del conector. JSON con la toda la información del conector. Bizagi Studio usa este archivo para interpretar el conector.
|- etc__________________________________# Directorio necesario para usar bz-util.
|   |-- config.js
|- node_modules_________________________# Dependencias del proyecto.
|- actions.js___________________________# JSON con las acciones y sus descripciones.
|- bizagiRouter.js______________________# Contiene lógica para ejecutar las acciones.
|- package.json_________________________# package.json con la información del conector y dependencias.
|- Readme.md____________________________# README ordinario.

De esta manera se tine un mayor control sobre la estructura del proyecto, pero ahora hay algunos problemas que se deben resolver:

• Si hiciéramos el proceso contrario, es decir, comprimir el directorio a un .zip y luego cambiarle la extensión a .bizc, Bizagi Studio no reconoce el tipo de archivo. Esto ocurre porque no tuvimos en cuenta la misma configuración para la compresión que tuvo el editor de conectores.

• Tampoco existe una manera de modificar la metainformación del conector, cómo lo son el autor, versión, descripción, ícono, entradas y salidas de las funciones, etc.