> For the complete documentation index, see [llms.txt](https://docs.roboteasy.tech/studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboteasy.tech/studio/utilitarios/exemplos/criando-um-excel-e-varrendo-os-dados.md).

# Criando um Excel e Varrendo os Dados

Passo a passo para manipulação de planilhas Excel.

O Studio conta com diversos objetos para manipulação de planilhas Excel. Nesse artigo vamos juntos desenvolver um robô capaz de criar uma planilha, inserir dados e por último capturar esses dados transformando em uma lista para visualização das informações.

#### O que você vai aprender:

* Manipulação de planilhas Excel (ler planilha, escrever dados, abrir e fechar Excel)
* Trabalhar com variáveis do tipo listas
* Imprimir dados em caixas de mensagem

#### Utilizaremos os objetos:

1. [Criar Excel](/studio/geral-1/objetos/integration/microsoft/office365/pasta-de-trabalho/criar-excel.md): criar a planilha Excel em background;
2. [Manipular Dados](/studio/geral-1/objetos/excel/manipular-dados.md): adicionar colunas como Nome, Sobrenome e Idade;
3. [Inserir Linha](/studio/geral-1/objetos/dashboard/grid/inserir-linha.md): adicionar uma linha em branco para o espaçamento;
4. [Manipular Dados](/studio/geral-1/objetos/excel/manipular-dados.md): adicionar os dados na planilha;
5. [Ler Dados Excel](/studio/geral-1/objetos/excel/ler-dados.md): ler os dados da planilha e transformar em uma lista;
6. [Fechar Excel](/studio/geral-1/objetos/excel/fechar-excel.md): fechar o aplicativo do Excel com o salvamento;
7. [Varrer Lista](/studio/geral-1/objetos/listas/varrer-lista.md): percorrer a lista de dados capturada no item 5;
8. [Caixa de Mensagem](/studio/geral-1/objetos/acoes-globais/caixa-de-mensagem.md): disparar mensagem do tipo "alert" para visualizar os dados da lista.

{% hint style="info" %}
**IMPORTANTE**

Este artigo é apenas um exemplo para que você aprenda a utilizar os objetos do Studio, mas é possível utilizar menos objetos para alcançar o mesmo resultado.
{% endhint %}

> ✍️Vamos ao passo a passo!

### PASSO 1: Criar Planilha

Para iniciar a construção do nosso robô, vamos utilizar o objeto "Criar Excel" e selecionar o diretório onde desejamos que ele seja salvo no nosso computador, conforme exemplo:

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FTm1180ryjFQdFVcUpXpn%2Fimage.png?alt=media&amp;token=b3a8ba0e-cc70-4b92-9e1b-e0ed1a407ddd" alt=""><figcaption><p>Preenchimento do objeto Criar Excel</p></figcaption></figure>

### PASSO 2: Criar Colunas de Cabeçalho

Na sequência, vamos preparar o cabeçalho da nossa planilha com as colunas de nome, sobrenome e idade. Para isso, utilizaremos o objeto "Manipular Dados" e preencheremos de acordo com a estrutura que queremos criar.&#x20;

Adicionaremos na célula A1 o Nome, na B1 o Sobrenome e no C1 a Idade:

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2Fc9LR3kRZgLIOckzbMSoY%2Fimage.png?alt=media&amp;token=cf6694ac-868e-469e-8c51-26a4fdef3efb" alt=""><figcaption><p>Inclusão de colunas com o objeto Manipular Dados</p></figcaption></figure>

Vamos adicionar uma linha em branco abaixo do cabeçalho apenas para dar um espaçamento e para que você conheça o objeto Inserir Linha. Este passo é opcional.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FMGUYs54OHeomQdiRTp9q%2Fimage.png?alt=media&amp;token=12f8d09a-3de4-459b-8243-60a0e68e7d7d" alt=""><figcaption><p>Incluindo uma linha em branco com o bjeto Inserir Linha</p></figcaption></figure>

### PASSO 3: Preencher os Dados

Para preencher os dados nas linhas da nossa planilha usaremos novamente o objeto Manipular Dados, como no exemplo abaixo:

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FYm6TK65TtXvC58W1v6gx%2Fimage.png?alt=media&amp;token=eae2d08d-cb44-4702-bac7-0f0d80a788f3" alt=""><figcaption><p>Incluindo dados na planilha com o objeto Manipular Dados</p></figcaption></figure>

### PASSO 4: Ler Dados da Planilha

Até este momento já temos uma planilha Excel criada e preenchida com alguns dados. Poderíamos fechar o Excel e finalizar o robô por aqui.

Porém, a proposta desse artigo era criar uma planilha e depois varrer os dados para mostrar em tela.

Por isso, antes de fechar o Excel, vamos utilizar o objeto "Ler Dados Excel" para capturar os dados da planilha e salvar em uma variável do tipo Lista.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FXj2VVmsmlhRhMOlBl36o%2Fimage.png?alt=media&amp;token=09eab2ff-6333-476b-bb0b-321eb1819362" alt=""><figcaption><p>Capturando dados da planilha com o objeto Ler Dados Excel</p></figcaption></figure>

Agora que já temos os dados da planilha salvos em uma variável do tipo lista, podemos fechar o Excel para reduzir o consumo de memória do computador. Para isso, utilizaremos o objeto Fechar Excel.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2F9G4VsbvsN6oAj2wXLJBj%2Fimage.png?alt=media&amp;token=79d9a39e-270e-49eb-a692-d88d2b6cb6ef" alt=""><figcaption><p>Fechando o Excel</p></figcaption></figure>

### PASSO 5: Varrer e Mostrar Dados

Vamos para a etapa final do nosso projeto que consiste em varrer a lista de dados que capturamos no passo anterior, e mostrar em tela através de mensagens de alerta.

Para percorrer os dados da nossa variável lista, vamos utilizar o objeto "Varrer Lista" conforme abaixo:

<div align="left"><figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2Fg4hht9k2ufBjpVPz1Su2%2Fimage.png?alt=media&amp;token=4b7909a5-4820-4c4c-903e-2e862687f968" alt=""><figcaption><p>Utilização do objeto Varrer Lista</p></figcaption></figure></div>

Queremos que, para cada item percorrido no objeto Varrer Lista, nosso robô mostre uma caixa de mensagem com as informações. Para isso, vamos colocar o objeto Caixa de Mensagem dentro do Varrer Lista, dessa forma:

<div align="left"><figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FteLX81u0XntuavhGhIIo%2Fimage.png?alt=media&amp;token=de16ed8e-72cb-462f-b32d-d8977a929d93" alt=""><figcaption><p>Utilizando um objeto dentro do outro criando um laço</p></figcaption></figure></div>

No objeto "Caixa de Mensagem" adicionaremos { } e o nome identificador do objeto do Varrer Lista, no meu caso agora é "structRepeat10" então ficará assim:

<div align="left"><figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FK3cjPCAMlZj6bVZmlNN9%2Fimage.png?alt=media&amp;token=9f95212b-070d-47bf-a7e5-cfeb4709bac2" alt=""><figcaption><p>Preenchimento do objeto Caixa de Mensagem</p></figcaption></figure></div>

Se você seguiu todo o passo a passo desse artigo, deve ter um robô construído com a seguinte estrutura:

<div align="left"><figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FEIKdcge6pHex8IwrTnHi%2Fimage.png?alt=media&amp;token=756b5d3f-06c7-4fb1-86b5-d09e4f341b3d" alt=""><figcaption><p>Estrutura do robô finalizado</p></figcaption></figure></div>

Vamos executar?

Verifique se o seu robô está compilado com sucesso no console localizado na parte inferior da sua tela e, estando tudo ok, clique no botão ![](https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FamJwxqOefpMVE5ZN43Or%2Fimage.png?alt=media\&token=c652aa5b-7978-4f55-b550-17bda79f36f5).

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FvGOUlztp6lzOg779WQWk%2Fimage.png?alt=media&amp;token=ed82f62f-931f-4ae3-a7a3-cd27682c62c0" alt=""><figcaption><p>Localizando o console no Studio</p></figcaption></figure>

Se tudo deu certo, esperamos que o robô apresente 4 caixas de mensagem, cada uma com os dados correspondentes a uma linha da nossa planilha.

A primeira apresentará o cabeçalho:

![](https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FsjBbL1PYp8T1Aqev7jSO%2Fimage.png?alt=media\&token=f5a04e9c-fc1a-45cd-991c-b80ed17a73fa)

E da segunda em diante, apresentará os dados que preenchemos na planilha:

![](https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FO8MQLlHzbc1nd3ItCCKJ%2Fimage.png?alt=media\&token=d12a5c19-c625-45c9-a60b-180fbda59c24) ![](https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FD31XgSAotT29z7XxHHiD%2Fimage.png?alt=media\&token=ed5c663c-377c-44d6-a29d-1e1fd036ec5e)![](https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2F598y8dkaGExXZiyuHb9s%2Fimage.png?alt=media\&token=a6c265e1-86a3-45d8-a910-04fd6f600fe6)

### Download do Robô

{% file src="/files/Mq1ZUhsk4WhUjZgp0nwq" %}

### Conclusão

A manipulação de planilhas é amplamente utilizada por nossos clientes e já representa um robô de complexidade média.&#x20;

{% hint style="success" %}
**DICA**

Para reforçar o aprendizado, sugiro que você refaça esse robô utilizando uma planilha Excel do seu computador para explorar ainda mais os recursos.
{% endhint %}

Espero que esse artigo tenha te ajudado a melhorar seus conhecimentos na ferramenta Studio da Roboteasy.

Até logo! :clap: