Gatilhos

Tipos de gatilho, propriedade de entrada e comportamento de entry point em processos do Maestro.

O que é

Um gatilho define como um processo começa. Cada processo requer pelo menos um gatilho, e os novos processos incluem um Gatilho manual por padrão.

Tipos de gatilhos

O fluxo é compatível com os seguintes tipos de gatilho:

Tipo	Description	Use case
Manual Trigger	Inicia o processo sob demanda quando você seleciona Depurar	Teste, depuração e execução ad-hoc
Gatilho programado	Executa o processo em um agendamento recorrente, definido como um intervalo ou uma expressão CRON	Sincronizações de dados periódicas, relatórios diários, tarefas de limpeza recorrentes
Gatilhos baseados em conector	Inicia o processo quando ocorre um evento em um conector do Integration Service (por exemplo, novo e-mail recebido ou formulário enviado)	Automação orientada por eventos que reage a sistemas externos em tempo real

Posicionamento do gatilho

Os gatilhos são adicionados a partir da paleta de nós na barra de ferramentas inferior. Você não pode adicionar um gatilho do identificador de saída de um nó.

Depois que um gatilho é adicionado, ele aparece na tela como um nó circular. Seu identificador de saída se conecta ao primeiro nó no processo para concluir o ponto de entrada.

Observação:

Cada gatilho deve conectar-se a pelo menos um nó downstream. O fluxo exibe um aviso se um gatilho não tiver conexão de saída.

Entradas do disparo

As variáveis de entrada são de propriedade de seu gatilho, não do processo. Cada gatilho define seu próprio conjunto de entradas, e essas entradas são preenchidas apenas quando esse gatilho específico é acionado.

Para fazer referência à entrada de um gatilho em um nó downstream, use a sintaxe:

$vars.<triggerName>.output.<inputName>

Por exemplo, se um Disparo manual chamado manualTrigger1 definir uma entrada chamada userId:

$vars.manualTrigger1.output.userId

As entradas de gatilho são configuradas a partir do painel Variáveis . Cada entrada pertence ao gatilho que a possui e tem seu próprio nome e tipo.

Após uma entrada ser definida, ela aparece nesse gatilho no painel Variáveis e é acessível posteriormente $vars.<triggerName>.output.<inputName>.

Consulte Variáveis e fluxo de dados para saber mais sobre a sintaxe de expressões e como os dados se movem entre os nós.

Vários gatilhos

Um processo pode ter mais de um gatilho. Cada gatilho atua como um ponto de entrada separado. Quando qualquer gatilho é acionado, ele inicia uma execução independente do processo.

Isso é útil quando a mesma lógica precisa ser executada em resposta a diferentes eventos. Por exemplo, um processo pode ter um Gatilho agendado para execuções de lote diárias e um gatilho baseado em conector que reage a solicitações de entrada durante o dia.

Cada gatilho possui suas próprias entradas. Os nós posteriores fazem referência ao gatilho específico que iniciou a execução atual. Se seu processo tiver um Gatilho manual chamado manualTrigger1 e um Gatilho agendado chamado scheduledTrigger1, cada um tem seu próprio namespace $vars.<triggerName>.output .

Páginas relacionadas

• Variáveis e fluxo de dados — sintaxe de expressão, saída de nó, referências de entrada de gatilho
• A tela — paleta de nós, painel de propriedades, barra de ferramentas inferior
• Tratamento de erros — tratamento de falhas em nós a jusante de um gatilho