Conectar a eventos (Triggers)
Un trigger conecta una automatización a un evento del sistema. Cuando ese evento ocurre, la automatización se ejecuta automáticamente.
Por ejemplo: cuando un formulario se aprueba, cuando una tarea cambia de estado, o cuando se crea un workflow.
¿Cómo funciona?
- Desde la ventana de Triggers, hacé clic en + para crear una nueva conexión.
- Seleccioná la automatización que querés ejecutar (solo aparecen automatizaciones standalone).
- Seleccioná el evento que va a dispararla.
- Configurá el mapeo de parámetros: de dónde se obtiene cada valor que la automatización necesita.
Mapeo de parámetros
Cada parámetro de la automatización debe recibir un valor. En el contexto de un trigger, los valores pueden venir de:
- Objeto que disparó el evento: por ejemplo, si el evento es "tarea completada", podés mapear el parámetro
tareaal objeto que disparó el trigger. - Campos del objeto: podés acceder a campos específicos como nombre, estado, sitio asociado, etc.
- Valor constante: un valor fijo que siempre será el mismo.
- Parámetros de entrada del trigger: datos adicionales disponibles en el contexto del evento.
Si algún parámetro queda sin asignar, el sistema muestra una advertencia. Todos los parámetros requeridos deben tener un valor configurado.
Reutilización
Una misma automatización puede tener múltiples triggers. Por ejemplo, podés conectar la misma automatización de "notificar por email al responsable" a:
- El evento "tarea creada" en la plantilla de mantenimiento correctivo
- El evento "formulario aprobado" en la plantilla de inspección
- Un evento global de cambio de estado
Cada trigger tiene su propio mapeo de parámetros, adaptado al contexto del evento.
Eventos disponibles
Los triggers se pueden configurar para distintos tipos de entidades y eventos:
| Cambios de estado | Asignaciones en actividades | Creación de objetos |
|---|---|---|
| formularios | se asignó un equipo (rol) | formularios |
| tareas | se asignó un usuario | tareas |
| workflows | se asignó un proveedor (contratista) | workflows |
| cotizaciones | se asignó un usuario de proveedor | |
| campos personalizados | ||
| hitos | ||
| formularios de ingeniería |
Entidades relacionadas
Los triggers pueden asociarse a eventos de:
- Formularios
- Tareas
- Workflows
- Sitios
- Elementos de Red
- Clientes
- Solicitudes de acceso a sitio
- Hitos
- Campos personalizados
Gestión de triggers
Desde la ventana de Triggers podés:
- Ver todas las conexiones entre automatizaciones y eventos
- Ver el estado de cada conexión (activa/inactiva, automatización publicada, parámetros configurados)
- Activar o desactivar triggers individualmente o en lote
- Eliminar conexiones que ya no se necesiten
Ejemplo paso a paso
Querés que cada vez que se apruebe un formulario de mantenimiento correctivo, se cree automáticamente un elemento de red y un nuevo formulario asociado.
- Creá la automatización con los pasos: crear elemento de red → crear formulario → asociarlos.
- Definí los parámetros: la automatización necesita recibir el formulario aprobado como parámetro.
- Creá el trigger: evento "formulario aprobado" en la plantilla de mantenimiento correctivo.
- Mapeá el parámetro: el parámetro
formulariose mapea al objeto que disparó el evento. - Activá el trigger y publicá la automatización.
A partir de ese momento, cada aprobación de formulario en esa plantilla ejecutará el flujo completo.