Varrer Dados Excel

Visão Geral

O objeto Varrer Dados Excel permite percorrer linha a linha uma tabela ou lista de dados obtida a partir do Excel, executando um conjunto de ações para cada registro.

Ele funciona como um laço de repetição (foreach) sobre os dados lidos, sendo essencial para processamentos em massa, validações, transformações e integrações.

---

Funcionamento

Ao ser executado, o objeto:

1. Recebe uma lista ou tabela (normalmente retornada por Ler Dados Excel).

2. Cria uma variável de iteração que representa a linha atual.

3. Inicializa um contador.

4. Para cada item da lista:

   • Atualiza a variável de iteração.

   • Executa os componentes internos do bloco.

   • Incrementa o contador.

5. Finaliza quando todos os registros forem processados.

Opcionalmente, o processamento pode ocorrer em paralelo.

Quando usar

• Para percorrer linhas de planilhas.

• Para validar registros um a um.

• Para integrar dados do Excel com sistemas, APIs ou arquivos.

• Para aplicar regras de negócio em massa.

Quando não usar

• Quando for necessário acessar apenas uma célula específica.

• Para leitura simples sem processamento por linha.

---

Configuração

CAMPO	DESCRITIVO
Nome da variável de iteração	Variável que representará a linha atual (ex.: item).
Selecionar lista ou tabela de dados	Lista retornada por Ler Dados Excel.
Nome identificador do contador	Variável que armazenará o índice da iteração.
Valor inicial do contador	Valor inicial do contador.
Incremento do contador	Valor somado a cada iteração.
Executar em paralelo	Executa as iterações simultaneamente.
Ignorar primeira linha	Ignora o cabeçalho da tabela.

---

Estrutura de Bloco

Este é um objeto do tipo bloco. Tudo o que estiver dentro dele será executado para cada linha da planilha.

---

Exemplos

Exemplo simples

Cenário: Ler um CSV e exibir cada linha.

Fluxo:

1. Ler Dados Excel

2. Varrer Dados Excel

   • Variável de iteração: item

   • Dentro do bloco:

     • Mensagem Log: item["Nome"]

Exemplo aplicado

Cenário: Importar dados para um sistema.

Fluxo:

1. Abrir Excel

2. Ler Dados Excel

3. Varrer Dados Excel

4. Dentro do bloco:

   • Validar campos

   • Enviar dados via API

   • Registrar sucesso ou erro

---

Retornos

O objeto Varrer Dados Excel não retorna valores diretamente. Os dados são acessados pela variável de iteração configurada.

---

Erros comuns e como evitar

Lista não informada Certifique-se de usar o retorno de Ler Dados Excel.

Variável inexistente no bloco Utilize corretamente o nome configurado em Nome da variável de iteração.

Uso incorreto de paralelismo Evite executar em paralelo quando houver escrita concorrente em arquivos ou sistemas.

---

Boas práticas

• Usar nomes claros para a variável de iteração (linha, registro, item).

• Ignorar cabeçalho quando o CSV possuir colunas nomeadas.

• Evitar lógica pesada dentro do bloco se estiver em modo paralelo.

• Utilizar contador para controle e logs.

---

Robô Exemplo

18KB

Varrer Dados Excel - Robô Exemplo.roboteasy

Open