Para crear estas automatizaciones de forma más rápida y sencilla, recomendamos utilizar Camunda Modeler.
Al final de cada artículo encontrarás ejemplos de archivos que podrás descargar, abrir y adaptar directamente desde Camunda. Una vez configurado el archivo con la automatización que necesites, podrás importarlo fácilmente en Wattwin.
Descarga Camunda Modeler aquí: Camunda Modeler v4.11.1
¿Cómo funciona?
En este artículo veremos cómo configurar una tarea automática de ejecución de un script dentro de un proceso BPM de Wattwin.
Este tipo de tarea permite ejecutar un script concreto dentro del flujo de una automatización. Puede utilizarse, por ejemplo, para validar datos, comprobar información de una oportunidad o servicio, o aplicar lógica específica antes de continuar con el proceso.
Nota:
En este tipo de tarea, la variable principal permite indicar qué script debe ejecutarse. Si el código del script no se informa correctamente, la tarea no podrá ejecutar la validación o acción esperada.
Variables
En esta sección veremos las posibles variables que se pueden configurar en una tarea automática de ejecución de script.
En este caso, la variable principal es la que permite indicar el código del script que queremos ejecutar dentro del proceso BPM.
1. Script
La variable de script permite indicar qué script debe ejecutarse cuando el proceso llegue a esta tarea.
Para ello, debemos informar el código del script en la variable scriptCode.
¿Cómo encontrar el código del script en Wattwin?
Para localizar el código del script:
- Accede a Configuración > Scripts.
- Localiza el script que quieres ejecutar desde la tarea BPM.
- Copia el valor del campo correspondiente al script seleccionado. Este será el valor que deberás informar en la variable
scriptCode.
-
Variable:
scriptCode - Valor: código del script que queremos ejecutar.
La estructura del script será similar a la siguiente (siguiendo el ejemplo de la captura anterior):
execution.setVariableLocal("scriptCode", "VALIDACIÓN_DNI_CLIENTE);Importante:
Asegúrate de copiar exactamente el código del script. Los códigos son siempre en mayúscula. Si el valor informado no coincide con un script existente o está mal escrito, la tarea no podrá ejecutarlo correctamente.
Funcionalidades adicionales
En algunos casos, puede ser necesario configurar un comportamiento alternativo si la ejecución del script falla.
Por ejemplo, si el script realiza una validación y esta no se cumple, podemos hacer que el flujo no continúe por el camino normal y redirigirlo hacia otra tarea específica.
Para ello, se puede añadir a la tarea un evento de error. Este evento permite definir una salida alternativa en caso de que el script no finalice correctamente:
- Para crear este evento, se debe añadir una bolita vacía, arrastrarla encima de la tarea y seleccionar este tipo de evento.
Ejemplo:
Si la tarea valida el campo DNI del cliente y el script falla porque el cliente no tiene rellenado el DNI, el flujo puede redirigirse automáticamente hacia una tarea de revisión o corrección del dato.
Ejemplo de flujo
En el siguiente ejemplo, si la ejecución del script finaliza correctamente, el proceso seguirá con el flujo normal.
En cambio, si la ejecución del script falla, el proceso se desviará hacia una tarea alternativa para completar o revisar el campo requerido.
Con esta configuración, si la ejecución del script falla, es decir, si el cliente no tiene rellenado el DNI, el flujo se dirigirá a la tarea Falta rellenar el campo. Si el script termina correctamente, el proceso continuará con el flujo habitual.
Recomendación:
Utiliza este tipo de evento cuando el script pueda bloquear el avance normal del proceso y necesites definir un camino alternativo para corregir la información o gestionar la excepción.
Ejemplo de configuración completa
A continuación se muestra un ejemplo básico de configuración de una tarea automática de ejecución de script:
execution.setVariableLocal("scriptCode", "VALIDACION_DNI_CLIENTE");Con esta configuración, Wattwin ejecutará el script indicado cuando el proceso llegue a esta tarea.
Si además se ha configurado un evento de error, el flujo podrá continuar por un camino alternativo en caso de que el script no se ejecute correctamente.
Fichero BPM de ejemplo
En esta sección se puede adjuntar o mostrar un ejemplo de fichero BPM con una tarea automática de ejecución de script ya configurada (descárgalo al final del artículo).
Este fichero puede servir como referencia para revisar cómo debe informarse la variable scriptCode dentro del flujo y cómo puede configurarse un evento alternativo en caso de error.
Nota:
Antes de utilizar el fichero BPM en un entorno real, revisa que el valor de scriptCode corresponde con un script existente y válido dentro del dominio en el que se va a aplicar.
👇🏼