02.4 BIRT| Report

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:

#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.