Exibir origem

O Report é a entidade responsável pela interligação e execução de um Layout e seus Datasets pelo Protheus.

Pelo Report podemos definir um Layout a ser executado e alguns parâmetros de exibição com a chamada da função.

Estrutura de um Report

Para definir um Report podemos utilizar alguns comandos da metalinguagem do Birt:

NAME: Nome do Report;
TITLE: Título do Report;
ASKPAR: Indica se exibe a janela de solicitação de perguntas antes da janela de configuração de impressão
EXCLUSIVE: Quando utilizado, Datasets do Report que utilizem perguntas beaseadas no arquivo de Perguntas Padráo (SX1) que se repetem, somente serão exibidos uma única vez;

Após a definição, para ativar-se a impressão do Report, devem ser utilizados os comandos:

ACTIVATE REPORT: Comando utilizado para iniciar a execução do Report;
LAYOUT: Informa o arquivo .rptdesign previamente desenvolvido e compilado no RPO para processamento do Report;
FORMAT: Define o modo de visualização do Report, que podem ser HTML ou PDF;
- HTML: Demonstra o resultado em tela, pelo navegador definido como padrão no sistema operacional;
- PDF: Executa o processamento do Report pelo navegador e disponibiliza para download um arquivo no formato Pdf com o resultado do processamento;

Exemplo de um Report

Criaremos um exemplo de um Report simples que solicita os parâmetros dos Datasets no momento de sua execução:

Para desenvolvimento sem chave de compilação, trocar no exemplo abaixo o comando DEFINE REPORT por DEFINE USER_REPORT

Necessário fontes BIRTReport.prw, TDSProcess.prw e BIRTDataset.prw com data igual ou superior a 06/04/2016

#Include 'Protheus.ch'
#Include 'tdsBirt.ch'
 
User Function TESTEREP()
 
Local oReport

DEFINE REPORT oReport NAME REPTST1 TITLE "Teste de Report" ASKPAR EXCLUSIVE
 
ACTIVATE REPORT oReport LAYOUT REPTST1 FORMAT HTML

Return

Aplicação

Após compilada a função, o Report poderá ser acessado via menu, bastando cadastrar a função U_TESTEREP() no menu desejado.