DataViewer 6

Manual de Treinamento
DATA VIEWER
Processo Desenvolvimento de
Relatrios Grficos
Crie voc mesmo layouts e programas de relatrio.
TECNOLOGIA
Copyright 1999-2003 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
1.00 050104
i
ndice
Prefcio................................................................................................ i
Como o Manual Organizado ........................................................................ i
Convenes Usadas neste Manual ................................................................ i
Processo Desenvolvimento de Relatrios Grficos ........................ 1
Objetivo do Processo.....................................................................................1
Benefcios para o Usurio..............................................................................1
Objetivos Especficos do Treinamento ..........................................................1
Principais Conceitos dos Relatrios Grficos................................................1
Principais Funcionalidades dos Relatrios Grficos .....................................1
Fluxograma bsico de criao de um relatrio grfico e edio de layouts..1
Procedimentos ...............................................................................................1
Criando Relatrios Grficos.......................................................................1
Editando Layouts .......................................................................................1
Definindo o Cabealho e Rodap do Layout.............................................1
Identificando os Elementos de Edio ......................................................1
Identificar os Recursos de Formao do Layout .......................................1
Identificar as Informaes Extras ..............................................................1
Salvando o Layout do Relatrio Grfico ....................................................1
Mantendo Layouts dos Relatrios Grficos...............................................1
Biblioteca de Funes ...............................................................................1
Estudo de Caso .............................................................................................1
iii
Prefcio
Este manual foi construdo com base na metodologia de Planejamento

Instrucional, tambm conhecida como Planejamento Centrado no Treinando
ou Planejamento por Objetivos.
Todas as informaes, aqui contidas, esto dispostas de forma a facilitar ao
mximo sua aplicao prtica. Os especialistas, autores deste treinamento,
alm de serem os prprios desenvolvedores do mdulo apresentado,
passaram por uma completa formao nesta metodologia, recebendo o ttulo
de Multiplicadores de Conhecimento.
Nas primeiras pginas do manual, voc encontrar a lista de objetivos
instrucionais desenhados por esta equipe de especialistas. Leia atentamente
estes objetivos e certifique-se de que cada passo, que voc caminha nesta
trilha de desenvolvimento, leva-o a um ganho de performance.
Logo a seguir, so apresentados os procedimentos que constituem o
processo, isto , suas principais reas funcionais, juntamente com os
objetivos instrucionais especficos para o processo.
Entendendo e cumprindo os objetivos deste manual, voc estar garantindo o
retorno do investimento efetuado em sua formao, alm de evoluir
profissionalmente.
Como o Manual Organizado

O manual de treinamento dividido em captulos. O captulo representa um
processo e apresenta os objetivos especficos e os benefcios do treinamento.
Cada captulo apresenta os procedimentos que o compem.
Lendo os conceitos, voc ter um bom entendimento de como o Data Viewer
funciona. Trabalhando com os procedimentos, voc ganhar experincia
prtica em usar o Data Viewer.
iv
Convenes Usadas neste Manual
Este cone identifica uma Dica, isto , uma informao adicional importante
para facilitar a operacionalizao tcnica de um processo.
Este cone identifica uma Observao, isto , um comentrio adicional

focando o negcio.
Este cone indica Cuidado, isto , as informaes apresentadas alertam

sobre aes que podem provocar algum dano ao processo, como, por
exemplo, informaes incorretas ou falta de dados necessrios.
Este cone identifica uma lista de Pr-requisitos para a realizao de uma

tarefa.
Este cone indica Importante, isto , alguma informao para a qual se quer
chamar a ateno.
5
Processo Desenvolvimento de
Relatrios Grficos
Objetivo do Processo
Criar relatrios grficos por intermdio da edio de layouts.
Benefcios para o Usurio

Os principais benefcios deste treinamento para o usurio so:
Utilizar o recurso de mltiplos layouts para poder desenvolver opes de
classificao e exibio de informaes no mesmo relatrio grfico.
Desenvolver relatrios grficos para impresso de informaes em
formulrios desenhados pelo prprio Data Viewer ou em pr-impressos.
Identificar os elementos grficos e os recursos de formatao para
personalizao dos relatrios, capazes de imprimir uma aparncia mais
agradvel, funcional e intuitiva.
Objetivos Especficos do Treinamento

Aps o treinamento neste processo, voc dever estar apto a:
Reconhecer os principais conceitos relacionados a Relatrios Grficos.
Identificar o fluxo de procedimentos para obteno de Relatrios Grficos.
Identificar as funcionalidades dos Relatrios Grficos.
Criar Relatrios Grficos.
Editar layouts de Relatrios Grficos.
Identificar os principais elementos disponveis para edio de Layouts de
Relatrios Grficos e suas propriedades.
6 Processo Desenvolvimento de Relatrios Grficos
Definir o cabealho e o rodap do layout do Relatrio grfico.

Identificar os recursos de formatao do layout do relatrio grfico.
Salvar layouts do Relatrio Grfico.
Manter layouts do Relatrio Grfico.
Principais Conceitos dos Relatrios Grficos

Formulrio (FORM)
Tipo de relatrio grfico cujos layouts apresentam caractersticas de
um formulrio, onde as informaes so lidas nas tabelas do banco
de dados do relatrio para depois serem exibidas de acordo com o
layout desenhado.
Formulrios permitem a aplicao de Grupos e Tabelas com
posicionamento vertical fixo no layout, para impresso no seqencial
das informaes obtidas nos bancos de dados.
Listagem (FLOW)
Tipo de relatrio grfico cujos layouts apresentam caractersticas de
uma listagem, onde as informaes so exibidas medida que so
lidas nas tabelas do banco de dados do relatrio.
Listagens permitem a aplicao exclusiva de Tabelas sem
posicionamento vertical fixo no layout, para impresso sucessiva de
linhas com as informaes obtidas nos bancos de dados.
Partes do Layout
Um layout dividido em cabealho, corpo e rodap.
por intermdio dos parmetros de Configurao da pasta
Propriedades do Layout, que essas reas so definidas.
Elementos de edio do Layout

Os elementos de edio de um layout de relatrio grfico so:
Objetos: Dentre os Objetos, destacam-se o Grupo e a Tabela. O

primeiro imprime ao Relatrio Grfico a caracterstica de formulrio; o
segundo, a caracterstica de listagem.
Campos da Base de Dados: Todos so provenientes das tabelas

importadas para o Data Viewer ou em sua inicializao, ou por
intermdio das funes Administrao de Tabelas (GR0114) e
Tabelas do Relatrio (GR0104).
Processo Desenvolvimento de Relatrios Grficos 7
Constantes: So contedos padro do Data Viewer exibidos nos

relatrios.
Aplicao dos elementos de edio nas partes do Layout

O Data Viewer estabelece regras de aplicao dos elementos de edio
nas reas do layout.
No Cabealho e Rodap, as opes disponveis so:

Objetos - Texto, Retngulo, Linha e Imagem.
Constantes Todas.
Campos do BD nenhum.
No Corpo, as opes disponveis so:

Objetos Tabela e Grupo.
1) Quando as regras de aplicao dos elementos nas reas do layout so

desrespeitadas, o Data Viewer ignora o comando do usurio, no produz
qualquer efeito grfico e tambm no exibe qualquer mensagem de erro.
2) Os nicos elementos que podem ser aplicados diretamente no Corpo do

layout so o Grupo e a Tabela. Todos os demais elementos, para serem
utilizados, devem estar vinculados a um grupo ou tabela previamente aplicado
ao Corpo do layout.
Principais Funcionalidades dos Relatrios

Grficos
Mltiplos layouts para o mesmo relatrio.
Desenho de formulrios.
Uso de formulrios pr-impressos.
Cpia de Layouts.
Seleo dos Layouts para gerao do Relatrio Grfico.
Fluxograma bsico de criao de um relatrio

grfico e edio de layouts.
Anotaes
Procedimentos
Criando Relatrios Grficos
O objetivo deste procedimento descrever os passos para criao de um
Relatrio Grfico.
1. Acionar o boto Relatrios no menu principal do Data Viewer.
2. Acionar o boto Incluir da janela Manuteno de Relatrios (GR0103).
3. Na janela Inclui Relatrios (GR0103A), insira as seguintes informaes:
O nome do relatrio a ser gerado deve ter 6 (seis) caracteres quaisquer no
nome, mais uma ou duas letras, de "a" at "bz", como forma de controle de
verses de um mesmo relatrio.
Campo Contedo Observao

Relatrio Proc06AA Nesse campo inserido o cdigo do layout grfico
que est sendo cadastrado, conforme as regras
descritas acima.
Ttulo Ttulos do Nesse campo inserido o nome do relatrio
Cliente grfico que est sendo cadastrado.
Ttulo Ttulos por Nesse campo inserido o ttulo que identifica a
Classificao Cliente classificao do relatrio.
Perfil EMS2.0 Nesse campo selecionado o perfil do relatrio a
ser gerado. As opes disponveis so:
EMS 2.0, correspondente aos produtos EMS
2.0 e HR do ERP Datasul e importado na
inicializao do Data Viewer por intermdio
do arquivo grbloco2.d.
EMS 5.0, correspondente ao produto EMS 5.0
do ERP Datasul e importado na inicializao
do Data Viewer por intermdio do arquivo
grbloco5.d.
Magnus I, correspondente ao produto
Magnus I do ERP Datasul e importado na
do arquivo grblocoi.d.
WebDesk, correspondente ao produto
WebDesk da Datasul e importado na
do arquivo grblocow.d.
Outros, correspondente a outro produto
Progress e importado na inicializao do Data
Viewer por intermdio do arquivo grbloco.d.
4. Selecionar o campo Relatrio Grfico.

5. Acionar o boto OK, na janela Inclui Relatrios (GR0103A).
6. Selecionar, com um duplo clique de mouse, o relatrio que acaba de ser
includo para retornar ao menu principal do Data Viewer.
7. Acionar o boto tabelas do menu principal do Data Viewer.
8. Na janela Tabelas do Relatrio, selecionar a tabela titulo na lista de
tabelas disponveis.
9. Acionar o boto incluir para transferir a tabela titulo para a lista de tabelas
selecionadas.
Aps seleo de cada tabela, permanecem exibidas na lista de tabelas
disponveis somente aquelas que possuem relacionamento com as tabelas
utilizadas. A manuteno de relacionamentos entre tabelas feita por
intermdio da Funo Manuteno de Relacionamentos.
10. Na janela Tabelas do Relatrio, selecionar a tabela emitente na lista de

tabelas disponveis.
11. Acionar o boto incluir para transferir a tabela emitente para a lista de
tabelas selecionadas.
12. Na janela Tabelas do Relatrio, selecionar a tabela estabelecimento na
lista de tabelas disponveis.
13. Acionar o boto incluir para transferir a tabela estabelecimento para a
lista de tabelas selecionadas.
14. Acionar o boto OK da janela Tabelas do Relatrio (GR0104).
Anotaes
Editando Layouts
Os objetivos deste procedimento so apresentar o Data Viewer Layout Editor,
suas principais opes de menu e barras de ferramentas, e descrever os
passos para edio de um layout de um Relatrio Grfico.
Para que se consiga utilizar a funo Manuteno de Layouts (GR0150),
necessrio que se tenha selecionado um relatrio do tipo Relatrio Grfico.
Essa seleo feita por intermdio da funo Manuteno de Relatrios
(GR0103), e que o relatrio possua tabelas relacionadas ao mesmo. Esse
relacionamento efetuado por intermdio da funo Tabelas do Relatrio.
1. No menu principal do Data Viewer, acionar o boto Editor de Layouts.

2. Na janela Manuteno de Layouts, acionar o boto Novo ou Modifica
para chamar o editor de Layouts.
3. Na janela Propriedades do Layout Pasta Configurao, preencher as
informaes a seguir:
Margens 2.54 Nesse campo so inseridos os valores a serem
considerados no espaamento das margens superior,
inferior, esquerda e direita do relatrio. As margens da
pgina permitem que seja definida uma rea de uso
exclusivo para definio do cabealho e rodap do
relatrio.
Tamanho A4 Nesse campo selecionado, entre as opes
do Papel disponveis, o tamanho do papel utilizado na
impresso do relatrio gerado por esse layout.
Caso as opes disponveis no atendam as
necessidades, possvel informar um tamanho
personalizado por intermdio dos campos Altura e
Largura.
Orientao Paisagem Nesse campo selecionada a orientao a ser
considerada para a gerao do layout.
Retrato - determina que a maior dimenso do layout
fica disposta na vertical.
Paisagem - determina que a maior dimenso do
layout fica disposta na horizontal.

Layout Formulrio Nesse campo selecionado o tipo de layout a ser
gerado.
Formulrio - permite aplicao de grupos e tabelas
com posicionamento vertical fixo no layout. para
impresso no seqencial das informaes obtidas
nos bancos de dados.
Listagem - permite aplicao exclusiva de tabelas
sem posicionamento vertical fixo no layout, para
impresso sucessiva de linhas com as informaes
obtidas nos bancos de dados.
Descrio Form - Nesse campo inserida uma breve descrio sobre o
do Layout Ttulos layout que est sendo cadastrado.
A unidade de medida considerada para definio da margem e do tamanho do

papel pode ser apresentada em centmetros ou polegadas. A identificao da
unidade de medida utilizada apresentada entre parnteses ao lado do
agrupador de informaes Margem e Tamanho do Papel. A alterao da
unidade de medida pode ser efetuada por intermdio da Barra de Menu -
Extras, opo Unidade de Medida.
4. Na opo Imprimir somente dados,definir o valor como no.

5. Na janela Propriedades do Layout, acionar a pasta Classificao.
6. Na janela Propriedades do Layout Pasta Classificao, selecionar a
tabela emitente.
7. Selecionar o atributo cod-emitente da tabela.
8. Acionar o boto Incluir.
9. Na janela Propriedades do Layout Pasta Classificao, preencher as
informaes a seguir para a classificao:
Classificao Ordem Quebra

Emitente.cod-emitente Crescente X
10. Acionar o boto OK.

11. Ambientar-se com o Data Viewer Layout Editor, identificando a Barra de
Menu, Barra de Botes Padro, Barra de Formatao, rvore de
Visualizao e a rea de Edio.
12. Arrastar um grupo para dentro do layout.
13. Arrastar os seguintes objetos para do grupo:
Tabela Atributo Objeto

emitente Cod-emitente Cdigo
emitente Cod-emitente >>>>>>>>9
Emitente Nome-emit Nome
Emitente Nome-emit X(40)
Emitente Lim-credito Limite Crdito
Emitente Lim-credito >>>,>>>,>>9
14. Alinhar os textos com os atributos correspondentes.

15. Efetuar duplo clique no atributo emitente.nome-emit para visualizar a tela
e depois cancelar.
Anotaes
Definindo o Cabealho e Rodap do Layout

Os objetivos deste procedimento so apresentar as propriedades do layout
que definem as reas de cabealho e rodap, destacar os elementos de
edio que podem ser utilizados nessas reas, e descrever os passos de
edio do cabealho e ou rodap do layout.
1. Acionar as Propriedades do Layout.
2. Na janela Propriedades do Layout Pasta Configurao, observar suas
propriedades.
Campo Observao
Margens Nesse campo so inseridos os valores a serem considerados no
espaamento das margens superior, inferior, esquerda e direita do
relatrio. As margens da pgina permitem que seja definida uma
rea de uso exclusivo para definio do cabealho e rodap do
relatrio.
Tamanho Nesse campo selecionado, entre as opes disponveis, o
do Papel tamanho do papel utilizado na impresso do relatrio gerado por
esse layout.
Caso as opes disponveis no atendam as necessidades,
possvel informar um tamanho personalizado por intermdio dos
campos Altura e Largura.
A rea de cabealho e rodap definida por intermdio das Propriedades do

Layout. O tamanho do papel e as margens determinam as reas para edio
do cabealho e rodap do relatrio.
A unidade de medida considerada para definio da margem e do tamanho do

papel pode ser apresentada em centmetros ou polegadas. A identificao da
unidade de medida utilizada apresentada entre parnteses ao lado do
agrupador de informaes Margem e Tamanho do Papel. A alterao da
unidade de medida pode ser efetuada por intermdio da Barra de Menu -
Extras, opo Unidade de Medida.
3. Observando as regras de aplicao de elementos de edio nas reas de

cabealho e rodap, faa um exerccio de arrastar elementos para dentro
dessas reas.
A figura abaixo ilustra, por intermdio de um organograma, o relacionamento

dos elementos de edio com o cabealho e rodap do layout do relatrio
grfico.
Anotaes
Identificando os Elementos de Edio

O objetivo deste procedimento apresentar as propriedades dos principais
elementos de edio de um layout de Relatrio Grfico.
1. Arrastar para dentro da rea de edio do cabealho do layout um objeto
Texto da rvore de Visualizao.
2. Na janela Propriedades Texto, observar suas propriedades:
Campo Observao
Nome Nesse campo inserido o nome do objeto texto.
Valor Nesse campo inserido o valor do objeto texto.
Objeto Quando assinalado, determina que o objeto faz parte do
Formulrio formulrio.
Importante:
Objetos que fazem parte do formulrio so desconsiderados
quando o usurio seleciona a opo Imprimir Somente Dados.
3. Arrastar para dentro da rea de edio do cabealho do layout um objeto

Imagem da rvore de Visualizao.
4. Na janela Propriedades da Imagem, observar suas propriedades.
Campo Observao
Nome Nesse campo inserido o nome do objeto texto.
Caminho Nesse campo selecionado o caminho de endereamento do
arquivo da imagem.
Imagem Nesse campo inserido o nome do arquivo da imagem.
Objeto Quando assinalado, determina que o objeto faz parte do
Formulrio formulrio.
Importante:
Objetos que fazem parte do formulrio so desconsiderados
quando o usurio seleciona a opo Imprimir Somente Dados.
5. Arrastar para dentro da rea de um grupo o objeto Campo Calculado da

rvore de Visualizao.
6. Na janela Propriedades Campo Calculado Pasta Dados, observar suas
propriedades.
Campo Observao
Nome Nesse campo inserido o nome do campo calculado.
Tipo Nesse campo selecionado o tipo de dado do campo calculado. As
Dado opes disponveis so: caractere, inteiro, decimal, data e lgico.
Campo Observao
Formato Nesse campo inserido o formato a ser utilizado pelo campo
calculado.
Os formatos disponveis para seleo esto descritos no manual de
referncia do produto.
7. Selecionar a pasta Frmula da janela Propriedades Campo Calculado.

8. Na janela Propriedades Campo Calculado Pasta Frmula, observar
suas propriedades.
Campo Observao
Frmula Nesse campo deve ser inserido o cdigo Progress representativo da
frmula do campo calculado.
9. Definir a seguinte frmula para o campo calculado:

emitente.nome-abrev + " - " + string(emitente.cod-emitente) + " - " +
string(emitente.lim-credito)
10. Arrastar para dentro da rea de edio do layout o objeto Tabela da

rvore de Visualizao.
11. Selecionar a pasta Posio da janela Propriedades da Tabela.
12. Na janela Propriedades da Tabela Pasta Posio, observar suas
propriedades.
13. Selecionar a pasta Segmento da janela Propriedades da Tabela.

14. Na janela Propriedades da Tabela Pasta Segmento, observar suas

propriedades.
Campo Observao
Cabealho Quando assinalado, determina que o cabealho da tabela deve
ser impresso.
Imprimir Quando assinalado, determina que a borda do cabealho da
Borda tabela ser impressa na gerao do relatrio.
Cada parte do relatrio (Cabealho, Dados, Clculo e Rodap)
possui a opo de imprimir ou no a borda.
Imprimir Quando assinalado, determina que as linhas de grade do
Grade cabealho da tabela sero impressas na gerao do relatrio.
Cada parte do relatrio (Cabealho, Dados, Clculo e Rodap)
possui a opo de imprimir ou no a grade.
Dados Quando assinalado, determina que os dados devem ser
impressos.
Clculo Quando assinalado, determina que clculos da tabela podem ser
realizados e impressos.
Rodap Quando assinalado, determina que o rodap deve ser impresso
Classificao Nesse campo deve ser selecionada a classificao a ser aplicada
para o clculo. Essa classificao utilizada na gerao do
relatrio.
As classificaes so definidas nas propriedades do layout.
A Qtde Registos aplica-se apenas para layouts do tipo formulrio e permite

definir a quantidade mxima de registros a serem impressos por pgina
15. Selecionar para a classificao de dados o valor SEM

CLASSIFICAO.
16. Informar o valor 5 para o atributo Qtde Registros e desabilitar a rea de

Rodap.
17. Selecionar a pasta Fonte Livre da janela Propriedades da Tabela.

Fonte livre, um cdigo fonte em Progress e de autoria do usurio.O usurio
pode selecionar atributos das tabelas para insero na rea de edio do
fonte.
18. Adicionar o seguinte cdigo na opo de fonte livre da tabela:
/* EXEMPLO DE FONTE LIVRE - TABELA */
19. Confirmar a adio da tabela atravs do boto OK.
20. Selecionar a tabela e acionar o boto Editar Tabela.
21. Arrastar os seguintes objetos da tabela Ttulo nos respectivos segmentos,

conforme tabela abaixo (obedecer ordem de incluso):
Atributo Objeto Segmento
ep-codigo Emp Cabealho
ep-codigo 999 Dados
cod-estabel Estab Cabealho
cod-estabel XXX Dados
cod-esp Esp Cabealho
cod-esp !! Dados
serie Srie Cabealho
serie XXXXX Dados
nr-docto Documento Cabealho
nr-docto XXXXXXXXXXXXXXXX Dados
parcela /P Cabealho
parcela XX Dados
Dt-emissao Dt Emisso Cabealho
Dt-emissao 99/99/9999 Dados
Dt-vencimen Dt Vcto Cabealho
Dt-vencimen 99/99/9999 Dados
Vl-original Vl Original Cabealho
Vl-original >>>>>>>,>>9.99 Dados
Vl-saldo Valor Saldo Cabealho
Vl-saldo >>>>>>>,>>9.99 Dados
22. Depois de adicionados na tabela, selecionar a opo de alinhamento de

colunas da tabela ( esquerda ou direita).
23. Sair do modo de edio.
24. Posicionar corretamente a tabela no formulrio.
25. Arrastar para dentro da rea de edio do layout um novo grupo.

26. Arrastar para dentro da rea de edio do novo grupo layout o objeto
Clculo da rvore de Visualizao.
27. Na janela Propriedades Clculo Pasta Dados, observar suas
propriedades.
Nome v-media-saldoNome da varivel que armazenar o clculo.
Tipo decimal Nesse campo deve ser selecionado o tipo de dado da
Dado varivel. As opes disponveis so: caractere, inteiro,
decimal, data, lgico.
Tabela titulo Deve ser selecionada a tabela utilizada para o clculo
da varivel.
Campo Vl-saldo Deve ser selecionado o campo utilizado para o clculo
da varivel.
Formato >>>>>>>,>>9.99 Nesse campo deve ser inserido o formato de
apresentao do contedo do campo.
Os formatos disponveis esto descritos no manual de
referncia do produto.
O campo Classificao exibe a opo de classificao da Tabela ou Grupo,

conforme a classificao definida nas propriedades do layout.
28. Selecionar a pasta Clculo da janela Propriedades Clculo.

29. Na janela Propriedades Clculo Pasta Clculo, observar suas
propriedades, selecionar o tipo clculo igual MDIA e atualizar as
informaes atravs do boto atualizar.
Campo Observao
Tipo Nesse campo necessrio selecionar o tipo de clculo que este
Clculo atributo (varivel) vai armazenar.
Contador, permite a gerao de um cdigo Progress que monta
um contador de registros dentro da classificao informada.
Mximo, permite a gerao de um cdigo Progress que armazena
na varivel de clculo o maior valor dentro da classificao
informada.
Mnimo, permite a gerao de um cdigo Progress que armazena
na varivel de clculo o menor valor dentro da classificao
informada.
Mdia, permite a gerao de um cdigo Progress que armazena
na varivel de clculo a mdia aritmtica dentro da classificao
informada.
Livre, permite a gerao de um cdigo Progress, somente para a
parte correspondente as Definies, deixando livre para o usurio
a codificao das partes Primeiro, Clculo e ltimo.
Total, permite a gerao de um cdigo Progress que armazena
na varivel de clculo a somatria dos valores dentro da
classificao informada
Quando acionado o boto clculo, o programa gera o cdigo fonte

correspondente ao tipo de clculo. Para cada tipo de clculo existem partes
de cdigo Progress padronizado correspondente a Definio, Primeiro,
Clculo e ltimo. Sempre que acionado, o cdigo fonte do clculo gerado
sobrepondo eventuais alteraes manuais feitas no cdigo pelo usurio.
30. Para visualizar o cdigo fonte gerado para cada uma das partes,
selecione a opo desejada. Eventualmente, esse cdigo pode ser
alterado pelo usurio.
Definio - cdigo com a definio das variveis necessrias para o tipo de
clculo selecionado. Exemplo de cdigo gerado para MDIA:
var d-Media_Cotacao as decimal no-undo.
def var Media_Cotacao as decimal format ">>>.>>9,99999" no-undo.
Primeiro - cdigo para inicializao das variveis conforme o tipo de clculo

selecionado. Exemplo de cdigo gerado para MDIA:
assign d-Media_Cotacao = 0.
assign Media_Cotacao = 0.
Clculo - cdigo para execuo dos clculos conforme o tipo clculo

assign d-Media_Cotacao = d-Media_Cotacao + 1.

assign Media_Cotacao = Media_Cotacao + cotacao.cota-mensal.
ltimo - cdigo para finalizao do clculo conforme o tipo de clculo

assign Media_Cotacao = Media_Cotacao / d-Media_Cotacao.
Sempre que acionado o boto Atualiza, o cdigo fonte do clculo gerado

sobrepondo eventuais alteraes manuais feitas no cdigo pelo usurio.
31. Criar um total de Valor Saldo (campo vl-saldo) de Ttulos (tabela titulo) por
Emitente (classificao emitente.cod-emitente). Pode ser utilizado um
objeto total ou clculo. Utilizar o formato >>>>>>>,>>9.99.
32. Criar textos para representar os rtulos dos objetos criados.
33. Criar uma faixa de seleo pelo Cdigo do Emitente, com valores iniciais
pr-definidos de 25 at 40.
Anotaes
Identificar os Recursos de Formao do Layout

O objetivo deste procedimento destacar as opes disponveis na barra de
ferramentas de formatao do Data Viewer Layout Editor.
A barra de ferramenta padro apresenta os botes das principais opes de

formatao do editor de layouts do Relatrio Grfico.
Boto Nome Descrio
Negrito Quando acionado, altera o estilo da

fonte de um objeto selecionado para
negrito.
Itlico Quando acionado, altera o estilo da

fonte de um objeto selecionado para
itlico.
Esquerda Quando acionado, alinha o contedo

do texto a esquerda do objeto.
Centro Quando acionado, alinha o contedo

do texto ao centro do objeto.
Direita Quando acionado, alinha o contedo

do texto a direita do objeto.
Topo Quando acionado, desloca o

contedo do texto para o topo do
objeto.
Meio Quando acionado, desloca o

contedo do texto para o meio do
objeto.
Rodap Quando acionado, desloca o

contedo do texto para o rodap do
objeto.
Tipo Fonte Selecionar o tipo de fonte a ser

aplicado ao texto de um objeto.
Boto Nome Descrio

Tamanho Fonte Selecionar o tamanho de fonte a ser
aplicado ao texto de um objeto.
Cor Fonte Selecionar a cor a ser aplicada a

fonte do texto de um objeto.
Cor Selecionar a cor a ser aplicada ao

Preenchimento objeto selecionado.
Cor Linha Selecionar a cor a ser aplicada ao

objeto selecionado.
1. Utilizar as opes de formatao acima para formatar os objetos

adicionados.
Anotaes
Identificar as Informaes Extras

O objetivo deste procedimento destacar as opes disponveis na barra de
ferramentas de Extras do Data Viewer Layout Editor.
A barra de ferramenta Extras apresenta opes de parametrizao do editor

de layouts do Relatrio Grfico.
Opes Tecla de Descrio
Atalho
Barra de Ctrl+Alt+S Quando acionado, habilita/desabilita a barra de status.

Status
Barra de Ctrl+Alt+U Quando acionado, habilita/desabilita a barra de
Ferramentas ferramentas.
Dicas Ctrl+Alt+I Quando acionado, habilita/desabilita a exibio de
dicas durante a utilizao.
Grade Ctrl+Alt+G Quando acionado, apresenta a janela Grade, a qual
permite definir o espaamento entre os pontos da
grade.
Importante:
A definio do espaamento entre pontos da grade
somente permitida quando a opo Grade, do menu
Visualizao, estiver ativada.
Unidade de Selecionar a escala a ser considerada para
Medida visualizao das medidas no Editor de Layout do
Relatrio Grfico. As opes disponveis so:
Centmetros, quando selecionado, determina
que centmetro escala a ser utilizada para
visualizao das medidas.
Opes Tecla de Descrio

Atalho
Polegadas, quando selecionado, determina que
polegada escala a ser utilizada para
visualizao das medidas.
Importante:
Essa parametrizao altera de forma automtica a
visualizao das medidas nas Propriedades do Layout,
Propriedades do Campo Calculado, Propriedades da
Tabela, Propriedades do Objeto (Campo BD) e na
Rgua do menu de Visualizao.
Visualizao Selecionar a visualizao a ser utilizada para os
campos da base de dados. As opes disponveis so:
Nome, quando selecionado, determina que os
campos da base de dados sero apresentados
pelos seus nomes.
Descrio, quando selecionado, determina que
os campos da base de dados sero apresentados
pelas suas descries.
Log Console Ctrl+Alt+L Quando acionado, permite visualizar os erros que
ocorrem durante a execuo do editor.
Anotaes
Salvando o Layout do Relatrio Grfico

O objetivo deste procedimento bsico descrever os passos para salvar um layout de
Relatrio Grfico.
1. Na janela principal do Data Viewer Layout Editor, acionar o boto Salvar.

2. Na janela Salvar Layout, inserir o nome do layout e acionar o boto Salvar
para concluir o procedimento.
Anotaes
Mantendo Layouts dos Relatrios Grficos

O objetivo deste procedimento descrever as principais caractersticas da
funo Manuteno de Layouts.
Ao acionar o boto Editor de Layout, no menu principal do Data Viewer,
apresentada a janela Manuteno de Layouts (GR0150). Nessa janela,
destacam-se os seguintes botes:
Boto Nome Descrio
Novo Quando acionado, executa o editor de layout e inicializa um novo

layout.
Modifica Quando acionado, executa o editor de layout e abre o layout

selecionado, no qual permitido alterar o layout do relatrio
grfico selecionado.
Elimina Quando acionado, permite eliminar o layout do relatrio grfico
selecionado.
Cpia Quando acionado, apresenta a janela Cpia Layout (GR0150C), a
qual permite gerar uma cpia do layout selecionado.
Filtro Quando acionado, apresenta a janela Faixa de Layouts do

Relatrio (GR0150F), a qual permite informar uma faixa de layouts
a serem considerados para exibio na janela Manuteno de
Layouts.
Gerar Quando assinalado, permite determinar se o relatrio est pronto
ou no para ser utilizado.
Anotaes
Biblioteca de Funes
O objetivo deste procedimento demonstrar alguns recursos adicionais que
podem ser utilizados atravs do uso de Fontes Livres, especficos para
Relatrios Grficos.
A Biblioteca de Funes, responsvel por obter os dados do relatrio e os
dados do layout e transformar no PDF final, executada automaticamente
pelo Data Viewer da seguinte forma:
run dvrt/lib/dvlib.p persistent set h-FunctionLibrary.Onde:
dvrt/lib/dvlib.p o arquivo referente a Biblioteca de Funes.
h-FunctionLibrary a varivel de referncia a Biblioteca de Funes
(essa varivel ser utilizada pelo usurio quando o mesmo quiser executar
alguns mtodos adicionais em fontes livres).
A seguir sero demonstrados os mtodos disponveis na Biblioteca de
Funes que podem ser utilizados pelos usurios a partir do .P gerado.
A lista de mtodos a seguir apresenta para cada mtodo o nome do mtodo,
seu objetivo, os parmetros necessrios e um exemplo de execuo:
Mtodo: SetColor
Objetivo: Permite ao usurio alterar a cor do objeto de uma tabela/grupo em

tempo de execuo do relatrio. Dessa forma, possvel atravs de
codificao imprimir um determinado valor de objeto de uma cor X caso
atenda uma condio e de uma cor Z caso a condio no seja
atendida.
No parmetro referente cor podem ser utilizados:
black, silver, gray, white, maroon, red, purple, fuchsia, green, lime, olive,
yellow, navy, blue, teal, acqa.
Hexadecimal - Exemplo: #FFFF00
Formato RGB - Exemplo: rgb(255,0,0)
Parmetros: - INPUT PARAMETER p-nome-tabela AS CHAR

- INPUT PARAMETER p-nome-objeto AS CHAR
- INPUT PARAMETER p-cor AS CHAR
Exemplo: run setColor in h-FunctionLibrary

(<tabela|grupo>,<objeto>,<cor>).
Mtodo: setBackgroundColor
Objetivo: Permite ao usurio alterar a cor de fundo do objeto de uma tabela/grupo

em tempo de execuo do relatrio. Dessa forma, possvel atravs de
codificao imprimir um determinado valor de objeto de uma cor X caso
atenda uma condio e de uma cor Z caso a condio no seja
atendida.
No parmetro referente cor podem ser utilizados:
black, silver, gray, white, maroon, red, purple, fuchsia, green, lime, olive,
yellow, navy, blue, teal, acqa.
Hexadecimal - Exemplo: #FFFF00
Formato RGB - Exemplo: rgb(255,0,0)

- INPUT PARAMETER p-cor AS CHAR
Exemplo: run setBackgroundColor in h-FunctionLibrary

(<tabela|grupo >,<objeto>,<cor>).
Mtodo: setInvisible
Objetivo: Permite ao usurio ocultar o valor de um objeto no relatrio.

- INPUT PARAMETER p-valor AS CHAR
Exemplo: Rum setinvisible in h-Functionalibrary

(<tabela|grupo >,<objeto>,<yes|no>).
Mtodo: setObjectNewValue
Objetivo: Permite ao usurio alterar o valor do objeto de uma tabela/grupo em

tempo de execuo do relatrio.
O uso do mtodo setObjectNewValue deve ser efetuado ANTES dos
mtodos writePage, writeBody e writeCalc, atravs de fontes livres.

- INPUT PARAMETER p-valor AS CHAR
Exemplo: run setObjectNewValue in h-FunctionLibrary

(<tabela|grupo >,<objeto>,<valor>).
Anotaes
Estudo de Caso
Cenrio
Criar um layout do tipo formulrio para imprimir boletos bancrios contendo
inclusive Cdigo de Barras.
No cadastramento do relatrio, selecionar as seguintes tabelas (pode ser
utilizado o mesmo relatrio do exerccio anterior, criando apenas um novo
layout):
titulo
emitente
estabelec (estabelecimento)
Utilizar a seguinte classificao:

ttulo.ep-codigo
titulo.cod-estabel
titulo.cod-esp
titulo.serie
titulo.nr-docto
titulo.parcela (com quebra de pgina)
Utilizar as seguintes informaes:

Rtulo Atributo
Pagamento Banco do Brasil S/A (texto)
Vencimento Titulo.dt-vencimen
Cedente Estabelec.nome
Agencia/Cta (campo calculado) string(titulo.agencia) + "/" +
Corrente string(titulo.ct-conta-cr)
Data Titulo.dt-emissao
Emisso
Parcela Titulo.parcela
Referencia Titulo.dt-confirma
Valor Ttulo.vl-original
Documento
Instrues ATENO SR. CAIXA APS O VENCIMENTO
PAGAVEL SOMENTE NO BANCO DO BRASIL
Desconto (deixar espao para preenchimento)
Acrscimo (deixar espao para preenchimento)
Valor (deixar espao para preenchimento)
Cobrado
Rtulo Atributo
Sacado Emitente.nome-emit
Emitente.endereo
Emitente.cidade / Emitente.estado / Emitente.cep
Cdigo de (Campo calculado) string(titulo.agencia) +
Barras string(titulo.ct-conta-cr) + string(titulo.vl-original)
Criar a seguinte condio:

- Caso o valor do documento (Ttulo.vl-original) seja maior que R$ 10.000,00,
mostrar o valor do mesmo em amarelo, com a cor de fundo vermelho.
Resultados Esperados com o Cenrio

Checklist Atingido Observao
Relatrio Grfico do tipo
FORM cadastrado.
Todas as informaes
solicitadas constantes no
relatrio.
Classificao das
informaes e a quebra
de pgina devidamente
parametrizadas.
A condio do valor do
documento criada.
Layout do Relatrio
Grfico Salvo.
35

DataViewer 6

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

DataViewer 6

Uploaded by

Copyright:

Available Formats

Manual de Treinamento

Crie voc mesmo layouts e programas de relatrio.

Este manual foi construdo com base na metodologia de Planejamento

Como o Manual Organizado

Convenes Usadas neste Manual

Este cone identifica uma Observao, isto , um comentrio adicional

Este cone indica Cuidado, isto , as informaes apresentadas alertam

Este cone identifica uma lista de Pr-requisitos para a realizao de uma

Benefcios para o Usurio

Objetivos Especficos do Treinamento

Definir o cabealho e o rodap do layout do Relatrio grfico.

Principais Conceitos dos Relatrios Grficos

Elementos de edio do Layout

Objetos: Dentre os Objetos, destacam-se o Grupo e a Tabela. O

Campos da Base de Dados: Todos so provenientes das tabelas

Constantes: So contedos padro do Data Viewer exibidos nos

Aplicao dos elementos de edio nas partes do Layout

No Cabealho e Rodap, as opes disponveis so:

No Corpo, as opes disponveis so:

1) Quando as regras de aplicao dos elementos nas reas do layout so

2) Os nicos elementos que podem ser aplicados diretamente no Corpo do

Principais Funcionalidades dos Relatrios

Fluxograma bsico de criao de um relatrio

Campo Contedo Observao

4. Selecionar o campo Relatrio Grfico.

10. Na janela Tabelas do Relatrio, selecionar a tabela emitente na lista de

1. No menu principal do Data Viewer, acionar o boto Editor de Layouts.

Campo Contedo Observao

A unidade de medida considerada para definio da margem e do tamanho do

4. Na opo Imprimir somente dados,definir o valor como no.

Classificao Ordem Quebra

10. Acionar o boto OK.

Tabela Atributo Objeto

14. Alinhar os textos com os atributos correspondentes.

Definindo o Cabealho e Rodap do Layout

A rea de cabealho e rodap definida por intermdio das Propriedades do

A unidade de medida considerada para definio da margem e do tamanho do

3. Observando as regras de aplicao de elementos de edio nas reas de

A figura abaixo ilustra, por intermdio de um organograma, o relacionamento

Identificando os Elementos de Edio

3. Arrastar para dentro da rea de edio do cabealho do layout um objeto

5. Arrastar para dentro da rea de um grupo o objeto Campo Calculado da

7. Selecionar a pasta Frmula da janela Propriedades Campo Calculado.

9. Definir a seguinte frmula para o campo calculado:

10. Arrastar para dentro da rea de edio do layout o objeto Tabela da

13. Selecionar a pasta Segmento da janela Propriedades da Tabela.

14. Na janela Propriedades da Tabela Pasta Segmento, observar suas

A Qtde Registos aplica-se apenas para layouts do tipo formulrio e permite

15. Selecionar para a classificao de dados o valor SEM

16. Informar o valor 5 para o atributo Qtde Registros e desabilitar a rea de

17. Selecionar a pasta Fonte Livre da janela Propriedades da Tabela.

18. Adicionar o seguinte cdigo na opo de fonte livre da tabela:

/* EXEMPLO DE FONTE LIVRE - TABELA */

19. Confirmar a adio da tabela atravs do boto OK.

20. Selecionar a tabela e acionar o boto Editar Tabela.

21. Arrastar os seguintes objetos da tabela Ttulo nos respectivos segmentos,

22. Depois de adicionados na tabela, selecionar a opo de alinhamento de

23. Sair do modo de edio.

24. Posicionar corretamente a tabela no formulrio.

25. Arrastar para dentro da rea de edio do layout um novo grupo.

O campo Classificao exibe a opo de classificao da Tabela ou Grupo,

28. Selecionar a pasta Clculo da janela Propriedades Clculo.

Quando acionado o boto clculo, o programa gera o cdigo fonte

Primeiro - cdigo para inicializao das variveis conforme o tipo de clculo