Manual de Referncia

Data Viewer 2.02

No homologado

Copyright 1998, 1999 DATASUL S.A. Todos os direitos reservados.

Nenhuma parte deste documento pode ser copiada, reproduzida, traduzida ou
transmitida por qualquer meio eletrnico ou mecnico, na sua totalidade ou
em parte, sem a prvia autorizao escrita da DATASUL S.A., que reserva-se
o direito de efetuar alteraes sem aviso prvio. A DATASUL S.A no assume
nenhuma responsabilidade pelas conseqncias de quaisquer erros ou
inexatides que possam aparecer neste documento.
DATASUL S.A.
Av. Santos Dumont, 831, Joinville, SC, CEP 89.222-900

2.00 14/07/99

ndice
Prefcio.............................................................................................. iii
CAPTULO 1 Introduo .................................................................... 1
Integrao com Outros Mdulos....................................................................2

CAPTULO 2 Pblico Alvo ................................................................. 5

CAPTULO 3 Processo Caractersticas Tcnicas ............................ 7
CAPTULO 4 Processo Acesso ao Data Viewer............................... 9
Funo Acessando o Data Viewer................................................................9

CAPTULO 5 Processo Relatrios .................................................. 15

Funo
Funo
Funo
Funo
Funo

Manuteno do Relatrio...............................................................15
Tabelas do Relatrio......................................................................19
Acompanhamento Processo Relatrio ..........................................21
Atualizar .........................................................................................21
Desfazer.........................................................................................22

CAPTULO 6 Processo Colunas ..................................................... 23

Funo
Funo
Funo
Funo
Funo

Campos do Relatrio .....................................................................23

Campos Calculados.......................................................................25
Propriedades dos Campos do Relatrio........................................29
Reordenar Campos do Relatrio ...................................................31
Grupos do Relatrio.......................................................................32

CAPTULO 7 Processo Geral .......................................................... 37

Funo
Funo
Funo
Funo

Classificaes do Relatrio............................................................37
Selees do Relatrio....................................................................39
Manuteno de Variveis ..............................................................41
Parmetros do Relatrio ................................................................45

ii

Funo
Funo
Funo
Funo
Funo

Totais do Relatrio .........................................................................47

Manuteno de Clculos ...............................................................48
Fonte Livre .....................................................................................51
Parmetros de Entrada ..................................................................53
Manuteno de Procedures Internas.............................................54

CAPTULO 8 Processo Gerao..................................................... 57

Funo
Funo
Funo
Funo

Teste ..............................................................................................57
Fonte ..............................................................................................57
Gerao WEB ................................................................................58
Editor ..............................................................................................60

CAPTULO 9 Processo Administrao........................................... 61

Funo
Funo
Funo
Funo
Funo
Funo
Funo
Funo
Funo
Funo
Funo
Funo
Funo
Funo
Funo
Funo
Funo

Administrar Tabelas .......................................................................61

Administrar Relacionamentos ........................................................63
Manter Relacionamentos ...............................................................63
Manter Tabelas ..............................................................................65
Manter Campos..............................................................................67
Manter Usurios.............................................................................70
Alterar Usurio Relatrio................................................................73
Permisses Usurios (Tabelas / Campos) ....................................74
Manter Perfis..................................................................................75
Exportar Perfil ................................................................................76
Importar Perfil.................................................................................77
Manter Blocos x Perfil ....................................................................78
Dados (Exportar)............................................................................80
Dados (Importar) ............................................................................81
Gerao (Relatrios)......................................................................82
Gerao (Menu) .............................................................................83
ProTools .........................................................................................83

CAPTULO 10 Processo Formato e Impresso de Valores dos

Atributos e Variveis ....................................................................... 85

iii

Prefcio
Os produtos DATASUL so conjuntos de aplicaes relacionadas que
permitem interligar toda uma empresa, resultando em um sistema integrado
de gesto empresarial.
Cada produto estruturado em aplicativos ou sistemas (como Controladoria e
Finanas ou Manufatura), que por sua vez so compostos por mdulos
(como Contabilidade ou Controle da Produo), que implementam uma srie
de funes (como a Movimentao Contbil ou a Manuteno de Ordens de
Produo).
O Manual de Referncia de Mdulo visa abranger toda a informao
necessria para compreender os mdulos que compem os produtos
DATASUL, bem como solucionar dvidas relativas ao seu funcionamento.
uma obra de referncia j que seu principal objetivo a consulta para
obteno de informaes, ao contrrio de um livro ou outro tipo de manual
que lido do incio ao fim.
Para cada mdulo so definidas suas principais reas funcionais. Uma rea
funcional um conjunto identificado de comportamentos relacionados. Neste
manual, cada rea funcional dentro de um mdulo chamada de processo e
cada comportamento que compem esta rea funcional chamado de
funo.
Importante
As caractersticas do mdulo apresentado neste manual so suas
caractersticas bsicas. Tomando-as como base, o mdulo pode ser
configurado para qualquer tipo de empresa.
Todos os dados utilizados nos relatrios e telas do DATASUL EMS
apresentados neste manual so fictcios.

CAPTULO 1

Introduo
Objetivo

O Manual de Referncia do Data Viewer 2.02 tem como objetivo de mostrar

ao usurio como trabalhar com o Data Viewer 2.02. Atravs de telas,
exemplos, etc., deve ser mostrado os passos de elaborao de relatrios,
assim como poder modificar os mesmo ou at elimin-los.
O Data Viewer uma ferramenta para extrao de dados, voltada ao usurio
final, que possibilita a elaborao de relatrios e exportao de dados atravs
da gerao de um programa com cdigo fonte em Progress de interface
grfica.
Sua principal finalidade auxiliar o usurio em suas tarefas do dia-a-dia,
permitindo confeccionar relatrios dentro de necessidades especficas
obedecendo as limitaes da ferramenta.

Caractersticas

As principais caractersticas do mdulo so:

Ambiente Windows 95;

Armazena todas as definies dos bancos de dados a serem utilizados,

em uma base prpria;

Permite a agregao da bases especficas;

Disponibiliza manuteno no relacionamento das tabelas a serem

utilizadas;

Utiliza rtulos do dicionrio de dados, que podem ser alterados pelo

usurio;

Permite que o mesmo relatrio seja gerado em forma de listagem ou

exportao de dados;

Fcil manipulao dos objetos no layout do relatrio;

Viso geral

Insero de cdigo fonte Progress livre para o usurio em posies

especficas;

Segurana a nvel de usurio para os relatrios e s tabelas;

Determinao da classificao;

Totais e clculos variados, com frmulas automticas ou definidas pelo

usurio;

Seleo e parmetros fixos ou em tempo de execuo;

Vrios blocos de dados distintos;

Fonte gerado legvel e modificvel.

Esta ferramenta prpria para gerao de relatrios e listagens, exportaes

e grficos. Assemelha-se a outras ferramentas de mercado como o Crystal
Reports e Report Builder. A partir de uma base de dados, informaes so
extradas, selecionadas, comparadas , utilizadas na busca de outras
informaes, calculadas e por fim exibidas.

Data Viewer

Criao do
Fonte
(.W e .P)

2.02

Compilao do
Fonte
Programa
Fonte

RCODE

Integrao com Outros Mdulos

A integrao do Data Viewer com outros produtos Datasul feita atravs de
APIs (Aplication Program Interface). Estas APIs so localizadas em pontos
estratgicos e realizam operaes necessrias para o produto para o qual o
programa est sendo criado. Este conjunto de APIs so denominados
PERFIL.
Para cada produto Datasul existe um PERFIL prprio para atender as
caractersticas do produto.
Existe tambm um Perfil padro que tem como finalidade atender
necessidades bsicas dos programas criados, sem necessariamente estarem
ligados a um produto Datasul.
A integrao do Data Viewer com os demais produtos Datasul, necessita
tambm dos relatrios padro e tabelas/relacionamentos dos bancos do
produto. Desta maneira o usurio possui os relatrios padro para utilizar uma

CAPTULO 1

Introduo

cpia destes e construir seus prprios programas, alterando para o que

atende melhor a sua necessidade.
Com as tabelas e relacionamentos, o Data Viewer fica preparado para atender
as caractersticas dos bancos de dados dos produtos. Estes dados existem na
mdia dos respectivos produtos, assim, ao instalar o Data Viewer e carregar
os dados dos produtos, possvel a criao de programas para os mesmos.
O Data Viewer pode gerar relatrios integrados com os seguintes produtos:

Datasul EMS-Framework 2.0;

Datasul EMS-Framework 5.0;

Magnus I

Para que isto seja possvel, necessrio que sejam utilizados os perfis, que
so:

Perfil EMS 2.0 (grbloco2.d);

Perfil EMS 5.0 (grbloco5.d);

Perfil Padro (grbloco.d).

CAPTULO 2

Pblico Alvo
Objetivo

O principal usurio do Data Viewer o usurio final que, na maioria dos

casos, no possui conhecimento tcnico de linguagem de programao. Alm
destes, destinado a profissionais das reas de desenvolvimento, operaes,
assistncia tcnica e parceiros.

Viso geral

A utilizao da ferramenta pode ser exemplificada como:

Datasul: Desenvolvimento de programas para os produtos da Datasul.

Esta funo geralmente realizada por um programador, analista de
sistemas ou ainda algum profissional com conhecimento de linguagem de
programao Progress. A partir do Data Viewer esta tarefa pode ser
realizada por qualquer profissional que possua um mnimo de
informaes sobre as necessidades do programa a ser criado. No
produto Datasul-EMS 2.0, grande parte dos programas de relatrios foram
construdos com o Data Viewer.

Parceiro/rea de Sistemas do Cliente: Utilizao por parceiros de

negcios da Datasul, onde, caso o parceiro possua algum aplicativo com
ou sem integrao com os produtos Datasul, possvel utilizar o Data
Viewer para gerao de programas a partir da base de dados do seu
aplicativo com ou sem relacionamentos com os bancos de dados de
produtos Datasul. Exemplo, um parceiro que possua um sistema de
gesto hospitalar, possvel gerar programas relacionando informaes
de estoque de um produto Datasul, com informaes de consumo de
materiais do aplicativo do parceiro.

Usurio Final: Os relatrios necessrios ao usurio podem ser criados

por ele prprio, mesmo sem conhecimento tcnico, tendo em vista que
no pr-requisito o conhecimento de linguagem de programao
Progress para operar e criar relatrios simples no Data Viewer.

necessrio apenas conhecer as tabelas onde as informaes desejadas

esto armazenadas e conhecer/saber operar os recursos do Data Viewer.

CAPTULO 3

Processo Caractersticas Tcnicas

Objetivo

Este processo tem por objetivo orientar o usurio em relao as

caractersticas tcnicas do Data Viewer.

Viso geral

O Data Viewer um gerador de programas (relatrios, exportao e grfico)

que cria fontes Progress, os quais podem ser executados independentemente
do Data Viewer. Estes programas fontes criados podem ser acoplados em
aplicativos e produtos Progress j existentes sendo estes Datasul ou no.
O Data Viewer possibilita a criao de programas de relatrios e programas
de gerao de grficos via Excel 97. Os programas de relatrios criados
possibilitam ainda sada para impressora, arquivos, tela e HTML.
possvel ainda determinar perfis para a criao dos programas. Desta
maneira possvel manter caractersticas desejadas para todos os programas
construdos utilizando um mesmo perfil. Para criar programas que sigam
padres de produtos Datasul, foram construdas diversas APIs (Aplication
Program Interface). Estas APIs desempenham um papel de interface entre os
programas gerados pelo Data Viewer e os produtos Datasul, levando em
considerao que cada produto possui uma metodologia de desenvolvimento
especfica. As APIs funcionam como uma Caixa Preta, procedendo a
interface do Data Viewer com qualquer outro produto Datasul, bem como
produtos especficos do cliente. Este conjunto de APIs forma o Perfil que
caracteriza um programa construdo.
Para o processo de customizao da rea de fonte livre, alm do fato do
usurio necessitar conhecer a linguagem de programao Progress, est rea
tem um tamanho limitado, impossibilitando um codificao muito extensa.
Entretanto nada impede a utilizao de procedures internas e/ou externas.
O Data Viewer possibilita utilizar os programas criados por ele nos aplicativos
e produtos Progress j existentes, sem a necessidade da existncia do
prprio Data Viewer, isto , o programa criado independente. Desta

maneira, um programa criado pode ser distribudo independente. Esta

possibilidade dada devido ao fato do programa criado ser um fonte
Progress.
A seguir um diagrama ilustrando o fluxo de um programa gerado pelo Data
Viewer e a sua utilizao:

Aplicativo/Produto
Progress

Data Viewer

Gerao do
Fonte Progress

Fonte
Gerado
(.W/.P)
Compilao

Fonte
Compilado
RCODE

Utilizao do
Fonte Progress
Gerado

Fonte
Compilado
RCODE

Cpia do Programa Compilado

CAPTULO 4

Processo Acesso ao Data Viewer

Objetivo

Este processo tem por objetivo orientar o usurio quanto ao acesso.

Funo

Acessando o Data Viewer

Objetivo

Esta funo tem por objetivo mostrar o procedimento de acesso ao Data

Viewer.

Descrio

Ao conectar o Data Viewer se apresenta a tela abaixo, onde necessrio

informar o usurio desejado e sua senha:

Feito isto, ser apresentada a tela principal da ferramenta, disponibilizando

acesso a todas as funes disponveis ao tipo de usurio para confeco dos
relatrios, bem como o layout do relatrio.

10

Boto Relatrios: Este boto tem por objetivo detalhar de que forma
feita a manuteno nos relatrios do usurio no Data Viewer. O mesmo um
atalho para a Funo Manuteno do Relatrio.
Boto Tabelas: Este boto tem por objetivo realizar a manuteno nas
tabelas que fazem parte do relatrio. O mesmo um atalho para a Funo
Tabelas do Relatrio.
Boto Campos: Este boto tem por objetivo realizar a manuteno dos
campos que fazem parte do relatrio. O mesmo um atalho para a Funo
Campos do Relatrio.
Boto Propriedades: Este boto tem por objetivo realizar a manuteno
nas propriedades de um campo do relatrio corrente. O mesmo um atalho
para a Funo Propriedades dos Campos do Relatrio.

CAPTULO 4

Processo Acesso ao Data Viewer

11

Boto Campos Calculados: Este boto tem por objetivo realizar a

manuteno de campos (variveis) que fazem parte do layout do relatrio, ou
seja, no pertencem a nenhuma tabela. O mesmo um atalho para a Funo
Campos Calculados.
Boto Clculos: Este boto tem por objetivo incluir, modificar ou
eliminar os clculos para o relatrio. O mesmo um atalho para a Funo
Manuteno de Clculos.
Boto Variveis: Este boto tem por objetivo realizar a manuteno no
cadastro de variveis utilizadas no relatrio. O mesmo um atalho para a
Funo Manuteno de Variveis.
Boto Seleo: Este boto tem por objetivo realizar a manuteno dos
campos a serem utilizados como seleo para o relatrio (faixa inicial e final).
O mesmo um atalho para a Funo Selees do Relatrio.
Boto Parmetros: Este boto tem por objetivo realizar consultas e
manutenes dos parmetros de leitura das tabelas no processamento do
relatrio. O mesmo um atalho para a Funo Parmetros do Relatrio.
Boto Classificao: Este boto tem por objetivo realizar a manuteno
nas classificaes ou formas de ordenao do relatrio. O mesmo um atalho
para a Funo Classificaes do Relatrio.
Boto Totais: Este boto tem por objetivo realizar a manuteno no
cadastro de totais do relatrio. O mesmo um atalho para a Funo Totais do
Relatrio.
Boto Teste: Este boto tem por objetivo possibilitar a gerao do
programa de interface do relatrio e do programa de processamento, alm de
compilar e executar este programas. O mesmo um atalho para a Funo
Teste.
Boto Gerao: Este boto tem por objetivo possibilitar a gerao do
programa de interface do relatrio e do programa de processamento, alm de
compilar estes programas. O mesmo um atalho para a Funo Fonte.

12

Boto Gerao WEB: Este boto tem por objetivo a Gerao WEB dos
relatrios. Gera a interface, faz a compilao, porm a verificao de erro
(caso ocorra) feita no WEBSpeed. O mesmo um atalho para a Funo
Gerao WEB.
Boto Desfazer: Este boto tem por objetivo questionar o usurio se ele
Deseja desfazer as alteraes ?.. O mesmo um atalho para a Funo
Desfazer.
Boto Atualizar: Este boto tem por objetivo questionar o usurio se ele
Deseja salvar as alteraes ?. O mesmo um atalho para a Funo
Atualizar.
Boto Reordena Campos: Este boto tem por objetivo permitir a
ordenao dos campos no layout do relatrio sem que seja necessrio
arrast-los com o mouse. O mesmo um atalho para a Funo Reordenar
Campos do Relatrio.
Boto Grupos: Este boto tem por objetivo permitir consultas e
atualizaes nos grupos do layout do relatrio. O mesmo um atalho para a
Funo Grupos do Relatrio.
Boto Acompanhamento: Este boto tem por objetivo permitir alterar o
acompanhamento no processamento do relatrio. Seu valor como contedo
inicial um contador dos registros lidos.. O mesmo um atalho para a
Funo Acompanhamento Processo Relatrio.
Boto Editor: Este boto possibilita acessar o Editor Progress O mesmo
um atalho para a Funo Editor.
Boto Parmetros de Entrada: Este boto tem por objetivo permitir ao
usurio incluir, modificar ou eliminar os Parmetros de Entrada. O mesmo
um atalho para a Funo Parmetros de Entrada.
Boto Fonte Livre: Este boto tem por objetivo permitir ao usurio
escrever cdigo Progress ou at mesmo chamar outros programas, includes
em pontos especficos do relatrio. O mesmo um atalho para a Funo
Fonte Livre.

CAPTULO 4

Processo Acesso ao Data Viewer

Boto Procedures Internas: Este boto tem por objetivo permitir ao

usurio incluir, modificar ou eliminar as Procedures Internas para o relatrio.
O mesmo um atalho para a Funo Manuteno de Procedures Internas.

13

15

CAPTULO 5

Processo Relatrios
Objetivo

Este processo tem por objetivo descrever as funes Manuteno de

Relatrios, Tabelas do Relatrio, Acompanhamento Processo Relatrio,
Atualizar e Desfazer.

Funo

Manuteno do Relatrio

Objetivo

Esta funo tem por objetivo detalhar de que forma feita a manuteno nos
relatrios do usurio no Data Viewer.

Descrio

Selecionar no menu do Data Viewer a opo Relatrio, item Relatrio ou

atravs do boto Relatrios. acessado ento, a tela de Manuteno de
Relatrios:

16

Nesta, pode-se incluir, modificar, eliminar, copiar ou filtrar relatrios, como

apresentado na tela a seguir:

CAPTULO 5

Processo Relatrios

17

Campo

Descrio

Relatrio

Inserir o nome do relatrio a ser gerado. Dever ter 6

(seis) caracteres quaisquer no nome, mais 1 (uma) ou 2
(duas) letras, variando de "a" at "bz".
Exemplo:
Relatrio: CDR004a.

Ttulo

Inserir o ttulo para o relatrio que est sendo criado. Este

ttulo ser impresso no cabealho de cada pgina do
relatrio.
Exemplo:
Relatrio: CDR004a
Ttulo: Listagem de Produtos Faturados.

Ttulo Classificao

Inserir o ttulo para identificar a classificao do relatrio.

Exemplo:
Relatrio: CDR004a

18

Ttulo: Listagem de Produtos Faturados

Ttulo Classificao: Por cliente
Nota
Este ttulo de classificao, ser impresso na pgina de
parmetros do relatrio e, tambm ser utilizado no
programa a ser gerado para apresentar todas as
classificaes deste relatrio, podendo-se a partir deste,
identificar e chamar o relatrio pela classificao.

Sistema Relatrio

Informar o nome do sistema ou mdulo a que pertence o

relatrio.
Exemplo Faturamento, Ponto Eletrnico, Contas a
Pagar.

Subdiretrio
Programa

Informar subdiretrio do diretrio de trabalho do usurio

onde sero gravados os programas dos relatrios
gerados.
Exemplo
Subdiretrio Programa: Cdp
Relatrio gerado: c:\relatorios\cdp\cdr004a
Onde c:\relatorios o diretrio de trabalho do usurio, cdp
o subdiretrio programa, cdr004a o programa a
gerado.
Nota

Listagem,
Exportao ou
Grfico

Exportao Tipo
Fixa

Caso este subdiretrio ou estrutura de subdiretrio no

exista, ser criada automaticamente pelo Data Viewer no
momento da gerao do programa do relatrio.
Se o seu contedo for branco, o programa do relatrio
ser gerado no diretrio de trabalho do usurio.
Informar se o relatrio trar como resultado uma listagem,
um arquivo texto como exportao de dados ou um
grfico para visualizao de dados. Para exportao no
traz no resultado cabealho, labels para grupos de dados,
rodap, pgina de parmetros, nem realiza clculos como
mdia, mximo, mnimo, total, etc. Somente ser
considerado como objeto de exportao os que estiverem
no layout do relatrio.
Ser realizada a exportao dos dados para os objetos do
layout do relatrio a um arquivo texto como uma linha
contnua, obedecendo apenas o formato dos objetos do

CAPTULO 5

Processo Relatrios

Exportao Tipo
Separador

Exportao Tipo
Progress

Separador

Perfil
Tipo Grfico
Suporte HTML
Relatrio Padro

19

layout.
Ser realizada a exportao dos dados para os objetos do
layout do relatrio a um arquivo texto separando estes
conforme o separador definido pelo usurio. Obedecendo
ainda quebra de linha por cada grupo do layout do
relatrio.
Ser realizada a exportao dos dados para os objetos do
layout do relatrio a um arquivo texto utilizando-se o
mtodo de exportao do Progress, o qual utiliza como
separador um espao, para campos do tipo caracter so
exportados entre aspas, campos lgicos como yes/no.
Informar o tipo de separador a ser utilizado para identificar
os campos dos dados a serem exportados.
Podem ser: tabulao, espao, sustenido, vrgula, ponto e
vrgula ou outro, a escolha do usurio.
Informar se o relatrio a ser gerado ser utilizando no
produto EMS-200, EMS-500 ou Padro (outro produto).
Informar o tipo de grfico que ser gerado.
Definir se o relatrio gerado poder ter sua sada em
HTML ou no.
Definir se o relatrio ser padro, ou seja, apenas a
empresa criadora do relatrio poder alter-lo.

Nota
Pode-se perfeitamente modificar um relatrio do tipo listagem para um do tipo
exportao e vice-versa, porm, como j mencionado anteriormente, caso a
listagem tenha clculos variados ou totais sero desconsiderados para a
exportao.

Funo

Tabelas do Relatrio

Objetivo

Esta funo tem por objetivo realizar a manuteno nas tabelas que fazem
parte do relatrio.

Descrio

Selecionar no menu do Data Viewer a opo Relatrio, item Tabelas ou por

meio do boto Tabelas, onde existir acesso tela de Tabelas do Relatrio.
Ser apresentado um browse com as tabelas Disponveis e outro com as
Utilizadas, referentes ao banco de dados selecionado, conforme figura a
seguir:

20

Faixa de valores
inicial e final para
leitura das tabelas
disponveis.

Na coluna de Disponveis sero apresentadas todas as tabelas disponveis do

banco de dados selecionado para trabalho. Selecionar a tabela desejada, em
seguida pressionar o boto incluir (>>), onde a tabela passa s Utilizadas.
Para eliminar uma tabela da coluna de Utilizadas, basta selecionar a tabela
desejada, e pressionar o boto de eliminar (<<).
Nota
Quando da incluso de tabelas no relatrio, sero disponibilizadas para uma
prxima incluso neste relatrio, apenas as tabelas que possuam
relacionamentos com uma das tabelas que j fazem parte do relatrio.
Deve-se atentar a ordem em que as tabelas so inclusas no relatrio, pois a
leitura das mesmas para a execuo do relatrio ser feita na mesma
seqncia (cascata), podendo vir a prejudicar a performance ou at mesmo,
no resultado final do relatrio.

CAPTULO 5

Processo Relatrios

Funo

Acompanhamento Processo Relatrio

Objetivo

Esta funo tem por objetivo permitir alterar o acompanhamento no

processamento do relatrio. Seu valor como contedo inicial um contador
dos registros lidos.

Descrio

Selecionar no menu do Data Viewer a opo Relatrio, item

Acompanhamento ou por meio do boto Acompanhamento, onde existir
acesso tela de Acompanhamento Processo Relatrio.

21

Campo

Descrio

Ttulo
Acompanhamento
Atributo
Acompanhamento

Possibilita a alterao do ttulo da tela de acompanhamento no

processamento do relatrio.
Possibilita a alterao do campo da tela de acompanhamento no
processamento do relatrio. Pode ser selecionado o campo de
uma das tabelas utilizadas para fazer o relatrio.

Funo

Atualizar

Objetivo

Esta funo tem por objetivo questionar o usurio se ele Deseja salvar as
alteraes ?.

Descrio

Selecionar no menu do Data Viewer a opo Relatrio, item Atualizar ou

por meio do boto Atualizar, onde existir acesso tela Atualizar.

22

Funo

Desfazer

Objetivo

Esta funo tem por objetivo questionar o usurio se ele Deseja desfazer as
alteraes ?.

Descrio

Selecionar no menu do Data Viewer a opo Relatrio, item Desfazer ou

por meio do boto Desfazer, onde existir acesso tela Desfazer.

23

CAPTULO 6

Processo Colunas
Objetivo

Este processo tem por objetivo descrever as funes Campos do Relatrio,

Campos Calculados, Propriedades, Reordena Campos e Grupos.

Funo

Campos do Relatrio

Objetivo

Esta funo tem por objetivo realizar a manuteno dos campos que fazem
parte do relatrio.

Descrio

Selecionar no menu do Data Viewer a opo Colunas, item Campos ou

atravs do boto Campos. acessado ento, a tela de Campos do
Relatrio, a qual permite incluir ou eliminar campos do relatrio.

24

Incluir campo

Eliminar campo

Na tela anterior, o browse a esquerda apresenta as tabelas selecionadas para

o relatrio, o browse a direita os campos (atributos) que estas possuem e, o
browse inferior os campos que pertencem ao layout do relatrio.
Selecionar os campos que lhe so necessrios (um por vez) e, pressionar o
boto incluir, ou de dois clicks sobre o campo. Depois s pressionar OK.

CAPTULO 6

Processo Colunas

25

Verificando o layout:

Funo

Campos Calculados

Objetivo

Esta funo tem por objetivo realizar a manuteno de campos (variveis) que
fazem parte do layout do relatrio, ou seja, no pertencem a nenhuma tabela.
Podem ter um valor fixo, ou receberem valor durante a execuo do relatrio.

Descrio

Atravs do menu do Data Viewer opo Colunas, item Campos Calculados

ou atravs do boto Campos Calculados, acessado a tela de manuteno
de Campos Calculados.

26

Nesta, clicar sobre o boto incluir para apresentar a seguinte tela:

Campo

Descrio

Atributo

Inserir o nome do atributo (campo calculado) que

ir armazenar um valor informado.
Inserir o ttulo ou descrio para o campo
calculado cadastrado.
Selecionar tipo de informao que ser
armazenado.
As opes disponveis so: caracter, inteiro,

Rtulo
Tipo Dado

CAPTULO 6

Processo Colunas

Formato

27

decimal, data, lgico.

Inserir o formato que ser utilizado para
apresentar o valor do campo calculado.

Pressionando OK e voltando a tela de manuteno de campos calculados,

onde encontra-se o boto Frmula, pode-se atravs deste, cadastrar a
frmula que ir gerar o valor para o campo calculado. Ao clicar neste,
apresentada a seguinte tela:

Na tela de frmula para campos calculados, o browse da direita contm as

tabelas utilizadas no relatrio, o da esquerda, os campos das respectivas
tabelas e no inferior o editor da frmula para o clculo.
No exemplo acima, foi selecionado a tabela ord-prod, o campo qtproduzida e clicado sobre o boto Insere ou efetuado dois cliques sobre o
campo, depois clicado sobre o boto + (somar). Fazer o mesmo com o
campo qt-refugada.

28

Feito isto, basta clicar sobre o boto OK e, sair da tela de manuteno de

campos calculados. Este campo calculado ser apresentado no layout do
relatrio. Veja:

CAPTULO 6

Processo Colunas

29

Ver abaixo o resultado do campo calculado:

Funo

Propriedades dos Campos do Relatrio

Objetivo

Esta funo tem por objetivo realizar a manuteno nas propriedades de um

campo do relatrio corrente. Caso algum dos valores sejam aqui alterados,
no afetar os demais relatrios onde est sendo utilizado.

Descrio

Atravs do menu do Data Viewer opo Colunas, item Propriedades ou

atravs do boto Propriedades, acessado a tela de Propriedades dos
Campos do Relatrio.

30

Campo

Descrio

Tabela

Informar o nome da tabela, caso o objeto selecionado seja um

campo calculado, este aparecer em branco.
Informar o nome do objeto selecionado.
Informar o tipo de dado ou contedo do objeto.

Atributo
Tipo Dado

Exemplo:
Caracter: Conversor de Voltagem
Inteiro: 147
Decimal: 147,36
Data: 21/04/1998
Lgico: Sim

Formato

Informar a forma a qual o contedo do objeto vai ser

apresentado.

Linha

Informar o nmero da linha do campo selecionado no layout do

relatrio.
Informar o nmero da coluna do campo selecionado no layout

Coluna

CAPTULO 6

Processo Colunas

Grupo
Tamanho Col-Label
Tamanho Label
Exibir

Grupo

31

do relatrio.
Informar o nmero do grupo do campo selecionado no layout do
relatrio.
Informar o espao necessrio para rtulo de coluna mais
traduo do campo selecionado no layout do relatrio.
Informar o espao necessrio para rtulo de coluna mais
traduo do campo selecionado no layout do relatrio.
Habilitar o campo que especfica a condio em que sero
mostrados os registros lidos.
Sempre: sero mostrados todos os registros lidos.
Primeiro: ser mostrado apenas o primeiro registro lido dentro
de uma classificao escolhida pelo usurio.
ltimo: ser mostrado apenas o ltimo registro lido dentro de
uma classificao escolhida pelo usurio.
Informar o tipo de descrio ou ttulo utilizado no grupo.
No label: no mostra a descrio ou ttulo dos campos no
layout.
Side label: mostra a descrio ou ttulo dos campos no layout
ao lado do mesmo (em linha).
Column-label: mostra a descrio ou ttulo dos campos no
layout em cima do mesmo (em coluna).
Nota
Quando selecionada uma das opes de label no item grupo,
esta ser aplicada para todo o grupo do objeto selecionado.

Funo

Reordenar Campos do Relatrio

Objetivo

Esta funo tem por objetivo permitir a ordenao dos campos no layout do
relatrio sem que seja necessrio arrast-los com o mouse.
Atravs do menu do Data Viewer opo Colunas, item Reordena Campos
ou atravs do boto Reordena Campos, acessado a tela de Reordenar
Campos do Relatrio.

Descrio

32

Um relatrio composto de campos e estes campos seguem uma seqncia.

Nesta funo o usurio ter condies de alterar est seqncia. Os campos
so mostradas no browse e ao lado direito da tela temos os botes de sobe e
desce para permitir as devidas alteraes quando necessrias.

Funo

Grupos do Relatrio

Objetivo

Esta funo tem por objetivo permitir consultas e atualizaes nos grupos do
layout do relatrio.
obrigatrio para relatrios com separao de grupos de dados que o
primeiro campo de cada grupo de campos do layout esteja na classificao do
relatrio.

Descrio

Atravs do menu do Data Viewer opo Colunas, item Grupos ou atravs

do boto Grupos, acessado a tela de Grupos do Relatrio.

CAPTULO 6

Processo Colunas

33

Na tela acima, deve-se clicar sobre o campo que desejado utilizar como
separador de grupo, exemplo o nr-nota-fisc e, aps clicar sobre o boto
Separa, depois pressionar o boto OK.
Boto

Descrio

Propriedades

Possibilita informar se o campo selecionado quebra pgina quando

mudar de valor.
Nota
Os botes Propriedades e Separa, somente ficaro habilitados
quando selecionado um campo que possua classificao no relatrio
ou um campo calculado e o prximo uma classificao.

Separa
Elimina

Permite realizar a separao dos grupos no layout.

Tem por funo eliminar a linha de separao dos grupos no layout.
Nota
O boto Elimina somente ficar habilitado quando selecionada uma
linha de separao de grupos.

Nota
Grupo uma diviso hierrquica, que possibilita ao programa quebrar as
informaes mediante os grupos informados, para melhor visualizar as
informaes.

34

Podemos citar como exemplo uma Listagem de Notas Fiscais por Clientes,
onde teramos no grupo 1 (um) os dados do cliente e, no grupo 9 (nove) as
informaes referentes a nota fiscal, item, valor mercadoria e valor total da
nota.
Consultando o exemplo, observamos que h dois grupos:
Grupo 1:

CAPTULO 6

Processo Colunas

Grupo 9:

35

37

CAPTULO 7

Processo Geral
Objetivo

Este processo tem por objetivo descrever as funes Classificaes do

Relatrio, Selees do Relatrio, Manuteno Variveis, Parmetros do
Relatrio, Totais do Relatrio, Manuteno de Clculos, Fonte Livre,
Manuteno de Parmetros e Manuteno de Procedures Internas.

Funo

Classificaes do Relatrio

Objetivo

Esta funo tem por objetivo realizar a manuteno nas classificaes ou

formas de ordenao do relatrio.

Descrio

Selecionar no menu do Data Viewer a opo Geral, item Classificao ou

atravs do boto Classificao. acessado ento, a tela de Classificaes
do Relatrio.

38

Campos

Descrio

Ordem

Informar se a classificao do campo selecionado, ser de forma

ascendente (menor para maior) ou, descendente (maior para menor).
Informar se deseja visualizar as tabelas e campos pelo nome ou pela
descrio.

Visualizao

Na tela de manuteno de classificaes, o browse a esquerda traz as tabelas

do relatrio, o da direita os campos desta tabela e, o inferior, os campos que
fazem parte das classificaes do relatrio.
Selecionar o campo desejado para classificao e, incluir o mesmo nas
classificaes, atravs do boto incluir (seta para baixo), ou com dois clicks
sobre o campo.
Importante
Quando da eliminao de uma classificao que utilizada para dividir grupos
do relatrio, os objetos dos grupos se juntaro em um nico grupo no layout,
fugindo ao posicionamento anterior.

CAPTULO 7

Processo Geral

39

Nota
permitido ao usurio atravs do boto "Edita", editar a classificao e fazer
alteraes nesta, caso necessrio.
Exemplo:
Temos uma listagem de notas ficais e queremos que seu resultado seja
classificado apenas pelo ms da nota e no toda a sua data.
Classificao: nota-fiscal.data-emissao
Edita: month(nota-fiscal.data-emissao).
Utilizamos assim a funo month do progress para resgatar o valor do ms
em uma data e, temos o relatrio classificado apenas por ms.

Funo

Selees do Relatrio

Objetivo

Esta funo tem por objetivo realizar a manuteno dos campos a serem
utilizados como seleo para o relatrio (faixa inicial e final).

Descrio

Selecionar no menu do Data Viewer a opo Geral, item Seleo ou

atravs do boto Seleo, onde existir acesso a tela de Selees do
Relatrio.

40

Na tela de Selees do Relatrio, o browse a esquerda traz as tabelas do

relatrio, o da direita os campos desta tabela e o inferior, os campos que
fazem parte das selees do relatrio.
Selecionar os campos que deseja para seleo (um por vez) e incluir o
mesmo nas selees, atravs do boto incluir (seta para baixo), ou com dois
clicks sobre o campo.

CAPTULO 7

Processo Geral

41

Conferindo selees:

Funo

Manuteno de Variveis

Objetivo

Esta funo tem por objetivo realizar a manuteno no cadastro de variveis

utilizadas no relatrio.

Descrio

Selecionar no menu do Data Viewer a opo Geral, item Variveis ou

atravs do boto Variveis, onde existir acesso a tela de Manuteno de
Variveis.

42

Boto Incluir
Boto Modificar

Incluir ou Modificar Variveis: acessar atravs dos botes incluir ou

modificar na tela de manuteno de variveis, onde ser apresentada na tela
a seguir:

CAPTULO 7

Processo Geral

43

Campo

Descrio

Varivel

Inserir o nome da varivel a ser cadastrada.

Este campo no pode ter espao em branco, caracteres
especiais ou acentuao.
Inserir o ttulo ou descrio para a varivel.
Este campo pode ter espao em branco, caracteres
especiais ou acentuao.
Inserir o formato que ser utilizado para informar o
contedo da varivel.
Valor Inicial que ser apresentado ao solicitar o contedo
para a varivel.
Selecionar o tipo de informao que a varivel
armazenar.

Rtulo

Formato
Inicial
Tipo Dado

44

Opes disponveis:

Visualizador

Caracter: Conversor de Voltagem;

Inteiro: 147;

Decimal: 147,36;

Data: 21/04/98;

Lgico: sim.
Alm do formato, pode-se definir outras maneiras de
mostrar o contedo da varivel (fill-in, radio-set, combobox).
Nota
Somente permitida seleo de outros formatos, para
variveis do tipo inteiro ou caracter. Variveis do tipo
lgico, tem como formato padro "toggle-box" ou "checkbox".

Valor Visualizador

Contedo que ser utilizado para o visualizador (radio-set,

combo-box).
Exemplo:
Varivel: v-estado-ordem
Rtulo: Estado da Ordem
Tipo Dado: Caracter
Formato: x(15)
Visualizador : Combo-Box
Valor Visualizador:

Horizontal / Vertical
Pede em Execuo

"Aberta";

"Cancelada";

"Finalizada";

"Suspensa".

Caso o visualizador seja do tipo "radio-set", pode-se optar

pela apresentao do seu contedo de forma horizontal
ou vertical.
Quando marcado, a varivel que est sendo cadastrada,
ser solicitada em tela no momento de executar o
relatrio, caso contrrio, ela ser apenas considerada
como varivel interna de clculo do relatrio.

CAPTULO 7

Processo Geral

Funo

Parmetros do Relatrio

Objetivo

Esta funo tem por objetivo realizar consultas e manutenes dos

parmetros de leitura das tabelas no processamento do relatrio.
Selecionar no menu do Data Viewer a opo Geral, item Parmetros ou
atravs do boto Parmetros, onde existir acesso a tela de Parmetros do
Relatrio.

Descrio

Boto

Descrio

Encontra

Faz referncia da ocorrncia informada com a existncia de uma

ocorrncia igual em outra tabela a ser informada.
Faz referncia da ocorrncia informada com a inexistncia de uma
ocorrncia igual em outra tabela a ser informada.
Adicionar abre parnteses na linha da ocorrncia selecionada.
Eliminar abre parnteses na linha da ocorrncia selecionada.

No
Encontra
Seta direita (
Seta
esquerda (
Seta direita )
Seta
esquerda )
E

Adicionar fecha parnteses na linha da ocorrncia selecionada.

Eliminar fecha parnteses na linha da ocorrncia selecionada.
Adicionar conector lgico de obrigatoriedade na linha da ocorrncia
selecionada.

45

46

OU

Adicionar conector lgico de opcionalidade na linha da ocorrncia

selecionada.

Na tela de manuteno de parmetros, o browse a esquerda traz as tabelas

do relatrio, o da direita os campos desta tabela e o inferior, os campos que
fazem parte dos parmetros do relatrio.
Selecionar o campo desejado para parmetro e incluir o mesmo nos
parmetros, atravs do boto incluir seta para baixo, ou com dois clicks
sobre o campo. Depois pressionar o boto com a comparao desejada para
este parmetro. apresentada uma tela onde pede-se o campo Comparar
com, informar o contedo desejado como comparao. Pressionar OK e
voltando a tela de manuteno de parmetros, pressionar OK novamente.
O parmetro acima feito, est fixo para o relatrio. Fato que, para expedir um
relatrio com outro contedo para parmetro, ou so abertos os parmetros
novamente e alterado os contedos de comparao ou criado outro
relatrio.
No programa de Manuteno de Variveis, o usurio informou quais ele
deseja pedir em tela:

CAPTULO 7

Processo Geral

47

No programa de Parmetros, ele pode informar estas variveis como

comparao para que o programa do relatrio gerado, busque as informaes
no banco de dados mediante seus contedos:

Funo

Totais do Relatrio

Objetivo

Esta funo tem por objetivo realizar a manuteno no cadastro de totais do

relatrio.

Descrio

Selecionar no menu do Data Viewer a opo Geral, item Totais ou atravs

do boto Totais, onde existir acesso a tela de Totais do Relatrio.

48

Adicionar total do
campo
selecionado ao
relatrio.

Na tela acima, o browse da esquerda apresenta todos os campos do tipo

inteiro ou decimal que encontram-se no layout do relatrio e o browse da
direita as classificaes do relatrio e, o inferior, os totais do relatrio.
Nota
Para que seja permitida a Manuteno de Totais, necessrio ter pelo menos
1 (um) campo no layout do relatrio que seja do tipo de dado inteiro ou
decimal. Cada total possui vnculo direto com uma classificao do relatrio
ou geral.

Funo

Manuteno de Clculos

Objetivo

Esta funo tem por objetivo incluir, modificar ou eliminar os clculos para o
relatrio.

Descrio

Selecionar no menu do Data Viewer a opo Geral, item Clculos ou

atravs do boto Clculos, onde existir acesso a tela Manuteno de
Clculos, onde possvel incluir, modificar ou eliminar os mesmos.

CAPTULO 7

Processo Geral

49

Ao incluir ou modificar um clculo ser apresentada a seguinte tela:

Boto Gerar
Cdigo

Campo

Descrio

Atributo

Informar o nome do atributo (varivel) que

est sendo cadastrada para armazenar o
clculo.

50

Rtulo
Formato
Tipo Dado
Tipo Clculo

Informar uma descrio ou ttulo para o campo.

Informar qual forma que o contedo deste

campo ser apresentado.
Selecionar o tipo de dado que este clculo
vai armazenar, pode ser inteiro ou decimal.
Selecionar o tipo de clculo que este atributo
(varivel) vai armazenar.

Contador: monta um contador de registros

dentro da classificao informada.

Mximo: armazena no campo de clculo o

maior valor entre este e o campo
acumulador dentro da classificao
informados.

Mnimo: armazena no campo de clculo o

menor valor entre este e o campo
acumulador dentro da classificao
informados.

Mdia: armazena no campo de clculo a

mdia entre o campo acumulador e o
nmero de registros lidos dentro da
classificao informada.

Livre: armazena no campo de clculo uma

frmula que o usurio definiu, para ser
impressa dentro da classificao
informada.

Total: armazena no campo de clculo o

total do campo acumulador dentro da
classificao informada.
Nmero da linha em que ser apresentado o
clculo, aps a quebra da classificao
informada.
Nmero da coluna em que ser apresentado o
clculo, aps a quebra da classificao
informada.
Quando marcado, o clculo ser apresentado
no relatrio.
Clculos que no sero impressos no relatrio,
geralmente sero utilizados em alguma outra
frmula para o relatrio. Portanto,
aconselhvel que para estes, voc informe
linha = 1, coluna = 1. Assim, estes tero sua
frmula montada no fonte do programa do
relatrio antes que todos os outros.
Tabela: tabela utilizada em classificao do
relatrio, pode ser branco quando classificao

Linha
Coluna
Mostra Atributo

Classificao

CAPTULO 7

Processo Geral

Campo Acumulado

Definio/Primeiro/Clculo/Fim

51

gera.
Atributo: atributo de uma tabela utilizada em
classificao do relatrio, ou geral.
Tabela: tabela utilizada para leitura no relatrio.
Atributo: atributo do tipo inteiro ou decimal, de
uma tabela utilizada para o relatrio.
Armazena o cdigo progress responsvel para
que seja gerado o clculo, este cdigo pode ser
alterado pelo usurio.
Aps clicar sobre o Boto Gerar Cdigo, e
preenchidos os campos anteriores, so
geradas as definies e frmulas dos dados
informados, dentro dos respectivos pontos
(Definio, Primeiro, Clculo, Fim).

Definies: Cdigo com as definies do

clculo;

Primeiro: Cdigo para zerar o clculo;

Clculo: Frmula para atribuir o valor

desejado ao clculo;

Fim: Finalizao do Clculo.

Boto Gerar Cdigo: Gera as definies e frmulas dos dados informados,

dentro dos respectivos pontos, Definio, Primeiro, Clculo, Fim.
Sempre que clicado o Boto Gerar Cdigo, este ir regerar o cdigo do
clculo, levando em considerao os campos preenchidos na tela. Portando,
caso voc tenha alterado manualmente um dos itens Definio, Primeiro,
Clculo e Fim e depois clicar sobre o Boto Gerar Cdigo, todas as
alteraes manuais sero perdidas.

Funo

Fonte Livre

Objetivo

Esta funo tem por objetivo permitir ao usurio escrever cdigo Progress ou
at mesmo chamar outros programas, includes em pontos especficos do
relatrio.

Descrio

Selecionar no menu do Data Viewer a opo Geral, item Fonte Livre ou

atravs do boto Fonte Livre, permitindo acesso a tela Inclui Fonte Livre
(cdigo Progress para o relatrio escrito pelo usurio).

52

Local do relatrio
onde ser utilizado
o Fonte Livre

Campo editor onde

inserido o Fonte
Livre

Os pontos onde podem ser inseridos os cdigos Progress, so os

mencionados abaixo, e estes so limitados a 2000 caracteres cada:

Antes Leitura Registros: antes do primeiro For Each para leitura das
tabelas do relatrio;

Antes Mostrar Registros: antes do Display dos campos que fazem parte
do layout do relatrio;

Aps Mostra Registros: aps Display dos campos que fazem parte do
layout do relatrio e, antes do Display dos clculos definidos para o
relatrio;

Aps Leitura Registros: aps o End que fecha o primeiro For Each das
tabelas para leitura no relatrio;

Final Programa: antes de imprimir a pgina de parmetros.

Outros pontos: Aps Definio de Variveis, Aps Atribuio de Variveis,

Aps Abertura do Arquivo de Sada, Antes da Impresso dos Parmetros,
Aps Fechamento do Arquivo de Sada, Aps Definio das Variveis
(Interface), Aps Definio das Includes (Interface), Boto de Fechar do
Programa (Interface), Boto de Ajuda do Programa (Interface), Boto de
Arquivo (Interface), Boto de Impressora (Interface), Troca de Valor do
Destino (Interface), Troca de Valor da Execuo (Interface), Incio do Cdigo

CAPTULO 7

Processo Geral

53

Principal (Interface), Inicializao de Variveis (Interface), Antes de Habilitar

Campos (Interface), Aps Habilitar Campos (Interface), Incio da Execuo
(Interface), Execuo do Relatrio (Interface), Aps Execuo (Interface), Fim
da Execuo (Interface).

Funo

Parmetros de Entrada

Objetivo

Esta funo tem por objetivo permitir ao usurio incluir, modificar ou eliminar
os Parmetros de Entrada.

Descrio

No menu do Data Viewer, opo Geral, item Parmetros de Entrada, ou

pelo boto Parmetros de Entrada, acessar a tela Manuteno de
Parmetros, onde possvel incluir, modificar ou eliminar os mesmos.

54

Ao incluir ou modificar um parmetro de entrada, ser apresentada a seguinte

tela:

O Tipo de Dado pode ser: Caracter, Inteiro, Decimal, Data, Lgico.

Funo

Manuteno de Procedures Internas

Objetivo

Esta funo tem por objetivo permitir ao usurio incluir, modificar ou eliminar
as Procedures Internas para o relatrio.

Descrio

No menu do Data Viewer, opo Geral, item Procedures Internas ou pelo

boto Procedures Internas, acessamos a tela de Manuteno de Procedures
Internas.

CAPTULO 7

Processo Geral

Ao incluirmos ou modificarmos uma Procedure Interna, ser apresentada a

seguinte tela:

As Procedures Internas cadastradas na Funo Manuteno de Procedures

Internas, podero ser utilizadas no Fonte Livre. Estas procedures estaro
disponveis somente para aquele relatrio corrente, qual ela foi vinculada.

55

57

CAPTULO 8

Processo Gerao
Objetivo

Este processo tem por objetivo descrever as funes Teste, Fonte, Gerao
WEB e Editor.

Funo

Teste

Objetivo

Esta funo tem por objetivo possibilitar a gerao do programa de interface

do relatrio e do programa de processamento, alm de compilar e executar
este programas.
No menu do Data Viewer, opo Gerao, item Teste ou pelo boto
Teste, efetuamos a gerao do relatrio (teste).

Descrio

Caso ocorra algum erro de compilao, estes sero apresentados em tela

para o usurio, impedindo que o programa seja executado.

Funo

Fonte

Objetivo

Esta funo tem por objetivo possibilitar a gerao do programa de interface

do relatrio e do programa de processamento, alm de compilar estes
programas. Esta opo no executa os programas gerados.

58

Descrio

No menu do Data Viewer, opo Gerao, item Fonte, efetuamos a

gerao do relatrio.

Caso ocorra algum erro de compilao, estes sero apresentados em tela

para o usurio.

Funo

Gerao WEB

Objetivo

Esta funo tem por objetivo a Gerao WEB dos relatrios. Gera a interface,
faz a compilao, porm a verificao de erro (caso ocorra) feita no
WEBSpeed.

Descrio

Esta funo pode ser acessada no menu do Data Viewer, opo Gerao,
item WEB ou pelo boto Gerao WEB.
Caso o usurio deseje a Gerao WEB do relatrio, atualmente, deve:

Escolher obrigatoriamente o perfil EMS 2.0.

CAPTULO 8

Processo Gerao

No utilizar Parmetros de Entrada.

No utilizar Procedures Internas (sero descartadas).

59

60

Funo

Editor

Objetivo

Esta funo possibilita acessar o Editor Progress.

Descrio

No menu do Data Viewer, opo Gerao, item Editor ou pelo boto

Editor, permite acesso a tela Procedure Editor.

61

CAPTULO 9

Processo Administrao
Objetivo

Este processo tem por objetivo descrever as funes Administrar Tabelas,

Administrar Relacionamentos, Manter Relacionamentos, Manter Tabelas,
Manter Campos, Manter Usurios, Alterar Usurio Relatrio, Permisses
Usurios (Tabelas / Campos), Perfis (Manter, Exportar, Importar, Manter
Blocos x Perfil), Dados (Exportar / Importar), Gerao (Relatrios / Menu),
ProTools.
Ser visto neste captulo, como trabalhar com as rotinas de Administrao do
Data Viewer.

Funo

Administrar Tabelas

Objetivo

Esta funo tem por objetivo importar ou eliminar no Data Viewer definies
(tabelas, campos, ndices) de bases de dados a serem usadas para fazer
relatrios

Descrio

Atravs do menu do Data Viewer, opo Administrao item Administrar

Tabelas, acessamos a tela de Manuteno das Definies das Tabelas.

62

Boto Eliminar: Limpa o banco de dados do Data Viewer, de todas as

definies relacionadas aos bancos de dados que o usurio havia carregado
para desenvolver relatrios. Esta opo no altera os relatrios j
cadastrados.
Boto Carregar: Quando selecionada esta opo, ser apresentada uma
nova tela.

Nesta tabela, o browse da esquerda, apresenta todas as bases de dados

conectadas disponveis, e o browse da direita as bases selecionadas para

CAPTULO 9

Processo Administrao

63

importao. Para passar uma tabela de disponvel selecionada, clicar sobre

a base desejada no browse de disponveis e, depois clicar sobre o boto
incluir (>). O mesmo pode ser feito para eliminar uma base selecionada,
clicando no boto eliminar (<). Selecionadas as bases, clicar no boto OK, e
sero carregadas ento as definies das bases selecionadas para o Data
Viewer.

Funo

Administrar Relacionamentos

Objetivo

Esta funo tem por objetivo gerar ou eliminar automaticamente no Data

Viewer, os relacionamentos referentes as tabelas das bases de dados
importadas para fazer relatrios.

Descrio

Atravs do menu do Data Viewer, opo Administrao item Administrar

Relacionamentos, acessamos a tela de Gerao Total dos Relacionamentos.

Boto Carregar: gera dentro do Data Viewer os relacionamentos entre as

tabelas, estes relacionamentos so tratados pelo Data Viewer como
Automticos. Devendo-se fazer isto apenas uma vez, a menos que seu banco
de dados, que contm as tabelas que deseja-se criar relatrios, sofra
alteraes constantes a nvel de ndices e atributos que fazem parte da chave
das tabelas.
Boto Eliminar: limpa o banco do Data Viewer de todos os relacionamentos
do tipo automtico. Este processo no afeta os relatrios j cadastrados.

Funo

Manter Relacionamentos

Objetivo

Esta funo tem por objetivo incluir, modificar ou eliminar manualmente no

Data Viewer, relacionamentos referentes as tabelas das bases de dados
importadas para fazer relatrios.

64

Descrio

Atravs do menu do Data Viewer, opo Administrao item Manter

Relacionamentos, acessamos a tela de Incluso de Relacionamentos.

Estrutura a partir
do pai.

Estrutura a partir
do filho.

Para efetuar a incluso do relacionamento, basta informar tabela pai, tabela

filho e os campos que fazem parte do relacionamento.
Para auxiliar o usurio que vai efetuar a incluso do relacionamento, pode ser
utilizado o boto Pesquisa Relaes (da estrutura a partir do pai e filho):

CAPTULO 9

Processo Administrao

Funo

Manter Tabelas

Objetivo

Esta funo tem por objetivo incluir, modificar ou eliminar no Data Viewer,
tabelas virtuais como Buffers ou Temp-Tables (tabelas temporrias).

Descrio

Atravs do menu do Data Viewer, opo Administrao item Manter

Tabelas, acessamos a tela de Manuteno de Tabelas.

65

66

Boto Incluir

Para incluir uma tabela virtual, na tela de Manuteno de Tabelas, clicar sobre
o boto Incluir:

CAPTULO 9

Processo Administrao

67

Campo

Descrio

Tabela
Tabela Origem

Inserir o nome da tabela a ser criada.

Selecionar uma tabela origem, onde a nova ser uma cpia da
origem.
Inserir uma descrio para a tabela criada.
Assinalar o tipo de tabela que o usurio est criando (Fsica,
Virtual, Temporria).
Fsica: quando da criao de uma tabela do tipo fsica, esta ser
considerada como uma tabela que deveria ter sido importada de
uma base de dados para o Data Viewer.

Descrio
Tipo Tabela

Nota
Tabela do tipo Fsica no deve possuir tabela origem.

Cpia
Relacionamentos

Virtual: tabela virtual ou buffer, uma cpia de uma tabela fsica.

Devendo sempre possuir uma tabela origem. Este tipo de tabela,
quando lida, apresenta os mesmos dados existentes em sua
tabela de origem.
Temporria: uma tabela do tipo temporria, sem dados
inicialmente. O usurio dever fazer uma rotina para carreg-la
com as informaes desejadas. Pode possuir uma tabela de
origem ou no. Estas tabelas so definidas nos programas
gerados pelo Data Viewer como new shared, podendo ser
compartilhada por outros programas durante a mesma seo
Progress.
Quando assinalada a opo Copia Relacionamentos, todos os
relacionamentos que a tabela origem possui, sero copiados para
a tabela a ser criada. Porm, quando da manuteno de
relacionamentos na tabela origem, este no ocorrer
automaticamente para as tabelas derivadas.

Para modificar ou eliminar uma tabela virtual, clicar nos respectivos botes na
tela de Manuteno de Tabelas.

Funo

Manter Campos

Objetivo

Esta funo tem por objetivo incluir, modificar ou eliminar no Data Viewer,
campos (atributos) das tabelas importadas ou criadas para fazer relatrios.
Permitir ao usurio realizar consulta e manuteno de atributos das tabelas
cujas definies foram carregadas para o Data Viewer ou criadas no mesmo.
No alterando as definies dos atributos nas tabelas originais em suas bases
de dados, de onde as definies foram carregadas.

68

Descrio

Atravs do menu do Data Viewer, opo Administrao item Manter

Campos, acessamos a tela de Manuteno de Campos.

Boto Frmula: s
pode ser informada
para atributos
virtuais.
Boto Filtrar: faixa
do nome dos
arquivos.

O usurio pode Incluir o campo desejado:

CAPTULO 9

Processo Administrao

69

Campo

Descrio

Tabela
Atributo
Rtulo
Coluna
Rtulo

Nome da tabela a qual o atributo selecionado pertence.

Inserir o nome do atributo selecionado.
Inserir a descrio ou ttulo do atributo selecionado para ser apresentado
na forma de coluna.
Inserir a descrio ou ttulo do atributo selecionado para ser apresentado
na forma de linha.
Inserir a forma a qual o contedo do atributo selecionado vai ser
apresentado.
Selecionar tipo de informao a qual o atributo selecionado vai
armazenar.
As opes disponveis so: caracter, inteiro, decimal, data, lgico.
Assinalar uma das opes:

Formato
Tipo Dado

Tipo
Campo

Fsico: no armazena frmula, apenas seu prprio contedo para o

registro.
Quando assinalado, informar se o atributo possui um texto no seu
contedo para o registro.

Campo
Narrativa

Virtual: armazena uma frmula no seu contedo (define uma

varivel no programa do relatrio que o utilizar).

70

O usurio pode Modificar o campo desejado:

O usurio pode Eliminar o campo desejado:

Funo

Manter Usurios

Objetivo

Esta funo tem por objetivo incluir, modificar ou eliminar os usurios do Data
Viewer

Descrio

Atravs do menu do Data Viewer, opo Administrao item Manter

Usurios, acessamos a tela Manuteno Usurios:

CAPTULO 9

Processo Administrao

71

Para incluir usurios, na tela Manuteno Usurios, clicar sobre o boto

Incluir, acessando a tela de incluso de usurios:

Campo

Descrio

Usurio
Caminho Editor Texto

Inserir o nome do usurio que ter acesso ao Data Viewer.

Inserir o caminho editor texto.

72

Diretrio Trabalho
Diretrio Trabalho WEB
Visualiza Barra de
Ferramentas
Tipo Usurio

Inserir o diretrio de trabalho onde sero gravados os

programas criados pelo usurio no Data Viewer.
Inserir diretrio de trabalho WEB.
Quando assinalado, disponibiliza duas opes:

Rgua;

ToolBar.
Assinalar uma das opes: Iniciante, Avanado,
Administrador.
Nota
Apenas os usurios do tipo Administrador, tero acesso a
rotina de administrao no menu do Data Viewer.

Boto Senha: quando clicado, libera acesso a tela Manuteno de Senha.

Campo

Descrio

Senha Atual

Inserir a senha atual para alterao.

Quando este programa for acessado pela primeira vez, o usurio
no precisa informar a senha atual, devido a mesma no existir.
Ser informado apenas a nova senha, confirmando esta senha.
Inserir a nova senha do usurio.
Confirmar a nova senha digitada no campo "Nova Senha".

Nova Senha
Confirma Senha

Para modificar ou eliminar um usurio, selecionar na tela de Manuteno de

Usurios, o usurio desejado para alterao, depois, clicar sobre o boto
Modificar ou Eliminar, conforme sua necessidade.

CAPTULO 9

Processo Administrao

73

Funo

Alterar Usurio Relatrio

Objetivo

Esta funo tem por objetivo alterar o usurio do relatrio.

Descrio

Atravs do menu do Data Viewer, opo Administrao item Alterar Usurio

Relatrio, acessamos a tela Alterao de Usurio do Relatrio:

Campo

Descrio

Relatrio Origem
Usurio Destino
Relatrio Destino

Selecionar o relatrio de origem.

Selecionar o usurio destino do relatrio.
Inserir o nome do relatrio destino. O programa apresenta o nome
do relatrio origem, possibilitando alteraes quando necessrio.
Inserir o ttulo do relatrio, sendo que o programa apresenta o
ttulo do relatrio origem, permitindo alteraes quando
necessrio.
Inserir o ttulo de classificao, sendo que o programa apresenta
o ttulo classificao origem, possibilitando alteraes quando
necessrio.

Ttulo
Ttulo
Classificao

Nota
Aps alterar o usurio do relatrio, o usurio anterior do relatrio de origem
no mais ter este relatrio na sua lista de relatrios na tela de Manuteno
de Relatrios.

74

Funo

Permisses Usurios (Tabelas / Campos)

Objetivo

Esta funo tem por objetivo efetuar o controle de acesso dos usurios do
Data Viewer s Tabelas e Atributos (campos) importados ou carregados.

Descrio

Atravs do menu do Data Viewer, opo Administrao item Permisses

Usurios, acessamos as telas:

Boto Incluir

Boto Eliminar

Manuteno de Acesso as Tabelas: informar o nome da tabela. No

browse da esquerda coluna Disponveis, selecionar os usurios que
podero utilizar esta tabela para fazer relatrios. Para pass-los a coluna
Acessando, browse da direita, clicar sobre o boto Incluir. Para retirar o
acesso, selecionar o usurio na coluna de acessando e clicar sobre o
boto Eliminar. O curinga * (asterisco), significa que todos os usurios
do Data Viewer possuem acesso a tabela informada.

CAPTULO 9

Processo Administrao

75

Manuteno de Acesso a Campos: informar o nome da tabela.

No browse da esquerda, na coluna Disponveis, selecionar o campo.

No browse central, os usurios que podero utilizar este campo para fazer
relatrios.
Para pass-los a coluna Acessando, browse da direita, clicar sobre o boto
Incluir. Para retirar o acesso, selecionar o usurio na coluna de Acessando
e, clicar sobre o boto Eliminar. O curinga * (asterisco), significa que
todos os usurios do Data Viewer possuem acesso a tabela informada.

Boto Incluir

Boto Eliminar

Funo

Manter Perfis

Objetivo

Esta funo tem por objetivo incluir, modificar ou eliminar Perfis.

Descrio

Atravs do menu do Data Viewer, opo Administrao item Perfis, subitem Manter Perfis, acessamos a tela Manuteno de Perfis:

76

Nota
Podemos definir Perfil, como sendo um conjunto de blocos que fazem a
integrao com determinado produto.

Funo

Exportar Perfil

Objetivo

Esta funo tem por objetivo a exportao de Blocos do Perfil.

Descrio

Atravs do menu do Data Viewer, opo Administrao item Perfis, subitem Exportar Perfil, acessamos a tela Exportao de Blocos:

CAPTULO 9

Processo Administrao

Funo

Importar Perfil

Objetivo

Esta funo tem por objetivo a importao de Blocos do Perfil.

Descrio

Atravs do menu do Data Viewer, opo Administrao item Perfis, subitem Importar Perfil, acessamos a tela Importao de Blocos:

77

78

Funo

Manter Blocos x Perfil

Objetivo

Esta funo tem por objetivo incluir, modificar, eliminar ou copiar Blocos.

Descrio

Atravs do menu do Data Viewer, opo Administrao item Perfis, subitem Manter Blocos x Perfil, acessamos a tela Manuteno de Blocos:

CAPTULO 9

Processo Administrao

O usurio que no tiver permisso sobre um produto especfico, no ter

acesso sobre os blocos daquele produto.

79

80

Funo

Dados (Exportar)

Objetivo

Esta funo tem por objetivo a Exportao de Relatrios (base de dados do

Data Viewer), possibilitando assim realizar atualizaes sem perda de
informaes.

Descrio

Atravs do menu do Data Viewer, opo Administrao item Dados, subitem Exportar, acessamos a tela Exportao de Relatrios:

Campo

Descrio

Exportao

Definies: quando assinalado, indica que sero exportadas as

informaes relacionadas as base carregadas para trabalhar no Data
Viewer, ou seja, so as tabelas, campos, ndices, relacionamentos
entre outros.
Dados: quando assinalado, habilita os campos Perfis, Relatrios e
Seleo.
Indica que sero exportadas todas as informaes referentes aos
relatrios existentes no Data Viewer, ou seja, tudo que for necessrio

CAPTULO 9

Processo Administrao

Relatrios

Seleo
Diretrio

para que este relatrio seja gerado.

Assinalar uma das opes:

Padro;

Comum;

Ambos.
Informar uma faixa inicial e final de usurios e relatrios no Data
Viewer, para a realizao de sua exportao.
Informar diretrio para onde sero exportadas (geradas) as
informaes.

Funo

Dados (Importar)

Objetivo

Esta funo tem por objetivo a Importao de Relatrios (base de dados do

Data Viewer), possibilitando assim realizar atualizaes sem perda de
informaes.

Descrio

Atravs do menu do Data Viewer, opo Administrao item Dados, subitem Exportar, acessamos a tela Importao de Relatrios:

Campo

Descrio

Relatrios

Definies: quando assinalado, indica que sero importadas as

informaes relacionadas as base carregadas para trabalhar no Data
Viewer, ou seja, so as tabelas, campos, ndices, relacionamentos
entre outros.
Dados: quando assinalado, Indica que sero importadas todas as
informaes referentes aos relatrios existentes no Data Viewer, ou
seja, tudo que for necessrio para que este relatrio seja gerado.
Informar diretrio para o qual foram geradas ou exportadas
(anteriormente) as informaes (relatrios).

Diretrio

81

82

Funo

Gerao (Relatrios)

Objetivo

Esta funo tem por objetivo a gerao de relatrios por faixas e partes.

Descrio

Atravs do menu do Data Viewer, opo Administrao item Gerao, subitem Relatrios, acessamos a tela de Opes da Gerao de Relatrios:

Atravs das faixas por Usurio e Relatrio, pode ser feita a gerao de todos
os relatrios, de um ou vrios usurios, de uma s vez.
Opes de gerao:

Tela Relatrio: programa com tela de interface do relatrio, pgina de

seleo, parmetros e impresso.

Fonte Relatrio: programa com lgica do relatrio, o programa que faz o

processamento e impresso dos dados para o relatrio.

Tela Classificao: programa com tela que apresentar todas as

classificaes de um mesmo relatrio.

Tela Web: quando assinalado, possibilita Gerao WEB.

CAPTULO 9

Processo Administrao

Funo

Gerao (Menu)

Objetivo

Esta funo tem por objetivo ajudar o usurio a montar um menu para os
relatrios existentes no Data Viewer.

Descrio

Atravs do menu do Data Viewer, opo Administrao item Gerao, subitem Menu, acessamos o assistente de Gerao de menu do Data Viewer.

O assistente tem por funo ajudar o usurio a montar um menu para os

relatrios existentes no Data Viewer.

Funo

ProTools

Objetivo

Esta funo tem por objetivo disponibilizar uma barra de ferramentas para
auxiliar o usurio do Data Viewer.

Descrio

Atravs do menu do Data Viewer, opo Administrao item ProTools,

acessamos o ProTools:

83

84

Disponibiliza as seguintes funes: Color Changer, Config info, Control

Hierarchy, DB List, DOS, Set Font 2, Editor, Procedures, Propath, Run,
Session, Window Viewer, Windows Info, Screen Capture, PRO*Spy, Smart
Object Upgrade Utility, Screen Scaling Utility, Progress COM Object Viewer.

85

CAPTULO 10

Processo Formato e Impresso de Valores dos

Atributos e Variveis
Objetivo

Este processo tem por objetivo mostrar o formato e impresso de valores dos
atributos e variveis do relatrio.

Descrio

O formato do atributo determina como seu valor ser apresentado em tela ou

impresso, independente do valor armazenado no banco de dados.
Por exemplo, o atributo nome tem 40 caracteres no banco de dados, mas
para a impresso ser utilizado o formato x(20), logo, apenas os vinte
primeiros caracteres sero impressos.
Valor inicial para os formatos conforme o tipo de dado:
Tipo de Dado

Formato Inicial

Caracter
Data
Decimal
Inteiro
Lgico

X(8)
99/99/99
->>,>>9.99 *
->,>>>,>>9 *
Sim / No

Nota: Caso seja utilizado o formato Europeu na seo Progress (-E), o valor
inicial para formato decimal ->>.>>9,99 e para inteiro ->.>>>.>>9. Mais
informaes ver item "Impresso para Formato Numrico".
Impresso para Formato Caracter : se o atributo est utilizando o formato
inicial x(8), apenas os oito primeiros caracteres sero impressos, a menos que
seja especificado outro formato. O x representa que um caracter

86

alfanumrico utilizar cada posio e, o 8 representa o nmero de

caracteres que o Data Viewer utilizar para a impresso.
possvel utilizar diferentes smbolos para definir o formato caracter: X,N,A,!
e 9. Pode tambm utilizar outros, como parnteses, vrgula, trao, etc. Para
mostrar, por exemplo, informaes como nmero de telefone.
Smbolo

Objetivo

X
N
A
!

Representa qualquer caracter

Representa um nmero ou uma letra
Representa uma letra
Representa uma letra e, convertida para
maiscula
Representa um nmero
Representa quanto caracteres sero utilizados
conforme o formato.

9
(n)

Exemplo !(4) eqivale a !!!!, resultando cinco

caracteres do tipo letra maiscula.

Formato

Valor

Impresso

Xxxxxxxx
X(9)
X(20)
Xxx
AAA-9999
!!!-9999
(999) 999-9999
!!!!

Vrios caracteres
Vrios caracteres
Vrios caracteres
Vrios caracteres
Abcd1234
Abcd1234
6176635000
Bola

Vrios c
Vrios ca
Vrios caracteres
Vr
Abc-1234
ABC-1234
(617) 663-5000
BOLA

Impresso para Formato Numrico: quando especificado o formato

numrico para o dado, comum utilizarem-se os seguintes caracteres 9, z, *
ou >. Mas, pode-se tambm utilizar outros smbolos como +, -, <. Por
exemplo, o formato inicial para impresso de um atributo decimal >>,>>9.99 e para um inteiro ->,>>>,>>9. Caso seja utilizado o formato
numrico Europeu (-E) na sua seo Progress, o tipo decimal passa a ser >>.>>9,99 e o inteiro ->.>>>.>>9. Isto porque o formato Europeu inverte as
posies entre vrgula (,) e ponto (.) para identificao dos separadores de
milhar.

CAPTULO 10

Processo Formato e Impresso de Valores dos Atributos e Variveis

Smbolo

Objetivo

Posicionado na frente do nmero, indica que o

valor mencionado positivo.
Posicionado na frente do nmero, indica que o
valor mencionado negativo.
Caso o contedo do seu atributo seja (U) ou, no
utilize todo o formato, este deixar em branco ao
invs de preencher com zeros.
Indica um nmero. Caso o contedo do seu
atributo seja (0) ou, no utilize todo o formato,
este ser preenchido com zeros.
Indica um nmero. Caso o contedo do seu
atributo seja (0) ou, no utilize todo o formato,
este ser preenchido com asterisco.

> or z

Exemplo

Formato

Valor

Impresso

99999
9,999
>,>>9
$zzz9
$>>>9
$->,>>9.99
$ >,>>>9.99
$->,>>9.99
$ >,>>9.99

1234
1234
1234
123
123
1234
1234
-1234
-1234

01234
1,234
1,234
$ 123
$ 123
$ 1,234.00
$ 1,234.00
$ - 1,234.00
??????

87

Impresso para Formato Lgico: variveis ou atributos lgicos sempre so

tratados como falso/verdadeiro. Seu valor inicial sempre sim/no, porm
pode-se utilizar vrias palavras para represent-los como por exemplo:
comprado/fabricado, fsica/jurdica, azul/branco, etc.

Exemplos

Formato

Verdadeiro

Falso

Sim/No
Comprado/fabricado
Fsica/jurdica
Azul/branco

Sim
Comprado
Fsica
Azul

No
Fabricado
Jurdica
Branco

88

Impresso para Formato Data: o formato data traz como valor inicial dois
dgitos para o dia, dois para o ms e dois para o ano, (99/99/99) podendo este
ltimo ser modificado para quatro dgitos (99/99/9999). Pode-se usar como
separador a barra (/) ou o trao (-).
Tambm como inicial vem a ordem (ms/dia/ano). Para modificar esta ordem,
basta na inicializao da seo Progress, setar o parmetro (-d) com a ordem
desejada, como por exemplo, -d dmy, que representa dia, ms e ano.

Exemplos

Formato

Valor

Impresso

99/99/99
99/99/9999
99-99-99
99-99-99
999999
999999
99999999

3/10/1990
3/10/2090
3/10/1990
3/10/2090
3/10/1990
03/10/90
03/10/1990

03/10/1990
03/10/2090
03-10-90
???????? *
031090
031090
03101990

Nota: Neste exemplo o valor 3/10/2090 muito grande para ser mostrado
naquele formato. A parte com o ano tem formato para impresso de "99" e o
valor "2090", onde necessrio que no formato a parte do ano seja "9999",
em funo do valor sair da centena atual.

89