# Funções Básicas 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. É especialmente útil para usuários com conhecimento prévio em consulta de dados, que desejam criar relatórios personalizados a partir das informações contidas na base de dados do sistema.
## Funcionalidades Principais
### Formulários Pivot e Campos
**Formulários Pivot**: Representam a tabela inicial da qual os dados são extraídos. 
- **Exemplo:** Formulário "Clientes"

**Campos**: São os dados específicos desejados nos relatórios. 
- **Exemplos:** “Nome”, “CPF”, “Endereço”
### Junções (Formulários Ancestrais)
As **junções**, também conhecidas como **formulários ancestrais**, permitem combinar dados de diferentes formulários (tabelas) em uma única consulta.

- **Exemplo:** Para incluir detalhes do produto no relatório de vendas, pode-se criar uma junção entre o formulário **“Venda”** e o formulário **“Produtos”**.
### Agrupamentos e Ordenação
**Agrupamentos**: Permitem consolidar dados com base em critérios específicos.

**Ordenação**: Define a sequência em que os resultados são apresentados.

- **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**: Condições que restringem os dados retornados pela consulta. Os filtros disponibiliza duas opções, sendo elas: 

- **E:** Com esta opção, o sistema considerará apenas as regras aplicadas (Verdadeiro).
- **OU:** Ao selecionar esta opção, o sistema considerará ambas as regras aplicadas.
  
**Funções de Tratamento**: Manipular os dados para a apresentação dos resultados 

- **Exemplo:** Aplicar um filtro para mostrar apenas vendas acima de R$ 1000 e usar uma função de tratamento para formatar datas no padrão dd/mm/aaaa.
### 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.
## Caso de Uso: Análise de Desempenho de Vendas por Região
### Cenário 
Quando for necessário gerar um relatório para analisar o desempenho de vendas por região, identificando os produtos mais vendidos e os vendedores de melhor performance, é possível estruturar a consulta da seguinte forma:
### Passo a Passo: Como Criar Query Builder
1. No campo **"Selecionar o formulário Pivot"**, escolha o Pivot **"Venda"**.
2. Arraste os campos para a coluna **"Campos (fields)"** da tabela. Exemplo:
    - **ID**: Exibe os identificadores das vendas no relatório.
    - **Data de emissão**: Exibe a data de emissão da venda, e é possível definir o período desejado.
    - **Valor Total**: Exibe o valor total da venda.
3. Na seção **"Formulário Ancestrais"**, será listado os formulários para junção. Exemplo:  
	- Para filtrar clientes por região, arraste o formulário **"Clientes"** para a coluna **"Junções (Joins)"** da tabela.
4. Na seção **"Clientes"**, arraste os campos para a coluna **"Campos (fields)"**. Exemplo:
    - **Cidade**: Permite filtrar os clientes por cidade.
    - **Razão social/Nome**: Exibe o nome ou razão social dos clientes.
5. Defina os filtros para refinar o relatório, para isso, clique no ícone de **"Funil"** na barra principal. Na janela de filtros, defina as opções desejadas. Exemplo:
    - Selecione **"Cliente (Cidade)"**, escolha **"Igual"** e insira a cidade desejada (por exemplo: **Chapecó**).
    - Após definir os filtros, clique em **"Aplicar"**.
6. Após definir os campos e filtros, clique em **"Pré-visualização"** para visualizar as colunas e informações do relatório.
7. Clique em **"Visualização Completa"**, o que direcionará para uma nova tela, onde será possível exportar o relatório nos formatos **PDF** ou **CSV**.
## Fluxo de Trabalho
```mermaid
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]
```
## 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
## Leia Também
- [[visoes query builder|Visões Query Builder]]
- [[habilitar acesso query builder|Habilitar acesso Query Builder]]