Relatório Personalizado para usar no Kit

Orientações sobre o desenvolvimento de relatórios para essa rotina.

Guia Desenho

Na tela de Desenho,  Devem ser informados os parâmetros que serão utilizados para filtrar o relatório.  Sobre esses parâmetros é importante ressaltar alguns pontos para que evite a ocorrência de erros ao executar os relatórios pela rotina. Dentre esses pontos temos os seguintes:

  1. Os parâmetros que forem informados na guia Desenho, devem ser informados também no DataPipeline de busca (Figura 'ConstrutorConsulta'), eles devem possuir os mesmos nomes.

  2. Os Parâmetros devem ser informados com o Datatype ‘dtString’, isso se deve ao fator de que o Sistema espera apenas por parâmetros do tipo String;

  3. Os Parâmetros são vinculados ao SQL através do DataPipeline, então para cada parâmetro, deve ser informado qual é o DataPipeline que possui estes parâmetros; 

A Figura abaixo apresenta um exemplo da Interface de Desenho de um relatório. Atualmente está selecionado na guia Desenho e nessa guia é que vamos adicionar os parâmetros e configurá-los, conforme os pontos acima.

Guia Dados

 Nesta guia aparecerá os campos que retornarão do DataPipeline. Para configurar o DataPipeline temos que clicar no ícone com um papel e um lápis.

 A próxima figura mostra um exemplo de uma Consulta SQL feita para retornar os dados que serão usados nos relatórios. O nome da consulta será o nome que será configurado na Opção DataPipeline dos parâmetros na guia Desenho. Aqui temos algumas considerações especiais para os relatórios. 

  1. O cast dos parâmetros é diferente de Oracle para Firebird, verificar a sintaxe correta;

  2. O cast das Datas para ‘VARCHAR’ é estritamente necessário, de modo a enviar uma data como texto para o sistema;

  3. Caso alterar os parâmetros manualmente, onde aparece por exemplo: ‘(COALESCE(CAST(:PARAM AS VARCHAR(1000)), 'T') = 'T'))’, é muito importante não trocar a letra ‘T’. Obs: alguns outros relatórios feitos anteriormente pode estar apenas com ‘’(aspas vazios).

  4. Os filtros/parâmetros obrigatórios para os relatórios emitidos pelo Kit são: Estab, idempregado, idfuncao, idlocal, idvinc e data inicial e final. E importante destacar que outros parâmetros no relatório podem gerar erro de emissão por dentro da rotina, aconselha-se a usar apenas os já citados.

Guia Cálculo

  Nessa guia será configurado um Evento para o Report (o Relatório), esse evento será responsável por não mostrar as caixas de prompt (aquelas nas quais aparecem na tela e deve-se selecionar os dados a serem filtrados). Isso se torna necessário para que no sistema não apareçam as caixas de diálogos na tela ao tentar emitir os relatórios.

         Também recomendo simplesmente copiar este evento de algum outro relatório personalizado que já o possua, pois geralmente ele será igual.