Tarea automática - Cambio de etapa

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?

Las tareas de cambio de etapa permiten automatizar el movimiento de una oportunidad o servicio dentro de un tablero de Wattwin.

Este tipo de tarea puede resultar útil cuando queremos que, al cumplirse una condición concreta dentro de un proceso BPM, el registro avance automáticamente a una etapa determinada del tablero.

Para configurar correctamente esta acción, es necesario indicar a qué etapa queremos mover el registro. Para ello, utilizaremos una variable específica: stageId.

Esta variable debe contener el identificador interno de la etapa de destino. A continuación, te explicamos qué variable debes configurar y cómo puedes encontrar este identificador dentro de Wattwin.

Nota:
En el script de la tarea BPM se debe informar la variable y su valor siguiendo la estructura correspondiente. En este caso, la variable será stageId y el valor será el ID de la etapa a la que queremos mover el registro.

Video explicativo 

También puedes acceder rápidamente a las diferentes secciones de este artículo:

Variables

En esta sección veremos las posibles variables que se pueden configurar en una tarea de cambio de etapa.

Actualmente, para indicar la etapa a la que debe moverse el registro, se utiliza la siguiente variable:

• Variable: stageId
• Valor: ID de la etapa del tablero a la que queremos mover la oportunidad o servicio.

Importante:
El valor de stageId debe corresponder exactamente con el ID interno de la etapa del tablero. Si se informa un ID incorrecto, la tarea no podrá mover el registro a la etapa esperada.

¿Cómo encontrar el ID de la etapa en Wattwin?

Para configurar correctamente la variable stageId, primero es necesario localizar el ID de la etapa dentro del tablero de oportunidades o servicios.

Este identificador puede consultarse desde las herramientas de desarrollo del navegador, revisando la llamada que carga las etapas del tablero.

1. Accede a Wattwin y dirígete a Configuración > Tablero de oportunidades / servicios, según el tipo de tablero que quieras consultar.
2. Abre las herramientas de desarrollo del navegador. Puedes hacerlo pulsando clic derecho sobre la pantalla y seleccionando Inspeccionar, o usando el atajo correspondiente de tu navegador.
3. Dentro del panel de inspección, accede a la pestaña Network.
4. En Wattwin, selecciona el tablero del que necesitas obtener las etapas. Al hacerlo, el navegador registrará las llamadas necesarias para cargar la información del tablero.
5. En la pestaña Network, busca la llamada que contenga el nombre Stages.
6. Haz clic sobre la llamada y abre la pestaña Preview. Desde esta vista podrás consultar la información de las etapas del tablero, incluyendo sus identificadores internos.
7. Localiza la etapa a la que quieres mover el registro y copia su ID. Este será el valor que deberás informar en la variable stageId.

Recomendación:
Asegúrate de copiar el ID de la etapa correcta y del tablero correspondiente. Si trabajas con tableros distintos para oportunidades y servicios, cada uno puede tener sus propias etapas e identificadores.

Ejemplo de configuración de la variable

Una vez localizado el ID de la etapa, podrás utilizarlo en la configuración de la tarea BPM.

Por ejemplo, si queremos mover una oportunidad o servicio a una etapa concreta, deberemos informar la variable de la siguiente manera:

• Variable: stageId
• Valor: el ID de la etapa obtenida desde la llamada Stages.

La estructura del script será similar a la siguiente:

execution.setVariableLocal('stageId', 'ID_DE_LA_ETAPA');

De esta forma, cuando el proceso llegue a la tarea configurada, Wattwin identificará la etapa indicada y moverá el registro automáticamente.

Fichero BPM de ejemplo

En esta sección se adjunta un ejemplo de fichero BPM con una tarea de cambio de etapa ya configurada (ver final del artículo).

Este fichero puede servir como referencia para revisar cómo debe informarse la variable stageId dentro del flujo y comprobar la estructura esperada de la automatización.

Nota:
Antes de utilizar el fichero BPM en un entorno real, revisa que el valor de stageId corresponde con una etapa existente en el tablero del dominio en el que se va a aplicar.