Inserir Colunas

Visão Geral

O objeto Inserir Coluna adiciona uma ou mais colunas em uma planilha Excel a partir de uma coluna de referência, deslocando as colunas existentes para a direita.

Ele é utilizado para inserir novos campos, criar espaço para dados calculados, adicionar colunas auxiliares e reorganizar a estrutura da planilha.

---

Funcionamento

Ao ser executado, o objeto:

1. Utiliza a instância do Excel aberta.

2. Identifica a coluna inicial informada.

3. Insere a quantidade de colunas definida em Quantidade de Colunas.

4. Desloca automaticamente as colunas existentes para a direita.

As colunas inseridas ficam vazias e prontas para receber dados ou formatação.

Quando usar

• Para adicionar colunas de cálculo (ex.: Total, Status, Categoria).

• Para incluir novos campos em relatórios.

• Para preparar estrutura antes de preencher dados.

• Para ajustar layout de planilhas importadas.

---

Configuração

CAMPO	DESCRITIVO
Título	Nome exibido no fluxo do robô.
Selecionar objeto do tipo Excel	Instância do Excel que será utilizada.
Colunas (letra)	Letra da coluna onde as novas colunas serão inseridas (ex.: A, B, C).
Quantidade de Colunas	Número de colunas a serem inseridas a partir da posição informada.

---

Exemplos

Exemplo simples

Objetivo: Inserir uma coluna antes da coluna C.

Configuração:

• Objeto Excel: excel

• Colunas (letra): C

• Quantidade de Colunas: 1

Resultado:

• Uma nova coluna será inserida na posição C, deslocando as colunas C, D, E... para a direita.

Exemplo aplicado

Cenário: Adicionar coluna de Status em um relatório.

Fluxo:

1. Abrir Excel

2. Inserir Coluna (Coluna: D, Quantidade: 1)

3. Escrever cabeçalho “Status”

4. Preencher valores

5. Formatar Célula

6. Salvar Excel

---

Retornos

O objeto Inserir Coluna não retorna valores. Ele apenas altera a estrutura da planilha.

---

Erros comuns e como evitar

Coluna inexistente Informe uma letra de coluna válida.

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

---

Boas práticas

• Inserir colunas antes de preencher ou formatar dados.

• Utilizar nomes claros para cabeçalhos após a inserção.

• Ajustar largura com Auto Ajuste Coluna após incluir dados.

• Salvar o arquivo ao final da alteração estrutural.

---

Robô Exemplo

10KB

Incluir Coluna - Robô Exemplo.roboteasy

Open