Histórico da Página

O DataSet compreende O Report é a entidade responsável pelo processamento das informações. É a inteligência do Report sendo a entidade produtora de resultados capazes de serem processados pelos componentes do Layout para a posterior exibição.

Datasets são criados quando é necessário um processamento prévio das informações que serão populadas em uma WorkTable contendo os resultados para posterior pesquisa que será realizada pelo Layout em conjunto com o TOTVS | WebViewer.

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çãoO desenvolvimento de um Dataset é feito em ADVPL utilizando a metalinguagem para Datasets BIRT. Após o Dataset ser compilado em um repositório de objetos, estará disponível para ser adicionado a um Layout através do TOTVS | Developer Studio.

Estrutura de um Report

O Dataset é formado de diversos componentes utilizados para acesso a informações:

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;
• Title: Título do Dataset;
• Description: Descrição do Dataset;
• Pergunte: Utilizado para indicar o código de grupo de Perguntas Padrão (SX1) quando utilizado;
• Parameters: Conjunto de parâmetros quando necessário e não utilizadas Perguntas Padrões (SX1);
• Columns: Define a estrutura do arquivo de saída. Esta estrutura é utilizada para definir a WorkTable (tabela temporária) a ser criada no Banco de Dados que conterá os resultados do processamento do Dataset para posterior pesquisa;
• Query: Define a estrutura SQL de pesquisa na WorkTable no momento da exibição do Dataset pelo TOTVS | WebViewer, no momento da renderização do Layout;
• Process: Início do código ADVPL que será executado na chamada do Dataset.

Exemplo de um Report

Criaremos um exemplo de um Report simples que solicita alguns parâmetros baseado em um Grupo de Perguntas do SX1 e grava na WorkTable os valores digitados nestes parâmetros.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.