Manual de Treinamento

DATA VIEWER

Processo Definio da Interface

do Relatrio

Crie voc mesmo os 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 040601
 i

ndice

Prefcio.............................................................................................. iii
Como o Manual Organizado ...................................................................... iii
Convenes Usadas neste Manual .............................................................. iv
Processo Definio da Interface do Relatrio.................................. 5
Objetivo do Processo.....................................................................................5
Benefcios para o Usurio..............................................................................5
Objetivos Especficos do Treinamento ..........................................................5
Fluxograma ....................................................................................................6
Procedimentos ...............................................................................................7
Definindo Selees para o Relatrio .........................................................7
Definindo Variveis para o Relatrio .........................................................9
Definindo Parmetros para o Relatrio ...................................................11
Inserindo pequenos cdigos Progress no fonte do relatrio ...................13
Definindo Parmetros de Entrada ...........................................................16
Definindo Procedures Internas ................................................................17
Estudo de Caso ...........................................................................................19
 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.

Este cone usado para indicar que existem informaes complementares a

 serem buscadas no manual de referncia correspondente. Na verso digital
deste manual, ao clicar sobre este cone, possvel abrir o manual de
referncia no ponto desejado.
Este cone, acompanhado da inscrio Volta para Apresentao, s tem validade
 para a verso digital deste manual. Serve para abrir e/ou voltar para a
apresentao do treinamento, no prximo processo a ser examinado.
 5

Processo Definio da Interface

do Relatrio

Objetivo do Processo
Definir a interface que ser exibida e os parmetros que sero solicitados ao
usurio no momento da execuo do programa do relatrio.

Benefcios para o Usurio

As principais vantagens em definir as interfaces so:
Saber definir atributos e parmetros para seleo das informaes e
execuo do relatrio.
Aprender a customizar o relatrio por intermdio da criao e insero de
pequenas partes de cdigo no programa fonte gerado pelo Data Viewer.

Objetivos Especficos do Treinamento

Aps o treinamento neste processo, voc dever estar apto a:
Definir os atributos de seleo das informaes das tabelas a serem
consideradas pelo relatrio.
Definir variveis a serem utilizadas em tempo de execuo pelo programa
de relatrio.
Definir os parmetros de validao das informaes a serem
consideradas pelo relatrio.
Identificar como pequenos cdigos Progress podem ser inseridos no
programa de relatrio.
Definir os parmetros de entrada, pr-requisitos de execuo do
programa do relatrio.
6 Processo Definio da Interface do Relatrio

Identificar como criar e salvar Procedures Internas, pequenos cdigos

Progress que podem ser reutilizados em diversos pontos do programa de
relatrio.

Fluxograma
Processo Definio de Interfaces

Incio

Definir Selees Incluir Cdigos no

para o Relatrio Fonte

Determinar
Criar Variveis
Parmetros de
para o Relatrio
Entrada

Definir Parmetros Definir Procedures

do Relatrio Internas

Fim
 Processo Definio da Interface do Relatrio 7

Procedimentos
Definindo Selees para o Relatrio
O objetivo desse procedimento definir os atributos de seleo das
informaes das tabelas a serem consideradas pelo relatrio.
1. Selecionar para edio o Relatrio PROC03AA.
2. No menu principal do Data Viewer, acionar o boto Seleo.
3. Na janela Selees do Relatrio (GR0110), selecionar os atributos da
tabela a serem utilizados para seleo das informaes e acionar o boto
Incluir, aps cada seleo, para incluir na lista de atributos selecionados
para classificao. Nesse exerccio devero ser selecionados os atributos
a seguir:
Tabela Atributo
Ordem-compra Cod-estabel
Ordem-compra Cod-emitente
Ordem-compra Dat-ordem

4. Na janela Selees do Relatrio (GR0110), selecione, na lista de atributos

j selecionados para seleo, selecione o atributo a seguir e acione o
boto Valores.
Tabela Atributo
Ordem-compra Dat-ordem

5. Na janela Manuteno de Valores, inserir as seguintes informaes:

Campo Contedo Observao
Gera Sim Esse campo, quando assinalado, determina que o fonte
Valores de relatrio ser gerado inicializando as variveis
Inicias correspondentes com os valores definidos nos campos
faixa inicial e final.
Faixa 01/01/1990 Nesse campo inserido o valor de inicializao da
Inicial varivel correspondente a faixa inicial do atributo de
seleo das informaes do relatrio.
Faixa 12/31/2002 Nesse campo inserido o valor de inicializao da
Final varivel correspondente a faixa final do atributo de
seleo das informaes do relatrio.

6. Acionar o boto OK, para confirmar os valores inseridos e retornar a

janela Selees do Relatrio (GR0110).
8 Processo Definio da Interface do Relatrio

7. Na janela Selees do Relatrio (GR0110), acionar o boto OK, para

confirmar as selees definidas para o Relatrio e retornar para o menu
principal do Data Viewer.
Anotaes
 Processo Definio da Interface do Relatrio 9

Definindo Variveis para o Relatrio

O objetivo deste procedimento definir variveis a serem utilizadas como
parmetros de execuo pelo programa de relatrio.
1. No menu principal do Data Viewer, acionar o boto Variveis.
2. Na janela Manuteno de Variveis (GR0124), pressione o boto Incluir.
3. Na janela Inclui Variveis no Relatrio (GR0124A), insera as seguintes
informaes:
Campo Contedo Observao
Varivel l-manual Nesse campo inserido o nome da varivel a
ser cadastrada.
Importante:
No podem ser inseridos espaos em branco,
caracteres especiais ou acentuao.
Rtulo Manual Nesse campo inserido um ttulo ou descrio
para a varivel.
Formato Sim/No Nesse campo inserido o formato a ser utilizado
pelo campo calculado.
Inicial Sim Nesse campo inserido o valor de inicializao
da varivel para execuo do relatrio.
Tipo de dado Lgico Nesse campo selecionado o tipo de dado da
varivel. As opes disponveis so:
Caractere.
Inteiro
Decimal
Data
Lgico
Visualizador - Nesse campo selecionado a forma de
visualizao da varivel. As opes disponveis
so fill-in, radio-set, combo-box.
Importante:
Somente permitida seleo do visualizador
para variveis do tipo inteiro ou caracter.
Variveis do tipo Decimal e Data tem
visualizador fill-in.
Variveis do tipo lgico tem visualizador "toggle-
box".
Valor Visualizador - Nesse campo selecionado o contedo que
ser utilizado para o visualizador (radio-set,
combo-box).
10 Processo Definio da Interface do Relatrio

Campo Contedo Observao

Horizontal/Vertical - Nesse campo selecionada a forma de
apresentao da varivel com visualizador radio-
set. As opes disponveis so:
Horizontal, valores da varivel alinhados
lado a lado na horizontal, para serem
assinalados;
Vertical, valores da varivel alinhados um
abaixo do outro na vertical, para serem
selecionados.
Pede Execuo Sim Indica se a varivel ser solicitada ao usurio no
folder de parmetros da interface ou no.

4. Acionar o boto OK, para confirmar as variveis e retornar a janela

Manuteno de Variveis (GR0124).
5. Na janela Manuteno de Variveis (GR0124), acionar o boto Sair para
retornar ao menu principal do Data Viewer.

Anotaes
 Processo Definio da Interface do Relatrio 11

Definindo Parmetros para o Relatrio

O objetivo desse procedimento definir os parmetros de validao das
informaes a serem consideradas pelo relatrio.
1. No menu principal do Data Viewer, acionar o boto Parmetros.
2. Na janela Parmetros do Relatrio (GR0111), efetuar a seguinte filtragem
dos dados, conforme parmetros abaixo:
Abre Tabela/Atributo Operador Comparar com Fecha Conector
( Ordem- = 1 and l-manual = yes OU
compra.origem
Ordem- = 2 and l-depende = OU
compra.origem yes
Ordem- = 3 and l-independe = )
compra.origem yes

 Para criar a seqncia acima, selecionar trs vezes o campo ordem-

compra.origem. Aps isso, selecionar cada uma das linhas e definir a
comparao, atravs do boto =. Na tela Propriedades dos Parmetros,
digitar o valor conforme coluna acima Comparar Com. Depois disso, para
cada linha verificar o conector e as opes de Abre e Fecha parnteses,
utilizando os botes correspondentes.

3. Na janela Propriedades dos Parmetros (GR0119), acionar o boto OK,

para confirmar o parmetro e retornar a janela Parmetros do Relatrio
(GR0111)
4. Na janela Parmetros do Relatrio (GR0111), acione o boto OK para
retornar ao menu principal do Data Viewer.
12 Processo Definio da Interface do Relatrio

Anotaes
 Processo Definio da Interface do Relatrio 13

Inserindo pequenos cdigos Progress no fonte do relatrio

O objetivo deste procedimento identificar como pequenos cdigos Progress
podem ser inseridos no programa do relatrio.
Esses pequenos cdigos Progress so denominados Fontes livres. So de
livre definio do usurio e que podem ser inseridos em pontos pr-
determinados no programa fonte do relatrio no momento da sua gerao.
Ao todo, existem 26 pontos, dentro dos fontes da interface e da lgica do
relatrio, onde o usurio pode inserir um fonte livre.
Antes Leitura Registros
Antes Mostrar Registros
Aps Mostra Registros
Aps Leitura Registros
Final Programa
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 Principal (Interface)
Inicializao de Variveis (Interface)
Antes de Habilitar Campos (Interface)
Aps Habilitar Campos (Interface)
14 Processo Definio da Interface do Relatrio

Incio da Execuo (Interface)

Execuo do Relatrio (Interface)
Aps Execuo (Interface)
Fim da Execuo (Interface)
1. No menu principal do Data Viewer, acionar o boto Fonte Livre.No
campo Fonte Livre, da janela Inclui Fonte Livre (GR0123), selecionar o
ponto de insero do Fonte Livre a seguir:
Campo Contedo Observao
Fonte Antes leitura Nesse campo selecionado o ponto de insero do
Livre registros cdigo Progress dentro dos fontes da interface e da
lgica do relatrio.

3. Na rea de Edio do Fonte Livre, da janela Inclui Fonte Livre

(GR0123), inserir o cdigo Progress a seguir:
Campo Contedo Observao
rea de Edio /* antes leitura Nesse campo so inseridos os cdigos
doFonte Livre registros */ Progress do fonte livre.
Importante:
O cdigo Progress no deve possuir mais de
2000 caracteres para cada fonte livre por
ponto de insero.

 Caso necessrio, possvel inserir:

Atributos das tabelas diretamente no Fonte Livre, por intermdio do
acionamento do boto Inserir.
Operadores diretamente no Fonte Livre, por intermdio do acionamento do
boto do operador desejado.

4. Acionar o boto Ok para confirmar a insero do Fonte Livre e retornar ao

menu principal do Data Viewer.
Processo Definio da Interface do Relatrio 15

Anotaes
16 Processo Definio da Interface do Relatrio

Definindo Parmetros de Entrada

O objetivo deste procedimento definir os parmetros de entrada, pr-
requisitos de execuo do programa de relatrio.
Parmetros de Entrada de um relatrio so pr-requisitos para sua execuo.
So recebidos de outros programas, pelo programa do relatrio, no incio de
sua execuo. Se inexistentes, a execuo cancelada. Para permitir testes
durante o desenvolvimento do relatrio, o Data Viewer exibe, a cada
execuo, uma janela solicitando os parmetros de entrada.

1. Acionar, no menu principal do Data Viewer, a opo Geral, Parmetros

de Entrada.
2. Na janela Manuteno de Parmetros (GR0141), acionar o boto Incluir.
3. Na janela Inclui Parmetros no Relatrio (GR0141A), insira as seguintes
informaes:
Campo Contedo Observao
Parmetro v-param- Nesse campo inserida a descrio do parmetro a
estab ser cadastrado.
Formato X(03) Nesse campo inserido o formato a ser utilizado pelo
campo calculado.
Tipo de character Nesse campo selecionado o tipo de dado do campo.
Dado As opes disponveis so: caractere, inteiro, decimal,
data, lgico.

4. Acionar o boto OK, para retornar ao menu principal do Data Viewer.

Anotaes
 Processo Definio da Interface do Relatrio 17

Definindo Procedures Internas

O objetivo desse procedimento identificar como criar e salvar Procedures
Internas, pequenos cdigos Progress que podem ser reutilizados em diversos
pontos do programa de relatrio.
Procedures internas so partes de cdigo Progress construdos em blocos,
para execuo seqencial na interface e ou lgica do relatrio. Sua insero
no fonte do relatrio dar-se- por intermdio da Funo Fonte Livre,
obedecendo o mesmo critrio de Pontos de Insero de Fontes Livres.
1. No menu principal do Data Viewer, acionar o boto Procedures Internas.
2. Na janela Manuteno de Procedures Internas (GR0142), acionar o boto
Incluir
3. Na janela Inclui Procedures Internas do Relatrio (GR0142A),insira as
seguintes informaes:
Campo Contedo Observao
Proc. Pi- Nesse campo inserido o nome da procedure interna.
Interna exemplo
Seqncia 1 Nesse campo inserido um nmero para identificar a
seqncia de execuo da procedure interna, em
relao as demais procedures internas do relatrio.
Destino Interface Nesse campo selecionado o destino de aplicao da
procedure interna. As opes disponveis so:
Interface (.w).
Lgica (.p).
Cdigo Message "Teste Procedure Interna" SKIP
"Parametro: " v-param-estab view-as alert-box.
ASSIGN c-cod-estabel-ini = v-param-estab.

4. Acionar o boto OK, para confirmar a procedure interna e retornar a

janela Manuteno de Procedures Internas (GR0142).
5. Na janela Manuteno de Procedures Internas (GR0142), acionar o boto
Sair para retornar ao menu principal do Data Viewer.
6. Acionar cone Fonte Livre, selecionar o item Aps definio da
variveis (Interface) e digitar run pi-exemplo.. Acionar ento o boto
OK.
18 Processo Definio da Interface do Relatrio

Anotaes
 Processo Definio da Interface do Relatrio 19

Estudo de Caso
Cenrio
Objetivando filtrar as informaes exibidas na listagem Totais de Compras por
Fornecedor, o gerente do departamento de compras questionou sobre a
possibilidade de poder selecionar os fornecedores, e tambm parametrizar na
interface a impresso de somente os pedidos cuja natureza seja igual a
compra (1) ou servio (2). Esse relatrio encontra-se cadastrado no Data
Viewer e disponvel para implementao da Seleo, campo pedido-
compr.cod-emitente, e Parametrizao, campo pedido-compr.natureza,
solicitadas.
Resultados Esperados com o Cenrio
Checklist Atingido Observao
Relatrio Salvo com a
Seleo de fornecedor
implementada.
Relatrio Salvo com a
Parametrizao da
natureza do pedido de
compra implementada.
21