Buscar Dados - Grid

Objeto utilizado para retornar dados de um grid do orquestrador

Visão Geral

O objeto Buscar Dados - Grid permite consultar registros armazenados em uma Grid do Orquestrador.

Esse objeto é utilizado para recuperar dados previamente armazenados na Grid, possibilitando que o robô utilize essas informações dentro do fluxo de automação.

A consulta pode ser realizada com filtros específicos, intervalo de datas e limite de registros retornados. Para executar essa operação, é necessário utilizar um objeto do tipo Autenticação, responsável por estabelecer a conexão com o Orquestrador.

---

Funcionamento

O objeto Buscar Dados - Grid realiza uma consulta na Grid do Orquestrador e retorna os registros encontrados de acordo com os critérios configurados.

O fluxo de funcionamento ocorre da seguinte forma:

1. O robô se autentica no Orquestrador através do objeto Autenticação.

2. O objeto Buscar Dados - Grid consulta uma Grid específica.

3. Podem ser aplicados filtros, intervalo de datas ou limite de registros.

4. Os dados encontrados são retornados no formato configurado.

Quando usar

• Quando for necessário consultar dados armazenados em uma Grid do Orquestrador.

• Quando o robô precisar recuperar registros previamente armazenados.

• Quando for necessário filtrar dados por data ou critérios específicos.

Quando não usar

Não utilizar quando o robô não precisa consultar dados armazenados na Grid do Orquestrador.

---

Configuração

CAMPO	DESCRITIVO
Versão do componente	Define a versão do componente utilizada pelo objeto.
Título	Nome do objeto dentro do fluxo do robô.
Nome Identificador do Objeto	Identificador único do objeto dentro do robô.
Selecionar objeto do tipo Autenticação	Define qual objeto Autenticação será utilizado para acessar o Orquestrador.
Selecionar Grid	Define a Grid do Orquestrador que será consultada.
Formatação das Datas	Define o formato das datas utilizadas na consulta.
Personalizado	Permite definir manualmente um formato personalizado de data.
Data início	Define a data inicial para filtragem dos registros.
Data fim	Define a data final para filtragem dos registros.
Filtrar	Campo utilizado para aplicar filtros adicionais na consulta.
Número máximo de linhas	Define o limite máximo de registros retornados pela consulta.
Listar todos os registros	Quando habilitado, retorna todos os registros da Grid.
Tipo de Retorno	Define o formato de retorno dos dados consultados (ex: Json).

---

Exemplos

Exemplo simples

Fluxo básico para consultar dados de uma Grid:

1. Configurar o objeto Autenticação.

2. Inserir o objeto Buscar Dados - Grid no fluxo.

3. Selecionar a Grid desejada.

4. Definir o Número máximo de linhas ou habilitar Listar todos os registros.

5. Executar o robô para recuperar os dados.

Exemplo aplicado

Cenário: um robô precisa consultar registros armazenados na Grid para processar dados pendentes.

Fluxo:

1. O robô realiza autenticação no Orquestrador utilizando o objeto Autenticação.

2. O objeto Buscar Dados - Grid consulta a Grid configurada.

3. O robô recupera os registros pendentes armazenados.

4. O fluxo processa os dados retornados e executa as ações necessárias.

---

Retornos

Os dados retornados pelo objeto dependem do Tipo de Retorno configurado.

Quando configurado como Json, os registros encontrados na Grid são retornados em formato JSON, permitindo que o robô manipule os dados dentro do fluxo.

---

Erros comuns e como evitar

Objeto de autenticação não configurado

Sem autenticação, o robô não consegue acessar o Orquestrador.

Como evitar:

• Configurar previamente um objeto Autenticação no fluxo.

Grid não selecionada

O objeto não consegue executar a consulta sem uma Grid definida.

Como evitar:

• Garantir que a opção Selecionar Grid esteja corretamente configurada.

Limite de registros inadequado

Definir um número muito baixo pode impedir o retorno de todos os dados necessários.

Como evitar:

• Ajustar corretamente o campo Número máximo de linhas ou habilitar Listar todos os registros.

---

Boas práticas

• Utilizar filtros para reduzir o volume de dados retornados.

• Definir corretamente o Número máximo de linhas para evitar consultas excessivas.

• Utilizar intervalos de data para otimizar consultas.

• Manter o objeto Autenticação reutilizável no fluxo.