# Ler Dados Texto

## CONFIGURAÇÃO

Para utilizar este Objeto é necessário selecionar o documento de texto e escolher os parâmetros do objeto.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2Fc40KqkPhjnB4nslsKQDg%2Fimage.png?alt=media&#x26;token=4a371cf0-82a3-4872-8361-f160148eb8e6" alt=""><figcaption><p>Layout geral do objeto</p></figcaption></figure>

**Preenchendo o objeto:**

<table><thead><tr><th width="302">Campo</th><th>Descritivo</th></tr></thead><tbody><tr><td>Título </td><td>É o nome do objeto e <strong>não precisa ser alterado</strong>, a menos que você queira identificá-lo para facilitar a localização dele no robô, por exemplo: "Ler Dados Texto - Lista de Informações".</td></tr><tr><td>Nome Identificador do Objeto</td><td>É um identificador único do objeto e <strong>não precisa ser alterado</strong>, 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.</td></tr><tr><td>Selecionar objeto do tipo Arquivo</td><td>Opção para selecionar <strong>Criar Texto</strong> como objeto principal.</td></tr><tr><td>Arquivo</td><td>Selecionar o arquivo diretamente no diretório</td></tr><tr><td>Retornar lista com o conteúdo das linhas do arquivo</td><td>Esse parâmetro, caso marcado indica que a leitura trará uma lista com as linhas do arquivo. O padrão é sempre trazer todo o conteúdo para uma variável <strong>Texto.</strong></td></tr><tr><td>Codificação</td><td>Codificação do texto para a leitura. Exemplo: <strong>UTF-8 e ANSI.</strong></td></tr><tr><td>Formatar Cabeçalho</td><td>Opção para formatar cabeçalho do documento texto na sua leitura no formato <strong>Lista ou Tabela de Dados.</strong></td></tr></tbody></table>

**Retornar lista com o conteúdo das linhas do arquivo:**

<table><thead><tr><th width="270">Campo</th><th width="282.3333333333333">Descritivo</th><th data-hidden></th></tr></thead><tbody><tr><td>Delimitador</td><td>Caractere que delimita o arquivo. <strong>Exemplo: ; (ponto e vírgula)</strong></td><td></td></tr><tr><td>Ignorar primeira linha</td><td>Ignora a primeira linha do arquivo.</td><td></td></tr><tr><td>Tipo de Retorno</td><td>Seleciona o tipo de retorno do arquivo. <strong>Lista ou Tabela de Dados</strong></td><td></td></tr><tr><td>Arquivo possui cabeçalho</td><td>Definir se o arquivo possui ou não cabeçalho.</td><td></td></tr><tr><td>Incluir cabeçalho</td><td>Inclui cabeçalho no arquivo.</td><td></td></tr><tr><td>Configurações Avançadas</td><td>Definir configuração avançada. Linha Inicial/ Conteúdo - Linha Final/Conteúdo</td><td></td></tr></tbody></table>

## PRÉ-REQUISITOS

1 - É necessário ter documento txt criado no seu computador para conseguir selecioná-lo.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FSxNyZtPmWmUbczWZOQN1%2Fimage.png?alt=media&#x26;token=9a234513-38f5-43f1-8dea-e3c9ea1f9512" alt=""><figcaption><p>Pré-requisito de Utilização</p></figcaption></figure>

2 - Quando utilizar o Ler Dados Texto com o formato **Lista** é necessário utilizar [Varrer Lista](https://docs.roboteasy.tech/studio/geral/objetos/listas/varrer-lista) e quando o formato for **Tabela de Dados** é necessário utilizar [Varrer Dados Tabela](https://docs.roboteasy.tech/studio/geral/objetos/tabela-de-dados/varrer-dados-tabela).&#x20;

3 - É possível ler o texto do arquivo corrido, ou seja, sem qualquer formatação específica do objeto.

## CASOS DE USO

* Utilizar pra ler dados do documento de texto.
* Acessar informações armazenadas dentro do documento de texto.
* Quando quiser fazer um processamento e análise de dados na sua automação.
* Extração de informações estruturadas pra melhor entendimento e análise.
* Verificação e validação de dados.

## EXEMPLO

**Ler Dados Texto como uma lista de um documento de texto já preenchido.**

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FWGGVYQ12hlHFUVPGnlvF%2Fimage.png?alt=media&#x26;token=fc5ef4eb-ab92-4404-a87c-e0beb375f140" alt=""><figcaption><p>Configuração Robô Exemplo Ler Dados Texto</p></figcaption></figure>

**DOCUMENTO UTILIZADO:**

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FnEh5aVY4yCvqxV4HqOop%2Fimage.png?alt=media&#x26;token=dc4ec29c-6f2d-4054-a745-ac802460b992" alt=""><figcaption><p>Documento Utilizado Ler Dados Texto</p></figcaption></figure>

**PASSO 1:** Configurar Ler Dados Texto para ler a 3 e 4 linhas da lista no documento de texto.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FGXb9LSviMqDsokhqpRxk%2Fimage.png?alt=media&#x26;token=7879477a-5ed8-4a1e-a287-5df7dec99b3f" alt=""><figcaption><p>Configuração Ler Dados Texto</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%2F3z99XnJeZ2O8RK6tSQ9X%2Fimage.png?alt=media&#x26;token=1b8aff3e-0f91-44ef-a311-537f62a25f98" alt=""><figcaption><p>Configuração Varrer Lista</p></figcaption></figure>

**PASSO 3:** Configurar Caixa de Mensagem para verificar o retorno da leitura.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FMan7VxbqWKuLUMxD498O%2Fcaixa%20de%20mensagem.gif?alt=media&#x26;token=a062237b-b1e0-495b-9c73-ae9252ae3cbd" 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%2FYj68rD34ZxeXHMXRVsSf%2Fexecu%C3%A7%C3%A3o%20sucesso%20robo%20exemplo.gif?alt=media&#x26;token=4eae62ad-ecb7-474a-a802-e8374a10616b" alt=""><figcaption><p>Execução Sucesso Robô Exemplo Ler Dados Texto</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%2F7KFqDmEHdFrkWMhYx8yU%2FLer%20Dados%20Texto%20-%20Rob%C3%B4%20Exemplo.roboteasy?alt=media&token=fe557093-1e9b-4928-8638-3905051c1ac5>" %}
