# Características Técnicas

## O Data Viewer e a Integração com Outros Produtos Progress que utilizando o banco Oracle(Schema Holder) e Progress

O Data Viewer é um gerador de programas fontes na linguagem Progress, homologado para plataforma de banco Progress ou Oracle, sendo utilizado para emissão de relatórios. É voltado para o usuário final e ou desenvolvedores, e tem como pré-requisito o conhecimento básico do modelo de dados do negócio da empresa. Para usuários do ERP Datasul, EMS2, HR/HCM, EMS5, Datasul 10 ou superior e Magnus considerando que o Data Viewer possua mesma plataforma de banco que o Produto ERP, o Data Viewer possui arquivos de perfis que abreviam a sua configuração e integração com o modelo de dados do negócio da empresa. Para usuários de outros produtos da plataforma Progress ou Schema Holder Oracle, o Data Viewer possui funções de configuração e integração.

## Tipos de Programas de Relatório do Data Viewer

São cinco os tipos de programas de relatório gerados pelo Data Viewer:

Texto ou caractere, para exibição de informações sem elementos gráficos e em formato de listagens.

Exportação, para geração de arquivos textos em forma de registros de uma tabela;

Gráfico Excel, para exibição das informações em formato de gráfico do Microsoft Excel.

Cenários Dinâmicos Excel, para exibição de informações em tabelas dinâmicas e gráficos do Microsoft Excel.

Relatórios Gráficos, para exibição de informações com recursos gráficos e em formato de listagens e ou formulários.

## Formas de Execução e Dispositivos de Saída dos Programas Gerados

Uma vez gerados, os programas de relatório podem ser executados independentemente do Data Viewer. São fontes, que podem ser compilados e ter suas chamadas cadastradas em menus de outros aplicativos. Todos os relatórios permitem selecionar o dispositivo de saída: impressora, vídeo e arquivo em disco.

## Relatórios Gráfico Excel e Cenários Dinâmicos Excel

Os programas de relatórios gerados para Gráficos Excel e Cenários Dinâmicos Excel requerem Microsoft Excel 97 ou superior, e Microsoft Office 2000 ou superior respectivamente.

## Relatórios Gráfico com opção de Código de Barras

Os programas de relatórios Gráficos permitem configurar os campos do banco de dados e campos calculados inclusos no layout, para serem visualizados no formato de código de barras, permitindo que as informações desses campos possam ser interpretadas por leitores ópticos quando da listagem do relatório.

## Relatórios Texto com opção de arquivo HTML

Quando selecionado o perfil EMS 2.0 para um programa de relatório do tipo texto, o Data Viewer permite parametrizar para geração do programa, uma opção de saída do relatório em arquivo no formato HTML. Em tempo de execução do programa, o usuário poderá optar, na pasta impressão, pela saída em arquivo no formato texto ou HTML. Relatórios do tipo Exportação, Gráfico Excel, Cenários Dinâmicos e Relatórios Gráficos não possuem essa opção.

## Interface web

Quando selecionado o perfil EMS 2.0 para um programa de relatório do tipo texto, o Data Viewer permite a geração de uma interface web para execução do programa por intermédio da Função Geração WEB. Relatórios do tipo Exportação, Gráfico Excel, Cenários Dinâmicos e Relatórios Gráficos não possuem essa opção.

## Interface WebDesk

Os relatórios para execução em ambiente Web, gerados hoje a partir do DataViewer 3.00, são fortemente dependentes da estrutura fornecida pelo EMS Web Access. Com o objetivo de minimizar essa limitação, o Data Viewer oferece o perfil WebDesk, com o qual o usuário tem a possibilidade de gerar relatórios a serem executados diretamente no ambiente do WebDesk 2.03, requerendo o mínimo de intervenção possível. Diferentemente da interface web, o perfil WebDesk permite a geração de relatórios do tipo: Texto, Exportação, Gráfico Excel, Cenários Dinâmicos e Relatórios Gráficos.

## Application Programming Interface (API)

Uma API (Application Programming Interface) é um programa que recebe parâmetros específicos e executa uma tarefa determinada nos produtos Datasul. A tarefa pode ser uma atualização ou pode retornar informações, resultados de um cálculo ou um gráfico. Uma API é uma interface aberta para as funções de negócio.

O esquema de funcionamento de uma API é o seguinte: a partir da chamada da API, com a entrada dos parâmetros correspondentes ou de dados para uma atualização, podem ocorrer três situações:

· A API pode fazer um acesso ao produto Datasul e receber uma resposta que pode ser dados lidos da base ou o resultado de alguma função, que é repassado para o programa chamador.

· A API pode fazer uma extração de dados, gerando um gráfico, um relatório ou uma consulta.

· A API pode executar uma função, por exemplo de eliminação de dados, e retornar se a execução foi correta "OK" ou incorreta "NOK".

Os programas de relatório gerados pelo Data Viewer utilizam-se das APIs específicas de cada produto ERP Datasul para extração de dados, estas APIs encontram-se no diretório GRAPI. Veja detalhes no procedimento Como Compilar o Diretório GRAPI.

## Fonte Livre

Fonte Livre é uma função do Data Viewer que permite ao usuário inserir pequenos pedaços de código Progress de sua autoria em determinados pontos do programa de relatório que será gerado. Para utilização do Fonte Livre, o usuário desenvolvedor precisa conhecer a linguagem de programação Progress. Além disso, o tamanho do Fonte Livre é bastante limitado. Codificações mais extensas poderão utilizar-se da Função Manutenção de Procedures Internas.

## Pontos de Inserção de Fontes Livres

O Data Viewer possui 26 Pontos de Inserção de Fontes Livres dentro do código fonte que é gerado para cada programa de relatório. Existe uma limitação de tamanho, de 2000 caracteres por fonte livre por ponto de inserção para banco Progress e 1000 caracteres para banco Oracle.

## Processo Data Viewer de Geração e Execução de Relatórios

Com o advento dos Relatórios Gráficos, o Data Viewer ganhou novos componentes de tecnologia capazes de caracterizar um ambiente próprio para esse tipo de relatórios. Assim temos um ambiente Data Viewer para Relatórios Texto, Exportação, Gráfico Excel e Cenários Dinâmicos Excel, e outro para Relatórios Gráficos.

A figura abaixo ilustra na sua parte central, as funções do processo básico de geração e execução de relatórios do Data Viewer; na parte superior, o ambiente de Relatórios Textos; e na parte inferior o ambiente de Relatórios Gráficos.

Relatórios Gráficos geram, além dos programas de interface “.W” e lógica “RP.P” comum aos dois ambientes, um arquivo XML, “Layout.XML”, com as características do layout definido por intermédio do “Data Viewer Layout Editor”. O conjunto de métodos da Biblioteca de Funções do Data Viewer recebe os dados processados pelo programa “RP.P” e o layout definido em “Layout.XML” para poder produzir o arquivo “.FO” que é uma especialização do padrão XML para formulários gráficos. Por intermédio de um Formatting Objects Processor (FOP), programa Java que processa o arquivo “.FO”, o relatório é renderizado em um arquivo no formato PDF.

Importante:
A biblioteca de funções, além de estar disponível no DV (arquivos do diretório DVRT), está disponível também para os produtos EMS2, EMS5, HR/HCM e Datasul 10+ permitindo assim que os relatórios gerados possam ser executados nos ambientes de produção desses respectivos produtos diretamente, sem necessidade de utilizar o ambiente do Data Viewer. Qualquer outro produto que deseja executar relatórios gráficos gerados pelo Data Viewer precisa ter acesso ao ambiente DVRT no propath para a correta execução do mesmo.

## Geração de Relatórios Multiidioma

A técnica de Multiidioma do Datasul EMS 2 e Datasul HR/HCM permite que o usuário, em tempo de execução, selecione o idioma de visualização do relatório gerado. Os idiomas possíveis para geração do relatório são: Português, Inglês e Espanhol. A definição da utilização ou não dessa técnica para o relatório é feita por intermédio da Função Geração de Menu (GR0146).

Importante:
Essa funcionalidade somente é utilizada quando o relatório é executado em ambientes dos produtos Datasul EMS 2.06B, Datasul HCM 2.08, Datasul HCM 2.09 e Datasul 10 ou superior.

| Topo |