Manual de Referência

Data Viewer 2.02

Não 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 eletrônico ou mecânico, na sua totalidade ou
em parte, sem a prévia autorização escrita da DATASUL S.A., que reserva-se
o direito de efetuar alterações sem aviso prévio. A DATASUL S.A não assume
nenhuma responsabilidade pelas conseqüências de quaisquer erros ou
inexatidões que possam aparecer neste documento.
DATASUL S.A.
Av. Santos Dumont, 831, Joinville, SC, CEP 89.222-900

2.00 14/07/99
 i

Índice

Prefácio.............................................................................................. iii

CAPÍTULO 1 Introdução .................................................................... 1

Integração com Outros Módulos....................................................................2
CAPÍTULO 2 Público Alvo ................................................................. 5

CAPÍTULO 3 Processo Características Técnicas ............................ 7

CAPÍTULO 4 Processo Acesso ao Data Viewer............................... 9

Função Acessando o Data Viewer................................................................9
CAPÍTULO 5 Processo Relatórios .................................................. 15
Função Manutenção do Relatório...............................................................15
Função Tabelas do Relatório......................................................................19
Função Acompanhamento Processo Relatório ..........................................21
Função Atualizar .........................................................................................21
Função Desfazer.........................................................................................22
CAPÍTULO 6 Processo Colunas ..................................................... 23
Função Campos do Relatório .....................................................................23
Função Campos Calculados.......................................................................25
Função Propriedades dos Campos do Relatório........................................29
Função Reordenar Campos do Relatório ...................................................31
Função Grupos do Relatório.......................................................................32
CAPÍTULO 7 Processo Geral .......................................................... 37
Função Classificações do Relatório............................................................37
Função Seleções do Relatório....................................................................39
Função Manutenção de Variáveis ..............................................................41
Função Parâmetros do Relatório ................................................................45
ii

Função Totais do Relatório .........................................................................47

Função Manutenção de Cálculos ...............................................................48
Função Fonte Livre .....................................................................................51
Função Parâmetros de Entrada ..................................................................53
Função Manutenção de Procedures Internas.............................................54
CAPÍTULO 8 Processo Geração..................................................... 57
Função Teste ..............................................................................................57
Função Fonte ..............................................................................................57
Função Geração WEB ................................................................................58
Função Editor ..............................................................................................60
CAPÍTULO 9 Processo Administração........................................... 61
Função Administrar Tabelas .......................................................................61
Função Administrar Relacionamentos ........................................................63
Função Manter Relacionamentos ...............................................................63
Função Manter Tabelas ..............................................................................65
Função Manter Campos..............................................................................67
Função Manter Usuários.............................................................................70
Função Alterar Usuário Relatório................................................................73
Função Permissões Usuários (Tabelas / Campos) ....................................74
Função Manter Perfis..................................................................................75
Função Exportar Perfil ................................................................................76
Função Importar Perfil.................................................................................77
Função Manter Blocos x Perfil ....................................................................78
Função Dados (Exportar)............................................................................80
Função Dados (Importar) ............................................................................81
Função Geração (Relatórios)......................................................................82
Função Geração (Menu) .............................................................................83
Função ProTools .........................................................................................83
CAPÍTULO 10 Processo Formato e Impressão de Valores dos
Atributos e Variáveis ....................................................................... 85
 iii

Prefácio

Os produtos DATASUL são conjuntos de aplicações relacionadas que

permitem interligar toda uma empresa, resultando em um sistema integrado
de gestão empresarial.
Cada produto é estruturado em aplicativos ou sistemas (como Controladoria e
Finanças ou Manufatura), que por sua vez são compostos por módulos
(como Contabilidade ou Controle da Produção), que implementam uma série
de funções (como a Movimentação Contábil ou a Manutenção de Ordens de
Produção).
O Manual de Referência de Módulo visa abranger toda a informação
necessária para compreender os módulos que compõem os produtos
DATASUL, bem como solucionar dúvidas relativas ao seu funcionamento. É
uma obra “de referência” já que seu principal objetivo é a consulta para
obtenção de informações, ao contrário de um livro ou outro tipo de manual
que é lido do início ao fim.
Para cada módulo são definidas suas principais áreas funcionais. Uma área
funcional é um conjunto identificado de comportamentos relacionados. Neste
manual, cada área funcional dentro de um módulo é chamada de processo e
cada comportamento que compõem esta área funcional é chamado de
função.
Importante
As características do módulo apresentado neste manual são suas
características básicas. Tomando-as como base, o módulo pode ser
configurado para qualquer tipo de empresa.
Todos os dados utilizados nos relatórios e telas do DATASUL EMS
apresentados neste manual são fictícios.
 1

CAPÍTULO 1

Introdução

Objetivo O Manual de Referência do Data Viewer 2.02 tem como objetivo de mostrar
ao usuário como trabalhar com o Data Viewer 2.02. Através de telas,
exemplos, etc., deve ser mostrado os passos de elaboração de relatórios,
assim como poder modificar os mesmo ou até eliminá-los.
O Data Viewer é uma ferramenta para extração de dados, voltada ao usuário
final, que possibilita a elaboração de relatórios e exportação de dados através
da geração de um programa com código fonte em Progress de interface
gráfica.
Sua principal finalidade é auxiliar o usuário em suas tarefas do dia-a-dia,
permitindo confeccionar relatórios dentro de necessidades específicas
obedecendo as limitações da ferramenta.
Características As principais características do módulo são:
• Ambiente Windows 95;
• Armazena todas as definições dos bancos de dados a serem utilizados,
em uma base própria;
• Permite a agregação da bases específicas;
• Disponibiliza manutenção no relacionamento das tabelas a serem
utilizadas;
• Utiliza rótulos do dicionário de dados, que podem ser alterados pelo
usuário;
• Permite que o mesmo relatório seja gerado em forma de listagem ou
exportação de dados;
• Fácil manipulação dos objetos no layout do relatório;
2

• Inserção de código fonte Progress livre para o usuário em posições

específicas;
• Segurança a nível de usuário para os relatórios e às tabelas;
• Determinação da classificação;
• Totais e cálculos variados, com fórmulas automáticas ou definidas pelo
usuário;
• Seleção e parâmetros fixos ou em tempo de execução;
• Vários blocos de dados distintos;
• Fonte gerado legível e modificável.
Visão geral Esta ferramenta é própria para geração de relatórios e listagens, exportações
e gráficos. Assemelha-se a outras ferramentas de mercado como o Crystal
Reports e Report Builder. A partir de uma base de dados, informações são
extraídas, selecionadas, comparadas , utilizadas na busca de outras
informações, calculadas e por fim exibidas.

Criação do
Fonte Compilação do
Data Viewer (.W e .P) Fonte
Programa
RCODE
2.02 Fonte

Integração com Outros Módulos

A integração do Data Viewer com outros produtos Datasul é feita através de
API´s (Aplication Program Interface). Estas API´s são localizadas em pontos
estratégicos e realizam operações necessárias para o produto para o qual o
programa está sendo criado. Este conjunto de API´s são denominados
PERFIL.
Para cada produto Datasul existe um PERFIL próprio para atender as
características do produto.
Existe também um Perfil padrão que tem como finalidade atender
necessidades básicas dos programas criados, sem necessariamente estarem
ligados a um produto Datasul.
A integração do Data Viewer com os demais produtos Datasul, necessita
também dos relatórios padrão e tabelas/relacionamentos dos bancos do
produto. Desta maneira o usuário possui os relatórios padrão para utilizar uma
CAPÍTULO 1 Introdução 3

cópia destes e construir seus próprios programas, alterando para o que

atende melhor a sua necessidade.
Com as tabelas e relacionamentos, o Data Viewer fica preparado para atender
as características dos bancos de dados dos produtos. Estes dados existem na
mídia dos respectivos produtos, assim, ao instalar o Data Viewer e carregar
os dados dos produtos, é possível a criação de programas para os mesmos.
O Data Viewer pode gerar relatórios integrados com os seguintes produtos:
• Datasul EMS-Framework 2.0;
• Datasul EMS-Framework 5.0;
• Magnus I
Para que isto seja possível, é necessário que sejam utilizados os perfis, que
são:
• Perfil EMS 2.0 (grbloco2.d);
• Perfil EMS 5.0 (grbloco5.d);
• Perfil Padrão (grbloco.d).
 5

CAPÍTULO 2

Público Alvo

Objetivo O principal usuário do Data Viewer é o usuário final que, na maioria dos
casos, não possui conhecimento técnico de linguagem de programação. Além
destes, é destinado a profissionais das áreas de desenvolvimento, operações,
assistência técnica e parceiros.
Visão geral A utilização da ferramenta pode ser exemplificada como:

• Datasul: Desenvolvimento de programas para os produtos da Datasul.

Esta função é geralmente realizada por um programador, analista de
sistemas ou ainda algum profissional com conhecimento de linguagem de
programação Progress. A partir do Data Viewer esta tarefa pode ser
realizada por qualquer profissional que possua um mínimo de
informações sobre as necessidades do programa a ser criado. No
produto Datasul-EMS 2.0, grande parte dos programas de relatórios foram
construídos com o Data Viewer.

• Parceiro/Área de Sistemas do Cliente: Utilização por parceiros de

negócios da Datasul, onde, caso o parceiro possua algum aplicativo com
ou sem integração com os produtos Datasul, é possível utilizar o Data
Viewer para geração 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
gestão hospitalar, é possível gerar programas relacionando informações
de estoque de um produto Datasul, com informações de consumo de
materiais do aplicativo do parceiro.
• Usuário Final: Os relatórios necessários ao usuário podem ser criados
por ele próprio, mesmo sem conhecimento técnico, tendo em vista que
não é pré-requisito o conhecimento de linguagem de programação
Progress para operar e criar relatórios simples no Data Viewer. É
6

necessário apenas conhecer as tabelas onde as informações desejadas

estão armazenadas e conhecer/saber operar os recursos do Data Viewer.
 7

CAPÍTULO 3

Processo Características Técnicas

Objetivo Este processo tem por objetivo orientar o usuário em relação as

características técnicas do Data Viewer.
Visão geral O Data Viewer é um gerador de programas (relatórios, exportação e gráfico)
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 não.
O Data Viewer possibilita a criação de programas de relatórios e programas
de geração de gráficos via Excel 97. Os programas de relatórios criados
possibilitam ainda saída para impressora, arquivos, tela e HTML.
É possível ainda determinar perfis para a criação dos programas. Desta
maneira é possível manter características desejadas para todos os programas
construídos utilizando um mesmo perfil. Para criar programas que sigam
padrões de produtos Datasul, foram construídas diversas API´s (Aplication
Program Interface). Estas API´s desempenham um papel de interface entre os
programas gerados pelo Data Viewer e os produtos Datasul, levando em
consideração que cada produto possui uma metodologia de desenvolvimento
específica. As API´s funcionam como uma “Caixa Preta”, procedendo a
interface do Data Viewer com qualquer outro produto Datasul, bem como
produtos específicos do cliente. Este conjunto de API´s forma o Perfil que
caracteriza um programa construído.
Para o processo de customização da área de fonte livre, além do fato do
usuário necessitar conhecer a linguagem de programação Progress, está área
tem um tamanho limitado, impossibilitando um codificação muito extensa.
Entretanto nada impede a utilização 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 existência do
próprio Data Viewer, isto é, o programa criado é independente. Desta
8

maneira, um programa criado pode ser distribuído 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 utilização:

Data Viewer Aplicativo/Produto

Progress

Geração do Utilização do
Fonte Progress Fonte Progress
Gerado

Fonte
Gerado
(.W/.P) Fonte
Compilado
Compilação RCODE

Fonte
Compilado
RCODE
Cópia do Programa Compilado
 9

CAPÍTULO 4

Processo Acesso ao Data Viewer

Objetivo Este processo tem por objetivo orientar o usuário quanto ao acesso.

Função Acessando o Data Viewer

Objetivo Esta função tem por objetivo mostrar o procedimento de acesso ao Data
Viewer.
Descrição Ao conectar o Data Viewer se apresenta a tela abaixo, onde é necessário
informar o usuário desejado e sua senha:

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

acesso a todas as funções disponíveis ao tipo de usuário para confecção dos
relatórios, bem como o layout do relatório.
10

Botão Relatórios: Este botão tem por objetivo detalhar de que forma é
feita a manutenção nos relatórios do usuário no Data Viewer. O mesmo é um
atalho para a Função Manutenção do Relatório.

Botão Tabelas: Este botão tem por objetivo realizar a manutenção nas
tabelas que fazem parte do relatório. O mesmo é um atalho para a Função
Tabelas do Relatório.

Botão Campos: Este botão tem por objetivo realizar a manutenção dos
campos que fazem parte do relatório. O mesmo é um atalho para a Função
Campos do Relatório.

Botão Propriedades: Este botão tem por objetivo realizar a manutenção

nas propriedades de um campo do relatório corrente. O mesmo é um atalho
para a Função Propriedades dos Campos do Relatório.
CAPÍTULO 4 Processo Acesso ao Data Viewer 11

Botão Campos Calculados: Este botão tem por objetivo realizar a

manutenção de campos (variáveis) que fazem parte do layout do relatório, ou
seja, não pertencem a nenhuma tabela. O mesmo é um atalho para a Função
Campos Calculados.

Botão Cálculos: Este botão tem por objetivo incluir, modificar ou

eliminar os cálculos para o relatório. O mesmo é um atalho para a Função
Manutenção de Cálculos.

Botão Variáveis: Este botão tem por objetivo realizar a manutenção no

cadastro de variáveis utilizadas no relatório. O mesmo é um atalho para a
Função Manutenção de Variáveis.

Botão Seleção: Este botão tem por objetivo realizar a manutenção dos
campos a serem utilizados como seleção para o relatório (faixa inicial e final).
O mesmo é um atalho para a Função Seleções do Relatório.

Botão Parâmetros: Este botão tem por objetivo realizar consultas e

manutenções dos parâmetros de leitura das tabelas no processamento do
relatório. O mesmo é um atalho para a Função Parâmetros do Relatório.

Botão Classificação: Este botão tem por objetivo realizar a manutenção

nas classificações ou formas de ordenação do relatório. O mesmo é um atalho
para a Função Classificações do Relatório.

Botão Totais: Este botão tem por objetivo realizar a manutenção no

cadastro de totais do relatório. O mesmo é um atalho para a Função Totais do
Relatório.

Botão Teste: Este botão tem por objetivo possibilitar a geração do

programa de interface do relatório e do programa de processamento, além de
compilar e executar este programas. O mesmo é um atalho para a Função
Teste.

Botão Geração: Este botão tem por objetivo possibilitar a geração do

programa de interface do relatório e do programa de processamento, além de
compilar estes programas. O mesmo é um atalho para a Função Fonte.
12

Botão Geração WEB: Este botão tem por objetivo a Geração WEB dos
relatórios. Gera a interface, faz a compilação, porém a verificação de erro
(caso ocorra) é feita no WEBSpeed. O mesmo é um atalho para a Função
Geração WEB.

Botão Desfazer: Este botão tem por objetivo questionar o usuário se ele
“Deseja desfazer as alterações ?”.. O mesmo é um atalho para a Função
Desfazer.

Botão Atualizar: Este botão tem por objetivo questionar o usuário se ele
“Deseja salvar as alterações ?”. O mesmo é um atalho para a Função
Atualizar.

Botão Reordena Campos: Este botão tem por objetivo permitir a

ordenação dos campos no layout do relatório sem que seja necessário
arrastá-los com o mouse. O mesmo é um atalho para a Função Reordenar
Campos do Relatório.

Botão Grupos: Este botão tem por objetivo permitir consultas e

atualizações nos grupos do layout do relatório. O mesmo é um atalho para a
Função Grupos do Relatório.

Botão Acompanhamento: Este botão tem por objetivo permitir alterar o

acompanhamento no processamento do relatório. Seu valor como conteúdo
inicial é um contador dos registros lidos.. O mesmo é um atalho para a
Função Acompanhamento Processo Relatório.

Botão Editor: Este botão possibilita acessar o Editor Progress O mesmo

é um atalho para a Função Editor.

Botão Parâmetros de Entrada: Este botão tem por objetivo permitir ao

usuário incluir, modificar ou eliminar os Parâmetros de Entrada. O mesmo é
um atalho para a Função Parâmetros de Entrada.

Botão Fonte Livre: Este botão tem por objetivo permitir ao usuário
escrever código Progress ou até mesmo chamar outros programas, includes
em pontos específicos do relatório. O mesmo é um atalho para a Função
Fonte Livre.
CAPÍTULO 4 Processo Acesso ao Data Viewer 13

Botão Procedures Internas: Este botão tem por objetivo permitir ao

usuário incluir, modificar ou eliminar as Procedures Internas para o relatório.
O mesmo é um atalho para a Função Manutenção de Procedures Internas.
 15

CAPÍTULO 5

Processo Relatórios

Objetivo Este processo tem por objetivo descrever as funções Manutenção de

Relatórios, Tabelas do Relatório, Acompanhamento Processo Relatório,
Atualizar e Desfazer.

Função Manutenção do Relatório

Objetivo Esta função tem por objetivo detalhar de que forma é feita a manutenção nos
relatórios do usuário no Data Viewer.
Descrição Selecionar no menu do Data Viewer a opção “Relatório”, item “Relatório” ou
através do botão “Relatórios”. É acessado então, a tela de Manutenção de
Relatórios:
16

Nesta, pode-se incluir, modificar, eliminar, copiar ou filtrar relatórios, como

apresentado na tela a seguir:
CAPÍTULO 5 Processo Relatórios 17

Campo Descrição
Relatório Inserir o nome do relatório a ser gerado. Deverá ter 6
(seis) caracteres quaisquer no nome, mais 1 (uma) ou 2
(duas) letras, variando de "a" até "bz".
Exemplo:
Relatório: CDR004a.

Título Inserir o título para o relatório que está sendo criado. Este
título será impresso no cabeçalho de cada página do
relatório.
Exemplo:
Relatório: CDR004a
Título: Listagem de Produtos Faturados.

Título Classificação Inserir o título para identificar a classificação do relatório.

Exemplo:
Relatório: CDR004a
18

Título: Listagem de Produtos Faturados

Título Classificação: Por cliente

Nota
Este título de classificação, será impresso na página de
parâmetros do relatório e, também será utilizado no
programa a ser gerado para apresentar todas as
classificações deste relatório, podendo-se a partir deste,
identificar e chamar o relatório pela classificação.

Sistema Relatório Informar o nome do sistema ou módulo a que pertence o

relatório.
Exemplo Faturamento, Ponto Eletrônico, Contas a
Pagar.

Subdiretório Informar subdiretório do diretório de trabalho do usuário

Programa onde serão gravados os programas dos relatórios
gerados.
Exemplo
Subdiretório Programa: Cdp
Relatório gerado: c:\relatorios\cdp\cdr004a
Onde c:\relatorios é o diretório de trabalho do usuário, cdp
é o subdiretório programa, cdr004a é o programa a
gerado.

Nota

Caso este subdiretório ou estrutura de subdiretório não

exista, será criada automaticamente pelo Data Viewer no
momento da geração do programa do relatório.
Se o seu conteúdo for branco, o programa do relatório
será gerado no diretório de trabalho do usuário.
Listagem, Informar se o relatório trará como resultado uma listagem,
Exportação ou um arquivo texto como exportação de dados ou um
Gráfico gráfico para visualização de dados. Para exportação não
traz no resultado cabeçalho, labels para grupos de dados,
rodapé, página de parâmetros, nem realiza cálculos como
média, máximo, mínimo, total, etc. Somente será
considerado como objeto de exportação os que estiverem
no layout do relatório.
Exportação Tipo Será realizada a exportação dos dados para os objetos do
Fixa layout do relatório a um arquivo texto como uma linha
contínua, obedecendo apenas o formato dos objetos do
CAPÍTULO 5 Processo Relatórios 19

layout.
Exportação Tipo Será realizada a exportação dos dados para os objetos do
Separador layout do relatório a um arquivo texto separando estes
conforme o separador definido pelo usuário. Obedecendo
ainda quebra de linha por cada grupo do layout do
relatório.
Exportação Tipo Será realizada a exportação dos dados para os objetos do
Progress layout do relatório a um arquivo texto utilizando-se o
método de exportação do Progress, o qual utiliza como
separador um espaço, para campos do tipo caracter são
exportados entre aspas, campos lógicos como yes/no.
Separador Informar o tipo de separador a ser utilizado para identificar
os campos dos dados a serem exportados.
Podem ser: tabulação, espaço, sustenido, vírgula, ponto e
vírgula ou outro, a escolha do usuário.
Perfil Informar se o relatório a ser gerado será utilizando no
produto EMS-200, EMS-500 ou Padrão (outro produto).
Tipo Gráfico Informar o tipo de gráfico que será gerado.
Suporte HTML Definir se o relatório gerado poderá ter sua saída em
HTML ou não.
Relatório Padrão Definir se o relatório será padrão, ou seja, apenas a
empresa criadora do relatório poderá alterá-lo.

Nota
Pode-se perfeitamente modificar um relatório do tipo listagem para um do tipo
exportação e vice-versa, porém, como já mencionado anteriormente, caso a
listagem tenha cálculos variados ou totais serão desconsiderados para a
exportação.

Função Tabelas do Relatório

Objetivo Esta função tem por objetivo realizar a manutenção nas tabelas que fazem
parte do relatório.
Descrição Selecionar no menu do Data Viewer a opção “Relatório”, item “Tabelas” ou por
meio do botão “Tabelas”, onde existirá acesso à tela de Tabelas do Relatório.
Será apresentado um browse com as tabelas “Disponíveis” 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
disponíveis.

Na coluna de Disponíveis serão apresentadas todas as tabelas disponíveis do

banco de dados selecionado para trabalho. Selecionar a tabela desejada, em
seguida pressionar o botão incluir (>>), onde a tabela passa às Utilizadas.
Para eliminar uma tabela da coluna de Utilizadas, basta selecionar a tabela
desejada, e pressionar o botão de eliminar (<<).
Nota
Quando da inclusão de tabelas no relatório, serão disponibilizadas para uma
próxima inclusão neste relatório, apenas as tabelas que possuam
relacionamentos com uma das tabelas que já fazem parte do relatório.
Deve-se atentar a ordem em que as tabelas são inclusas no relatório, pois a
leitura das mesmas para a execução do relatório será feita na mesma
seqüência (cascata), podendo vir a prejudicar a performance ou até mesmo,
no resultado final do relatório.
CAPÍTULO 5 Processo Relatórios 21

Função Acompanhamento Processo Relatório

Objetivo Esta função tem por objetivo permitir alterar o acompanhamento no
processamento do relatório. Seu valor como conteúdo inicial é um contador
dos registros lidos.
Descrição Selecionar no menu do Data Viewer a opção “Relatório”, item
“Acompanhamento” ou por meio do botão “Acompanhamento”, onde existirá
acesso à tela de Acompanhamento Processo Relatório.

Campo Descrição
Título Possibilita a alteração do título da tela de acompanhamento no
Acompanhamento processamento do relatório.
Atributo Possibilita a alteração do campo da tela de acompanhamento no
Acompanhamento processamento do relatório. Pode ser selecionado o campo de
uma das tabelas utilizadas para fazer o relatório.

Função Atualizar
Objetivo Esta função tem por objetivo questionar o usuário se ele “Deseja salvar as
alterações ?”.
Descrição Selecionar no menu do Data Viewer a opção “Relatório”, item “Atualizar” ou
por meio do botão “Atualizar”, onde existirá acesso à tela Atualizar.
22

Função Desfazer
Objetivo Esta função tem por objetivo questionar o usuário se ele “Deseja desfazer as
alterações ?”.
Descrição Selecionar no menu do Data Viewer a opção “Relatório”, item “Desfazer” ou
por meio do botão “Desfazer”, onde existirá acesso à tela Desfazer.
 23

CAPÍTULO 6

Processo Colunas

Objetivo Este processo tem por objetivo descrever as funções Campos do Relatório,
Campos Calculados, Propriedades, Reordena Campos e Grupos.

Função Campos do Relatório

Objetivo Esta função tem por objetivo realizar a manutenção dos campos que fazem
parte do relatório.
Descrição Selecionar no menu do Data Viewer a opção “Colunas”, item “Campos” ou
através do botão “Campos”. É acessado então, a tela de Campos do
Relatório, a qual permite incluir ou eliminar campos do relatório.
24

Incluir campo

Eliminar campo

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

o relatório, o browse a direita os campos (atributos) que estas possuem e, o
browse inferior os campos que pertencem ao layout do relatório.
Selecionar os campos que lhe são necessários (um por vez) e, pressionar o
botão incluir, ou de dois clicks sobre o campo. Depois é só pressionar “OK”.
CAPÍTULO 6 Processo Colunas 25

Verificando o layout:

Função Campos Calculados

Objetivo Esta função tem por objetivo realizar a manutenção de campos (variáveis) que
fazem parte do layout do relatório, ou seja, não pertencem a nenhuma tabela.
Podem ter um valor fixo, ou receberem valor durante a execução do relatório.
Descrição Através do menu do Data Viewer opção “Colunas”, item “Campos Calculados”
ou através do botão “Campos Calculados”, é acessado a tela de manutenção
de Campos Calculados.
26

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

Campo Descrição
Atributo Inserir o nome do atributo (campo calculado) que
irá armazenar um valor informado.
Rótulo Inserir o título ou descrição para o campo
calculado cadastrado.
Tipo Dado Selecionar tipo de informação que será
armazenado.
As opções disponíveis são: caracter, inteiro,
CAPÍTULO 6 Processo Colunas 27

decimal, data, lógico.

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

Pressionando “OK” e voltando a tela de manutenção de campos calculados,

onde encontra-se o botão “Fórmula”, pode-se através deste, cadastrar a
fórmula que irá gerar o valor para o campo calculado. Ao clicar neste, é
apresentada a seguinte tela:

Na tela de fórmula para campos calculados, o browse da direita contém as

tabelas utilizadas no relatório, o da esquerda, os campos das respectivas
tabelas e no inferior o editor da fórmula para o cálculo.
No exemplo acima, foi selecionado a tabela “ord-prod”, o campo “qt-
produzida” e clicado sobre o botão “Insere” ou é efetuado dois cliques sobre o
campo, depois é clicado sobre o botão “+” (somar). Fazer o mesmo com o
campo “qt-refugada”.
28

Feito isto, basta clicar sobre o botão “OK” e, sair da tela de manutenção de
campos calculados. Este campo calculado será apresentado no layout do
relatório. Veja:
CAPÍTULO 6 Processo Colunas 29

Ver abaixo o resultado do campo calculado:

Função Propriedades dos Campos do Relatório

Objetivo Esta função tem por objetivo realizar a manutenção nas propriedades de um
campo do relatório corrente. Caso algum dos valores sejam aqui alterados,
não afetará os demais relatórios onde está sendo utilizado.
Descrição Através do menu do Data Viewer opção “Colunas”, item “Propriedades” ou
através do botão “Propriedades”, é acessado a tela de Propriedades dos
Campos do Relatório.
30

Campo Descrição
Tabela Informar o nome da tabela, caso o objeto selecionado seja um
campo calculado, este aparecerá em branco.
Atributo Informar o nome do objeto selecionado.
Tipo Dado Informar o tipo de dado ou conteúdo do objeto.
Exemplo:
Caracter: Conversor de Voltagem
Inteiro: 147
Decimal: 147,36
Data: 21/04/1998
Lógico: Sim

Formato Informar a forma a qual o conteúdo do objeto vai ser

apresentado.
Linha Informar o número da linha do campo selecionado no layout do
relatório.
Coluna Informar o número da coluna do campo selecionado no layout
CAPÍTULO 6 Processo Colunas 31

do relatório.
Grupo Informar o número do grupo do campo selecionado no layout do
relatório.
Tamanho Col-Label Informar o espaço necessário para rótulo de coluna mais
tradução do campo selecionado no layout do relatório.
Tamanho Label Informar o espaço necessário para rótulo de coluna mais
tradução do campo selecionado no layout do relatório.
Exibir Habilitar o campo que específica a condição em que serão
mostrados os registros lidos.
Sempre: serão mostrados todos os registros lidos.
Primeiro: será mostrado apenas o primeiro registro lido dentro
de uma classificação escolhida pelo usuário.
Último: será mostrado apenas o último registro lido dentro de
uma classificação escolhida pelo usuário.
Grupo Informar o tipo de descrição ou título utilizado no grupo.
No label: não mostra a descrição ou título dos campos no
layout.
Side label: mostra a descrição ou título dos campos no layout
ao lado do mesmo (em linha).
Column-label: mostra a descrição ou título dos campos no
layout em cima do mesmo (em coluna).
Nota
Quando selecionada uma das opções de label no item grupo,
esta será aplicada para todo o grupo do objeto selecionado.

Função Reordenar Campos do Relatório

Objetivo Esta função tem por objetivo permitir a ordenação dos campos no layout do
relatório sem que seja necessário arrastá-los com o mouse.
Descrição Através do menu do Data Viewer opção “Colunas”, item “Reordena Campos”
ou através do botão “Reordena Campos”, é acessado a tela de Reordenar
Campos do Relatório.
32

Um relatório é composto de campos e estes campos seguem uma seqüência.

Nesta função o usuário terá condições de alterar está seqüência. Os campos
são mostradas no browse e ao lado direito da tela temos os botões de sobe e
desce para permitir as devidas alterações quando necessárias.

Função Grupos do Relatório

Objetivo Esta função tem por objetivo permitir consultas e atualizações nos grupos do
layout do relatório.
Descrição É obrigatório para relatórios com separação de grupos de dados que o
primeiro campo de cada grupo de campos do layout esteja na classificação do
relatório.
Através do menu do Data Viewer opção “Colunas”, item “Grupos” ou através
do botão “Grupos”, é acessado a tela de Grupos do Relatório.
CAPÍTULO 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, após clicar sobre o botão
“Separa”, depois pressionar o botão OK.
Botão Descrição
Propriedades Possibilita informar se o campo selecionado quebra página quando
mudar de valor.
Nota
Os botões Propriedades e Separa, somente ficarão habilitados
quando selecionado um campo que possua classificação no relatório
ou um campo calculado e o próximo é uma classificação.

Separa Permite realizar a separação dos grupos no layout.

Elimina Tem por função eliminar a linha de separação dos grupos no layout.
Nota
O botão Elimina somente ficará habilitado quando selecionada uma
linha de separação de grupos.

Nota
Grupo é uma divisão hierárquica, que possibilita ao programa quebrar as
informações mediante os grupos informados, para melhor visualizar as
informações.
34

Podemos citar como exemplo uma Listagem de Notas Fiscais por Clientes,
onde teríamos no grupo 1 (um) os dados do cliente e, no grupo 9 (nove) as
informações referentes a nota fiscal, item, valor mercadoria e valor total da
nota.
Consultando o exemplo, observamos que há dois grupos:
Grupo 1:
CAPÍTULO 6 Processo Colunas 35

Grupo 9:
 37

CAPÍTULO 7

Processo Geral

Objetivo Este processo tem por objetivo descrever as funções Classificações do

Relatório, Seleções do Relatório, Manutenção Variáveis, Parâmetros do
Relatório, Totais do Relatório, Manutenção de Cálculos, Fonte Livre,
Manutenção de Parâmetros e Manutenção de Procedures Internas.

Função Classificações do Relatório

Objetivo Esta função tem por objetivo realizar a manutenção nas classificações ou
formas de ordenação do relatório.
Descrição Selecionar no menu do Data Viewer a opção “Geral”, item “Classificação” ou
através do botão “Classificação”. É acessado então, a tela de Classificações
do Relatório.
38

Campos Descrição
Ordem Informar se a classificação do campo selecionado, será de forma
ascendente (menor para maior) ou, descendente (maior para menor).
Visualização Informar se deseja visualizar as tabelas e campos pelo nome ou pela
descrição.

Na tela de manutenção de classificações, o browse a esquerda traz as tabelas

do relatório, o da direita os campos desta tabela e, o inferior, os campos que
fazem parte das classificações do relatório.
Selecionar o campo desejado para classificação e, incluir o mesmo nas
classificações, através do botão “incluir” (seta para baixo), ou com dois clicks
sobre o campo.
Importante
Quando da eliminação de uma classificação que é utilizada para dividir grupos
do relatório, os objetos dos grupos se juntarão em um único grupo no layout,
fugindo ao posicionamento anterior.
CAPÍTULO 7 Processo Geral 39

Nota
É permitido ao usuário através do botão "Edita", editar a classificação e fazer
alterações nesta, caso necessário.
Exemplo:
Temos uma listagem de notas ficais e queremos que seu resultado seja
classificado apenas pelo mês da nota e não toda a sua data.
Classificação: nota-fiscal.data-emissao
Edita: month(nota-fiscal.data-emissao).
Utilizamos assim a função month do progress para resgatar o valor do mês
em uma data e, temos o relatório classificado apenas por mês.

Função Seleções do Relatório

Objetivo Esta função tem por objetivo realizar a manutenção dos campos a serem
utilizados como seleção para o relatório (faixa inicial e final).
Descrição Selecionar no menu do Data Viewer a opção “Geral”, item “Seleção” ou
através do botão “Seleção”, onde existirá acesso a tela de Seleções do
Relatório.
40

Na tela de Seleções do Relatório, o browse a esquerda traz as tabelas do

relatório, o da direita os campos desta tabela e o inferior, os campos que
fazem parte das seleções do relatório.
Selecionar os campos que deseja para seleção (um por vez) e incluir o
mesmo nas seleções, através do botão “incluir” (seta para baixo), ou com dois
clicks sobre o campo.
CAPÍTULO 7 Processo Geral 41

Conferindo seleções:

Função Manutenção de Variáveis

Objetivo Esta função tem por objetivo realizar a manutenção no cadastro de variáveis
utilizadas no relatório.
Descrição Selecionar no menu do Data Viewer a opção “Geral”, item “Variáveis” ou
através do botão “Variáveis”, onde existirá acesso a tela de Manutenção de
Variáveis.
42

Botão Incluir

Botão Modificar

Incluir ou Modificar Variáveis: acessar através dos botões incluir ou

modificar na tela de manutenção de variáveis, onde será apresentada na tela
a seguir:
CAPÍTULO 7 Processo Geral 43

Campo Descrição
Variável Inserir o nome da variável a ser cadastrada.
Este campo não pode ter espaço em branco, caracteres
especiais ou acentuação.
Rótulo Inserir o título ou descrição para a variável.
Este campo pode ter espaço em branco, caracteres
especiais ou acentuação.
Formato Inserir o formato que será utilizado para informar o
conteúdo da variável.
Inicial Valor Inicial que será apresentado ao solicitar o conteúdo
para a variável.
Tipo Dado Selecionar o tipo de informação que a variável
armazenará.
44

Opções disponíveis:
• Caracter: Conversor de Voltagem;
• Inteiro: 147;
• Decimal: 147,36;
• Data: 21/04/98;
• Lógico: sim.
Visualizador Além do formato, pode-se definir outras maneiras de
mostrar o conteúdo da variável (fill-in, radio-set, combo-
box).
Nota
Somente é permitida seleção de outros formatos, para
variáveis do tipo inteiro ou caracter. Variáveis do tipo
lógico, tem como formato padrão "toggle-box" ou "check-
box".

Valor Visualizador Conteúdo que será utilizado para o visualizador (radio-set,

combo-box).
Exemplo:
Variável: v-estado-ordem
Rótulo: Estado da Ordem
Tipo Dado: Caracter
Formato: x(15)
Visualizador : Combo-Box
Valor Visualizador:
• "Aberta";
• "Cancelada";
• "Finalizada";
• "Suspensa".

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

pela apresentação do seu conteúdo de forma horizontal
ou vertical.
Pede em Execução Quando marcado, a variável que está sendo cadastrada,
será solicitada em tela no momento de executar o
relatório, caso contrário, ela será apenas considerada
como variável interna de cálculo do relatório.
CAPÍTULO 7 Processo Geral 45

Função Parâmetros do Relatório

Objetivo Esta função tem por objetivo realizar consultas e manutenções dos
parâmetros de leitura das tabelas no processamento do relatório.
Descrição Selecionar no menu do Data Viewer a opção “Geral”, item “Parâmetros” ou
através do botão “Parâmetros”, onde existirá acesso a tela de Parâmetros do
Relatório.

Botão Descrição
Encontra Faz referência da ocorrência informada com a existência de uma
ocorrência igual em outra tabela a ser informada.
Não Faz referência da ocorrência informada com a inexistência de uma
Encontra ocorrência igual em outra tabela a ser informada.
Seta direita ( Adicionar abre parênteses na linha da ocorrência selecionada.
Seta Eliminar abre parênteses na linha da ocorrência selecionada.
esquerda (
Seta direita ) Adicionar fecha parênteses na linha da ocorrência selecionada.
Seta Eliminar fecha parênteses na linha da ocorrência selecionada.
esquerda )
E Adicionar conector lógico de obrigatoriedade na linha da ocorrência
selecionada.
46

OU Adicionar conector lógico de opcionalidade na linha da ocorrência

selecionada.

Na tela de manutenção de parâmetros, o browse a esquerda traz as tabelas

do relatório, o da direita os campos desta tabela e o inferior, os campos que
fazem parte dos parâmetros do relatório.
Selecionar o campo desejado para parâmetro e incluir o mesmo nos
parâmetros, através do botão “incluir” seta para baixo, ou com dois clicks
sobre o campo. Depois pressionar o botão com a comparação desejada para
este parâmetro. É apresentada uma tela onde pede-se o campo “Comparar
com”, informar o conteúdo desejado como comparação. Pressionar “OK” e
voltando a tela de manutenção de parâmetros, pressionar “OK” novamente.
O parâmetro acima feito, está fixo para o relatório. Fato que, para expedir um
relatório com outro conteúdo para parâmetro, ou são abertos os parâmetros
novamente e alterado os conteúdos de comparação ou é criado outro
relatório.
No programa de Manutenção de Variáveis, o usuário informou quais ele
deseja pedir em tela:
CAPÍTULO 7 Processo Geral 47

No programa de Parâmetros, ele pode informar estas variáveis como

comparação para que o programa do relatório gerado, busque as informações
no banco de dados mediante seus conteúdos:

Função Totais do Relatório

Objetivo Esta função tem por objetivo realizar a manutenção no cadastro de totais do
relatório.
Descrição Selecionar no menu do Data Viewer a opção “Geral”, item “Totais” ou através
do botão “Totais”, onde existirá acesso a tela de Totais do Relatório.
48

Adicionar total do
campo
selecionado ao
relatório.

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

inteiro ou decimal que encontram-se no layout do relatório e o browse da
direita as classificações do relatório e, o inferior, os totais do relatório.

Nota
Para que seja permitida a Manutenção de Totais, é necessário ter pelo menos
1 (um) campo no layout do relatório que seja do tipo de dado inteiro ou
decimal. Cada total possui vínculo direto com uma classificação do relatório
ou geral.

Função Manutenção de Cálculos

Objetivo Esta função tem por objetivo incluir, modificar ou eliminar os cálculos para o
relatório.
Descrição Selecionar no menu do Data Viewer a opção “Geral”, item “Cálculos” ou
através do botão “Cálculos”, onde existirá acesso a tela Manutenção de
Cálculos, onde é possível incluir, modificar ou eliminar os mesmos.
CAPÍTULO 7 Processo Geral 49

Ao incluir ou modificar um cálculo será apresentada a seguinte tela:

Botão Gerar
Código

Campo Descrição
Atributo Informar o nome do atributo (variável) que
está sendo cadastrada para armazenar o
cálculo.
50

Rótulo Informar uma descrição ou título para o campo.

Formato Informar qual forma que o conteúdo deste
campo será apresentado.
Tipo Dado Selecionar o tipo de dado que este cálculo
vai armazenar, pode ser inteiro ou decimal.
Tipo Cálculo Selecionar o tipo de cálculo que este atributo
(variável) vai armazenar.
• Contador: monta um contador de registros
dentro da classificação informada.
• Máximo: armazena no campo de cálculo o
maior valor entre este e o campo
acumulador dentro da classificação
informados.
• Mínimo: armazena no campo de cálculo o
menor valor entre este e o campo
acumulador dentro da classificação
informados.
• Média: armazena no campo de cálculo a
média entre o campo acumulador e o
número de registros lidos dentro da
classificação informada.
• Livre: armazena no campo de cálculo uma
fórmula que o usuário definiu, para ser
impressa dentro da classificação
informada.
• Total: armazena no campo de cálculo o
total do campo acumulador dentro da
classificação informada.
Linha Número da linha em que será apresentado o
cálculo, após a quebra da classificação
informada.
Coluna Número da coluna em que será apresentado o
cálculo, após a quebra da classificação
informada.
Mostra Atributo Quando marcado, o cálculo será apresentado
no relatório.
Cálculos que não serão impressos no relatório,
geralmente serão utilizados em alguma outra
fórmula para o relatório. Portanto, é
aconselhável que para estes, você informe
linha = 1, coluna = 1. Assim, estes terão sua
fórmula montada no fonte do programa do
relatório antes que todos os outros.
Classificação Tabela: tabela utilizada em classificação do
relatório, pode ser branco quando classificação
CAPÍTULO 7 Processo Geral 51

Campo Acumulado
Definição/Primeiro/Cálculo/Fim
gera.
Atributo: atributo de uma tabela utilizada em
classificação do relatório, ou geral.
Tabela: tabela utilizada para leitura no relatório.
Atributo: atributo do tipo inteiro ou decimal, de
uma tabela utilizada para o relatório.
Armazena o código progress responsável para
que seja gerado o cálculo, este código pode ser
alterado pelo usuário.
Após clicar sobre o Botão Gerar Código, e
preenchidos os campos anteriores, são
geradas as definições e fórmulas dos dados
informados, dentro dos respectivos pontos
(Definição, Primeiro, Cálculo, Fim).
• Definições: Código com as definições do
cálculo;
• Primeiro: Código para zerar o cálculo;
• Cálculo: Fórmula para atribuir o valor
desejado ao cálculo;
• Fim: Finalização do Cálculo.

Botão Gerar Código: Gera as definições e fórmulas dos dados informados,

dentro dos respectivos pontos, Definição, Primeiro, Cálculo, Fim.
Sempre que clicado o Botão Gerar Código, este irá regerar o código do
cálculo, levando em consideração os campos preenchidos na tela. Portando,
caso você tenha alterado manualmente um dos itens Definição, Primeiro,
Cálculo e Fim e depois clicar sobre o Botão Gerar Código, todas as
alterações manuais serão perdidas.

Função Fonte Livre

Objetivo Esta função tem por objetivo permitir ao usuário escrever código Progress ou
até mesmo chamar outros programas, includes em pontos específicos do
relatório.
Descrição Selecionar no menu do Data Viewer a opção “Geral”, item “Fonte Livre” ou
através do botão “Fonte Livre”, permitindo acesso a tela Inclui Fonte Livre
(código Progress para o relatório escrito pelo usuário).
52

Local do relatório
onde será utilizado
o Fonte Livre

Campo editor onde

é inserido o Fonte
Livre

Os pontos onde podem ser inseridos os códigos Progress, são os

mencionados abaixo, e estes são limitados a 2000 caracteres cada:
• Antes Leitura Registros: antes do primeiro For Each para leitura das
tabelas do relatório;
• Antes Mostrar Registros: antes do Display dos campos que fazem parte
do layout do relatório;
• Após Mostra Registros: após Display dos campos que fazem parte do
layout do relatório e, antes do Display dos cálculos definidos para o
relatório;
• Após Leitura Registros: após o End que fecha o primeiro For Each das
tabelas para leitura no relatório;
• Final Programa: antes de imprimir a página de parâmetros.
Outros pontos: Após Definição de Variáveis, Após Atribuição de Variáveis,
Após Abertura do Arquivo de Saída, Antes da Impressão dos Parâmetros,
Após Fechamento do Arquivo de Saída, Após Definição das Variáveis
(Interface), Após Definição das Includes (Interface), Botão de Fechar do
Programa (Interface), Botão de Ajuda do Programa (Interface), Botão de
Arquivo (Interface), Botão de Impressora (Interface), Troca de Valor do
Destino (Interface), Troca de Valor da Execução (Interface), Início do Código
CAPÍTULO 7 Processo Geral 53

Principal (Interface), Inicialização de Variáveis (Interface), Antes de Habilitar

Campos (Interface), Após Habilitar Campos (Interface), Início da Execução
(Interface), Execução do Relatório (Interface), Após Execução (Interface), Fim
da Execução (Interface).

Função Parâmetros de Entrada

Objetivo Esta função tem por objetivo permitir ao usuário incluir, modificar ou eliminar
os Parâmetros de Entrada.
Descrição No menu do Data Viewer, opção “Geral”, item “Parâmetros de Entrada”, ou
pelo botão “Parâmetros de Entrada”, acessar a tela Manutenção de
Parâmetros, onde é possível incluir, modificar ou eliminar os mesmos.
54

Ao incluir ou modificar um parâmetro de entrada, será apresentada a seguinte

tela:

O Tipo de Dado pode ser: Caracter, Inteiro, Decimal, Data, Lógico.

Função Manutenção de Procedures Internas

Objetivo Esta função tem por objetivo permitir ao usuário incluir, modificar ou eliminar
as Procedures Internas para o relatório.
Descrição No menu do Data Viewer, opção “Geral”, item “Procedures Internas” ou pelo
botão “Procedures Internas”, acessamos a tela de Manutenção de Procedures
Internas.
CAPÍTULO 7 Processo Geral 55

Ao incluirmos ou modificarmos uma Procedure Interna, será apresentada a

seguinte tela:

As Procedures Internas cadastradas na Função Manutenção de Procedures

Internas, poderão ser utilizadas no Fonte Livre. Estas procedures estarão
disponíveis somente para aquele relatório corrente, à qual ela foi vinculada.
 57

CAPÍTULO 8

Processo Geração

Objetivo Este processo tem por objetivo descrever as funções Teste, Fonte, Geração
WEB e Editor.

Função Teste
Objetivo Esta função tem por objetivo possibilitar a geração do programa de interface
do relatório e do programa de processamento, além de compilar e executar
este programas.
Descrição No menu do Data Viewer, opção “Geração”, item “Teste” ou pelo botão
“Teste”, efetuamos a geração do relatório (teste).

Caso ocorra algum erro de compilação, estes serão apresentados em tela

para o usuário, impedindo que o programa seja executado.

Função Fonte
Objetivo Esta função tem por objetivo possibilitar a geração do programa de interface
do relatório e do programa de processamento, além de compilar estes
programas. Esta opção não executa os programas gerados.
58

Descrição No menu do Data Viewer, opção “Geração”, item “Fonte”, efetuamos a

geração do relatório.

Caso ocorra algum erro de compilação, estes serão apresentados em tela

para o usuário.

Função Geração WEB

Objetivo Esta função tem por objetivo a Geração WEB dos relatórios. Gera a interface,
faz a compilação, porém a verificação de erro (caso ocorra) é feita no
WEBSpeed.
Descrição Esta função pode ser acessada no menu do Data Viewer, opção “Geração”,
item “WEB” ou pelo botão “Geração WEB”.
Caso o usuário deseje a Geração WEB do relatório, atualmente, deve:
• Escolher obrigatoriamente o perfil EMS 2.0.
CAPÍTULO 8 Processo Geração 59

• Não utilizar Parâmetros de Entrada.

• Não utilizar Procedures Internas (serão descartadas).

60

Função Editor
Objetivo Esta função possibilita acessar o Editor Progress.
Descrição No menu do Data Viewer, opção “Geração”, item “Editor” ou pelo botão
“Editor”, permite acesso a tela Procedure Editor.
 61

CAPÍTULO 9

Processo Administração

Objetivo Este processo tem por objetivo descrever as funções Administrar Tabelas,
Administrar Relacionamentos, Manter Relacionamentos, Manter Tabelas,
Manter Campos, Manter Usuários, Alterar Usuário Relatório, Permissões
Usuários (Tabelas / Campos), Perfis (Manter, Exportar, Importar, Manter
Blocos x Perfil), Dados (Exportar / Importar), Geração (Relatórios / Menu),
ProTools.
Será visto neste capítulo, como trabalhar com as rotinas de Administração do
Data Viewer.

Função Administrar Tabelas

Objetivo Esta função tem por objetivo importar ou eliminar no Data Viewer definições
(tabelas, campos, índices) de bases de dados a serem usadas para fazer
relatórios
Descrição Através do menu do Data Viewer, opção “Administração” item “Administrar
Tabelas”, acessamos a tela de Manutenção das Definições das Tabelas.
62

Botão “Eliminar”: Limpa o banco de dados do Data Viewer, de todas as

definições relacionadas aos bancos de dados que o usuário havia carregado
para desenvolver relatórios. Esta opção não altera os relatórios já
cadastrados.
Botão “Carregar”: Quando selecionada esta opção, será apresentada uma
nova tela.

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

conectadas disponíveis, e o browse da direita as bases selecionadas para
CAPÍTULO 9 Processo Administração 63

importação. Para passar uma tabela de disponível à selecionada, clicar sobre

a base desejada no browse de disponíveis e, depois clicar sobre o botão
incluir (>). O mesmo pode ser feito para eliminar uma base selecionada,
clicando no botão eliminar (<). Selecionadas as bases, clicar no botão “OK”, e
serão carregadas então as definições das bases selecionadas para o Data
Viewer.

Função Administrar Relacionamentos

Objetivo Esta função tem por objetivo gerar ou eliminar automaticamente no Data
Viewer, os relacionamentos referentes as tabelas das bases de dados
importadas para fazer relatórios.
Descrição Através do menu do Data Viewer, opção “Administração” item “Administrar
Relacionamentos”, acessamos a tela de Geração Total dos Relacionamentos.

Botão Carregar: gera dentro do Data Viewer os relacionamentos entre as

tabelas, estes relacionamentos são tratados pelo Data Viewer como
Automáticos. Devendo-se fazer isto apenas uma vez, a menos que seu banco
de dados, que contém as tabelas que deseja-se criar relatórios, sofra
alterações constantes a nível de índices e atributos que fazem parte da chave
das tabelas.
Botão Eliminar: limpa o banco do Data Viewer de todos os relacionamentos
do tipo automático. Este processo não afeta os relatórios já cadastrados.

Função Manter Relacionamentos

Objetivo Esta função tem por objetivo incluir, modificar ou eliminar manualmente no
Data Viewer, relacionamentos referentes as tabelas das bases de dados
importadas para fazer relatórios.
64

Descrição Através do menu do Data Viewer, opção “Administração” item “Manter

Relacionamentos”, acessamos a tela de Inclusão de Relacionamentos.

Estrutura a partir
do pai.

Estrutura a partir
do filho.

Para efetuar a inclusão do relacionamento, basta informar tabela pai, tabela

filho e os campos que fazem parte do relacionamento.
Para auxiliar o usuário que vai efetuar a inclusão do relacionamento, pode ser
utilizado o botão Pesquisa Relações (da estrutura a partir do pai e filho):
CAPÍTULO 9 Processo Administração 65

Função Manter Tabelas

Objetivo Esta função tem por objetivo incluir, modificar ou eliminar no Data Viewer,
tabelas virtuais como Buffers ou Temp-Tables (tabelas temporárias).
Descrição Através do menu do Data Viewer, opção “Administração” item “Manter
Tabelas”, acessamos a tela de Manutenção de Tabelas.
66

Botão Incluir

Para incluir uma tabela virtual, na tela de Manutenção de Tabelas, clicar sobre
o botão “Incluir”:
CAPÍTULO 9 Processo Administração 67

Campo Descrição
Tabela Inserir o nome da tabela a ser criada.
Tabela Origem Selecionar uma tabela origem, onde a nova será uma cópia da
origem.
Descrição Inserir uma descrição para a tabela criada.
Tipo Tabela Assinalar o tipo de tabela que o usuário está criando (Física,
Virtual, Temporária).
Física: quando da criação de uma tabela do tipo física, esta será
considerada como uma tabela que deveria ter sido importada de
uma base de dados para o Data Viewer.
Nota
Tabela do tipo “Física” não deve possuir tabela origem.
Virtual: tabela virtual ou buffer, é uma cópia de uma tabela física.
Devendo sempre possuir uma tabela origem. Este tipo de tabela,
quando lida, apresenta os mesmos dados existentes em sua
tabela de origem.
Temporária: é uma tabela do tipo temporária, sem dados
inicialmente. O usuário deverá fazer uma rotina para carregá-la
com as informações desejadas. Pode possuir uma tabela de
origem ou não. Estas tabelas são definidas nos programas
gerados pelo Data Viewer como new shared, podendo ser
compartilhada por outros programas durante a mesma seção
Progress.
Cópia Quando assinalada a opção “Copia Relacionamentos”, todos os
Relacionamentos relacionamentos que a tabela origem possui, serão copiados para
a tabela a ser criada. Porém, quando da manutenção de
relacionamentos na tabela origem, este não ocorrerá
automaticamente para as tabelas derivadas.

Para modificar ou eliminar uma tabela virtual, clicar nos respectivos botões na
tela de Manutenção de Tabelas.

Função Manter Campos

Objetivo Esta função tem por objetivo incluir, modificar ou eliminar no Data Viewer,
campos (atributos) das tabelas importadas ou criadas para fazer relatórios.
Permitir ao usuário realizar consulta e manutenção de atributos das tabelas
cujas definições foram carregadas para o Data Viewer ou criadas no mesmo.
Não alterando as definições dos atributos nas tabelas originais em suas bases
de dados, de onde as definições foram carregadas.
68

Descrição Através do menu do Data Viewer, opção “Administração” item “Manter

Campos”, acessamos a tela de Manutenção de Campos.

Botão Fórmula: só
pode ser informada
para atributos
virtuais.

Botão Filtrar: faixa

do nome dos
arquivos.

O usuário pode Incluir o campo desejado:

CAPÍTULO 9 Processo Administração 69

Campo Descrição
Tabela Nome da tabela a qual o atributo selecionado pertence.
Atributo Inserir o nome do atributo selecionado.
Rótulo Inserir a descrição ou título do atributo selecionado para ser apresentado
Coluna na forma de coluna.
Rótulo Inserir a descrição ou título do atributo selecionado para ser apresentado
na forma de linha.
Formato Inserir a forma a qual o conteúdo do atributo selecionado vai ser
apresentado.
Tipo Dado Selecionar tipo de informação a qual o atributo selecionado vai
armazenar.
As opções disponíveis são: caracter, inteiro, decimal, data, lógico.
Tipo Assinalar uma das opções:
Campo • Virtual: armazena uma fórmula no seu conteúdo (define uma
variável no programa do relatório que o utilizar).
• Físico: não armazena fórmula, apenas seu próprio conteúdo para o
registro.
Campo Quando assinalado, informar se o atributo possui um texto no seu
Narrativa conteúdo para o registro.
70

O usuário pode Modificar o campo desejado:

O usuário pode Eliminar o campo desejado:

Função Manter Usuários

Objetivo Esta função tem por objetivo incluir, modificar ou eliminar os usuários do Data
Viewer
Descrição Através do menu do Data Viewer, opção “Administração” item “Manter
Usuários”, acessamos a tela Manutenção Usuários:
CAPÍTULO 9 Processo Administração 71

Para incluir usuários, na tela Manutenção Usuários, clicar sobre o botão

“Incluir”, acessando a tela de inclusão de usuários:

Campo Descrição
Usuário Inserir o nome do usuário que terá acesso ao Data Viewer.
Caminho Editor Texto Inserir o caminho editor texto.
72

Diretório Trabalho Inserir o diretório de trabalho onde serão gravados os

programas criados pelo usuário no Data Viewer.
Diretório Trabalho WEB Inserir diretório de trabalho WEB.
Visualiza Barra de Quando assinalado, disponibiliza duas opções:
Ferramentas • Régua;
• ToolBar.
Tipo Usuário Assinalar uma das opções: Iniciante, Avançado,
Administrador.
Nota
Apenas os usuários do tipo Administrador, terão acesso a
rotina de administração no menu do Data Viewer.

Botão Senha: quando clicado, libera acesso a tela Manutenção de Senha.

Campo Descrição
Senha Atual Inserir a senha atual para alteração.
Quando este programa for acessado pela primeira vez, o usuário
não precisa informar a senha atual, devido a mesma não existir.
Será informado apenas a nova senha, confirmando esta senha.
Nova Senha Inserir a nova senha do usuário.
Confirma Senha Confirmar a nova senha digitada no campo "Nova Senha".

Para modificar ou eliminar um usuário, selecionar na tela de Manutenção de

Usuários, o usuário desejado para alteração, depois, clicar sobre o botão
“Modificar” ou “Eliminar”, conforme sua necessidade.
CAPÍTULO 9 Processo Administração 73

Função Alterar Usuário Relatório

Objetivo Esta função tem por objetivo alterar o usuário do relatório.
Descrição Através do menu do Data Viewer, opção “Administração” item “Alterar Usuário
Relatório”, acessamos a tela Alteração de Usuário do Relatório:

Campo Descrição
Relatório Origem Selecionar o relatório de origem.
Usuário Destino Selecionar o usuário destino do relatório.
Relatório Destino Inserir o nome do relatório destino. O programa apresenta o nome
do relatório origem, possibilitando alterações quando necessário.
Título Inserir o título do relatório, sendo que o programa apresenta o
título do relatório origem, permitindo alterações quando
necessário.
Título Inserir o título de classificação, sendo que o programa apresenta
Classificação o título classificação origem, possibilitando alterações quando
necessário.

Nota
Após alterar o usuário do relatório, o usuário anterior do relatório de origem
não mais terá este relatório na sua lista de relatórios na tela de Manutenção
de Relatórios.
74

Função Permissões Usuários (Tabelas / Campos)

Objetivo Esta função tem por objetivo efetuar o controle de acesso dos usuários do
Data Viewer às Tabelas e Atributos (campos) importados ou carregados.
Descrição Através do menu do Data Viewer, opção “Administração” item “Permissões
Usuários”, acessamos as telas:
• Manutenção de Acesso as Tabelas: informar o nome da tabela. No
browse da esquerda coluna “Disponíveis”, selecionar os usuários que
poderão utilizar esta tabela para fazer relatórios. Para passá-los a coluna
“Acessando”, browse da direita, clicar sobre o botão “Incluir”. Para retirar o
acesso, selecionar o usuário na coluna de acessando e clicar sobre o
botão “Eliminar”. O curinga “*” (asterisco), significa que todos os usuários
do Data Viewer possuem acesso a tabela informada.

Botão Incluir

Botão Eliminar
CAPÍTULO 9 Processo Administração 75

• Manutenção de Acesso a Campos: informar o nome da tabela.

No browse da esquerda, na coluna “Disponíveis”, selecionar o campo.
No browse central, os usuários que poderão utilizar este campo para fazer
relatórios.
Para passá-los a coluna “Acessando”, browse da direita, clicar sobre o botão
“Incluir”. Para retirar o acesso, selecionar o usuário na coluna de Acessando
e, clicar sobre o botão “Eliminar”. O “curinga” “*” (asterisco), significa que
todos os usuários do Data Viewer possuem acesso a tabela informada.

Botão Incluir

Botão Eliminar

Função Manter Perfis

Objetivo Esta função tem por objetivo incluir, modificar ou eliminar Perfis.
Descrição Através do menu do Data Viewer, opção “Administração” item “Perfis”, sub-
item “Manter Perfis”, acessamos a tela Manutenção de Perfis:
76

Nota
Podemos definir Perfil, como sendo um conjunto de blocos que fazem a
integração com determinado produto.

Função Exportar Perfil

Objetivo Esta função tem por objetivo a exportação de Blocos do Perfil.
Descrição Através do menu do Data Viewer, opção “Administração” item “Perfis”, sub-
item “Exportar Perfil”, acessamos a tela Exportação de Blocos:
CAPÍTULO 9 Processo Administração 77

Função Importar Perfil

Objetivo Esta função tem por objetivo a importação de Blocos do Perfil.
Descrição Através do menu do Data Viewer, opção “Administração” item “Perfis”, sub-
item “Importar Perfil”, acessamos a tela Importação de Blocos:
78

Função Manter Blocos x Perfil

Objetivo Esta função tem por objetivo incluir, modificar, eliminar ou copiar Blocos.
Descrição Através do menu do Data Viewer, opção “Administração” item “Perfis”, sub-
item “Manter Blocos x Perfil”, acessamos a tela Manutenção de Blocos:
CAPÍTULO 9 Processo Administração 79

O usuário que não tiver permissão sobre um produto específico, não terá
acesso sobre os blocos daquele produto.
80

Função Dados (Exportar)

Objetivo Esta função tem por objetivo a Exportação de Relatórios (base de dados do
Data Viewer), possibilitando assim realizar atualizações sem perda de
informações.
Descrição Através do menu do Data Viewer, opção “Administração” item “Dados”, sub-
item “Exportar”, acessamos a tela Exportação de Relatórios:

Campo Descrição
Exportação Definições: quando assinalado, indica que serão exportadas as
informações relacionadas as base carregadas para trabalhar no Data
Viewer, ou seja, são as tabelas, campos, índices, relacionamentos
entre outros.
Dados: quando assinalado, habilita os campos Perfis, Relatórios e
Seleção.
Indica que serão exportadas todas as informações referentes aos
relatórios existentes no Data Viewer, ou seja, tudo que for necessário
CAPÍTULO 9 Processo Administração 81

para que este relatório seja gerado.

Relatórios Assinalar uma das opções:
• Padrão;
• Comum;
• Ambos.
Seleção Informar uma faixa inicial e final de usuários e relatórios no Data
Viewer, para a realização de sua exportação.
Diretório Informar diretório para onde serão exportadas (geradas) as
informações.

Função Dados (Importar)

Objetivo Esta função tem por objetivo a Importação de Relatórios (base de dados do
Data Viewer), possibilitando assim realizar atualizações sem perda de
informações.
Descrição Através do menu do Data Viewer, opção “Administração” item “Dados”, sub-
item “Exportar”, acessamos a tela Importação de Relatórios:

Campo Descrição
Relatórios Definições: quando assinalado, indica que serão importadas as
informações relacionadas as base carregadas para trabalhar no Data
Viewer, ou seja, são as tabelas, campos, índices, relacionamentos
entre outros.
Dados: quando assinalado, Indica que serão importadas todas as
informações referentes aos relatórios existentes no Data Viewer, ou
seja, tudo que for necessário para que este relatório seja gerado.
Diretório Informar diretório para o qual foram geradas ou exportadas
(anteriormente) as informações (relatórios).
82

Função Geração (Relatórios)

Objetivo Esta função tem por objetivo a geração de relatórios por faixas e partes.
Descrição Através do menu do Data Viewer, opção “Administração” item “Geração”, sub-
item “Relatórios”, acessamos a tela de Opções da Geração de Relatórios:

Através das faixas por Usuário e Relatório, pode ser feita a geração de todos
os relatórios, de um ou vários usuários, de uma só vez.
Opções de geração:
• Tela Relatório: programa com tela de interface do relatório, página de
seleção, parâmetros e impressão.
• Fonte Relatório: programa com lógica do relatório, é o programa que faz o
processamento e impressão dos dados para o relatório.
• Tela Classificação: programa com tela que apresentará todas as
classificações de um mesmo relatório.
• Tela Web: quando assinalado, possibilita Geração WEB.
CAPÍTULO 9 Processo Administração 83

Função Geração (Menu)

Objetivo Esta função tem por objetivo ajudar o usuário a montar um menu para os
relatórios existentes no Data Viewer.
Descrição Através do menu do Data Viewer, opção “Administração” item “Geração”, sub-
item “Menu”, acessamos o assistente de Geração de menu do Data Viewer.

O assistente tem por função ajudar o usuário a montar um menu para os

relatórios existentes no Data Viewer.

Função ProTools
Objetivo Esta função tem por objetivo disponibilizar uma barra de ferramentas para
auxiliar o usuário do Data Viewer.
Descrição Através do menu do Data Viewer, opção “Administração” item “ProTools”,
acessamos o ProTools:
84

Disponibiliza as seguintes funções: 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

CAPÍTULO 10

Processo Formato e Impressão de Valores dos

Atributos e Variáveis

Objetivo Este processo tem por objetivo mostrar o formato e impressão de valores dos
atributos e variáveis do relatório.
Descrição 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 impressão será utilizado o formato x(20), logo, apenas os vinte
primeiros caracteres serão impressos.
Valor inicial para os formatos conforme o tipo de dado:
Tipo de Dado Formato Inicial
Caracter X(8)
Data 99/99/99
Decimal ->>,>>9.99 *
Inteiro ->,>>>,>>9 *
Lógico Sim / Não

Nota: Caso seja utilizado o formato Europeu na seção Progress (-E), o valor
inicial para formato decimal é ->>.>>9,99 e para inteiro é ->.>>>.>>9. Mais
informações ver item "Impressão para Formato Numérico".

Impressão para Formato Caracter : se o atributo está utilizando o formato

inicial x(8), apenas os oito primeiros caracteres serão impressos, a menos que
seja especificado outro formato. O “x” representa que um caracter
86

alfanumérico utilizará cada posição e, o “8” representa o número de

caracteres que o Data Viewer utilizará para a impressão.
É possível utilizar diferentes símbolos para definir o formato caracter: X,N,A,!
e 9. Pode também utilizar outros, como parênteses, vírgula, traço, etc. Para
mostrar, por exemplo, informações como número de telefone.
Símbolo Objetivo
X Representa qualquer caracter
N Representa um número ou uma letra
A Representa uma letra
! Representa uma letra e, é convertida para
maiúscula
9 Representa um número
(n) Representa quanto caracteres serão utilizados
conforme o formato.
Exemplo !(4) eqüivale a !!!!, resultando cinco
caracteres do tipo letra maiúscula.

Formato Valor Impressão

Xxxxxxxx Vários caracteres Vários c
X(9) Vários caracteres Vários ca
X(20) Vários caracteres Vários caracteres
Xxx Vários caracteres Vár
AAA-9999 Abcd1234 Abc-1234
!!!-9999 Abcd1234 ABC-1234
(999) 999-9999 6176635000 (617) 663-5000
!!!! Bola BOLA

Impressão para Formato Numérico: quando especificado o formato

numérico para o dado, é comum utilizarem-se os seguintes caracteres 9, z, *
ou >. Mas, pode-se também utilizar outros símbolos como +, -, <. Por
exemplo, o formato inicial para impressão de um atributo decimal é -
>>,>>9.99 e para um inteiro é ->,>>>,>>9. Caso seja utilizado o formato
numérico Europeu (-E) na sua seção Progress, o tipo decimal passa a ser -
>>.>>9,99 e o inteiro ->.>>>.>>9. Isto porque o formato Europeu inverte as
posições entre vírgula (,) e ponto (.) para identificação dos separadores de
milhar.
CAPÍTULO 10 Processo Formato e Impressão de Valores dos Atributos e Variáveis 87

Símbolo Objetivo
+ Posicionado na frente do número, indica que o
valor mencionado é positivo.
- Posicionado na frente do número, indica que o
valor mencionado é negativo.
> or z Caso o conteúdo do seu atributo seja (U) ou, não
utilize todo o formato, este deixará em branco ao
invés de preencher com zeros.
9 Indica um número. Caso o conteúdo do seu
atributo seja (0) ou, não utilize todo o formato,
este será preenchido com zeros.
* Indica um número. Caso o conteúdo do seu
atributo seja (0) ou, não utilize todo o formato,
este será preenchido com asterisco.

Exemplo Formato Valor Impressão

99999 1234 01234
9,999 1234 1,234
>,>>9 1234 1,234
$zzz9 123 $ 123
$>>>9 123 $ 123
$->,>>9.99 1234 $ 1,234.00
$ >,>>>9.99 1234 $ 1,234.00
$->,>>9.99 -1234 $ - 1,234.00
$ >,>>9.99 -1234 ??????

Impressão para Formato Lógico: variáveis ou atributos lógicos sempre são

tratados como falso/verdadeiro. Seu valor inicial é sempre sim/não, porém
pode-se utilizar várias palavras para representá-los como por exemplo:
comprado/fabricado, física/jurídica, azul/branco, etc.

Exemplos Formato Verdadeiro Falso

Sim/Não Sim Não
Comprado/fabricado Comprado Fabricado
Física/jurídica Física Jurídica
Azul/branco Azul Branco
88

Impressão para Formato Data: o formato data traz como valor inicial dois
dígitos para o dia, dois para o mês e dois para o ano, (99/99/99) podendo este
último ser modificado para quatro dígitos (99/99/9999). Pode-se usar como
separador a barra (/) ou o traço (-).
Também como inicial vem a ordem (mês/dia/ano). Para modificar esta ordem,
basta na inicialização da seção Progress, setar o parâmetro (-d) com a ordem
desejada, como por exemplo, -d dmy, que representa dia, mês e ano.
Exemplos Formato Valor Impressão
99/99/99 3/10/1990 03/10/1990
99/99/9999 3/10/2090 03/10/2090
99-99-99 3/10/1990 03-10-90
99-99-99 3/10/2090 ???????? *
999999 3/10/1990 031090
999999 03/10/90 031090
99999999 03/10/1990 03101990

Nota: Neste exemplo o valor 3/10/2090 é muito grande para ser mostrado
naquele formato. A parte com o ano tem formato para impressão de "99" e o
valor é "2090", onde é necessário que no formato a parte do ano seja "9999",
em função do valor sair da centena atual.
89