Ler Dados CSV

Visão Geral

O objeto Ler Dados CSV realiza a leitura de um arquivo CSV e carrega seu conteúdo em uma estrutura de tabela, permitindo que os dados sejam percorridos, filtrados e utilizados no fluxo do robô.

Ele é utilizado para importação de dados, processamento em lote e integração com planilhas e sistemas que exportam informações em formato CSV.

---

Funcionamento

Ao ser executado, o objeto:

1. Acessa o arquivo CSV informado.

2. Lê o conteúdo conforme a codificação e o delimitador configurados.

3. Interpreta a primeira linha como cabeçalho (se configurado).

4. Carrega os dados em memória como uma tabela estruturada.

Opcionalmente, é possível limitar a leitura a um intervalo específico de linhas, reduzindo o volume de dados carregados.

Quando usar

• Para importar dados de planilhas em formato CSV.

• Para processar grandes volumes de registros.

• Para validar e transformar dados externos.

• Para alimentar loops e regras de negócio a partir de arquivos.

Quando não usar

• Para leitura de arquivos não estruturados.

• Para arquivos que não estejam no formato CSV.

• Quando o volume de dados for incompatível com a memória disponível.

---

Configuração

CAMPO	DESCRITIVO
Título	Nome exibido no fluxo do robô.
Nome Identificador do Objeto	Identificador da tabela que armazenará os dados lidos.
Caminho do Arquivo	Caminho do arquivo CSV a ser lido.
Codificação	Codificação do arquivo (ex.: UTF-8).
Delimitador	Caractere que separa as colunas (ex.: ;, ,).
Arquivo possui cabeçalho	Indica se a primeira linha contém os nomes das colunas.
Ignorar primeira linha	Desconsidera a primeira linha durante a leitura.
Formatar Cabeçalho	Ajusta automaticamente os nomes das colunas.

Configurações Avançadas

Permitem ler apenas um trecho específico do arquivo:

OPÇÃO	DESCRITIVO
Nº linha Inicial / Final	Define intervalo numérico de linhas a serem lidas.
Conteúdo Inicial / Final	Define o início e fim com base em conteúdo textual.

A primeira linha sempre será considerada o cabeçalho quando essa opção estiver ativa.

---

Exemplos

Exemplo simples

Objetivo: Ler todo o conteúdo de um CSV.

Configuração:

• Caminho do Arquivo: C:\Roboteasy\arquivo_resultado.csv

• Codificação: UTF-8

• Delimitador: ;

• Arquivo possui cabeçalho: marcado

Resultado:

• Os dados serão carregados na tabela tabelaDadosCSV.

Exemplo aplicado

Cenário: Processar dados de um relatório.

Fluxo:

1. Ler Dados CSV

2. Para cada linha da tabela:

   • Validar campos

   • Executar regras de negócio

3. Gerar novo relatório ou atualizar sistema

---

Retornos

O objeto Ler Dados CSV retorna uma tabela de dados, onde cada linha representa um registro do CSV e cada coluna corresponde a um campo.

Esses dados podem ser utilizados em:

• Laços de repetição

• Validações

• Escrita em novos arquivos

• Integrações com sistemas

---

Erros comuns e como evitar

Delimitador incorreto Certifique-se de utilizar o mesmo separador usado no arquivo.

Codificação incompatível Utilize a codificação correta para evitar caracteres inválidos.

Arquivos muito grandes Use as Configurações Avançadas para limitar o intervalo de leitura e evitar consumo excessivo de memória.

Robô Exemplo

8KB

Ler Dados CSV - Robô Exemplo.roboteasy

Open