Gerador de Consultas e Relatórios¶
Utilitários > Gerador de Consultas e Relatórios
O que é¶
O Gerador de Consultas e Relatórios é a ferramenta de desenvolvimento de relatórios customizados do sistema. Permite criar, editar, testar e salvar relatórios baseados em SQL diretamente no ambiente do ERP, sem necessidade de ferramentas externas. Os relatórios criados aqui ficam disponíveis no módulo Relatórios Configurados para uso pelos operadores.
Como acessar¶
No menu principal, clique em Utilitários → Gerador de Consultas e Relatórios.
Acesso restrito a usuários com nível de permissão administrativa.
Onde impacta o sistema¶
- Lê e grava na tabela
CONSRELA(mesma tabela usada pelos Relatórios Configurados) - Sub-tabelas:
SELECORE(campos de seleção),CONDCORE(condições),ORDECORE(ordenação),PARACORE(parâmetros) - Relatórios criados ficam imediatamente disponíveis para os usuários com permissão
Estrutura de um relatório¶
Cada relatório possui quatro seções configuráveis:
| Seção | O que define |
|---|---|
Seleção (SELECORE) |
Campos do SELECT: tabela, campo, título, tamanho, coluna, máscara, totalização |
Condições (CONDCORE) |
Cláusulas WHERE: campo1, operador, campo2, tipo |
Ordenação (ORDECORE) |
Cláusulas ORDER BY: campo, quebra de grupo |
Parâmetros (PARACORE) |
Parâmetros interativos pedidos ao usuário antes de gerar: campo, tipo, operador, máscara, título |
Editor SQL¶
O módulo inclui um editor SQL completo (SynEdit) com:
- Destaque de sintaxe SQL (palavras-chave em cores diferentes)
- Autocomplete (SynCompletionProposal) com sugestão de tabelas e campos do banco
- Teste de consulta — execute o SQL diretamente para verificar o resultado antes de salvar
Configuração do relatório¶
| Campo | Descrição |
|---|---|
| Nome | Nome exibido no módulo Relatórios Configurados |
| Tipo | C = caractere (PrintFast), F = FastReport (gráfico/template) |
| Largura | Largura de impressão em colunas (para tipo caractere) |
| Nível | Nível mínimo de acesso para executar o relatório |
| Usuários | Lista de usuários com acesso (separados por vírgula) |
| Sistema | Módulo/sistema ao qual o relatório pertence |
| Imprimir cabeçalho | Se deve imprimir cabeçalho padrão do sistema |
| Impressora padrão | Impressora pré-selecionada para este relatório |
Gerenciar permissões¶
O menu de contexto Permissões de Usuário permite definir quais usuários podem acessar o relatório, sem precisar editar o campo manualmente.
Salvar / Carregar arquivo¶
| Ação | Como fazer |
|---|---|
| Salvar como arquivo | SaveDialog1 — salva o relatório em arquivo .rel para transferência entre ambientes |
| Carregar de arquivo | OpenDialog1 — importa um arquivo .rel criado em outro ambiente |
Atalhos de teclado¶
| Ação | Atalho |
|---|---|
| Testar SQL | Botão de execução no editor |
| Gerar relatório | Botão Gerar |
| Salvar | Botão Salvar |
| Salvar como arquivo | Ctrl+S / SaveDialog |
| Fechar | Botão Sair |
Perguntas frequentes¶
Qual a diferença entre tipo Caractere e FastReport? Tipo Caractere usa o motor PrintFast — simples, rápido, adequado para relatórios tabulares em impressoras matriciais ou de texto. Tipo FastReport usa templates gráficos — adequado para relatórios com formatação rica, gráficos, logos e exportação para PDF/XLS.
Como o parâmetro é substituído no SQL?
No SQL, use a tag {CAMPO} onde CAMPO é o campo definido em PARACORE. Antes de executar, o sistema pede o valor ao usuário e substitui a tag na query.
O relatório que criei não aparece para os usuários — por quê? Verifique o campo Nível e a lista de Usuários. Se o nível estiver alto demais ou o usuário não estiver na lista, o relatório não aparecerá no módulo Relatórios Configurados para aquele perfil.