# Ler Coluna

## CONFIGURAÇÃO

Para utilizar este Objeto é necessário configurar Varrer Dados Tabela e inserir o nome correto da coluna desejada.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FIOoM3KMf3hGZ1hEPfbbb%2Fimage.png?alt=media&#x26;token=10f6e4cb-ad82-4930-a4ee-3cb748b1f704" 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: "Ler Coluna - Usuários".                                                                                        |
| 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 objeto do tipo Tabela de Dados | Opção para selecionar Varrer Dados Tabela.                                                                                                                                                                                                                       |
| Nome da coluna                            | Deve ser informado o nome da coluna que será lida.                                                                                                                                                                                                               |

{% hint style="info" %}
**INTERPOLAÇÃO**

Trata-se de um conceito técnico utilizado em programação e você não precisa se preocupar em alterá-lo neste momento.
{% endhint %}

## PRÉ-REQUISITOS

* Para ler a coluna corretamente o objeto somente aceita [Varrer Dados Tabela](https://docs.roboteasy.tech/studio/geral/objetos/tabela-de-dados/varrer-dados-tabela).
* É necessário configurar [Criar Tabela](https://docs.roboteasy.tech/studio/geral/objetos/tabela-de-dados/criar-tabela) ou já ter um arquivo que possa ser transformado em tabela de dados 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 Tabela de Dados.
* Na condição de usar o Criar Tabela, para visualizar a mudança em tela será necessário o objeto [Exportar](https://docs.roboteasy.tech/studio/geral/objetos/tabela-de-dados/exportar) para que seja criada a tabela e visualizada a alteração.
* 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)

## CASOS DE USO

* Utilizar para Ler Coluna específica da Tabela de Dados.
* Caso seja necessário utilizar a informação da coluna lida em outro tipo de automação.
* Verificação de dados, caso a tabela extraída esteja com as informações incorretas.

## EXEMPLO

**Ler coluna de tabela e visualizar em tela através de caixa de mensagem.**

<details>

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

* **Objetos:** [Criar Tabela](https://docs.roboteasy.tech/studio/geral/objetos/tabela-de-dados/criar-tabela) - [Inserir Dados em Tabela](https://docs.roboteasy.tech/studio/geral/objetos/tabela-de-dados/inserir-dados-em-tabela) - [Varrer Dados Tabela](https://docs.roboteasy.tech/studio/geral/objetos/tabela-de-dados/varrer-dados-tabela) - [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%2FjZhHoYxzvEbJDI9wzp19%2Fimage.png?alt=media&#x26;token=92a7cd9f-0d25-44ca-b456-c05dab7a696d" alt=""><figcaption><p>Configuração Robô Exemplo Ler Coluna</p></figcaption></figure>

**PASSO 1:** Configurar Criar Tabela e Inserir Dados em Tabela.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FaRRLtvBqmvOF9xElFRK8%2Fimage.png?alt=media&#x26;token=0dd1fbc5-ce76-459e-b00b-88abd9b7127d" alt=""><figcaption><p>Configuração Criar Tabela</p></figcaption></figure>

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FHcO96IAfEOlUFWY9NLoU%2Fimage.png?alt=media&#x26;token=f15039e3-e044-44ac-a500-33906ae3e693" alt=""><figcaption><p>Configuração Inserir Dados em Tabela</p></figcaption></figure>

**PASSO 2:** Configurar Varrer Dados Tabela.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2Fi1u22JzMZP3BLmoMqXIJ%2Fimage.png?alt=media&#x26;token=4654464c-b92e-4c48-9ed3-e7f9a7e27744" alt=""><figcaption><p>Configuração Varrer Dados Tabela</p></figcaption></figure>

**PASSO 3:** Configurar Ler Coluna.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FJXAZn6xDDpsuP12VcoZV%2Fimage.png?alt=media&#x26;token=a197f56c-a10c-4e86-90ad-b74dfeb814ed" alt=""><figcaption><p>Configuração Ler Coluna</p></figcaption></figure>

**PASSO 4:** Configurar Caixa de Mensagem.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2Fj7yaaTKGBmhcu9A6dfni%2Fcaixa%20de%20mensagem.gif?alt=media&#x26;token=685bfcf6-6a56-41a8-8c6c-c6c1bf4d135e" 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%2FJEatsYzaO1JLeQ3zSqPJ%2Fexecu%C3%A7%C3%A3o%20sucesso%20.gif?alt=media&#x26;token=c0e393c4-70c3-4809-9389-b9fdebab2319" alt=""><figcaption><p>Execução Sucesso Robô Exemplo Ler Coluna</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%2F3Iui1ESKusk08DW8OANv%2FLer%20Coluna%20-%20Rob%C3%B4%20Exemplo.roboteasy?alt=media&token=dcafb091-c015-428d-8e0b-e258f5cc24e6>" %}