Varrer Lista Json

Permite Varrer uma lista de Json

Visão Geral

O objeto Varrer Lista Json tem como objetivo criar um laço de repetição (loop) para iterar sequencialmente sobre todos os elementos presentes em uma lista JSON (Array) que já foi previamente declarada ou obtida no fluxo da automação.

---

Funcionamento

O objeto percorre a lista JSON selecionada e, para cada item encontrado, executa os comandos inseridos dentro de sua estrutura de bloco. Durante a execução, ele atribui automaticamente os dados do item atual a uma Variável iteradora e controla o número do ciclo atual através de uma variável de Contador. O usuário pode configurar o valor inicial e o passo (incremento) desse contador, bem como optar por ignorar o primeiro registro da lista.

Quando usar

• Quando for necessário processar múltiplos registros em lote de forma sequencial (ex: ler uma lista de clientes retornada por uma API e cadastrá-los em um sistema um a um).

• Para aplicar regras de negócio, extrair ou manipular dados específicos iterando sobre os elementos individuais de um Array JSON.

Quando não usar

• Quando a intenção for manipular ou acessar um único item sabendo previamente o seu índice na lista (o acesso direto é mais performático).

• Quando a variável alvo for um objeto JSON simples ({}) e não uma estrutura de lista/array ([]).

---

Configuração

CAMPO	DESCRITIVO
Título	É o nome do objeto e não precisa ser alterado, a menos que você queira identificá-lo para facilitar a leitura do fluxo, por exemplo: "Varrer Lista Json - Faturas".
Lista Json	A variável do tipo lista JSON (Array) que será percorrida pelo laço de repetição.
Variável iteradora	O nome da variável que armazenará os dados do item correspondente à iteração atual do laço. É essa variável que deve ser referenciada nos objetos internos do bloco para manipular o dado do ciclo.
Contador	O nome da variável de controle numérico que armazenará o índice ou o número da iteração atual do laço.
Valor inicial do contador	O número pelo qual a variável Contador começará a contagem na primeira iteração (geralmente 0 ou 1).
Incremento do contador	O valor numérico que será somado ao Contador a cada novo ciclo finalizado (geralmente 1).
Ignorar primeira linha	Se marcado, o laço de repetição pulará o processamento do primeiro elemento (índice 0) da lista JSON.

---

Estrutura de Bloco

O objeto atua visualmente como um contêiner no fluxo de trabalho. Todos os objetos posicionados dentro da área deste bloco serão repetidos no laço.

O cabeçalho do bloco exibe a mensagem instrucional "Varre a lista , acessa-se o item iterador através da variável...", indicando claramente qual é a variável (ex: jsonListRepeat33440) que contém o dado do ciclo.

Além disso, o bloco suporta a inserção de objetos de controle de fluxo nativos em seu interior:

• Próximo Laço: Avança imediatamente para a próxima iteração da lista JSON, ignorando os objetos abaixo dele no ciclo atual.

• Sair do Laço: Interrompe definitivamente a repetição da lista JSON, continuando a automação fora do bloco.

---

Exemplos

Exemplo simples

Varrer uma lista JSON (listaEmails) contendo endereços de e-mail. Na configuração, define-se a "Variável iteradora" como emailAtual e o "Contador" como i. Dentro do bloco, adiciona-se o objeto "Enviar E-mail", utilizando a variável emailAtual no campo de destinatário. O robô enviará um e-mail para cada item da lista.

Exemplo aplicado

Um robô consome um endpoint que retorna um Array JSON com os dados de 100 colaboradores recém-contratados. Utilizando o objeto Varrer Lista Json, o robô itera sobre essa lista configurando o "Valor inicial do contador" como 1. A cada ciclo, ele lê as informações do colaborador a partir da "Variável iteradora", abre o sistema de RH da empresa e realiza o cadastro. O robô utiliza a variável "Contador" para registrar em um log de execução qual número de registro (ex: "Cadastrando funcionário 15 de 100") está sendo processado naquele momento.

---

Retornos

---

Erros comuns e como evitar

• Não utilizar a variável iteradora no bloco: Configurar o laço, mas referenciar a lista completa (Lista Json) nos objetos dentro do bloco em vez da Variável iteradora. Isso faz com que o robô tente processar o array inteiro a cada ciclo em vez do item individual.

• Lista vazia ou incompatível: Apontar no campo "Lista Json" uma variável que não foi declarada, que está nula ou que não contém a estrutura de um Array, o que ocasionará erro de execução ao tentar iniciar a varredura.

---

Boas práticas

• Utilize nomes de variáveis intuitivos para o Contador (ex: index ou contadorLinha) e para a Variável iteradora (ex: clienteAtual), facilitando a manutenção e compreensão do robô por outros desenvolvedores.

• Se a lista JSON contiver um cabeçalho estrutural inútil no primeiro registro (comum em conversões brutas de CSV para JSON), utilize a opção Ignorar primeira linha para poupar a criação de lógicas condicionais ("Se") desnecessárias no primeiro ciclo.