Voltar ao centro de ajuda

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?

  1. Na janela de Actions, clique em + para criar uma nova conexão.
  2. Selecione a automação que deseja executar (apenas automações standalone aparecem).
  3. Defina o label (texto visível do botão).
  4. 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

TriggersActions
Executa-seAutomaticamente diante de um eventoManualmente quando o usuário clica
Visível para o usuárioNão (ocorre em segundo plano)Sim (aparece como botão)
Label personalizadoNão se aplicaSim, define-se o texto do botão
Contexto de parâmetrosObjeto que disparou o eventoObjeto onde o botão é exibido