Obter por filtro

A operação Buscar Registros por Filtro permite recuperar múltiplos registros de uma tabela do dicionário com base em critérios personalizados.

🎯 O que essa operação faz?

Essa operação permite buscar registros dentro de uma tabela do dicionário utilizando filtros personalizados.

✅ Principais características:

• Recupera múltiplos registros com base em critérios específicos.

• Permite aplicar filtros para refinar a busca.

• Pode ser usada para carregar listas dinâmicas ou validar informações.

📂 Como Configurar a Operação "Buscar por Filtro"

1️⃣ Acesse o Componente

1. No Hablla Studio, abra o fluxo de automação onde deseja buscar registros no dicionário.

2. Adicione o bloco "Dicionário".

3. No painel lateral direito, selecione a operação "Buscar por Filtro".

2️⃣ Preencha os Campos Obrigatórios

Campo	Tipo de Dado	Obrigatório?	Descrição
Workspace ID	string	✅ Sim	ID do workspace onde a tabela do dicionário está localizada.
Nome da Tabela	string	✅ Sim	Nome da tabela do dicionário onde os registros estão armazenados.

3️⃣ Adicionar Filtros (Opcional)

Além dos campos obrigatórios, você pode definir filtros para refinar a busca.

Filtro	Tipo de Dado	Descrição
Campos Personalizados	collection	Permite selecionar quais campos do dicionário devem ser usados como filtro.
Método de Filtro	string (fields ou query)	Define se a busca será baseada em campos específicos ou em query string.
Ordenação	string (asc ou desc)	Define a ordem crescente (asc) ou decrescente (desc) dos resultados.
Página	number	Permite definir a página da busca para paginação dos resultados.
Limite	number	Define quantos registros devem ser retornados por vez.

⚠️ Atenção!

• Se nenhum filtro for aplicado, a busca retornará todos os registros da tabela.

• Utilize a paginação para evitar retorno excessivo de registros.

4️⃣ Salvar a Configuração

Após preencher os campos e definir os filtros, clique no botão "Salvar" ✅.

Agora, sempre que essa automação for acionada, os registros filtrados serão retornados automaticamente.

📌 Exemplo de Uso no Fluxo de Automação

📊 Cenário: Você deseja buscar todos os clientes cadastrados na tabela "Clientes" do dicionário que estão no status "Ativo".

🔹 Fluxo de automação:

1️⃣ Bloco 1 → Disparar uma automação sempre que um cliente realizar uma ação. 2️⃣ Bloco 2 → Buscar no dicionário todos os clientes com status "Ativo". 3️⃣ Bloco 3 → Enviar uma mensagem personalizada para esses clientes.

🚀 Resultado: A automação filtra e retorna apenas os registros relevantes, permitindo comunicações direcionadas e segmentadas.

🎉 Conclusão

A operação Buscar Registros por Filtro no Dicionário é ideal para encontrar informações específicas de maneira dinâmica e personalizada. Com essa funcionalidade, você pode otimizar buscas e tornar suas automações ainda mais inteligentes no Hablla Studio.

Se precisar de mais suporte, entre em contato com nossa equipe! 🚀