Cree sus propios conectores de flujo de trabajo en el microservicio de flujo de trabajo de E/S de ProcessMaker
Uso de conectores de flujo de trabajo en un proceso empresarial
Los conectores de flujo de trabajo se utilizan en procesos comerciales para conectarse a sistemas de terceros. Hoy en día, la mayoría de los procesos comerciales necesitan conectarse a múltiples sistemas de terceros para recuperar y/o enviar datos. ProcessMaker I/O tiene una forma muy potente y moderna de construir y administrar conectores y, como tal, tiene muchas de las características de un iPaaS (plataforma de integración como servicio como mulesoft). No obstante, también puede ser conveniente conectar ProcessMaker a otras soluciones iPaaS para mejorar la capacidad de administrar flujos de trabajo y reglas en torno a conjuntos de conectores más grandes.E/S de ProcessMaker es un microservicio API de flujo de trabajo. Está diseñado para proporcionar una manera sencilla para que un desarrollador agregue funcionalidad de flujo de trabajo a una aplicación empresarial con poco esfuerzo de desarrollo. ProcessMaker I/O ahora tiene un marco de conectores completo para permitir una manera fácil de desarrollar y mantener conectores como parte del microservicio ProcessMaker I/O.
Biblioteca de conectores de flujo de trabajo
ProcessMaker I/O tiene una forma para que los desarrolladores creen sus propios conectores de flujo de trabajo y También existe una biblioteca de conectores disponibles públicamente que han sido construidos por el equipo de E/S de ProcessMaker. Constantemente agregamos nuevos conectores de flujo de trabajo, por lo que debe volver a consultar con frecuencia para ver qué nuevos conectores están disponibles. Además, si desea ver un conector específico y no está en la lista, háganoslo saber. Aquí está nuestra corriente biblioteca de conectores públicos.
Uso de conectores de flujo de trabajo preconstruidos en 5 sencillos pasos
Para utilizar un conector preconstruido existente en su proceso comercial, siga estos pasos:
Crear un proceso con una tarea de servicio - Puede hacer esto mediante programación o utilizar cualquier editor de procesos compatible con BPMN 2.0 existente (Adonis, comercio itp, etc.) para crear un mapa de procesos exportable
Configure el conector en la Tarea de Servicio de su proceso
Configure el enlace al script lua en el parámetro de entrada `script_url`
Como ejemplo de este parámetro para el conector Docusign es el siguiente:
`script_url`:https://raw.githubusercontent.com/ProcessMaker/pmio-lua-connectors/master/docusign/docusign.lua2. Configurar los parámetros de entrada para el conector - Por ejemplo, para el conector Docusign aquí están los parámetros: nombre de usuario: {nombre de usuario}contraseña: {contraseña}claveintegradora: {clave}api_endpoint:login_informationscript_url:https://raw.githubusercontent.com/ProcessMaker/pmio-lua-connectors/master/docusign/docusign.luabase_url:https://demo.docusign.net/restapi/v2/ 3. Configurar los parámetros de salida for the connector - For example for the Docusign connector here are the parameters:"email":{response.loginAccounts.0.email}, "accountId":{response.loginAccounts.0.accountId}, "siteDescription":{response.loginAccounts.0.siteDescription}, "userId":{response.loginAccounts.0.userId}, "userName":{response.loginAccounts.0.userName}, "name":{response.loginAccounts.0.name}, "isDefault":{response.loginAccounts.0.isDefault} 4. Subir el xml del proceso con el conector configurado para su entorno de E/S de ProcessMaker*Para cada punto final de API, deberá crear una tarea de servicio. Si desea utilizar varios puntos finales, debe agregar tantas tareas de servicio como necesite por cada API de solicitud. Nota: hay formas de agrupar estos conectores para crear una única tarea de servicio, pero lo dejaremos para una discusión posterior. El ejemplo de un proceso que incluye una tarea de servicio con un conector configurado (con todos los parámetros) es aquí.Si no ha creado un entorno de E/S de ProcessMaker, haga lo siguiente:
Una de las grandes características de ProcessMaker I/O es que no tienes que esperar a que nuestro equipo cree los conectores que deseas. Tienes la posibilidad de crear cualquier conector a cualquier sistema de terceros muy fácilmente. Cualquier conector que cree deberá cargarse en el Repositorio de Github de ProcessMaker para nuestros conectores Lua para poder ser ejecutado. No es necesario ser muy técnico para crear un conector, pero deberá tener conocimientos básicos de los métodos de autorización, las llamadas API y la sintaxis de Lua. Sin embargo, si observamos algunos de nuestros ejemplos, creemos que incluso un usuario no técnico puede hacerlo con bastante facilidad.
Usando LUA
Lua es el lenguaje que utilizamos para crear tus conectores. Lua es un lenguaje de programación muy divertido y fácil de aprender. Significa “luna” en portugués, eso es genial. Si quieres aprender más sobre el idioma, puedes leer más aquí. Para utilizar Lua, el primer paso es configurar Lua en su computadora. Si ya tienes Lua, comprueba que todas las bibliotecas necesarias estén instaladas. Aquí puedes leer el tutorial detallado sobre cómo configurar Lua y sus módulos.
Uso de la API del servicio de terceros
Una vez que haya instalado Lua, el siguiente paso es encontrar la documentación de la API a la que planea conectarse. Por ejemplo, si fuera a crear un conector para Docusign, revisaría el DOCUMENTACIÓN DE LA API de DocuSign. Deberá determinar qué puntos finales de la API desea utilizar para su necesidad de proceso particular. Para comenzar con la API de terceros, deberá hacer lo siguiente:
Crear una cuenta de servicio o utilizar una cuenta existente
Define los parámetros de entrada que quieres utilizar en tu conector
Por ejemplo: Parámetros de entrada para DocuSign* `nombre de usuario` - correo electrónico del usuario de la aplicación utilizado para autorizar la llamada* `contraseña` - contraseña del usuario utilizada para autorizar la llamada* `clave de integrador` - utilizada para integrar y autenticar con la plataforma DocuSign* `api_endpoint` - URI del punto final de la API, por ejemplo, `login_information`* `base_url` - la URL de la API del servicio
Crea tu propio script de Lua
La forma más sencilla de hacerlo es simplemente copiar el script de uno de nuestros ejemplos de conectores Lua. Cada conector LUA consta de los siguientes componentes:
respuesta: estructura decodificada JSON recibida de la respuesta API.
código - Código de respuesta HTTP.
encabezados: estructura de encabezados recibida de la respuesta API.
Después de desarrollar su conector, debe probarlo para asegurarse de que todo funcione correctamente. La forma sencilla de probarlo es crear un archivo con los parámetros de entrada que requiere el conector. Como ejemplo: input2.txt:{ "nombre de usuario": "su_nombre de usuario", "contraseña": "su_contraseña", "clave de integrador": "su_clave de integrador", "api_endpoint": "información_inicio de sesión", "baseUrl": "https://demo.docusign.net/restapi/v2/"}Run modo consola e ingrese el siguiente comando:`lua docusign.luaDebería obtener esta respuesta:{"headers":{"content-length":"379","strict-transport-security":"max-age=31536000; includeSubDomains","content-type":"application/json; charset=utf-8","date":"Fri, 09 Feb 2018 13:41:18 GMT","connection":"close","x-docusign-tracetoken":"XXXXX","cache-control":"no-cache"},"code":200,"response":{"loginAccounts":[{"baseUrl":"https://demo.docusign.net/restapi/v2/accounts/XXXXX","email":"XXX@XXX.com","accountId":"XXX","siteDescription":"","userId":"XXXXX","userName":"XXXXX","name":"XXXXX","isDefault":"true"}]}}If you get "code":200, that mean that your connector works correctly!
Publique su conector en la biblioteca de conectores
Crea un Github cuenta o utilizar una cuenta existente
Cree una solicitud de extracción al repositorio público de Github y envíe un correo electrónico a support@processmaker.io
Para la versión actual, solo están disponibles para su uso los conectores de la Biblioteca. Estamos planeando agregar la posibilidad de utilizar su propio repositorio privado en el futuro. Si desea crear un conector Lua y mantenerlo en el repositorio privado ahora, comuníquese con nuestro equipo de soporte support@processmaker.ioNow su conector está listo para usarse.
15 de octubre de 2026
Herramientas puntuales versus plataforma: qué sucede cuando la orquestación no es nativa
