Conectar a eventos (Disparadores)

Conectar a eventos (Disparadores)

Um disparador conecta uma automatização a um evento do sistema. Quando esse evento ocorre, a automatização é executada automaticamente.
Por exemplo: quando um formulário é aprovado, quando uma tarefa muda de estado, ou quando um workflow é criado.


Como funciona?

    Na janela de Disparadores, clique em + para criar uma nova conexão.
    Selecione a automatização que deseja executar (apenas automatizações standalone publicadas aparecem).
    Selecione o evento que vai acioná-la.
    Configure o mapeamento de parâmetros: de onde vem cada valor que a automatização precisa.


Mapeamento de parâmetros

Cada parâmetro da automatização deve receber um valor. No contexto de um disparador, os valores podem vir de:
  • Objeto que acionou o evento: por exemplo, se o evento é "tarefa concluída", você pode mapear o parâmetro tarefa ao objeto que acionou o disparador.
  • Campos do objeto: você pode acessar campos específicos como nome, estado, site associado, etc.
  • Valor constante: um valor fixo que será sempre o mesmo.
  • Parâmetros de entrada do disparador: dados adicionais disponíveis no contexto do evento.
Se algum parâmetro ficar sem atribuição, o sistema exibirá um aviso. Todos os parâmetros obrigatórios devem ter um valor configurado.


Reutilização

Uma mesma automatização pode ter múltiplos disparadores. Por exemplo, você pode conectar a mesma automatização de "notificar por e-mail o responsável" a:
  • O evento "tarefa criada" no modelo de manutenção corretiva
  • O evento "formulário aprovado" no modelo de inspeção
  • Um evento global de mudança de estado
Cada disparador tem seu próprio mapeamento de parâmetros, adaptado ao contexto do evento.


Eventos disponíveis

Os disparadores podem ser configurados para diferentes tipos de eventos:
Mudanças de estado
Atribuições em atividades
Criação de objetos
formulários
uma equipe (perfil) foi atribuída
formulários
tarefas
um usuário foi atribuído
tarefas
workflows
um fornecedor foi atribuído
workflows
cotações
um usuário de fornecedor foi atribuído
campos personalizados
marcos
formulários de engenharia


Entidades relacionadas

Os disparadores podem ser associados a eventos de:
  • Formulários
  • Tarefas
  • Workflows
  • Sites
  • Elementos de Rede
  • Clientes
  • Solicitações de acesso ao site
  • Marcos
  • Campos personalizados
  • Cotações
  • Formulários de engenharia


Gestão de disparadores

Na janela de Disparadores você pode:
  • Ver todas as conexões entre automatizações e eventos
  • Ver o estado de cada conexão (ativa/inativa, automatização publicada, parâmetros configurados)
  • Ativar ou desativar disparadores individualmente ou em lote
  • Excluir conexões que não são mais necessárias


Exemplo passo a passo

Você quer que, cada vez que um formulário de manutenção corretiva seja aprovado, seja criado automaticamente um elemento de rede e um novo formulário associado.
    Crie a automatização com os passos: criar elemento de rede → criar formulário → associá-los.
    Defina os parâmetros: a automatização precisa receber o formulário aprovado como parâmetro.
    Crie o disparador: evento "formulário aprovado" no modelo de manutenção corretiva.
    Mapeie o parâmetro: o parâmetro formulário é mapeado ao objeto que acionou o evento.
    Ative o disparador e publique a automatização.
A partir desse momento, cada aprovação de formulário nesse modelo executará o fluxo completo.


Modos de disparador disponíveis

Descrição
Acionado automaticamente quando um evento ocorre
Executado manualmente a partir de uma tarefa
Executado manualmente a partir de um formulário
Acionado por outra automatização
Acionado por uma chamada API externa
Automatização independente executável via API

Disparadores de aprovação

Os disparadores podem ser configurados para executar em eventos de aprovação (transições de etapas e grupos de aprovação). A integração existe com o fluxo de aprovação do Sytex.
Nota: Os disparadores de aprovação não são um tipo separado, mas sim configurados por meio dos eventos do sistema de aprovação no disparador automático.