Saltar al contenido principal
Iniciar sesión Menú

Tarea automática - Creación nueva instancia relacionada

  • Actualización

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 creación de una nueva instancia relacionada dentro de un proceso BPM de Wattwin.

Esta tarea permite crear automáticamente una nueva instancia vinculada a una oportunidad o servicio existente. Por ejemplo, puede utilizarse para generar un nuevo servicio relacionado con una oportunidad, crear una oportunidad a partir de otra instancia o trasladar determinada información desde el registro de origen hacia el nuevo registro creado.

A la izquierda tenemos la tarea automática de creación de una nueva instancia relacionada. Como recomendación, lo más sencillo es copiar una tarea que ya esté configurada correctamente y modificar únicamente las variables necesarias. A la derecha tenemos el fragmento de código asociado a la tarea. Para acceder a este código, debes clicar sobre la tarea y abrir la sección Listeners.

Nota:
Las variables configuradas en esta tarea determinan cómo se creará la nueva instancia: qué automatización tendrá, a qué pipeline pertenecerá, qué solución utilizará, qué usuarios estarán asignados y qué información se copiará desde la instancia de origen.

Video explicativo 

Accede rápidamente a las diferentes secciones de este artículo:

Variables

1. Automatización

2. Pipeline

3. Solución

4. Tipo de instancia

5. Canal

6. Solicitante / Responsable / Responsable comercial / Responsable técnico

7. Duplicar instalación y presupuesto

8. Variables extra

Ejemplo de configuración completa

Fichero BPM de ejemplo

Variables

En esta sección veremos todas las posibles variables que se pueden configurar en una tarea automática de creación de una nueva instancia relacionada.

Estas variables permiten definir la configuración principal de la nueva instancia, así como algunos comportamientos adicionales, como duplicar la instalación y el presupuesto o enviar información extra desde la oportunidad de origen.

 

1. Automatización

Esta variable permite escoger qué automatización tendrá la nueva instancia creada.

Es decir, permite indicar qué flujo BPM deberá seguir la instancia una vez se haya creado automáticamente.

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

Para localizar el ID de la automatización:

  1. Accede a Configuración > Automatizaciones.
  2. Selecciona la automatización que quieres utilizar en la nueva instancia.
  3. Una vez dentro de la automatización, copia el identificador que aparece en la URL. Ese será el valor que deberás informar en la variable targetProcessDefinitionId.
  • Variable: targetProcessDefinitionId
  • Valor: ID de la automatización obtenido desde la URL.
execution.setVariableLocal("targetProcessDefinitionId", "ID_DE_LA_AUTOMATIZACION");

 

2. Pipeline

Esta variable permite escoger qué pipeline tendrá la instancia que se va a crear.

El pipeline determina el tablero y las etapas por las que podrá avanzar la nueva instancia.

¿Cómo encontrar el ID del pipeline en Wattwin?

Para localizar el ID del pipeline:

  1. Accede a Configuración > Tablero de Servicios.
  2. Selecciona el tablero o pipeline que quieres utilizar.
  3. Copia el identificador que aparece en la URL. Ese será el valor que deberás informar en la variable targetPipelineId.

  • Variable: targetPipelineId
  • Valor: ID del pipeline obtenido desde la URL.
execution.setVariableLocal("targetPipelineId", "ID_DEL_PIPELINE");

 

3. Solución

Esta variable permite escoger qué solución tendrá la nueva instancia.

La solución define parte del comportamiento y la configuración de la instancia, por lo que es importante seleccionar la que corresponda según el tipo de proceso que se quiera crear.

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

Para localizar el ID de la solución:

  1. Accede a Configuración > Soluciones.
  2. Selecciona la solución que quieres utilizar en la nueva instancia.
  3. Copia el identificador que aparece en la URL. Ese será el valor que deberás informar en la variable targetSolutionId.

  • Variable: targetSolutionId
  • Valor: ID de la solución obtenido desde la URL.
execution.setVariableLocal("targetSolutionId", "ID_DE_LA_SOLUCION");

Nota:
Si la solución tiene configurada una automatización y un pipeline por defecto, se pueden obviar las variables targetProcessDefinitionId y targetPipelineId.

 

4. Tipo de instancia

Esta variable permite escoger de qué tipo será la instancia que se va a crear.

Puedes crear una nueva instancia de tipo servicio o una nueva instancia de tipo oportunidad.

  • Variable: targetProcessType
  • Valor: service para crear un servicio.
  • Valor: sales para crear una oportunidad.
execution.setVariableLocal("targetProcessType", "service");

Importante:
El tipo de instancia debe ser coherente con la solución, automatización y pipeline seleccionados. Por ejemplo, si quieres crear un servicio, asegúrate de utilizar una solución y un pipeline compatibles con servicios.

 

5. Canal

Esta variable permite escoger qué canal tendrá la instancia que se va a crear.

¿Cómo encontrar el ID del canal en Wattwin?

Para localizar el ID del canal:

  1. Accede a Configuración > Canales.
  2. Selecciona el canal que quieres utilizar en la nueva instancia.
  3. Copia el identificador que aparece en la URL. Ese será el valor que deberás informar en la variable targetChannelId.

  • Variable: targetChannelId
  • Valor: ID del canal obtenido desde la URL.
execution.setVariableLocal("targetChannelId", "ID_DEL_CANAL");

 

6. Solicitante / Responsable / Responsable comercial / Responsable técnico

Estas variables permiten escoger qué usuarios quedarán asignados en la nueva instancia creada.

Puedes informar directamente el ID de un usuario concreto o utilizar políticas para relacionar usuarios de la instancia origen con la nueva instancia.

¿Cómo encontrar el ID de un usuario en Wattwin?

Para localizar el ID de un usuario:

  1. Accede a Usuarios.
  2. Selecciona el usuario que quieres asignar.
  3. Copia el identificador que aparece en la URL. Ese será el valor que deberás informar en la variable correspondiente.

Figura Variable Valor
Solicitante targetCreatedById ID del usuario obtenido desde la URL
Responsable targetOwnerId ID del usuario obtenido desde la URL
Responsable comercial targetCommercialOwnerId ID del usuario obtenido desde la URL
Responsable técnico targetTechnicalOwnerId ID del usuario obtenido desde la URL

La estructura del script sería similar a la siguiente:

execution.setVariableLocal("targetCreatedById", "ID_DEL_USUARIO");
execution.setVariableLocal("targetOwnerId", "ID_DEL_USUARIO");
execution.setVariableLocal("targetCommercialOwnerId", "ID_DEL_USUARIO");
execution.setVariableLocal("targetTechnicalOwnerId", "ID_DEL_USUARIO");

 

Asignación de usuarios según la instancia origen

Además de informar un usuario concreto, también puedes indicar que determinados usuarios de la nueva instancia se asignen en función de los usuarios de la instancia de origen.

Por ejemplo, podrías indicar que el solicitante de la nueva instancia sea el responsable de la instancia de origen:

  • Variable: createdBy
  • Valor: owner 
execution.setVariableLocal("createdBy", "owner");

También podrías indicar que el responsable de la nueva instancia sea el solicitante de la instancia de origen:

  • Variable: ownerPolicy
  • Valor: createdBy 
execution.setVariableLocal("ownerPolicy", "createdBy");

Nota:
Estas políticas son útiles cuando quieres reutilizar usuarios de la instancia origen sin tener que informar manualmente el ID de un usuario concreto.

7. Duplicar instalación y presupuesto

Esta variable permite duplicar la instalación y el presupuesto de la oportunidad origen en la nueva instancia creada.

De esta forma, la nueva instancia puede partir de una copia de la información técnica y económica ya existente.

  • Variable: orderPolicy
  • Valor: cloneDeep 
execution.setVariableLocal("orderPolicy", "cloneDeep");

Importante:
Utiliza esta opción únicamente cuando quieras que la nueva instancia conserve una copia completa de la instalación y el presupuesto de la oportunidad origen.

8. Variables extra

También es posible enviar otras variables de la oportunidad origen hacia la nueva instancia creada.

Esto permite trasladar información adicional que puede ser útil para clasificar, identificar o completar la nueva instancia.

Algunos de los campos que se pueden enviar son:

  • channelId
  • cups
  • facility
  • tags
  • priority

La estructura del script dependerá de la variable que quieras trasladar, pero seguirá el mismo formato general:

execution.setVariableLocal("cups", "VALOR_DEL_CUPS");
execution.setVariableLocal("priority", "VALOR_DE_LA_PRIORIDAD");

Nota:
Las variables extra deben utilizarse únicamente cuando el proceso BPM esté preparado para recibir y aplicar esa información en la nueva instancia.

 

Ejemplo de configuración completa

A continuación se muestra un ejemplo de configuración de una tarea automática de creación de una nueva instancia relacionada:

execution.setVariableLocal("targetProcessDefinitionId", "ID_DE_LA_AUTOMATIZACION");
execution.setVariableLocal("targetPipelineId", "ID_DEL_PIPELINE");
execution.setVariableLocal("targetSolutionId", "ID_DE_LA_SOLUCION");
execution.setVariableLocal("targetProcessType", "service");
execution.setVariableLocal("targetChannelId", "ID_DEL_CANAL");
execution.setVariableLocal("targetOwnerId", "ID_DEL_USUARIO");
execution.setVariableLocal("orderPolicy", "cloneDeep");

Con esta configuración, Wattwin creará una nueva instancia de tipo servicio, con la automatización, pipeline, solución, canal y responsable indicados. Además, duplicará la instalación y el presupuesto de la oportunidad origen.

 

Fichero BPM de ejemplo

En esta sección se puede adjuntar o mostrar un ejemplo de fichero BPM con una tarea automática de creación de una nueva instancia relacionada ya configurada (tienes el archivo para descargar al final del artículo).

Este fichero puede servir como referencia para revisar cómo deben informarse las variables 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 los valores de las variables corresponden con datos existentes y válidos dentro del dominio en el que se va a aplicar.

Footer-banner.png

Artículos relacionados