| Campo | Tipo | Descrição |
| ---------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Descrição | Campo de texto | Descrição visual do conector na construção do fluxo. |
| Tabela de dados | Seletor | Permite selecionar a tabela de dados em que os registros serão consultados. |
| Filtrar por | Tabela de Parâmetros | Tabela de parâmetros para aplicação de filtros de consulta de registros. |
| Campo | Campo de texto | Nome do campo da tabela de destino para consulta. Utilize o prefixo `data.[nome_do_campo]` para acessar os campos customizados na estrutura do Floui Database. |
| Operador | Seletor |
Operador para realizar a consulta de registros, entre:
Igual.
Diferente.
Maior.
Maior ou igual.
Menor.
Menor ou igual.
Contêm.
Não contêm.
|
| Valor | Campo de texto | Define o valor a ser usado como parâmetro de consulta. |
| Página | Campo de texto | Define o número da página contendo os resultados da consulta. Caso não informado, irá usar o valor padrão de 1. |
| Itens por página | Campo de texto | Define a quantidade de registros informados em cada página. Caso não informado, irá usar o valor padrão de 10. |
| Ordenar por | Tabela de Parâmetros | Tabela de parâmetros para definir a ordenação dos registros retornados. |
| Campo | Campo de texto | Define o campo que será usado na ordenação. |
| Direção | Seletor | Informa a direção da ordenação. Ascendente (ASC) ou Descendente (DESC). |
| Output Path | Campo de texto | Refere-se ao caminho de saída onde o resultado da consulta será disponibilizado no contexto de execução do conector. |
| {% endtab %} | | |
{% tab title="Payload" %}
## Sucesso
Em casos de sucesso o conector irá retornar uma lista contendo todos os registros correspondentes ao filtro, ordenação e paginação dentro da carga de dados do conector.
Sucesso na listagem de registros
## Erro
Caso o conector tenha erro na consulta e listagem de resultados, em sua saída será reportado o motivo do erro através do campo `error`, e uma lista `items` vazia.
Um erro comum na execução ocorre devido à parametrização incorreta na tabela de filtros **Filtrar por**. Isso acontece quando o nome do campo do Floui Database é inserido de maneira errada, sem o prefixo `data.`.
Por exemplo, em uma tabela fictícia de usuários com os campos "nome" e "sobrenome", se o campo "nome" for configurado sem o prefixo “data.”, o erro `Some fields are invalid` será gerado no objeto `msg` de saída do conector. Para evitar esse problema, todos os campos parametrizados na estrutura do Floui Database devem incluir o prefixo `data.` na tabela de filtros.
Já os campos internos padrão da tabela NoSQL, como `created_at` e `updated_at`, não precisam desse prefixo.
Erro na parametrização de campos para filtragem de registros
