O DataSet compreende 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.

O 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:

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

#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

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.