Ferramenta: Tabela - Buscar Registros

Quando usar

Use este node sempre que precisar consultar dados de uma tabela do Brife dentro de um workflow. Exemplos comuns:

• Buscar todos os clientes que atendem a um criterio (ex: cidade = "Sao Paulo")


• Verificar se um registro ja existe antes de criar um novo


• Listar pedidos pendentes para processamento automatizado


• Alimentar um Chatbot IA com dados de uma tabela para responder perguntas do usuario

---

Como funciona

O node se conecta a uma tabela do workspace, permite selecionar uma pagina especifica e aplicar filtros para refinar os resultados. Os registros encontrados ficam disponiveis como uma lista de objetos para os nodes seguintes.

O fluxo segue pela saida Sucesso* quando a busca e completada (mesmo que nenhum registro seja encontrado), ou pela saida *Erro se houver falha na operacao.

---

Configuracoes

Tabela

Seleciona qual tabela do workspace sera consultada. A lista exibe todas as tabelas disponiveis, carregadas automaticamente.

Pagina

Apos selecionar a tabela, escolha a pagina especifica dentro dela. As paginas sao carregadas automaticamente com base na tabela selecionada. Este campo so aparece quando ha paginas disponiveis.

Filtros

Permite adicionar condicoes para refinar quais registros serao retornados. Cada filtro tem tres campos:

| Campo | Descricao |
|-------|-----------|
| Campo | A coluna da tabela a ser comparada. A lista e carregada automaticamente da pagina selecionada. |
| Operador | O tipo de comparacao. |
| Valor | O valor a ser comparado. Aceita variaveis dinamicas. |

Operadores disponiveis:

| Operador | Descricao |
|----------|-----------|
| Contem | O valor do campo contem o texto informado |
| Igual a | O valor do campo e exatamente igual ao informado |
| Maior que | O valor do campo e maior que o informado |
| Maior ou igual | O valor do campo e maior ou igual ao informado |
| Menor que | O valor do campo e menor que o informado |
| Menor ou igual | O valor do campo e menor ou igual ao informado |
| Existe | O campo possui algum valor (nao esta vazio) |

Use o botao + para adicionar filtros e o icone de lixeira para remover. Se nenhum filtro for configurado, todos os registros da pagina serao retornados.

Limite

Numero maximo de registros retornados pela busca. Valor padrao: 50. Aceita variaveis dinamicas.

---

Dados de saida

| Variavel | Tipo | Descricao |
|----------|------|-----------|
| `rows` | Lista | Lista de registros encontrados |
| `rows[].id` | Texto | ID unico do registro |
| `rows[].databaseId` | Texto | ID da tabela a qual o registro pertence |
| `rows[].pageId` | Texto | ID da pagina a qual o registro pertence |
| `rows[].values` | Objeto | Valores dos campos do registro (chave = ID do campo, valor = conteudo) |
| `rows[].createdAt` | Data | Data/hora de criacao do registro |
| `rows[].updatedAt` | Data | Data/hora da ultima atualizacao |
| `pagination` | Objeto | Informacoes de paginacao |
| `pagination.page` | Numero | Pagina atual |
| `pagination.limit` | Numero | Limite de registros por pagina |
| `pagination.totalItems` | Numero | Total de registros encontrados |
| `pagination.totalPages` | Numero | Total de paginas disponiveis |

---

Saidas do node

| Saida | Quando ativa |
|-------|-------------|
| Sucesso | A busca foi executada (mesmo que retorne 0 registros) |
| Erro | Falha na conexao com a tabela ou erro interno |

---

Dicas

• Para acessar o valor de um campo especifico de um registro, use `rows[0].values.nome_do_campo`. Os nomes dos campos correspondem aos IDs definidos na tabela.


• Combine multiplos filtros para buscas mais precisas. Todos os filtros sao aplicados com logica E (AND) -- ou seja, o registro precisa atender a todas as condicoes.


• Use a variavel `pagination.totalItems` para verificar quantos registros foram encontrados antes de prosseguir no fluxo.


• Defina um limite adequado. Para verificar existencia de um registro, `1` e suficiente. Para processamento em lote, ajuste conforme necessario.


• Este node pode ser usado como ferramenta do Chatbot IA, permitindo que o agente consulte tabelas automaticamente para responder perguntas do usuario.