# Varrer Dados Excel

{% hint style="warning" %}
O objeto é condicionado a trazer várias informações em milissegundos (pouco tempo), devido a isso, caso não seja colocado um "[Aguardar](https://docs.roboteasy.tech/studio/geral/objetos/acoes-globais/aguardar)" é possível que trave o Studio.
{% endhint %}

## CONFIGURAÇÃO

Para utilizar esse objeto basta configurar **Ler Dados Excel** e inserir valor inicial e seu incremento do contador.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FgkO7FSCVTGGL5FwS86KN%2Fconfigura%C3%A7%C3%A3o%20geral.PNG?alt=media&#x26;token=77e9c328-b88c-4ea6-af3c-a0a14ac58f2a" alt=""><figcaption><p>Layout geral do objeto</p></figcaption></figure>

**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: "Varrer Dados Excel - Informações Financeiras".                                                                 |
| Nome identificador do objeto        | É um identificador único do objeto e **não precisa ser alterado**, mas você pode renomear caso queira para localizá-lo mais facilmente quando for usá-lo em outros objetos. Apenas lembre-se que esse nome deve ser único e sem espaços ou caracteres especiais. |
| Selecionar lista ou tabela de dados | Opção para selecionar **Ler dados Excel** como objeto principal.                                                                                                                                                                                                 |
| Contador de Linhas                  | <p>Opção para indicar a posição atual da linha que está sendo lida. </p><p>Exemplo: Count, Contador.</p>                                                                                                                                                         |
| Valor Inicial do Contador           | Linha inicial a ser lida. Padrão: 0 (zero)                                                                                                                                                                                                                       |
| Incremento do Contador              | Valor a ser somado na contagem das linhas. Padrão: 1 (um)                                                                                                                                                                                                        |

## PRÉ-REQUISITOS

É necessário configurar [Ler dados Excel](https://docs.roboteasy.tech/studio/geral/objetos/excel/ler-dados) como objeto de selecionar lista ou tabela de dados.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FQB667wKj7DcEPcK1PxiK%2Fpre%20requisitos.PNG?alt=media&#x26;token=73e229ac-dd08-432f-b43e-1ef986bd42a9" alt=""><figcaption><p>Pré-requisito de Utilização</p></figcaption></figure>

## CASOS DE USO

* Utilizar para varrer informações de dentro de um documento Excel.
* Quando necessário fazer manipulação eficiente de grandes conjuntos de dados.
* Caso precise varrer o documento Excel para realizar algum outra automação de tarefas.

## EXEMPLO

**Varrer dados do documento Excel e verificar seu retorno em caixa de mensagem.**

<details>

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

* **Objetos:** [Abrir Excel](https://docs.roboteasy.tech/studio/geral/objetos/excel/abrir-excel) - [Ler dados Excel](https://docs.roboteasy.tech/studio/geral/objetos/excel/ler-dados) - [Caixa de Mensagem](https://docs.roboteasy.tech/studio/geral/objetos/acoes-globais/caixa-de-mensagem) - [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%2FWyQaC53N6XF5T7HdCyT0%2Fconfigura%C3%A7%C3%A3o%20robo%20exemplo.PNG?alt=media&#x26;token=0ca2adb9-3def-433b-9512-cf18c4b8d38b" alt=""><figcaption><p>Configuração Robô Exemplo Varrer Dados Excel</p></figcaption></figure>

Dados Planilha:

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FnpDP5XJUiVbFw2olVjxI%2Fdados%20planilha.PNG?alt=media&#x26;token=8b97275c-8cdc-4858-bb1f-8cab9d186e65" 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%2FL2UrioKcCOwyotiWEblZ%2Fconfigura%C3%A7%C3%A3o%20abrir%20excel.PNG?alt=media&#x26;token=a72cbd88-f6bb-43d3-8552-7a4064e84d67" alt=""><figcaption></figcaption></figure>

**PASSO 2:** Configurar Ler Dados Excel.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FI99pKSGFYm0CN3jq90JR%2Fconfigura%C3%A7%C3%A3o%20ler%20dados%20excel.PNG?alt=media&#x26;token=19a79a71-90fe-43c7-878f-c6b7f68f8a1e" alt=""><figcaption></figcaption></figure>

**PASSO 3:** Configurar Varrer Dados Excel.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FyjczTDcdF2DM0H2sb2Wz%2Fconfigura%C3%A7%C3%A3o%20exemplo%20varrer%20dados%20excel.PNG?alt=media&#x26;token=15549bac-47fc-4540-936d-97d9efd66a25" alt=""><figcaption></figcaption></figure>

**PASSO 4:** Configurar Caixas de Mensagem com "Count" e nome identificador do objeto de Varrer Dados Excel para verificar o retorno dos dados em tela.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FVUEmcECFOIjwlG0qO6vB%2FConfigura%C3%A7%C3%A3o%20Caixa%20de%20Mensagem.gif?alt=media&#x26;token=1144b395-89df-41ab-a21b-e12816b34a61" alt=""><figcaption><p>Configuração Caixa de Mensagem</p></figcaption></figure>

**PASSO 5:** 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%2FGqff5ZG2zEs0zzqnVi63%2FExecu%C3%A7%C3%A3o%20Sucesso%20Robo%20EXEMPLO.gif?alt=media&#x26;token=8b9c9449-5b4d-402c-bf87-d38c39a536b8" alt=""><figcaption><p>Execução Sucesso Robô Exemplo Varrer Dados Excel</p></figcaption></figure>

## Baixar o Robô

{% file src="<https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2Fx1EQuihb9OTlAyIuGvfP%2FVarrer%20Dados%20Excel%20-%20Rob%C3%B4%20Exemplo.roboteasy?alt=media&token=1da567c2-c77a-4b1e-a8a9-2941bb393e7c>" %}