Varrer Dados CSV

Visão Geral

O objeto Varrer Dados CSV percorre um arquivo CSV linha a linha, permitindo executar ações para cada registro encontrado.

Ele é utilizado para processamento sequencial de dados, leitura controlada de grandes arquivos e execução de regras para cada linha do CSV.

---

Funcionamento

Ao ser executado, o objeto:

1. Abre o arquivo CSV informado.

2. Lê cada linha conforme o delimitador configurado.

3. Para cada linha:

   • Armazena os valores nas variáveis correspondentes.

   • Incrementa um contador de linhas.

   • Executa os componentes posicionados dentro do bloco.

Se o arquivo possuir cabeçalho e essa opção estiver marcada, a primeira linha será ignorada no processamento.

Quando usar

• Para processar registros um a um em arquivos CSV.

• Para executar validações ou integrações por linha.

• Para tratar grandes volumes de dados sem carregar tudo em memória.

• Para implementar laços baseados em arquivos.

Quando não usar

• Quando é necessário carregar todo o CSV em uma estrutura de tabela (use Ler Dados CSV).

• Para manipulação de arquivos que não sejam CSV.

• Quando não há necessidade de percorrer todas as linhas.

---

Funcionamento como bloco

O Varrer Dados CSV é um objeto do tipo bloco. Para cada linha lida, os componentes dentro do bloco são executados uma vez, até que todo o arquivo seja percorrido.

---

Configuração

CAMPO	DESCRITIVO
Título	Nome exibido no fluxo do robô.
Nome Identificador do Objeto	Identificador da variável que receberá os dados da linha atual.
Arquivo	Caminho do arquivo CSV a ser percorrido.
Delimitador	Caractere que separa as colunas do CSV.
Arquivo possui cabeçalho	Indica se a primeira linha contém os nomes das colunas.
Contador de Linhas	Variável que armazenará o número da linha atual.
Valor inicial do contador	Valor inicial do contador de linhas.
Incremento do contador	Valor de incremento a cada nova linha lida.

---

Exemplos

Exemplo simples

Objetivo: Percorrer todas as linhas de um CSV.

Configuração:

• Arquivo: C:\Roboteasy\arquivo_resultado.csv

• Delimitador: ;

• Arquivo possui cabeçalho: marcado

• Contador de Linhas: count

Fluxo:

1. Varrer Dados CSV

2. Dentro do bloco:

   • Processar dados da linha

   • Registrar informações

   • Executar validações

Exemplo aplicado

Cenário: Importar dados para um sistema.

Fluxo:

1. Varrer Dados CSV

2. Para cada linha:

   • Validar campos

   • Enviar dados para API

   • Registrar sucesso ou erro

Esse padrão permite processamento robusto e controlado.

---

Retornos

O objeto Varrer Dados CSV não retorna uma estrutura única. Ele disponibiliza os dados da linha atual durante cada iteração e atualiza o contador de linhas conforme configurado.

---

Erros comuns e como evitar

Delimitador incorreto Utilize o mesmo separador usado no arquivo CSV.

Cabeçalho tratado como dado Marque a opção Arquivo possui cabeçalho quando aplicável.

Arquivo muito grande sem controle Prefira esse objeto ao invés de carregar todo o CSV em memória.

---

Boas práticas

• Utilizar Varrer Dados CSV para arquivos grandes.

• Tratar exceções dentro do bloco com Try/Catch.

• Usar o contador para logs e rastreabilidade.

• Validar existência do arquivo antes da leitura.

• Nomear claramente as variáveis de linha e contador.

Robô Exemplo

6KB

Varrer Dados CSV - Robô Exemplo.roboteasy

Open