Módulo Loop Do While

• Definição

• Configuração do módulo

  • Crie suas condicionais

    • Parâmetro

  • Exemplo

Definição

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:

var loop_count = -1;
do 
{
    loop_count ++;
	//bloco de código que será executado
}while(condition);

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 FOR, 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.

Configuração do módulo Loop Do While

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.

Saiba sobre o Cabeçalho do Módulo aqui.

Crie suas condicionais

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;

• 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 SMOP (no ícone de +);
• Condições: comparações entre dois valores (igual, diferente de, maior que, menor que, etc);

• 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 SMOP (no ícone de +);
• 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).

Exemplo de configuração

Parâmetro

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".

Exemplo

O módulo "Loop Do While" requer que um outro módulo esteja conectado a ele. Observe o exemplo: