Inserir Planilha

Visão Geral

O objeto Inserir Planilha cria uma nova aba (planilha) dentro de um arquivo Excel já aberto, permitindo organizar dados em múltiplas folhas no mesmo arquivo.

Ele é utilizado para separar informações por contexto, gerar abas de apoio, relatórios por período, categorias ou etapas do processo.

---

Funcionamento

Ao ser executado, o objeto:

1. Utiliza a instância do Excel aberta.

2. Cria uma nova planilha no arquivo.

3. Define o nome da planilha conforme informado.

4. A nova aba passa a estar disponível para escrita, leitura e formatação.

A planilha é criada vazia, pronta para receber dados.

Quando usar

• Para separar dados por tipo (ex.: Vendas, Clientes, Erros).

• Para gerar relatórios mensais em abas diferentes.

• Para criar planilhas auxiliares de cálculo.

• Para estruturar arquivos Excel complexos.

Quando não usar

• Quando todos os dados devem permanecer em uma única aba.

• Para arquivos CSV (não suportam múltiplas planilhas).

• Quando apenas leitura de dados é necessária.

---

Configuração

CAMPO	DESCRITIVO
Título	Nome exibido no fluxo do robô.
Selecionar objeto do tipo Excel	Instância do Excel onde a nova planilha será criada.
Nome Planilha	Nome da nova aba que será adicionada ao arquivo.

---

Exemplos

Exemplo simples

Objetivo: Criar uma aba chamada "Cadastro".

Configuração:

• Objeto Excel: excel

• Nome Planilha: Cadastro

Resultado:

• Uma nova aba chamada Cadastro será criada no arquivo.

Exemplo aplicado

Cenário: Gerar relatório com abas separadas.

Fluxo:

1. Criar Excel

2. Inserir Planilha: "Resumo"

3. Inserir Planilha: "Detalhes"

4. Escrever dados em cada aba

5. Salvar Excel

---

Retornos

O objeto Inserir Planilha não retorna valores. Ele apenas adiciona uma nova aba ao arquivo Excel.

---

Erros comuns e como evitar

Nome de planilha já existente Utilize nomes únicos para cada aba.

Nome inválido Evite caracteres não permitidos pelo Excel (ex.: : \ / ? * [ ]).

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

---

Boas práticas

• Padronizar nomes de planilhas.

• Criar todas as abas antes de começar a escrever dados.

• Utilizar variáveis para gerar nomes dinâmicos (ex.: por data).

• Salvar o arquivo após criar novas planilhas.

---

Robô Exemplo

9KB

Inserir Planilha - Robô Exemplo.roboteasy

Open