Módulo Loop For

• Definição

• Configuração do módulo

  • Loop For

• Exemplo

Definição

O módulo ferramental "Loop For", módulo padrão da plataforma para a utilização em qualquer fluxo, foi criado para suprir a necessidade de processamento de listas de informações. Ele é composto por duas operações, Begin e End, que marcam, respectivamente, o começo e o fim de uma repetição (loop), com base em um array que você deve fornecer no formato JSON.

A primeira operação (Begin) aceita como argumento apenas uma lista ou array e deriva as 3 declarações do FOR a partir dessa lista. Esse tipo de expressão também é conhecida como For Each em algumas linguagens, e pode ser representado da seguinte maneira:

for(loop_counter = 0; loop_counter < array.length ; loop_counter++){
    element = array[loop_counter]; 
	//bloco de código que será executado
} 

Para representar o loop_counter (contador do loop) e o element do código acima na plataforma, a operação Begin do módulo For inicializa e mantém dois parâmetros equivalentes, que poderão ser acessados por qualquer módulo conectado ao fluxo:

1. loopCounter: armazena a posição de execução do fluxo, iniciando do valor “0” para a primeira execução e incrementando-o a cada execução

2. element: armazena o elemento do array que está na posição de loopCounter, sendo uma forma conveniente de acessar o conteúdo de cada execução do loop

A operação Begin do módulo For somente executará o código dentro do segmento do fluxo localizado entre as operações For Begin e For End se o array passado como parâmetro for válido. Caso o array seja vazio (ou seja, somente “[]”), o bloco inteiro será ignorado e a execução seguirá para o próximo componente do fluxo depois do For End ou simplesmente encerrará a execução do fluxo (caso não haja mais operações a serem executadas).

Configuração do módulo "Loop For"

O módulo "Loop For" 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.

Loop For

Preencha os campos necessários do "Loop For", sendo que:

• Lista (Array): aqui você poderá arrastar tanto um parâmetro das operações anteriores como ou um parâmetro do fluxo, assim como informar um array manualmente ou utilizar uma operação SMOP (no ícone de + );
• Validar: valida o array, exibindo a lista completa que será tratada na área de Pré-visualização dos Dados.

Para finalizar a configuração do módulo, clique em "Salvar".

Exemplo

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