Tópico Nº: 59 : - Título: Criação de relatórios personalizados

Aviso: este módulo está disponível somente na versão GFILPLus.

Menu de acesso: a partir da tela principal, clique em "Relatórios -> Customizados", ou pelas tecla de atalho CTRL+Z

Antes de você começar a utilizar este módulo e criar relatórios com SQL personalizados, é importante estar ciente de que faz-se necessário um conhecimento básico em estrutura de banco de dados Firebird e, principalmente, conhecimento em linguagem SQL.
Se você não possuir conhecimento nessa área, uma revenda GFIL poderá lhe auxiliar.

Por outro lado, o GFIL traz alguns SQL (modelos) prontos. Para utilizar esses modelos não é preciso nenhum conhecimento SQL, pois basta copiar e colar.
Você também pode sugerir ao desenvolvedor GFIL para incluir novos na lista de modelos. Para isso siga os passos do tópico 23 deste manual de ajuda.

A utilização deste módulo é relativamente simples. Todas as opções são bastante intuitivas.
Basicamente o que você precisa fazer é indicar o SQL, clicar no botão para processar esse SQL, o que trará os campos da consulta para o grid "Campos Gerados Pelo SQL". Em seguida inclua cada campo que desejar, na "Composição do Relatório". Aí é só imprimir.

Informações importantes

1. Os dados retornados por este módulo serão sempre somente os da filial logada. Se você tiver mais de uma filial cadastrada no mesmo banco de dados, JAMAIS tente listar dados de outra filial, pois podem ocorrer graves problemas com os dados;

2. Para "wheres" com data, utilize os parâmetros :DATA_INICIO e :DATA_FIM. Quando a consulta desse SQL for processada, o GFIL substituirá esses parâmetros pelos valores indicados nos campos "Data Inicial" e "Data Final" que estão na tela;

3. Sempre que precisar filtrar dados e/ou relacionar joins entre tabelas pelo campo FILIAL, o parâmetro :FILIAL deverá, obrigatoriamente, estar contido no SQL. O GFIL substituirá esse parâmetro pelo código da filial logada.
   Obs.: esse parâmetro não é obrigatório se sua base de dados tem apenas uma empresa/filial cadastrada;

4. Para utilizar imagens no cabeçalho, essas imagens devem estar previamente cadastradas no GFIL. Veja como fazer esse cadastramento no tópico 93 deste manual de ajuda;

5. Como já foi detalhado nos itens anteriores, quando houver um parâmetro na sentença SQL, o GFIL substituirá automaticamente os parâmetros :DATA_INICIO, :DATA_FIM e :FILIAL. Mas você pode incluir qualquer outro parâmetro na sentença. Ao rodar o SQL, o GFIL vai perguntar qual valor deseja atribuir a cada parâmetro e substituirá no SQL final;

6. Quando ocorrer a situação do item 4 acima, ou seja, que você definiu um outro parâmetro no SQL, ao rodar ele, o GFIL vai solicitar que o valor dele seja informado. Se o parêmetro for do tipo texto você deve informar o valor entre aspas simples:
   Exemplos: para campos do tipo VARCHAR, CHAR, etc, informe assim: 'dado'; para valores inteiros informe apenas o número, sem formatação, assim: 10; e, para campos do tipo decimal, informe 10,00;

7. Nessa tela você ainda tem disponível a aba "Estrutura do BD", onde poderá visualizar todas as tabelas com respectivos campos e seus tipos;

8. Na configuração do campo a incluir na composição, o valor de "Tamanho" não é o tamanho do campo no banco de dados, mas sim, o width dele no relatório. Na dúvida, faça tentativas colocando tamanhos diferentes e testando a impressão;

9. No menu "Opções" você consegue salvar um layout em arquivo e também importar layouts de arquivo. Essa importação precisa obrigatoriamente ser de um arquivo gerado pelo próprio GFIL (opção exportar);

10. Caso pretenda utilizar a mesma configuração para impressões recorrentes, recomenda-se salvar o layout dando-lhe uma descrição. Aí, no futuro é só selecionar o layout e já imprimir o relatório;

11. Quer liberar um operador sem status de administrador para manusear este módulo? Atribua o poder "Pode executar SQL personalizados" dos "Poderes administrativos" do cadastro do operador.