Manipular Dados
Visão Geral
O objeto Manipular Dados permite escrever valores diretamente em células específicas de uma planilha Excel, definindo também o tipo do dado (Texto, Número, Data, etc.).
Ele é utilizado para preenchimento estruturado de planilhas, atualização de registros, escrita de cabeçalhos, datas, valores calculados e qualquer tipo de informação em posições exatas.
Funcionamento
Ao ser executado, o objeto:
Utiliza a instância do Excel aberta.
Para cada parâmetro configurado:
Acessa a coluna e linha informadas.
Insere o valor.
Aplica o tipo de dado (Texto, Data, Número, etc.).
Repete o processo para todos os registros configurados no bloco de parâmetros.
Esse objeto permite escrever múltiplas células em uma única execução.
Quando usar
Para preencher relatórios célula a célula.
Para inserir cabeçalhos e valores em posições fixas.
Para atualizar campos específicos de uma planilha.
Para controlar tipos de dados (ex.: datas como Data, números como Número).
Quando não usar
Para leitura de dados (use Ler Dados Excel).
Para escrita em grandes volumes sequenciais (use varredura + escrita em loop, se existir).
Para arquivos CSV.
Configuração
Campos gerais
Selecionar objeto do tipo Excel
Instância do Excel onde os dados serão escritos.
Parâmetros (repetível)
Cada item da lista representa uma célula a ser preenchida.
Coluna
Letra da coluna (ex.: A, B, C).
Linha
Número da linha (ex.: 1, 2, 10).
Valor
Conteúdo a ser escrito na célula.
Tipo
Tipo do dado (Texto, Número, Data, etc.).
Exemplos
Exemplo simples
Objetivo: Preencher duas células.
Configuração:
Coluna: A | Linha: 1 | Valor:
Data Futura| Tipo: TextoColuna: A | Linha: 2 | Valor:
20/10/2023| Tipo: Data
Resultado:
A1 conterá o texto “Data Futura”.
A2 conterá a data 20/10/2023 formatada como Data.
Exemplo aplicado
Cenário: Preencher cabeçalhos e valores comparativos.
Configuração:
A1: “Data Futura” (Texto)
A2: 20/10/2023 (Data)
B1: “Data Anterior” (Texto)
B2: 09/06/2023 (Data)
Fluxo:
Abrir Excel
Manipular Dados
Formatar Célula (cabeçalhos em negrito)
Salvar Excel
Retornos
O objeto Manipular Dados não retorna valores. Ele apenas escreve dados na planilha.
Erros comuns e como evitar
Coluna inválida Utilize letras válidas (A, B, C... AA, AB...).
Linha inválida Informe números de linha existentes ou válidos.
Tipo incompatível com valor Certifique-se de que o valor esteja no formato compatível com o tipo (ex.: datas válidas para tipo Data).
Excel não aberto Execute após Abrir Excel ou Criar Excel.
Boas práticas
Definir o tipo correto para evitar conversões automáticas incorretas.
Agrupar escritas relacionadas em uma única execução do objeto.
Preencher dados antes de aplicar formatações.
Utilizar variáveis para valores dinâmicos.
Salvar o arquivo após a escrita.
Robô Exemplo
Last updated
Was this helpful?