Módulo Loop Do While
Last updated
Last updated
O módulo ferramental "Loop Do While", módulo padrão da plataforma para a utilização em qualquer fluxo, foi criado para processar dados externos relacionados à quantidade de registros, sobre os quais não temos informação a priori. Ele é útil por conta da necessidade de termos uma ou mais interações para consumir todos os dados em um fluxo, um processo que também é conhecido como leitura paginada.
O módulo "Loop Do While" é composto por duas operações, DO e WHILE, que marcam, respectivamente, o começo e o fim de uma repetição (loop).
A estrutura desse tipo de loop pode ser representada da seguinte maneira:
Observe que o DO é inicializado com valor de loop_count = -1, mas a primeira instrução a ser executada é seu incremento para “0”. Isso mantém a consistência com o , no qual a primeira execução do loop também tem o valor “0”. Além disso, assim como no FOR, a variável loop_count também contém, na saída do loop, o valor da quantidade de execuções menos um.
Para representar o loop_count (contador do loop), a operação DO do módulo Do While inicializa e mantém um parâmetro equivalente, que poderá ser acessado por qualquer módulo conectado ao fluxo, denominado loopCount. Este parâmetro armazena a posição de execução do fluxo, iniciando do valor “0” para a primeira execução, incrementando-o a cada execução.
O módulo "Loop Do While" aparece na opção Ferramentas da edição de um fluxo. Após clicar para adicioná-lo, o modal de configuração será exibido.
Na área de "Crie sua condicional", há os seguintes campos e opções:
Satisfazer todas: se deseja que todas as condições configuradas sejam seguidas;
Satisfazer qualquer uma: quando é indiferente seguir todas as condições configuradas;
Condições: comparações entre dois valores (igual, diferente de, maior que, menor que, etc);
Adicionar condição: clique para adicionar mais uma condição;
Validar: clique para validar as condições
Resultado: informa se a condição informada é verdadeira ou falsa (True/False).
O parâmetro loopCount da operação DO está sempre disponível para quaisquer módulos dentro do loop e também após a execução do loop, aparecendo no lado esquerdo do modal de configuração de cada operação do fluxo, desde que as operações estejam todas conectadas pelas linhas do fluxo.
Após a finalização do loop, o parâmetro loopCount conterá o total de execuções menos 1 (uma vez que a variável começa em 0).
Para finalizar a configuração do módulo, clique em "Salvar".
O módulo "Loop Do While" requer que um outro módulo esteja conectado a ele. Observe o exemplo:
.
Variável 1: digite ou arraste um parâmetro de outro componente do fluxo para informar uma variável para comparação ou utilize uma (no ícone de +);
Variável 2: digite ou arraste um parâmetro de outro componente do fluxo para informar outra variável para comparação ou utilize uma (no ícone de +);
