Query Builder
Introdução
O Query Builder é uma ferramenta que permite aos usuários criar consultas personalizadas para acessar informações em um banco de dados através de uma interface visual. Esta documentação visa fornecer uma visão geral das funções básicas do Query Builder, auxiliando os usuários a criar relatórios eficientes e personalizados.
O que é o Query Builder?
O Query Builder é uma ferramenta para construção, manipulação e visualização de consultas sobre o banco de dados do sistema. O Query builder é essencial para usuários que desejam criar relatórios personalizados e utilizá-los como fonte para tomada de decisões (Data-driven).
Funcionalidades Principais
Formulários Pivot
O formulário Pivot representa a informação mais relevante do relatório, pois é a partir dele que o relatório será estruturado e interpretado no sistema.
Exemplo:
“Gostaria de verificar os dados financeiros que meu provedor irá receber, mas não sei por onde começar.”
Com base na solicitação do usuário, ele deseja visualizar as informações de recebimentos, que correspondem ao formulário de Contas a Receber no sistema. Assim, o relatório deve ser iniciado pelo pivot de Contas a Receber. A lógica de construção do relatório permanece a mesma, sempre começando pelo pivot relacionado ao objetivo final do usuário.
Campos
Os campos correspondem aos dados utilizados na configuração das colunas do relatório. A partir deles, você pode determinar quais informações serão exibidas e definir a ordem das colunas. É possível reordenar as colunas do relatório arrastando o campo desejado para a posição desejada, segurando-o e movendo-o para o local adequado. Além disso, os campos oferecem a opção de alterar a exibição, incluindo o nome que aparece como título da coluna, bem como o formato dos dados, como o ano ou o estilo de data (estadunidense ou brasileiro). Para fazer essas alterações, clique no ícone de engrenagem, ajuste as configurações conforme necessário e salve as modificações.
Importante!
Cada campo possui uma lógica de funcionamento específica. Dessa forma, campos numéricos podem ser utilizados para aplicações envolvendo dados numéricos, como datas, contagens, somas, entre outros. Já os campos de descrição devem ser utilizados exclusivamente para alterações relacionadas ao conteúdo textual, sem alteração de dados relacionados a datas ou valores numéricos.
Junções (Formulários Ancestrais)
As junções, também referidas como formulários ancestrais do sistema, representam registros prévios que antecedem ou estão relacionados a determinado dado no relatório. Por exemplo, para emitir um contrato, é necessário, primeiramente, realizar o cadastro do cliente; assim, o formulário de cadastro constitui a junção ancestral do contrato.
As junções, ou formulários ancestrais, permitem a integração de dados provenientes de diferentes formulários (ou tabelas) em uma única consulta, facilitando a análise e a geração de relatórios mais completos.
Somente os formulários relacionados no sistema poderão ser unificados a partir do mesmo relatório no Query Builder.
Agrupamentos e Ordenação
Agrupamentos: Permitem agrupar dados com base em critérios específicos. Ordenação: Estabelece a sequência na qual os resultados são exibidos, podendo ser por ordem alfabética (A a Z) ou por valor numérico, conforme o critério definido na coluna correspondente.
- Exemplo: Agrupar vendas por mês e ordenar por valor total decrescente para identificar os meses mais lucrativos.
Filtros e Funções de Tratamento
Filtros: recursos utilizados para refinar os dados retornados por uma consulta. Os filtros oferecem duas opções de configuração:
- E: Com esta configuração, o sistema considera apenas as regras aplicadas, exigindo que todas sejam satisfeitas (condição verdadeira).
- OU: Ao selecionar esta opção, o sistema considera múltiplas regras, permitindo que pelo menos uma delas seja atendida. Funções de Tratamento: Manipular os dados para a apresentação dos resultados.
Exemplo: Filtros utilizando a regra OU
Para filtrar dois planos de vendas diferentes no mesmo relatório, o usuário deve criar um novo grupo de filtros. Dentro deste grupo, deve clicar em Nova Regra, selecionar a opção Ou em azul e, então, aplicar os filtros desejados dentro do grupo.
Não há limitação no número de regras que podem ser adicionadas a um grupo de filtros, permitindo filtrar dados do mesmo tipo várias vezes.
Por fim, é fundamental sempre clicar em Aplicar para que as configurações de filtro sejam salvas corretamente.
Subquery
Subquery são consultas aninhadas dentro de uma consulta principal, permitindo operações mais complexas.
- Exemplo: Usar uma subquery para encontrar clientes que fizeram compras acima da média geral de vendas.
Fluxo de Trabalho
graph TD Start[Início] --> A[Escolher Formulário Pivot] A --> B[Selecionar Campos] B --> C[Definir Junções] C --> D[Aplicar Filtros] D --> E[Executar Consulta] E --> F[Fim]
Quer saber mais, assista o Webinar: Construção de relatórios personalizados com o Query Builder
Considerações Finais
O Query Builder é uma ferramenta versátil que permite aos usuários extrair informações valiosas do banco de dados de forma eficiente. Ao dominar suas funções básicas, os usuários podem criar relatórios personalizados e obter informações importantes para a tomada de decisões. Para aprofundar seus conhecimentos, recomenda-se explorar cada função detalhadamente e praticar com diferentes cenários de consulta.
Etiquetas
QueryBuilder ConsultasPersonalizadas BancoDeDados Relatorios
