# Buscar Dados - Grid

## CONFIGURAÇÃO

Para utilizar esse objeto basta configurar o objeto Autenticação e selecionar grid com o tipo de retorno desejado.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FYXdUvpNO3l1r2gBzruAV%2FBuscar%20Dados%20Grid%20v3.png?alt=media&#x26;token=1d9dac7a-1df7-4cc5-998a-d46c73e1e95b" alt=""><figcaption><p>Layout geral do objeto</p></figcaption></figure>

**Preenchendo o objeto:**

| Campo                                       | Descrição                                                                                                                                                                                                                                                        |
| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 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: "Buscar Dados Grid- Dados de Rastreabilidade".                                                                  |
| 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 Autenticação      | Opção para selecionar objeto **Autenticação.**                                                                                                                                                                                                                   |
| Selecionar Grid                             | Opção para selecionar o grid para buscar dados.                                                                                                                                                                                                                  |
| Caixa de Seleção: Selecionar Grid           | Opção para selecionar grid manualmente com **ID** ou **NOME.**                                                                                                                                                                                                   |
| Data Inicio                                 | Data inicial do período de busca.                                                                                                                                                                                                                                |
| Data Fim                                    | Data final do período de busca.                                                                                                                                                                                                                                  |
| Filtrar                                     | Neste campo, é possível filtrar pela informação a ser buscada                                                                                                                                                                                                    |
| Definir Número máximo de Linhas             | Número máximo de linhas retornadas                                                                                                                                                                                                                               |
| Caixa de Seleção: Listar todos os registros | Opção para buscar todos os registros em um grid                                                                                                                                                                                                                  |
| Tipo de Retorno                             | Tipo de retorno em **JSON**, **LISTA** ou **TABELA DE DADOS**                                                                                                                                                                                                    |

{% hint style="warning" %}
**ATENÇÃO:**&#x20;

* Listar todos os registros pode gerar lentidão ao buscar grids com muitas linhas
  {% endhint %}

## COMO PEGAR ID DO GRID

* Caso não o seu grid não aparece de forma orgânica dentro da seleção no objeto, basta desmarcar a caixa de seleção "Selecionar Grid" e digitar o ID ou nome do gráfico.&#x20;
* Com isso, os passos para pegar o ID são:

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FMkt0IASWiOH2EdGfwFlL%2Fid%20grid.gif?alt=media&#x26;token=43e4f074-4ff7-48ef-87ff-22883a58f496" alt=""><figcaption><p>Pegar ID do Grid via Orquestrador</p></figcaption></figure>

## RETORNOS

* Tipos de retorno de variáveis para o objeto:

**RESULTADO -** {orchestratorGetGrid4.Result}

**LEITURA DINÂMICA -** {orchestratorGetGrid4read}

## PRÉ-REQUISITOS

* É necessário configurar o objeto [Autenticação](https://docs.roboteasy.tech/studio/geral/objetos/orquestrador/autenticacao) com o usuário e senha onde encontra-se o Grid e Runtime desejado.

## CASOS DE USO

* Utilizar para buscar dados do grid criado dentro da ferramenta RobotEasy Orquestrador.
* Possível de utilizar para transferir dados do grid para documentos particulares. Ex: Excel, CSV.
* Validação de preenchimento correto das informações dentro dos grids.

## EXEMPLO

Buscar dados do grid desejado.

<details>

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

* **Objetos:** [Autenticação](https://docs.roboteasy.tech/studio/geral/objetos/orquestrador/autenticacao) - [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%2FFFrB6J6PQEwipHc9VyBc%2FBuscar%20Dados%20Grid%20v3%20robo%20exemplo.png?alt=media&#x26;token=27b39f53-a5b8-4b3a-972d-e09f672d48fd" alt=""><figcaption><p>Configuração Robô Exemplo Buscar Dados Grid</p></figcaption></figure>

**PASSO 1:** Configurar Autenticação.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FNG2hM7aBNZN1klMC3AeO%2FAutenticacao.png?alt=media&#x26;token=92754b41-e119-4d1e-9eb6-47225da12a80" alt=""><figcaption><p>Configuração Autenticação</p></figcaption></figure>

**PASSO 2:** Configurar Buscar Dados Grid.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2Fr7Wsl4n0sKbdzcZrhLim%2FBuscar%20Dados%20Grid%20v3%20exemplo.png?alt=media&#x26;token=f47adf03-1d56-4523-9498-cf0727c4d8c4" alt=""><figcaption><p>Configuração Buscar Dados Grid</p></figcaption></figure>

**PASSO 3:** Configurar Caixa de mensagem com retornos desejados.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FipzFDZGXuanxACI07YXl%2Fimage.png?alt=media&#x26;token=73d0be1d-1c7b-4f49-96c5-11c6ea22f12e" alt=""><figcaption><p>Caixa de mensagem com resultado</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%2FmJJvzteuu3zZ679h9utY%2FBuscar%20dados%20grid%20exemplo.gif?alt=media&#x26;token=dcb50495-bde4-413d-ba9d-8a7940d7f51c" alt=""><figcaption><p>Execução Sucesso Robô Exemplo Buscar Dados Grid</p></figcaption></figure>

## Baixar o Robô

{% hint style="info" %}
O Robô contêm informações sensíveis por isso não será disponibilizado.
{% endhint %}