En esta guía vamos a ilustrar algunos ejemplos de procesos BPMN para cubrir algunos casos de uso.
Recursos relevantes:
- API REST Camunda: https://docs.camunda.org/manual/7.8/reference/rest/
- Conector HTTP Camunda: https://docs.camunda.org/manual/7.8/reference/connect/http-connector/
- Plugin SPIN (JSON) Camunda: https://docs.camunda.org/manual/7.8/reference/spin/json/
Formularios de tareas de usuario de Camunda: https://docs.camunda.org/manual/7.8/user-guide/task-forms/
INFO
En esta guía se utilizará un entorno local. Ten en cuenta que 'localhost: 8085' será la IP/DNS del servidor que aloja la plataforma onesait (es decir, defender.onesaitplatform.com)
Proceso de negocio que involucra formularios de usuario con tareas de usuario
Recursos:
Vamos a crear un proceso que comienza con un formulario personalizado embebido (start-form.html) que le pide al usuario que introduzca su edad. Cuando se envía, un administrador del proceso tiene que aprobar la solicitud enviando otro formulario (task-form.html). Por último, hay un gateway (puerta de enlace) que bifurca el flujo del proceso en función de la edad de entrada (<= 21 ó > 21).
Ambos formularios están referenciados en sus respectivas tareas.
Se hace referencia al primer formulario en el evento de inicio:
El segundo está referenciado en la tarea 'Aprobar cliente':
Estos formularios deben implementarse junto con el proceso .bpmn. Para hacer esto, puedes usar la API REST de la siguiente manera:
(Recuerda el encabezado de autorización con el token de portador de plataforma de onesait)
De todos modos, este proceso ya está disponible como ejemplo por defecto en el motor BPMN.
Para iniciar el proceso, puedes usar la API REST o ir a la aplicación web Camunda de la lista de tareas a través de Controlpanel.
API REST
Esto se demostrará en el siguiente ejemplo de proceso (MSO).
Webapp de lista de tareas Camunda
Ve a BPMN tenants (inquilinos) y haz clic en 'View it' (verlo).
Serás redirigido a la aplicación web Camunda. Luego, haz clic en 'Tasklist' (Lista de tareas).
Entonces, en la barra superior, en el lado derecho, haz clic en 'Start process' (Iniciar proceso) y selecciona 'Customer Data Process' (Proceso de datos del cliente).
Se te presentará el formulario. Complétalo y haz clic en Start (Iniciar).
El proceso se desencadenará y aparecerá una nueva tarea en la lista de tareas.
Puedes reclamarla y aprobar la solicitud.
Finalmente, el proceso se detendrá en la tarea 'Over 21' (Más de 21). ¡Reclámala y complétala!
Proceso de negocio que involucra la orquestación de microservicios (Micro Service Orchestration, MSO)
Recursos:
El proceso básicamente acepta o rechaza una operación de pago. Esto implica la validación de un token (tarjeta de crédito) y el saldo disponible.
En este proceso vamos a organizar algunos microservicios/llamadas API. El flujo implementa la siguiente lógica:
- El proceso comienza con dos parámetros: token y cantidad para la operación. El parámetro token está asociado con una tarjeta de crédito en otra base de datos, y la cantidad es la cantidad de crédito que se utilizará en la operación.
- El token se valida llamando al microservicio A, que devuelve el número de tarjeta de crédito asociado.
- Si se recupera el número de tarjeta de crédito, entonces se recupera el saldo de esta cuenta bancaria (microservicio B), y si el saldo es mayor que la cantidad, entonces el proceso acepta la operación de pago. De lo contrario, se rechaza.
- Por último, se realiza una transacción al microservicio C, como una solicitud POST.
Este ejemplo también está disponible de forma predeterminada en el motor BPMN, pero probablemente tengas que cambiar las direcciones URL de los conectores http.
Tareas de servicio (llamadas a la API REST)
Las tres tareas principales de servicio implementan un conector http para realizar las llamadas. Este conector se configura dentro de la configuración de la tarea, seleccionando Details>Implementation>Connector (Detalles>Implementación>Conector).
Después aparecerá una nueva pestaña para establecer los parámetros del conector.
En los encabezados establecemos el Content-type (tipo de contenido), aceptar (Accept), autorización (Authorization), etc.
El método es el método HTTP.
La url es la url de la API REST.
La carga útil o payload (opcional) es el cuerpo de la solicitud. Cuando necesites enviar cargas útiles JSON, usa el Script de Tipo de Parámetro (Parameter Type Script) para hacer uso del Plugin Spin.
Vamos a comenzar el proceso a través de la API REST de Camunda
Primero necesitas conocer la ID de definición del proceso. Puedes recuperarla haciendo la siguiente solicitud.
(Recuerda el encabezado de autorización con el token de portador de plataforma de onesait)
Para empezar el proceso, realiza la siguiente petición con los parámetros de entrada (token y cantidad) en el cuerpo de la solicitud.
Como este proceso no tiene ninguna tarea de usuario, terminará y tú tendrás en la respuesta las variables creadas a lo largo de la ejecución del proceso:
