Fluxo de controle

Nós de fluxo de controle que ramificam (Decisão, Alternar), iteram (Loop) e mesclam caminhos para gerenciar a ordem de execução do processo.

O que é

O fluxo de controle determina como seu processo decide o que executar e em qual ordem. Cada processo começa como uma linha direta de nós, mas o trabalho real requer decisões, repetição e reunificação. Flow fornece quatro nós de fluxo de controle — Decision, Switch, Loop e Merge — que permitem que você ramificar, iterar e convergir sem sair da tela.

Ramificação

A ramificação divide um processo em caminhos separados para que diferentes nós sejam executados dependendo de uma condição.

Decisão — dois caminhos

O nó Decisão avalia uma única expressão do JavaScript e roteia para uma das duas saídas: verdadeiro ou falso. É compatível com sim/não, aprovado/falha ou qualquer verificação binária.

$vars.httpRequest1.output.statusCode === 200

A expressão acima envia respostas bem-sucedidas na ramificação verdadeira e todo o resto na ramificação falsa.

Consulte a referência do nó de decisão para obter a configuração completa.

Switch — três ou mais caminhos

O nó Switch avalia uma lista ordenada de expressões de casos e aceita a primeira correspondência. Adicione até dez casos mais uma ramificação padrão opcional para qualquer coisa que não corresponda.

A alternância ajusta o roteamento por categoria, status ou qualquer valor com mais de dois resultados possíveis.

Consulte a referência do nó Switch para ver a configuração completa.

Loops

Os loops repetem uma sequência de nós várias vezes. O fluxo oferece dois nós de loop para diferentes situações.

Loop (para cada)

O nó Loop itera sobre uma coleção (um array) e executa seu corpo uma vez por item. Ela expõe três variáveis dentro do corpo do loop:

• currentItem — o item para a iteração atual
• currentIndex um rastreamento de índice baseado em zero que a iteração está sendo executada
• collection a matriz completa que está sendo iterada

Após a conclusão de todas as iterações, o Loop produz uma matriz output que agrega os resultados de cada iteração. A execução continua a partir do identificador de sucesso .

A expressão Coleção de um nó Loop aponta para a matriz sobre a qual ela itera, $vars.script1.output. A opção Paralela executa todas as iterações ao mesmo tempo em vez de sequencialmente. Os nós conectados ao identificador de saída do loop formam o corpo do loop, e o nó conectado ao identificador de sucesso é executado após a conclusão de todas as iterações.

Mesclando ramificações

Após uma Decisão ou Alterância dividir seu processo, use um nó Mesclar quando os nós subsequentes precisarem ser executados, independentemente de qual ramificação foi adotada.

O nó Merge aceita várias bordas de entrada em seu único identificador de entrada e produz uma saída. O último nó de cada ramificação conecta-se à Mesclagem, e o processo continua a partir do identificador de saída de Mesclagem.

Observação:

Mesclar espera pela ramificação que realmente foi executada — ela não espera por todas as bordas de entrada. Apenas a ramificação que recebeu dados durante a execução atual passa.

Exemplo prático

Considere um processo que busca uma lista de tíquetes de suporte, faz loop em cada um deles e roteia tíquetes de alta prioridade de forma diferente do resto.

O processo conecta cinco nós:

1. Um nó HTTP Request chama uma API de tíquete e retorna uma matriz de objetos de tíquete.
2. Um nó Loop itera sobre $vars.httpRequest1.output.body.tickets.
3. Dentro do corpo do loop, um nó de Decisão avalia $vars.loop1.currentItem.priority === "high". A ramificação verdadeira se conecta a um nó Enviar e-mail que alerta a equipe no local; a ramificação false conecta-se a um nó de script que registra o ticket para revisão posterior.
4. Um nó Merge conecta ambas as ramificações para que a iteração seja concluída limpa, independentemente de qual caminho executou.
5. A mesclagem conecta-se de volta à entrada loopBack do Loop, e o identificador de sucesso do Loop continua para o restante do processo.

Esse padrão — busca, loop, ramificação, mesclagem — abrange uma grande parte dos cenários de automação do mundo real.

Páginas relacionadas

• Nó de decisão — referência de configuração completa para ramificação de dois caminhos
• Nó Switch — referência de configuração completa para ramificação de vários caminhos
• Variáveis e fluxo de dados — como funcionam as expressões $vars e saídas de nó
• Tratamento de erros — tratamento de falhas, que é distinto da ramificação condicional
• A tela — navegação e criação de processos visualmente