Executar a partir de botões (Actions)
Uma action conecta uma automação a um botão visível na interface. Quando o usuário clica no botão, a automação é executada.
Isso substitui e melhora o que antes era conhecido como "assistentes de criação" ou "automações instantâneas".
Como funciona?
- Na janela de Actions, clique em + para criar uma nova conexão.
- Selecione a automação que deseja executar (apenas automações standalone aparecem).
- Defina o label (texto visível do botão).
- Configure o mapeamento de parâmetros: de onde se obtém cada valor que a automação precisa nesse contexto.
Mapeamento de parâmetros
Assim como nos triggers, cada parâmetro da automação deve receber um valor. No contexto de uma action, os valores podem vir de:
- Objeto atual: a tarefa ou formulário onde o botão é exibido.
- Campos do objeto: nome, status, site, projeto, etc.
- Valor constante: um valor fixo.
Se algum parâmetro ficar sem atribuir, o sistema mostra um aviso.
Reutilização
Uma mesma automação pode ter múltiplas actions em diferentes templates. Por exemplo, uma automação que cria um workflow associado pode ter botões em:
- O template de tarefa de instalação
- O template de formulário de inspeção
- Qualquer outro template onde faça sentido oferecer essa ação
Cada action tem seu próprio label e mapeamento de parâmetros, adaptado ao contexto onde o botão é exibido.
Exemplos de uso
Criar elementos relacionados: Um botão em uma tarefa que cria um elemento de rede, dois sites e os relaciona entre si — tudo em um único clique.
Iniciar um workflow: Um botão em um formulário que cria um workflow selecionando projeto e template a partir das opções configuradas.
Gerar documentação: Um botão que cria um formulário pré-carregado com dados do site atual.
Diferença com os triggers
| Triggers | Actions | |
|---|---|---|
| Executa-se | Automaticamente diante de um evento | Manualmente quando o usuário clica |
| Visível para o usuário | Não (ocorre em segundo plano) | Sim (aparece como botão) |
| Label personalizado | Não se aplica | Sim, define-se o texto do botão |
| Contexto de parâmetros | Objeto que disparou o evento | Objeto onde o botão é exibido |