Fluxo de controle

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

O que é

O fluxo de controle determina como seu processo decide o que executar e em qual ordem. Todo processo começa como uma linha reta de nós, mas o trabalho real requer decisões, repetição e reunificação. O Fluxo fornece quatro nós de fluxo de controle — Decision, Switch, Loop e Merge — que permitem 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 de acordo com uma condição.

Decision — dois caminhos

O nó Decision avalia uma única expressão JavaScript e roteia para uma de duas saídas: verdadeira ou falsa. Ela se encaixa em sim/não, aprovação/falha ou qualquer verificação binária.

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

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

Consulte a Referência do nó Decision para obter a configuração completa.

Switch — três ou mais caminhos

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

Switch ajusta o roteamento por categoria, status ou qualquer valor com mais de dois resultados possíveis.

Consulte a referência do nó Switch para obter 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 situações diferentes.

Loop (Para cada)

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

• currentItem — o item para a iteração atual
• currentIndex — um índice com base zero que rastreia qual iteração está sendo executada
• collection — o array completo sendo iterado

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

A expressão Coleção de um nó do Loop aponta para o array que ele itera, como $vars.script1.output. A opção Paralelo 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 Sucesso é executado após a conclusão de todas as iterações.

Mesclagem de ramificações

Após uma Decision ou Switch dividir seu processo, use um nó Merge quando você precisar executar nós subsequentes, independentemente de qual ramificação você adotou.

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

Observação:

O Merge aguarda a ramificação que realmente foi executada — ele não aguarda todos os caminhos 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ó Solicitação HTTP chama uma API de tíquete e retorna um array de objetos de tíquete.
2. Um nó Loop itera sobre $vars.httpRequest1.output.body.tickets.
3. Dentro do corpo do loop, um nó Decision avalia $vars.loop1.currentItem.priority === "high". A ramificação verdadeira se conecta a um nó Enviar E-mail que alerta a equipe de plantão; a ramificação falsa se conecta a um nó Script que registra o tíquete para revisão posterior.
4. Um nó Merge conecta as duas ramificações para que a iteração seja concluída de forma limpa, independentemente de qual caminho foi executado.
5. O Merge se conecta de volta à entrada loopBack do Loop, e o identificador Sucesso do Loop continua para o restante do processo.

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

Páginas relacionadas

• Nó Decision — 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 as saídas de nós
• Tratamento de erros — tratamento de falhas, que é diferente da ramificação condicional
• A tela — navegação e criação de processos visualmente