> 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/geral-1/objetos/orquestrador/buscar-dados-na-grid.md).

# 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="/files/74rHHaXLPFMAvVPrtMKL" 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="/files/6WqMtlcHGFSOv4BS9an0" 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](/studio/geral-1/objetos/orquestrador/autenticacao.md) 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](/studio/geral-1/objetos/orquestrador/autenticacao.md) - [Caixa de Mensagem](/studio/geral-1/objetos/acoes-globais/caixa-de-mensagem.md)

</details>

<figure><img src="/files/rEaSfRjlw1HLDZxrHbom" alt=""><figcaption><p>Configuração Robô Exemplo Buscar Dados Grid</p></figcaption></figure>

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

<figure><img src="/files/AuBxj7eRi9qQvkx4USWM" alt=""><figcaption><p>Configuração Autenticação</p></figcaption></figure>

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

<figure><img src="/files/Klj1uK35bbmGtXTbWTxi" alt=""><figcaption><p>Configuração Buscar Dados Grid</p></figcaption></figure>

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

<figure><img src="/files/iyIjHJ0hGp3czpQr3LBr" alt=""><figcaption><p>Caixa de mensagem com resultado</p></figcaption></figure>

**PASSO 4:** Executar o robô e verificar as ações.

<figure><img src="/files/gjixRuc8BZf0cHacUtqw" 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 %}