# Inserir Linha

## CONFIGURAÇÃO

Para utilizar esse objeto basta configurar **Abrir Excel ou Criar Excel,** decidindo a(s) linha(s) que serão inserida e sua quantidade.

![Layout geral do objeto](https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2F8OgRjPuWNrTcyvInj0Oy%2Fconfigura%C3%A7%C3%A3o%20geral%20inserir%20Linha.PNG?alt=media\&token=88281cb9-4d70-41a0-96f8-3c3b137630b4)

**Preenchendo o objeto:**

| Campo                           | Descritivo                                                                                                                                                                                   |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Título                          | É o nome do objeto e **não precisa ser alterado**, a menos que você queira identificá-lo para facilitar a localização dele no robô, por exemplo: "Inserir Linhas - Novas Linhas Financeiro". |
| Selecionar objeto do tipo Excel | Opção para selecionar **Abrir Excel ou Criar Excel** como objeto principal.                                                                                                                  |
| Linhas (números)                | Adicione as linhas em número.                                                                                                                                                                |
| Quantidade                      | Quantidade de novas linhas.                                                                                                                                                                  |

{% hint style="info" %}
A linha adicionada será colocada exatamente na linha mencionada, o valor anterior da linha será passado para a próxima.
{% endhint %}

## PRÉ-REQUISITOS

É necessário configurar [**Abrir Excel**](https://docs.roboteasy.tech/studio/geral/objetos/excel/abrir-excel) **ou** [**Criar Excel**](https://docs.roboteasy.tech/studio/geral/objetos/excel/criar-excel) como objetos do tipo Excel para utilizar esse objeto.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FCKYObRU3nlGFClTuChjN%2Fpre%20requisito%20formata%C3%A7%C3%A3o%20condicional.PNG?alt=media&#x26;token=69911880-6c2c-45b5-a3f8-51a9c678c206" alt=""><figcaption><p>Pré-requisito de Utilização</p></figcaption></figure>

## CASOS DE USO

* Utilizar para incluir novas linhas sem afetar os dados previamente inseridos no documento Excel.
* Quando precisar atualizar o documento com novas informações e para isso é necessário inserir linhas.

## EXEMPLO

**Inserir 3 (três) novas linhas no documento Excel.**

<details>

<summary>ITENS UTILIZADOS NO ROBÔ</summary>

**Objeto:** [Abrir Excel](https://docs.roboteasy.tech/studio/geral/objetos/excel/abrir-excel) - [Aguardar](https://docs.roboteasy.tech/studio/geral/objetos/acoes-globais/aguardar) - [Fechar Excel](https://docs.roboteasy.tech/studio/geral/objetos/excel/fechar-excel)

**Documentos:** Excel Simples

</details>

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FyYDnErCK79TBNJo7I5cd%2Fconfigura%C3%A7%C3%A3o%20robo%20exemplo.PNG?alt=media&#x26;token=3b3d7524-6a56-4fb4-9165-670203d09fe2" alt=""><figcaption></figcaption></figure>

Dados Planilha:

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FEpJMR1lnkXVFcqspAFP0%2Fdados%20planilha.PNG?alt=media&#x26;token=48843475-6700-4ce3-8136-255bb77584b5" alt=""><figcaption><p>Dados Planilha</p></figcaption></figure>

**PASSO 1:** Configurar Abrir Excel

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FgF97aoEpw8vxsWqlg5OJ%2Fconfigura%C3%A7%C3%A3o%20abrir%20excel.PNG?alt=media&#x26;token=66860d73-2f3e-4106-8483-5db23401dcac" alt=""><figcaption><p>Configuração Abrir Excel</p></figcaption></figure>

**PASSO 2:** Configurar Inserir Linha.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FOOIN0Bq7XkxoEXFzM7OA%2Finserir%20linha.PNG?alt=media&#x26;token=705337da-9fb7-4d94-95fb-944ca0512e83" alt=""><figcaption><p>Configuração Inserir Linha</p></figcaption></figure>

**PASSO 3:** Executar o robô e verificar as ações.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FUEjks3LSsenuuLkjKeEh%2FExecu%C3%A7%C3%A3o%20sucesso%20rob%C3%B4%20exemplo.gif?alt=media&#x26;token=88ca4a2d-0aa1-44df-88d3-8addbe7fe5a9" alt=""><figcaption></figcaption></figure>

## Baixar o Robô

{% file src="<https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FhpSatIuVAGuOiMR9KBCb%2FInserir%20Linha%20-%20Rob%C3%B4%20Exemplo.roboteasy?alt=media&token=28d7ed40-a3af-470e-a3c5-6e4829d4dc63>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.roboteasy.tech/studio/geral/objetos/excel/inserir-linha.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.