Inserir Linha

Visão Geral

O objeto Inserir Linha adiciona uma ou mais linhas em uma planilha Excel a partir de uma linha de referência, deslocando as linhas existentes para baixo.

Ele é utilizado para inserir novos registros, criar espaço para dados adicionais e reorganizar a estrutura de relatórios.

---

Funcionamento

Ao ser executado, o objeto:

1. Utiliza a instância do Excel aberta.

2. Identifica a linha inicial informada.

3. Insere a quantidade de linhas definida em Quantidade de Linhas.

4. Desloca automaticamente as linhas existentes para baixo.

As novas linhas são criadas vazias e prontas para receber dados ou formatação.

Quando usar

• Para adicionar novos registros em relatórios.

• Para inserir linhas de subtotal ou separação.

• Para preparar estrutura antes de preencher dados.

• Para ajustar planilhas importadas.

Quando não usar

• Quando a planilha não deve ter sua estrutura alterada.

• Quando apenas o conteúdo precisa ser atualizado.

• Para arquivos CSV (use objetos de CSV).

---

Configuração

CAMPO	DESCRITIVO
Título	Nome exibido no fluxo do robô.
Selecionar objeto do tipo Excel	Instância do Excel que será utilizada.
Linhas (número)	Número da linha onde as novas linhas serão inseridas.
Quantidade de Linhas	Número de linhas a serem inseridas a partir da posição informada.

---

Exemplos

Exemplo simples

Objetivo: Inserir uma linha antes da linha 2.

Configuração:

• Objeto Excel: windowExcelOpen1

• Linhas (número): 2

• Quantidade de Linhas: 1

Resultado:

• Uma nova linha será inserida na posição 2, deslocando as linhas 2, 3, 4... para baixo.

Exemplo aplicado

Cenário: Inserir linha de cabeçalho extra.

Fluxo:

1. Abrir Excel

2. Inserir Linha (Linha: 1, Quantidade: 1)

3. Escrever novos títulos

4. Formatar Célula

5. Salvar Excel

---

Retornos

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

---

Erros comuns e como evitar

Número de linha inválido Informe um número de linha existente ou válido na planilha.

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

---

Boas práticas

• Inserir linhas antes de aplicar formatações finais.

• Atualizar fórmulas que dependam de intervalos fixos.

• Usar variáveis para definir dinamicamente a posição da inserção.

• Salvar o arquivo após alterações estruturais.

---

Robô Exemplo

9KB

Inserir Linha - Robô Exemplo.roboteasy

Open