broom-wideLimpar Planilha

Visão Geral

O objeto Limpar Planilha remove todo o conteúdo de uma planilha Excel, apagando valores e fórmulas, mas mantendo a estrutura da aba (linhas, colunas e formatações básicas).

Ele é utilizado para reutilizar planilhas, reiniciar relatórios e preparar uma aba para receber novos dados em uma nova execução do robô.


Funcionamento

Ao ser executado, o objeto:

  1. Utiliza a instância do Excel aberta.

  2. Limpa todas as células da planilha ativa.

  3. Remove valores, textos e fórmulas.

  4. Mantém a planilha existente, pronta para novo preenchimento.

Se a opção Salvar Conteúdo estiver marcada, a limpeza é persistida no arquivo.

Quando usar

  • Para reutilizar uma planilha em execuções recorrentes.

  • Para limpar relatórios antes de gerar novos dados.

  • Para apagar conteúdo antigo mantendo o layout.

  • Para resetar abas de trabalho automaticamente.

Quando não usar

  • Quando os dados antigos precisam ser preservados.

  • Para excluir uma planilha inteira (use excluir planilha, se existir).

  • Para arquivos CSV.


Configuração

CAMPO
DESCRITIVO

Selecionar objeto do tipo Excel

Instância do Excel onde a planilha será limpa.

Salvar Conteúdo

Quando marcado, salva o arquivo após a limpeza.


Exemplos

Exemplo simples

Objetivo: Limpar completamente a planilha atual.

Configuração:

  • Objeto Excel: windowExcelOpen1

  • Salvar Conteúdo: marcado

Resultado:

  • Todas as células da planilha ficarão vazias e o arquivo será salvo.

Exemplo aplicado

Cenário: Gerar relatório diário no mesmo arquivo.

Fluxo:

  1. Abrir Excel

  2. Limpar Planilha

  3. Inserir cabeçalhos

  4. Preencher dados do dia

  5. Salvar Excel

  6. Fechar Excel


Retornos

O objeto Limpar Planilha não retorna valores. Ele apenas remove o conteúdo da aba.


Erros comuns e como evitar

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

Perda de dados não intencional Utilize apenas quando tiver certeza de que o conteúdo anterior não será necessário.


Boas práticas

  • Fazer backup antes de limpar planilhas críticas.

  • Usar em conjunto com criação de cabeçalhos automáticos.

  • Limpar antes de inserir novos dados para evitar resíduos.

  • Salvar o arquivo após a operação.


Robô Exemplo

Last updated

Was this helpful?