# Varrer Lista

{% 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 este Objeto é necessário selecionar a lista e escolher os parâmetros desejados.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2F57W3Nj6YykslQQEJHl3y%2Fimage.png?alt=media&#x26;token=80f15bc1-d959-4f95-98cc-1c978cb06477" 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 Lista - Informações Notas".                                                                             |
| 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             | Opção para selecionar a lista que será varrida.                                                                                                                                                                                                                  |
| Contador de Linhas           | Contador de linhas de um arquivo.                                                                                                                                                                                                                                |
| Valor Inicial de Contador    | Valor a ser informado para início do contador.                                                                                                                                                                                                                   |
| Incremento do Contador       | Valor que definirá o quanto será incrementado no contador a cada repetição.                                                                                                                                                                                      |
| Lista paralela               | Opção para varrer uma lista paralela.                                                                                                                                                                                                                            |
| Ignorar Primeira Linha       | Opção para ignorar a primeira linha da lista                                                                                                                                                                                                                     |

## PRÉ-REQUISITOS

* É necessário configurar e já ter um arquivo que possa ser transformado em lista no seu computador. Ex: Excel / Json.
* Podemos usar o [Abrir Excel](https://docs.roboteasy.tech/studio/geral/objetos/excel/abrir-excel) com o tipo de retorno em Lista.
* Caso tenha que selecionar o arquivo para utilizar no robô, será necessário o objeto [Carregar Arquivo.](https://docs.roboteasy.tech/studio/geral/objetos/tabela-de-dados/carregar-de-arquivo)
* É possível utilizar o objeto [Buscar Arquivos ](https://docs.roboteasy.tech/studio/geral/objetos/arquivos/buscar-arquivo)como uma lista e trazer todos os documentos dentro do diretório desejado.

## CASOS DE USO

* Utilizar para varrer informações de uma lista.
* Verificação de informações dentro de uma lista.
* Caso precise utilizar algum dado dentro da lista, mas seja necessário uma varredura para especificar.
* Varrer documentos em formato de lista.

## EXEMPLO

**Varrer documentos dentro de uma pasta em formato de lista.**

<details>

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

* **Objetos:** [**Buscar Arquivos**](https://docs.roboteasy.tech/studio/geral/objetos/arquivos/buscar-arquivo) **-** [**Caixa de Mensagem**](https://docs.roboteasy.tech/studio/geral/objetos/acoes-globais/caixa-de-mensagem)

</details>

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FFpfd7idNr26QpxCFXfUu%2Fimage.png?alt=media&#x26;token=bf31deea-756f-4f7c-8b0b-72fc45666d9f" alt=""><figcaption><p>Configuração Robô Exemplo Varrer Lista</p></figcaption></figure>

**PASSO 1:** Configurar Buscar Arquivos.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FBTIJEJw02jInWtiJIzEk%2Fimage.png?alt=media&#x26;token=0442f91c-0072-4803-98f6-15e64130558d" alt=""><figcaption><p>Configuração Buscar Arquivos</p></figcaption></figure>

**PASSO 2:** Configurar Varrer Lista.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2F0cbD6p9UqWxCRyql0Jyd%2Fimage.png?alt=media&#x26;token=c7081bf7-3925-468e-be99-067d92b9c2b7" alt=""><figcaption><p>Configuração Varrer Lista</p></figcaption></figure>

**PASSO 3:** Configurar Caixa de Mensagem com o nome identificador do objeto do Varrer Lista.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FsdaVVRbrCgJ6Awb2wJO0%2Fimage.png?alt=media&#x26;token=2b76c5bf-a6c6-4715-a38e-bacc4d93d58b" alt=""><figcaption><p>Configuração Caixa de Mensagem</p></figcaption></figure>

**PASSO 4:** 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%2Fz8VsNxl6JahaRfWfMYyh%2Fexecu%C3%A7%C3%A3o%20sucesso.gif?alt=media&#x26;token=1a4cac94-8a4b-4c27-8045-3fdf183ab25c" alt=""><figcaption><p>Execução Sucesso Robô Exemplo Varrer Lista</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%2FigYsG716BfWNI9Rduwya%2FVarrer%20Lista%20-%20Rob%C3%B4%20Exemplo.roboteasy?alt=media&token=2aa766a0-f111-4eb2-94ff-79388dbfb4b1>" %}