Varrer Lista

Visão Geral

O objeto Varrer Lista é usado para percorrer todos os itens de uma lista e executar um conjunto de ações para cada item. Durante a execução, o robô atualiza uma variável para representar o item atual do loop, além de atualizar um contador. Este objeto facilita fluxos de automação que precisam agir de forma sequencial sobre cada elemento de uma lista (ex.: resultados de busca, linhas de tabela, elementos coletados, etc.).

Funcionamento

O robô começa a varrer os itens da lista selecionada, um por vez. Para cada item:

O objeto atualiza a variável do item atual com o valor do elemento sendo percorrido.
O contador é atualizado conforme as configurações.
Em cada iteração você pode adicionar outras ações para processar o item atual.

Ao terminar a lista, a execução segue normalmente para os próximos passos do robô.

Quando usar

Quando você precisa processar cada item de uma lista (ex.: clicar em cada resultado, salvar dados de cada linha, verificar cada arquivo retornado em pesquisa).
Quando é necessário acumular um resultado ou executar ações repetitivas sobre uma coleção de itens.
Quando quer controlar a iteração através de um contador personalizado.

Quando não usar

Quando a lista está vazia ou não foi inicializada, o objeto não irá executar nenhum processamento.
Quando não há necessidade de percorrer itens sequencialmente.

Configuração

CAMPO

DESCRITIVO

Título

Nome que identifica o bloco no fluxo.

Selecionar Lista

Lista que será percorrida (ex.: variáveis de lista retornadas por objetos anteriores).

Filtro de Lista

(Opcional) Permite aplicar um filtro para varrer somente itens que atendam a uma condição específica.

Nome da Variável do Item Atual

Variável onde será armazenado o item que está sendo processado na iteração atual.

Ignorar o primeiro item

Se marcado, inicia a varredura a partir do segundo item da lista.

Varredura Paralela

Se marcado, permite varrer itens em paralelo (concorrência) — dependendo de configurações do robô.

Contador

Variável numérica para controlar a contagem da iteração.

Valor inicial do contador

Valor inicial que o contador deve assumir ao começar a varredura.

Incremento do contador

Valor que será adicionado ao contador a cada iteração.

Estrutura de Bloco

Retornos

Este objeto não retorna diretamente um valor externo, mas atualiza:

A variável de item atual a cada iteração.
A variável do contador conforme configurado.

Essas variáveis podem ser utilizadas nos objetos filhos do laço.

Erros comuns e como evitar

Lista não selecionada ou vazia: → Sempre assegure que a lista foi populada por um objeto anterior antes de varrer.
Nome da variável do item atual não definido: → Defina sempre a variável para evitar erros no processamento interno.

Boas práticas

Nomeie variáveis de item atual e contador de forma clara (ex.: itemArquivo, indexUser) para facilitar a manutenção do fluxo.
Utilize filtros de lista para reduzir o volume de itens quando aplicável.
Quando possível, trate exceções dentro do laço para não interromper toda a varredura.