Ler Dados Excel

Visão Geral

O objeto Ler Dados Excel permite extrair dados de uma planilha do Microsoft Excel, podendo ler:

• Uma célula específica (retornando um valor simples), ou

• Um intervalo de células (Range) (retornando uma lista ou tabela de dados).

Ele é utilizado para integrar planilhas ao fluxo do robô, possibilitando validações, loops, cálculos e envio de informações para outros sistemas.

---

Funcionamento

Ao ser executado, o objeto se comporta de acordo com a configuração:

1. Leitura de célula única

Quando o Range não é selecionado e uma Célula é informada:

• O valor da célula é lido.

• O retorno é um Texto.

• O conteúdo é armazenado diretamente na variável do objeto.

2. Leitura de intervalo (Range)

Quando a opção Selecionar Range está habilitada:

• Um intervalo de colunas e linhas é definido.

• Cada célula do intervalo é lida.

• O retorno pode ser:

  • Lista

  • Tabela

• Os dados ficam disponíveis para varredura, filtros e estruturas de repetição.

Quando usar

• Para ler totais, status e indicadores (modo célula).

• Para importar tabelas inteiras (modo range).

• Para percorrer registros de planilhas.

• Para validar dados antes de executar decisões.

• Para integrar Excel com APIs, banco de dados e sistemas.

Quando não usar

• Para arquivos CSV (use os objetos de CSV).

---

Configuração

Campos gerais

CAMPO	DESCRITIVO
Nome Identificador do Objeto	Variável que receberá o resultado da leitura.
Selecionar objeto do tipo Excel	Instância do Excel aberta.
Usar célula selecionada	Lê a célula atualmente selecionada no Excel.

---

Modo 1 – Leitura de Célula

CAMPO	DESCRITIVO
Célula	Endereço da célula a ser lida (ex.: A1, C6).

Comportamento:

• Retorno do tipo Texto.

• Ideal para valores únicos.

---

Modo 2 – Leitura por Range

CAMPO	DESCRITIVO
Selecionar Range	Habilita leitura de intervalo.
Coluna Inicial / Final	Define o intervalo de colunas.
Linha Inicial / Final	Define o intervalo de linhas.
Comportamento com Linhas sem Conteúdo	Ignorar ou considerar linhas vazias.
Tipo de Retorno	Lista ou Tabela.
Range possui cabeçalho	Indica se a primeira linha é cabeçalho.
Incluir cabeçalho	Inclui o cabeçalho no retorno.

---

Exemplos

Exemplo 1 – Ler uma célula

Objetivo: Ler o total da célula F10.

Configuração:

• Célula: F10

• Variável: totalVenda

Resultado:

• O valor será retornado como texto em totalVenda.

Exemplo 2 – Ler uma tabela

Objetivo: Ler dados das colunas A até F, linhas 1 até 100.

Configuração:

• Selecionar Range: habilitado

• Coluna Inicial: A

• Coluna Final: F

• Linha Inicial: 1

• Linha Final: 100

• Tipo de Retorno: Tabela

• Range possui cabeçalho: marcado

Resultado:

• Os dados serão retornados como tabela estruturada para varredura.

---

Retornos

Modo	Tipo de Retorno
Célula	Texto
Range	Lista ou Tabela

---

Erros comuns e como evitar

Excel não aberto Execute após Abrir Excel ou Criar Excel.

Endereço de célula inválido Utilize o padrão A1, B2, AA10.

Intervalo fora da planilha Confirme limites de linhas e colunas.

Cabeçalho tratado incorretamente Marque corretamente as opções de cabeçalho.

---

Boas práticas

• Usar leitura de célula para validações rápidas.

• Usar leitura por range para processamento em massa.

• Definir intervalos precisos para performance.

• Converter tipos (Texto → Número/Data) quando necessário.

• Fechar o Excel ao final do fluxo.

• Nomear variáveis conforme o conteúdo lido (ex.: valorTotal, tabelaClientes).

---

Robô Exemplo

18KB

Ler Dados Excel - Robô Exemplo.roboteasy

Open