Gaspro PDF

GAS Pro
Gerador Automtico de Sistemas

Profissional
GAS Pro 4.0
Manual do Usurio
Manual do Usuri o
iii
Manual do Usurio
GAS Informtica Ltda
Braslia-DF
Manual do Usuri o
iv
Copyright
Todos os direitos reservados. Nenhuma parte deste
material poder ser reproduzida, transmitida,
transcrita, armazenada em meio recupervel ou
traduzida para outras lnguas, no todo ou em parte, em
qualquer forma ou por quaisquer meios, seja
eletrnico, mecnico, magntico, tico ou manual, sem
o consentimento prvio e por escrito da GAS
Informtica Ltda.
A GAS Informtica Ltda reserva-se, outrossim, o
direito de revisar e fazer mudanas peridicas no
contedo deste manual, sem a obrigao de notificar a
quaisquer pessoas ou instituies.
Alguns nomes de produtos que aparecem neste manual
so marcas registradas de seus respectivos
proprietrios.
Manual do Usuri o
v
Crditos
Projetistas e
programadores
Evandro Rodrigo da Silva
Heber Jorge da Silva
Documentao Heber Jorge da Silva
Reviso Maurcio da Costa Jatob
Teresa Cristina de Deus Oliveira
Editorao
eletrnica
GAS Informtica Ltda
Agradecimentos
pelos testes e
sugestes
Airton da Silva Cruz
Arnaldo Rocha Netto
Cristian Ramos
Danilo de Oliveira Pimentel
Fbio Garcez Freitas
Giordano Alan Barbosa Sereno
Hilton Silva Jnior
Jos Luiz Maia
Leonardo Soares da Silva
Paulo Henrique Pereira Cortez
Manual do Usuri o
vi
Esta a mais nova verso do GAS para MS-DOS,
incorporando, conforme prometemos, todas as
saudosas e viveis sugestes enviadas pelos nossos
usurios.
Este o fruto de um trabalho rduo de todos ns.
Durante meses, empenhamos nossos esforos para
disponibilizar esta ferramenta, tornando-a o mais
eficiente possvel.
Agradecemos, mais uma vez, pela colaborao e
compreenso de todos, deixando o nosso convite para
que continuem reportando novas sugestes.
Heber & Evandro
14/07/1999
Manual do Usuri o
7
Manual do Usuri o
8
Captulo 1: Introduo
O que o GAS-Pro
O GAS-Pro uma ferramenta de produtividade no
desenvolvimento de sistemas aplicativos para serem
compilados na linguagem CA-Clipper verso 5.x.
Embora mantenha a interface amigvel caracterstica
das suas verses anteriores, esta verso profissional do
GAS est dotada de recursos que possibilitam os
tcnicos de informtica definir e gerar projetos de
sistemas bastante complexos, sem qualquer esforo de
programao.
Todos os programas fontes necessrios ao sistema so
gerados como se tivessem sido programados
manualmente na linguagem CA-Clipper. Esta filosofia
permite que o GAS-Pro seja utilizado como uma
poderosa ferramenta de desenvolvimento de sistemas,
j que a posse dos programas fontes proporciona a
continuidade manual do trabalho. A agilizao e a
padronizao proporcionada representam ganhos
significativos para as organizaes, no que concerne a
custos de desenvolvimento e manuteno dos sistemas.
O GAS-Pro funciona em um Ambiente de
Desenvolvimento Integrado, contendo um mdulo
modelador do projeto, dicionrio de dados ativo,
editores de programas, telas e relatrios,
configuradores, etc., de modo que todo o projeto do
sistema aplicativo pode ser executado com bastante
simplicidade, sem a necessidade de ferramentas
externas, no havendo, na maioria dos casos, a
necessidade de interveno manual nos programas
fontes gerados.
Para usurios que no possuam experincia de
programao, com pouco treinamento, o GAS-Pro
poder ser operado para gerar aplicaes completas,
compiladas e prontas para serem executadas, com
todas as funes necessrias ao gerenciamento do
banco de dados.
Manual do Usuri o
9
Algumas caractersticas do GAS-Pro
Funciona em um Ambiente de Desenvolvimento
Integrado (IDE), contendo o modelador do projeto,
editores de texto, telas e relatrios, configuradores,
documentadores, clipboard, etc;
Gera programas fontes em CA-Clipper 5.x,
opcionalmente comentados linha a linha;
Possibilita ao projetista, atravs do mdulo
modelador, desenhar a estrutura hierrquica ou
modelo funcional do projeto conforme necessrio,
com uma interface bastante amigvel, atravs de 3
simples teclas (INS, DEL, ENTER);
Possui dicionrio de dados ativo. A um toque de
tecla, l esto os arquivos definidos no projeto, com
seus atributos, relacionamentos, etc., possibilitando
a captura de informaes atravs de menu;
Permite definio de diversos tipos de grficos para
serem apresentados pela aplicao final, espelhando
a situao dos dados existentes nos arquivos DBF;
Gera, opcionalmente, aplicaes com menus do tipo
pop-down ou menus tradicionais (retngulos
centralizados na tela);
capaz de gerar programas que fazem alteraes
globais no arquivos da aplicao (processamento em
lote);
Possibilidade de configurar a quantidade de
endentao (tabulao) das estruturas do CA-
Clipper, nos programas fontes a serem gerados;
capaz de gerar aplicativos bastante complexos
com mdulos (DBF) relacionados (1-N) a diversos
nveis, como no exemplo a seguir:
Manual do Usuri o
10
O GAS-Pro gera automaticamente todas as rotinas
para controle desses relacionamentos, como por
exemplo a integridade referencial dos arquivos
subordinados. No exemplo acima, quando for excluido
um registro de NOTAS FISCAIS, em todos os arquivos
subordinados a este arquivo, sero automaticamente
excluidos os registros que se relacionam com aquela
NOTA excluda. A rotina de entrada de dados tambm
gerada de modo a permitir a digitao dos registros
dos arquivos subordinados no mesmo momento.
Integridade referencial em tabelas. O GAS-Pro gera
rotinas para controlar e impedir o apagamento de
registros das tabelas referenciadas por registros de
outros arquivos;
Emite o projeto fsico da aplicao contendo
especificao da aplicao e seus arquivos, telas,
estruturas, atributos, relacionamentos existentes,
processamentos, lanamentos, layout de relatrios,
referncia cruzada dos mdulos, etc. Gera tambm
as capas externas e internas e o ndice por assunto
dessa documentao;
Emite a documentao de operao da aplicao
(manual do usurio) com as telas da aplicao
inseridas no texto, capa e ndice de captulos;
Gera automaticamente programa utilitrio para
adaptar os arquivos DBF da aplicao, no caso de
ocorrerem modificaes no projeto que altere nomes,
tamanhos e tipos de campos de qualquer um dos
subsistemas;
Mdulo configurador de cores, molduras das janelas,
impressoras, portas, etc., totalmente redesenhado;
Manual do Usuri o
11
Possibilidade de gerao de tela de abertura ou de
apresentao das aplicaes geradas;
Possibilidade de gerar aplicaes que utilizem os
recursos de 50 linhas na tela, em monitores VGA;
Permite a troca de fontes de caracteres na tela em
monitores VGA;
Gerador de tela totalmente redesenhado, com a
colocao de novos recursos e enriquecimento da
interface. Possibilidade de reposicionamento da tela,
de campos e frmulas. Possibilidade de usar toda a
rea til do vdeo;
Ajuda on-line sensitiva ao contexto, com pesquisa
de palavras;
Ajuda em separado para campos (ajuda ativa), que
pode ser opcionalmente apresentada
automaticamente sempre que um campo estiver
pendente de digitao;
Implementao de campos do tipo seqencial, com
incremento automtico a cada registro digitado,
podendo inclusive conter dgitos verificadores.
Campo do tipo lgico, podendo inclusive compor
expresso chave de ndices;
Em qualquer momento da definio do projeto de
sistema, sempre que for necessrio escrever alguma
expresso em CA-Clipper, pode-se invocar o editor
interno do GAS-Pro para criar trechos de programa
a serem inseridos dentro da aplicao, evitando
assim as intervenes manuais nos programas fontes
gerados pelo GAS-Pro;
Reestruturado o plano de senhas gerado na aplicao
final para funcionar de maneira semelhante ao
existente nas aplicaes geradas pelo GAS for
Windows, ou seja, criao de grupos de usurios aos
quais so dadas as permisses para as diversas
operaes nos subsistemas e o cadastramento de
usurios dentro dos grupos para herdar essas
Manual do Usuri o
12
permisses, permitindo cerceamento global a nvel
de sistema (3 nveis) e a nvel de rotina, por
subsistema (arquivo);
Por opo do projetista, o sistema poder contar com
a manuteno de um arquivo de log, em nvel de
subsistema, onde so gravadas encriptadas todas as
operaes feitas nos arquivos, como por exemplo, as
situaes anterior e atual de registros modificados
bem como quem e em que data e hora executou as
modificaes. O administrador do sistema (com
senha master) poder visualizar esses dados
mediante a simples ativao de uma hot-key;
Os arquivos de controle de senhas, bem como o
arquivo de log so agora gravados em um diretrio
separado, por opo do usurio da aplicao final.
Esta opo facilita e agiliza a operao da aplicao
em ambiente de rede, onde uma cpia do programa
executvel pode ficar em cada uma das estaes,
ganhando velocidade nos overlays dinmicos do CA-
Clipper e diminuindo o trfego na rede;
A critrio do projetista, a aplicao poder no criar
mais os arquivos de controle de senhas na mquina
do usurio, proporcionando maior segurana no
plano de senhas;
Criao automtica de ajuda on-line sensitiva ao
contexto para as aplicaes geradas;
Implementao do recurso de criao e execuo de
macros, que possibilitam a elaborao de tutoriais
para melhor entendimento da utilizao do GAS-
Pro, possibilitando tambm a elaborao de
instrues programadas para treinamento nas
empresas;
Gera, opcionalmente, sistemas aplicativos para
serem utilizados em ambiente multiusurio (rede
local);
Manual do Usuri o
13
Operao atravs de menus de barras, caixas de
dilogo com acentuao direta, janelas do tipo pick-
file com pesquisa;
Suporte completo a mouse durante toda a operao
do GAS-Pro, inclusive nos editores para marcao
de blocos, rolagens, etc;
O trabalho de definio pode ser abandonado a
qualquer tempo, sem que cause a perda da definio
do projeto de sistema em andamento;
Gerao automtica de telas e relatrios padro;
Manuteno de banco de campos contendo
atributos de campos para reutilizao posterior, em
outras aplicaes;
Possibilidade de definir mltiplos conjuntos de
pesquisas para os arquivos da aplicao;
Valor inicial (default) para quaisquer dos campos
definidos em um subsistema (arquivo). Este valor
inicial colocado automaticamente na aplicao
final, como default para o campo em digitao;
Compila automaticamente a aplicao final, na
linguagem CA-Clipper, por seleo de menu;
Possui interface com o DOS, podendo-se convocar
qualquer comando ou executar programas, sem
interromper a definio do projeto;
Emite planilhas de gerao, para facilitar a
elaborao do projeto de sistema, com
preenchimento prvio dos dados a serem informados
ao GAS-Pro;
Possibilita a definio de campos no editveis e
invisveis, a serem processados por outros
subsistemas;
Permite a definio de validao (crtica) de
campos, durante a entrada de dados, inclusive com
Manual do Usuri o
14
verificao de existncia em outros arquivos de
dados;
Possibilita a definio de processamentos, com o
estabelecimento de frmulas para modificar campos
de outros arquivos de dados;
Possibilita o estabelecimento de uma quantidade
qualquer de lanamentos a serem gerados em outros
arquivos de dados. Este recurso difere dos
processamentos acima pelo fato de criar N novos
registros no arquivo alvo do lanamento;
Permite a definio de pr-crtica de campos, ou
seja, certos campos podero ser acessados somente
se determinadas condies estabelecidas forem
satisfeitas;
Cria, opcionalmente, rotinas para permitir digitao
de dados com rolagem (scroll), ou seja, diversos
registros so visualizados ao mesmo tempo durante a
digitao de dados;
Gera, opcionalmente, menus do tipo pick, durante a
entrada de dados, podendo ser do tipo interno e
externo (outro arquivo), com captura da informao
selecionada para dentro do campo em digitao;
Permite a programao, para cada campo, de uma
funo ou comando para ser executado quando o
campo estiver sendo digitado e uma tecla de funo
for pressionada;
Permite a escolha da mensagem a ser mostrada ao
operador da aplicao final, sempre que um campo
for invalidado durante a digitao;
Permite a formatao e gerao de relatrios, na
forma de programa fonte, com quebras e
totalizaes, sem a necessidade de elaborao de
layouts prvios, feitos na prpria tela, no momento
de sua criao;
Manual do Usuri o
15
Gera, opcionalmente, rotinas de calculadora e
calendrio;
Possui utilitrios para listar programas fontes das
aplicaes geradas com ndices de contedo e funo
de cada programa, trocar o nome da moeda na funo
extenso, etc;
Possibilidade de escolha, pelo projetista, do
linkeditor (RTLink, BLinker e ExoSpace) a ser
utilizado para a montagem da aplicao;
Compatibilizao da aplicaes com a nova
legislao que obriga a utilizao de impressora
fiscal (PDV e ECF);
Aberta a possibilidade da criao de sistemas multi-
empresas. O arquivo de empresas tratado de
maneira semelhante ao que feito com o arquivo de
parmetros, com seus campos publicados no incio
da execuo da aplicao, podendo ser usados em
qualquer lugar, inclusive em cabealhos e telas. Um
menu com a lista das empresas ser aberto antes de
se iniciar uma seo de operao da aplicao e, a
critrio do projetista, cada uma dessas empresas
poder ter seus arquivos em diretrios diferentes. No
menu Apoio da aplicao, existe a possibilidade
da troca de empresa a qualquer momento;
As aplicaes geradas podem contar agora, por
opo do projetista, com barras de progresso para as
operaes de indexao, filtragem, emisso de
relatrios e etiquetas, localizao de registros,
compactao, processos pre-definidos, etc. Como
benefcio adicional, sempre que forem usadas barras
de progresso, as compactaes de arquivos .DBT so
feitas com copy, significando maior eficincia na
compactao pois registros deletados no so
copiados para o novo arquivo (j o pack deixa no
.DBT os registros deletados);
A impresso de consultas agora pode apresentar um
nmero ilimitado de quebras, com totalizao, sub-
totalizao e sumarizao. Isto significa que o
Manual do Usuri o
16
usurio final das aplicaes poder criar
praticamente qualquer tipo de relatrio, a partir das
consultas que ele prprio monta e grava;
Definio opcional pelo projetista da execuo de
processos e lanamentos serem feitas antes da
emisso de relatrios ou etiquetas. Com isto, fica
aberta a possibilidade de incluir no prprio relatrio
os dados dos processos e lanamentos que acabaram
de ser feitos;
Implementada a possibilidade de filtragem e/ou
ordenao de relatrios a partir de campos de
arquivos relacionados. Esta implementao
possibilita a obteno de relatrios ainda mais
sofisticados atravs do GAS-Pro;
Aberta a possibilidade de o projetista definir em
qualquer um dos cabealhos das aplicaes, a
apresentao de um relgio de tempo real, nos
formatos hh:mm:ss ou hh:mm;
Os menus das aplicaes do GAS-Pro podem agora
ser bem mais elaborados com a insero de linhas
separadoras entre as opes, o que facilita o
agrupamento de opes com mesmas caractersticas,
dentro de um mesmo menu;
Colocada no calendrio das aplicaes geradas a
possibilidade da seleo e captura da data mostrada
no mesmo para o campo que estiver sendo editado no
momento;
Possibilidade da definio de parmetros de opes
para serem passados ao compilador, como por
exemplo, compilar com numerao de linhas,
compilar com informao de debug, etc;
Colocada a possibilidade de se estabelecer uma
condio para que um determinado menu aparea
para o usurio. Isto pode ser feito utilizando-se
nvel, nome ou senha de usurio, campos do arquivo
de parmetros ou do arquivo de multi-empresa, etc.,
dando uma enorme flexibilidade aplicao;
Manual do Usuri o
17
O projetista poder agora definir hot-keys para que o
usurio possa acionar diretamente, de qualquer
ponto da aplicao, qualquer um dos subsistemas
definidos. As hot-keys aparecem ao lado das opes
de menu, a exemplo do que acontece no ambiente
Windows. Uma boa utilizao para este recurso, por
exemplo, quando se deseja retirar do usurio um
acesso a um dos arquivo, deixando-o ser acionado
somente pelo supervisor, atravs da hot-key;
Durante a manuteno de registros pelo usurio,
existe agora a possibilidade de o mesmo ativar a
opo cpia. Quanto ativada, esta opo cria um
registro novo a partir dos dados do registro que est
sendo visualizado na tela, bastando ento que o
usurio modifique o que desejar no novo registro
criado. Isto facilita enormemente a incluso de
novos registros na aplicao;
Aumentado o tamanho do campo Ttulo para menu
para facilitar ao projetista a nomeao de cada um
dos mdulos;
Colocadas duas hot-keys na rvore do projeto para
permitir a marcao ou desmarcao dos programas
gerados, em um s comando, de todos os mdulos do
projeto;
A recepo da data do sistema no incio da operao
da aplicao ficou agora opcional, a critrio do
projetista;
Na emisso de relatrios com processos, o projetista
poder inibir a mensagem de confirmao para
executar os processos, bastando deixar o ttulo do
processo em branco;
Em qualquer ponto da operao da aplicao onde
tiver sido estabelecido um critrio de filtragem, o
usurio poder agora recuperar o critrio anterior
para aproveit-lo utilizando-o na montagem de um
novo critrio atravs de concatenao. Tambm, na
montagem de critrios de filtragem, nveis de
parnteses so colocados automaticamente para
Manual do Usuri o
18
despreocupar o usurio com as concatenaes dos
operadores lgicos .AND. e .OR.;
Alteradas as rotinas dentro das aplicaes geradas e
nas bibliotecas do GAS-Pro para compatibilizao
com as datas na virada do milnio;
Opcionalmente o projetista poder solicitar ao GAS-
Pro para gerar uma agenda de compromissos, com
alarme, na aplicao final;
Compatibilizada a gerao de aplicaes para
utilizar os drivers RDD do CA-Clipper CDX, MDX e
NDX;
Aberta a posssibilidade na aplicao final de
direcionar o backup tambm para um diretrio ou
drive da rede, e no mais somente em drives A e B;
Colocada busca incremental nas telas de consultas
das aplicaes geradas com o GAS-Pro (inclusive
em tabelas externas - VDBF( )). Agora, medida
que o usurio vai digitando letras na coluna desejada
um registro correspondente, caso exista, ser
apresentado na tela. Esta pesquisa pode ser
chaveada atravs de uma tecla de funo para no
conflitar com as teclas de comandos e aes j
existentes nas janelas de consultas (menu F10);
Agilizada dramaticamente a filtragem inicial de
relatrios (aquela que estabelecida pelo projetista).
Agora, essas expresses de filtragem passam a fazer
parte do ndice de impresso do relatrio o que
permite um posicionamento imediato nos registros a
serem imperessos;
Agilizado dramaticamente tambm o processo de
filtragem nas tabelas externas VDBF( ). Agora, basta
que o projetista crie um ndice pelos campos que
compem a expresso de filtragem para que a
aplicao final reconhea e utilize este ndice, sem a
necessidade de indexao prvia para a apresentao
da lista externa;
Manual do Usuri o
19
Criada uma funo na biblioteca do GAS-Pro para
permitir a apresentao de letras grandes na tela.
Isto til em sistemas do tipo PDV onde o nome do
produto vendido e seu preo podem aparecer na tela
em tamanho famlia;
Aberta a possibilidade de se configurar, em tempo
de projeto, o tamanho e a posio das janelas de
consultas dos subsistemas e das consultas extras;
A critrio do projetista, o tamanho das colunas das
consultas podem ser definidas de duas maneiras:
utilizar a maior largura entre o contedo do campo e
o ttulo da coluna ou, como na verso anterior, fixar
sempre em relao largura do contedo do campo.
Algumas caractersticas dos sistemas
gerados
Possibilidade do usurio escolher e fixar, em tempo
de execuo, as posies das janelas, caixas de
dilogos e menus que aparecem nas telas;
Entrada de dados, com diversas facilidades de
digitao, como repetio de dados, confirmao,
visualizao e captura de campos de outros arquivos,
ajuda ativa por campo, etc;
Suporte completo para operao com mouse;
Alternativa rpida para substituir o comando SET
FILTER do CA-Clipper, quando os arquivos tm
tamanho considervel;
Apresentao de dois tipos de consultas aos dados
cadastrados, podendo ser tela a tela (um registro por
vez) ou vrios registros na mesma tela (tbrowse),
permitindo a elaborao de projees sobre os
campos atravs de criao de novas colunas dentro
da consulta;
Manual do Usuri o
20
Possibilidade de montar consultas prprias, com a
gravao e recuperao em disco dos parmetros das
consultas;
Possibilidade de gravar especificaes de relatrios,
para serem ativados posteriormente atravs de menu;
Alterao de dados dos registros digitados;
Acesso imediato a qualquer registro cadastrado,
mediante o fornecimento da informao dos campos
chaves de qualquer um dos conjuntos de pesquisa
definidos;
Pesquisa seqencial por qualquer campo do arquivo
ou de outros arquivos a ele relacionados;
Eliminao e recuperao de registros;
Gerao e recuperao de cpias de segurana
(backups) em um ou mais volumes;
Possibilidade de trocar fontes de caracteres na tela
(VGA);
Emisso de relatrios formatados pelo prprio
usurio, na ordem desejada, com seleo de quais
registros sero impressos (filtragem);
Exportao de dados dos arquivos, com filtragem,
nos formatos texto, DBF e SDF, para serem
utilizados em processadores de texto e outras
aplicaes;
Reconstruo de arquivos ndices;
Configurao de ambiente, cores, impressoras,
portas, mouse, etc;
Ajuda on-line, disponvel a qualquer momento,
atravs da tecla F1;
Apresentao de calendrio na tela a qualquer
momento, ou de uma calculadora, com possibilidade
Manual do Usuri o
21
de captura do resultado para dentro de campos em
digitao;
Rotinas de processamento global para manipulao
agrupada de registros segundo especificao do
usurio;
Plano de senhas com at 3 nveis de acesso, com
possibilidade de determinar quais rotinas que cada
usurio poder acessar, em cada um dos arquivos de
dados da aplicao;
Direcionamento de relatrios para arquivo, vdeo ou
impressora;
Possibilidade de impresso de relatrios a partir de
uma determinada pgina;
Aplicaes podem ter diversos conjuntos de
pesquisas indexadas;
Informao detalhada sobre erros que venham a
ocorrer durante a execuo da aplicao, como por
exemplo, em qual programa ocorreu, em qual linha,
qual o trace, possveis causas e ainda as solues
para a correo do erro;
Possibilidade de editar e imprimir campo tipo memo
com acentos e alinhado;
Possibilidade de trocar o diretrio de trabalho de
dentro da aplicao, permitindo que arquivos de
diversas empresas ou reas sejam manipulados pelo
mesmo programa;
As aplicaes geradas com o GAS-Pro podem agora
ser executadas em modo protegido, sendo
compatveis com o linker ExoSpace. Isto significa
melhor performance e uma enorme quantidade de
memria disponvel para operar a aplicao, com
possibilidade de executar programas externos com
mais liberdade, como por exemplo, um utilitrio
compactador para fazer backups.
Manual do Usuri o
22
Limitaes do GAS-Pro
Pelo fato de gerar sistemas para a linguagem CA-
Clipper verso 5.3, o GAS-Pro incorpora tambm
limites estabelecidos para a mesma. Outros limites,
contudo, so inerentes especificamente ao GAS-Pro na
maioria dos casos, devido necessidade de um
dimensionamento prvio. Esses limites foram
dimensionados em nmeros bastantes razoveis de
modo a atender maioria das aplicaes. No entanto,
pela filosofia adotada pelo GAS-Pro de fornecer,
todos os programas fontes da aplicao, esses limites
passam a no existir praticamente, pela possibilidade
da interveno nos programas fontes gerados. Esta
prtica, contudo, requer um conhecimento prvio da
linguagem de programao CA-Clipper 5.3.
Mdulos existentes (vertical) na rvore do projeto:
500
Quantidade de opes de menu de cada subsistema:
08
Nveis horizontais na rvore do projeto: 11
Campos por arquivo de dados DBF: 95
Relatrios
Quantidade mxima: 500
Largura mxima: 254
Quantidade mxima de quebras (por nvel): 10
Quantidade mxima de relacionamentos: 30
Conjuntos de pesquisa (ndices)
Quantidade mxima de conjuntos por arquivo: 8
Quantidade de campos concatenados por
conjunto: 10
Quantidade de processos definidos por arquivo: 90
Quantidade de frmulas definidas por arquivo: 90
Quantidade de lanamentos definidos por arquivo:
20
Manual do Usuri o
23
Quantidade de telas por subsistema (DBF) : 3
Editor de programas interno (EP-JR)
Quantidade mxima de linhas: 3000
Quantidade de caracteres por linha: 260
Tamanho mximo do arquivo em KB: 100
Como utilizar este manual
Este manual est organizado em funo dos seguintes
captulos:
I) Introduo
II) Conceitos preliminares: apresenta alguns
conceitos bsicos utilizados na elaborao de
projetos de sistemas com o GAS-Pro, e ainda um
glossrio com termos utilizados nos textos
explicativos deste manual.
III)Instalao do GAS-Pro: detalha os passos
necessrios para a instalao do GAS-Pro no
equipamento, bem como os requisitos necessrios
para que possa ser operado plenamente. Aborda
tambm o contedo do CD de distribuio do
produto.
IV) Ativando o GAS-Pro: este captulo aborda os
passos iniciais para a execuo do GAS-Pro no
equipamento onde foi instalado. Aborda tambm a
operao do recurso de criao e execuo de
macros, os objetos utilizados para a interface do
GAS-Pro com o seu usurio e tambm alguns
aspectos de sua operao utilizando mouse.
V) Operando o GAS-Pro: este captulo contempla uma
descrio detalhada do produto, explicando os
procedimentos a serem adotados para a utilizao do
Ambiente de Desenvolvimento Integrado do GAS-
Pro. uma abordagem cuidadosa de todas as opes
de menus e informaes a serem passadas ao GAS-
Pro na fase de elaborao de um projeto de sistema
aplicativo.
Manual do Usuri o
24
VI) Operando o editor interno do GAS-Pro - EPJr:
este captulo aborda os aspectos da operao do
editor interno do GAS-Pro, utilizado na criao de
arquivos de ajuda, manuais, planilhas,
documentao, formulrios, etc., bem como na
elaborao de rotinas em CA-Clipper, se necessrio,
para serem integradas ao projeto.
VII) Um exemplo prtico: compreende um guia
prtico de operao, ensinando atravs de um
exemplo real, todos os passos a serem seguidos para
a criao de um projeto de sistema utilizando o
GAS-Pro. Recomendamos o seu acompanhamento
cuidadoso, mesmo por usurios com conhecimentos
tcnicos de informtica.
VIII) Operando a aplicao gerada: aborda os
aspectos da operao da aplicao exemplo gerada
no captulo anterior, explicando passo a passo os
recursos colocados na aplicao pelo GAS-Pro.
IX) Utilizando a documentao on-line do GAS-Pro:
este captulo aborda os aspectos da operao do The
Norton Instant Access Engine (Norton Guides), que
fornecido nos disquetes do CA-Clipper juntamente
com a sua documentao on-line. No CD do GAS-
Pro fornecida uma base de consulta de sua
documentao no formato daquele utilitrio.
X) Utilizando o programa daptador de arquivos
DBF: aborda os aspectos da utilizao do programa
utilitrio gerado automaticamente pelo GAS-Pro,
sempre que uma redefinio do projeto causou
modificaes nos atributos de campos de qualquer
de seus arquivos.
XI) O GAS-Pro como ferramenta de desenvolvi-
mento: este captulo voltado exclusivamente para
os aspectos que venham a auxiliar a interveno
manual nos programas fontes criados para a
aplicao, caso sejam necessrias. So detalhadas
neste captulo as funes existentes nas bibliotecas
que acompanham o GAS-Pro, bem como as funes
e procedures criadas dentro dos programas fontes.
Manual do Usuri o
25
XII) Dicas e truques: a dcima e ltima parte deste
manual contm algumas dicas para auxiliar a
utilizao inteligente do GAS-Pro na
implementao de recursos especiais na aplicao.
Manual do Usuri o
26
Manual do Usuri o
27
Captulo 2: Conceitos
Preliminares
Recomendamos a leitura deste captulo mesmo queles
que possuam experincia em programao. Alguns
conceitos abordados so importantes para o
entendimento de como o GAS-Pro trata as
informaes que vo sendo fornecidas no decorrer da
execuo do projeto de sistema.
Componentes de um projeto definido
atravs do GAS-Pro
Todas as aplicaes definidas pelo GAS-Pro so
tratadas como projeto de sistema. Um projeto de
sistema se constitui de um conjunto de informaes
necessrias construo de uma aplicao, que o
GAS-Pro vai solicitando e armazenando para utilizar
no momento apropriado.
A modelagem ou desenho de um projeto atravs do
GAS-Pro feita atravs do seu mdulo modelador. Por
intermdio do modelador do projeto podemos ir
montando os mdulos que formaro a nossa aplicao
final.
Os mdulos so colocados no projeto em forma de
rvore hierrquica, e aparecem dentro do modelador
conforme o exemplo a seguir:
Manual do Usuri o
28
Graficamente, o exemplo desta rvore seria
representado assim:
Um fato importante a observar nessa estrutura que,
todos os mdulos inseridos imediatamente abaixo do
ttulo da aplicao aparecero no seu menu principal
(no nosso exemplo, os mdulos 1 e 2). Os demais
mdulos aparecero em submenus.
Tipos de mdulos que podem ser inseridos no projeto
Menu uma janela exibida na tela pelo programa,
apresentando duas ou mais opes que podem ser
selecionadas pelo usurio. Quando inserimos um menu
no projeto, estamos nos referindo a uma dessas opes.
Abaixo de uma opo de menu podem ser inseridos
qualquer outro tipo de mdulo.
Subsistema Um subsistema referido, dentro das aplicaes do
GAS-Pro, como sendo um arquivo de dados DBF com
todos os seus atributos (campos, validaes, etc.).
Quando inserimos um subsistema na rvore do projeto,
o GAS-Pro cria automticamente uma opo de menu
para a sua ativao. Precisamos depois definir um
submenu (menu do subsistema) para as opes a serem
selecionadas a partir dele. O GAS-Pro sugere
Manual do Usuri o
29
Incluso, Alterao e Consulta porm, podemos
modificar a sugesto e inserir outras, como veremos
mais adiante, nos captulos V e VII deste manual.
Diversas outras definies devem ser feitas para um
subsistema, como por exemplo, os atributos do
arquivo, chaves de acesso, tela de digitao, etc.
Debaixo de um mdulo subsistema, somente um outro
subsistema pode ser inserido, fazendo um
relacionamento 1-N (ou pai/filho) a ser abordado mais
adiante.
Tela complementar Uma tela complementar um tipo de mdulo que
possibilita a manuteno de arquivos DBF atravs de
outras telas, diferentes daquela definida originalmente
para um subsistema. Para criar uma tela complementar,
necessrio que um nome de subsistema j definido no
projeto seja informado.
Diversas telas complementares podem ser definidas
para um mesmo subsistema.
Nenhum tipo de mdulo pode ser inserido
imediatamente abaixo de uma tela complementar.
Consulta extra Uma consulta extra um tipo de mdulo que
possibilita a criao de consultas especiais a
determinados arquivos de dados da aplicao. Atravs
de consultas extras pode-se consultar arquivos
subordinados (filhos) sem a necessidade de estarem
relacionados com o arquivo pai. Nesta consulta,
diversos aspectos podem ser definidos, como por
exemplo, quais arquivos e campos constaro na
mesma, qual a ordem de apresentao, quais os
registros que faro parte (filtro), alm de outras mais.
Esta consulta sempre feita no formato browse, onde
cada registro aparece numa linha e os campos dos
registros aparecem em colunas.
imediatamente abaixo de um mdulo do tipo consulta
extra.
Rotina avulsa Uma rotina avulsa se constitui de um programa ou
fragmento de programa no gerado pelo GAS-Pro, ou
Manual do Usuri o
30
seja, escrito manualmente pelo projetista utilizando o
editor interno do GAS-Pro.
imediatamente abaixo de um mdulo do tipo rotina
avulsa.
Comando ou
programa externo
Um comando ou programa externo referido dentro do
projeto como sendo o nome de um programa
executvel qualquer ou mesmo de um comando interno
do DOS.
imediatamente abaixo de um mdulo de comando ou
programa externo.
Relatrio Um relatrio referido dentro do projeto como sendo
um mdulo emissor em papel, das informaes
retiradas dos arquivos de dados (subsistemas) e
formatadas de uma maneira especial.
Debaixo de um mdulo relatrio, somente um outro
relatrio pode ser inserido, fazendo um relacionamento
1-N (ou pai/filho)a ser abordado mais adiante.
Grfico Esta opo permite a representao dos dados dos
arquivos da aplicao na forma de grficos. Esses
grficos podem ser de diversos tipos: pizza, rea,
barras, barras-3d, linhas, etc. Esses grficos so
colocados nas aplicaes sem a necessidade de
bibliotecas especiais. Eles so apresentados pelo
utilitrio SGR - Servidor Grfico Residente,
desenvolvido pela GAS Informtica.
Etiqueta Este tipo de mdulo , em tudo, semelhante ao mdulo
relatrio. Porm, o destino das informaes emitidas ,
normalmente, um formulrio com etiquetas adesivas
para endereamento ou identificaes para diversos
fins.
Arquivo de
parmetros
Um mdulo do tipo arquivo de parmetros bastante
semelhante ao mdulo subsistema abordado
anteriormente. Entretanto, tem algumas caractersticas
prprias, a saber:
possui um s registro;
Manual do Usuri o
31
no possui chaves de acesso ou arquivos ndices
associados;
no tem arquivos relacionados;
no recebe nem gera lanamentos;
no tem montagem de consultas;
nenhum relatrio pode ser definido.
Este tipo de mdulo normalmente utilizado para
armazenar informaes que se alteram com certa
periodicidade como por exemplo, inflao, taxa de
juros, descontos, etc.
imediatamente abaixo de um mdulo do tipo arquivo
de parmetros.
Um projeto s pode ter um nico arquivo de
parmetros.
Processos pr-
definidos
Este tipo de mdulo pode ser inserido no projeto toda
vez que houver a necessidade da execuo de
processos parciais ou totais, em um ou mais arquivos
da aplicao.
Abaixo deste tipo de mdulo, somente outro mdulo
igual pode ser inserido.
Linha separadora Este mdulo poder ser inserido no projeto a fim de
proporcionar um aspecto de melhor visual aos mdulos
definidos no projeto.
Apoio Trata-se de uma categoria de mdulo destinado a,
como o prprio nome sugere, proporcionar um apoio
ao funcionamento da aplicao, como por exemplos,
rotinas de backup, suporte a mouse, configuraes, etc.
Um mdulo de apoio s pode ser inserido abaixo desta
opo, e nenhum tipo de mdulo pode ser inserido
imediatamente abaixo de um mdulo de apoio.
Manual do Usuri o
32
Como so organizadas as informaes
As informaes digitadas nas aplicaes so
organizadas em arquivos, registros e campos. Um
arquivo pode ter muitos registros que, por sua vez,
pode conter diversos campos. Para exemplificar,
tomemos um exemplo que do conhecimento de todos:
um conjunto de cartes de clientes representaria um
arquivo de dados. Cada carto, com todos os dados do
cliente, representa um registro e, finalmente, cada
informao do cliente como nome, endereo, cargo,
telefone, etc., representaria um campo.
Os arquivos so gravados em disco e suas informaes
podem ser recuperadas pela aplicao para serem
manipuladas, consultadas ou impressas em papel.
Relacionamento 1-N (1 para N)
Um relacionamento 1-N se caracteriza pelo
relacionamento de uma nica informao contida em
um arquivo com diversas outras informaes contidas
em outro arquivo. Para exemplificar, tomemos dois
arquivos, um contendo os dados de empregados e um
outro contendo os nomes dos dependentes desses
empregados.
Tabela 1: Empregados
Matrcula Nome Cargo
01 Joo Pintor
02 Pedro Pedreiro
03 Maria Copeira
04 Antnio Servente
Manual do Usuri o
33
Observe que esses dois arquivos possuem um
relacionamento 1-N (de empregados para dependentes)
ligados pelo campo matrcula.
Ao elaborar um projeto de sistema onde precisam
cadastrar empregados e seus dependentes, pessoas sem
experincia costumam definir um s arquivo, com a
seguinte estrutura:
EMPREGADOS
Campo 1: Matricula
Campo 2: Nome do empregado
Campo 3: Cargo
Campo 4: Dependente 1
Campo 5: Dependente 2
... ...
Campo N: Depentente N-3
Aqui, normalmente, h um impasse. Quantos campos
devem ser reservados para os dependentes? Qualquer
que seja o nmero, existem sempre duas
possibilidades.
a. pode existir um empregado que tenha mais
dependentes do que o limite que foi calculado.
Onde seriam cadastrados os excedentes?
b. existe um grande desperdcio de espao de
armazenamento! Nos registros de empregados
Tabela 2: Dependentes
Matr. Empr. Dependente
01 Jorge
01 Edna
01 Maria
02 Carlos
04 Durval
Manual do Usuri o
34
que no tm dependentes ou os que tm poucos,
diversos campos ficaro vazios, o que tambm
consome espao de armazenamento.
A maneira correta de resolver este tipo de problema
definindo-se dois arquivos com relacionamento 1-N.
O GAS-Pro capaz de gerar aplicaes que suportam
o relacionamento 1-N, a diversos nveis (pai/filho/
neto/...), etc, tanto em arquivos quanto em relatrios.
Glossrio
Para facilitar o entendimento das explicaes deste
manual, a seguir est um pequeno glossrio de termos
largamente utilizados nos textos explicativos.
Aplicao, Sistema ou Sistema aplicativo
Conjunto de programas, desenvolvidos com o objetivo
de executar operaes inter-relacionadas.
Argumento
Um valor ou varivel passada a uma funo.
Arquivo de dados
Um arquivo de dados uma coleo organizada de
dados ou informaes relacionadas. Seguramente, no
seu dia a dia, voc tem contato com arquivo de dados,
seja cuidando dos seus negcios fazendo uso de uma
agenda telefnica, seja manipulando uma lista de
compromissos a pagar. Cada um desses arquivos de
dados est organizado de modo a permitir que voc
possa acessar de forma fcil e rpida as informaes
neles contidas.
Um exemplo simples de um banco de dados um
arquivo de cartes de clientes, onde os dados de cada
cliente como nome, endereo, telefone, etc., aparecem
em cartes separados.
O GAS-Pro criar programas que lhe permitiro
armazenar, acessar e extrair tais informaes dos
Manual do Usuri o
35
arquivos de dados contidos em meios magnticos
(disquetes ou discos rgidos).
Arquivo alvo
Um arquivo alvo referido na fase de elaborao de
um projeto como sendo um arquivo destinatrio de
uma validao, de um lanamento ou de um
processamento externo, a partir de informaes
contidas geralmente em outros arquivos de dados.
Arquivo ndice
Um arquivo ndice um conjunto ordenado de
informaes (chaves) associadas que proporciona uma
ordenao lgica dos registros existentes em um
arquivo de dados. Cada chave existente no arquivo
ndice est associado a um determinado registro
existente no arquivo de dados. o arquivo ndice que
proporciona a localizao imediata das informaes
existentes no arquivo de dados.
Arquivo de parmetros
Um arquivo de parmetros referido, dentro das
aplicaes do GAS-Pro, como sendo um arquivo DBF,
com um s registro, contendo informaes que sofrem
alteraes com certa periodicidade. Podem ser vistas
por toda a aplicao, como por exemplo, taxa de juros
de mercado, descontos, inflao, etc.
Backup
Ou cpia de segurana, se constitui em cpias de
reserva de programas ou arquivos de dados, utilizadas
para prevenir perdas eventuais ocasionadas por danos
fsicos no meio de armazenamento ou por outras
causas. A manuteno de cpias de segurana (ou
backups) dos arquivos de dados providncia
indispensvel em qualquer instalao, por menor que
seja.
Manual do Usuri o
36
Banco de campos
um conjunto de arquivos contendo especificaes de
campos. Esses arquivos podem ser carregados e suas
definies aproveitadas para definir outros campos
com as mesmas caractersticas, dentro de qualquer
subsistema.
Biblioteca de funes
Bibliotecas so rotinas pr-compiladas e agrupadas em
arquivos de extenso LIB utilizadas para a montagem
(linkedio) do programa final executvel. O CA-
Clipper vem acompanhado de suas prprias bibliotecas
de funes e no CD do GAS-Pro so fornecidas
algumas bibliotecas para serem utilizadas pelo CA-
Clipper verses 5.01, 5.2 e 5.3.
Caixa de dilogo
So janelas apresentadas pelo GAS-Pro ou pelas
aplicaes por ele geradas, com a finalidade de receber
uma informao do usurio, atravs do teclado. Esta
janela sempre apresentada com um ttulo contido em
uma ou mais linhas, uma mensagem tambm em uma
ou mais linhas e uma rea de digitao onde o cursor
posicionado para receber as informaes. Dentro do
campo destinado digitao poder, eventualmente,
aparecer uma sugesto que o usurio poder
aproveitar, modificar ou mesmo descartar.
Campo
uma diviso do registro. Nos projetos definidos
atravs do GAS-Pro, um campo contm diversos
atributos como nome, tamanho, tipo, casas decimais,
mscara, validao, etc.
Campo-chave
o campo do arquivo designado para servir como
chave de acesso aos registros, ou seja, o campo que
vai identificar um registro ou grupo de registros dentro
do arquivo de dados no momento em que nele se fizer
uma pesquisa de informao. Esse campo nunca pode
Manual do Usuri o
37
aparecer sem informaes, em branco ou zerado. Um
arquivo poder ter mais de um campo-chave, porm, a
pesquisa sobre o segundo campo-chave estar
subordinada ao primeiro campo.
Campo invisvel
Durante a definio dos sistemas existem alguns
campos que no podem ou no so de interesse do
projetista que o usurio veja o seu contedo. Esse tipo
de campo, que denominado invisvel nas
explicaes deste manual, normalmente processado
por informaes contidas em outras bases de dados,
atravs de lanamentos ou processamentos externos.
Campo no editvel
Diferentemente do campo invisvel, os campos no
editveis podem ser vistos pelo usurio da aplicao
porm, no podem ser acessados para digitao ou
modificao. Esse tipo de campo, que denominado
no editvel nas explicaes deste manual,
normalmente processado por informaes contidas
em outras bases de dados, atravs de lanamentos ou
processamentos externos.
Caracter de controle
Caracter de controle so os caracteres cujos cdigos
definidos na tabela ASCII esto abaixo de 32, e so
utilizados, como o prprio nome indica, para controles
diversos, como por exemplo, cdigo para alimentao
de linha, salto de pgina, retrocesso, etc. Esses cdigos
geralmente so utilizados nas sadas de impressoras ou
em programas de comunicao de dados.
Caracteres extendidos
So os caracteres da tabela ASCII com cdigos acima
de 127, normalmente utilizados para a formao de
caracteres estrangeiros ou semi-grficos.
Manual do Usuri o
38
Comando ou programa externo
Um comando ou programa externo referido pelo
GAS-Pro como sendo o nome de um programa
executvel qualquer ou mesmo de um comando interno
do DOS.
Compilador
Compilador um programa utilitrio que serve para
transformar programas escritos em linguagem de
programao, para a linguagem de mquina, ou seja a
linguagem que o computador entende. Como benefcio
principal desta operao est o aumento da velocidade
de processamento do programa.
Conjunto de pesquisa
Conjunto de pesquisa um grupo de at 10 campos
escolhidos para compor uma chave de indexao de um
arquivo de dados. Nas aplicaes geradas pelo GAS-
Pro, podem ser definidos at 8 conjuntos de pesquisa
para serem gerados automaticamente, de modo que, o
operador da aplicao pode escolher, durante os
processos de consulta, qual o conjunto que comandar
a pesquisa.
Default
Esta palavra, largamente utilizada como jargo de
informtica, significa uma situao ou informao que
assumida pelo programa, quando esta no for
informada ou obtida durante a sua execuo.
Diretrio / subdiretrio
Diretrio uma tabela gravada em disco, manipulada
pelo DOS, onde se encontram os nomes, tamanhos e
outras informaes de todos os programas e arquivos
que esto gravados naquele disco. Pode-se ver o
diretrio de um disco, sempre que se selecionar o drive
e digitar DIR ou DIR /W. Subdiretrio um diretrio
criado sob outro diretrio, formando uma estrutura
hierrquica (em rvore).
Manual do Usuri o
39
Etiqueta
Este tipo de mdulo , em tudo, semelhante ao mdulo
relatrio explicado em outro tpico deste glossrio;
porm, o destino das informaes emitidas ,
normalmente, um formulrio com etiquetas adesivas
para endereamento ou identificaes de diversos fins.
Filtragem
Filtragem ou critrio de seleo de registros o
estabelecimento de condio para agrupar registros
para sofrerem um processamento qualquer.
Funo
Uma funo se caracteriza por uma rotina especial,
residente em uma biblioteca de funes, utilizada para
executar uma determinada tarefa, retornando sempre
um resultado qualquer. Existem dois tipos bsicos de
funes: as que so inerentes linguagem de
programao, e as que so definidas pelo programador.
Existem funes do CA-Clipper verso 5.2 que
precisaro ser conhecidas para que possam ser
utilizadas, se necessrio, na formatao de relatrios
ou na validao de campos, bem como na montagem de
critrios para a seleo dos registros durante a
operao do sistema gerado. Algumas delas so:
TRIM(expC) ou RTRIM(expC)
onde expC um campo ou expresso do tipo
caracter. Esta funo utilizada para a
eliminao dos espaos em branco no final de
uma expresso caracter. Por exemplo,
suponhamos que se tenha definido um campo
chamado CIDADE com um tamanho de 20
caracteres. Assim, quando se digitar a cidade
Braslia dentro deste campo, este ficar com o
seguinte contedo:
Brasilia
Esta funo permite que os espaos aps a
palavra Braslia sejam eliminados.
Manual do Usuri o
40
ALLTRIM(expC)
Semelhante a funo anterior, eliminando porm
os espaos tanto da direita como da esquerda da
palavra.
IF(condio, Resultado1, Resultado2)
Esta funo opera como se fosse um IF linear. A
expresso condio avaliada e, caso seja
verdadeira, Resultado1 ser considerado. Em
caso contrrio, valer o Resultado2.
Na expresso:
var=IF(1<2, 10, 0)
a expresso 1<2 ser avaliada retornando
verdade (.T.) e a varivel var assumir o valor
10.
LTRIM(expC)
Elimina os espaos somente do lado esquerdo da
palavra.
STR(expN, Q, D)
onde expN significa um campo ou expresso do
tipo numrico qualquer, Q a quantidade de
dgitos e D a de decimais. Essa funo
utilizada para converter a expN em uma
expresso do tipo caracter, contendo os mesmos
dgitos.
Tambm, na formatao de relatrios e
etiquetas, essa funo ser til para imprimir
dois campos de tipos diferentes (numrico e
caracter) na mesma linha do relatrio ou
etiqueta.
SUBSTR(expC, pos, tam)
Manual do Usuri o
41
serve para se extrair uma parte especfica de um
campo do tipo caracter, comeando na posio
pos e com um tamanho igual a tam. Por
exemplo, assumindo-se que o campo CIDADE
tenha um contedo igual a BRASILIA:
SUBSTR(cidade,1,6) = BRASIL
SUBSTR(cidade,2,3) = RAS
Alm dessas funes, recomendvel o
conhecimento das demais funes do CA-
Clipper, para uma melhor utilizao. As funes
disponveis dessa linguagem esto
documentadas no respectivo manual. muito
importante tambm o conhecimento das funes
existentes na biblioteca GASPRO5x.LIB
fornecida no CD do GAS-Pro, que esto
detalhadas no captulo XI - O GAS-Pro como
ferramenta de desenvolvimento, tpico
Funes da biblioteca GASPRO.LIB.
Indexao
o modo pelo qual os registros esto organizados
dentro do arquivo de dados. Esta organizao feita
em funo do campo-chave. Assim, um arquivo de
dados indexado pelo campo NOME, estar organizado
alfabeticamente e tambm todas as pesquisas a este
arquivo sero feitas em funo desse campo.
Integridade referencial
Integridade referencial se caracteriza pela preservao
da integridade das informaes em um banco de dados
que sejam referenciadas por outras informaes.
Basicamente, o GAS-Pro trata de dois tipos de
integridade referencial:
Integridade de arquivos subordinados (pai/filho/neto...)
Podemos tomar como exemplo dois arquivos: um que
armazena dados de notas fiscais e outro que armazena
os dados dos itens constantes das notas fiscais
cadastradas no primeiro arquivo. Se o usurio da
aplicao apagar um registro de Notas Fiscais, os itens
Manual do Usuri o
42
referentes a esta nota, que se encontram armazenadas
no outro arquivo ficaro rfos, tendo que ser tambm
apagados.
Integridade de validao externa (tabelas)
A integridade de validaes pode ser exemplificada
tomando-se dois arquivos em que um deles tm seus
registros validados segundo a sua existncia no outro
arquivo. Para mostrar um exemplo clssico,
suponhamos um cadastro de empregados em que os
cdigos dos cargos sejam validados em uma tabela de
cargos. Ao ser apagado um registro da tabela,
necessrio verificar se existe algum registro de
empregado sendo validado naquele registro da tabela
de cargos. Caso exista, o usurio deve ser avisado e a
operao no poder prosseguir.
Do primeiro tipo de integridade, o GAS-Pro trata
automaticamente, colocando nos programas fontes as
rotinas necessrias. Do segundo tipo de integridade, o
GAS-Pro cuidar somente se esta opo estiver
configurada.
Janela
As janelas so retngulos que o programa exibe na tela
do micro, para apresentar mensagens, menus ou caixas
de dilogos, durante a sua execuo.
Lanamento
Durante a definio de um projeto de sistema atravs
do GAS-Pro, podem ser definidos processos especiais
para serem efetuados sobre os arquivos de dados. Um
deles o lanamento que se constitui na criao de um
ou mais registros vazios dentro do arquivo alvo e o
conseqente preenchimento de seus campos com fr-
mulas ou informaes contidas em outros arquivos. O
lanamento semelhante ao processamento externo,
sendo diferente apenas no fato de que, no lanamento,
um ou mais registros so criados no arquivo alvo.
Manual do Usuri o
43
Linkedio
Se constitui em um processo intermedirio e final
(seguinte compilao) na obteno do programa
executvel. Neste processo, as rotinas necessrias ao
funcionamento do sistema so pesquisadas nas
bibliotecas de funes e ligadas ao arquivo produzido
pelo compilador, gerando o cdigo final executvel,
gravado em um arquivo de extenso .EXE.
Macro
A macro se constitui em um conjunto de caracteres
gravados em arquivo que, quando passados ao GAS-
Pro, faz com que este trabalhe sozinho na gerao de
uma aplicao, sem a interferncia do operador. As
macros podem ser criadas e executadas atravs do
GAS-Pro. O captulo IV detalha a sua utilizao. Um
outro conceito de macro existe quando se est
operando o editor interno do GAS-Pro (EP-Jr). Ali, as
macros so tratadas como um conjunto de caracteres,
que so muito utilizados em um texto, e que podem ser
inseridos no texto atravs de um simples comando.
Menu
uma janela exibida na tela pelo programa,
apresentando duas ou mais opes que podem ser
selecionadas pelo usurio, utilizando-se das setas
cursoras do teclado do micro. Nos menus apresentados
pelo GAS-Pro e pelas aplicaes por ele geradas, o
usurio pode tambm selecionar as opes
pressionando a primeira letra da opo desejada e a
tecla ENTER em seguida.
Nome de arquivo
o nome pelo qual um determinado programa ou
arquivo identificado quando gravado no disco. Um
nome de arquivo composto de uma letra para
designar a unidade controladora de disco em que ser
gravado ou j esteja gravado, seguida de : (dois
pontos) e do nome do arquivo propriamente dito, com
at 8 caracteres (letras ou nmeros).
Manual do Usuri o
44
Opcionalmente pode-se acrescentar ao nome do
arquivo um . (ponto) e uma extenso com at trs
caracteres. Essa extenso serve para designar o tipo do
arquivo. Abaixo esto alguns exemplos:
A:TESTE.DBF
Arquivo de dados (tipo DBF) de nome TESTE,
gravado no drive A.
C:CLIENTES.TXT
Arquivo de texto (tipo TXT) de nome
CLIENTES, gravado no drive C.
Overlay
Este termo define uma tcnica de programao que
permite um uso racional da memria disponvel do
computador. Esta tcnica consiste na alocao de uma
rea de memria dividida em duas partes: uma fixa
onde fica residente uma parte do programa em
execuo, e outra compartilhada por outros mdulos
(overlays).
Pano de fundo
O pano de fundo mencionado no manual e nas telas
do GAS-Pro e das aplicaes geradas, se constitui da
rea da tela sobre a qual as diversas janelas e menus
so exibidas. O pano de fundo das telas do GAS-Pro
e das aplicaes podem ser configuradas pelo usurio.
Path
Este termo utilizado para especificar um caminho
para o DOS encontrar os arquivos gravados em disco.
Processamento externo
Um processamento externo se caracteriza por
alteraes de contedos de campos de arquivos a partir
de informaes que esto sendo digitadas em outros
arquivos. O processamento externo semelhante ao
lanamento, sendo diferente apenas no fato de que,
Manual do Usuri o
45
neste ltimo, um ou mais registros so criados dentro
do arquivo alvo.
Projeto
Todas as aplicaes definidas pelo GAS-Pro so por
ele tratadas como projeto de sistema. O projeto de
sistema se constitui no conjunto de informaes
necessrias construo de uma aplicao, que o
GAS-Pro solicita e armazena para utilizar no momento
apropriado.
Prompt do DOS
O prompt do DOS a situao na qual o Sistema
Operacional est aguardando do operador um comando
qualquer. Este prompt normalmente marcado com a
letra do drive corrente, podendo s vezes conter o
nome do diretrio atual, data, hora, etc.
Registro
Em um arquivo de dados, todos os dados para um item
particular chamado de REGISTRO. Por exemplo, no
arquivo de cartes de clientes, cada registro contm
todas as informaes de determinada pessoa. Cada
item de informao dentro de um registro chamado
de CAMPO. Um carto de cliente possui campos para
nome, telefone, endereo, etc.
Relatrio
Um relatrio referido dentro do projeto como sendo
um mdulo emissor em papel, das informaes
retiradas dos arquivos de dados (subsistemas) e
formatadas de uma maneira especial.
Rotina avulsa
Uma rotina avulsa se constitui de um programa ou
fragmento de programa no gerado pelo GAS-Pro, ou
seja, escrito manualmente pelo projetista utilizando o
editor interno do GAS-Pro e colocado no projeto de
sistema em definio pelo GAS-Pro.
Manual do Usuri o
46
Servidor de arquivos
um computador conectado a uma rede local que faz o
armazenamento de dados para outros computadores
(estaes de trabalho) tambm conectados rede, com
a finalidade de proporcionar o compartilhamento de
informaes para mltiplos usurios.
Sistema Operacional - ou DOS
um conjunto de programas que se encontra gravado
em disco e que so responsveis pelo gerenciamento
de todas as operaes realizadas pelo
microcomputador. O Sistema Operacional fornecido
pelo fabricante do equipamento, quando da aquisio
do mesmo. O Sistema Operacional mais comum para
os microcomputadores o MS-DOS.
String
Uma seqncia de caracteres incluindo letras, nmeros
e smbolos.
Subsistema
Um subsistema referido, dentro das aplicaes do
GAS-Pro, como sendo um arquivo DBF, contendo
todas as rotinas necessrias sua manipulao, como
entrada de dados, manuteno e consultas aos
registros.
Tabela ASCII
A tabela ASCII (American Standard Code for
Information Interchange) ou Cdigo Padro
Americano para Intercmbio de Informaes uma
tabela com cdigos de 0 a 255 elaborada para
representar os caracteres (letras, smbolos, etc.) dentro
da memria do microcomputador.
Tamanho de campo
a quantidade mxima de caracteres que so
permitidos como entrada para determinado campo. O
tamanho de um campo do tipo numrico pode ser no
Manual do Usuri o
47
mximo de 19 dgitos, incluindo-se o ponto decimal e
as casas decimais. Para o tipo Caracter, o tamanho
mximo permitido de 999 caracteres.
Um aspecto muito importante nas definies de
tamanhos de campos que, se forem definidos
inadequadamente, podero surgir problemas de espao
de armazenamento do arquivo de dados. Cada posio
a mais, sem necessidade, que tenha sido dimensionado
para um campo, ocupar espao desnecessrio em
disco, espao este que pode ser considervel,
dependendo do nmero de registros contidos no
arquivo.
Tela complementar
Uma tela complementar um tipo de mdulo que
possibilita a manuteno de arquivos DBF atravs de
outras telas, diferentes daquela definida originalmente
para um subsistema.
Tipos de campos
Os tipos de campos de arquivos manipulados pelos
sistemas gerados pelo GAS-Pro, podem ser:
CARACTER
Podendo conter letras, nmeros, smbolos,
pontuao, bem como nmeros que no venham
a ser utilizados em clculos, como por exemplo
os nmeros de telefone, cep, carteira de
identidade, etc.
NUMRICO
Podendo conter somente nmeros que podem ser
calculados, pontos decimais e sinais + e -.
Devido ao fato das entradas numricas
representarem dados para serem calculados,
recomendamos no us-los para especificar
telefones, matrculas, etc.
Manual do Usuri o
48
LGICO
Podendo conter as letras T, F, Y ou N, que
significa verdadeiro (T e Y) ou falso (F e N).
DATA
Podendo conter datas, com um tamanho de 8
posies.
MEMO
Podendo conter cerca de 64 mil caracteres, este
tipo de campo pode ser usado para armazenar
informaes mais extensas, como por exemplo,
um texto com providncias tomadas sobre
determinado assunto.
TSR
Abreviao de Terminate and Stay Resident, uma
classe de programa que tem a capacidade de ficar
residente e ativo na memria do micro enquanto outros
programas so executados. Os programas residentes
podem, a um determinado estmulo, em determinado
momento, interromper a execuo do programa que
estiver sendo executado e tomar o controle do micro
para executar uma tarefa qualquer. O GAS-Pro possui
dois utilitrios desse tipo que so o GASLEEP e o
GASCAPT.
Varivel
Um nome ou identificador contendo um valor possvel
de ser avaliado.
Manual do Usuri o
49
Manual do Usuri o
50
Captulo 3: Instalando e
retirando o GAS-Pro do
equipamento
Este captulo aborda os aspectos da instalao do
produto GAS-Pro no equipamento microcomputador
do usurio, de modo que possa ser utilizado na sua
plenitude.
Requisitos de hardware (equipamento)
O GAS-Pro executvel em qualquer
microcomputador da linha IBM-PC (80386 ou
posterior), com Sistema Operacional compatvel com o
MS-DOS, verso 3.00 ou posterior, com a configurao
mnima de 2 Mbytes de memria expandida, uma
unidade de CD-ROM e um disco rgido tipo
winchester, alm de impressora.
Requisitos de memria
Por operar em um Ambiente de Desenvolvimento
Integrado (IDE), o GAS-Pro requer uma quantidade
mnima de memria para alocao de dados de 340
KBytes, o que, na realidade, representa cerca de 560
Kbytes de memria livre antes de ser executado, a
nvel do DOS. Ao ser ativado, o GAS-Pro far uma
verificao da memria disponvel avisando se esta
estiver aqum do mnimo necessrio. Ao receber esta
mensagem, aconselhvel verificar se existe na
memria programas residentes (TSR) que possam ser
desalocados para fornecer ao GAS-Pro as condies
plenas de funcionamento.
Manual do Usuri o
51
Requisitos de software (programas)
Para rodar as aplicaes geradas pelo GAS-Pro
necessria a utilizao do produto CA-Clipper verses
5.01, 5.2 e 5.3.
O que vem no CD do GAS-Pro
O GAS-Pro - Gerador Automtico de Sistemas,
comercializado em Compact Disk (CD), acompanhado
do presente manual on-line de operao e software
para a leitura do referido manual.
Aps a instalao do produto, o diretrio do GAS-Pro
dever conter os seguintes arquivos:
Os programas e overlays do sistema gerador
As bibliotecas
As bibliotecas de funes desenvolvidas pela GAS
Informtica para funcionar com o CA-Clipper 5.01,
implementam as mesmas funes que existem naquelas
dedicadas ao CA-Clipper 5.2 e CA-Clipper 5.3.
GAS.EXE GAS05.OVL GAS14.OVL
GAS00.OVL GAS06.OVL GAS15.OVL
GASPRO51.LIB GASPRO52.LIB GASPRO53.LIB
GASP51PM.LIB GASP52PM.LIB GASP53PM.LIB
Manual do Usuri o
52
As diferenas entre as bibliotecas acima est exposta
abaixo:
GASPRO51.LIB
Est escrita e compilada em CA-Clipper verso 5.01
GASPRO52.LIB
GASPRO53.LIB
GASP51PM.LIB
Est escrita e compilada em CA-Clipper verso 5.01 e
pode ser utilizada em modo protegido
GASP52PM.LIB
GASP53PM.LIB
Essas funes esto documentadas detalhadamente no
Captulo XI - O GAS-Pro como ferramenta de
desenvolvimento, neste manual, e tambm no arquivo
GASPRO.NG, a ser explicado mais adiante, no
captulo IX.
Manual do Usuri o
53
Os arquivos de extenso .PLA
Esses arquivos contm planilhas para auxiliar a
elaborao do projeto de sistema e ainda para
documentar tecnicamente o projeto. Todas essas
planilhas podem ser modificadas, se necessrio,
conforme veremos mais adiante neste manual.
Os arquivos auxiliares
GASPRO.SOS
Contendo um exemplo de texto de ajuda para o
operador do sistema gerado. Este texto, que poder ser
mudado ou refeito totalmente, s estar pronto para ser
usado como ajuda ao sistema gerado aps a execuo
da opo Prepara ajuda a partir do menu de
utilitrios do GAS-Pro.
GASPRO.HLP
Contm todas as instrues de ajuda on-line, sensitiva
ao contexto, para a operao do GAS-Pro.
GASLETRA.BLK
Contm as fontes de letras de bloco utilizadas pelo
GAS, para emitir capas de listagens, projeto fsico e
manual de usurio da aplicao gerada. Quando este
arquivo no encontrado no disco, o GAS no
confecciona as capas.
.
APLICA GLO PROCESSO
ATRIB SUBSIS PROJETO
DBF LANC SUBSIS
Manual do Usuri o
54
VGALIB.FTS
Contm fontes de caracteres para monitores do tipo
VGA, para permitir diversas opes a serem mostradas
nas telas do GAS-Pro e das aplicaes geradas.
PRINTERS.DBF
Contm as especificaes das impressoras cadastradas
no GAS-Pro, que so passadas para as aplicaes
geradas.
GASMANU.GAB
Contendo o gabarito do manual do usurio, que pode
ser modificado segundo as explicaes detalhadas
neste manual.
GAS.ICO e GAS.PIF
Contendo, respectivamente, um cone e informaes
sobre o programa GAS.EXE, para ser executado no
ambiente do Windows verso 3.1 ou posterior. O
Arquivo GAS.PIF est configurado para ser executado
em um diretrio de nome C:\GASPRO40, de modo
que, se o GAS-Pro for instalado em um outro
diretrio, necessrio que este arquivo seja
modificado pelo utilitrio PIFEDIT do Windows.
ERROS.DBF
Contendo as mensagens sobre causas e solues de
erros de execuo da aplicao gerada. Este arquivo
tem seus dados criptografados.
GETSYS.PRG
Contendo o programa fonte da classe de objeto GET
fornecida pelo CA-Clipper, modificado para atender s
necessidades dos programas gerados pelo GAS-Pro,
como suporte a mouse, ajuda ativa, etc.
Manual do Usuri o
55
SGRGAL.PCX
Este arquivo a galeria de tipos de grficos que podem
ser colocados na aplicao.
SGRHELV8.FON
Arquivo de fontes de letras para vdeo padro CGA,
utilizado pelo SGR.EXE.
SGRVGA.FON
Arquivo de fontes de letras para vdeo padro EGA e
VGA, utilizado pelo SGR.EXE.
Os utilitrios
GASCAPT.EXE
Se encarrega da captura das telas do sistema aplicativo
gerado, para constar no manual do sistema (manual do
usurio), que emitido pelo prprio GAS-Pro. Este
programa um programa do tipo residente (TSR).
GASLEEP.EXE
Um programa de apresentao grfica destinado a
preservar o monitor de vdeo do microcomputador.
Como apresenta grficos que esto em movimentao
constante, evita a queima dos elementos de fsforo do
monitor. Este programa do tipo residente (TSR) e,
para ser usado, dever ser carregado na memria antes
da ativao do GAS-Pro. Sua ativao est detalhada
no Captulo IV.
SGR.EXE
Este o programa SGR - Servidor Grfico Residente
que cuida das apresentaes de grficos, quando estas
Manual do Usuri o
56
estiverem providas desses recursos. Este utilitrio foi
desenvolvido pela GAS Informtica e poder
acompanhar as aplicaes geradas pelo GAS-Pro, sem
quaisquer royalties, no podendo, no entanto, ser
comercializado separadamente ou ser utilizado em
outras aplicaes que no tenham sido geradas pelo
GAS-Pro.
Outros arquivos
Eventualmente outros arquivos podero estar presentes
no diretrio do GAS-Pro como, por exemplo:
Arquivos com extenses .ATR, .PRO, .REL, .PRG, .ETQ e
.SGR
Contendo especificaes de aplicaes geradas pelo
GAS-Pro e que podero servir para aprendizado de
operao do GAS-Pro. Esses arquivos sero colocados
pelo utilitrio instalador, em um subdiretrio de nome
ESTOQUE, abaixo do diretrio GASPRO40.
Arquivos com extenso .CPO
o banco de campo inicial do GAS-Pro. Futuramente,
com a utilizao do GAS-Pro, outros arquivos podero
ser adicionados.
Arquivo EPJR.MAC
Utilizado pelo editor interno do GAS-Pro (EP-Jr)
para operar com macros.
GASPRO.NG
Alm desses arquivos no diretrio do GAS-Pro, existe
outro de nome GASPRO.NG que se constitui numa
base de dados contendo informaes sobre o GAS-
Pro, no formato do utilitrio Norton Instant Access
Engine (Norton Guides) que acompanha o CA-Clipper
Manual do Usuri o
57
verso 5.x. Se o diretrio de nome \NG for encontrado
no disco rgido, este arquivo ser ali colocado no
momento da instalao do GAS-Pro para ser utilizado
como base de consulta do GAS-Pro.
Como instalar o GAS-Pro no equipa-
mento
Antes de iniciar este procedimento, assegure-se de que
o microcomputador onde ser instalado o GAS-Pro
esteja isento de qualquer tipo de vrus. Existem
diversos programas anti-vrus no mercado que podem
realizar esta tarefa. S ento, prossiga com a
instalao do GAS-Pro.
Para ser instalado, o GAS-Pro necessita de cerca de
4.6 Mbytes livres no disco rgido. Antes de iniciar a
instalao, verifique esta disponibilidade.
Para a instalao do GAS-Pro no equipamento, basta
colocar o CD do GAS no referido drive, posicionar-se
nesse drive e digitar:
INSTALAR
Se a opo Inserir notificao automaticamente das
Propriedades do Sistema estiver habilitada, o
equipamento iniciar, imediatamente, a instalao do
GAS Pro.
Ao ativar o programa, selecione Instalar o GAS-Pro
v4.0 no disco rgido para iniciar o processo de
instalao. O programa de instalao colocar na tela,
todas as informaes necessrias. Durante e aps o
processo de instalao, alguns aspectos devem ser
observados:
Manual do Usuri o
58
Programas compactadores e otimizadores de
winchester
Programas compactadores e otimizadores de
winchester podem ser utilizados sem quaisquer
restries. O GAS-Pro tambm pode ser instalado sem
problemas em discos compactados com o utilitrio
DBLSPACE do MS-DOS verso 6.x.
Instalao em rede local
Embora o programa de instalao permita a escolha do
nome do diretrio para instalar o GAS-Pro em
ambiente de rede local, recomendamos a instalao em
um diretrio de nome GASPRO40, no servidor da
rede. O programa de instalao do GAS-Pro criar
dois arquivos de controle neste diretrio.
Redes baseadas
em servidores
A instalao em um servidor de arquivos idntica
instalao em um disco rgido. Entretanto, a pessoa
que estiver fazendo a instalao do GAS-Pro precisa
ter acesso de criao e gravao (create/write) no
subdiretrio onde o GAS-Pro est sendo instalado
(\GASPRO40). Tambm, os usurios do GAS-Pro na
rede precisam ter, pelo menos, acesso de leitura
(read) neste diretrio.
Redes peer-to-peer Se o GAS-Pro vai ser acessado por qualquer uma das
estaes, ento, ele tem que ser instalado atravs do
redirecionador da rede. Instalado dessa maneira, um
usurio s poder acess-lo de outra estao se estiver
logado na rede. Se o GAS-Pro foi instalado atravs
do redirecionador em um PC que o usurio ir usar, ele
ter de acessar o seu disco rgido como drive da
rede, para poder usar o GAS-Pro.
Utilizao da memria de vdeo
Durante a operao de emisso do projeto fsico
atravs da opo Utilitrios, o GAS-Pro utiliza a
memria de todas as pginas de vdeo disponveis,
para a montagem das telas da aplicao. Se algum
Manual do Usuri o
59
programa residente estiver fazendo uso dessa rea (por
exemplo o QEMM 7.03, da QuarterDeck Office
Systems, ativado em modo stealth), as telas podero
ficar comprometidas na documentao emitida.
Programas residentes
Durante a instalao do GAS-Pro, programas
residentes (TSR) podem gerar conflitos, causando
erros. Caso venha a ocorrer este tipo de erro, retire os
programas residentes da memria e tente novamente a
instalao.
Desinstalao do GAS-Pro
A desinstalao ou retirada do GAS-Pro do
microcomputador pode ser efetivada com a simples
excluso dos arquivos utilizados pelo mesmo, arquivos
os quais se encontram disponveis no diretrio
GASPRO40 do equipamento.
Manual do Usuri o
60
Manual do Usuri o
61
Captulo 4: Executando o
GAS-Pro
Existem basicamente duas maneiras de se ativar o
GAS-Pro.
Ativando o GAS-Pro
Ativando em modo normal
Para ativar o GAS-Pro, basta digitar GAS, a partir da
linha de comando do DOS.
Por operar em Ambiente de Desenvolvimento
Integrado (IDE), o GAS-Pro requer uma quantidade
mnima de memria para alocao de dados de 340
KBytes, o que, na realidade, representa cerca de 560
Kbytes de memria livre, a nvel do DOS. Ao ser
ativado, o GAS-Pro far uma verificao da memria
disponvel avisando se estiver aqum do mnimo
necessrio. Ao receber esta mensagem, aconselhvel
verificar se existe na memria programas residentes
(TSR) que possam ser desalocados para fornecer ao
GAS-Pro as condies plenas de funcionamento.
Quando ativado em ambiente multi-usurio (rede
local), o GAS-Pro tem a necessidade de manter
arquivos de configurao em separado para cada
usurio da aplicao. Desta maneira, ele consegue
manter as preferncias de cada usurio sem conflitar
com os demais. Para a formao do nome dos arquivos
de configurao dos usurios, o GAS-Pro utiliza a
identificao da estao na rede. Devido diversidade
de redes e ao modo como so instaladas e
administradas, poder ocorrer o caso do GAS-Pro no
conseguir identificar o nome da estao. Se isto
acontecer, o GAS-Pro procurar em seguida uma
Manual do Usuri o
62
varivel de ambiente de nome ESTACAO. Caso esta
varivel no esteja definida, o GAS-Pro solicitar a
entrada da identificao atravs do teclado. Portanto,
se o GAS-Pro est perguntando a identificao da
estao, crie uma varivel de ambiente, atravs do
comando SET do DOS, colocando no arquivo
AUTOEXEC.BAT da estao, o seguinte comando:
SET ESTACAO=xxxx
onde xxxx o nome ou nmero, com 4 posies, que
identifica a estao. Cada estao da rede dever ter
uma identificao diferente. Desta maneira, o GAS-
Pro no mais solicitar o nome da estao.
Ativando para criar ou executar macros
O recurso das macros visa facilitar o trabalho nas
demonstraes, bem como na criao de sistemas que
sirvam de exemplo de utilizao (tutoriais). Est sendo
documentada em manual porque entendemos que este
pode ser um valioso recurso para auxiliar no
treinamento de sua utilizao nas diversas reas da
empresa.
As macros so arquivos criados para armazenar
todos os passos usados na elaborao de um projeto de
sistema, como se fosse um video-tape da operao. O
uso de macros bastante til tanto para se fazer
demonstraes quanto para treinamento de operao.
Para que o GAS-Pro utilize uma macro, basta
acion-lo conforme abaixo:
GAS [arqmacro[.ext] /opo]
onde:
arqmacro o nome do arquivo que armazena a
macro;
.ext a extenso do arquivo, sendo assumida
.MCR quando no informada;
Manual do Usuri o
63
opo pode ser a letra C para criao da
macro, a letra E para a execuo de macro
previamente criada. Existe tambm a opo A
que funciona exatamente como na opo E,
exceto pelo clculo automtico dos tempos das
mensagens da macro, ignorando o tempo que foi
especificado quando da sua criao.
Durante a criao ou execuo de macros, a tecla F1
pode ser utilizada para obter ajuda de como oper-la
corretamente.
O recurso de criao e execuo de macros no est
disponvel em ambiente multi-usurio (rede local).
Criando macros
Quando o GAS-Pro ativado para criar uma macro
pela opo /C, a operao de gerao normal,
porm todas as teclas utilizadas pelo operador so
armazenadas, de modo totalmente transparente, no
arquivo arqmacro. Se o arquivo arqmacro j
existir no disco, o operador dever confirmar a sua
substituio pela nova macro a ser criada, ou, se
preferir, concatenar ou continuar a sua gravao a
partir de determinado ponto.
Durante a criao de uma macro, os seguintes
controles esto disponveis:
F1 Apresenta ajuda de como cri-la corretamente.
ALT-F10 Apresenta uma caixa de dilogo para a entrada de texto
explicativo da operao que vai ser executada, a ser
apresentado quando a macro estiver sendo executada.
At 512 caracteres podem ser digitados para este texto.
Para forar a quebra de linhas deve-se utilizar o
caracter |.
Aps a entrada do texto, deve-se informar o tempo de
exposio do mesmo, em segundos. No momento da
apresentao da macro, esta janela ficar exposta pela
quantidade de segundos informada, a menos que uma
tecla seja pressionada antes de esgotado o tempo. Um
valor igual a 0 far com que a janela fique exposta at
que uma tecla seja pressionada.
Manual do Usuri o
64
CTRL Interrompe e finaliza a criao da macro, sem prejuzo
para a aplicao que estiver sendo criada.
Quando estiver criando uma macro, no
aconselhvel cancelar a gerao de programas fontes,
emisso de documentao, etc., pois, a mesma poder
perder a sincronia. Outro aspecto que pode afetar as
macros a utilizao do banco de campos. Quando
for necessrio capturar um campo no banco, selecione
este campo digitando o seu nome diretamente no menu
(NO UTILIZE AS SETAS). Isto evitar que outros
campos inseridos aps a criao da macro alterem a
sua sincronia.
Executando macros
Se o GAS-Pro for ativado para executar uma macro
(opo /E), todos os passos da gerao da aplicao
podero ser revistos. Durante a execuo de uma
macro, os seguintes controles esto disponveis:
F1 Apresenta ajuda.
1 a 9 Altera a velocidade de exibio (9 mais lento).
0 A exibio feita a cada tecla pressionada.
* A exibio feita sem espera (muito rpido).
ESC Cancela a apresentao da macro.
. (ponto) Cancela a apresentao da macro e permite que se
continue sua gravao a partir daquele ponto, ou seja,
permite que novos comandos sejam colocados na
macro, a partir daquele ponto.
Ao ser ativado, o GAS-Pro apresenta o seu MENU
PRINCIPAL, conforme tela da figura IV.1.
Manual do Usuri o
65
Figura IV.1
Preservando o monitor de vdeo
O utilitrio GASLEEP um programa residente
(TSR), fornecido no CD do GAS-Pro, destinado a
preservar as clulas de fsforo do monitor de vdeo
(salva tela), atravs de apresentaes grficas que se
movimentam. Pode ser utilizado tanto pelo GAS-Pro
quanto pelas aplicaes por ele geradas tendo, no
entanto, que ser carregado na memria, antes do GAS-
Pro ou do programa executvel da aplicao.
Este programa, uma vez carregado na memria, ocupa
apenas 5 Kbytes e entra em ao aps determinado
tempo de inatividade do teclado ou do mouse. Ao
entrar em ao, passa a fazer apresentaes grficas
aleatrias na tela. Um novo toque em qualquer uma das
teclas faz com que ele se recolha novamente,
esperando novo tempo de inatividade.
Para carreg-lo na memria, deve-se utilizar a seguinte
sintaxe:
GASLEEP [nome] [/Sn] [/Tm] [/E] [/D] [/?]
onde:
nome o nome a ser exibido durante a
apresentao
n o tipo de apresentao (1-6)
Manual do Usuri o
66
m a quantidade de minutos de inatividade para
executar
E executa no residente
D desaloca o GASLEEP da memria
? apresenta ajuda de como ativar
Usando a tecla F1 para obter ajuda de
operao
Durante toda a operao do GAS-Pro, a tecla F1 serve
para apresentar texto de ajuda sensitiva ao contexto da
operao que estiver sendo realizada no momento. Ao
ser pressionada, uma janela aparecer exibindo o texto
pertinente, o qual poder ser rolado e paginado
verticalmente, caso seja extenso o suficiente para no
se fixar totalmente na janela, atravs das setas cursoras
PGUP e PGDN. Atravs da tecla F3 pode-se tambm
localizar palavras ou fragmentos de texto, com
abrangncia em todo o arquivo de ajuda do GAS-Pro.
Os objetos componentes da interface do
GAS-Pro
A interface do GAS-Pro com o seu operador feita
atravs de menus, janelas, caixas de dilogo e janelas
pick. Todos esses objetos aparecem na forma de
retngulos na tela, divididos em duas partes: na parte
superior da janela, aparece sempre um ttulo, em
maisculas, relativo situao do momento; na parte
inferior, aparece a mensagem relativa ao que o
GAS-Pro espera do operador.
Manual do Usuri o
67
Menus
Os menus do GAS-Pro apresentam sempre uma barra
horizontal (em reverso) que serve para selecionar uma
das opes disponveis. Se existir mais opes do que
as que so apresentadas de uma s vez na janela do
menu, uma barra vertical criada automaticamente no
lado direito da janela para mostrar a posio relativa
da opo selecionada em relao ao total de opes
disponveis. O mouse poder ser clicado em pontos
dessa barra para provocar a rolagem de opes do
menu.
A seleo da opo desejada a partir dos menus
apresentados pode ser feita utilizando-se as setas
cursoras (cima/baixo) para movimentar a barra (em
reverso), ou ainda pressionando simplesmente as
primeiras letras da opo desejada, seguidas da tecla
ENTER. Se uma segunda letra for pressionada, a opo
que se inicie com essas duas letras ser selecionada, e
assim por diante. O mouse, se existir, poder tambm
ser utilizado sobre os menus. Um clique sobre uma das
opes move a barra de seleo para aquela opo e
um segundo clique no mesmo lugar efetiva a seleo
da opo. Os ttulos dos menus podero tambm ser
clicados para selecionar as opes que porventura
estejam anunciadas ali, como por exemplo, teclas de
funo e teclas ENTER, INS, DEL, etc.
Algumas opes podem no estar disponveis para
seleo em determinadas situaes, aparecendo, por
isso, em uma cor diferente das demais opes
(aparecem na mesma cor utilizada no ttulo da janela).
Outras opes, devido sua natureza, podem aparecer
separadas das demais por uma linha horizontal ou
espao, dependendo do tipo de moldura utilizado.
A tecla ESC ou o boto direito do mouse, tanto nos
menus quanto nos demais objetos, servem para
cancelar a situao, fazendo com que o GAS-Pro
retorne o controle para a tela anterior.
Manual do Usuri o
68
Caixas de dilogo
Alm de mensagens ao operador, as caixas de dilogo
apresentam campos onde devem ser digitadas
informaes para serem processadas pelo GAS-Pro.
Essas informaes esto sujeitas a crticas ou
validaes, segundo critrios estabelecidos para a
situao. Caso no sejam aceitas as informaes
digitadas, o operador ser avisado atravs de uma
janela de aviso.
Nas caixas de dilogo, o mouse pode ser utilizado do
seguinte modo:
a. um clique dentro do campo em digitao,
move o cursor para aquela posio;
b. um clique no boto direito, cancela a
operao (ESC);
c. um clique em qualquer outro ponto da tela,
exceto dentro do campo, tem a mesma funo da
tecla ENTER, ou seja, aceita o que estiver
digitado dentro do campo.
Janelas de avisos e erros
Os avisos e erros de operao do GAS-Pro so
apresentados em uma janela contendo informaes
explicativas ao operador, na qual este poder
pressionar a tecla ENTER, quando julgar necessrio
continuar a operao.
Janelas pick-file (pega arquivo)
As janelas pick-file (pega arquivo) so janelas de menu
conjugadas com uma caixa de dilogo. Quando o GAS-
Pro estiver solicitando ao operador, a entrada de um
nome de arquivo (em uma caixa de dilogo), o
operador poder pressionar a tecla F10 para acessar
um menu contendo os nomes dos arquivos existentes
no disco, que sejam do tipo necessrio operao. Se,
ao pressionar F10 o operador j tiver digitado algo na
caixa de dilogo, o arquivo iniciado com as letras
Manual do Usuri o
69
digitadas aparece selecionado automaticamente,
bastando que o usurio pressione ENTER para levar
este nome para o campo. Uma vez dentro da janela
pick-file, o operador pode continuar digitando letras
enquanto o GAS-Pro vai selecionando o arquivo que
atende ao que foi digitado.
Por exemplo, se foi digitada a letra R e foi
pressionada a tecla F10, o primeiro arquivo que
comece com esta letra estar selecionado. Se continuar
digitando, por exemplo, a letra E, o arquivo que
comece com RE ficar selecionado, e assim por
diante. Para levar o nome do arquivo para o campo de
digitao, basta pressionar ENTER.
Editores de texto, telas e relatrios
Dentro dos editores do GAS-Pro, o mouse poder ser
utilizado para marcar blocos, posicionar os campos ou
frmulas definidas e provocar a rolagem horizontal ou
vertical das linhas atravs das barras de rolagem.
O clipboard
Nas operaes com o editor interno do GAS-Pro (EP-
Jr), editores de tela e campos em digitao, existe a
possibilidade de gravar ou carregar texto para o
clipboard. O clipboard uma rea de memria
reservada para armazenamento e transferncia de
informaes entre as vrias fases da operao do GAS-
Pro. Para colocar uma informao no clipboard a
partir de um editor, necessrio que um bloco de texto
tenha sido marcado e a seqncia CTRL-OC seja
pressionada. A partir de um campo ou caixa de
dilogo, basta pressionar CTRL-OC, no sendo
necessria a marcao de bloco, porque este recurso s
existe dentro dos editores. Da mesma maneira, para
carregar uma informao do clipboard, basta digitar
CTRL-OR. Se estiver dentro de um dos editores do
GAS-Pro, a informao ser inserida na posio do
cursor. Se estiver dentro de campos em digitao, a
informao substituir a que estiver dentro do campo,
Manual do Usuri o
70
sendo considerada somente a primeira linha gravada
no clipboard.
Operando o GAS-Pro com mouse
Se houver um mouse conectado ao micro, o GAS-Pro
poder ser operado com a utilizao deste recurso,
conforme j explicado na descrio dos objetos de
interface do GAS-Pro. O que for aqui explicado sobre
a operao do mouse servir para qualquer parte deste
manual:
o boto direito do mouse tem a mesma funo da
tecla ESC, ou seja poder ser utilizado para cancelar
operaes e voltar telas;
o boto esquerdo serve para selecionar opes
dentro de menus, marcar blocos e arrastar campos
dentro dos editores de texto, telas e relatrios;
se o mouse possuir 3 botes, o boto do meio no
ser considerado.
a operao de arrastar e soltar objetos (drag and
drop) se constitui da seguinte seqncia: clicar o
boto esquerdo sobre o objeto e, com o boto retido,
arrastar o mouse movimentando-o at uma
determinada posio desejada e, em seguida, liberar
o boto esquerdo que estava retido.
Manual do Usuri o
71
Manual do Usuri o
72
Captulo 5: Operando o
GAS-Pro
O GAS-Pro foi concebido para ser operado mesmo por
pessoas sem experincia na rea de informtica,
podendo gerar sistemas completos na linguagem CA-
Clipper verso 5.3, 5.2 e 5.01, sem ter programado
uma nica linha sequer. As explicaes que sero
apresentadas neste captulo so completadas e
ilustradas pelo roteiro descrito no Captulo VII - Um
exemplo prtico, neste manual. Naquele captulo,
apresentada, passo a passo, a gerao de uma aplicao
exemplo. Recomendamos, o seu acompanhamento,
mesmo por pessoas com experincia, para assimilar os
recursos de gerao disponveis no GAS-Pro.
Uma aplicao gerada pelo GAS-Pro, durante a sua
concepo, denominada PROJETO DE SISTEMA.
Um projeto de sistema pode conter diversos
subsistemas para manipular arquivos DBF. Pode conter
tambm outras entidades, como por exemplo, menus,
arquivo de parmetros, relatrios, etiquetas, rotinas
avulsas, etc. A criao dessas entidades feita atravs
do mdulo modelador do GAS-Pro, de uma maneira
bastante simplificada. A estrutura hierrquica das
aplicaes geradas pelo GAS-Pro so totalmente
flexveis, isto , a colocao dos mdulos (menus,
arquivos, relatrios, rotinas, etc.) totalmente livre,
podendo ser inseridas em qualquer posio da rvore,
ou seja, o projetista tem toda a liberdade para modelar
a sua aplicao de acordo com a sua prpria tcnica e
personalidade.
Neste captulo sero descritas todas as opes
existentes nas telas do GAS-Pro, que podem ser
acionadas do seu menu principal, que aparece na
figura V.1.
Manual do Usuri o
73
Figura V.1
Durante a operao do GAS-Pro, algumas teclas tm
funo especial para auxiliar o trabalho de modelagem
e execuo do projeto. Podem ser acionadas de dentro
de campos, menus, editores, etc.
Tecla F1 Apresenta ajuda on-line, sensitiva ao contexto.
Quando operando com menus, cada opo possui texto
prprio, bastando mover a barra de seleo e
pressionar a tecla F1 para obter ajuda sobre aquele
item.
Tecla ALT-F2 Sempre que for necessrio executar operaes com o
DOS, a tecla ALT-F2 pode ser usada para executar um
shell. Enquanto estiver no ambiente do DOS, no rode
programas do tipo residente (TSR) para que o trabalho
do GAS-Pro no fique comprometido pela falta de
memria, o que poderia causar efeitos imprevisveis.
Tecla ALT-M Se estiver operando com um mouse, a tecla ALT-M
serve como hot-key para ligar e desligar rapidamente a
sua operao, independentemente do que estiver
configurado no menu de opes do mdulo de
configurao, a ser explicado mais adiante neste
captulo.
Manual do Usuri o
74
Configura
As configuraes possibilitam a adaptao do GAS-
Pro - e dos sistemas por ele criados - s caractersticas
da instalao onde ser executado, permitindo a
escolha dos esquemas de cores para os diversos tipos e
qualidades de monitores de vdeo, bem como do tipo
de impressora conectada ao micro, alm de outras
caractersticas inerentes ao prprio sistema que ser
criado.
Os parmetros de configurao so gravados em
arquivo e usados por todos os mdulos do GAS-Pro,
sendo tambm transferidos aplicao final gerada.
Esta opo NO PRECISA ser acionada a cada vez
que o GAS-Pro seja utilizado, devendo ser requisitada
somente quando se desejar mudar alguns desses
parmetros. As configuraes possveis so:
Esquema de cores
Denomina-se Esquemas de cores s combinaes das
cores utilizadas na apresentao dos diversos objetos
que aparecem nas telas do GAS-Pro. Essas
combinaes compreendem as cores de frente
(foreground), fundo (background) e, em alguns
objetos, as cores das bordas e ttulos (somente frente).
Em vdeos de padro EGA/VGA, esto disponveis 256
esquemas de cores para a seleo. Em vdeos CGA/
MONO/HERCULES, apenas 128 aparecem na janela
de seleo, conforme figura V.2.
Manual do Usuri o
75
Figura V.2
Como configurar um esquema de cores
Aps escolher o objeto que se deseja configurar,
selecione o esquema mais conveniente para a sua
apresentao, de uma das duas maneiras a seguir:
Atravs do teclado
Utilizar as setas para mover o cursor de seleo
e pressionar ENTER. As setas cima/baixo
servem para mudar a cor do fundo e as setas
direita/esquerda mudam a cor da frente. O
esquema selecionado estar sempre dentro do
cursor de seleo. Alguns objetos permitem que
suas bordas e ttulos sejam configurados atravs
de um outro cursor de seleo que aparece na
parte de baixo da janela de seleo de esquemas
de cores. Esta configurao feita movendo-se
o cursor de seleo, tambm utilizando as setas,
porm com a tecla CTRL pressionada e retida.
Atravs do mouse
Se um mouse estiver disponvel para a operao
do GAS-Pro, basta clicar diretamente sobre o
esquema desejado. Imediatamente o cursor de
seleo ser movido para aquele local. Neste
ponto, s clicar novamente dentro do cursor de
seleo para que o esquema seja aceito.Pode-se
Manual do Usuri o
76
tambm arrastar com o mouse, o cursor de
seleo at o esquema desejado e liber-o em
seguida.
Independentemente do mtodo utilizado, sempre que o
cursor de seleo movimentado, o efeito a ser obtido
mostrado imediatamente em uma janela-exemplo,
conforme pode ser observado na figura V.3.
Figura V.3
Os seguintes objetos podem ter seus prprios
esquemas de cores.
Pano de fundo Pano de fundo o esquema a ser usado para encher a
tela de fundo, combinado com o caracter escolhido
para isto, o qual pode ser selecionado a partir da opo
do menu Caracter do fundo descrito no mais adiante
neste captulo.
Para este objeto, podem ser selecionadas as cores de
frente e fundo.
Janelas As janelas so os retngulos onde aparecem as
mensagens fixas apresentadas pelo GAS-Pro, durante
a sua operao. Normalmente so superpostas por
outras janelas e menus que se tornem necessrios.
frente e fundo, bem como a cor ser utilizada nas bordas
e no ttulo (frente).
Caixas de dilogo So as janelas onde as informaes solicitadas pelo
GAS-Pro sero digitadas pelo usurio. Uma caixa de
Manual do Usuri o
77
dilogo tem sempre um ttulo, uma mensagem ao
usurio e um campo para a digitao das informaes
solicitadas.
frente e fundo, e tambm a cor de frente a ser utilizada
nas bordas e no ttulo.
Avisos e erros As janelas de avisos e erros so utilizadas pelo GAS-
Pro para apresentar mensagens ao usurio, sempre que
ocorrerem situaes imprevistas ou erros, durante a
sua operao.
frente e fundo, bem como a cor de frente a ser utilizada
Menus e campos Este o esquema de cor utilizado para os diversos
menus de onde so selecionadas as opes de operao
do GAS-Pro.
frente e fundo, e tambm a cor de frente a ser utilizada
Tela de digitao o esquema de cor utilizado nas telas de digitao de
informaes para o banco de dados, que so
formatadas durante o processo de definio do
subsistema.
frente e fundo.
Tela de digitao
no ativa
o esquema de cor empregado em telas de banco de
dados que estejam sendo exibidas, mas que, no
momento, no esto sendo utilizadas. Isto acontece
sempre que dois ou mais bancos de dados relacionados
(pai e filho) so definidos.
frente e fundo.
Tela de ajuda o esquema de cor empregado em janelas que
apresentam texto de ajuda que so apresentadas
sempre que a tecla F1 pressionada, durante a
operao do GAS-Pro ou nas janelas de ajuda de
entrada de informaes, quando a opo AJUDA
ATIVA estiver ligada.
Manual do Usuri o
78
frente, fundo e ttulo, servindo tambm de esquema de
cor default para as janelas de ajuda da aplicao final.
Expressa A opo Expressa permite uma configurao rpida
do GAS-Pro no que diz respeito a esquemas de cores.
Um menu apresentado de onde poder ser
selecionada uma das configuraes de cores pr-
programadas do GAS-Pro.
Uma vez selecionado um esquema, o GAS-Pro
assumir as cores para os diversos objetos como,
menus, caixas de dilogo, janelas, etc.
Caracter do fundo
Caracter do fundo o caracter que ser usado para
preencher a tela, por baixo das diversas janelas e
menus. Esta opo apresenta um menu de onde poder
ser selecionado um caracter a ser utilizado para encher
a tela, nas cores escolhidas atravs da opo Pano de
fundo, descrita anteriormente, neste captulo.
Selecionando o caracter do fundo
Com o auxlio das setas e da tecla ENTER (ou do
mouse, se estiver disponvel), selecione um caracter
para ser usado no preenchimento da tela de fundo do
GAS-Pro. Este caracter ser utilizado em combinao
com o esquema de cor escolhido para pano de fundo.
Fontes de caracteres
Em monitores do tipo VGA/SVGA, o GAS-Pro
oferece diversos tipos de de fontes de caracteres para
escrever nas telas. Uma vez selecionada uma fonte de
caracteres, esta ser carregada na memria RAM do
vdeo, permanecendo ativa inclusive em outras sees
de utilizao do GAS-Pro. Se a RAM de vdeo estiver
sendo utilizada pelo utilitrio VIDRAM do QEMM ou
se o projeto estiver sendo executado em modo de 50
linhas na tela, as fontes no podero ser mostradas.
Manual do Usuri o
79
Essas fontes esto contidas no arquivo VGALIB.FTS
fornecido no CD do GAS-Pro. Como as aplicaes
geradas pelo GAS-Pro podem tambm ter este recurso
quando executadas em vdeo VGA, este arquivo deve
ser enviado juntamente com o programa executvel da
aplicao para o microcomputador onde dever
executada.
Molduras
As molduras correspondem s bordas das janelas,
menus, caixas de dilogo, etc., que so apresentadas na
tela pelo GAS-Pro, e nas aplicaes por ele geradas.
Esta opo permite a escolha, atravs de menu, de um
tipo de moldura para ser usado ou ainda, a definio de
um tipo prprio, montada com os caracteres da tabela
ASCII.
Seleo da moldura desejada
Com o auxlio das setas e da tecla ENTER (ou do
mouse, se estiver disponvel), selecione a moldura
desejada e observe o seu efeito na tela.
Definio de uma moldura
Esta opo permite a criao de uma moldura para ser
utilizada na apresentao dos objetos. Pode-se definir
todos os caracteres que faro parte da moldura como,
os quatro cantos, linhas de separao e conectores.
Aps escolher a parte da moldura a ser definida,
selecione o caracter a ser utilizado para formar a parte
selecionada da moldura que est sendo definida.
Alguns caracteres de controle como os de cdigo 9, 13
e 26 no podero ser selecionados por produzirem
efeitos indesejveis quando so impressos no vdeo.
Manual do Usuri o
80
Impressora
Esta opo permite a seleo da impressora que estar
conectada ao micro onde ser executada a aplicao
final. A seleo feita atravs de um menu em cujas
opes aparecem as impressoras cadastradas que
podem ser configuradas no GAS-Pro. A impressora
que estiver aqui configurada ser a impressora default
para a aplicao final gerada. Se desejado, o GAS-Pro
poder gerar na aplicao final um mdulo de
configurao semelhante a este, bastando que esteja
configurada a sua gerao no modelador do projeto.
Atravs deste menu podem ser inseridas novas
impressoras e tambm podem ser retiradas outras. Para
inserir uma nova impressora,basta pressionar a tecla
INS e informar o nome e os controles da nova
impressora. Para retirar uma impressora do menu,
pressione a tecla DEL sobre o nome da impressora a
retirar. A tecla ENTER serve tanto para selecionar uma
impressora quanto para editar os comandos da mesma.
O nome da impressora configurada no GAS-Pro
aparece sempre no ttulo deste menu. O menu que aqui
aparece ser levado para a aplicao final, desde que o
GAS-Pro esteja configurado para gerar este mdulo.
Dentre as configuraes possveis de serem feitas para
uma impressora, figuram:
Marca da impressora
Informe neste campo a marca da impressora a ser
configurada. Lembre-se de que este nome servir para
identificar esta impressora dentro deste menu, que o
mesmo que ser levado para a aplicao final gerada,
desde que o GAS-Pro esteja configurado para gerar
este mdulo.
Porta de sada
Esta opo permite configurar a porta onde dever
estar conectada a impressora, podendo ser uma das
portas seriais ou paralelas disponveis no micro. O
GAS-Pro verificar quais as que esto disponveis e as
oferecer como opes de menu.
Manual do Usuri o
81
Cdigos de impresso
Informe os diversos cdigos solicitados Cuidados
especiais devem ser tomados com respeito aos cdigos
aqui informados. Procure inform-los corretamente,
segundo o manual, para evitar erros durante a
execuo da aplicao.
Normalmente, os manuais das impressoras apresentam
seus cdigos de recursos de impresso na linguagem
BASIC, como por exemplo: CHR$(27);E. No nosso
caso, a linguagem utilizada deve obedecer sintaxe do
CA-Clipper, que dispensa o $ e ainda substitui o ;
por +, como por exemplo, CHR(27)+'F'.
Algumas impressoras no possuem determinados
recursos. Por exemplo, a orientao landscape em
impressoras matriciais. Caso a impressora no possua
determinado recurso, responda simplesmente com
ENTER, deixando a informao em branco.
No caso de linhas por pgina, substitua o nmero que
indica a quantidade de linhas na pgina pelas letras
NNN. Mais tarde, essas letras sero substitudas
pelos nmeros correspondentes. Informe esta
configurao somente se a impressora que estiver
sendo configurada for do tipo matricial. Para as
impressoras que tratam formulrios na forma de
pginas (A4, Letter, Legal, etc.) como as do tipo Laser,
DeskJet, InkJet, etc., deixar esta informao em
branco.
Nome Empresa/Usurio
O nome da empresa ou rea usuria serve para constar
no cabealho da aplicao, de relatrios, telas de
apresentao, etc. Basta selecionar esta opo e digitar
o nome desejado.
Endentao de Programas
A endentao de programas fontes o espacejamento
em colunas utilizado para deslocar, para a direita, as
linhas de cdigos dentro de estruturas da linguagem
Manual do Usuri o
82
CA-Clipper (DO WHILE / DO CASE / IF/ELSE, etc.),
conforme mostrado na figura V.4. Este deslocamento
muito importante para facilitar a visualizao, pelo
programador, do incio e trmino dessas estruturas.
Figura V.4
Utilize as setas direita e esquerda (ou clique o mouse
sobre as setas) para mudar o valor da endentao que
poder variar de 1 a 10. O nmero escolhido para
endentao no deve ser muito grande para que as
linhas dos programas possam ser vistas integralmente
na tela, sem a necessidade de rolagem horizontal.
Ao obter o resultado desejado, pressione ENTER (ou
clique ) para aceitar a configurao, ou pressione ESC
para cancelar.
Opes
Configurao de aspectos do comportamento do GAS-
Pro, durante a sua operao, como por exemplo,
emisso de efeitos sonoros, utilizao de mouse, etc.
Essas opes aparecem sempre marcadas (ligadas) ou
desmarcadas (desligadas). Este estado pode ser
mudado pressionando-se a tecla ENTER sobre a opo
selecionada. As opes a seguir podem ter seu estado
ligado ou desligado:
Manual do Usuri o
83
Efeitos sonoros
Se ligada, o GAS-Pro emitir efeitos sonoros para
chamar a a ateno do usurio, quando se fizer
necessrio. Caso contrrio, o GAS-Pro operar em
silncio.
Utiliza mouse
Se ligada, o GAS-Pro poder ser totalmente operado
com o mouse que estiver conectado ao micro. Se
nenhum mouse tiver sido detectado pelo GAS-Pro,
esta opo estar aparecendo no menu com uma cor
diferente, no podendo ser selecionada. A tecla ALT-
M tambm pode ser usada como hot-key, em qualquer
situao de operao do GAS-Pro, para ligar e
desligar a utilizao do mouse.
Ajuda ativa
Se estiver ligada, todas as informaes solicitadas pelo
GAS-Pro sero acompanhadas de janelas contendo
texto de ajuda para orientao para a entrada correta
das respostas, bem como das teclas de funes
disponveis naquele momento.
Se estiver desligada, essas janelas no sero
apresentadas.
Durante a operao, a tecla ALT-F1 funciona como
hot-key dentro dos campos, para ativar e desativar esta
ajuda ativa.
Menus centralizados
Se estiver ligada, as opes dos diversos menus do
GAS-Pro aparecero centralizadas dentro da janela.
Caso contrrio, as opes aparecero alinhadas
esquerda.
cones na rvore
O mdulo modelador do GAS-Pro (rvore do projeto)
pode se mostrar de duas formas: com ou sem cones.
Manual do Usuri o
84
Se esta opo estiver ligada, cones sero utilizados
para representar o tipo de mdulo existente na rvore.
Se estiver desmarcada, somente linhas e setas sero
mostradas interligando e relacionando os mdulos.
Configurao expressa
A exemplo da opo Expressa explicada na
configurao de esquemas de cores, esta opo
Expressa permite uma configurao rpida do GAS-
Pro em trs aspectos de uma s vez: esquema de cores,
caracter do fundo e molduras. Um menu apresentado,
de onde poder ser selecionada uma das configuraes
pr-programadas do GAS-Pro.
Projeto
As aplicaes definidas e geradas atravs do GAS-Pro
so tratadas como PROJETO. Esta opo permite a
abertura de um novo projeto de sistema a ser definido
ou a abertura de um projeto j existente para ser
modificado e gerado novamente.
Nome do projeto
Informe um nome de arquivo para armazenar as
definies de um novo projeto ou um j existente para
ser modificado e regerado. A tecla F10 pode ser
utilizada para apresentar um menu com os nomes dos
projetos que porventura j existam no disco. O GAS-
Pro sugere sempre o nome do ltimo projeto que tenha
sido carregado.
F10 captura nome na janela
A seleo do arquivo desejado pode ser feita
utilizando-se as setas cima/baixo bem como o mouse
Manual do Usuri o
85
(se houver). Pode-se ainda selecionar os arquivos
teclando-se as letras iniciais dos seus nomes. A tecla
ENTER efetiva a seleo do arquivo ou diretrio
posicionado na barra de seleo, enquanto a tecla ESC
cancela a operao de seleo de arquivos.
possvel tambm selecionar outros diretrios alm
do que sugerido. Selecionando-se o primeiro item da
lista apresentada na solicitao do nome e diretrio do
projeto sero visualizados os arquivos do diretrio
imediatamente acima. As opes que se iniciam com
setas apontando para baixo seguidas de um nome de
arquivo, representam subdiretrios. A sua seleo
permite a visualizao e escolha dos arquivos nele
contidos.
Ao informar um nome de projeto, o GAS-Pro
solicitar algumas informaes adicionais
denominadas Dados genricos do projeto,
constituidos de:
Nome da empresa Informe o nome da empresa ou rea usuria do sistema
aplicativo que ser gerado.
Ttulo da aplicao Informe uma frase para intitular o projeto de sistema
que est sendo definido. Esta informao ser
utilizada, exatamente conforme foi digitada, para
constar nos cabealhos de programas fontes, cabealho
de relatrios e de telas apresentadas durante a
operao da aplicao final.
Nome do projetista Informe o nome do projetista do sistema aplicativo que
est sendo definido. Esta informao ser utilizada
dentro dos cabealhos dos programas fontes e nas
documentaes emitidas pelo GAS-Pro.
Cdigo da ajuda
(nmero do
contexto)
Informe um nmero para identificar um bloco de texto
de ajuda a ser escrito, para ser mostrado ao usurio
final. O nmero sugerido pelo GAS-Pro corresponde
ao bloco de texto definido no arquivo de ajuda da
aplicao final.
Dentro do texto da ajuda ativa (ALT-F1) existe tambm
o nmero default correspondente. Se desejar editar o
texto de ajuda neste momento, pressione a tecla F9 e o
GAS-Pro apresentar o seu editor interno (EP-Jr) e
tentar posicionar o cursor no incio do bloco de texto
Manual do Usuri o
86
correspondente, caso exista. Se no existir, o cursor
ficar posicionado no incio do texto.
Posteriormente essas informaes podero ser
modificadas, se necessrio.
Aps a entrada dessas informaes, o GAS-Pro
apresenta o mdulo modelador da aplicao,
representado na tela da figura V.5.
Figura V.5
Mdulo modelador do projeto
A partir deste menu, todo o projeto de sistema pode ser
modelado, inserindo-se ou apagando mdulos e
entrando com informaes sobre cada mdulo inserido.
Teclas de controle
Setas cima /
baixo Posicionam a barra reversa sobre os mdulos. Se
houver um nmero de mdulos suficientemente grande
que no possam ser todos mostrados simultaneamente
na tela, a barra em reverso provocar a rolagem dos
mdulos, para cima ou para baixo dentro do menu,
dependendo da borda em que esta estiver sendo
movimentada. Sempre que isto acontecer, uma barra de
rolagem vertical apresentada automaticamente pelo
GAS-Pro, na borda direita da janela do menu,
Manual do Usuri o
87
mostrando a posio relativa do mdulo selecionado
em relao ao total de mdulos do projeto. Se um
mouse estiver conectado e se a opo de utilizao
estiver ligada, este poder ser utilizado neste menu da
mesma maneira como utilizado nos demais menus do
GAS-Pro.
ENTER Permite a entrada ou modificao das informaes
sobre o mdulo selecionado.
ESC Retorna ao menu anterior
INS Insere novo mdulo, abaixo do mdulo em que estiver
posicionada a barra reversa.
DEL Apaga, aps confirmao, o mdulo em que estiver
posicionada a barra reversa. Observar que, se o
mdulo possuir outros mdulos subordinados, estes
tambm sero apagados. Observar tambm que, se
existirem outras definies vinculadas a este mdulo,
como arquivos .ATR, .PRG, etc., o GAS-Pro solicitar
tambm a confirmao para o seu apagamento.
F4 Esta tecla serve para mudar o modo de apresentao da
rvore do projeto - com ou sem cones. Os cones so
utilizados para facilitar a identificao do mdulo
existente na rvore. Se voc estiver usando um vdeo
padro VGA e se estiver utilizando uma fonte de
caracteres diferente da normal, esses cones podem ser
bem representativos.
F10 Esta tecla uma hot-key para ligar ou desligar a
gerao de um mdulo. uma maneira mais rpida de
configurar a gerao ou no de um mdulo, sem a
necessidade de selecionar Opes e Gerar
programas fontes atravs do menu deste mdulo.
Sempre que a gerao dos programas fontes de um
mdulo estiver ligada, o smbolo estar aparecendo
na parte mais esquerda do mdulo dentro da rvore.
Se a gerao estiver desligada, o smbolo estar
aparecendo em seu lugar.
F11 Esta tecla tem como objetivo marcar a gerao de
todos os mdulos existentes na rvore do projeto, de
uma s vez.
Manual do Usuri o
88
F12 Esta tecla tem como objetivo desmarcar a gerao de
todos os mdulos existentes na rvore do projeto, de
uma s vez.
Mudando a posio de um mdulo na rvore
Em certas ocasies, devido a redefinies, algum
mdulo precisa ter a sua posio alterada dentro da
rvore do projeto. Se o mdulo a ser reposicionado for
do tipo MENU, basta apag-lo da posio onde se
encontra (tecla DEL) e inser-lo novamente na nova
posio desejada (tecla INS) dentro da rvore do
projeto. No caso de se tratar de outros tipos de
mdulos, devido possibilidade de terem sido feitas
diversas definies para o mesmo, como telas,
atributos, relatrios, rotinas avulsas, etc, deve-se ter o
cuidado de NO APAGAR as definies existentes no
momento em que o GAS-Pro solicitar a confirmao:
DESEJA APAGAR AS DEFINIES.... Desta
maneira, quando ele for inserido na nova posio na
rvore, essas definies sero reaproveitadas
automaticamente.
Pressionando-se a tecla ENTER sobre a primeira
opo, que o ttulo do projeto, pode-se estabelecer
diversas definies para o projeto:
Dados genricos do projeto
Esta opo permite a modificao dos dados genricos
informados quando da criao do projeto.
Nome da Empresa
Ttulo da Aplicao
Nome do Projetista
Nmero do contexto relativo ao bloco de texto de
ajuda que ser apresentado ao usurio final.
Manual do Usuri o
89
Rotinas especiais (Marca/Desmarca)
Atravs desta opo, pode-se comandar a gerao das
rotinas especiais que sero incorporadas aplicao
resultante do projeto em definio. As opes que
estiverem marcadas (ligadas) sero levadas para a
aplicao e as que estiverem desmarcadas (desligadas)
no sero geradas.
Para marcar e desmarcar essas opes, basta pressionar
a tecla ENTER com a barra de seleo posicionada na
opo desejada. As rotinas especiais que podem ou no
ser geradas so:
Mquina de calcular
Se ligada, o GAS-Pro criar nos programas fontes da
aplicao final, uma rotina para apresentar uma pop-
calculadora com facilidade de captura de resultados.
Calendrio
Se esta opo estiver ligada, o GAS-Pro criar nos
programas fontes da aplicao final, uma rotina para
apresentar um calendrio para consulta de datas
passadas, presentes e futuras.
Protege arquivos DBF
Se esta opo estiver ligada, o GAS-Pro criar uma
rotina dentro da aplicao que encriptar o header ou
cabealho dos arquivos de dados (.DBF), de modo que
no possam ser acessados pelos gerenciadores de
banco de dados interativos compatveis com o dBASE.
Alm disso, o GAS-Pro trocar o atributo dos arquivos
de dados para READ ONLY (somente leitura),
impedindo que gravaes sejam feitas em seus
registros. Esta opo, juntamente com a opo GERA
PARA REDE LOCAL a ser explicada a seguir, so
mutuamente exclusivas, ou seja, os arquivos de dados
em ambiente multi-usurio (rede), no podem ser
protegidos.
Manual do Usuri o
90
Gera para rede local
Se esta opo estiver ligada, o GAS-Pro criar uma
aplicao contendo todos os controles exigidos para
operao em ambiente multi-usurio (rede local).
Todos os comandos de bloqueio de arquivos e registros
sero inseridos nos programas fontes gerados, nos
locais em que se fizerem necessrios.
Menus tipo pop-down
Se estiver ligada, o GAS-Pro criar na aplicao final,
menus do tipo pop-down. Os menus do tipo pop-down
se caracterizam por terem uma disposio de opes na
horizontal, na linha do topo da tela e, quando
selecionada uma delas, um outro menu apresentado
logo abaixo. Se esta opo estiver desligada, os menus
gerados sero sempre verticais e dispostos na parte
central da tela, superpostos em cascata.
A experincia mostrar que, se esta opo estiver
marcada, bom para a esttica que a rotina seguinte
Ttulos nos menus esteja desligada. Os ttulos nos
menus tendem a se confundir com as opes da parte
horizontal do menu pop-down.
Outro aspecto a ser levado em conta que, se esta
opo estiver ligada, as opes do menu principal
aparecero na horizontal, uma ao lado da outra.
Portanto, interessante que a identificao dessas
opes na rvore hierrquica sejam feitas em uma
nica palavra, para que uma opo no se confunda
com a outra. Veja o exemplo a seguir:
CONTAS A PAGAR CONTAS A RECEBER
RELATRIOS APOIO
Observe que as quatro opes acima se confundem
devido existncia de mais de uma palavra para
defin-las. Agora veja:
Manual do Usuri o
91
PAGAMENTOS RECEBIMENTOS RELATRIOS
APOIO
As opes acima ficaro bem definidas no menu da
aplicao!
Ttulos nos menus
Se esta opo estiver ligada, o GAS-Pro criar nos
menus da aplicao final, ttulos na sua parte superior.
Tutorial
Com esta opo, o GAS Pro criar rotinas que
permitam a criao de macros tutoriais na aplicao
final. Uma vez criadas essas rotinas na aplicao,
podero ser gravadas sees de treinamento para o
usurio final da aplicao, que poder obeservar a sua
aplicao exesutar spzinha tudo o que tenha sido
gravado.
Gera com comentrios
Se esta opo estiver ligada, os programas fontes sero
providos de comentrios linha a linha, para facilitar o
acompanhamento da sua lgica. Caso contrrio, os
programas fontes contero apenas alguns poucos
comentrios que forem considerados imprescindveis.
Data com formato sculo
Se esta opo estiver ligada, as datas apresentadas na
aplicao final tero a informao do sculo, no
formato DD/MM/AAAA, como por exemplo:
06/01/1994
Caso contrrio, as datas tero o formato DD/MM/AA,
assim:
06/01/94
Manual do Usuri o
92
Cabealho da aplicao
Se esta opo estiver ligada, uma tela inicial ou
cabealho poder ser definido para a aplicao. Nesta
tela inicial podero constar diversas informaes do
projeto, bem como outras informaes que podem ser
escritas ou desenhadas. Se esta opo estiver
desmarcada, a opo de criao deste cabealho no
poder ser selecionada. Sempre que esta opo estiver
sendo desmarcada, o GAS-Pro dar a oportunidade de
apagar o cabealho, se existir, do diretrio do projeto.
Moldura no cabealho
Se esta opo estiver ligada, a moldura do cabealho
explicado no tem anterior apresentar bordas ou
molduras. Caso contrrio, ser apresentada sem as
molduras.
Vdeo 50 linhas (VGA)
Se o micro dispor de um vdeo de padro EGA/VGA,
esta opo estar disponvel para seleo. Se estiver
ligada, o GAS-Pro criar uma aplicao que utiliza 50
linhas na tela. Caso contrrio, a aplicao utilizar
apenas as 25 linhas convencionais. Logo que esta
opo ligada, o GAS-Pro passa, por sua vez, a
funcionar em modo de 50 linhas para que as telas da
aplicao possam ser criadas nesse formato.
importante verificar se o micro onde ser executada a
aplicao possui tambm este tipo de vdeo, pois, uma
aplicao criada para rodar com vdeo de 50 linhas no
poder ser executada em 25 linhas. O posicionamento
de mensagens em linhas de nmero superior a 25
provocariam erros de execuo.
Impresso de consultas
Se esta opo estiver ligada, o GAS-Pro ir criar na
aplicao uma rotina para permitir ao usurio final
Manual do Usuri o
93
imprimir as consultas elaboradas atravs do mdulo de
consulta. Se estiver desligada, o usurio no ter a
possibilidade de emitir as consultas na impressora.
Lembre-se de que esta configurao abranger todos
os arquivos definidos no projeto.
Processamento global
Se esta opo estiver ligada, o GAS-Pro ir criar na
executar processamento global (modificao,
apagamento e recuperao agrupada de registros) na
aplicao. Se estiver desligada, o usurio no ter a
possibilidade de executar esses processamentos.
Lembre-se de que esta configurao abranger todos
Exportao de dados
Se esta opo estiver ligada o GAS-Pro ir criar na
executar a exportao de dados (formatos DBF, SDF e
delimitados) a partir das consultas definidas na
aplicao final. Se estiver desligada,o usurio no ter
a possibilidade de fazer exportao de dados. Lembre-
se de que esta configurao abranger todos os
arquivos definidos no projeto.
Proteger aplicao
Se marcada esta opo, a aplicao gerada conter
rotinas de proteo contra cpia pirata.
Pressionando-se ENTER, pode-se escolher o nvel de
proteo que ser utilizado.
Nvel 1 Maior segurana; porm, mais problemtica, pois
verifica maior nmero de detalhes do computador.
Alguns programas Windows podem alterar esses
fatores causando erros de validao;
Nvel 2 Menos seguro contra quebra, pois utiliza menor
quantidade de pontos de verificao.
Manual do Usuri o
94
Utilizar PLL
Os arquivos PLL (arquivos pr-linkados) podem ser
utilizados por diversas aplicaes que estejam sendo
executadas no mesmo equipamento ou ambiente, com a
vantagem de ganho de espao em disco devido
reduo no tamanho dos programas executveis. Para
maiores detalhes sobre arquivos PLL, consultar o
manual do CA-Clipper.
Se estiver ligada, todas as compilaes feitas atravs
do GAS-Pro ou atravs do arquivo de lote (criado
durante a gerao do programa executvel)
necessitaro dos arquivos listados no arquivo criado
CLIPGAS.PLT. No esquea, no momento de
transferir a aplicao para outros equipamentos, de
transferir tambm o arquivo CLIPGAS.PLL
juntamente com a aplicao.
Sempre que estiver sendo ligada esta opo, o GAS-
Pro poder criar automaticamente o arquivo de nome
CLIPGAS.PLL num diretrio a ser informado. Este
diretrio deve estar de acordo com o ajuste feito na
varivel de ambiente PLL, que inicializada pelo
comando SET PLL=C:\... colocado no arquivo de
nome AUTOEXEC.BAT, conforme recomendao do
CA-Clipper. Uma vez configurada esta opo, os
programas que forem compilados atravs do GAS-Pro
estaro compartilhando a biblioteca pr-linkada
CLIPGAS.PLL.
Verso do CA-Clipper
Esta opo serve para determinar qual verso do CA-
Clipper ser utilizada nos cdigos fontes gerados pelo
GAS-Pro. As opes so: verso 5.01, 5.2x ou 5.3x.
Deixar na senha
Se esta opo estiver marcada e o mdulo de senhas
for criado, o GAS-Pro criar uma rotina para fazer
com que a aplicao no possa ser abandonada
diretamente com a tecla ESC, ou seja, qualquer
operador que no tenha a senha Gerncia deixar a
Manual do Usuri o
95
aplicao parada na tela de entrada de senhas (a menos
que use explicitamente a tecla F4 para sair). O
operador que esteja utilizando a senha master (nvel 3 -
gerncia) poder abandonar normalmente a aplicao
selecionando opo por meio de um menu.
Barras de progresso
Se esta opo estiver marcada, algumas operaes
mais demoradas da aplicao, como, por exemplo,
indexao, emisso de relatrios, compactao, etc.,
sero executadas com a exibio de uma barra
percentual para monitorao do andamenteo da
operao.
Linkeditor
Esta opo permite a escolha do linkeditor a ser
utilizado na montagem da aplicao, podendo
selecionar-se o RTlink, BLinker e Exospace.
Receber data do sistema
Se esta opo estiver marcada, a aplicao ir solicitar
ao usurio a entrada de uma data, toda vez que a
aplicao for iniciada.
Compilao
Esta opo permite a escolha das seguintes formas de
compilao: Normal, Nmero de linhas e Com
debugger. A opo aqui escolhida influenciar na
construo do arquivo em lote para a compilao da
aplicao. Informaes de debugger s ser oferecida
se o linkeditor escolhido for o RTlink.
Criar arquivo de senhas
Se esta opo estiver ligada, o sistema criar
automaticamente os arquivos necessrios ao plano de
Manual do Usuri o
96
senhas da aplicao, caso no sejam encontrados no
diretrio especfico. Isto pode ser incoveniente para a
segurana da base de dados, pois basta que um usurio
apague estes arquivos para que todo o plano de senhas
seja reinicializado.
Desmarcando essa opo, poder-se- ser
proporcionada maior segurana aplicao, pois isto
exigir a existncia desses arquivos para ser
executada.
Usar driver RDD
Esta po serve para configurar o driver RDD que
dever ser utilizado na aplicao, determinando o tipo
de arquivo-ndice associado, podendo selecionar-se o
NTX, CDX, MDX e NDX.
Ajustar colunas de consultas
Se esta opo estiver marcada, as colunas das
consultas em tela paginada sero ajustadas
automaticamente, levando-se em considerao o que
for maior entre a largura do ttulo e a largura do
contedo da coluna. Caso esteja desmarcada, as
colunas sero ajustadas somente pelo tamanho do
contedo do campo.
Imp. fiscal
Esta opo serve para estabelecer a impressora fiscal
default que ser utilizada na aplicao, podendo
selecionar-se a Bematech MP20-FI e Yanco 8000-
ECF. No entanto, esta opo no determina, ainda, que
a aplicao ir trabalhar com impressoras fiscais,
estabelecendo apenas um default da impressora fiscal a
ser utilizada.
Manual do Usuri o
97
Elaborando o cabealho da aplicao
Um cabealho ou tela inicial de apresentao da
aplicao pode ser criada atravs desta opo. O
cabealho da aplicao uma rea retangular, cujo
tamanho pode ser alterado, e serve para conter tanto
informaes gerais, como data, hora, etc., quanto
informaes inerentes ao projeto e ao usurio, como
por exemplo, nome do projeto, nome da empresa,
usurio logado, observao do usurio, etc.
Movimentando e alterando o tamanho da janela
A tecla F9 permite a alterao do tamanho da janela de
edio, bem como a sua movimentao atravs do
vdeo. As teclas utilizadas so as setas cursoras
combinadas ou no com a tecla CTRL. Se estiver
operando com o mouse, basta clicar na borda da janela
e arrast-la para a posio desejada.
Inserindo e posicionando variveis do projeto
A tecla F6 permite capturar de um menu, as variveis
do projeto para mostrar na tela, como por exemplo,
ttulo do projeto, nome da empresa, data, hora, etc. As
setas cursoras servem para posicionar essas variveis
na tela. O mouse tambm pode ser utilizado para tal
fim, bastando clicar sobre um determinado campo, e
arrast-lo para a posio desejada, liberando o boto
em seguida. As variveis que aparecem assinaladas
com no menu j se encontram posicionadas na
tela.
Como retirar uma varivel j posicionada
Para remover uma varivel da tela, basta pressionar F6
e escolher a varivel que se deseja remover e
pressionar a tecla ESC. Outra maneira mais
simplificada pressionar CTRL-T sobre o qualquer
ponto de marcao da varivel na janela de edio.
Manual do Usuri o
98
Montando um cabealho padro
A tecla ALT-T permite a criao de um cabealho
padro para o sistema em definio. Todas as variveis
so dispostas na tela, podendo ser, em seguida,
colocadas em nova posio.
Como desenhar linhas e molduras
Basta pressionar a tecla F5, escolher uma das molduras
e utilizar as setas cursoras para desenh-las. A tecla F8
funciona de modo semelhante, desenhando com
qualquer grfico escolhido de um menu (tabela ASCII).
A tecla F7 permite o apagamento das molduras, como
se fosse uma borracha (desenha com o caracter
espao).
Escrevendo com letras expandidas
A tecla ALT-E serve para ativar e desativar o modo de
letras expandidas. Neste modo, os caracteres digitados
ocuparo uma altura de trs linhas e trs colunas (3 x
3), como no exemplo a seguir:
Nem todos os caracteres esto disponveis para
digitao (os minsculos, por exemplo), devido a
baixa resoluo para a criao da fonte de caracteres.
Sempre que este modo estiver ativado, a palavra Exp
estar aparecendo no canto inferior direito da tela.
Pressionando-se novamente ALT-E, o modo de letras
expandidas ser desligado, voltando a digitao
normal.
Manual do Usuri o
99
Aumentando e diminuido a largura das variveis
O caracter serve para marcar na tela a largura
informada para a varivel do projeto. Acionando-se as
teclas INS e DEL sobre esse caracter, aumenta ou
diminue a largura da varivel, desde que a varivel
seja do tipo caracter (ttulo do projeto, nome da
empresa ou rea usuria, etc).
As teclas INS e DEL acionadas fora desses dois
caracteres, tm a sua funo normal.
A tabela do Apndice B contm os comandos
disponveis para a criao do cabealho da aplicao.
Esses comandos so os mesmos utilizados na
confeco das telas de digitao dos subsistemas e na
formatao de relatrios, conforme veremos mais
adiante neste manual.
Criando variveis pblicas
Este mdulo permite a definio de variveis pblicas
para a aplicao, ou seja, aquelas que sero vista por
todos os mdulos da aplicao. Essas variveis podem
ser de qualquer tipo, inclusive vetores.
Utilize esta opo para criar variveis que contm as
tabelas internas usadas em validaes, pr-validaes,
etc., ou que sero decodificadas dentro de telas ou
relatrios. Uma vez definidas, essas podero ser
referenciadas nas informaes solicitadas pelo GAS-
Pro.
Os nomes dessas variveis no podem ser iguais aos
nomes das variveis definidas como campos nos
subsistemas ou arquivo de parmetro, caso exista.
Outro uso bastante til para esta opo a definio de
teclas hot-keys para ativar funes. Como exemplo, o
GAS-Pro gera a rotina de definio das teclas F5 e F6
para ativar o calendrio e a calculadora,
respectivamente (se configurada a sua gerao).
Seguindo esses exemplos, pode-se configurar outras
que sejam necessrias.
Manual do Usuri o
100
Dentro deste mdulo, o GAS-Pro gera tambm a
instruo SET EPOCH TO 1960, significando que
dados com datas anteriores a 1960 sero tratados pela
aplicao, como sendo do ano 2000 em diante e as
iguais ou posteriores a 1960, sero tratadas como
sendo do ano 1900 em diante. Fique vontade para
mudar de acordo com a sua necessidade e como melhor
lhe convier.
Funes complementares
Este mdulo serve para a definio, pelo analista, de
qualquer funo ou procedure que desejar escrever
para fazer parte da aplicao final. Para exemplificar,
o GAS-Pro j coloca automaticamente as funes que
executam o calendrio e calculadora na aplicao
gerada. Outras podem ser inseridas, observando-se a
sintaxe do CA-Clipper.
Uma grande utilidade deste mdulo poderia ser a
construo de uma INIT PROCEDURE do CA-Clipper
para, por exemplo, executar um mdulo de proteo
contra cpias da aplicao, ou ainda, para exibir telas
de apresentao inicial.
Editando o arquivo de ajuda ao usurio
Esta opo permite a edio de um arquivo texto para
servir de ajuda on-line para a aplicao final. Este
arquivo deve ser criado ou modificado obedecendo
algumas regras especiais:
dever comear na coluna 1 e terminar na 56 ou seja,
o texto dever ter 56 caracteres de largura.'
os smbolos \NNN (barra invertida seguida de um
nmero) no precisam estar em sequncia, sendo, no
entanto, obrigatrios. atravs deles que sero
reconhecidas as marcas de inicio e fim de bloco de
texto que dever ser mostrado.
Manual do Usuri o
101
o texto que aparece na mesma linha de \NNN no
considerado como integrante do bloco a mostrar,
podendo portanto, ser usado como comentrio.
o ltimo bloco dever obrigatoriamente ser marcado
com \00.
o nmero mximo de blocos de texto 120. Se
forem criados mais de 120 blocos, os mesmos sero
desconsiderados.
por razes de dimensionamento de memria, o
tamanho mximo do texto para ser editado a partir
do GAS-Pro de 100 Kb. Se necessitar trabalhar em
um arquivo maior, utilize um editor externo, como
por exemplo, o EP-Pro - Editor de Programas
Profissional.
Quando os programas fontes do projeto forem gerados,
este arquivo ser automaticamente preparado
(indexado) para servir de ajuda para a aplicao. Se
forem necessrias outras modificaes aps a gerao
da aplicao, este poder ser reindexado atravs da
opo Ajuda da aplicao - Indexa arquivo SOS, no
menu de utilitrios do GAS-Pro.
Para que a ajuda on-line da aplicao final funcione
corretamente, necessria a presena dos arquivos
com extenso .SOS e .INX, com o mesmo nome da
aplicao final executvel. O arquivo de extenso
.SOS contm o texto a ser apresentado ao usurio e o
de extenso .INX um arquivo ndice para auxiliar a
localizao dos blocos de texto. Ambos devem estar
presentes no mesmo diretrio do programa final
executvel (.EXE).
Descrevendo o projeto para documentao
Esta opo permite a criao do formulrio
DESCRIO DO PROJETO para fazer parte da
documentao do projeto. O editor interno do GAS-
Pro (EP-Jr) utilizado para inserir o texto descritivo,
sendo uma verso light do EP-Pro - Editor de
Manual do Usuri o
102
Programas Profissional, desenvolvido pela GAS
Infomtica Ltda. Est dimensionado para suportar
textos de at 100 Kbytes com, no mximo, 2000 linhas.
O captulo VI totalmente dedicado s instrues de
sua utilizao.
O arquivo PROJETO.PLA fornecido no CD do GAS-
Pro, que pode ser modificado para atender s
necessidades, a base de criao deste formulrio.
Atravs de variveis do GAS-Pro, informaes do
projeto em definio so inseridas automaticamente no
formulrio.
As variveis que podem ser utilizadas para inserir as
informaes do projeto, devem ser precedidas do
caracter @ e esto contidas na tabela a seguir:
Varivel Informao inserida Tam.
ANALISTA Nome do responsvel pelo projeto 30
DATA Data do sistema (atual) 8
INT_REF Integridade referencial em tabelas 30
MONITOR Placa adaptadora e monitor VGA 30
EQUI_MOUSE Mouse (recomendado) 19
PROJETO Nome do arquivo executvel (.exe) 12
PROT_DBF Cabealho do DBF criptografado 30
REDE Ambiente de rede local 22
SENHA Plano de senhas com 3 nveis 28
TIT_PROJ Ttulo do Projeto 40
USUARIO Nome da empresa ou rea usuria 47
CALCULADORA Pop-calculadora ativa 21
CALENDARIO Pop-calendrio ativo 20
REC_MOUSE Suporte a mouse 15
SECULO Datas com formato secular 25
EXPORTA Exportao de dados, em diversos formatos 40
IMPRIME Impresso de consultas 22
Manual do Usuri o
103
Exemplo: @TIT_PROJ
Se o GAS-Pro encontrar a varivel acima definida
dentro do arquivo PROJETO.PLA, substituir a
varivel a partir da posio do @ pelo ttulo do
projeto informado nas opo Dados genricos do
projeto. Se a planilha fornecida no CD do GAS-Pro
for modificada, muito importante que a disposio
das variveis considere o tamanho especificado na
coluna TAMANHO da tabela. Se a distncia entre
duas variveis dispostas em uma mesma linha for
menor do que o tamanho da primeira, a segunda ser
sobreposta e no ser considerada.
Enquanto estiver no editor, a tecla ALT-T serve para
recriar o formulrio DESCRIO DO PROJETO,
como se fosse a primeira vez.
Criando um novo mdulo na rvore do projeto
A tecla INS, quando acionada a partir do modelador,
permite a insero de novos mdulos na rvore
hierrquica do projeto. Os mdulos possveis de serem
inseridos aparecem no menu da figura V.6, de onde
podem ser selecionados.
Figura V.6
Manual do Usuri o
104
Inserindo um MENU na rvore do projeto
Esta opo permite que um menu seja inserido a partir
da posio da barra seletora, dentro da rvore do
sistema. Selecione esta opo sempre que desejar
agrupar outros mdulos a um nvel mais baixo (sub
menu), como por exemplo, tabelas, classes de
relatrios, etc.
Os seguintes dados devem ser informados ao GAS-
Pro:
Identificao do
Menu
Informe uma frase para identificar a opo que est
sendo inserida.
Se a opo de gerao de menu do tipo pop-down
estiver ligada e este for o primeiro nvel da rvore
(posio mais esquerda), lembre-se de que estas
opes iro ser colocadas no menu principal da
aplicao lado a lado (na horizontal). Por esta razo,
interessante que a identificao desta opo seja feita
em uma nica palavra, para que uma opo no se
confunda com a outra, como por exemplo:
RELATRIOS APOIO
Observe que as quatro opes acima se confundem. J
no exemplo a seguir, as opes ficam bem definidas.
APOIO
Nvel de acesso Informe o nvel mnimo que dever ter o operador da
aplicao, dentro do plano de senhas, para que tenha
acesso a este mdulo.
Condio para
menu
Informe uma condio que, se avaliada como verdade,
permitir que o usurio visualize este mdulo no
menu. Este recurso pode ser utilizado para cercear
mdulos a certos usurios em aplicaes com o plano
Manual do Usuri o
105
de senhas rodando em rede. Pode ser til tambm para
liberar mdulos em sistemas multi-empresa, que o
GAS-Pro capaz de gerar.
Cdigo da ajuda
(nmero do
contexto)
Informe o nmero para identificar um bloco de texto
ao bloco de texto definido no arquivo da ajuda da
aplicao final. Dentro do texto de ajuda ativa (ALT-
F1) existe tambm o nmero default correspondente.
Se desejar editar o texto de ajuda neste momento,
pressione a tecla F9 e o GAS-Pro apresentar o seu
editor interno (EP-Jr) e tentar posicionar o cursor no
incio do bloco de texto correspondente, caso exista.
Se no existir, o cursor ficar posicionado no incio do
texto.
Figurar no menu Informe se a referida opo aparecer na aplicao
final.
Inserir aps... Selecione a opo aps a qual dever ser inserido o
mdulo que acaba de ser criado. Esta seleo se refere
ao aspecto posicional e ser oferecida sempre que um
novo mdulo, de qualquer tipo, seja inserido na rvore.
Insero de SUBSISTEMA (DBF) na rvore do projeto
Esta opo permite que um subsistema de arquivos
seja inserido nesta posio, dentro da rvore do
sistema. A insero de um mdulo subsistema significa
que, na aplicao final gerada, um arquivo DBF ser
criado e todas as rotinas para a sua manipulao sero
agregadas ao sistema.
Ao inserir um subsistema na rvore, pode-se faz-lo
numa das 3 formas a seguir:
Manual do Usuri o
106
Definindo um novo subsistema (INS)
Selecione esta opo para entrar com as informaes
do novo subsistema, como dados genricos, ttulos e os
atributos de arquivo (campos), crticas, etc. Sempre
que um novo subsistema inserido na rvore, os seus
dados genricos precisam ser informados ao GAS-Pro.
Nome do arquivo
(DBF)
Informe o nome do arquivo DBF que conter os dados
a serem controlados por este subsistema. A tecla F10
apresenta um menu com as opes de arquivos que
podem ser carregados para dentro do projeto (arquivos
.ATR).
Ttulo para menus
e cabealhos
Informe uma frase que identifique este mdulo para
ser utilizado em cabealhos de telas. A montagem
cuidadosa desta frase facilitar a identificao do
mdulo, pelo usurio da aplicao final.
Ttulo abreviado Informe um ttulo abreviado para este mdulo, para ser
utilizado dentro de menus.Se a opo de gerao de
menu do tipo pop-down estiver ligada e este for o
primeiro nvel da rvore (posio mais esquerda),
lembre-se de que estas opes iro ser colocadas no
menu principal da aplicao lado a lado (na
horizontal). Por esta razo, interessante que a
identificao desta opo seja feita em uma nica
palavra, para que uma opo no se confunda com a
outra. Veja os exemplos abaixo:
RELATRIOS APOIO
Observe que as quatro opes acima se confundem.
Agora veja:
APOIO
As opes acima ficaro bem definidas no menu da
aplicao, no caso de menus pop-down
Manual do Usuri o
107
Cdigo da ajuda
(nmero do
contexto)
Informe o nmero para identificar um bloco de texto
ao bloco de texto definido no arquivo da ajuda da
aplicao final. Dentro do texto de ajuda ativa (ALT-
F1) existe tambm o nmero default correspondente.
Se desejar editar o texto de ajuda neste momento,
pressione a tecla F9 e o GAS-Pro apresentar o seu
editor interno (EP-Jr) e tentar posicionar o cursor no
incio do bloco de texto correspondente, caso exista.
Se no existir, o cursor ficar posicionado no incio do
texto.
Condio para
menu
permitir que o usurio visualize este mdulo no
Tecla de atalho Selecione uma combinao de teclas para acessar este
mdulo por meio do menu. Esta combinao
funcionar como hot-key para o usurio utilizar no
acesso opo de menu que ativa este mdulo. A
descrio desta combinao de teclas ser
automaticamente colocada ao lado direito da opo de
menu correspondente.
Carregando diretamente de arquivo DBF
Selecione esta opo para carregar os atributos
diretamente de um arquivo DBF existente.
Primeiramente o GAS-Pro verificar se o arquivo DBF
necessita algum tipo de adaptao (campos DATA
caracter da verso 5.x do GAS, que no mais existem
nesta verso) e far as adaptaes necessrias, aps
confirmao.
Naturalmente sero apenas carregados do arquivo DBF
os nomes dos campos, tamanhos, tipos, etc. Os demais
Manual do Usuri o
108
atributos do subsistema, como validaes, mscaras,
etc. devem ser completados mais tarde, atravs da
opo Definio de atributos, do menu de definio
do subsistema.
Lendo arquivo .ATR existente
Selecione esta opo para carregar os atributos
diretamente de um arquivo ATR que tenha sido
definido atravs do GAS Pro ou do GAS verso 5.1.
Algumas informaes adicionais sero necessrias e
podero ser feitas atravs da opo Definio de
atributos, do menu de definio do subsistema.
Escolhendo as opes do subsistema
Atravs do menu de opes do subsistema, pode-se
selecionar as informaes que devero ser
consideradas somente por este subsistema ou arquivo
DBF. Para marcar e desmarcar as opes, basta
pressionar a tecla ENTER com a barra de seleo
posicionada. As opes de subsistema so:
Gerar programas fontes
Se esta opo estiver assinalada, os programas fontes
relativos a este subsistema sero gerados normalmente.
Por outro lado, se esses programas j tiverem sido
gerados e tiverem sofrido intervenes manuais que
no devam ser perdidas, basta desligar esta opo
retirando a marcao para que o GAS-Pro, ao gerar
novamente os programas de todo o projeto, deixe de
gerar os que so relativos a este subsistema.
Caso este programa no seja encontrado no diretrio
do projeto, o GAS-Pro far a sua gerao,
independentemente de existir ou no marcao nesta
opo.
Manual do Usuri o
109
Nvel de acesso
Esta opo estar sempre marcada se a rvore do
projeto tiver na sua seo de processamento de apoio,
a opo Plano de senhas. Caso esteja marcada,
possvel estabelecer-se um nvel de acesso mnimo
(global) a ser exigido do usurio para acessar este
mdulo em definio, bastando clicar-se o mouse ou
pressionar ENTER sobre esta opo Sempre que isto
ocorrer, a opo vai se alternando para uma das opes
a seguir:
Operao
Se este nvel for selecionado, no haver nenhuma
restrio, a nvel global, para o acesso ao mdulo em
definio, uma vez que, qualquer usurio cadastrado
na aplicao final ter, pelo menos, este nvel. A
seleo do nvel Operao significa que o nvel
mnimo exigido ser o de operao.
Manuteno
Se este nvel for selecionado, os usurios cadastrados
com nvel inferior (operao) no podero acessar, em
nenhuma hiptese, este mdulo. A seleo do nvel
Manuteno significa que o nvel mnimo exigido
ser o de manuteno.
Gerncia
Se este nvel for selecionado, os usurios cadastrados
com nveis inferiores (operao e manuteno) no
podero acessar, em nenhuma hiptese, este mdulo. A
seleo do nvel Gerncia significa que o nvel
mnimo exigido o de gerncia.
Posteriormente, dentro da aplicao final, o usurio
que estiver cadastrado em nvel de Gerncia poder
fazer cerceamento mais apurado, a nvel de rotina.
Manual do Usuri o
110
Tela com moldura
Se esta opo estiver assinalada, as telas de entrada de
dados desse arquivo tero uma borda ou moldura. Caso
contrrio, aparecero sem esses atributos.
Ttulo na moldura da tela
Se esta opo estiver assinalada, a tela de entrada de
dados desse arquivo ter um ttulo sobre a borda ou
moldura da mesma. Caso contrrio, no aparecer este
ttulo.
Digitao com rolagem
Se esta opo estiver assinalada e os campos a serem
digitados neste arquivo estiverem definidos em uma
mesma linha da tela (lado a lado), o GAS-Pro criar
uma rotina de entrada de dados com rolagem, na qual
aparecero diversos registros ao mesmo tempo na tela.
Se os campos do arquivo no estiverem na mesma
linha ou se esta opo estiver desmarcada, a entrada de
dados ser normal.
Esta opo s poder ser utilizada, se o subsistema em
definio estiver no ltimo nvel, ou seja, um
subsistema que tenha um outro subsistema
subordinado (filho), no poder trabalhar com esta
opo. Verifique o exemplo a seguir:
Chave primria
Uma chave primria se caracteriza pela no existncia,
dentro do arquivo, de dois registros com contedos
iguais na expresso chave. Alguns exemplos de chave
primria so os nmeros de CPF, carteira de
identidade, CGC, matrculas, etc., que no se repetem
de pessoa para pessoa. A chave no primria, ao
Manual do Usuri o
111
contrrio, no tem qualquer restrio a respeito de
contedos de campos, podendo acontecer vrias vezes,
dentro do arquivo de dados, registros com contedos
repetidos.
Deste modo, se for escolhido o tipo de chave
primria, o GAS-Pro gerar rotinas que no
permitiro a digitao de registros com contedos
iguais para o conjunto de campos escolhidos para
chave. A cada registro digitado na aplicao gerada, o
arquivo ser pesquisado pela existncia de algum
registro com informao idntica e, caso encontrado, o
usurio ser avisado.
Se esta opo estiver assinalada, a chave deste arquivo
ser do tipo primria, caso contrrio, a chave ser no
primria.
Integridade referencial
A integridade referencial o processo segundo o qual
os registros de bases de dados inter-dependentes so
tratados de maneira especial. Basicamente, o GAS-Pro
trata de dois tipos de integridade referencial:
Integridade de arquivos subordinados (pai/filho/neto)
Podemos tomar como exemplo dois arquivos: um que
armazena dados de notas fiscais e outro que armazena
os dados dos itens constantes das notas fiscais
cadastradas no primeiro arquivo. Se o usurio da
aplicao apagar um registro de Notas Fiscais, os tens
referentes a esta nota, que se encontram armazenadas
no outro arquivo ficaro rfos, tendo que ser tambm
apagados.
Integridade de validao externa (tabelas)
A integridade de validaes pode ser exemplificada
tomando-se dois arquivos em que um deles tm seus
registros validados segundo a sua existncia no outro
arquivo. Para mostrar um exemplo clssico,
suponhamos um cadastro de empregados em que os
Manual do Usuri o
112
cdigos dos cargos sejam validados em uma tabela de
cargos. Ao ser apagado um registro da tabela,
necessrio verificar se existe algum registro de
empregado sendo validado naquele registro da tabela
de cargos. Caso exista, o usurio deve ser avisado e a
operao no poder prosseguir.
Do primeiro tipo de integridade, o GAS-Pro trata
automaticamente, colocando nos programas fontes as
rotinas necessrias. Do segundo tipo de integridade, o
GAS-Pro cuidar somente se esta opo estiver ligada.
No figurar no menu
Se esta opo estiver assinalada, este subsistema ficar
sem qualquer tipo de acesso via menu, podendo, no
entanto, serem montadas consultas, processos e
lanamentos no mesmo. A tecla F9 para visualizar
arquivos na aplicao final tambm no dar acesso ao
arquivo deste subsistema. Porm este aparecer nos
menus de reindexao e apagamento de registros
(apoio).
Pedir diretrio de trabalho
Se esta opo estiver assinalada, a aplicao final
solicitar, quando for executada pela primeira vez, um
diretrio de trabalho especficos para os arquivos DBF
e de ndice deste mdulo. Caso contrrio, o diretrio
para os arquivos deste mdulo sero os mesmo dos
demais arquivos da aplicao.
Esta opo possibilita a elaborao de sistemas
aplicativos integrados, onde arquivos podem ser
compartilhados por duas aplicaes diferentes,
residindoem direferentes diretrios.
importante que as duas aplicaes tenham o mesmo
padro de indexao do GAS-Pro 3.x para que seus
arquivos ndices possam ser acessados e mantidos
corretamente.
Manual do Usuri o
113
Abrir cupom fiscal
Se esta opo estiver assinalada, a entrada de dados
neste mdulo ser, automaticametne, direcionada
impressora fiscal. Esta opo libera a opo
Impressora fiscal no menu Definio do
subsistema.
Criar log para arquivo
Se esta opo estiver marcada, GAS-Pro gerar rotinas
na aplicao para criar e manter um arquivo de
logpara este mdulo. Esta aplicao est disponvel
apenas se a aplicao estiver sendo gerada com plano
de senhas. No arquivo de log so gravadas diversas
informaes - encriptadas - tais como nome do
usurio, tipo de transao que fez no mdulo, data,
hora e, ainda, as informaes dos campos modificados
com seus valores antes e depois das modificaes. Este
recurso permite um gerenciamento perfeito da
operao da aplicao. O contedo do arquivo de log
pode ser visto a qualquer momento na aplicao
atravs da hot-key CTRL+INS por qualquer operador
que tenha a senha master (administrador).
Criando o menu do subsistema
Esta opo permite a definio do menu de acesso ao
subsistema. Normalmente, as opes oferecidas so:
Incluso (incluso de registros)
Alterao (manuteno do arquivo)
Consulta (tela paginada)
Se necessrio, essas opes podem ser apagadas e
outras podem ser inseridas. Utilize as mesmas teclas
de controle descritas para o mdulo modelador do
projeto (INS/DEL/ENTER) para inserir, apagar ou
modificar opes, conforme necessrio. Por exemplo,
se deixar somente a opo Consulta e faz projees
este subsistema s ser acessado dentro da aplicao
atravs da tela paginada (objeto tbrowse).
Manual do Usuri o
114
Se nenhuma opo for definida para um menu de
subsistema, o GAS-Pro criar na aplicao um banco
de dados sem qualquer tipo de acesso para digitao ou
consultas. Este artifcio pode ser utilizado para criar
arquivos destinados a servirem de alvo de
processamentos e lanamentos a partir de outras bases
de dados.
Ao ser pressionada a tecla INS, as opes que se
apresentam so as que aparecem na figura V.7.
Figura V.7
Os ttulos que aparecem no menu podem ser mudados,
aps inseridos, ao ser pressionada a tecla ENTER sobre
eles.
Selecionada uma das opes, esta ser inserida no
menu do subsistema aps a opo anteriormente
selecionado.
Rotina avulsa
Uma rotina avulsa pode ser inserida a nvel do menu
do subsistema. Esta rotina pode ser criada utilizando-
se o editor interno do GAS-Pro (EP-Jr).
Manual do Usuri o
115
Comando/programa externo
Selecionada esta opo, um comando externo
aplicao pode ser inserido a nvel do menu do
subsistema.
Consulta extra
A opo de Consulta extra foi criada para permitir
que arquivos subordinados a outros (filhos) possam ser
consultados separadamente, onde sero mostrados
todos os registros existentes no arquivo,
independentemente do relacionamento existente.
Exemplo:
Os registros de itens podem ser consultados
independentemente do arquivo a que est subordinado
(NOTAS). Esta facilidade bastante til por exemplo,
para mostrar em uma s consulta, todas as sadas de
determinado item, em determinada data, no
importando a qual Nota Fiscal pertenam.
Pode-se tambm utilizar esta opo para montar
consultas a qualquer arquivo da aplicao, com a
possibilidade de escolher quais os campos que sero
nela apresentados, quais arquivos que sero
consultados, qual a ordem de apresentao, quais os
registros que faro parte (filtro) e outras definies
mais.
A montagem detalhada desta Consulta extra ser
abordada mais adiante, neste captulo, sob o tpico
Inserindo uma consulta extra na rvore do projeto.
Definio de atributos (campos)
Esta opo permite a definio da estrutura do arquivo
DBF que est sendo inserido. Alm da estrutura
(nomes de campos, tipos, tamanhos, etc.), pode-se
entrar tambm com outras especificaes, como por
exemplo, validaes, pr-validaes, texto de ajuda de
campos, etc.
Manual do Usuri o
116
A criao da estrutura do arquivo DBF feita atravs
de um menu, representado na figura V.8. As teclas de
controle so:
Figura V.8
INS Insere um novo campo na estrutura do arquivo DBF, na
posio imediatamente abaixo da barra seletora.
DEL Retira da estrutura o campo posicionado sob a barra
seletora.
F4 Muda para a definio da tela do subsistema (hot-key),
a ser vista mais adiante neste captulo.
F8 Adiciona o campo selecionado ao banco de campos
(campos frequentemente utilizados em outros
subsistemas).
ESC Retorna ao menu anterior.
Neste menu, se estiver aparecendo um asterisco * ao
lado do nome de um campo, isto significa que esse
campo tambm existe em um ou mais arquivos
relacionados (pais) aos quais o arquivo em definio
est subordinado (filho).
Nome do campo
o nome pelo qual o campo ser identificado dentro
do arquivo de dados. Poder ser informado um nome
com at 10 posies contendo letras e dgitos
Manual do Usuri o
117
numricos, devendo, no entanto, comear
obrigatoriamente com uma letra conforme exigncia
do CA-Clipper.
Se este for um subsistema de parmentro ou variveis
complementares, seria de exmia convenincia iniciar
seus nomes com um padro qualquer, como por
exmplo:
K_TAXAJURO, K_PERCDESC, K_INFLACAO
Como essas variveis sero copiadas ara variveis de
memria (pblicas) dentro da aplicao final, esta
prtica ajuda a evitar os possveis conflitos de nomes
com as variveis existentes no sistema.
A tecla F8 pode ser utilizada para capturar todos os
atributos dentro do banco de campos. Ao ser
pressionada, o GAS-Pro apresenta uma janela de menu
com os diversos campos contidos no banco. Se um
nome de campo tiver sido digitado parcialmente, o
campo que comea com a parte j digitada ser
pesquisado e ficar selecionado, bastando que o
usurio pressione ENTER. Dentro da janela do banco
de campos, pode-se selecionar os atributos para o
campo desejado, pressionando-se as letras do nome
deste campo ou utilizando-se as setas para movimentar
a barra de seleo do menu. Uma vez selecionado um
campo, seus atributos sero assumidos para o campo
em definio.
A tecla F10 est disponvel para a compatibilizao do
campo em definio com campo de outro arquivo do
projeto, com as mesmas caractersticas, ou seja, as
definies de um campo existente em outro arquivo
sero capturadas para o campo em definio, podendo
ser, em seguida, corrigidas e adaptadas.
O apndice D deste manual relaciona diversas
palavras que no podem ser utilizadas como nomes de
campos, por serem reservadas pelo GAS-Pro e CA-
Clipper.
Manual do Usuri o
118
Tamanho do campo
a quantidade de caracteres ou dgitos numricos que
o campo poder conter e que sero reservadas dentro
do arquivo para as informaes destinadas a este
campo.
No caso de definio de relatrios ou etiquetas, este
tamanho corresponde largura utilizada para efeito de
posicionamento deste contedo na tela de formatao
de relatrio, ou seja, no tem efeito sobre a quantidade
de caracteres que sero impressos no relatrio ou
etiqueta. Para se imprimir apenas parte de um
contedo, deve-se utilizar as funes SUBSTR( ),
LEFT( ), MID( ) ou RIGHT( ) do CA-Clipper.
Para o caso de definio e atributos, os tamanhos de
campos possveis so:
Tipo caracter, com at 999 posies (se o campo
no couber na tela, este ser recebido com rolagem
da informao digitada);
Tipo numrico, com at 19 posies, com 18 casas
decimais;
Tipo data, com 8 posies;
Tipo memo, com 10 posies;
Tipo imagem, com 6 posies;
Tipo lgico, com uma posio;
Tipo Cdigo de barras, com valor aproximado da
largura do cdigo de barras em caracteres. A largura
ideal a mesma quantiade de dgitos do seu
contedo, exceto no caso do CB 3/9 (3 de 9) que
deve ser 3 vezes a quantidade de dgitos do seu
contedo.
A tecla F10 pode ser utilizada para compatibilizar o
tamanho solicitado com um campo de outro arquivo do
projeto, com as mesmas caractersticas.
Manual do Usuri o
119
Tipo do campo
O tipo do campo est em funo do tipo de informao
que se deseja nele armazenar. Os tipos de campo
podem ser:
Campo do tipo caracter
Selecione este tipo, se o campo em definio est
destinado a armazenar informaes genricas, de tipo
no numrico ou data, como por exemplo, informaes
como nomes de clientes, endereos ou qualquer
informao em que todas as teclas existentes no
teclado do micro tenham a possibilidade de ser
utilizadas quando da digitao de seu contedo.
Existem campos que, apesar de terem caractersticas
numricas, no so, na realidade, campos do tipo
numrico, sendo, na realidade, do tipo caracter. Como
exemplo, temos: nmeros de telefones, CEP, nmeros
de identidades, matrculas, etc. Esses campos devem
ser definidos como do tipo caracter por no serem
campos computacionais, ou seja, no existe nenhuma
razo para se totalizar ou fazer qualquer tipo de
operao aritmtica com, por exemplo, um nmero de
telefone.
Campo do tipo numrico
Pode armazenar somente dgitos numricos. Embora
no haja nenhum impedimento, procure definir como
campo numrico, somente campos computacionais, ou
seja, aqueles campos sobre os quais sero feitos
clculos, totalizaes, acumulaes, etc., durante a
execuo da aplicao. Um nmero de matrcula, por
exemplo, apesar de conter somente dgitos numricos,
no um campo computacional, pois nunca ocorrer
sobre ele qualquer tipo de clculo. Outros exemplos de
campos no computacionais so os nmeros de
identidade, CGC, CPF, telefone, etc.
Selecione este tipo de campo se ele estiver sendo
criado para armazenar campos computacionais, como
por exemplo, idade, preo, quantidade, etc...
Manual do Usuri o
120
Nmero de decimais
Esta pergunta s feita se o tipo de campo for
numrico, devendo ser respondida com o
nmero de casas decimais que dever ter a
informao nele digitada. Por exemplo, valores
monetrios trabalham com duas casas, ndices
financeiros normalmente com 4 ou 5 casas, etc.
Campo do tipo data
Selecione este tipo de campo se a informao a ser
nele digitada se constituir de datas.
Campo tipo imagem
Selecione este tipo de campo se a informao a ser
nele selecionada se constituir de imagens em formato
PCX.
Campo do tipo lgico
Este tipo de campo muito pouco utilizado.
Normalmente, pode armazenar situaes que podem
assumir valores sim/no ou verdadeiro/falso, ou seja,
uma condio de estado qualquer.
Se este tipo de campo for definido, somente os
caracteres Y, (yes), N (no), T (true) e F (false) podero
ser digitados.
Campo do tipo memo
Este tipo de campo tambm utilizado muito
raramente. Como o seu prprio nome indica
(abreviao de MEMORANDO), este tipo de campo se
destina a armazenar texto, ou seja, informaes que
necessitam ser descritas mais detalhadamente, como
por exemplo, referncia tcnica de um produto, etc...
Este campo, apesar de consumir apenas 10 posies no
arquivo de dados (DBF), pode, na realidade, conter
Manual do Usuri o
121
mais de 64 mil caracteres, armazenados em um arquivo
paralelo de extenso .DBT criado para tal fim.
Tipo de acesso
O tipo de acesso diz respeito s condies de
visibilidade e editabilidade do campo.
Editvel
Selecione este tipo de acesso se desejar dar acesso
pleno a este campo, pelo usurio da aplicao. Este
campo poder ser digitado ou modificado vontade,
respeitando naturalmente, a expresso de validao de
seu contedo, a ser informado mais adiante.
No editvel
Selecione este tipo de acesso se desejar cercear o
acesso para digitao ou modificao deste campo. O
usurio da aplicao poder ver este campo em
consultas, porm, o cursor nunca estacionar neste
campo para digitaes ou modificaes. Um campo
com este tipo de acesso pode ser definido para servir
de alvo de processamentos externos, atravs de
frmulas definidas com campos de outros arquivos.
Invisvel
Selecione este tipo de acesso se desejar um
cerceamento total sobre este campo. O usurio da
aplicao nunca ver este campo, no tendo,
obviamente, acesso ao mesmo. Um campo com este
tipo de acesso pode ser definido para servir de
acumulador ou alvo de processamentos externos,
atravs de frmulas definidas a partir de campos de
outros arquivos.
Manual do Usuri o
122
Mscara
As mscaras ou pictures so gabaritos segundo os
quais os campos so mostrados ou recebidos na
digitao.
A seguir, alguns exemplos de mscaras:
!!! - o ponto de exclamao faz com que o caracter
digitado naquela posio seja sempre em maisculo;
@! - todos os caracteres digitados dentro do campo
sero transformados para maisculo;
99999999 - somente dgitos numricos e pontos
podero ser digitados dentro do campo. Se o campo
for do tipo caracter e essa mscara for usada, o
GAS-Pro ajustar o tamanho do campo com zeros
esquerda sempre que o contedo digitado for menor
do que a largura do campo. Por exemplo, 1 numa
largura igual a 3 resulta 001;
######## - semelhante anterior, aceitando tambm
caracteres espaos. Se o campo for do tipo
caracter e essa mscara for usada, o GAS-Pro
ajustar o tamanho do campo com espaos
esquerda sempre que o contedo digitado for menor
do que a largura do campo. Por exemplo, 1 numa
largura igual a 3 resulta 1.
@R 999-9999 - o @R na mscara faz com que
barras, pontos, hfens, vrgulas, etc., sejam
apresentados, sem a necessidade de digitao e sem
ocupar espao no arquivo de dados;
@E 9,999.99 - o @E faz com que a vrgula seja
permutada pelo ponto na separao das casas
decimais, assumindo o formato numrico brasileiro.
L ou Y - utilizada para campos do tipo lgico,
predispondo-se a mscara L em campos a serem
preenchidos com T (true) ou F (false). J a mscara
Y ser utilizada em campos a serem preenchidos
somente com Y (yes) ou N (no).
Manual do Usuri o
123
A tecla F10 pode ser utilizada para compatibilizar a
mscara solicitada com outra existente em outros
arquivos do projeto, com as mesmas caractersticas.
Largura de edio
Informe o tamanho ou largura em caracteres para
delimitar o campo na tela. Se este nmero for menor
do que o tamanho especificado para o campo, este ser
recebido com rolagem horizontal, quando o usurio da
aplicao estiver digitando informaes.
Ttulo do campo
Esta informao ser utilizada na identificao do
campo que est sendo definido nas mensagens de
validao, em ttulos de cabealhos da consultas e
ainda em menus de opes de ordenao de arquivos,
exportao de dados, etc. Se esta informao no for
fornecida, o prprio nome do campo ser utilizado
pelo GAS-Pro.
Texto de ajuda para o campo
Informe um texto para ser apresentado ao usurio da
aplicao como ajuda, assim que o cursor estacionar
neste campo para digitao de dados. At 160
caracteres podem ser digitados como ajuda de campo e
o caracter | serve para forar a quebra de linhas
dentro da janela apresentada na aplicao final.
Comando especial
Informe, se desejar, um comando ou nome de uma
rotina ou funo para ser executada toda vez que a
tecla F8 for acionada sobre este campo, dentro da
aplicao final. Lembre-se de que a tecla F9 pode ser
utilizada para a criao, neste momento, de uma rotina
em CA-Clipper (sendo necessrio algum conhecimento
da linguagem) e que as teclas F8 e F10 tambm podem
ajudar na programao do comando especial.
Manual do Usuri o
124
Alguns exemplos de utilizao desse recurso:
__KEYBOARD(BRASILIA)
Neste exemplo, toda vez que a tecla F8 for
pressionada na aplicao final, o campo atual
ser preenchido com a palavra BRASILIA.
MTAB(Solteiro|Casado|Vivo,ESTADO CIVIL)
Com este comando, toda vez que for pressionada
a tecla F8, uma tabela interna - MTAB( ) ser
apresentada ao usurio, retornando o valor
selecionado para o campo em edio.
Pr-validao
A pr-validao serve para o estabelecimento de uma
condio para que um campo seja digitado ou
modificado. Uma vez estabelecida a condio, o
campo s poder ser acessado se esta for verdadeira,
pois a condio avaliada ANTES do cursor
estacionar no campo a ser digitado.
No estabelecimento de pr-validaes mais complexas,
pode-se pressionar a tecla F9 e editar uma funo
inteira para fazer o trabalho. Evidentemente, para fazer
uso desta facilidade so necessrios conhecimentos de
programao na linguagem CA-Clipper.
Pressionando-se a tecla F9, o editor interno do GAS-
Pro invocado, criando automaticamente um arquivo
.PRG para conter a funo, que dever ser digitada. Os
nomes das funes de pr-validao so sugeridos
automaticamente pelo GAS-Pro que, deste modo,
controla o plano de denominao de mdulos do
projeto. Se desejar alterar o nome sugerido, a nica
exigncia a de que este nome termine com a
seqncia de caracteres F9( ) ou F9(lista de
parmetros) para que o editor do GAS-Pro
reconhea este nome como um arquivo a editar.
Se houver necessidade, pode ser colocado um
comentrio frente do nome do mdulo criado pelo
Manual do Usuri o
125
GAS-Pro, assim que terminar o trabalho de edio da
funo. Este comentrio, no entanto, ser vlido
somente quando indicado com duas barras seguidas ou
no estilo da linguagem C, conforme exemplos a seguir:
MAT001F9() // meu comentrio
PED004F9(par1, par2)
O GAS-Pro explora a pr-validao de 3 maneiras
distintas:
pr-validao simples do campo, informando uma
expresso, na linguagem CA-Clipper, como por
exemplo:
VAL(tipo)>2
!EMPT(matricula)
salario>1000000
apresentao de tabela interna, com captura de
informao, atravs da funo MTAB( ) contida nas
bibliotecas do GAS-Pro. A tecla F8 proporciona
uma interface rpida e amigvel para utilizar este
recurso.
apresentao de tabela externa, com captura de
contedo de campos, atravs da funo VDBF( )
tambm contida na biblioteca do GAS-Pro. Aqui
tambm, a tecla F8 auxilia na montagem da interface
para este recurso.
Se forem necessrias referncias a campos de outros
arquivos dentro da expresso de pr-validao, a tecla
F10 apresenta menus com os arquivos e campos
definidos para o projeto.
Manual do Usuri o
126
Validao
Informe, se desejar, uma expresso para validar a
informao que for digitada neste campo. Como
sugesto, o GAS-Pro coloca uma expresso que
servir para validar o campo em definio,
reconhecendo automaticamente campos que contero
unidades da Federao, CGC, CPF, etc.
Se desejar um campo sem crtica, basta pressionar ^Y,
seguido da tecla ENTER.
A tecla F7 pode ser utilizada para a montagem de
algumas expresses de validao mais comuns, atravs
de menu, conforme figura V.9.
Figura V.9
Algumas dessas funes esto contidas nas bibliotecas
do CA-Clipper e outras esto presentes em bibliotecas
do GAS-Pro.
possvel a validao de um campo segundo a sua
existncia em outro arquivo de dados atravs da
funo PTAB( ). Para este tipo de validao basta
pressionar a tecla F8 e o GAS-Pro montar, a partir de
novas informaes, a funo necessria ao
desempenho da tarefa.
A exemplo do que foi dito para a pr-validao, para o
estabelecimento de validaes mais complexas, pode-
se pressionar a tecla F9 e editar uma funo inteira
para fazer o trabalho.
Manual do Usuri o
127
Se forem necessrias referncias a campos de outros
arquivos dentro da expresso de validao, a tecla F10
apresenta menus com os arquivos e campos definidos
para o projeto.
Mensagem
Informe a mensagem que a aplicao dever apresentar
ao usurio quando a informao digitada para o campo
no atender expresso de validao. Como sugesto,
o GAS-Pro apresenta uma frase montada com o ttulo
do campo que est sendo definido. Para aceit-la, basta
pressionar a tecla ENTER. Caso no esteja adequada,
basta modific-la conforme desejado.
A mensagem de crtica pode ter mais de uma linha,
bastando que seja digitado o caracter | para separ-
las.
Ex.:
ATENO|Informao incorreta!|Deve ser E ou S
Valor inicial
Informe um valor inicial (default) para o campo em
definio. importante apresentar um valor que esteja
de acordo com o tipo do campo! Por exemplo, se o
campo for do tipo numrico, o valor inicial dever ser
um nmero; se for caracter, colocar este valor entre
aspas, etc.
Este valor ser sugerido somente durante a incluso de
registros, quando a aplicao estiver sendo executada.
A tecla F9 pode ser utilizada para a criao de funes
para retornar valores iniciais que sejam frmulas
complexas, difceis de serem definidas em uma linha.
Por exemplo, pode-se construir funes para abrir
outros arquivos e capturar informaes para compor
frmulas para iniciar o campo em definio.
A utilizao da tecla F9 requer, no entanto, algum
conhecimento da linguagem CA-Clipper.
Manual do Usuri o
128
Seqncia do campo
Se desejar que este campo assuma valores
incrementados automaticamente a cada registro
digitado, quando a aplicao final estiver sendo
executada, informe um nmero para utilizar como
incremento do campo.
Se o subsistema em definio for subordinado a um
outro (filho), o campo seqencial que for nele definido
ser reinicializado sempre que ocorrer incluso de um
novo registro no arquivo pai.
01 Pedro Silva (Registro do pai)
01 Claudia Silva
02 Daniela Silva
03 Danilo Silva
02 Antonio Soares
01 Gabriela Soares (reinicializou)
02 Mrcia Soares
No exemplo acima, se um novo filho for inserido para
o pai Pedro Silva, o novo seqencial ser 04.
Os campos do tipo numrico, data ou caracter (com
dgitos numricos) podem ser incrementados. Campos
do tipo data resultaro em uma nova data N dias aps
(sendo N o nmero informado como seqncia).
Frmulas & Campos externos
Esta opo permite a definio de frmulas ou campos
externos (de outros arquivos) para serem mostrados em
posies definidas na tela.
Ttulo
Informe uma frase para identificar esta frmula ou
campo externo dentro do menu que ser apresentado
Manual do Usuri o
129
durante a formatao da tela, quando a tecla F6 for
pressionada.
A tecla F10 aqui, faz surgir um menu com todos os
arquivos que estiverem relacionados a este, permitindo
a seleo de campos externos para serem mostrados.
Frmula
Entre com uma frmula envolvendo campos do arquivo
e/ou de outros arquivos para serem apresentados na
tela de digitao de dados. A tecla F10 aqui, faz surgir
um menu com todos os arquivos que estiverem
relacionados a este, permitindo a seleo de campos
externos que comporo as frmulas aqui descritas.
Depois, essas frmulas devero ser posicionadas,
durante a formatao da tela, atravs da tecla F6.
Caso existam vrios campos validando em um mesmo
arquivo, e um dos campos do arquivo mostrado em
diversas posies da tela, a funo PTAB( ) tem que ser
colocada explicitamente dentro da frmula a ser
mostrada, para forar a movimentao do ponteiro
dentro do aquivo externo. Por exemplo, dois campos
do tipo data validando na mesma tabela externa
(dlar), e os valores de cotao daquelas datas sendo
mostrados na tela ao lado de cada campo. Supondo-se
que o arquivo tabela de dlar se chame TBDOLAR e a
cotao se chame VALOR, teremos:
1
a
frmula:
IF(PTAB(data1,TBDOLAR),TBDOLAR-
>VALOR,)
2
a
frmula:
IF(PTAB(data2,TBDOLAR),TBDOLAR-
>VALOR,)
Com isto, teremos certeza de que os valores de cotao
mostrados ao lado de cada data estaro atualizados.
Quando se desejar forar a associao de uma frmula
a um determinado campo, pode-se usar o artifcio de
Manual do Usuri o
130
colocar um comentrio aps a frmula, contendo o
nome do campo desejado, conforme o exemplo:
Frmula:
EST_01F9() // valor
A frmula contida na funo EST_01F9() ser
mostrada aps a digitao do campo valor.
Mscara
quais as frmulas podem ser mostradas. A seguir, esto
alguns exemplos de mscaras:
naquela posio aparea sempre em maisculo;
@! - todos os caracteres do campo so apresentados
em maisculo;
apresentados, sem a necessidade de existirem
efetivamente no contedo do campo;
L ou Y - utilizada para campos do tipo lgico,
predispondo-se a mscara L em campos a serem
preenchidos com T (true) ou F (false). J a mscara
Y ser utilizada em campos a serem preenchidos
somente com Y (yes) ou N (no).
A tecla F10 pode ser utilizada para compatibilizar a
mscara solicitada com outra existente em outros
arquivos do projeto, com as mesmas caractersticas.
Manual do Usuri o
131
Largura
Informe o tamanho ou largura em caracteres para
delimitar esta frmula na tela.
Definio da tela
Esta opo permite a definio da tela para a digitao
dos dados a serem armazenados no arquivo DBF.
Diversos recursos esto disponveis para facilitar a
disposio dos campos na tela. Esses recursos so,
basicamente, os mesmos explicados para a confeco
do cabealho do projeto, neste captulo, com poucas
diferenas.
edio bem como a sua movimentao atravs do
Posicionando campos na tela
A tecla F10 permite capturar de um menu, os campos
do arquivo DBF em definio. Os campos ou frmulas
j posicionadas na tela so assinalados com nas
opes do menu. Uma vez selecionado um campo,
basta utilizar as setas ou o mouse (caso exista) para
escolher a posio mais conveniente e pressionar
ENTER. Se nas opes do subsistema estiver
selecionada a digitao com rolagem, obrigatrio que
os campos deste arquivo estejam dispostos em uma
mesma linha, juntamente com as frmulas ou campos
externos, se existirem.
Posicionando frmulas ou campos externos
A tecla F6 permite, a exemplo da tecla F10, capturar
de um menu, os campos externos ou frmulas definidas
Manual do Usuri o
132
para mostrar na tela. As marcas que aparecem na
frente das frmulas dentro do menu indicam que as
mesmas j se encontram posicionadas na tela.
As setas cursoras servem para posicionar essas
frmulas na tela. O mouse tambm pode ser utilizado
para tal fim, bastando clicar sobre um determinado
campo, e arrast-lo para a posio desejada, liberando
o boto em seguida.
Como retirar um campo ou frmula j posicionada
Para remover um campo ou frmula da tela, basta
ativar o menu com F6 ou F10, conforme o caso,
selecionar o campo ou frmula e pressionar a tecla
ESC. Outra maneira mais simplificada pressionar
CTRL-T sobre o primeiro ponto de marcao de campo
ou frmula na janela de edio.
Montando uma tela padro
A tecla ALT-T permite a criao de uma tela padro
para o sistema em definio. Todos os campos e
frmulas so dispostos na tela, podendo ser, em
seguida, reposicionadas, se necessrio.
espao).
letras expandidas, exatamente como explicado na
elaborao do cabealho do projeto, neste captulo.
Manual do Usuri o
133
estar aparecendo no canto inferior direito da tela.
expandidas ser desligado voltando a digitao
normal.
Aumentando e diminuindo a largura de campos ou frmulas
Os caracteres e servem para marcar na tela,
respectivamente, a largura disponvel para a edio do
campo ali posicionado, ou as frmulas a serem
mostradas. As teclas INS e DEL, sobre esses dois
caracteres, aumentam ou diminuem essas larguras, at
o tamanho mximo especificado, desde que os campos
ou frmulas sejam do tipo caracter. Quando se tratar de
campo de arquivo, somente a largura de edio na tela,
afetada por essas teclas. A largura ou tamanho do
campo dentro da estrutura do arquivo de dados
permanece inalterada.
A tabela do Apndice B contm os comandos
disponveis para a criao desta tela.
Dimenso da tela de consulta
Esta opo permite a definio das dimenses para a
tela de consulta (tela paginada) deste mdulo da
aplicao. Para tal, basta pressionar F9 e utilizar as
setas associadas ou no tecla CTRL para mudar as
dimenses.
Chaves de acesso
Esta opo permite a escolha dos campos que faro
parte dos conjuntos de pesquisa ou chaves de acesso ao
arquivo DBF que est sendo inserido no projeto.
Manual do Usuri o
134
Conjuntos de pesquisa
A chave de indexao se constitui de um ou mais
campos que servem para referenciar os registros
contidos no arquivo. As aplicaes geradas pelo GAS-
Pro permitem que alm do arquivo ndice bsico para
pesquisa, outros arquivos de ndices (conjuntos de
pesquisa) possam ser criados e mantidos pela
aplicao para proporcionar consultas indexadas por
outros campos.
A figura V.10 apresenta o menu de insero de
conjuntos de pesquisa. Em relacionamento de arquivos
1/N, a chave do filho composta de campos do
arquivo pai, colocados automaticamente no primeiro
conjunto de pesquisa (marcados com *). Somente
estes campos no so suficientes para a formao da
expresso chave do filho. necessrio colocar, pelo
menos, um campo do arquivo filho nesta expresso, de
maneira concatenada. Caso isto no seja feito, no
momento da gerao, o GAS-Pro enviar uma
mensagem: de que o referido subsistema est sem
chave de acesso ou o primeiro conjunto de pesquisa s
tem campos do pai.
Figura V.10
Pressione a tecla INS para inserir um novo conjunto de
pesquisa (arquivo ndice) para o subsistema. A tecla
DEL serve para apagar conjuntos j definidos e a tecla
ENTER permite proceder correes no conjunto
selecionado.
Manual do Usuri o
135
Dependendo do equipamento onde rodar a aplicao,
a criao de muitos arquivos de ndices poder
degradar a performance de execuo da aplicao, pois
esses ndices tm que ser atualizados constantemente.
Por isso, utilize mais de um conjunto de pesquisa
somente quando necessrio.
Ttulo para menu
Informe uma frase para identificar o conjunto de
pesquisa que est sendo montado. Esta frase ser
utilizada como opo do menu que ser apresentado ao
usurio da aplicao final, no momento de fazer a
escolha de qual conjunto de pesquisa ser utilizado.
A montagem cuidadosa desta frase facilitar a
identificao desta opo, pelo usurio final da
aplicao.
Campos chaves
Selecione os nomes dos campos que comporo, de
forma concatenada, as suas chaves de pesquisa e
indexao. Para anular a seleo de um campo j
marcado, basta pressionar a tecla ENTER sobre o
mesmo. A figura V.11 mostra o menu de seleo e
montagem da chave de pesquisa.
FiguraV.11
Manual do Usuri o
136
Campos que foram definidos como memo,
invisvel ou que tenham sido definidos em telas
diferentes da primeira, no podero ser selecionados
para o primeiro conjunto de pesquisa. Para os demais
conjuntos, a nica restrio com o campo memo e
invisvel.
No menu de campos, se estiver aparecendo um
asterisco * ao lado do nome de alguns campos, isto
significa que esses campos so campos de
relacionamento com os arquivos aos quais estes esto
subordinados na rvore hierrquica do projeto, sendo
parte da chave de indexao daqueles arquivos,
trazidos automaticamente para este arquivo
subordinado (filho). Neste caso, se este no for o
primeiro conjunto de pesquisa, recomendvel que
esses campos faam parte da chave na mesma ordem
em que aparecem neste menu.
Na janela intitulada CAMPOS CONCATENADOS
so apresentados os campos para compor a chave, na
ordem em que foram escolhidos.
Lanamentos
Esta opo permite a gerao de lanamentos em
outros arquivos de dados. Os lanamentos so bastante
semelhantes aos processamentos descritos no tpico a
seguir. A diferena que, no lanamento, um ou mais
registros so criados no arquivo alvo, antes de se fazer
o processamento, ou seja, o lanamento um
processamento com criao de registros, colocando-se
neles informaes de expresses obtidas a partir do
arquivo referido neste mdulo em definio e de
outros arquivos com ele relacionados.
O menu da figura V.12 representa o menu de insero
de lanamentos.
Manual do Usuri o
137
Figura V.12
Pressione a tecla INS para inserir novos lanamentos, a
tecla DEL quando desejar excluir um lanamento j
definido, a tecla ENTER para modificar os valores de
um lanamento ou a tecla ESC para finalizar.
Algumas perguntas so formuladas pelo GAS-Pro:
Arquivo alvo
Informe o nome do arquivo alvo, ou seja, o arquivo
que dever receber o lanamento quando um registro
for digitado neste arquivo que estamos definindo. A
tecla F10 invoca um menu com os nomes dos arquivos
existentes no projeto.
Quantidade de lanamentos
Informe a quantidade de lanamentos que devero ser
gerados no arquivo alvo. A quantidade aqui informada
implicar na quantidade de registros que sero criados
no arquivo alvo. Pode-se ainda usar como quantidade,
frmulas envolvendo campos de quaisquer arquivos no
momento relacionados.
Processos do arquivo alvo
Sempre que um lanamento feito, um novo registro
criado no arquivo alvo e seus campos so modificados.
Neste arquivo alvo podem ter sido definidos
processamentos para serem feitos em outros arquivos.
Manual do Usuri o
138
Selecione SIM caso queira que esses processos
sejam executados. Observe o diagrama a seguir:
Esta opo define se PROCESSO 1 e LANAMENTO
1 (ou quaisquer outros processos ou lanamentos
existentes) devem ser executados quando ocorrer o
lanamento em definio.
Cuidados especiais devem ser tomados caso a
integridade referencial tenha sido configurada neste
projeto pois, se existir uma validao em outro arquivo
(PTAB) no arquivo alvo do lanamento, ser gerado um
processo no arquivo alvo da validao. Se a opo
selecionada for NO, esse processo tambm no
ser executado.
Condio para incluso
Se for informada uma condio, o lanamento em
definio ser executado somente se essa condio
estiver atendida. Deixando esta condio em branco, o
processamento ser executado sempre.
A tecla F8 pode ser utilizada para montar uma
condio para verificar se um determinado registro
existe em um arquivo qualquer.
A tecla F10 pode ser utilizada para auxiliar na
montagem desta condio, permitindo a visualizao e
captura de campos de outros arquivos que estejam
relacionados no momento.
Para o estabelecimento de condies mais complexas,
existe o recurso da tecla F9 que ativar o editor interno
do GAS-Pro para permitir a criao de funes. A sua
utilizao, no entanto, requer algum conhecimento da
linguagem CA-Clipper.
Manual do Usuri o
139
Condio para excluso
Se for informada uma condio, o lanamento em
definio ser desfeito (excluso do registro lanado)
somente quando essa condio estiver atendida.
Deixando esta condio em branco, faz com que os
registros lanados no arquivo sempre sejam excludos.
Seleo de campos a serem lanados
Selecione os campos do arquivo alvo que devero
receber os valores a serem definidos. Basta pressionar
a tecla ENTER sobre o mesmo.
Valor a ser lanado no campo
Entre com o valor que ser colocado no campo
selecionado, logo que o lanamento for gerado. Deve-
se ter cuidado especial para definir valores que estejam
de acordo com o tipo do campo que ir receb-lo, ou
seja, campos numricos devero receber argumentos
numricos, campos do tipo caracter recebero valores
tipo caracter ou constantes entre aspas, etc. As teclas
F9 e F10 possuem as mesmas funes explicadas para
as condies do lanamento.
Se a quantidade de lanamentos for superior a 1, o
GAS-Pro criar automaticamente uma varivel
(NPARC) que indicar o nmero da parcela que est
sendo gerada no momento, e esta varivel pode ser
aqui referenciada. Em vista disso, existe a
Manual do Usuri o
140
possibilidade de usar o nmero da parcela (nparc) para
criar um frmula, como por exemplo:
DATE( )+30*nparc //calcula data de vencimento
//de cada parcela (de 30
//em 30 dias)
Em se tratando do prprio arquivo alvo do lanamento,
necessrio informar o nome do ALIAS na frente do
nome do campo, por exemplo:
ESTOQUE->valor
Em se tratando de campos sequenciais, pode-se deixar
esta informao em branco, pois estes sero
alimentados pela rotina de controle do campo
sequencial.
Processamentos
Esta opo permite a definio dos processamentos
externos para modificar campos dos arquivos referidos
neste mdulo ou de outros arquivos da aplicao.
Nesta fase, podem ser definidos por meio de frmulas,
processamentos de campos existentes neste arquivo ou
em outros arquivos do projeto que estejam de alguma
maneira relacionados com o subsistema em definio.
A figura V.12 representa o menu de insero de
processamentos.
Manual do Usuri o
141
Figura V.12
Pressione a tecla INS para inserir novos
processamentos, a tecla DEL quando desejar excluir
um processamento j definido, a tecla ENTER para
modificar os valores de um processamento ou a tecla
ESC para finalizar.
As seguintes perguntas so formuladas:
Arquivo alvo
Informe o nome do arquivo alvo do processamento a
ser definido. Em se tratando de campos de outros
arquivos relacionados, pressione F10 para capturar o
nome desse arquivo.
Campo alvo
Informe o nome do campo que dever sofrer o
processamento. A tecla F10 faz surgir um menu com
os campos que podem ser selecionados.
Condio
Se for informada uma condio, o processamento em
definio ser executado somente se essa condio
estiver atendida. Deixando esta condio em branco, o
processamento ser executado sempre.
Manual do Usuri o
142
Frmula direta
A frmula direta ser aplicada sobre o campo alvo do
processamento quando este ocorrer. Ao contrrio, a
frmula inversa, que ser definida a seguir,
executada sempre que registros do arquivo forem
apagados.
Informe uma frmula para modificar o campo que foi
informado como alvo. At 160 posies podem ser
utilizadas para definir esta frmula. Exemplo:
ARQUIVO->SALDO - VALOR
possvel tambm o estabelecimento de uma funo
para executar este processamento direto, bastando
fazer sua chamada com os devidos parmetros. Se
desejar cri-la, basta pressionar F9 para acessar o
editor. A sua criao, no entanto, requer algum
Frmula inversa
A frmula inversa ser aplicada sobre o campo alvo do
processamento, sempre que forem apagados registros
do arquivo.
Manual do Usuri o
143
Esta frmula, se informada, dever ser EXATAMENTE
a inversa da anterior, pois ser utilizada para desfazer
o processamento anterior, nos casos de apagamento de
registros. Exemplo:
ARQUIVO->SALDO + VALOR
Durante a digitao da frmula inversa, pode-se
pressionar a tecla F10 para trazer para o campo a
frmula direta definida anteriormente, para ser
modificada. Isto poder facilitar a construo da
frmula inversa.
A exemplo da frmula direta, possvel tambm o
estabelecimento de uma funo atravs da tecla F9
para executar o processamento inverso.
Condies especiais
Esta opo permite a definio de algumas condies
especiais que afetaro o comportamento da aplicao
final, no que diz respeito manunteo do arquivo
DBF (incluso, alterao e excluso). Essas condies
podem ser bastante teis quando no se deseja permitir
a manuteno em registros que tenham sofrido algum
tipo de processo e que no possam mais ser
modificados. Outro exemplo seria a no digitao em
um arquivo de parcelamento de pagamentos (filho), se
a venda foi feita vista.
A condio para abandonar a incluso pode ser
bastante til quando se deseja, por exemplo, evitar que
o usurio abandone a digitao em um arquivo filho
antes que um determinado total tenha sido igualado no
pai por meio de processamentos (totalizao de
itens).
Dentro desta opo, podem ser definidas as mensagens
a serem mostradas ao usurio da aplicao final, caso
essas condies no tenham sido atendidas. No caso
de digitao em arquivo subordinado (filho), a
mensagem de incluso s ser mostrada se o usurio
tentar incluir diretamente no arquivo filho. No caso
Manual do Usuri o
144
da digitao ter sido feita a partir do arquivo pai,
essa mensagem no ser exibida. At 100 caracteres
podem ser digitados como mensagem ao usurio e o
carecter |serve para forar a quebra de linhas dentro
da janela apresentada na aplicao final.
A tecla F8 pode ser usada para montar uma condio
para verificar se um determinado registro existe em um
arquivo qualquer.
utilizao no entanto, requer algum conhecimento da
Emitir relatrio aps a incluso
Esta opo permite a escolha de um ou mais relatrios
definidos no projeto para serem emitidos sempre que
um novo registro includo no arquivo (ou modificado
atravs de uma tela complementar). Esta opo muito
til para a emisso de uma Nota Fiscal, Pedido de
Compra, etc.
Observar que relatrios impressos durante a incluso
de registros no so os mesmos definidos para a tela
complementar, ou seja, escolha relatrios em ambos os
mdulos.
A figura V.14 representa o menu de insero de
relatrios. Pressione a tecla INS para inserir um novo
relatrio, a tecla DEL quando desejar excluir um
relatrio, a tecla ENTER para alterar o que foi
informado para este relatrio.
Manual do Usuri o
145
FiguraV.14
A seguintes perguntas so formuladas:
Relatrio
Entre com o nome do programa do relatrio que ser
invocado logo aps a incluso de um registro. Aperte
F10 para ver e capturar os relatrios que manipulam o
arquivo DBF alvo da incluso que acabou de ser feita.
Ttulo impresso
Entre com a frase que ser apresentada ao usrio final
no momento da emisso dos relatrios definidos para
serem emitidos aps a incluso de um registro no
arquivo DBF.
Condio
Informe uma expresso que estabelea uma condio
para que este relatrio seja impresso aps a incluso de
um registro. A tecla F9 poder ser acionada para a
edio de funes que estabeleam condies mais
complexas. J a tecla F10 possibilitar a captura de
campo de outro arquivos, desde que estejam
relacionados
Recebe variveis
Quando um relatrio definido atravs do GAS-Pro,
pode-se estabelecer uma tela para que o usurio da
Manual do Usuri o
146
aplicao entre com algumas informaes a serem
usadas na emisso. Se desejar que esta tela seja
apresentada ao usurio na Emisso aps incluso,
selecione SIM. Observar que, se o relatrio for
emitido normalmente atravs da opo de menu, esta
tela, quando existir, sempre ser apresentada.
Impressora fiscal
Esta opo permite a entrada de informaes
referentes impressora fiscal, como, por exemplo,
dados dos itens, forma de pagamento e mensagem
promocional.
Dados dos itens
Esta opo permite a entrada de informaes
referentes aos itens de produtos ou servios a serem
impressos na impressora fiscal.
Cdigo do item
Informe o nome do campo relativo ao cdigo do item a
ser impresso pela impressora fiscal. Esta informao
pode ser o nome de campo ou funo que retorne uma
expresso para ser utilizada como cdigo. Para editar
esta funo, pode-se utilizar a tecla F9 e ativar o editor
interno do GAS-Pro. A tecla F10 permitir a captura
de nomes de campos.
Descrio do item
Informe o nome do campo relativo descrio do item
a ser impresso pela impressora fiscal. Assim como o
cdigo do item, esta informao pode ser um nome de
campo ou funo que retorne uma expresso para que
seja utilizada como descrio do produto ou servio.
esta informao ser truncada em 29 caracteres para as
impressoras Bematech MP20FI e em 30 caracteres
para as impressoras Yanco 8000-ECF.
Manual do Usuri o
147
Natureza operao
Informe o nome do campo relativo natureza da
operao do item a ser impresso pela impressora fiscal.
Esta informao pode ser um nome ou funo que
retorne uma expresso que seja 1 ou 2 (para venda e
servio, respectivamente), podendo ser do tipo
caracter ou numrico. Assim como o cdigo do item,
pode-se utilizar a tecla F9 e F10 para suas devidas
finalidades.
Incidncia alquota
Informe o nome do campo relativo ao tipo de
incidncia ou situao tributria do item a ser impresso
pela impressora fiscal. Esta informao pode ser um
nome de campo ou funo que retorne uma expresso
que seja 1 para Incide, 2 para Isento, 3 para
Substituio e 4 para No incdncia, podendo ser do
tipo caracter ou numrico. Assim como o cdigo do
item, pode-se utilizar a tecla F9 e F10 para suas
devidas finalidades.
Valor da alquota
Informe o nome do campo relativo ao valor da alquota
que ser aplicada ao item a ser impresso pela
impressora fiscal. Esta informao pode ser um nome
de campo ou funo que retorne uma expresso que
represente um valor. Esta espresso pode ser do tipo
caracter ou numrico (ser tratado antes de ser enviado
impressora). Assim como o cdigo do item, pode-se
utilizar a tecla F9 e F10 para suas devidas finalidades.
As impressoras exigem que, antes que uma alquota
seja utilizada, esteja previamente cadastrada na
mesma. Caso contrrio, um erro ocorrer durante a
impresso desse item.
Quantidade
Informe o nome do campo relativo quantidade de
unidades do item a ser impresso pela impressora fiscal.
Esta informao pode ser um nome de campo,
Manual do Usuri o
148
expresso ou funo que retorne um valor maior que
zero e menor que 10000, podendo ter at duas casas
decimais, devendo-se ser do tipo numrico. Assim
como o cdigo do item, pode-se utilizar a tecla F9 e
F10 para suas devidas finalidades.
Valor unitrio
Informe o nome do campo relativo ao preo unitrio do
item a ser impresso pela impressora fiscal. Esta
informao pode ser um nome de campo, expresso ou
funo que retorne um valor numrico com at trs
casas decimeis. Assim como o cdigo do item, pode-se
Forma de pagamento
Esta opo deine os dados da forma de pagamento a
serem impressos no cupom fiscal.
Descrio
Informe o nome do campo relativo descrio da
forma de pagametno a ser aplicado no cupom fiscal.
Por exemplo, um cupom fiscal de 100 reais pode ser
pao da seguinte forma:
Carto - 50 reais
Cheque - 33 reais
Dinheiro - 12 reias
Ticket - 5 reais
Aps ter sido executada a impresso da primeira forma
de pagamento, o cupom ser finalizado e nenum item
poder mais ser vendido ou cancelado neste cupom.
Se a soma dos valores ds ormas de pagamento for
maior ou igual ao valor total do cupom,
automaticamente, o cupom fechado e, se for o caso,
ser impresso o valor do troco.
Manual do Usuri o
149
Esta informao pode ser um nome de campo,
expresso ou funo que retorne um valor de 15
caracteres para as impressoras Yanco 8000-ECF ou de
at 16 caracteres para as impressoras Bematech
MP20FI. Assim como o cdigo do item no tpico
anterior, pode-se utilizar a tecla F9 e F10 para suas
devidas finalidades.
Valor pagamento
Informe o nome do campo relativo ao valor da forma
de pagamento. Esta informao pode ser um nome de
campo ou funo que retorne uma expresso numrica
qualquer, podendo ter at duas casas decimais. Assim
como o cdigo do item no tpico anterior, pode-se
Mensagem promocional
Esta opo permite a entrada da mensagem
promocional para os cupons fiscais.
Mensagem
Informe o nome do campo relativo mensagem
promocional, a qual ser impressa ao final da imisso
do cupom fiscal. Esta informao pode ser um nome de
campo ou funo que retorne uma expresso do tipo
caractere de tamanho igual a:
492 caracteres para impressoras Bematech MP20FI,
podendo conter caracteres de controle para quebras
de linhas (CR+LF);
168 caracteres para impressoras Yanco 8000-ECF,
havendo uma quebra automtica de linha a cada 42
caracteres.
Assim como o cdigo do item explanado
anteriormente, pode-se utilizar a tecla F9 e F10 para
suas devidas finalidades.
Manual do Usuri o
150
Descrio do subsistema
DESCRIO DO SUBSISTEMA para fazer parte da
documentao do projeto. O arquivo DBF.PLA
fornecido no CD do GAS-Pro, que pode ser
modificado para atender s necessidades, a base de
criao deste formulrio. Atravs de variveis do
GAS-Pro, informaes do projeto em definio so
inseridas automaticamente no formulrio.
As variveis que podem ser utilizadas para inserir as
informaes do projeto, devem ser precedidas do
caracter @ e esto contidas nas tabelas a seguir:
Varivel Informao inserida Tam.
ANALISTA Nome do responsvel pelo projeto 30
CALCULADORA Pop-calculadora ativa 21
CALENDARIO Pop-calendrio ativo 20
DATA Data do sistema (atual) 8
DBF Nome do arquivo DBF 12
EQUI_MOUSE Mouse (recomendado) 19
INT_REF Integridade referencial em tabelas 30
MONITOR Placa adaptadora e monitor VGA 30
PROJETO Nome do arquivo executvel (.exe) 12
PROT_DBF Cabealho do DBF criptografado 30
REC_MOUSE Suporte a mouse 15
REDE Ambiente de rede local 22
SECULO Datas com formato secular 25
SENHA Plano de senhas com 3 nveis 28
TIT_DBF Ttulo do subsistema 38
TIT_PROJ Ttulo do Projeto 40
USUARIO Nome da empresa ou rea usuria 47
Manual do Usuri o
151
Exemplo: @TIT_PROJ
Se o GAS-Pro encontrar a varivel acima
definida dentro do arquivo DBF.PLA,
substituir a partir da posio do @ pelo ttulo
do projeto informado na opo Dados
genricos do subsistema. Se a planilha
fornecida no CD do GAS-Pro for modificada,
muito importante que a disposio das variveis
considere o tamanho especificado na coluna
TAMANHO da tabela. Se a distncia entre
duas variveis dispostas em uma mesma linha
for menor do que o tamanho da primeira, a
segunda ser sobreposta e no ser considerada.
Enqunto no editor, a combinao ALT-T permite
a recriao do formulrio, como se fosse a
primeira vez.
Descrevendo o subsistema (EP-Jr)
O EP-Jr uma verso light do EP-Pro - Editor de
Programas Profissional, tambm desenvolvido e
comercializado pela GAS Informtica Ltda. Est
dimensionado para suportar textos de at 100 Kbytes
com, no mximo, 3000 linhas. O captulo VI
totalmente dedicado s instrues de sua utilizao.
Formulrios de entrada de dados
Esta opo cria (caso ainda no exista) uma matriz de
formulrio para entrada de dados no arquivo do
subsistema em definio. No caso dessa matriz j
existir, o GAS-Pro a colocar dentro do editor para ser
modificada, se houver necessidade.
A combinao ALT-T permite a recriao do
formulrio, como se fosse a primeira vez. Esta opo
bastante til quando, aps o formulrio ter sido criado,
a estrutura do arquivo de dados tenha sido modificada.
Neste caso, o GAS-Pro recriar o formulrio com a
estrutura atualizada.
Manual do Usuri o
152
Desenhando o formulrio de entrada de dados (EP-Jr)
O captulo VI totalmente dedicado s instrues da
utilizao do editor interno do GAS-Pro (EP-Jr).
Inserindo uma TELA COMPLEMENTAR na rvore
do projeto
Esta opo permite a criao de mdulos dentro do
projeto que possibilitam a manuteno de arquivos
DBF atravs de outras telas, diferentes daquela
definida originalmente para a entrada de dados. Para
criar uma tela complementar, necessrio que um
nome de arquivo (subsistema) j definido no projeto
seja informado.
Utilize esta opo quando sentir a necessidade de criar,
em um ponto qualquer da aplicao, um mdulo que
venha a modificar apenas alguns campos de um
determinado arquivo, como por exemplo, registrar o
recebimento ou pagamento de contas, recebimento de
mercadorias, etc.
Note que esta opo NO CRIA novos registros dentro
do banco de dados, servindo apenas para o acesso a
determinados campos do mesmo.
Atravs de tela complementar no possvel alterar os
atributos j definidos para este arquivo (subsistema).
Caso haja essa necessidade, isto deve ser feito a partir
do mdulo (subsistema) escolhido para receber a tela
complementar.
Quaisquer definies de valores iniciais (default) ou
de seqncias (incremento automtico) que existirem
no arquivo principal, sero ignorados na tela
complementar.
Dados genricos
Esta opo permite a alterao das informaes
genricas deste mdulo, como por exemplo, o nome do
arquivo .DBF que conter os seus dados, ttulos para
cabealho e abreviado.
Manual do Usuri o
153
Nome do arquivo de atributros (.ATR)
Informe o nome do arquivo (.ATR) que conter os
dados a serem definidos para esta tela complementar.
A tecla F10 apresenta um menu com os nomes dos
arquivos .ATR j definidos no projeto.
Nome do arquivo DBF
Informe o nome do arquivo DBF que contem os dados
a serem manipulados pela tela complementar que est
sendo criada. Este nome tem que representar um
arquivo DBF j definido anteriormente no projeto e
que tenha, obrigatoriamente, chave do tipo primria. A
tecla F10 apresenta um menu com as opes de todos
Ttulo cabealhos
ser utilizada em cabealhos de telas. A montagem
mdulo, pelo usurio final da aplicao.
Ttulo abreviado
Informe um ttulo abreviado para este mdulo, para ser
utilizado dentro de menus. Se a opo de gerao de
menu do tipo pop-down estiver ligada e este for o
primeiro nvel da rvore (posio mais esquerda),
lembre-se de que estas opes iro ser colocadas no
menu principal da aplicao lado a lado (na
horizontal). Por esta razo, interessante que a
identificao desta opo seja feita em uma nica
palavra, para que uma opo no se confunda com a
outra, conforme j explicado na insero de item
Inserindo um menu na rvore do projeto, neste
captulo.
Manual do Usuri o
154
Cdigo da ajuda (Nmero do contexto)
aplicao final.
Opes da tela complementar
Permite a seleo de informaes que devero ser
consideradas somente por este mdulo de tela
complementar. Para marcar e desmarcar as opes,
basta pressionar a tecla ENTER com a barra de seleo
posicionada. As opes de tela complementar so
praticamente as mesmas de mdulos de subsistemas:
relativos a esta tela complementar sero gerados
normalmente. Por outro lado, se esses programas j
tiverem sido gerados e tiverem sofrido intervenes
manuais que no devam ser perdidas, basta desligar
esta opo retirando a marcao para que o GAS-Pro,
ao gerar novamente os programas de todo o projeto,
deixe de gerar os que so relativos a esta tela
complementar.
opo.
Manual do Usuri o
155
Nvel de acesso
projeto contiver na sua seo de processamento de
apoio, a opo Plano de Senhas. Caso esteja
marcada, possvel estabelecer um nvel de acesso
mnimo (global) a ser exigido do usurio para acessar
esta tela complementar em definio. Os nveis de
acesso que podem ser estabelecidos so os mesmos
existentes para mdulos do tipo subsistema, explicados
anteriormente neste captulo.
Tela com moldura
Se esta opo estiver assinalada, as telas de entrada de
dados desse arquivo tero uma borda ou moldura. Caso
contrrio, aparecero sem esses atributos.
Ttulo na moldura da tela
Se esta opo estiver assinalada, a tela de entrada de
dados desse arquivo ou tela complementar que estiver
sendo definida, ter um ttulo sobre a borda ou
moldura da mesma. Caso contrrio, no aparecer este
ttulo.
Digitao com rolagem
Se esta opo estiver assinalada e os campos a serem
digitados neste arquivo estiverem definidos em uma
mesma linha da tela (lado a lado), o GAS-Pro criar
uma rotina de entrada de dados com rolagem, na qual
aparecero diversos registros ao mesmo tempo na tela.
Se os campos do arquivo no estiverem na mesma
linha ou se esta opo estiver desmarcada, a entrada de
dados ser normal.
Processos do arquivo origem
Se esta opo estiver marcada, o GAS-Pro criar
rotina para forar a execuo de processamentos que
porventura tenham sido definidos a partir do arquivo
Manual do Usuri o
156
manipulado pela tela complementar. Caso esteja
desmarcada, os processamentos no sero executados.
Muitas vezes, uma tela complementar criada apenas
para a entrada de uma ou duas informaes em um
determinado arquivo, no havendo interesse na
execuo de processamentos externos definidos neste
arquivo. Use esta opo para ligar ou desligar a
execuo desses processamentos. Veja o diagrama
abaixo:
Esta opo define se PROCESSO 1 e LANAMENTO
1 (ou quaisquer outros processos ou lanamentos
existentes) devem ser executados quando ocorrer
digitao na tela complementar em definio.
Criar log para arquivo
Esta opo possui as mesmas peculiaridades dos
mdulos de subsistemas, visto anteriomente nesse
captulo.
Os tpicos referentes s frmulas & campos externos,
definio da tela, emisso de relatrio aps incluso e
formulrio de entrada de dados seguem a mesma
metodologia daqueles condizentes aos subsistemas.
Inserindo uma CONSULTA EXTRA na rvore do
projeto
Esta opo permite a criao dentro da aplicao final
de um mdulo de consulta a um ou mais arquivos
relacionados. Nesta consulta, diversos aspectos podem
Manual do Usuri o
157
ser definidos como por exemplo, quais arquivos e
campos constaro na mesma, qual a ordem de
apresentao, quais os registros que faro parte
(filtro), e outras definies mais.
Dados genricos
Esta opo permite a alterao das informaes
genricas deste mdulo.
Nome do programa
Informe o nome do programa que ser criado para
executar a consulta extra em definio, no sendo
necessrio a digitao da extenso (.PRG), que o GAS-
Pro colocar automaticamente. A tecla F10 apresenta
um menu com os nomes das consultas j definidas no
projeto.
Arquivo principal
Informe o nome do arquivo DBF que contem os dados
a serem manipulados pela consulta extra que est
sendo criada. Este nome tem que representar um
arquivo DBF j definido anteriormente no projeto. A
tecla F10 apresenta um menu com os arquivos
definidos.
Ttulo para menu
ser utilizada nos menus da aplicao. A montagem
mdulo, pelo usurio final da aplicao.
Cdigo da Ajuda (Nmero do Contexto)
aplicao final.
Manual do Usuri o
158
Condio para menu
Aplica-se mesma finalidade do tpico Condio para
Menu do mdulo Menu j visto anteriormente.
Tecla de atalho
Aplica-se mesma finalidade do tpico Tecla de
Atalho do mdulo Subsistema j visto anteriormente.
Opes da consulta extra
Permite a seleo de informaes que devero ser
consideradas somente por este mdulo. Para marcar e
desmarcar as opes, basta pressionar a tecla ENTER
com a barra de seleo posicionada. As opes de
consulta extra so idnticas s de mdulos de
subsistemas:
relativos a este mdulo sero gerados normalmente.
Por outro lado, se esses programas j tiverem sido
gerados e tiverem sofrido intervenes manuais que
no devam ser perdidas, basta desligar esta opo
retirando a marcao para que o GAS-Pro, ao gerar
novamente os programas de todo o projeto, deixe de
gerar os que so relativos a esta consulta extra.
opo.
Manual do Usuri o
159
Nvel de acesso
projeto tiver na sua seo de processamento de apoio,
a opo Plano de Senhas. Caso esteja marcada,
possvel estabelecer um nvel de acesso mnimo
(global) a ser exigido do usurio para acessar esta
consulta extra em definio. Os nveis de acesso que
podem ser estabelecidos so os mesmos existentes para
mdulos do tipo subsistema, explicados anteriormente
neste captulo.
Variveis complementares
Esta opo serve para definir um grupo de variveis a
serem definidas em tela, para serem recebidas a partir
de digitao do usurio, antes da execuo deste
mdulo. As seguintes perguntas devero ser
respondidas:
Dados genricos
Esta opo serve para a definio do ttulo que
aparecer no topo da tela, centralizado (ttulo na
moldura), caso configurado (em opes). Esta opo
serve tambm para a entrada do cdigo de ajuda
(nmero do contexto) para a ajuda online da
aplicao final.
Opes
Serve para definir se a janela que receber essas
variveis conter molduras, e se esta ter ttulo.
Definio de atributos
Esta opo permite a definio dos atributos das
variveis a serem recebidas, como por exemplo, nome,
tamanho, tipo, validaes, valor inicial etc. A entrada
desses atributos idntica entrada de atributos
(campos) de arquivos, conforme explicado no tpico
Manual do Usuri o
160
Inserindo um subsistema (DBF) na rvore do projeto -
definio de atributos.
Frmulas & campos externos
externos (de outros arquivos) para serem mostradas em
posies definidas na tela. Este processo idntico ao
que foi explicado no tpico Inserindo um subsistema
(DBF) na rvore do projeto - frmulas & campos
externos.
Definio da tela
Esta opo permite a definio de uma tela para a
digitao das variveis em definio. Diversos
recursos esto disponveis para facilitar a disposio
das variveis na tela, os quais, j foram detalhados no
tpico Inserindo um subsistema (DBF) na rvore do
projeto - definio da tela.
Relacionamentos
Embora um arquivo de dados (DBF) tenha sido
escolhido como base deste mdulo, diversos outros
podem ser utilizados atravs de relacionamentos
estabelecidos por esta opo. Uma vez estabelecido um
relacionamento de um arquivo com outro, os campos
desses arquivos podem ser utilizados de maneira
transparente dentro da consulta extra, como se fossem
provenientes de um s arquivo. Os procedimentos para
se estabelecer um relacionamento entre arquivos ser
detalhado mais adiante, neste captulo, sob o tpico
Inserindo um relatrio na rvore do projeto -
relacionamentos.
Definio dos contedos
Esta opo permite a definio dos contedos das
colunas que sero consultadas (browse) na aplicao
final. So permitidos diversos tipos de contedos,
como por exemplo campos do arquivo base ou de
Manual do Usuri o
161
outros arquivos, constantes, etc. Para cada contedo
definido, devero ser respondidas as seguintes
perguntas:
Ttulo
Informe um ttulo para ser impresso no cabealho da
tela de consulta.
A tecla F7 permite trazer as variveis complementares
que porventura tiverem sido definidas no mdulo.
A tecla F10 pode tambm ser utilizada para montar
automaticamente um conteudo a imprimir a partir de
campos de arquivos que tenham sido relacionados
(opo RELACIONAMENTO), campos do prprio
arquivo principal (arquivo base do mdulo).
Contedo
Estabelea o contedo da informao que figurar no
contedo da coluna da consulta.
A tecla F9 pode ser utilizada para criar uma funo
que retorne um valor para ser usado como contedo a
ser apresentado por este mdulo. A sua utilizao no
entanto, requer algum conhecimento da linguagem CA-
Clipper.
que porventura tiverem sido definidas no mdulo, para
servirem de contedo a ser consultado.
A tecla F10 tambm pode ser acionada para auxili-lo
a utilizar campos de outros arquivos como contedo
desta consulta extra.
Mscara
quais os contedos so mostrados na tela. Para maiores
detalhes sobre os tipos de mscaras, reporte-se ao
tpico Inserindo um subsistema na rvore do projeto -
definio de atributos - mscaras, neste captulo.
Manual do Usuri o
162
Tamanho
Informe o tamanho deste contedo, para efeito de
clculo da largura total da janela de consulta.
Ordem inicial
Se desejar, estabelea uma ordem sob a qual os
registros devero ser utilizados por esta consulta extra.
A tecla F10 pode ser acionada para ajud-lo a utilizar
campos dos arquivos relacionados ao arquivo base do
mdulo
importante observar que, a ordem aqui estabelecida
no definitiva, sendo apenas uma ordenao a ser
assumida. O GAS-Pro ir gerar rotinas dentro do
programa fonte do mdulo que permitir ao usurio
final da aplicao escolher outras ordenaes para
serem utilizadas.
Filtragem inicial
Se desejar, estabelea uma filtragem ou critrio de
seleo de registros a serem mostrados nesta consulta
extra.
A tecla F10 pode ser acionada para ajud-lo a utilizar
campos dos arquivos relacionados ao arquivo base
para a montagem do critrio de seleo de registros.
importante observar que, a filtragem aqui
estabelecida no definitiva, sendo apenas uma
filtragem a ser assumida. O GAS-Pro ir gerar rotinas
dentro do programa fonte da consulta extra que
permitir ao usurio final da aplicao escolher outros
critrios de seleo de registros.
Manual do Usuri o
163
Lanamentos
Para maiores detalhes sobre a finalidade e utilizao
dos lanamentos, reporte-se ao tpico Inserindo um
subsistema na rvore do projeto - Lanamentos, neste
captulo.
Processamentos
dos processamentos, reporte-se ao tpico Inserindo
um subsistema na rvore do projeto - Processamentos,
neste captulo.
Condies especiais
Esta opo permite a definio de condio que afetar
o comportamento da aplicao final, no que diz
respeito marcao de registros nas consultas.
Por meio desse recurso da consulta extra, pode-se
informar uma condio para que os registros que a
atendam apaream em cores diferentes nas referidas
consultas paginadas.
das condies especiais, reporte-se ao tpico
Inserindo um subsistema na rvore do projeto -
Condies especiais, neste captulo.
Dimenso da tela de consulta
do dimensionamento da tela de consulta, reporte-se ao
tpico Inserindo um subsistema na rvore do projeto -
Dimenso da tela de consulta, neste captulo.
Inserindo uma ROTINA AVULSA na rvore do
projeto
Esta opo permite que uma rotina avulsa seja inserida
nesta posio, dentro da rvore do projeto. Ao ser
Manual do Usuri o
164
selecionada, o editor interno do GAS-Pro (EP-Jr)
invocado para a edio da rotina. O captulo VI
totalmente dedicado operao do editor EP-Jr.
Algumas perguntas devero ser respondidas:
Nome da rotina (arquivo)
Informe o nome do programa ou rotina que ser criada
ou carregada para dentro do editor. Este nome de
arquivo ter obrigatoriamente a extenso .PRG. A
tecla F10 pode ser utilizada para apresentar um menu
(pick_list) com os programas que podem ser
carregados no editor.
Ttulo para menu
Entre com uma frase para identificar, dentro do menu,
a ativao da rotina avulsa cujo nome acabou de ser
informado. A montagem cuidadosa desta frase
facilitar a identificao desta opo, pelo usurio
final da aplicao.
Nvel de acesso
Informe o nvel mnimo que dever ter o operador da
aplicao, dentro do plano e senhas, para que tenha
acesso rotina em questo. Os nveis de acesso que
podem ser estabelecidos so os mesmos existentes para
mdulos do tipo subsistema, explicados anteriormente
neste captulo.
Cdigo da ajuda (Nmero do Contexto)
aplicao final.
Manual do Usuri o
165
Insero de COMANDO ou PROGRAMA EXTERNO
na rvore do projeto
Esta opo permite a ativao de um comando ou
programa executvel, a partir de um determinado
ponto na rvore do projeto. Algumas perguntas devem
ser respondidas:
Nome do comando ou programa externo
Informe o nome do programa ou comando externo que
ser ativado por esta opo. Este nome dever se
constituir de um comando do DOS ou de um programa
executvel qualquer, que tenha extenso .EXE, .COM
ou .BAT. No necessrio colocar a palavra RUN ou !
antes do referido comando ou programa externo, pois
tais parmetros sero inseridos automaticamente pelo
GAS Pro.
Identificao dentro do menu
Entre com uma frase para identificar, dentro do menu,
a ativao do comando ou programa externo acima. A
montagem cuidadosa desta frase facilitar a
aplicao.
Nvel de acesso
Informe o nvel mnimo que dever ter o operador da
aplicao, dentro do plano e senhas, para que tenha
acesso ao comando ou programa externo em questo.
Manual do Usuri o
166
Os nveis de acesso que podem ser estabelecidos so
os mesmos existentes para mdulos do tipo
subsistema, explicados anteriormente neste captulo.
Inserindo um RELATRIO na rvore do projeto
Esta opo permite a insero de um relatrio nesta
posio, dentro da rvore do sistema. O relatrio
definido pelo mdulo formatador de relatrios do
GAS-Pro.
Dados genricos
Nome do programa
Informe o nome do programa que conter o cdigo
fonte na linguagem CA-Clipper que ir conter este
relatrio. Embora este nome seja de livre escolha,
lembre-se de que, se desejar manter compatibilidade
com a codificao padro dos mdulos gerados pelo
GAS-Pro, este nome dever obedecer seguinte regra:
Arquivo principal
Entre com o nome do arquivo cujos campos sero
utilizados para a composio bsica das informaes
emitidas. Embora possam ser utilizadas informaes
de campos de diversos arquivos, o nome de arquivo
aqui informado ser o bsico, a ser acessado
seqencialmente, a partir do primeiro registro.
Manual do Usuri o
167
Ttulo para menu
Entre com uma frase para constar do menu que ativar
este relatrio. A montagem cuidadosa desta frase
facilita a identificao desta opo, pelo usurio final
da aplicao.
Ttulos processos
Informe uma frase para ser utilizada na mensagem de
confirmao ao usurio, para executar ou no os
processos, lanamentos ou apagamento de registros
que porventura venham a serem feitos a partir desse
relatrio.
Cdigo da ajuda (nmero do contexto)
aplicao final.
Condio para menu
Tecla de atalho
Manual do Usuri o
168
Opes do relatrio
Entrada das opes que afetaro diretamente o formato
do relatrio, como por exemplo, tamanho da pgina,
margem esquerda, quantidade de linhas por pgina,
margens, linhas de cabealho e rodap, etc.
Gerar programa fonte
A exemplo do que foi explicado para os mdulos de
subsistema e tela complementar, esta opo permite a
preservao de cdigo fonte modificado manualmente,
evitando que o GAS-Pro gere e grave um novo
programa sobre um j existente. Se esta opo estiver
assinalada, o programa relativo a este relatrio ser
gerado normalmente. Por outro lado, se este programa
fonte j tiver sido gerado e sofrido intervenes
manuais que no devam ser perdidas, basta desligar
esta opo retirando a marcao para que o GAS-Pro,
ao gerar novamente os programas de todo o projeto,
deixe de gerar este programa de relatrio, preservando
assim as modificaes feitas.
opo.
Nvel de acesso
apoio, a opo Plano de Senhas. O estabelecimento
de nvel de acesso global ao relatrio obedece s
mesmas regras descritas para os mdulos de
subsistema e tela complementar, j explicados neste
captulo.
Exclui registro listado
Caso esta opo esteja marcada, todos os registros
listados no relatrio sero excludos. Este processo de
excluso executado ao final da listagem, aps uma
Manual do Usuri o
169
confirmao do usurio. Se estiver desmarcado, isto
no ocorrer.
No figurar no menu
Aplica-se mesma finalidade do tpico No figurar no
menu do mdulo Subsistema j visto anteriormente.
No figurar no menu
Se assinalada essa opo, o relatrio no ter controle
de pgina, podendo ser utilizadas bobinas de papel
para imprim-lo. Este recurso importante para
sistemas que necessitem emitir pedidos ou oramentos
em pontos de venda (PDV).
Alguns aspectos devem ser observados:
Um relatrio no dever ultrapassar 32 mil linhas
impressas;
Os processos Saltar pgina...no incio e fim do
relatrio devem ser desmarcados;
Caso necessitar-se algumas linhas em branco entre
um relatrio e outro (para rasgar), utilizar as linhas
de rodap do relatrio, deixando-as em branco ou
colocando uma linha tracejada, conforme desejado.
Executar processos/lanamentos antes
Se marcada, os processos e lanamentos de finidos no
relatrio sero executados antes que o relatrio seja
emitido. Caso contrrio, esses processos e lanamentos
sero executados somente aps o complemento da
emisso. Marcar esta opo pode ser til quando se
deseja fazer algum resumo ou totalizao para ser
impresso, inclusive em cabealhos dos relatrios.
Manual do Usuri o
170
Tamanho da pgina
Corresponde quantidade de linhas que podem ser
impressas em uma pgina do formulrio a ser
utilizado. Esta configurao est diretamente
relacionada com a densidade vertical (quantidade de
linhas por polegada) configurada na opo Aspecto
do menu Definio do relatrio, a ser explicado mais
adiante. Se desejar mudar esta configurao, basta
pressionar ENTER e informar o novo nmero.
Margem esquerda
Corresponde quantidade de espaos que sero
colocados na frente de cada linha impressa do relatrio
(tabulao). Se desejar mudar este valor, basta
Linhas de cabealho
a quantidade de linhas que sero consideradas como
cabealho do relatrio a ser formatado. Durante a
definio do layout do relatrio, as primeiras linhas
(quantidade aqui especificada) sero consideradas
como cabealho. Se desejar alterar este nmero,
pressione ENTER e informe a nova quantidade.
Linhas de rodap
a quantidade de linhas que sero consideradas como
rodap do relatrio a ser formatado, ou seja, so as
linhas que sero impressas ao final de cada folha. Se
desejar alterar este nmero, pressione ENTER e
informe a nova quantidade.
Esta opo pode ser utilizada para definir a ltima
linha de impresso dos registros no relatrio (final da
pgina). Um nmero igual a 0 far com que os
registros sejam impressos at a linha especificada na
opo Tamanho da pgina. Qualquer outro valor
informado forar a impresso de registros em 'N`
linhas antes do Tamanho da pgina.
Manual do Usuri o
171
Aspecto do relatrio
Entrada das informaes que afetaro o aspecto final
do relatrio, como por exemplo, se ter espacejamento
duplo, se dever ser utilizada a densidade de 8 linhas/
polegada, se ser impresso em caracteres
comprimidos, etc. Essas opes so consideradas
flags, ou seja, podero ser ligadas ou desligadas. As
opes assinaladas com sero assumidas como
ligadas, sendo respeitadas pelo GAS-Pro, no momento
da gerao do relatrio.
Essas opes podem ser ligadas e desligadas com o
auxlio da tela ENTER.
Quantificar registros
Se esta opo estiver assinalada, os registros sero
contados a cada impresso, aparecendo ao final de
cada quebra e ao final do relatrio uma mensagem
contendo a quantidade de registros listados. Se esta
opo estiver desmarcada, esta mensagem no ser
impressa.
Usar espacejamento duplo
Se esta opo estiver assinalada, haver uma linha
extra separando cada registro impresso no relatrio. Se
estiver desmarcada, o espacejamento ser normal, ou
seja, no haver linha em branco entre um e outro
registro impresso.
Esta opo mutuamente exclusiva com a opo de
Um registro por pgina, a ser explicado mais
adiante.
Saltar pgina no incio
Se esta opo estiver assinalada, antes do relatrio
comear a ser impresso haver um salto para o topo da
pgina seguinte. Caso esteja desmarcada, este salto
no ocorrer.
Manual do Usuri o
172
Saltar pgina ao final
Se esta opo estiver assinalada, quando o relatrio
terminar de ser impresso, um salto para o topo da
prxima folha ocorrer automaticamente. Caso esteja
desmarcada, este salto no ocorrer.
8 linhas por polegadas
Se esta opo estiver assinalada, a densidade de
impresso deste relatrio ser de 8 linhas/polegada
(cabendo 88 linhas impressas em uma folha normal de
11 polegadas). Caso no esteja assinalada esta opo, a
densidade normal de 6 linhas/polegada ser utilizada.
Esta opo est diretamente relacionada com o que
estiver configurado para Tamanho da pgina no
menu anterior, Opes do relatrio.
Um registro por pgina
Se esta opo estiver assinalada, somente um registro
do arquivo de dados ser impresso em cada pgina,
sendo bastante til para a formatao de relatrios full-
page como fichas de empregados, contratos, etc. Se
estiver desmarcada, a impresso ser normal, isto
diversos registros sero impressos e o salto de pgina
ocorrer de acordo com o controle do contador de
linhas dentro do programa.
Esta opo mutuamente exclusiva com a opo de
Usar espacejamento duplo, j explicado neste
captulo.
Compresso em 12 cpp
Se esta opo estiver assinalada, o relatrio ser
impresso em caracteres elite (12 caracteres por
polegada).
Compresso em 17,5 cpp
impresso em caracteres comprimidos (17,5 caracteres
por polegada).
Manual do Usuri o
173
Em impressoras HP-Laser/DeskJet a taxa de
compresso , normalmente, de 16,75 cpp.
Compresso em 20 cpp
impresso em caracteres comprimidos (20 caracteres
por polegada).
Teste de posicionamento
Se esta opo estiver assinalada, o GAS-Pro criar no
programa fonte deste relatrio uma rotina para
imprimir teste de posicionamento, aps confirmao
do usurio, antes de cada impresso. Esta opo til
para a impresso de dados em formulrios pr-
impressos, como por, exemplo, contratos ou fichas.
Esta rotina s estar selecionvel se a opo Um
registro por pgina estiver assinalada.
Pausa para troca de papel
Se esta opo estiver assinalada, o GAS-Pro criar no
programa fonte deste relatrio uma rotina para pausar
a emisso do relatrio aps cada folha impressa,
permitindo a colocao de nova folha na impressora.
Este recurso utilizado quando se deseja imprimir o
relatrio em folhas soltas.
Orientao landscape
Normalmente, as impressoras matriciais no possuem
o recurso de orientao do formulrio para landscape
(paisagem), que se constitui na impresso do relatrio
no sentido horizontal do formulrio (a 90 graus).
Se esta opo estiver marcada, a impresso ser feita
no sentido landscape. Caso contrrio, a impresso se
dar no no sentido normal (portrait ou retrato).
Manual do Usuri o
174
Enfatizaes
Esta opo permite a marcao das variveis de
sistema a serem impressas no relatrio em atributo
negrito. Essas variveis de sistema so normalmente
impressas no cabealho do relatrio, como por
exemplo, nome da empresa, ttulo do sistema, pgina,
datas, etc. As variveis assinaladas sero impressas em
atributo negrito
.
Esta opo serve para definir um grupo de variveis
para serem posicionadas em tela e recebidas a partir de
digitao do usurio, antes da execuo deste mdulo.
As seguintes perguntas devero ser respondidas:
Dados genricos das variveis complementares
(nmero do contexto) para a ajuda on-line da aplicao
final.
Opes das variveis complementares
variveis conter molduras e se esta ter ttulo.
Definio de atributos das variveis complementares
Manual do Usuri o
175
Frmulas & campos externos das variveis complementares
externos.
Definio da tela das variveis complementares
Relacionamentos
escolhido como base do relatrio, diversos outros
transparente dentro do relatrio, como se fossem
provenientes de um s arquivo.
Seleo do arquivo a relacionar
O menu representado na figura V.15 permite o
estabelecimento dos relacionamentos dos arquivos
DBF de onde sero extradas as informaes a serem
impressas. Uma vez relacionados dois arquivos, os
campos de ambos podem ser utilizados para novos
relacionamentos com outros arquivos, e assim por
diante.
Manual do Usuri o
176
Figura V.15
Para iniciar o estabelecimento de um relacionamento,
selecione um dos arquivos presentes neste menu.
Seleo de campos do arquivo a relacionar
Selecione um ou mais campos do arquivo base do
relatrio que sero utilizados para o relacionamento
com o arquivo que acabou de ser escolhido. O campo
ou campos escolhidos devero ter as mesmas
caractersticas dos campos que compem a chave de
indexao do arquivo que acabou de ser escolhido. O
GAS-Pro far uma verificao e mostrar mensagem
de aviso caso os campos sejam incompatveis.
Quando terminar de escolher o campo (ou campos),
pressione a tecla ESC.
Insero de novos relacionamentos
A manipulao dos relacionamentos pode ser feita
atravs do menu representado pela figura V.16.
relacionamentos, a tecla DEL quando desejar excluir
um relacionamento j estabelecido, a tecla ENTER
para modificar um relacionamento existente ou a tecla
ESC para finalizar os relacionamentos.
Manual do Usuri o
177
Figura V.16
Esta opo permite a definio do contedo do
relatrio, ou seja, o estabelecimento das informaes
que devero ser impressas nas colunas ou nas posies
a serem escolhidas. O GAS-Pro permite diversos tipos
de contedos para relatrios, como por exemplo,
frmulas, campos do arquivo base ou de outros
arquivos, constantes, etc.
Definir cada um dos contedos
Selecione esta opo se desejar definir os contedos
do relatrio em elaborao. Neste caso, os contedos
sero definidos um a um, atravs da tecla INS, a partir
de campos do arquivo principal ou de outros arquivos
relacionados.
Usar campos do arquivo principal
Selecione esta opo se desejar encher os contedos do
relatrio em definio com os campos e atributos do
arquivo definido como principal. uma boa idia
quando a maioria dos contedos a serem definidos
sero retirados deste arquivo. Posteriormente, atravs
da tecla DEL, pode-se retirar alguns deles e inserir
outros, de outros arquivos, atravs da tecla INS.
Manual do Usuri o
178
Todos os campos do arquivo sero colocados nos
contedos do relatrio, exceto aqueles no editveis ou
invisveis. Os campos do tipo numrico sero
assinalados para serem totalizados. Esta situao, no
entanto, poder ser alterada durante a definio.
Insero de contedos
Atravs do menu representado na figura V.17, pode-se
inserir ou apagar contedos do relatrio.
Figura V.17
As seguintes teclas esto disponveis neste menu:
INS insere e define um novo contedo para o relatrio, na
posio imediatamente abaixo da barra seletora
DEL retira um contedo que tenha sido definido
anteriormente
F4 muda para a janela de definio do relatrio (hot-key)
ESC encerra definio de atributos
Para cada novo contedo definido, algumas perguntas
devem ser respondidas ao GAS-Pro:
Ttulo do contedo
Informe um ttulo para a informao que ser
designada para ser impressa no relatrio.
Manual do Usuri o
179
que porventura tiverem sido definidas neste mdulo.
A tecla F8 pode ser utilizada para montar
automaticamente um contedo para imprimir, a partir
de campos de outros arquivos a serem abertos pela
funo PTAB( ).
automaticamente um contedo a imprimir a partir de
(opo Relacionamentos), campos do prprio
arquivo principal (arquivo base do relatrio) ou de
arquivos abertos por contedos j estabelecidos
atravs da funo PTAB( ).
Contedo
Estabelea o contedo da informao a ser impressa. A
tecla F9 pode ser utilizada para criar uma funo que
retorne um valor para ser usado como contedo do
relatrio. A sua utilizao no entanto, requer algum
a utilizar campos de outros arquivos como contedo do
relatrio
.
Mscara
quais os campos so mostrados. Se estiver definindo a
mscara para um contedo de tipo numrico a ser
totalizado, informe a mscara com tamanho maior do
que o normal, de modo que possa conter o valor do
total, que pode ser bem maior do que um valor
individual de cada contedo.
A seguir esto alguns exemplos de mscaras:
mostrado naquela posio seja sempre em
maisculo;
Manual do Usuri o
180
@! - todos os caracteres existentes dentro do campo
apresentados, sem a necessidade de existirem no
arquivo de dados;
L ou Y - utilizada para campos do tipo lgico, se
utilizada a mscara L, o campo s poder ser
preenchido com T (true) ou F (false). Se utilizada a
mscara Y, o campo ser preenchido somente com
Y (yes) ou N (no).
Tamanho ou largura do contedo
Corresponde largura utilizada para efeito de
do relatrio. No tem efeito sobre a quantidade de
caracteres que sero impressos no relatrio. Para se
imprimir apenas parte de um contedo, deve-se utilizar
as funes SUBSTR( ), LEFT( ), MID( ) ou RIGHT( )
do CA-Clipper.
Tipo de contedo
Selecione o tipo de contedo, caracter, numrico, data,
lgico, memo ou cdigo de barras (CB EAN-13, CB
EAN-8, CB 3/9, CB 2/5-int ou CB UPC-A), de acordo
com o dado que ser impresso no relatrio.
Varivel para armazenar o contedo
Informe, se desejar, um nome de varivel para
armazenar o contedo que acabou de ser definido.
Mais tarde, ao definir novos contedos para este
relatrio, esta varvel poder ser utilizada sempre que
for necessrio usar esta mesma informao.
Manual do Usuri o
181
Exemplo:
Contedo 1: (desconto)
4,00+5,00+6,00 (armazena em MinhaVar)
Prximo contedo: (salrio liq)
100,00 - MinhaVar
Condio de impresso
Entre com uma expresso que defina uma condio
para que este contedo seja impresso no relatrio. Uma
vez informada uma condio, o campo s aparecer
impresso se esta for atendida. Se no informada, ser
sempre impresso.
A tecla F8 pode ser utilizada para estabelecer condio
segundo existncia em outro arquivo do projeto.
A tecla F9 pode ser utilizada para invocar o editor
interno do GAS-Pro para a criao de uma funo que
retorne um valor lgico para ser testado como
condio.
A tecla F10 pode auxiliar a montagem da condio de
impresso envolvendo campos de outros arquivos do
projeto.
Opes
A partir do menu da figura V.18, pode-se estabelecer
algumas opes para a impresso deste contedo. Para
marcar e desmarcar essas opes basta posicionar a
barra seletora e pressionar ENTER.
Manual do Usuri o
182
Figura V.18
Se a opo Negrito estiver assinalada, este contedo
ser impresso com tal atributo. Esta opo s estar
disponvel para ser marcada/desmarcada se a opo de
imprimir relatrio em atributo comprimido estiver
desligada.
Se a opo Expandido estiver assinalada, este
campo ser impresso com tal atributo.
Se a opo Omitir, se igual a anterior estiver
marcada, este campo ser impresso no primeiro
registro e omitido nos demais registros, caso tenha
contedo igual, voltando a ser impresso novamente,
por uma vez, no momento em que seu contedo for
diferente do anterior. No exemplo abaixo, o campo
matrcula omitido quando igual ao anterior:
Matrcula Dependente
0001 Rodrigo
Marcela
Tereza
0002 Carlos
Ingrid
Aparecida
0003 Lucas
Manual do Usuri o
183
Se a opo Totalizar coluna estiver assinalada, o
subtotal (se houver quebras) e o total geral (ao final do
relatrio) ser emitido para este campo. Esta opo
no selecionvel se o tipo de campo no permitir
totalizao.
Se a opo Justificar impresso memo estiver
assinalada, os campos memos existentes sero
justificados (alinhados). Durante o processo de
justificao de linhas, aquelas que terminarem com um
ponto final no sero justificadas, sendo deixadas
intactas.
Se a opo Sintetizar a coluna estiver assinalada,
este campo ou coluna ser sumarizado, ou seja, o valor
impresso ser um total de todos os registros lidos.
Neste caso, este campo ser impresso somente no final
de quebras ou final de relatrio, juntamente com os
demais campos no sumarizados. Quando um contedo
a ser sintetizado for armazanado em uma varivel,
lembre-se de que esta varivel armazenar o valor total
que est sendo obtido na sumarizao. Neste caso,
poder-se- utilizar esta varivel para fazer operaes
com outros contedos no sumarizados,. No entanto,
se assim a tiliz-la para operaes com outros
contedos tambm sumarizados, esta varivel conter
valores parciais da sumarizao.
A opo Continuar definio permite a sada deste
menu e a continuao da definio.
Formatao do relatrio
Esta opo permite a definio do relatrio e a
disposio dos contedos. Diversos recursos esto
disponveis para facilitar a disposio dos contedos
no relatrio. Esses recursos so, basicamente, os
mesmos explicados para a confeco das telas inicial e
... ...
Matrcula Dependente
Manual do Usuri o
184
de digitao, neste captulo, com algumas pequenas
diferenas.
Alterando o tamanho e movimentando a janela
edio bem como a sua movimentao atravs do
Posicionando contedos no relatrio
A tecla F10 permite capturar de um menu, os
contedos definidos para o relatrio. Os campos ou
contedos j posicionados no relatrio so assinalados
com nas opes do menu. Uma vez selecionado um
contedo, basta utilizar as setas ou o mouse (caso
exista) para escolher a posio mais conveniente
pressionando, em seguida, a tecla ENTER.
Posicionando variveis, frmulas ou campos externos do sistema
A tecla F6 permite, a exemplo da tecla F10, capturar
de um menu, as variveis do sistema informados
anteriormente, como por exemplo, o ttulo da
aplicao, nome da empresa, nmero da pgina, data,
hora, etc. Normalmente essas informaes so
colocadas na rea de cabealho do relatrio. As marcas
que aparecem na frente das variveis dentro do
menu indicam que as mesmas j se encontram
posicionadas no relatrio.
As setas cursoras servem para posicionar essas
variveis no relatrio. O mouse tambm pode ser
utilizado para tal fim, bastando clicar sobre um
determinado campo, e arrast-lo para a posio
desejada, liberando o boto em seguida.
Manual do Usuri o
185
Co mo retirar uma frmula ou contedo j posicionado
Para remover um contedo j posicionado no relatrio,
basta ativar o menu com F6 ou F10, conforme o caso,
selecionar o contedo desejado e pressionar a tecla
ESC. Outra maneira mais simplificada pressionar
CTRL-T sobre qualquer ponto de marcao do
contedo na janela do relatrio.
Montando um relatrio padro
A tecla ALT-T permite a criao de um relatrio
padro. Todos os contedos so dispostos no relatrio,
podendo ser, em seguida, mudadas de posio, se
necessrio. Antes do GAS-Pro iniciar a disposio dos
campos, ser solicitada a informao do sentido a ser
observado: se horizontal ou vertical.
Desenhando linhas e molduras
espao).
letras expandidas, exatamente do modo explicado para
a confeco da cabealho do projeto e da tela de
digitao, neste captulo.
aparecer no canto inferior direito da janela.
expandidas ser desligado, voltando a digitao
normal.
Manual do Usuri o
186
Aumentando e diminuido a largura de contedos
Os caracteres e servem para marcar no
relatrio, a largura disponvel para a apresentao do
contedo ali posicionado. As teclas INS e DEL, sobre
esses dois caracteres, aumentam ou diminuem essas
larguras, at o tamanho mximo especificado, desde
que os contedos sejam do tipo caracter.
A tabela do apndice B contm os comandos
disponveis para a formatao de relatrios.
Ordem inicial
Estabelecimento de uma ordenao inicial, fixa, para o
relatrio a ser criado. Uma vez estabelecida esta
ordenao, ela ficar permanente para a aplicao e,
embora o usurio final tenha a possibilidade de
estabelecer ordenaes diversas, essas sero sempre
concatenadas com a que for aqui estabelecida.
Expresso para ordenao inicial
Se desejar, estabelea uma ordem sob a qual o relatrio
ser emitido. A tecla F10 pode ser acionada para
ajud-lo a utilizar campos dos arquivos relacionados
ao arquivo base do relatrio. A tecla F7 permite trazer
as variveis complementares que porventura tiverem
sido definidas neste mdulo.
importante observar que, a ordem aqui estabelecida
no definitiva, sendo apenas uma ordenao a ser
programa fonte do relatrio que permitir ao usurio
serem concatenadas com a que for estabelecida.
Observar tambm que, se forem definidas quebras para
este relatrio, a ordenao dever estar de acordo com
os campos que comandaro essas quebras.
Manual do Usuri o
187
Filtragem inicial
Estabelecimento de uma filtragem ou seleo de
registros que devero ser impressos. Esta seleo
fixa, para o relatrio a ser criado. Uma vez
estabelecida esta seleo ou filtragem, ela ficar
permanente para a aplicao e, embora o usurio final
tenha a possibilidade de estabelecer outras filtragens,
essas sero sempre concatenadas com a que for aqui
estabelecida.
Expresso para filtragem inicial
seleo para imprimir os registros do relatrio. A tecla
F10 pode ser acionada para ajud-lo a utilizar campos
dos arquivos relacionados ao arquivo base do relatrio
para a montagem do critrio de seleo de registros. A
tecla F7 permite trazer as variveis complementares
importante observar que, a filtragem estabelecida
no definitiva, sendo apenas uma filtragem a ser
programa fonte do relatrio que permitir ao usurio
final da aplicao escolher outros critrios de seleo
de registros para serem concatenados com o critrio
estabelecido, no momento da emisso deste relatrio.
Lanamentos
Esta opo permite a gerao de lanamentos (criao
de registros) em outros arquivos de dados da
aplicao, colocando neles informaes de expresses
obtidas a partir do arquivo referenciado neste mdulo
em definio e de outros arquivos com ele
relacionados. Tais lanamentos sero efetuados aps a
emisso do relatrio e sempre atravs de uma
confirmao do usurio final. Os detalhes de como
construir um lanamento so os mesmos descritos no
projeto - Lanamentos, deste captulo, com a
diferena de que, tais lanamentos no possuem
Manual do Usuri o
188
condio de excluso de registro, pois no possuem
frmulas inversas.
Esses lanamentos so executados para cada um dos
registros listados no relatrio, considerando-se,
inclusive, o filtro inicial fixado para este, bem como o
filtro estabelecido pelo usurio final, durante a
emisso do relatrio.
Processamentos
externos para modificar campos do arquivo referido
neste mdulo, ou de outros arquivos da aplicao. Tais
processamentos sero efetuados aps a emisso do
relatrio e sempre atravs de uma confirmao do
usurio final. Os detalhes de como construir um
processamento so os mesmos descritos no tpico
Processamentos, deste captulo, com a diferena de
que, tais processamentos no possuem a opo de
frmula inversa, ou seja, uma vez executados, no
podero ser desfeitos automaticamente.
Esses processamentos so executados para cada um
dos registros listados no relatrio, considerando-se,
emisso do relatrio.
Definio de quebras (agrupamentos)
Permite o estabelecimento de quebras ou
agrupamentos de registros no relatrio. Algumas
informaes sero solicitadas como por exemplo, o
ttulo da quebra, a expresso que comandar a quebra,
totalizaes, salto de pgina, etc.
Ttulo da quebra
Entre com uma frase ou expresso para intitular as
quebras do relatrio. Para abrir a possibilidade de
utilizar funes como ttulo da quebra, o GAS-Pro no
ir gerar aspas antes e aps esta expresso, razo pela
Manual do Usuri o
189
qual, em se tratando de frase, coloque-a entre
apstrofes ().
A tecla F7 permite trazer as variveis complementares,
que porventura tiverem sido defindas no mdulo, para
servirem de contedos a serem impressos.
A tecla F8 pode ser utilizada para construir um
relacionamento por intermdio da funo PTAB( ) e
trazer um campo qualquer que seja de interesse.
A tecla F10 pode ser utilizada para mostrar e capturar
campos de arquivos relacionados.
Exemplo:
CLIENTE: +CLIENTES->NOME
Expresso d quebra
Entre com uma expresso para controlar esta quebra do
relatrio. A tecla F7 permite trazer as variveis
complementares que tiverem sido definidas. A tecla F9
pode ser utilizada para invocar o editor interno do
GAS-Pro para a criao de funo para estabelecer a
quebra. Esta opo requer, no entanto, algum
conhecimento da linguagem CA-Clipper. A tecla F10
poder tambm ser acionada para auxili-lo a
estabelecer a expresso de quebra a partir de campos
de arquivos relacionados. A tecla F7 permite trazer as
variveis complementares, que porventura tiverem
sido defindas no mdulo.
Opes
Essas opes complementam a definio de uma
quebra. Para marcar e desmarcar as opes, basta
posicionar a barra seletora e pressionar ENTER.
Utilizar atributo negrito
Se esta opo estiver marcada e a opo de impresso
de relatrio em atributo comprimido estiver desligada,
o ttulo da quebra ser impresso em atributo negrito.
Manual do Usuri o
190
Utilizar atributo expandido
Se esta opo estiver marcada o ttulo da quebra ser
impresso em atributo expandido.
Imprimir campos omitidos
Os campos omitidos (opo omitir se igual anterior
durante a definio do contedo do relatrio) podem
ser impressos a cada quebra, se esta opo estiver
marcada.
Saltar pgina
Se esta opo estiver assinalada, um salto de pgina
acontecer, logo aps o trmino de cada quebra.
Subtotalizar
Se esta opo estiver assinalada, os contedos
numricos que foram determinados para serem
totalizados tero um subtotal a cada quebra. Caso
contrrio, no haver subtotalizaes.
Imprimir ttulo da quebra
Se esta opo estiver assinalada, os ttulos informados
para as quebras sero impressos a cada ocorrncia de
quebra no relatrio. Caso contrrio, sero omitidos.
Continuar definio
Esta opo permite a sada deste menu de opes e
continuar as definies de quebras.
Insero de GRFICO na rvore do projeto
Esta opo permite a definio de grficos
representativos dos dados de um ou mais arquivos da
aplicao. Esses grficos so de diversos tipos: pizza,
rea, barras, barras 3D, linhas, etc. Nas aplicaes
Manual do Usuri o
191
geradas, eles sero apresentados pelo utilitrio SGR -
Servidor Grfico Residente que acompanha o GAS-
Pro e que dispensa o uso de bibliotecas de funes
para a construo dos grficos. Ocupando somente 6
kbytes de memria RAM, este utilitrio cuidar de
todos os detalhes das apresentaes, seleo e
impresso dos grficos de maneira totalmente
transparente para o usurio final.
Este utilitrio foi desenvolvido pela GAS Informtica
e poder ser fornecido nos disquetes das aplicaes
geradas pelo GAS-Pro sem a necessidade do
pagamento de royalties, desde que seja utilizado em
aplicaes geradas pelo GAS-Pro.
Na definio de um grfico, deve-se ter o cuidado de
selecionar muito bem os dados a serem grafados. Os
valores a serem plotados no devem ser muito
diferentes uns dos outros sob pena de prejudicar o
aspecto final do grfico. Uma grande quantidade de
barras dificulta a visualizao, impede a impresso de
legendas, causa a superposio dos ttulos e imprime
elementos diferentes com a mesma cor (cores tm
nmero limitado). Antes de levar a aplicao para o
usurio, faa testes de plotagem do grfico. Defina
qual o tipo que melhor espelhe a situao dos dados e,
se achar conveniente, cerceie do usurio a troca de
grficos durante a sua apresentao, pois, certos tipos
de grficos no comportam determinadas formas em
que os dados esto.
Elementos para a elaborao de um grfico
O GAS-Pro permite a definio de diversos tipos de
grficos, os quais se dividem em dois grupos, de
acordo com a similaridade do conjunto de informaes
a grafar (set de dados).
Grupo 1: Pizza e Barras
Grupo 2: Barras agrupadas, Barras 3D, Barras
Empilhadas, Barras Escalares, Linhas, rea 3D,
Linhas Empilhadas, rea e Mximos e Mnimos.
Manual do Usuri o
192
O tipo de grfico escolhido durante a gerao pode ser
trocado pelo usurio final da aplicao por qualquer
um outro grfico do mesmo grupo.
Os componentes utilizados para a definio de um
grfico so:
tipo do grfico
contedos
quebras
Dependendo da combinao desses trs elementos,
podemos ter quatro tipos de set de dados para a
montagem de um grfico.
Manual do Usuri o
193
Um ponto importante a ser observado que os ttulos
das quebras que so impressos nos grficos so o
desdobramento de uma expresso, como por exemplo:
LEFT(NMES(data),3) // 3 primeiras letras do ms
TABELA->descricao // campo de arquivo relacionado
Entretanto, os ttulos de contedos que so impressos
no grfico correspondem a, exatamente, o ttulo
informado na definio do contedo.
Manual do Usuri o
194
Dados genricos
Nome do programa
fonte na linguagem CA-Clipper. Embora este nome
seja de livre escolha, lembre-se de que, se desejar
manter compatibilidade com a codificao padro dos
mdulos gerados pelo GAS-Pro, este nome dever
obedecer seguinte regra:
Arquivo principal
utilizados para a composio das informaes a serem
grafadas. Embora possam ser utilizadas informaes
de campos de diversos arquivos, o nome de arquivo
informado ser o bsico, a ser acessado
seqencialmente, a partir do primeiro registro.
Ttulo para menu
o grfico. A montagem cuidadosa desta frase facilita a
aplicao.
Ttulo processos
Informe um ttulo para ser utilizado na mensagem de
confirmao ao usurio para executar ou no os
processos, lanamentos ou apagamento de registros
que porventura venham a ser definidos para serem
feitos a partir deste grfico.
Manual do Usuri o
195
aplicao final.
Condio para menu
permitir que o usurio visualize o referido grfico no
Tecla de atalho
Selecione uma combinao de teclas para acessar este
mdulo por meio do menu. Esta combinao
funcionar como hot-key para o usurio utilizar no
acesso opo de menu que ativa este grfico. A
descrio desta combinao de teclas ser
automaticamente colocada ao lado direito da opo de
menu correspondente.
Tipo do grfico (galeria)
Informe o nmero correspondente ao tipo de grfico
que deseja definir. A tecla F10 serve para visualizar e
selecionar o tipo de grfico desejado como mostra a
figura V.19.
Manual do Usuri o
196
Figura V.19
Ttulo do grfico
Entre com uma informao para intitular o grfico a
ser apresentado. At 22 caracteres podem ser
digitados. Esta informao ser usada como default
para o grfico, uma vez que o usurio da aplicao
final poder entrar com um novo ttulo, sempre que
pressionar ENTER sobre este ttulo, no menu de opes
do grfico.
Ttulo do eixo X
Entre com um ttulo para ser utilizado no eixo X do
grfico, durante a sua apresentao. Esta informao
no utilizada em caso de grfico do tipo pizza.
Ttulo do eixo Y
Entre com um ttulo para ser utilizado no eixo Y do
grfico, durante a sua apresentao. Esta informao
no utilizada para grficos do tipo pizza.
Ttulo de legenda
Entre com um ttulo para ser apresentado ao lado dos
valores do eixo Y.
Manual do Usuri o
197
Opes do grfico
Permitem a definio de algumas caractersticas
assumidas por esse mdulo. Essas opes podem ser
marcadas e desmarcadas com o auxlio da tecla
ENTER.
subsistema, tela complementar e relatrio, esta opo
permite a preservao de cdigo fonte modificado
manualmente.
Nvel de acesso
de nvel de acesso global ao grfico obedece s
subsistema e tela complementar, j explicados neste
captulo.
Exclui registro processado
Caso esta opo esteja marcada, todos os registros que
forneceram dados para o grfico sero excludos. Este
processo de excluso executado ao final da plotagem
do grfico, aps uma confirmao do usurio. Se
estiver desmarcada, isto no ocorrer.
Aspectos do grfico
do grfico, como por exemplo, fundo hachurado,
bordas, ngulos dos eixos, etc. Dentro deste menu,
existem dois grupos de informaes: o primeiro deles,
considerado como flags, ou seja, podem ser ligados
ou deligados. As opes assinaladas sero assumidas
como ligadas. O outro grupo de informaes so
parmetros de configurao do grfico.
Manual do Usuri o
198
Disponibilizar comandos
Existe uma srie de comandos que o usurio pode
executar enquanto o grfico estiver sendo apresentado,
como por exemplo,a impresso em papel, troca do tipo
do grfico, mudana de ngulos, legendas, etc. Se esta
opo estiver marcada, o usurio poder executar esses
comandos, caso contrrio, somente a impresso do
grfico ser permitida.
Fundo hachurado
Se esta opo estiver marcada, as paredes e o fundo do
grfico contero uma fina malha (hachuras) antes da
impresso dos elementos do grfico. Se estiver
desmarcada, essas hachuras no existiro, sendo
utilizado o fundo preto. Embora esta opo esteja
sendo aqui configurada, o usurio da aplicao final
poder mudar essa situao atravs de comandos,
desde que a opo Disponibilizar comandos esteja
marcada.
Bordas
Se esta opo estiver marcada, uma borda ser
desenhada ao redor do grfico. Caso contrrio, esta
borda no aparecer. Embora esta opo esteja sendo
aqui configurada, o usurio da aplicao final poder
mudar essa situao atravs de comandos, desde que a
opo Disponibilizar comandos esteja marcada.
Mostrar ttulo do grfico
Se esta opo estiver marcada, o ttulo principal do
grfico ser mostrado. Caso contrrio, este ser
omitido.
Enfatizar textos
Se esta opo estiver marcada, os textos apresentados
no grfico (ttulos, valores, etc.) sero enfatizados
(fonte bold). Se estiver desmarcada, sero exibidos
Manual do Usuri o
199
com fonte normal. Embora esta opo esteja sendo
aqui configurada, o usurio da aplicao final poder
mudar essa situao atravs de comandos, desde que a
opo Disponibilizar comandos esteja marcada.
Imprimir cores hachuradas
Se esta opo estiver marcada, as cores utilizadas no
grfico sero substitudas por hachuras. Caso
contrrio, a impresso ser feita em uma s cor. No
recomendvel desmarcar esta opo pois o resultado
no satisfatrio, a no ser para grficos de LINHA
(mesmo assim,desde que no tenha muitas delas).
Embora esta opo esteja sendo aqui configurada, o
usurio da aplicao final poder mudar essa situao
atravs de comandos, desde que a opo
Disponibilizar comandos esteja marcada.
Pintar reas internas
Se esta opo estiver marcada, cores sero utilizadas
para o enchimento das reas internas dos elementos do
grfico (barras, fatias de pizza, etc.). Se estiver
desmarcada, somente o contorno desses elementos
sero plotados. Embora esta opo esteja sendo aqui
configurada, o usurio da aplicao final poder mudar
essa situao atravs de comandos, desde que a opo
ngulo do eixo X
Entre com o valor do ngulo a ser aplicado ao eixo X
na apresentao deste grfico. Embora esta opo
esteja sendo aqui configurada, o usurio da aplicao
final poder mudar essa situao atravs de comandos,
marcada.
ngulo do eixo Y
Entre com o valor do ngulo a ser aplicado ao eixo Y
na apresentao deste grfico. Embora esta opo
Manual do Usuri o
200
marcada.
ngulo do texto para itlico
Entre com o valor do ngulo a ser aplicado fonte
utilizada para italizar (inclinar) o texto. Um ngulo
igual a 90 graus significa que a letras sero normais,
menor do que 90 a inclinao se dar para a esquerda e
maior do que 90 para a direita.
Resoluo da impressora
Este parmetro s tem relevncia para impressoras de
pgina (LaserJet, DeskJet entre outras) e diz respeito
resoluo que dever ser utilizada. Para impressoras
matriciais esta opo poder ser desprezada. As
resolues possveis so:
075 - impresso muito grande
100 - impresso de tamanho mdio
150 - impresso pequena
300 - impresso muito pequena
Disponibilizar comandos esteja marcada ou atravs
do menu de opes que apresentado antes da
plotagem do grfico.
Tamanho do ttulo
Informe um nmero de 1 a 6 para especificar o
tamanho a ser utilizado na fonte do ttulo do grfico.
Lembre-se de que uma fonte muito grande poder
causar o truncamento deste ttulo.Embora esta opo
Manual do Usuri o
201
marcada.
Eixo da legenda
Utilize a tecla ENTER para selecionar em qual eixo a
legenda com valores dever ser colocada. As opes
so ESQUERDA, DIREITA ou AMBAS. Embora esta
opo esteja sendo aqui configurada, o usurio da
aplicao final poder mudar essa situao atravs de
comandos, desde que a opo Disponibilizar
comandos esteja marcada.
Destaca fatias(separar fatias)
Esta opo s estar disponvel se estiver sendo
definido um grfico do tipo PIZZA. Utilize a tecla
ENTER para selecionar a opo desejada. As
possibilidades so:
NO as fatias no sero separadas;
LTIMA somente a ltima fatia da pizza ser separada;
TODAS todas as fatias da pizza sero separadas.
atravs do menu de opes, anes da plotagem do
grfico.
Posio do ttulo
Utilize a tecla ENTER para selecionar a posio onde o
ttulo do grfico dever ser mostrado. As opes so
ESQUERDO, CENTRO e DIREITO, porm o ttulo
ser sempre impresso no topo da tela. Embora esta
opo esteja sendo aqui configurada, o usurio da
aplicao final poder mudar essa situao atravs de
comandos, desde que a opo Disponibilizar
comando esteja marcada.
Manual do Usuri o
202
Exibir grades
Utilize a tecla ENTER para selecionar os locais onde
sero exibidas as grades do grfico (ou se no sero
exibidas). As opes disponveis so:
NO grades no sero exibidas
HORIZONTAL sero exibidas somente no eixo horizontal (em se
tratando de grficos BARRAS 3D e REAS 3D, esta
opo forar a exibio na parede direita do grfico.
VERTICAL sero exibidas somente no eixo vertical (em se
tratando de grficos BARRAS 3D e REAS 3D, esta
opo forar a exibio na parede esquerda do
grfico.
AMBAS as grades sero exibidas horizontal e verticalmente.
Vriveis complementares
aplicao final.
Manual do Usuri o
203
externos.
Relacionamentos
escolhido como base do grfico, diversos outros
transparente dentro da definio do grfico, como se
fossem provenientes de um s arquivo. Os detalhes de
como elaborar um relacionamento esto descritos no
tpico Insero de relatrio na rvore do projeto -
relacionamentos.
Manual do Usuri o
204
Esta opo permite a definio dos contedos que
sero totalizados e utilizados para a confeco do
grfico. O GAS-Pro permite diversos tipos de
contedos, como por exemplo, campos do arquivo base
ou de outros arquivos, constantes numricas, etc.
Insero de contedos
Esto disponveis neste menu, as seguintes teclas:
INS insere um novo contedo a ser grafado;
DEL elimina um contedo j definido;
ENTER altera definio de contedo; e
ESC encerra a definio de contedos.
devem ser respondidas:
Ttulo
Informe um ttulo para o contedo a grafar (barras).
Dependendo do tipo de grfico a ser definido, este
ttulo ser utilizado em suas legendas.
Figura V.20
Manual do Usuri o
205
Atente ao fato de que, tomando-se por base a figura
V.20, no recomendvel utilizar um ttulo muito
extenso pois, dependendo do nmero de contedos,
esses podem se sobrepor.
servirem de contedo a ser grafado.
automaticamente um contedo a grafar, a partir de
campos de outros arquivos a serem abertos pela funo
PTAB( ).
automaticamente um contedo a grafar a partir de
(opo Relacionamento), campos do prprio arquivo
principal (arquivo base do grfico) ou de arquivos
abertos por contedos j estabelecidos atravs da
funo PTAB( ) explicada acima (tecla F8).
Contedo
Serve para estabelecer o contedo que ser totalizado e
posteriormente grafado.
que retorne um valor para ser usado como contedo a
ser grafado. Sua utilizao no entanto, requer algum
Os contedos estabelecidos para grficos so SEMPRE
subtotalizados (dentro de quebras) ou totalizados (se
no existir quebras), considerando-se sempre o filtro
inicial e a condio informada para cada um dos
contedos. Por isso, este contedo sempre tem de ser
expresso numrica.
a utilizar campos de outros arquivos como contedo a
ser grafado.
Manual do Usuri o
206
Condio
Informe, se desejar, uma condio para que os
registros sejam totalizados para a apurao do valor a
ser grafado.
automaticamente um contedo a grafar, a partir de
campos de outros arquivos a serem abertos pela funo
PTAB( ).
que retorne um valor lgico. Sua utilizao no entanto,
requer algum conhecimento da linguagem CA-Clipper.
A tecla F10 pode tambm ser utilizada para trazer
campos de arquivos relacionados para serem usados no
estabelecimento desta condio.
Ordem inicial
grfico a ser criado. A ordem inicial deve estar de
acordo com a expresso da quebra pois, cada barra (ou
elemento) a ser grafado ser o valor acumulado dos
registros da quebra.
Se desejar, estabelea uma ordem sob a qual o grfico
ser totalizado. A tecla F10 pode ser acionada para
ao arquivo base do grfico. A tecla F7 permite trazer
as variveis complementares que porventura tiverem
sido definidas neste mdulo.
Filtragem inicial
registros que devero ser grafados. Esta seleo fixa,
para o grfico a ser criado. Uma vez estabelecida esta
Manual do Usuri o
207
seleo ou filtragem, ela ficar permanente para a
aplicao e, embora o usurio final tenha a
possibilidade de estabelecer outras filtragens, essas
sero sempre concatenadas com a que for aqui
estabelecida.
seleo para totalizar os registros a serem grafados. A
tecla F10 pode ser acionada para ajud-lo a utilizar
campos dos arquivos relacionados ao arquivo base do
grfico para a montagem do critrio de seleo de
registros. A tecla F7 permite trazer as variveis
complementares que porventura tiverem sido definidas
neste mdulo.
Lanamentos
plotagem do grfico, sempre aps a confirmao do
lanamento so os mesmos descritos no tpico
Lanamentos, deste captulo, com a diferena de que,
tais lanamentos no possuem condio de excluso de
registro, pois no possuem frmulas inversas.
registros utilizados no grfico, considerando-se,
plotagem do grfico.
Manual do Usuri o
208
Processamentos
processamentos sero efetuados aps a plotagem do
grfico e sempre atravs de uma confirmao do
dos registros utilizados no grfico, considerando-se,
plotagem do grfico.
Definio de quebras (agrupamentos)
Permite o estabelecimento de quebras ou
agrupamentos de registros para serem grafados.
Dependendo do tipo do grfico escolhido e o nmero
de contedos definidos, pode-se ter, no mximo, duas
quebras. A tecla INS pode ser usada neste menu para
inserir nova quebra. A tecla DEL serve para apagar
definies de quebras e a tecla ENTER permite a
alterao das definies de uma quebra.
Ttulo da quebra
Entre com uma expresso para servir de legenda de
grupos ou das barras do grfico. Se esta for a primeira
quebra, esta informao ser utilizada para intitular o
grupo. Se for a segunda, ser usada como ttulo das
barras. Veja o exemplo a seguir:
Manual do Usuri o
209
Observar que, no recomendvel utilizar um ttulo
muito extenso pois, dependendo do nmero de
elementos, os ttulos podem se sobrepor.
servirem de contedos a serem grafados.
A tecla F8 pode ser utilizada para montar um
relacionamento atravs da funo PTAB( ) e trazer um
campo qualquer que seja de interesse.
A tecla F10 pode ser utilizada para mostrar e capturar
campos de arquivos relacionados.
Exemplos:
PRODUTOS->descricao // nome do produto
NMES(data) // nome do ms
LEFT(NMES(data),3) // 3 primeiras letras do ms
Expresso da quebra
Entre com uma expresso para controlar a quebra. A
tecla F9 pode ser utilizada para invocar o editor
interno do GAS-Pro para a criao de funo para
estabelecer a quebra. Esta opo requer, no entanto,
algum conhecimento da linguagem CA-Clipper. A
tecla F10 poder tambm ser acionada para auxili-lo
a estabelecer a expresso de quebra a partir de campos
de arquivos relacionados. A tecla F7 permite trazer as
variveis complementares, que porventura tiverem
sido definidas no mdulo.
Manual do Usuri o
210
Insero de ETIQUETA na rvore do projeto
Esta opo permite a insero de um programa emissor
de etiquetas nesta posio, dentro da rvore do
sistema. Este programa definido pelo mdulo
formatador de etiquetas do GAS-Pro, que criar um
programa fonte (.PRG) para efetuar a emisso.
Dados genricos
Nome do programa
Arquivo principal
utilizados para a composio bsica da etiqueta.
Embora possam ser utilizadas informaes de campos
de diversos arquivos, o nome de arquivo informado
ser o bsico, a ser acessado seqencialmente, a partir
do primeiro registro.
Ttulo para menu
o programa de emisso da etiqueta. A montagem
cuidadosa desta frase facilita a identificao desta
opo, pelo usurio final da aplicao.
Manual do Usuri o
211
aplicao final.
Opes da etiqueta
Entrada das opes que afetaro diretamente o formato
da etiqueta, como por exemplo, a sua largura em
caracteres, altura em linhas, etc. Essas opes podem
ser marcadas e desmarcadas com o auxlio da tecla
ENTER. Os parmetros informados sero gerados
dentro do programa fonte de emisso da etiqueta,
contudo, este programa estar provido de uma rotina
que permitir ao usurio final da aplicao mud-los
em tempo de execuo. Os parmetros que podero ser
mudados pelo usurio so: altura da etiqueta, largura
da etiqueta, colunas de separao e quantidade de
carreiras.
manualmente, evitando que o GAS-Pro gere e grave
um novo programa sobre um j existente. Se esta
opo estiver assinalada, o programa relativo a esta
etiqueta ser gerado normalmente. Por outro lado, se
este programa fonte j tiver sido gerado e tiver sofrido
intervenes manuais que no devam ser perdidas,
basta desligar esta opo retirando a marcao para
que o GAS-Pro, ao gerar novamente os programas de
Manual do Usuri o
212
todo o projeto, deixe de gerar este programa de
etiqueta, preservando assim as modificaes feitas.
Caso este programa no exista no diretrio do projeto,
o GAS-Pro far a sua gerao, independentemente de
existir ou no marcao nesta opo.
Nvel de acesso
de nvel de acesso global ao programa de etiqueta
obedece s mesmas regras descritas para os mdulos
de subsistema, tela complementar e relatrio, j
explicados neste captulo.
forem impressos na etiqueta sero excludos. Este
processo de excluso executado ao final da emisso
das etiquetas, aps uma confirmao do usurio. Se
estiver desmarcada, isto no ocorrer.
Executar processos/lanamentos antes
Se marcada esta opo, os processos e lanamentos
definidos na etiqueta sero executados antes que a
etiqueta seja emitida. Caso contrrio, esses processos e
lanamentos sero executados somente aps o
complemento da emisso.
Altura da etiqueta
Corresponde quantidade de linhas que podem ser
impressas em uma etiqueta, considerando tambm a
linha que separa uma etiqueta e outra, dentro do
formulrio. Esta configurao est diretamente
relacionada com a densidade vertical (quantidade de
linhas por polegada) configurada na opo Aspecto
do menu Definio da etiqueta, a ser explicado mais
Manual do Usuri o
213
adiante. Se desejar mudar esta configurao, basta
Margem esquerda
Corresponde quantidade de espaos que sero
colocados na frente de cada linha impressa na etiqueta.
Se desejar mudar este valor, basta pressionar ENTER e
informar o novo nmero.
Largura da etiqueta
Corresponde quantidade de caracteres que podem ser
impressos em uma linha da etiqueta. Leve em
considerao que este parmetro est diretamente
relacionado com o que estiver configurado na
compresso de caracteres, no menu Aspecto.
Colunas de separao
Corresponde quantidade de caracteres que separam
uma etiqueta da outra dentro do formulrio. Leve em
considerao que este parmetro est diretamente
relacionado com o que estiver configurado na
compresso de caracteres, no menu Aspecto.
Nmero de carreiras
Corresponde quantidade de etiquetas dispostas
horizontalmente no formulrio de etiquetas.
Quantidade de carreiras por folha
Corresponde quantidade de etiquetas verticalmente
dispostas no formulrio de etiquetas. Esta opo s
funcionar quando a impressora configurada for
impressora de pgina, isto , se a configurao de
quantidade de linhas por pgina for deixada em
branco.
Manual do Usuri o
214
Aspecto da etiqueta
da etiqueta, como por exemplo, se dever ser utilizada
a densidade de 8 linhas/polegada, se ser impresso em
caracteres comprimidos, etc. Essas opes so
consideradas flags, ou seja, podero ser ligadas ou
desligadas. As opes assinaladas com sero
assumidas como ligadas, sendo respeitadas pelo GAS-
Pro, no momento da gerao da etiqueta.
Essas opes podem ser ligadas e desligadas com o
auxlio da tecla ENTER.
8 linhas por polegadas
Se esta opo estiver assinalada, a densidade de
impresso desta etiqueta ser de 8 linhas/polegada.
Caso no esteja assinalada esta opo, a densidade
normal de 6 linhas/ polegada ser utilizada. Esta opo
est diretamente relacionada com o que estiver
configurado para Altura da etiqueta no menu
anterior, Opes da etiqueta.
Compresso em 12 cpp
Se esta opo estiver assinalada, a etiqueta ser
impressa em caracteres elite (12 caracteres por
polegada). Caso contrrio, caracteres de tamanho
normal (10 caracteres por polegada) ser utilizado.
Compresso em 17,5 cpp
impressa em caracteres comprimidos (17,5 caracteres
por polegada).
Manual do Usuri o
215
Compresso em 20 cpp
impressa em caracteres comprimidos (20 caracteres
por polegada).
Em impressoras HP-Laser/DesekJet a taxa de
Orientao landscape
Normalmente, as impressoras matriciais no possuem
o recurso de orientao do formulrio para landscape
(paisagem), que se constitui na impresso do relatrio
no sentido horizontal do formulrio (a 90 graus). Se
esta opo estiver marcada, a impresso ser feita no
sentido landscape. Caso contrrio, a impresso se dar
no sentido normal (portrait ou retrato).
(nmero do contexto) para a ajuda on-line da aplicao
final.
Manual do Usuri o
216
externos.
Relacionamentos
escolhido como base da etiqueta, diversos outros
transparente dentro da etiqueta, como se fossem
provenientes de um s arquivo.
Seleo do arquivo a relacionar
Uma vez relacionados dois arquivos, os campos de
ambos podem ser utilizados para novos
relacionamentos com outros arquivos, e assim por
diante.
Manual do Usuri o
217
Para iniciar o estabelecimento de um relacionamento,
selecione um dos arquivos presentes neste menu.
Seleo de campos do arquivo a relacionar
Selecione um ou mais campos do arquivo base da
etiqueta que sero utilizados para o relacionamento
com o arquivo que acabou de ser escolhido. O campo
ou campos escolhidos devero ter as mesmas
caractersticas dos campos que compem a chave de
indexao do arquivo que acabou de ser escolhido. O
GAS-Pro far uma verificao e mostrar mensagem
de aviso, caso os campos sejam incompatveis.
Quando terminar de escolher o campo (ou campos),
pressione a tecla ESC.
Insero de novos relacionamentos
relacionamentos, a tecla DEL quando desejar excluir
um relacionamento j estabelecido, a tecla ENTER
para modificar um relacionamento existente ou a tecla
ESC para finalizar os relacionamentos.
Esta opo permite a definio do contedo da
etiqueta, ou seja, o estabelecimento das informaes
que devero ser impressas nas posies a serem
escolhidas. O GAS-Pro permite diversos tipos de
contedos para etiquetas, como por exemplo, campos
do arquivo base ou de outros arquivos, constantes, etc.
Insero de contedos
As seguintes teclas esto disponveis neste menu:
INS insere e define um novo contedo para a etiqueta, na
posio imediatamente abaixo da barra seletora
DEL retira um contedo que tenha sido definido
anteriormente
Manual do Usuri o
218
F4 muda para a janela de definio da etiqueta (hot-key)
ESC encerra definio de atributos
devem ser respondidas ao GAS-Pro:
Ttulo do contedo
Informe um ttulo para a informao que ser
designada para ser impressa na etiqueta.
automaticamente um contedo para imprimir, a partir
de campos de outros arquivos a serem abertos pela
funo PTAB( ).
automaticamente um contedo a imprimir a partir de
(opo Relacionamentos), campos do prprio
arquivo principal (arquivo base da etiqueta) ou de
arquivos abertos por contedos j estabelecidos
atravs da funo PTAB( ).
Contedo
Estabelea o contedo da informao a ser impressa. A
tecla F9 pode ser utilizada para criar uma funo que
retorne um valor para ser usado como contedo da
etiqueta. A sua utilizao no entanto, requer algum
a utilizar campos de outros arquivos como contedo da
etiqueta
.
Manual do Usuri o
219
Mscara
quais as informaes so mostrados.
Abaixo esto alguns exemplos de mscaras:
mostrado naquela posio seja sempre em
maisculo;
@! - todos os caracteres existentes dentro do campo
apresentados, sem a necessidade de existirem no
arquivo de dados;
Tamanho ou largura do contedo
Corresponde largura utilizada para efeito de
da etiqueta. No tem efeito sobre a quantidade de
caracteres que sero impressos no etiqueta. Para se
imprimir apenas parte de um contedo, deve-se utilizar
as funes SUBSTR( ), LEFT( ), MID( ) ou RIGHT( )
do CA-Clipper.
Tipo de contedo
Selecione o tipo de contedo, caracter, numrico, data,
ou lgico, de acordo com o dado que ser impresso na
etiqueta.
Opes
A partir do menu da figura V.21, pode-se estabelecer
algumas opes para a impresso deste contedo: Para
marcar e desmarcar essas opes basta posicionar a
barra seletora e pressionar ENTER.
Manual do Usuri o
220
Se a opo Negrito estiver assinalada, este conteudo
ser impresso com tal atributo. Esta opo s estar
disponvel para ser marcada/desmarcada se a opo de
imprimir etiqueta em atributo comprimido estiver
desligada.
Se a opo Expandido estiver assinalada, este campo
ser impresso com tal atributo.
Figura V.21
Formatao da etiqueta
Esta opo permite a definio da etiqueta. Diversos
dos contedos na etiqueta. Esses recursos so,
basicamente, os mesmos explicados para a confeco
das telas e relatrios, neste captulo, com pequenas
diferenas.
edio, bem como a sua movimentao atravs do
e arrast-la para a posio desejada. A janela da
etiqueta s pode ser expandida at o seu tamanho
mximo, estabelecido pelos parmetros Altura e
Largura da etiqueta.
Manual do Usuri o
221
Posicionando contedos na etiqueta
A tecla F10 permite capturar de um menu, os
contedos definidos para a etiqueta. Os campos ou
contedos j posicionados na etiqueta so assinalados
com nas opes do menu. Uma vez selecionado
um contedo, basta utilizar as setas ou o mouse (caso
exista) para escolher a posio mais conveniente
pressionando, em seguida, a tecla ENTER.
Como retirar um contedo j posicionado
Para remover um contedo j posicionado na etiqueta,
basta ativar o menu com F10, selecionar o contedo
desejado e pressionar a tecla ESC. Outra maneira mais
simplificada pressionar CTRL-T sobre qualquer
ponto de marcao do contedo na janela da etiqueta.
Montando uma etiqueta padro
A tecla ALT-T permite a criao de uma etiqueta
padro. Todos os contedos so dispostos na etiqueta,
podendo ser, em seguida, mudados de posio, se
necessrio.
espao).
letras expandidas, exatamente do modo explicado para
a confeco do cabealho do projeto e da tela de
digitao, neste captulo.
aparecer no canto inferior direito da janela.
Manual do Usuri o
222
expandidas ser desligado voltando a digitao
normal.
Aumentando e diminuido a largura de contedos
O caracter serve para marcar na etiqueta a largura
disponvel para a apresentao do contedo ali
posicionado. As teclas INS e DEL, sobre esses dois
caracteres, aumentam ou diminuem essas larguras, at
o tamanho mximo especificado, desde que os
contedos sejam do tipo caracter.
A tabela do apndice B contm os comandos
disponveis para a formatao da etiqueta.
Ordem inicial
Estabelecimento de uma ordenao inicial, fixa, para a
etiqueta a ser criada. Uma vez estabelecida esta
ordenao, ela ficar permanente para a aplicao e,
embora o usurio final tenha a possibilidade de
estabelecer ordenaes diversas, essas sero sempre
concatenadas com a que for aqui estabelecida.
Se desejar, estabelea uma ordem sob a qual a etiqueta
deve ser emitida. A tecla F10 pode ser acionada para
ao arquivo base da etiqueta. A tecla F7 serve para
trazer as variveis complementares que porventura
tiverem sido defindas no mdulo.
importante observar que, a ordem estabelecida no
definitiva, sendo apenas uma ordenao a ser
programa fonte da etiqueta que permitir ao usurio
Manual do Usuri o
223
serem concatenadas com a que for estabelecida neste
ponto.
Filtragem inicial
registros que devero ser impressos. Esta seleo
fixa, para a etiqueta a ser criada. Uma vez estabelecida
esta seleo ou filtragem, ela ficar permanente para a
aplicao e, embora o usurio final tenha a
possibilidade de estabelecer outras filtragens, essas
sero sempre concatenadas com a que for aqui
estabelecida.
seleo para imprimir os registros da etiqueta. A tecla
F10 pode ser acionada para ajud-lo a utilizar campos
dos arquivos relacionados ao arquivo base da etiqueta
para a montagem do critrio de seleo de registros. A
tecla F7 serve para trazer as variveis complementares
que porventura tiverem sido defindas no mdulo. A
tecla F9 pode ser utilizada para a criao, neste
momento, de uma rotina em CA-Clipper (sendo
necessrio algum conhecimento da linguagem).
importante observar que, a filtragem estabelecida
no definitiva, sendo apenas uma filtragem a ser
programa fonte da etiqueta que permitir ao usurio
final da aplicao escolher outros critrios de seleo
de registros para serem concatenados com o critrio
ora estabelecido, no momento da emisso desta
etiqueta.
Lanamentos
Manual do Usuri o
224
emisso da etiqueta e sempre atravs de uma
confirmao do usurio final. Os detalhes de como
construir um lanamento so os mesmos descritos no
projeto - Lanamentos, deste captulo, com a
diferena de que, tais lanamentos no possuem
condio de excluso de registro, pois no possuem
frmulas inversas.
registros listados na etiqueta, considerando-se,
inclusive, o filtro inicial fixado para esta, bem como o
emisso da etiqueta.
Processamentos
processamentos sero efetuados aps a emisso da
etiqueta e sempre atravs de uma confirmao do
dos registros listados na etiqueta, considerando-se,
inclusive, o filtro inicial fixado para esta, bem como o
emisso da etiqueta.
Arquivo de parmetros
Em alguns tipos de aplicaes, interessante a
manuteno de um arquivo de dados (DBF) para
armazenar parmetros utilizados pelo sistema e que se
Manual do Usuri o
225
alteram dentro de certa periodicidade. Um exemplo
tpico uma aplicao comercial que necessita saber
quais os valores da inflao, juros de mercado,
percentual de desconto, etc.
Esta opo permite a criao dentro da aplicao de
um nico arquivo (subsistema) de parmetros com as
seguintes caractersticas:
associados;
no tem arquivos relacionados;
no recebe nem gera lanamentos;
no tem montagem de consultas;
nenhum relatrio pode ser definido.
A manuteno deste arquivo feita normalmente e
suas variveis de arquivo (nomes de campos) sero
copiados para variveis pblicas de memria, para
serem vistas e utilizadas em toda a aplicao. Por
isso, no momento da definio dos nomes dos seus
campos, boa prtica inici-los com um padro
qualquer, como por exemplo:
K_TAXAJURO, K_PERCDESC, K_INFLACAO, ...
Isto ajuda a evitar os possveis conflitos com as
variveis criadas pelo GAS-Pro nos programas fontes
da aplicao.
A definio de um arquivo de parmetros , em tudo,
semelhante definio de um subsistema (DBF), j
explicado detalhadamente em outro tpico deste
captulo. Apenas algumas opes no estaro
disponveis quando se tratar de arquivos de
parmetros.
Manual do Usuri o
226
Insero de PROCESSOS PR-DEFINIDOS na rvore
do projeto
Esta opo permite a definio de processos e
lanamentos a serem executados em um determinado
arquivo ou parte dele. Este processo ser disparado
atravs de opo de menu (batch), aps a confirmao
do usurio. Os processamentos e lanamentos
definidos para o arquivo principal, atravs do mdulo
de subsistema (DBF) no sero executados. Caso haja
a necessidade de execut-los, aquelas definies tero
de estar repetidas aqui.
Dados genricos
Nome do programa
Arquivo principal
utilizados nos processos e lanamentos elaborados.
Embora possam ser utilizadas informaes de campos
de diversos arquivos, o nome de arquivo informado
ser o bsico, a ser acessado seqencialmente, a partir
do primeiro registro.
Manual do Usuri o
227
Ttulo para menu
o programa que executar os processamentos. A
montagem cuidadosa desta frase facilita a
aplicao.
aplicao final.
Condio para menu
Tecla de atalho
Opes do processo pr-definido
Permite a entrada de informaes genricas que
definem o comportamento do processo pr-definido.
Manual do Usuri o
228
manualmente, evitando que o GAS-Pro gere e grave
um novo programa sobre um j existente. Se esta
opo estiver assinalada, o programa relativo a este
mdulo ser gerado normalmente. Por outro lado, se
este programa fonte j tiver sido gerado e tiver sofrido
intervenes manuais que no devam ser perdidas,
basta desligar esta opo retirando a marcao para
que o GAS-Pro, ao gerar novamente os programas de
todo o projeto, deixe de gerar este programa,
preservando assim as modificaes feitas.
Caso este programa no exista no diretrio do projeto,
o GAS-Pro far a sua gerao, independentemente de
existir ou no marcao nesta opo.
Nvel de acesso
de nvel de acesso global a este mdulo obedece s
subsistema, tela complementar e relatrio, j
explicados neste captulo.
forem processados do arquivo principal sero
excludos. Esta excluso executada medida que os
registros so processados.
Manual do Usuri o
229
aplicao final.
externos.
Manual do Usuri o
230
Relacionamentos
escolhido como base dos processos pr-definidos,
diversos outros podem ser utilizados atravs de
relacionamentos estabelecidos por esta opo. Uma
vez estabelecido um relacionamento de um arquivo
com outro, os campos desses arquivos podem ser
utilizados de maneira transparente dentro da mdulo,
como se fossem provenientes de um s arquivo. Os
detalhes de como montar um relacionamento esto
descritos no tpico Insero de relatrios na rvore
do projeto - Relacionamentos, neste captulo.
Ordem inicial
arquivo principal do processamento pr-definido.
Se desejar, estabelea uma ordem sob a qual os
registros sero processados. A tecla F10 pode ser
acionada para ajud-lo a utilizar campos dos arquivos
relacionados ao arquivo base. A tecla F7 permite
trazer as variveis complementares que porventura
tiverem sido definidas neste mdulo.
Filtragem inicial
registros que devero ser processados. Esta seleo
fixa. Uma vez estabelecida esta seleo ou filtragem,
ela ficar permanente para a aplicao.
seleo para selecionar os registros a serem
processados. A tecla F10 pode ser acionada para
ao arquivo base para a montagem do critrio de
seleo de registros. A tecla F7 permite trazer as
Manual do Usuri o
231
variveis complementares que porventura tiverem sido
definidas neste mdulo.
Lanamentos
relacionados. Os detalhes de como construir um
lanamento so os mesmos descritos no tpico
Lanamentos, deste captulo, com a diferena de que,
tais lanamentos no possuem condio de excluso de
registro, pois no possuem frmulas inversas.
registros processados, considerando-se, inclusive, o
filtro inicial fixado para este.
Processamentos
neste mdulo, ou de outros arquivos da aplicao.Os
detalhes de como construir um processamento so os
mesmos descritos no tpico Inserindo um subsistema
(DBF) na rvore do projeto - Processamentos, deste
captulo, com a diferena de que, tais processamentos
no possuem a opo de frmula inversa, ou seja,
uma vez executados, no podero ser desfeitos
automaticamente.
dos registros processados, considerando-se, inclusive,
o filtro inicial fixado para este.
Definio do processo
DESCRIO DO PROCESSO para fazer parte da
Manual do Usuri o
232
documentao do projeto. O arquivo GLO.PLA
fornecido no CD do GAS-Pro, que pode ser
modificado para atender suas necessidades, a base de
criao deste formulrio.
Insero de LINHAS SEPARADORAS na rvore do
projeto
Esta opo permite a insero de uma linha separadora
para melhor distinguir as opes distribudas em um
menu qualquer.
Processamento de apoio
Esta opo permite a insero de rotinas de
processamento de apoio nesta posio, dentro da
rvore do sistema. Esta opo s estar disponvel se
as rotinas de processamento de apoio tiverem sido
tiradas, por alguma razo, da rvore do sistema. Como
default, o GAS-Pro as coloca na rvore para serem
geradas, com excesso das listadas a seguir::
Rotina avulsa;
Comando ou programa externo;
Subsistema (DBF);
Arquivo de parmetros;
Processamentos pr-definidos;
Muda empresa atual;
Impressora fiscal;
Linha separadora.
Essas opes podem ser inseridas no processamento de
apoio exatamente da mesma maneira como so
inseridas em outros pontos da rvore do projeto,
obedecendo as mesmas restries.
Manual do Usuri o
233
Atravs do menu representado na figura V.22, pode-se
inserir, apagar ou modificar opes do processamento
de apoio.
Figura V.22
As opes que o GAS-Pro coloca automaticamente ao
ser definido um novo projeto, so:
Backup
Insere rotinas para executar cpias de segurana dos
arquivos da aplicao, garantindo a sua integridade em
caso de perda por problemas externos como, queda de
energia, erro de mdia, etc.
Restaura Backup
Insere rotinas para executar a recuperao de arquivos
a partir das cpias de segurana geradas pela opo de
Backup.
Reconstri ndices
Insere na aplicao, as rotinas para executar a
reconstruo de arquivos ndices que porventura
estejam danificados.
Manual do Usuri o
234
Elimina registros marcados (Compactao)
Insere na aplicao, as rotinas para executar a
compactao dos arquivos de dados (DBF). Essa
compactao consiste na eliminao definitiva dos
registros que porventura foram apagados durante a
operao da aplicao.
V relatrios gravados
Todos os relatrios definidos no projeto podem ser
direcionados para arquivo/vdeo. Esta opo permite
ao usurio da aplicao final rever um relatrio em
vdeo, sem a necessidade de emit-lo novamente.
Atravs desta opo pode-se ainda imprimir o relatrio
a partir de uma determinada pgina.
Configura ambiente
Esta opo insere na aplicao, as rotinas para
executar as configuraes referentes ao seu ambiente
de operao. Essas rotinas permitem que diversas
configuraes sejam feitas a nvel da aplicao final,
como por exemplo, de cores, impressoras, molduras,
etc.
Impressora
Se escolhida esta opo, o GAS-Pro ir gerar dentro
da aplicao final rotinas para configurao da
impressora conectada ao micro.
Pano de fundo
Se escolhida, o GAS-Pro ir gerar dentro da aplicao
final um menu para a escolha do caracter a ser
utilizado para encher a tela por baixo das janelas e
caixas de dilogos mostrados na tela.
Fonte de caracteres
Se escolhida esta opo, o GAS Pro possibilitar a
troca das fontes de caracteres disponveis, desde que o
Manual do Usuri o
235
monitor onde a aplicao ir ser executada seja padro
VGA.
Esquema de cores
Se escolhida, o GAS-Pro criar dentro da aplicao
final as rotinas necessrias para que se possa mudar as
cores dos diversos tipos de objetos apresentados na
tela da aplicao.
Diretrio de trabalho
final as rotinas que possibilitam a troca de diretrio
dos arquivos de dados e ndices, manipulados pela
aplicao.
Confirma em campos
final as rotinas para configurar se o cursor mudar de
campo automaticamente ao chegar ao final do campo
ou se a tecla ENTER ter de ser pressionada para que
isto se realize
.
Confirma excluses
Se escolhida, o GAS-Pro criar dentro da aplicao,
uma rotina para permitir a configurao do
comportamento do processo de excluso de registros
dos arquivos (confirmada ou no).
Confirma incluses
uma rotina para solicitar ao usurio final uma
confirmao antes que o registro seja includo no
arquivo.
Manual do Usuri o
236
Excludos visveis
Se este mdulo for inserido na rvore, o usurio final
poder configurar a apresentao ou no, nas
consultas, dos registros que se encontram marcados
para apagamento (excludos).
Efeitos sonoros
uma rotina para permitir o chaveamento da emisso de
efeitos sonoros.
Ajuda de campo ativa
uma rotina para permitir o chaveamento e
configurao da apresentao de ajuda ativa no
momento da digitao de campos
Menus centralizados
Se este mdulo for inserido na rvore do projeto, o
usurio da aplicao final poder configurar a
apresentao dos menus com textos (opes)
centralizados ou no.
Utiliza mouse
uma rotina para permitir a ativao e desativao do
mouse.
Sensibilidade do mouse
uma rotina para permitir o ajuste da sensibilidade do
mouse.
Manual do Usuri o
237
Linha separadora
Se escolhida, o GAS-Pro ir inserir uma linha
separadora para melhor distinguir as opes distribdas
em um menu qualquer.
Opera plano de senhas
Esta opo insere na aplicao, as rotinas para
executar a manuteno do plano de senhas, com trs
nveis globais e cerceamento a nvel de rotina.
Muda empresa atual
Se esta opo estiver inserida, sempre que a aplicao
for iniciada ser apresentado ao usurio um menu das
empresas cadastradas para que selecione uma delas
com a qual deseja operar.
Aps selecionada uma empresa, todos os campos do
arquivo de empresas so publicados em variveis de
mesmo nome que podem ser utilizadas em qualquer
ponto da aplicao.
Impressora fiscal
Esta opo insere na aplicao final um sub-menude
manuteno da impressora fiscal, de onde o usurio
poder efetuar diversas operaes discais, como, por
exemplo, abrir e fechar caixa, mudar horrio de vero,
sangria, cancelar itens, etc.
Porta de comunicao
Esta opo insere, na aplicao final, um mdulo que
permite ao usurio o redirecionamento da sada da
impressora fiscal para uma determinada porta
disponvel.
Manual do Usuri o
238
Horrio de vero
permite ao usurio a mudana do atributo horrio de
vero da impressora fiscal. No caso de impressoras
Bematech, a cada vez que o usurio disparar esta
opo, ele estar realizando um chaveamento entre
os horrios de vero e convencional. No caso das
impressora Yanco, um menu intermedirio ser
apresentado com as opes Iniciar horrio de
veroe Terminar horrio de vero.
Leitura X
permite ao usurio a impresso do relatrio X, cuja
funo principal a de gerar um parecer exato do
movimento dirio da impressora, no momento em que
o mesmo emitido.
Sangria
permite ao usurio a retirada de valores em caixa.
Suprimentos
permite ao usurio a insero de valores no caixa,
como, por exemplo, valores para troco, etc.
Cancela item
permite ao usurio o cancelamento dos:
ltimos 100 itens impressos, no caso da impressora
Bematech;
Primeiros 200 itens impressos, no caso da
impressora Yanco.
Manual do Usuri o
239
Cancela cupom
permite ao usurio o cancelamento exclusivo do ltimo
cupom impresso. Um outro cancelamento s poder ser
solicitado aps a emisso de um outro cupom.
Modelo da impressora
permite ao usurio a troca da impressora fiscal
conectada, sendo possveis a Bematech MP20FI e a
Yanco 8000-ECF. Se esta opo no for
disponibilizada ao usurio, a impressora default,
definida em Rotinas Especiais no menu do projeto,
ser utilizada.
Abrir caixa
Conhecida tambm como Incio do dia, esta opo
incluir na aplicao final um mdulo para
acionamento da abertura do caixa pelo usurio. Com
exceo da troca de modelo de impressora fiscal, porta
de conexo e horrio de vero, qualquer outra opo
fiscal s poder ser acionada aps a ativao desta
opo. J a opo de troca de horrio de vero no
pode ser realizada aps esta opo ter sido ativada.
Fechar caixa
permite ao usurio o fechamento do caixa, considerado
como Fim do dia. Aps o acionamento desta opo
pelo usurio, um relatrio Z ser emitido
automaticamente, enviando o contedo do grande total
para a memria fiscal e zerando todos os totalizadores
parciais. Deste momento em diante, a impressora fiscal
no mais permitir operaes fiscais at que seja
alterada a data do seu relgio interno, ou seja, at o dia
seguinte.
Manual do Usuri o
240
Linha separadora
Esta opo ir inserir uma linha separadora para
melhor distinguir as opes distribdas em um menu
qualquer.
Gera Fontes
Esta opo inicia a criao dos programas fontes
(.PRG) necessrios execuo do projeto em
definio. Se nenhum projeto estiver sendo definido no
momento, o GAS-Pro solicitar a entrada de um nome
de projeto j existente, para ser carregado em memria
e ter seus programas fontes gerados.
Nome do Projeto
Informe um nome de arquivo para gravar os atributos
do projeto em definio. Este arquivo ter
obrigatoriamente a extenso PRO, que o GAS-Pro
coloca automaticamente. Pode-se informar tambm o
nome de um projeto j existente em disco para fazer a
regerao dos seus programas fontes. A tecla F10 pode
ser utilizada para capturar um nome de arquivo em um
menu.
Informado um nome de projeto o GAS-Pro iniciar a
gerao efetiva dos programas fontes (.PRG)
necessrios execuo do projeto. Nesta fase, o GAS-
Pro estar gravando em disco os programas gerados,
de forma idntica como se tivessem sido programados
manualmente.
Antes de iniciar o processo de gerao dos programas
fontes, o GAS-Pro executar uma srie de rotinas
verificando a consistncia de tudo o que foi informado
para o projeto que est para ser gerado. Esta
consistncia visa identificar erros de definio, como
por exemplo, referncias a campos inexistentes em
outros arquivos, telas no definidas ou incompletas,
etc. Caso algum erro seja detectado, o GAS-Pro
avisar para que possa ser corrigido o problema.
Manual do Usuri o
241
Executvel - compilao
Esta opo executa toda a operao de compilao e
ligao da aplicao final, ou seja, a operao que
obtm o programa final executvel da aplicao
(.EXE), a partir dos programas fontes (.PRG) criados
pelo GAS-Pro. Nesta operao, o GAS-Pro
desativado da memria, liberando-a inteiramente para
o CA-Clipper trabalhar com boa performance. Antes
de iniciar a compilao, o GAS-Pro solicitar a
entrada de um nome de projeto.
Utilitrio adaptador
Sempre que um projeto estiver sendo modificado o
GAS-Pro verifica se algum campo de algum dos seus
subsistemas foi modificado quanto ao seu nome,
tamanho, tipo ou casas decimais. No caso de ter sido
feita alguma modificao, o GAS-Pro gera
automaticamente um programa fonte de nome
XXX_ADAP.PRG contendo rotinas para executar
todas as adaptaes necessrias nos arquivos .DBF do
projeto, caso existam. Alm do mais, este programa,
quando executado, adapta tambm o arquivo de
senhas, se necessrio.
Esta opo serve tambm para compilar este programa,
bastando selecionar arquivo .CLP de mesmo nome,
tambm criado para tal fim.
Caso no queira executar este programa por no terem
sido digitados dados nos arquivos .DBF, apague
manualmente, a nvel do DOS os arquivos do diretrio
do projeto *.NTX (ou outro tipo de arquivo de ndice
qualquer), *.DB* e *.SYS. Observe que alguns deles
podero ter atributo read only, dependendo com quais
opes a aplicao foi gerada. O captulo X deste
manual detalha a operao deste programa utilitrio
adaptador de arquivos.
Manual do Usuri o
242
Utilitrios
Esta opo d acesso aos utilitrios do GAS-Pro, que
constitudo de um conjunto de programas que
executam tarefas especiais como, por exemplo, emitir
o manual do usurio da aplicao, emitir listagens de
programas da aplicao, preparar o arquivo de ajuda da
aplicao final, etc. O menu de utilitrios do GAS-Pro
est representado na figura V.23.
Figura V.23
Documentao
Esta opo permite a emisso de diversas informaes
para fazer parte da documentao do projeto. Um
segundo menu ser apresentado oferecendo as opes
de documentao que o GAS-Pro pode emitir.
Planilhas de gerao
Esta opo pode ser utilizada para enviar para a
impressora, um conjunto de formulrios que podero
auxiliar a definio de um projeto de sistema atravs
do GAS. Essas planilhas, que podem ser impressas
individualmente, contm as perguntas que o GAS-Pro
formula durante as definies. Podem ser preenchidas
manualmente por um tcnico e, se necessrio, passadas
a outra pessoa, mesmo leiga, para operar o GAS-Pro.
Essas planilhas so fornecidas no CD do GAS-Pro e
Manual do Usuri o
243
esto armazenadas em arquivos de formato ASCII, de
extenso .PLA, podendo portanto ser alteradas, se
necessrio.
A emisso dessas planilhas obedecer ao que estiver
configurado nas opes Configura formulrio e
Parmetros de impresso deste menu.
Emite projeto fsico
Esta opo emite em arquivo ou impressora, de acordo
com o que estiver configurado nas opes Configura
formulrio e Parmetros de impresso, a
documentao completa (projeto fsico) de um projeto
criado pelo GAS-Pro. Uma vez fornecido o nome do
projeto, o GAS-Pro recupera as informaes
necessrias dos arquivos de atributos e emite a
documentao completa, constituda de capa,
estruturas dos arquivos e atributos de campos, telas,
relacionamentos, processamentos externos,
lanamentos, formulrios para entrada de dados,
referncia cruzada dos arquivos, layouts de relatrios,
etc., tudo isso acompanhado de um ndice por assunto
e capas internas, para cada um dos assuntos.
Esta opo utiliza a memria de vdeo para a
montagem das telas dos subsistemas antes da
impresso, de modo que, se algum programa residente
estiver fazendo uso desta rea, as telas podero estar
comprometidas na documentao. Por exemplo, o
utilitrio QEMM386 da QuarterDeck Office Systems
quando utilizando o processo Stealth faz uso dessa
memria!...
Manual do usurio
Esta opo permite a confeco da documentao de
usurio para um determinado projeto.
Emite manual do usurio
Esta opo permite a obteno do manual do usurio
da aplicao final. Para tanto, o arquivo gabarito
Manual do Usuri o
244
GASMANU.GAB dever estar presente no diretrio
do GAS-Pro e o nome do projeto cujo manual ser
emitido dever ser informado.
Edita o arquivo gabarito do manual
Esta opo ativa o editor interno do GAS-Pro para
permitir a edio do arquivo GASMANU.GAB, que
o arquivo gabarito para a gerao de manuais de
operao para as aplicaes.
O captulo VI todo dedicado operao do editor
interno do GAS-Pro (EP-Jr).
Como preparar o arquivo gabarito do manual
Este arquivo ser utilizado como gabarito durante a
criao do manual da aplicao final (manual do
usurio).
Algumas regras devem ser observadas para a
construo correta deste arquivo:
Largura do texto
Mantenha um mximo de 72 caracteres por
linha, para que o manual se fixe, com folga, em
um papel de 80 colunas, facilitando a
distribuio das telas inseridas.
Nome do sistema (definido com ???)
Dentro do texto do gabarito, coloque ??? onde
desejar que o nome da aplicao seja substitudo
(a partir de 3 caracteres). Por exemplo, se a
aplicao gerada tiver o nome de CADASTRO e
o GAS-Pro encontrar ??? dentro do texto, o
conjunto ??? ser substitudo pelas trs
primeiras letras do nome da aplicao, ou seja:
CAD. As substituies so feitas sempre de
acordo com a quantidade de caracteres ?
encontrada.
Manual do Usuri o
245
Ttulos de captulos (definidos com \)
Um captulo deve ser iniciado com uma barra
invertida \ NA PRIMEIRA POSIO. O que
for escrito aps essa barra, na mesma linha, no
ser considerado como parte integrante do
manual, podendo o restante dessa linha ser
usado como comentrio. Logo abaixo da barra,
dever aparecer o TTULO DO CAPTULO
correspondente, que ser utilizado para a
confeco do ndice de assuntos.
Nomes de telas (definidos com @)
Onde for desejada a impresso de uma tela (veja
como capturar telas mais adiante), coloque um
@ seguido do nome da tela, NA PRIMEIRA
POSIO, como no exemplo a seguir:
@menu1.t
Durante a gerao do manual, se o GAS-Pro no
encontrar o arquivo que contm a tela, deixar um
espao de 24 linhas e colocar somente o nome da tela
neste espao. Se o arquivo que contm a tela existir,
este ser inserido no MANUAL a partir da posio do
@. Procure marcar a posio das telas perto do
incio dos captulos pois, no momento da gerao do
manual, o GAS-Pro testar se a tela caber na folha,
fazendo um salto de pgina se a mesma no se fixar na
pgina atual. A impresso da tela ser feita no atributo
elite (12 caracteres/polegada) e o texto ser
impresso em atributo normal, conforme a impressora
configurada dentro do GAS-Pro. Isto far com que as
telas apaream um pouco mais estreitas do que o resto
do texto, com um aspecto mais proporcional.
Excluses (definidas com ^)
Certas partes do manual-gabarito podem ser
excludas, de acordo com a aplicao que foi
gerada. Esta facilidade possibilita a confeco
Manual do Usuri o
246
de um gabarito bastante completo e, no
momento da emisso, pode-se decidir o que vai
ou no ser inserido no manual. Existem dois
tipos de excluses: as que o GAS-Pro tem
conhecimento pelo que foi definido no projeto e
as que ele no conhece, resultado de deciso de
quem est elaborando o manual.
Texto que o GAS-Pro sabe que no existe no projeto
Para marcar blocos de texto que o GAS-Pro no
deve colocar no manual, por se referirem a
assuntos que no existem no projeto, coloque na
linha anterior ao incio do bloco desejado o
caracter #, NA PRIMEIRA POSIO DA
LINHA, seguido imediatamente de uma das
diretivas a seguir:
Ao final do bloco de texto, insira uma linha
idntica, para o GAS-Pro identificar onde
termina o texto excludo.
Excluindo o texto que o projetista deseja retirar
COM_AJUDATIVA COM_GLOBAL COM_SENHA
COM_EXCLVISI COM_PROTECAO COM_CORES
COM_MOUSE COM_CONFEXCL COM_MAQCALC
COM_BACKUP COM_GRAFICO COM_SOM
COM_EXPORTA COM_REDE COM_DIRTRAB
COM_PACK COM_CONFIG COM_MARCAIMP
COM_CALEND COM_IMPTP COM_SUBORD
COM_FONTEVGA COM_RESTAURA COM_ETIQUETA
COM_PANOFUNDO COM_CONFINCL COM_MENUCENT
COM_CONFCAMPO COM_INDEX COM_VEREL
Manual do Usuri o
247
Para fazer a excluso de um bloco de texto que
decidiu no levar para o manual (mas quer
deixar no gabarito), basta colocar um ^ NA
PRIMEIRA POSIO, seguido de um
comentrio que identifique o bloco que se
deseja, opcionalmente, excluir. Quando o GAS-
Pro encontrar este smbolo, far uma pausa,
mostrar o comentrio e solicitar a confirmao
da excluso. IMPORTANTE NO SE
ESQUECER DE COLOCAR OUTRO ^
tambm na primeira posio do final do bloco a
ser excludo. Se for confirmada a excluso, o
GAS-Pro no levar para o manual o texto
existente entre os caracteres de marcao ^.
Salto incondicional de pgina (definido com |)
Um | na primeira posio da linha provoca um
salto incondicional de pgina no manual
emitido.
Final do arquivo (definido com \00)
O final do arquivo dever ser marcado com
\00, no incio da linha.
Capturando telas
Feito o arquivo-gabarito segundo as regras acima e
com as posies das telas devidamente marcadas com
@nome, capture as telas a imprimir da seguinte
maneira:
Compile e execute o sistema. Antes de executar a
aplicao, rode o programa utilitrio GASCAPT.EXE
fornecido no CD do GAS-Pro e que, no momeno da
instalao, foi colocado no diretrio de trabalho do
GAS-Pro. Quando desejar capturar uma tela, basta
pressionar ALT-C. Esta operao ativa o programa
GASCAPT que far a captura da tela atual. Informe os
nomes das telas capturadas de acordo com os nomes
comeados com @ colocados no arquivo-gabarito
que foi criado.
Manual do Usuri o
248
Para desalocar este utilitrio da memria, basta digitar
GASCAPT /D na linha do DOS.
Imprime listagens
Esta opo permite a impresso formatada, das
listagens dos programas fontes criados para uma
aplicao gerada, mediante a informao do nome do
programa fonte gerenciador da aplicao. Os nomes
dos programas a serem listados sero captados do
arquivo .LNK, de mesmo nome da aplicao, que
gerado juntamente com os programas fontes .PRG.
Se um programa fonte foi modificado manualmente de
modo a fazer um chamado a um programa externo (que
no pertena ao projeto), no se esquea de adicionar
seu nome na lista contida no arquivo .LNK, para que
faa parte da listagem.
A emisso das listagens obedecer ao que estiver
configurado nas opes Configura formulrio e
Parmetros de impresso.
Ajuda da aplicao
Esta opo permite a manipulao do arquivo de ajuda
ao usurio da aplicao final em dois aspectos:
reconstruo do arquivo ndice associado ao arquivo
de ajuda ou
edio do gabarito utilizado para a montagem do
arquivo de ajuda.
Indexa o arquivo de ajuda (SOS)
Logo aps gerar os programas fontes para uma
aplicao, o GAS-Pro gera automaticamente um
arquivo texto com o mesmo nome da aplicao final,
porm, com a extenso SOS. Este arquivo, gerado a
partir do modelo GASPRO.SOS fornecido no CD do
GAS-Pro, contm informaes especficas para cada
situao de operao de aplicaes geradas,
apresentadas quando o usurio pressiona a tecla F1.
Juntamente com este aquivo, o GAS-Pro gera tambm
Manual do Usuri o
249
um outro arquivo indexador de blocos de texto
contidos no primeiro, para permitir o acesso imediato
s informaes pertinentes operao realizada em um
dado momento pelo usurio.
Os arquivos que contm os blocos de texto de ajuda
on-line podem ser modificados livremente, segundo
algumas regras descritas neste captulo, sob o ttulo
Edita ajuda ao usurio. Uma vez modificado, um
arquivo precisa ser reindexado atravs desta opo,
para que os novos blocos de texto se tornem visveis
dentro da aplicao.
Edita o arquivo gabarito de ajuda
Esta opo d acesso ao editor interno do GAS-Pro
para a edio do arquivo gabarito GASPRO.SOS,
utilizado na montagem da ajuda on-line da aplicao
final.
O captulo VI todo dedicado operao do editor
interno do GAS-Pro (EP-Jr).
Como construir o arquivo de ajuda da aplicao
O arquivo de ajuda para a aplicao final pode ser
criado a partir do arquivo gabarito fornecido no CD do
GAS-Pro e que colocado dentro do editor. Cada
bloco de texto iniciado por \nnn corresponde ao
texto de ajuda nmero nnn (que o valor de uma
varivel pblica de nome COD_SOS criada nos
programas fontes gerados para a aplicao). O texto
que aparecer na janela quando o usurio final da
aplicao pressionar a tecla F1 o bloco de nmero
igual ao valor assumido, naquele momento, por aquela
varivel.
Os seguintes aspectos devero ser observados na
criao deste arquivo de ajuda:
Dever comear na coluna 1 e terminar na 56, ou
seja, o texto dever ter 56 caracteres de largura.
Os smbolos \nnn (barra invertida seguida de um
nmero) so obrigatrios no precisando estar em
seqncia. atravs deles que sero reconhecidas as
Manual do Usuri o
250
marcas de inicio e fim de bloco de texto que devero
ser mostrados, para cada valor da varivel cod_sos,
que pblica dentro dos programas fontes da
aplicao.
O texto que aparece na mesma linha de \nnn no
considerado como integrante do bloco a mostrar,
podendo portanto, ser usado como comentrio.
O nmero mximo de blocos de texto 120. Se
forem criados mais de 120 blocos, os mesmos sero
desconsiderados.
Troca nome da moeda
Ativando esta rotina, o GAS-Pro trocar o nome da
moeda circulante que se encontra nas bibliotecas
fornecidas no CD do GAS-Pro, bastando que seja
informado o nome da nova moeda (no singular e no
plural).
Nome da moeda (singular e plural)
Para que o GAS-Pro substitua o nome da moeda
dentro da biblioteca de funes, necessrio que o
nome da nova moeda seja informado, exatamente como
reproduzida pela funo EXT( ), no singular e no
plural.
Retira rotinas e diretivas
Esta opo efetua o enxugamento dos progragramas
fontes gerados para a aplicao. As rotinas especiais
configuradas para serem geradas, na realidade, so
sempre colocadas nos programas fontes e cerceadas do
programa compilador (CA-Clipper) atravs da
utilizao de diretivas de pr-processamento (#ifdef,
#ifndef, etc). O que esta rotina realiza, a retirada
definitiva de dentro dos programas, dos comandos que
compoem as rotinas que no possuam diretivas de pr-
processamento (#define).
Manual do Usuri o
251
Um nome de projeto ser solicitado pelo GAS-Pro.
Backup de projeto
Um projeto do GAS-Pro constitudo de diversos
arquivos que so utilizados para a gravao e
recuperao de informaes. Esses arquivos so,
segundo a sua extenso, utilizados para diversos fins.
Alguns exemplos de extenses de arquivos vinculados
a um projeto:
.PRO, .ATR, .FOR, .CAB, .PRG, .ED, .REL, .SOS,
.MAN, .RMK, .LNK, .SGR, .GLO, .CEX, CLP, etc...
Se dois ou mais projetos foram gerados em um mesmo
diretrio, pode ser um pouco complicado fazer a
separao manual dos arquivos que pertencem a um
projeto e aos outros. Esta opo faz esta separao,
copiando para um drive ou diretrio informado, todos
os arquivos que pertencem a um determinado projeto.
Esta opo serve tambm para fazer a restaurao de
um projeto atravs da sua cpia de backup.
A processo de backup feito utilizando-se rotinas de
compactao do prprio GAS-Pro, compatveis com o
formato .ZIP. Todos os aquivos do projeto so
compactados dentro de um nico arquivo de mesmo
nome do projeto e com a extenso .GAS.
Edita fontes de vdeo VGA
Esta opo, disponvel somente em monitores de vdeo
padro VGA, d acesso ao editor de fontes de
caracteres para alterao e criao de novos conjuntos
de caractereres para serem utilizados pelo GAS-Pro e
pelas apliaes geradas.
Manual do Usuri o
252
Edita fonte existente
Atravs desta opo possvel selecionar uma fonte
qualquer j existente no arquivo VGALIB.FTS
(biblioteca de fontes) para modificar seus caracteres.
Seleo da fonte a editar
Seleciona a fonte de caracteres que deseja editar.
Utilize as setas (cima/baixo) para mover a barra
seletora para a fonte desejada e pressione ENTER. A
tecla ESC serve para cancelar esta operao. Se estiver
utilizando um mouse, basta aplicar um duplo clique
com o boto esquerdo duas vezes sobre a opo. A
fonte denominada N-Icones a mesma fonte normal
(que aparece quando nenhuma fonte est sendo usada)
porm com cones para serem usados como
identificadores de mdulos dentro da rvore do
projeto.
Caracter a editar
Digite o caracter que deseja colocar na janela para ser
editado.
A tecla F8 pode ser usada para capturar caracteres do
menu.
A tecla F10 permite fazer a importao de caracteres
de uma outra fonte da biblioteca, para a fonte em
edio. Ao acionar esta opo, dever ser informado:
Nome da fonte a importar
Selecione uma fonte que ir fornecer caracteres para a
fonte que est sendo editada. Utilize as setas (cima/
baixo) para mover a barra seletora para a fonte
desejada e pressione ENTER. A tecla ESC serve para
cancelar esta operao. Se estiver utilizando um
mouse, basta aplicar um duplo clique com o boto
esquerdo duas vezes sobre a opo.
Manual do Usuri o
253
Caracter inicial
Selecione o caracter a ser copiado para a fonte que est
sendo editada. Este caracter escolhido somente o
caracter inicial de uma sequncia de caracteres que
podem ser copiados de uma s vez. Utilize as setas
(cima/baixo) para mover a barra seletora para o
caracter desejado e pressione ENTER. A tecla ESC
serve para cancelar esta operao. Se estiver utilizando
um mouse, basta aplicar um duplo clique com o boto
esquerdo duas vezes sobre a opo desejada. Pode-se
tambm selecionar caracteres desta janela digitando o
seu cdigo ASCII diretamente.
Quantidade a importar
Informe a quantidade de caracteres que devero ser
copiados para a fonte que est sendo editada, a partir
do caracter escolhido como inicial (inclusive ele).
Edio de caracteres
Utilize as setas para movimentar o cursor para a
posio desejada. Para marcar ou apagar o desenho do
caracter, utilize ESPAO, ENTER ou a tecla 5 (central
do teclado numrico). A tecla ESPAO funciona um
pouco diferente das outras duas, pois ela movimenta o
cursor uma posio frente enquanto a tecla ENTER e
o 5 deixam o cursor na mesma posio. O mouse
tambm pode ser utilizado para desenhar ou apagar
marcas no caracter.
A tecla F8 serve para carregar um caracter qualquer da
mesma fonte, para ser usado como base da criao do
caracter que est sendo editado.
A tecla F9 pode ser usada para trocar o caracter de
marcao dentro da janela de edio.
Quando terminar de editar o caracter, pressione a tecla
ESC e confirme a sua gravao.
Manual do Usuri o
254
Cria nova fonte
Esta opo permite a criao de um novo conjunto de
caracteres para ser adicionado na biblioteca
VGALIB.FTS, podendo ser usada posteriormente,
tanto no GAS-Pro quanto nas aplicaes geradas.
Duas perguntas devem ser respondidas antes da edio
da nova fonte:
Nome da fonte a ser criada
Informe um nome para identificar a nova fonte a ser
criada. Lembre-se de que este nome ir constar nos
menus apresentados pelo GAS-Pro e pelas aplicaes
geradas, quando a opo de troca de fontes de
caracteres for requisitada.
Fonte base para a criao
Selecione uma fonte qualquer dentre as existentes para
servir como base para a criao da nova fonte.
Lembre-se de que a fonte N-Icones a mesma fonte
Normal (original do seu micro) com a diferena de
que alguns caracteres foram editados para servirem de
cones na rvore do projeto.
Apaga fonte
Esta opo permite a retirada de um conjunto de
caracteres dentro da biblioteca VGALIB.FTS.
Selecione a fonte de caracteres que deseja retirar e
confirme a sua retirada.
Gera disquete de instalao
Esta opo permite a criao de um kit de instalao
de uma aplicao gerada. No disquete de instalao
criado um programa executvel de nome
INSTALAR.EXE que dever ser executado para
desencadear o processo de instalao da aplicao
final no equipamento do usurio. Todos os arquivos
Manual do Usuri o
255
necessrios ao perfeito funcionamento da aplicao
so colocados no disquete, de forma compactada
atravs de rotinas internas do GAS-Pro, compatveis
com o formato .ZIP, sendo descompactados no
momento da instalao atravs das rotinas que o GAS-
Pro coloca dentro do utilitrio de instalao
(INSTALAR.EXE) que criado no disquete. Algumas
perguntas devem ser respondidas:
Nome do projeto
Informe o nome do arquivo que contm as informaes
relativas ao projeto para o qual se deseja criar o kit de
instalao.
Drive de instalao
Informe a letra do drive no qual ser colocado um
disquete formatado para receber os programas e
arquivos necessrios instalao da aplicao. O
GAS-Pro verificar o espao disponvel neste disquete
e colocar mensagem de alerta, caso no exista o
espao mnimo recomendvel. Se o disquete j contm
uma instalao desta mesma aplicao, selecione
Prosseguir a partir do menu apresentado pois, os
arquivos existentes sero sobrepostos.
O kit instalao s poder ser criado em disquetes de
1.2 Mbytes ou 1.4 Mbytes.
Opes do programa instalador
Algumas opes podem ser especificadas para a
criao do kit de instalao:
Instalar fontes
Se desejar instalar tambm os programas fontes da
aplicao no equipamento do usurio, informe S. Os
programas fontes aqu referidos no incluem os
arquivos de controle do projeto. Somente os arquivos
Manual do Usuri o
256
fontes do CA-Clipper e os necessrios para executar a
compilao (.LNK, .RMK) so colocados no disquete,
em um subdiretrio de nome \FONTES.
Mensagens
Entre, se desejar, com as mensagens para serem
mostradas ao usurio.
Utilize o caracter | para forar a quebra de linhas
dentro das mensagens.
A mensagem inicial ser exibida antes que o processo
de instalao tenha incio. A mensagem final ser
mostrada logo aps o trmino do processo de
instalao. Estas mensagens aparecero em uma janela
centralizada na tela. No coloque mais de 20 linhas
nem deixe mais de 72 caracteres entre um | e outro
para que as linhas se fixem corretamente na janela.
Alm das mensagens inicial e final, informe tambm,
se desejar, uma mensagem para ser mostrada ao
usurio enquanto o processo de instalao estiver
sendo feito. No coloque mais de 10 linhas nem deixe
mais de 72 caracteres entre um | e outro para que a
linha se fixe corretamente na janela.
Comandos no AUTOEXEC.BAT
Especifique, separados por | , quais os comandos que
deseja adicionar ao arquivo AUTOEXEC.BAT no
equipamento onde esta aplicao ser instalada.
Outros arquivos
Especifique , separados por | , quais os arquivos que
deseja tambm instalar no equipamento do usurio.
Esses nomes de arquivos podem conter o drive e path,
pois, do contrrio, sero procurados no diretrio do
projeto. Cuidados devem ser tomados com o tamanho
desses arquivos j que o utilitrio instalador criado
pelo GAS Pro assume que somente um volume ser
utilizado.
Manual do Usuri o
257
Nome da seo outros
Informe uma frase para identificar, no programa
instalador, a seo de outros arquivos a instalar.
Exclui banco de campos
Esta opo permite a visualizao das informaes dos
campos armazenados no banco de campos e, na
oportunidade, possibilita a sua excluso, caso no seja
mais interessante a sua manuteno no banco.
Esta opo til para a retirada do banco, dos campos
especficos de uma determinada aplicao, que tenham
sido adicionados ao banco por estarem presentes em
muitos arquivos daquela aplicao.
Excluindo atributos do banco de campos
Selecione o campo desejado, verifique o seu contedo
e, se julgar desnecessria a sua manuteno no banco
de campos, pressione a tecla DEL. Aps confirmao,
este campo ser retirado do banco.
Descompacta arquivo .DBI
Arquivos de extenso .DBI so arquivos que reunem
diversas imagens de formato PCX (Zsoft - 16 cores),
que so associadas a campos de registros dos arquivos
de dados das aplicaes geradas pelo GAS Pro.
Esta opo permite o desmembramento de todas as
figuras .PCX existentes em um arquivos .DBI. vlido
notar que os nomes originais dos arquivos .PCX no
sero recuperados. O GAS Pro utilizar o prefixo (3
letras iniciais) do nome do arquivo .DBI e apendar
um nmero sequencial para identificar os arquivos.
Manual do Usuri o
258
Configura formulrio
Permite a escolha do tipo de formulrio a ser utilizado
para receber o material a ser impresso. Alm do tipo de
formulrio, possivel tambm a configurao do
nmero de linhas por polegada (densidade de
impresso) e se a compresso ser ativada ou no,
durante a emisso.
Seleo do formulrio a utilizar
Assinale a combinao (colunas, linhas e compresso)
mais adequada para a emisso das informaes em
papel. Esta configurao servir para as listagens de
programas, documentao e do manual do usurio.
Parmetros de impresso
Esta opo permite a configurao de alguns
parmetros para a impresso das diversas
documentaes constantes deste menu. Para marcar e
desmarcar opes basta posicionar a barra de seleo
sobre a opo e pressionar ENTER.
As configuraes acessadas por esta opo so:
Caracteres de controle
Se esta opo estiver assinalada, o GAS-Pro filtrar
durante a impresso, todos os caracteres com cdigo
abaixo de 32 na tabela ASCII, exceto os comandos de
retorno do carro e de alimentao de linha (CR,LF).
Isto significa que nenhum caracter de controle ser
enviado, dentre eles o salto de pgina, cdigos de
negrito, compresso, etc.
Caracteres extendidos
Se esta opo estiver assinalada, os caracteres
extendidos do micro (cdigos ASCII acima de 127),
como por exemplo: , etc, sero enviados
Manual do Usuri o
259
para a impressora. Caso contrrio, o GAS-Pro os
substituir pelos seus correspondentes no acentuados.
Normalmente, todas as impressoras so capazes de
imprimir esses caracteres desde que estejam
configuradas corretamente.
Retrocesso lgico
Alguns caracteres acentuados da lngua portuguesa no
tm uma correspondncia verdadeira com os caracteres
dos micros e impressoras. Por exemplo o A com til
pode aparecer assim (), o E com circunflexo no
tem correspondente, e assim por diante. Se esta opo
estiver marcada, o GAS-Pro ir utilizar a facilidade de
retrocesso do carro da impressora para formar as letras
e acentos necessrios, sempre que encontrar caracteres
acentuados dentro do texto. Neste caso, o (A com
til) seria formado com a seqncia
A+retrocesso+~, etc.
Se estiver desmarcada, o GAS-Pro enviar o
respectivo caracter acentuado sem fazer este
tratamento, sendo uma boa idia sempre que for
necessria a edio do material a ser impresso.
Sada para arquivo
Se essa opo estiver assinalada, o material a ser
impresso ser enviado para um arquivo com o mesmo
nome do projeto, com extenso .PRN que poder,
posteriormente ser impresso em papel, simplesmente
digitando a partir do prompt do DOS:
COPY ARQUIVO.PRN PRN
Se no assinalada, o GAS-Pro enviar o material
diretamente para a impressora conectada, conforme
esteja configurada.
Manual do Usuri o
260
A impresso em arquivo pode ser uma boa idia
sempre que for necessria a edio do material a ser
impresso.
Manual do Usuri o
261
Captulo 6: Operando o
Editor Interno do GAS-Pro
O EP-Jr uma verso light do EP-Pro - Editor de
Programas Profissional, um editor de programas
residente (TSR) com grande capacidade de texto e com
facilidades nicas para edio de programas fontes,
tambm desenvolvido e comercializado pela GAS
Informtica.
O EP-Jr, que s pode ser executado atravs do GAS-
Pro, est dimensionado para suportar textos de at 100
Kbytes com at 2000 linhas de texto, o suficiente para
atender s necessidades de edio dentro do GAS-Pro.
Embora dimensionado em limites bastante inferiores
ao EP-Pro, o editor interno do GAS-Pro mantm uma
grande quantidade de facilidades para a edio de
programas fontes. A seguir esto algumas delas:
formatao automtica da endentao de estruturas
da linguagem CA-Clipper ( DO/WHILE, IF/ELSE/
ENDIF, DO/CASE, etc.);
possibilidade de desenhar diretamente sobre o texto;
posicionamento do cursor diretamente sobre uma
determinada linha cujo nmero tenha sido
informado;
acentuao direta na lngua portuguesa;
suporte completo para ser operado com mouse, caso
exista algum conectado ao micro;
recuperao de linhas apagadas;
restaurao de linha modificada (undo);
captura de nomes de campos diretamente das
especificaes do projeto;
Manual do Usuri o
262
muitas outras a serem detalhadas neste captulo.
A janela de edio do EP-Jr
O EP-Jr s pode ser ativado atravs do GAS-Pro,
atravs da tecla F9, sempre que houver a possibilidade
de edio de um programa fonte, um texto de ajuda,
uma descrio do projeto ou de um subsistema, ou
ainda, para edio do manual de operao da
aplicao. Sempre que for possvel a sua ativao, o
GAS-Pro apresentar na tela uma mensagem avisando
que a tecla F9 pode ser utilizada para tal fim.
Ao ser ativado, o EP-Jr abre uma janela de edio
compreendendo, praticamente, toda a rea da tela,
conforme apresentado na figura VI.1.
Figura VI.1
Elementos da janela de edio
A janela de edio composta de um retngulo que
constitui a rea de trabalho do EP-Jr. Nas bordas
dessa janela esto dispostos alguns caracteres que
servem para orientao quanto a quantidade de
memria, posicionamento do cursor, etc.
Manual do Usuri o
263
Linha de status
a linha superior da janela, onde figuram as seguintes
informaes:
nome do arquivo que est sendo editado;
linha e coluna onde est posicionado o cursor, em
relao ao texto;
conjunto de flags ou indicadores do modo como o
EP-Jr est trabalhando no momento. Os indicadores
que aparecem em letras maisculas esto ligados e
os que aparecem com letras minsculas
desligados. No inicio do conjunto de indicadores
aparece um sinal de igual (=) caso o texto presente
na tela no tenha sido modificado aps a ltima vez
que foi salvo ou gravado. Caso tenha sido
modificado, aparecer o sinal de , indicando
que o texto est diferente da sua ltima verso, ou
seja, foi modificado aps ter sido carregado na
janela de edio. A tabela a seguir mostra o conjunto
de indicadores e os comandos utilizados para
modific-los:
Se um mouse estiver sendo utilizado, estaro ainda
aparecendo dois cones para serem clicados, o primeiro
deles para salvar o texto e o segundo para invocar a
tabela ASCII, de onde podem ser selecionados
caracteres para desenhar no texto.
Indicador Significado Comando
/ = Texto modificado ( ) ou no (=)
F2
A / a Acentuao direta no texto ALT-A
T / t Tabulao automtica CTRL-O-I
C / c Blocos com tratamento colunar CTRL-K-N
I / i Imprimir caracteres extendidos ALT-I
Manual do Usuri o
264
Barras de rolagem
Na borda direita e no canto inferior direito da janela
aparecem as barras de rolagem. Essas barras permitem
a visualizao da relao entre a posio do cursor e a
quantidade de linhas ou colunas que podem ser roladas
na vertical ou horizontal.
Linha de final de arquivo
No final do texto de programa aparece uma linha em
reverso com a frase Final do arquivo, indicando que
o final do texto est exatamente uma linha acima.
Nesta linha tambm figuram duas informaes
adicionais:
o nmero de caracteres totais do texto;
quantidade de caracteres que ainda podem ser
digitados.
Barra de memria
Na linha inferior da janela, do lado esquerdo da tela,
est a barra de memria que permite a visualizao
percentual da quantidade de memria total do buffer de
edio e a quantidade que o texto est ocupando no
momento.
Operao com mouse
Todos os controles do EP-Jr podem ser acionados com
o mouse. A seguir, algumas explicaes do seu
funcionamento.
Um clique no boto direito do mouse funciona como se
a tecla ESC tivesse sido pressionada.
Os comandos a seguir consideram apenas o clique do
boto esquerdo do mouse:
Manual do Usuri o
265
Na linha de status
Sobre o nmero da linha, coloca o cursor em uma
determinada linha como se CTRL-J tivesse sido
acionado;
Sobre qualquer das flags (ATCI), alterna a sua
situao, do mesmo modo como ALT-letra (liga/
desliga);
Sobre o smbolo ou sobre o smbolo , provoca o
salvamento do texto em edio (igual a F2);
Sobre o smbolo , apresenta a janela da tabela
ASCII;
Na barra de rolagem vertical
Nas setas (cima/baixo), movimenta o cursor linha a
linha;
Nas setas maiores (cantos superior/direito e inferior/
direito), move para o inicio e fim do arquivo,
respectivamente;
Em qualquer ponto acima do caracter marcador,
movimenta uma pgina acima (PGUP);
Em qualquer ponto abaixo do caracter marcador,
move uma pgina abaixo (PGDN).
Na barra de rolagem horizontal
Nas setas, movem um caracter para a esquerda ou
direita (^S/^D) respectivamente;
Em qualquer lugar direita ou esquerda do
caracter marcador, move para o fim ou incio da
linha, respectivamente.
Manual do Usuri o
266
Dentro da janela de edio do texto
Posiciona o cursor na posio clicada.
Retido e movimentado na janela de texto
Se movimentado de encontro s bordas da janela de
edio, provocar a rolagem do texto naquela
direo, continuando a marcar o bloco;
Executa a marcao de blocos de texto.
Em menus
Move a barra para a posio clicada. Um segundo
clique, seleciona a opo;
Em caixas de dilogo
Posiciona o cursor na posio clicada.
Movimentao e navegao
O mais importante a se aprender de um editor, como
movimentar o cursor atravs da janela de edio. O
cursor pode ser movimentado utilizando um grupo
especial de caracteres de controle, pressionando e
retendo a tecla CTRL e pressionando uma das teclas A,
S, D, F, E, R, X, C, W e Z. As teclas esto dispostas no
teclado de modo a indicar logicamente o seu uso, como
mostra a figura VI.2.
Manual do Usuri o
267
Figura VI.2
Pressionando-se CTRL-E, o cursor move para cima,
CTRL-D para a direita, CTRL-S para a esquerda e
CTRL-X para baixo. As teclas de setas, PGUP, PGDN,
HOME, END associadas ou no tecla CTRL podem
ser utilizadas para a navegao.
Para movimentar o cursor para uma determinada linha,
basta pressionar CTRL-J e informar o nmero da linha
desejada.
Como inserir texto no editor
Normalmente, quando o EP-Jr invocado de dentro
do GAS-Pro atravs da tecla F9, algum texto j estar
presente na janela de edio, ou por que o arquivo a
editar j existia em disco e foi carregado, ou por que o
GAS-Pro criou algumas informaes como cabealho
de programa ou comentrios elucidativos.
A digitao de texto no editor pode ser feita de dois
modos: insero e substituio. Esses dois modos
podem ser chaveados atravs da tecla INS ou CTRL-
V. O modo corrente pode ser identificado pelo tamanho
do cursor: se tiver o formato de um bloco cheio, o
modo de insero estar ligado; caso contrrio, se o
cursor aparecer somente como dois traos na base das
letras, o modo insero estar desligado, estando, por
conseguinte, funcionando o modo de substituio de
texto.
Manual do Usuri o
268
No modo de insero, como o prprio nome indica,
permite que palavras sejam inseridas sobre o texto
anterior. O texto direita do cursor vai se movendo
medida que novas informaes so digitadas.
O modo de substituio utilizado quando se deseja
apagar o texto sobre o cursor com o que estiver sendo
digitado.
Para estampar a data e hora na posio do cursor,
pressione CTRL-Q-T. Se desejar coloc-la no final do
arquivo, pressione CTRL-Q-O.
Desenhando sobre o texto
O EP-Jr permite o desenho diretamente sobre o texto,
com o auxlio das setas cursoras, ideal para fazer
molduras, linhas de separao, tabelas, etc. Para ativar
o modo desenho, basta pressionar a tecla F5 e escolher
um tipo de moldura a partir do menu. Sempre que
houver um cruzamento de linhas desenhadas, um
conector colocado automaticamente, prevenindo a
descontinuidade do desenho. Atravs da tecla F7
(borracha) pode-se apagar texto utilizando as setas
cursoras.
As linhas desenhadas sempre funcionam em modo de
substituio, mesmo que o modo de insero esteja
ligado. Qualquer tecla pressionada que no seja uma
das setas cursoras, desliga o modo desenho.
A tecla F8 funciona de modo semelhante tecla F5,
com a diferena de que o caracter a ser utilizado no
desenho pode ser selecionado diretamente da tabela
ASCII. A tabela ASCII serve tanto para consultar os
caracteres disponveis no micro quanto para a seleo
do caracter para desenhar. O caracter para desenho
pode ser selecionado atravs das setas (cima/baixo) ou
digitando-se diretamente o seu cdigo ASCII, ou ainda,
atravs do mouse. Alguns caracteres de controle da
tabela ASCII no podero ser selecionados como por
exemplo, o 9 (tab), 13 (retorno de carro) e o 26 (fim de
arquivo).
Manual do Usuri o
269
Operaes com blocos
Na janela de edio do EP-Jr pode-se marcar blocos
de texto. Uma vez marcado, o bloco pode ser movido
ou copiado para outro ponto do texto ou para um
arquivo em disco, impresso ou mesmo apagado
definitivamente do texto. Os blocos podem ser
marcados de duas maneiras distintas: bloco colunar ou
bloco convencional (linear).
Marcando blocos de texto
Para marcar um bloco de texto:
Posicionar o cursor no ponto inicial do bloco
desejado e pressionar a seqncia CTRL-K-B;
Movimentar o cursor para o final do bloco desejado
e pressionar CTRL-K-K;
Marcando bloco em uma linha
Para marcar rapidamente uma linha inteira, basta
posicionar o cursor na linha desejada e pressionar
CTRL-K-L.
Marcando bloco em uma palavra
Do mesmo modo, para marcar somente a palavra que
se encontra sob o cursor, pressione CTRL-K-T.
O texto marcado aparecer em cor diferente do
restante do texto, indicando que o bloco est marcado.
Ligando e desligando o modo de bloco colunar
O modo de bloco colunar pode ser ligado e desligado
pela seqncia CTRL-K-N, sendo tratado de modo
diferente pelo editor. A parte considerada como bloco
Manual do Usuri o
270
fica compreendida entre a diagonal que vai da primeira
marcao segunda marcao. Se o modo de bloco
colunar estiver ligado, a letra C do conjunto de
indicadores da linha de status estar em letra
maiscula.
Copiando
Para copiar um bloco marcado para outro ponto do
texto, basta levar o cursor at este ponto e pressionar
CTRL-K-C.
Movendo
Para mover um bloco (retir-lo de um ponto e lev-lo
para outro ponto do texto), basta levar o cursor para o
ponto de destino e pressionar CTRL-K-V.
Apagando
Para apagar todo o bloco marcado, pressionar CTRL-K-
Y.
Gravando em disco
Para gravar o bloco marcado em um arquivo, basta
pressionar CTRL-K-W e informar o nome do arquivo
onde dever ser gravada a informao.
Carregando do disco
Para carregar um bloco de texto gravado em disco,
basta pressionar CTRL-K-R e informar o nome do
arquivo que contm o bloco a ser carregado.
Manual do Usuri o
271
Imprimindo
Para imprimir um bloco marcado, pressione CTRL-K-
P. Se nenhum bloco estiver marcado, todo o texto ser
impresso. Os caracteres extendidos (cdigos
ASCII>127) que porventura tenham sido utilizados
para desenhar no texto, sero substituidos por pontos
nas posies correspondentes, desde que o indicador
I maisculo esteja aparecendo na linha de status
indicando a filtragem dos caracteres extendidos.
Aps a impresso do bloco, pode-se escolher atravs
de menu se uma linha ou toda uma pgina ser saltada.
Para facilitar a transferncia de informaes entre os
objetos de interface do GAS-Pro, pode-se usar o
clipboard, pressionando as teclas CTRL-O-C para
copiar um bloco marcado e CTRL-O-R para recuperar
este bloco em outro ponto qualquer, como telas,
relatrios, campos ou caixas de dilogo. Maiores
detalhes sobre o funcionamento do clipboard so
encontrados no captulo IV deste manual.
Procura e substituio
O comando de procura e substituio muito til
quando se deseja substituir uma palavra ou frase por
outra dentro do texto. Para requisitar este comando,
basta pressionar a seqncia CTRL-Q-A e informar:
palavra ou frase a ser encontrada no texto
palavra ou frase para substituir a primeira, e,
finalmente,
alguns caracteres combinados entre si, significando:
U Ignorar caixa, ou seja, minsculas sero tratadas como
maisculas
G Procurar globalmente em todo o texto (se no
informado, a procura se dar a partir do cursor).
B rPocurar no sentido do final do texto para o incio
Manual do Usuri o
272
N Substituir sem solicitar confirmao
Encontrando o argumento procurado, o EP-Jr efetua a
substituio automtica caso a opo N tenha sido
especificada. Sem a opo N, o EP-Jr mostra a
palavra encontrada em uma cor reversa e solicita
confirmao da troca, conforme exemplo da figura
VI.3.
Figura VI.3
Se for desejada somente a localizao de uma palavra
ou frase, sem substituio, pode-se utilizar a seqncia
CTRL-Q-F e informar a palavra a ser procurada. Em
ambos os casos, o comando CTRL-L provoca uma
continuidade na pesquisa para encontrar as ocorrncias
subseqentes.
Gravao de textos editados
Quando acionada a tecla F2, o texto existente na janela
de edio gravado em disco, sob o nome informado
quando foi carregado (aparece no incio da linha de
status). Sempre que ocorrer uma tentativa de
abandonar o texto editado sem gravar, o EP-Jr
apresentar um menu oferecendo a gravao ou o
abandono das modificaes.
O EP-Jr tambm lembrar ao seu operador toda vez
que mais de 1000 toques forem dados sem que o texto
tenha sido gravado e, da por diante, a cada 40 toques
at que o texto seja gravado. Isto ajuda a preservar a
Manual do Usuri o
273
integridade da informao digitada. Se for desejada a
gravao do texto, basta pressionar F2.
Capturando nomes de campos de arqui-
vos do projeto
A tecla F10 pode ser utilizada para capturar nomes de
campos existentes nos arquivos DBF definidos no
projeto (subsistemas ou arquivos de parmetros). Um
menu de arquivos apresentado e, aps selecionado o
arquivo, os nomes de seus campos ficam disponveis
para serem selecionados e inseridos no texto, na
posio do cursor.
Formatando texto na estrutura do CA-
Clipper
A endentao automtica de textos de programas
fontes em CA-Clipper pode ser configurada atravs da
tecla CTRL-O-I. Ao ativ-la, um T maisculo
aparece na linha de status, podendo-se informar um
nmero de 1 a 9, respresentando a quantidade de
espaos a serem adicionados esquerda das linhas de
programa.
para formatar todo o texto do programa, pressione
ALT-B;
para formatar somente um pargrafo, posicione o
cursor no incio de uma estrutura (IF/DO WHILE/
FOR, etc.) e pressione CTRL-B. O texto ser
endentado at o comando final que fecha a estrutura
(ENDIF/ENDDO/NEXT).
Manual do Usuri o
274
Criando e inserindo macros
Atravs da tecla F6 pode-se acessar o menu de
macros que, dentro do EP-Jr, so fragmentos de
texto que podem ser inseridos rapidamente dentro do
texto em edio. As macros do EP-Jr podem ser
criadas editando-se um arquivo de nome EPJR.MAC
dentro do diretrio do GAS-Pro. A sua criao
depende de algumas regras bsicas:
colocar o nome da macro (para aparecer no menu)
entre colchetes [ ], a partir da primeira posio da
linha;
nesta mesma linha podero, opcionalmente, ser
colocadas a linha e a coluna onde o cursor dever
estacionar aps a insero da macro. Esses dois
parmetros, se especificados, devero estar
igualmente entre colchetes [ ] e separados por
vrgula. A linha e coluna aqui especificadas se
relacionam macro que vai ser inserida, e no com o
texto em si.
nas linhas seguintes deve ser colocado o contedo da
macro.
O arquivo EPJR.MAC pode conter diversas macros
agrupadas, desde que as regras sejam obedecidas. O
exemplo a seguir mostra como poderiam ser criadas
duas macros, uma para inserir a estrutura IF/ENDIF
dentro do texto e outra para inserir a estrutura IF/
ELSE/ENDIF.
[IF/ELSE/ENDIF] [1,4] isto vai aparecer no menu
IF
ELSE
ENDIF
[IF/ENDIF] neste caso, no foram colocados os
parmetros linha/coluna
IF
ENDIF
Manual do Usuri o
275
No primeiro exemplo, os parmetros de linha e coluna
faro com que, logo aps a insero do fragmento de
programa no texto, o cursor se posicione logo aps o
IF, facilitando a insero de texto complementar.
No segundo exemplo, como no foram passados os
parmetros de linha e coluna, o cursor permanecer na
mesma posio em que se encontrava antes da insero
da macro.
Resumo dos comandos
A tabela a seguir apresenta o resumo de comandos que
podem ser utilizados dentro do editor interno do GAS-
Pro:
MOVIMENTAO DO CURSOR
Tecla Alternativa Efeito obtido
Ctrl-D Seta para direita Cursor direita
Ctrl-S Seta para esquerda Cursor esquerda
Ctrl-X Seta para baixo Cursor linha abaixo
Ctrl-E Seta para cima Cursor linha acima
Ctrl-C PgDn Move pgina abaixo
Ctrl-R PgUp Move pgina acima
Ctrl-F Crtl-seta para direita Prxima palavra
Ctrl-A Crtl-seta para esquerda Palavra anterior
Ctrl-Z Rolagem para cima
Ctrl-W Rolagem para baixo
Ctrl-J Vai para a linha...
Ctrl-L Procura prxima palavra
Ctrl-I Move para prxima tabulao
Ctrl-Q-R Move para incio do texto
Manual do Usuri o
276
Ctrl-Q-C Move para o final do texto
Ctrl-Q-E Move para incio janela edio
Ctrl-Q-X Move para final janela edio
Ctrl-Q-S Move para o incio da linha
Ctrl-Q-D Move para o final da linha
MOVIMENTAO DO CURSOR
INSERO E APAGAMENTO
Ctrl-Y Apaga a linha do cursor
Ctrl-U Recupera linha apagada
Ctrl-H Retrocesso Apaga caracter esquerda
Ctrl-G DEL Apaga caracter sob cursor
Ctrl-T Apaga palavra
Ctrl-N Insere CR no cursor
Ctrl-V INS Liga/desliga insero
MISCELNIA
F1 Apresenta ajuda on-line
F2 ^KD/^KS Grava o texto do editor
F5 Desenha molduras
F6 Insere macro comando no texto
F7 Desenha com borracha (apaga)
F8 Desenha com caracter escolhido
F10 Captura campo do arquivo DBF
Manual do Usuri o
277
Alt-A Liga/desliga acentuao
Alt-B Formata arquivo na estrutura do CA-Clipper
Alt-I Liga/desliga impresso ASC>127
Ctrl-B Formata pargrafo na estrutura CA-Clipper
5 (Keyword) Copia caracteres da linha acima
Crtl-O-I Liga e ajusta tamanho tabulao
MISCELNIA
COMANDOS DE BLOCOS
Ctrl-K-B Marca incio de bloco
Ctrl-K-K Marca final de bloco
Ctrl-K-C Copia bloco
Ctrl-K-V Move bloco
Ctrl-K-Y Apaga bloco
Ctrl-K-P Imprime bloco
Ctrl-K-N Alterna bloco normal/colunar
Ctrl-K-T Marca bloco de palavra
Ctrl-K-L Marca bloco na linha inteira
Ctrl-K-H Exibe/esconde marcaes de bloco
Ctrl-K-W Grava bloco de texto em disco
Ctrl-K-R L bloco gravado em disco
Ctrl-K-X F2 Grava texto e retorna ao GAS-Pro
Ctrl-K-S F2 Grava texto e pemanece editando
Ctrl-K-Q ESC Abandona texto e retorna ao GAS-Pro
Ctrl-O-C Copia bloco para o clipboard
Manual do Usuri o
278
Ctrl-O-R Carrega bloco do clipboard
COMANDOS DE BLOCOS
PROCURA/SUBSTITUIO
Ctrl-Q-F Procura palavra
Ctrl-Q-A Procura e substitui
Ctrl-Q-Y Apaga linha a partir cursor
Ctrl-Q-T Estampa data/hora no cursor
Ctrl-Q-O Estampa data/hora final texto
Manual do Usuri o
279
Manual do Usuri o
280
Captulo 7: Um Exemplo
Prtico
Para complementar o Captulo V - Operando o GAS-
Pro, nada melhor do que um exemplo prtico. Neste
captulo ser demonstrada a utilizao efetiva do
GAS-Pro na gerao de um sistema exemplo de
Controle de Estoques elaborado para efeitos
didticos sendo, porm, completamente funcional.
O acompanhamento passo a passo deste exemplo
proporcionar subsdios para uma utilizao mais
eficiente do GAS-Pro. Recomendamos que as pessoas,
mesmo com prtica em programao, sigam os passos
para a execuo desta aplicao para ganhar tempo no
conhecimento dos diversos recursos disponveis.
O sistema de controle de estoques foi escolhido como
exemplo porque, pelas suas caractersticas,
proporcionar o aprendizado de diversos recursos de
gerao do GAS-Pro, como por exemplo, a definio
de processamentos, lanamentos, campos no
editveis, relatrios, etiquetas, plano de senhas, etc.
O primeiro passo para a criao de um novo projeto de
sistema a sua concepo, como desejamos que
funcione, o que vai fazer e o que no vai fazer.
Existem diversas metodologias para o
desenvolvimento de projetos de sistema e seria
impossvel, neste manual, discorrer sobre qualquer
uma delas, mesmo porque, no nosso objetivo.
Qualquer que seja a metodologia empregada, o GAS-
Pro ser sempre uma ferramenta de valor inestimvel
para a construo da aplicao final.
Vamos comear entendendo como nosso exemplo de
sistema de estoque ser estruturado.
Manual do Usuri o
281
Nossa aplicao exemplo manipular 8 arquivos de
dados DBF. Nas explicaes seguintes, a sigla NF
significar Nota Fiscal.
Entrada de produtos em estoque
ser feita mediante a digitao da NF do fornecedor
(NOTAS.DBF);
medida que os itens de produtos da NF so
digitados (ITENS.DBF), as quantidades recebidas
sero creditadas no estoque (PRODUTOS.DBF) e o
valor do item ser acumulado no valor total da NF
(NOTAS.DBF);
criaremos uma tela complementar para o arquivo
PRODUTOS.DBF para fazer ajustes de quantidades,
a digitao do inventrio inicial; ou seja, o arquivo
Arquivo Contedo
NOTAS.DBF Dados genricos da NF do fornecedor
ITENS.DBF Itens digitados de cada NF
SAIDAS.DBF Baixas
PRODUTOS.DBF
Dados dos produtos em estoque, suas quan-
titidades, preo unitrio, percentual de lucro
para clculo do preo de venda, etc
FNDPROD.DBF
Dados de fornecedores por produto, para
controlar mais de um fornecedor para um
determinado produto
FORNEC.DBF
Tabela contendo os dados dos fornecedores
de produtos
INDEXAD.DBF
Tabela contendo informaes de um indexa-
dor financeiro qualquer para clculo de preo
de venda (por exemplo, dlar)
PAR_ESTO.DBF
Um nico registro, sem qualquer ndice
associado, para armazenar parmetros do
sistema
Manual do Usuri o
282
PRODUTOS.DBF poder ser acessado por duas telas
diferentes, em dois pontos distintos da aplicao.
Sada de produtos (baixas)
ser feita em um mdulo separado, mediante a
digitao do cdigo do produto, valor e a
quantidade- que est saindo do estoque;
Relatrios
faremos apenas alguns relatrios para exemplificar
os passos necessrios para a sua construo.
Posteriormente, mais relatrios podero ser criados e
anexados ao sistema;
a. tabela de preos, contendo os produtos em
estoque e o seu preo de venda, de acordo com o
percentual de lucro esperado;
b. produtos em ponto de pedido, ou seja, a
listagem dos produtos que esto com estoque
abaixo da quantidade mnima estabelecida;
c. notas fiscais recebidas, contendo a listagem
das notas fiscais de fornecedores que foram
digitadas como entrada de mercadoria. Este
relatrio exemplificar a emisso de arquivos
relacionados (pai/filho) em um mesmo relatrio;
d. finalmente, formataremos uma etiqueta com
dados do produto, para fixao em prateleiras.
Grficos
ser feito apenas um grfico mostrando a evoluo
dos valores das sadas de cada produto no ms. Na
gerao deste mdulo, utilizaremos tambm o
Manual do Usuri o
283
recurso de criao de uma tela de variveis
complementares para receber o ano de referncia do
grfico.
Conhecemos alguns aspectos do funcionamento do
nosso sistema de estoque. Agora, vamos iniciar a sua
criao. Durante a criao desta nossa aplicao
exemplo, sempre que surgir alguma dvida, pressione
a tecla F1 para obter ajuda adicional.
Nas explicaes que se seguem, sempre que aparecer o
smbolo ^ seguido de uma letra, significa que a tecla
CTRL deve ser pressionada e retida e a letra
pressionada em seguida.
Inicialmente, vamos nos posicionar dentro do diretrio
do GAS-Pro e digitar GAS, seguido da tecla ENTER.
CD\GASPRO40
GAS [Enter]
A partir do menu principal do GAS-Pro, selecione a
opo PROJETO e informe o nome do projeto a ser
criado. Crie um projeto de nome ESTOQUE, no
subdiretrio ESTOQUE, abaixo do diretrio do GAS-
Pro, conforme aparece na figura VII.1.
Figura VII.1
Manual do Usuri o
284
Se o diretrio C:\GASPRO40\ESTOQUE no existir, o
GAS-Pro pede uma confirmao para a sua criao ou,
se for o caso, a informao de um outro nome.
Selecione a opo Criar o diretrio para que o GAS-
Pro crie este diretrio para armazenar o projeto.
A seguir, o GAS-Pro solicita tambm uma
confirmao para a criao do novo projeto
ESTOQUE. Selecione Criar o novo projeto.
Quando iniciamos a definio de um novo projeto,
informamos os seus dados genricos. Essas
informaes sero utilizadas em cabealhos de
programas fontes, relatrios, telas, etc.
Nome da empresa
Informe o nome da empresa ou usurio da
aplicao a ser gerada. O GAS-Pro apresenta
como default o nome da empresa/usurio
definido na opo Configurao do seu menu
principal.
Ttulo da aplicao
Informe o ttulo da aplicao que, neste
exemplo, ser Controle de Estoques.
Nome do projetista
Informe o seu nome como responsvel pelo
desenvolvimento do projeto.
Cdigo da ajuda
Informe o nmero (contexto) correspondente ao
bloco de ajuda que ser apresentado no menu
geral da aplicao. Pressione ENTER nesta
informao, deixando o nmero informado pelo
prprio GAS-Pro (o nmero 3 j est associado
ajuda correspondente ao menu geral da
aplicao).
Manual do Usuri o
285
Essas informaes podem ser alteradas mais tarde,
durante a elaborao do projeto, conforme veremos
mais adiante.
As informaes referentes a este projeto so gravadas
em um arquivo de nome ESTOQUE.PRO dentro do
diretrio C:\GASPRO40\ESTOQUE. Para verificar a
existncia deste arquivo, pressione ALT-F2. Estamos
agora a nvel do DOS (shell). Digite DIR
C:\GASPRO40\ESTOQUE\*.*, tecle ENTER e
verifique que o GAS-Pro j gravou parte das
especificaes do projeto neste arquivo. No decorrer
da elaborao do projeto, diversos arquivos sero
criados para armazenar outras informaes de
controle.
Esta facilidade do GAS-Pro, atravs da tecla ALT-F2,
nos coloca diretamente no ambiente do DOS sem
haver, contudo, perda de definies.
Algumas recomendaes importantes:
utilize esta facilidade somente se precisar,
momentaneamente, executar algum comando do
DOS, como por exemplo, renomear, apagar, copiar
um arquivo, executar um programa, etc.;
lembre-se que o GAS-Pro continua na memria.
Portanto, programas extensos no tero memria
suficiente para serem executados;
jamais execute programas do tipo TSR (programas
que ficam residentes na memria). Isto poder
comprometer o funcionamento do GAS-Pro.
quando desejar retornar ao GAS-Pro, digite EXIT
seguido da tecla ENTER.
Aps a entrada das informaes referentes aos dados
genricos do projeto, o GAS-Pro apresenta o menu
intitulado MODELADOR DO PROJETO, conforme
figura VII.2.
Manual do Usuri o
286
Figura VII.2
Toda a modelagem da aplicao feita a partir deste
menu. As opes que nele aparecem, representam toda
a hierarquia de mdulos da aplicao a ser criada
(rvore hierrquica). Observe que algumas opes j
foram inseridas como sugesto. O captulo V detalha
todo o seu funcionamento de modo que, para o nosso
exemplo, vamos abordar somente o necessrio para a
modelagem do projeto ESTOQUE.
A disposio dos mdulos no modelador do projeto
est verticalizada. Para compreender melhor esta
disposio, reporte-se ao incio do captulo II, tpico
Componentes de um projeto definido atravs do
GAS-Pro.
Vamos selecionar as rotinas que desejamos colocar na
nossa aplicao. Selecione CONTROLE DE
ESTOQUES e pressione ENTER e um segundo menu
aparecer. A primeira opo Dados genricos ns j
informamos quando iniciamos o projeto. Vamos
selecionar Rotinas especiais, para obter o menu
correspondente tela da figura VII.3.
Manual do Usuri o
287
Figura VII.3
Este menu apresenta rotinas que desejamos ter na
aplicao. As rotinas marcadas com sero levadas
para os programas fontes e as desmarcadas no sero
geradas. Para marcar e desmarcar uma rotina, basta
colocar a barra seletora sobre ela e pressionar ENTER.
Cabe ressaltar que esse menu apresenta rolagem,
pois, por motivos espaciais, as 27 rotinas especiais
no podem ser apresentadas ao mesmo tempo.
Para este exemplo, faa uma configurao igual que
aparece na tela da figura VII.3. A opo Vdeo 50
linhas s estar disponvel se o monitor do micro
onde a aplicao est sendo gerada utiliza placa padro
VGA/SVGA. Para fazer uso desta opo, o projetista
dever saber se o micro onde a aplicao ser
executada possui tambm este padro. Qualquer
dvida que se tenha a respeito de qualquer uma dessas
rotinas, basta colocar a barra sobre a mesma e
pressionar a tecla F1 para obter ajuda adicional.
A seguir, criaremos uma tela de apresentao ou
cabealho para a nossa aplicao. Nesta tela
poderemos colocar informaes do projeto bem como
desenhar logotipos. Selecione Cabealho da
aplicao a partir do menu Definio do projeto e
construa uma tela semelhante que aparece na figura
VII.4.
Manual do Usuri o
288
Figura VII.4
O cabealho que o GAS-Pro sugere como default
aparece no topo da tela. Pressione CTRL-Y para apagar
as informaes nela posicionadas.
Para o nosso exemplo, colocamos o nome de uma
empresa fictcia. A movimentao da janela feita
pressionando F9 e utilizando as setas e CTRL-setas. O
mouse, se existir, pode tambm ser utilizado, clicando
e arrastando as bordas da janela. As variveis de
sistema so capturadas do menu acionado por F6 e
posicionadas com as setas (ou mouse), seguidas de
ENTER. Pressione ALT-E para digitar letras
expandidas. A interrupo da utilizao desse tipo de
letra tambm feita pressionando ALT-E.
Aps confeccionar o cabealho, pressione ESC e
selecione Salvar, para que o cabealho seja salvo
nos arquivos de controle do projeto.
Como o GAS-Pro trabalha em um Ambiente de
Desenvolvimento Integrado (IDE), podemos, medida
que executamos o projeto, ir fazendo a sua
documentao tcnica e de usurio. Selecione
Descrio do projeto e verifique que o GAS-Pro j
tem preparada uma planilha com informaes do
projeto inseridas automaticamente, faltando apenas
complementar algumas informaes de natureza
particular, utilizando o editor interno do GAS-Pro.
Assim como para o projeto, para cada subsistema
(DBF) da aplicao, poderemos complementar
planilhas semelhantes, que faro parte do projeto
Manual do Usuri o
289
fsico, que o GAS-Pro emite automaticamente, por
seleo de menu. Digite ESC para retornar ao menu.
As aplicaes geradas pelo GAS-Pro tambm j vo
automaticamente com ajuda on-line sensitiva ao
contexto, para auxiliar a sua operao pelo usurio
final. O arquivo utilizado para esta ajuda pode ser
modificado, se necessrio, atravs da opo Edita
ajuda ao usurio do menu DEFINIO DO
PROJETO. Selecione esta opo e verifique que o
GAS-Pro coloca dentro do editor, o arquivo que
contm o texto de ajuda para o usurio. Outra maneira
de se alterar o texto de ajuda pressionar a tecla F9
quando o GAS-Pro estiver solicitando a entrada do
cdigo da ajuda, o que ocorre em vrios pontos dentro
do projeto.
O editor interno do GAS-Pro (EP-Jr), um editor
bastante verstil e fcil de utilizar. Sua operao est
detalhada no Captulo VI deste manual.
No h necessidade de modificar este texto de ajuda.
Pressione a tecla ESC para abandonar e retornar ao
menu anterior, de onde vamos prosseguir a modelagem
do nosso projeto.
Pressione novamente ESC para retornar ao modelador
do projeto. Vamos comear a modelagem do nosso
sistema aplicativo inserindo os mdulos necessrios ao
seu funcionamento. O GAS-Pro j sugeriu toda a parte
de APOIO, ou seja, os mdulos de backup,
configurao, senhas, etc. Sabemos que, se no
desejarmos alguns desses mdulos, basta posicionar a
barra seletora sobre ele e pressionar DEL, confirmando
a sua excluso. Para o nosso exemplo, vamos utilizar
todos eles.
Posicione a barra seletora sobre o ttulo do projeto e
pressione INS.
A regra para a modelagem do projeto iniciar a
insero dos subsistemas de tabelas pois,
normalmente, os outros arquivos (cadastros) se
relacionam com elas.
Vamos inserir na rvore uma opo de menu sob a qual
colocaremos as duas tabelas do projeto, ou seja, a
Manual do Usuri o
290
tabela de FORNECEDORES e a tabela de
INDEXADORES.
Observe que o mdulo Apoio est diretamente
ligado ao ttulo do projeto. Isto significa que todo
mdulo inserido com a barra posiconada no ttulo do
projeto (como fizemos agora), ficar hierarquicamente
no mesmo nvel do Apoio e constando do menu
principal da aplicao.
A insero do novo mdulo feita a partir do menu
que aparece na figura VII.5.
Figura VII.5
Este menu apresenta os tipos de mdulos a serem
inseridos no nosso projeto. Como desejamos inserir um
menu, selecione a primeira opo: Menu e informe a
frase que aparecer no menu principal da nossa
aplicao.
Lembre-se que o mdulo que acabamos de inserir
ficar diretamente ligado ao ttulo do projeto
(aparecer no menu principal). Responda pergunta
Ttulo para menu com a palavra Tabelas.
Para o item Nvel de acesso, selecione a opo
Operao a fim de disponibilizar acesso a todos os
operadores do sistema, valendo-se de tal restrio no
item Condio para menu que dever ficar em
branco.
Para a pergunta Cdigo da ajuda, pressione ENTER
para aceitar a sugesto (4) do GAS-Pro. A questo
Manual do Usuri o
291
referente figurao no menu poder ser suprida com
a alternativa Sim.
Escolha a posio deste novo mdulo na rvore do
projeto, atravs do menu que aparece na tela da figura
VII.6.
Figura VII.6
Este menu permite a escolha da posio de insero do
novo mdulo na rvore do projeto. Duas opes esto
disponveis: se selecionar o ttulo do projeto, este
mdulo ser inserido imediatamente abaixo dele. Por
outro lado, se selecionar Apoio, este novo mdulo
ser inserido na ltima posio da rvore. Vamos
inserir este mdulo logo abaixo do ttulo do projeto,
portanto, pressione ENTER sobre ele. A sua tela
dever estar igual que aparece na figura VII.7.
Figura VII.7
Manual do Usuri o
292
At aqui, criamos uma opo de menu para agrupar as
tabelas da aplicao. Agora, com a barra seletora sobre
Tabelas, pressione a tecla INS para inserir a primeira
tabela.
Atravs do menu TIPO DE MDULO A INSERIR,
selecione Subsistema (DBF)
Neste momento o GAS-Pro nos oferece trs opes.
Selecione Definir um novo subsistema.
Alm da tecla F1 para apresentar ajuda de operao, o
GAS-Pro e os sistemas por ele gerados possuem um
recurso chamado Ajuda ativa que pode ser ligado e
desligado pressionando ALT-F1. Pressione esta tecla
para deixar esta ajuda ligada durante a execuo deste
exemplo.
Cada subsistema inserido no projeto tem os seus dados
genricos. Informe-os conforme a seguir:
Arquivo (DBF).....: FORNEC
Ttulo cabealhos: Tabela de fornecedores
Ttulo abreviado...: Fornecedores
Cdigo da ajuda...: 5
Condio p/ menu: Em branco
Tecla de atalho.....: Nenhuma
At aqui, fizemos a insero de um mdulo
subsistema na nossa rvore. Agora, precisamos
defin-lo adequadamente. Selecione o mdulo
Fornecedores e pressione ENTER. A tela da figura
VII.8 ser apresentada.
Manual do Usuri o
293
Figura VII.8
Este menu nos permite a definio completa de um
subsistema de arquivo DBF. A opo Dados
genricos j foi informada quando inserimos esse
subsistema. Contudo, se pressionarmos ENTER sobre
esta opo podemos modificar o que informamos
anteriormente.
Vamos selecionar Opes e definir algumas opes
de gerao. Normalmente, o que o GAS-Pro sugere
nos servir em quase todas as oportunidades.
Pressione ESC para retornar ao menu anterior e vamos
definir como ficar o menu deste subsistema.
Selecione Menu do subsistema e pressione ENTER.
O GAS-Pro j nos sugere as opes de Incluso,
Manuteno e Consulta. Vamos aceitar esta sugesto.
No entanto, vamos verificar o que poderamos fazer
aqui. Pressione a tecla INS. A tela da figura VII.9 ser
apresentada.
Manual do Usuri o
294
Figura VII.9
Observe que podemos tambm modelar este menu com
algumas opes a mais, bastando selecionar a opo
desejada. Neste subsistema no vamos inserir outras
opes no menu do subsistema; por isso, pressione
ESC para voltar ao menu anterior.
Poderamos tambm, ao invs de inserir novas opes,
apagar as que foram sugeridas pelo GAS-Pro (tecla
DEL). Por exemplo, se retirarmos todas as opes
deste menu, mesmo assim o GAS-Pro faria a gerao
deste arquivo, sem possibilidade de acesso; porm
podendo servir de alvo de lanamentos e
processamentos externos a partir de outros arquivos.
Se desejarmos, podemos alterar a frase que ser
apresentada no menu, bem como o bloco de texto de
ajuda para esta opo, pressionando ENTER sobre
qualquer delas e escrevendo a nova frase. Neste caso,
vamos deixar como est e prosseguir a definio
pressionando ESC para retornar ao menu anterior.
Vamos partir agora para a definio dos atributos
(campos) do arquivo Tabela de fornecedores.
Selecione Definio de atributos (campos) e
pressione ENTER. A tela da figura VII.10 ser
apresentada.
Manual do Usuri o
295
Figura VII.10
O nome do primeiro campo deste arquivo ser o cdigo
do fornecedor. Digite as informaes a seguir
lembrando que a tecla CTRL-Y serve para apagar
contedos de campos:
Nome..............: codigo
Tamanho........: 3
Tipo................: Caracter
N decimais....: 0
Tipo acesso...: Editvel
Mscara.........: ###
Larg. edio...: 3
Ttulo..............: Cdigo
Texto ajuda....: Informe o cdigo do fornecedor
Cmd especial.:
Pr-validao:
Validao.......:
Para a pergunta validao, vamos montar uma
validao simples atravs de menu. Pressione ^Y e F7.
A tela da figura VII.11 ser apresentada.
Manual do Usuri o
296
Figura VII.11
A partir deste menu podemos montar expresses para
validar o campo em definio. Selecione por exemplo,
a primeira opo No vazio e o GAS-Pro colocar
uma funo em CA-Clipper para atender a este critrio,
ou seja, este campo no poder ser vazio quando o
usurio estiver digitando dados na aplicao final.
Prosseguindo, vamos continuar a definio deste
campo ou atributo.
Mensagem: Necessrio informar CDIGO
Observe que o GAS-Pro procura sugerir o que for mais
apropriado. Como sugesto, altere vontade, se
necessrio.
Valor inicial:
Seqncia..:
Pronto! Definimos o primeiro campo do subsistema
(DBF) que colocamos no projeto. Agora vamos
prosseguir com os demais campos.
Aps a definio do primeiro campo, a tela da figura
Manual do Usuri o
297
Figura VII.12
Observe o que aparece no ttulo do menu esquerda da
tela. Podemos utilizar alguns comandos aqui:
Enter permite repassar o que foi informado para o campo
selecionado, e modific-lo, se necessrio;
INS permite a insero de um outro campo, logo abaixo do
que estiver selecionado com a barra seletora;
DEL podemos, com esta tecla, apagar o campo que
acabamos de informar;
F4 esta tecla nos coloca diretamente no mdulo
formatador da tela de digitao (hot-key). Foi aqui
colocada para permitir um rpido acerto de um campo
e seu posicionamento na tela, contudo, ainda cedo
para usarmos este recurso.
F8 esta sim, vamos utilizar agora. Ela nos permite
alimentar um banco de campos com as definies
que vo sendo feitas. Por exemplo, temos grandes
possibilidades de precisarmos, em outro arquivo da
aplicao, da definio de um campo igual a este.
Ento, vamos ganhar um tempo precioso. Pressione F8
e confirme a adio da definio deste campo ao
banco de campos. Posteriormente, com um simples
toque de tecla, vamos capturar esta definio em outro
arquivo de dados.
Pressione a tecla INS para inserir outro campo e
informe:
Manual do Usuri o
298
Nome...............: nome
Tamanho.........: 30
Tipo.................: Caracter
N decimais.....: 0
Tipo acesso....: Editvel
Mscara..........: @!
Larg. edio...: 30
Ttulo..............: Nome do fornecedor
Texto ajuda....: Entre com o nome do fornecedor
Cmd especial.:
Pr-validao:
Validao.......: !EMPT(nome)
Mensagem.....: Necessrio informar NOME DO
FORNECEDOR
Valor inicial....:
Seqncia.......:
Sempre selecionando o ltimo campo definido,
pressione INS e informe os demais campos deste
subsistema.
Nome.............: contato
Tamanho.......: 30
Tipo...............: Caracter
N decimais...: 0
Tipo acesso..: Editvel
Mscara.........: @!
Larg. edio..: 30
Ttulo.............: Contato
Texto ajuda...: Informe o nome da pessoa de contato
Manual do Usuri o
299
Cmd especial.:
Pr-validao:
Validao.......: !EMPT(contato)
Mensagem.....: Necessrio informar CONTATO
Valor inicial....:
Seqncia.......:
Nome.............: telefone
Tamanho.......: 10
N decimais...: 0
Mscara........: @R (999)999-9999
Larg. edio..: 13
Ttulo.............: Telefone
Texto ajuda...: Nmero do telefone para contato
Cmd especial.:
Pr-validao:
Validao.......: !EMPT(telefone)
Mensagem.....: Necessrio informar TELEFONE
Valor inicial....:
Seqncia.......:
Nome............: ramal
Tamanho......: 4
Tipo..............: Caracter
N decimais..: 0
Manual do Usuri o
300
Mscara........: ####
Larg. edio..: 4
Ttulo.............: Ramal
Texto ajuda...: Informe o nmero do ramal, se houver
Cmd especial.:
Pr-validao:
Validao.......:
Mensagem.....:
Valor inicial....:
Seqncia......:
Nome............: fax
Tamanho......: 10
N decimais...: 0
Mscara........: @R (999)999-9999
Larg. edio..: 13
Ttulo.............: Fax
Texto ajuda...: Nmero do FAX do fornecedor
Cmd especial.:
Pr-validao:
Validao.......:
Mensagem.....:
Valor inicial....:
Seqncia......:
Manual do Usuri o
301
Pronto! Acabamos de definir os atributos do
subsistema. Agora, vamos fazer outras definies
importantes.
Pressione ESC para retornar ao menu anterior e
selecione Definio da tela.
O mdulo formatador de telas do GAS-Pro est
provido de diversos recursos, que j foram detalhados
no Captulo V. Para este subsistema, pressione ALT-T
para fazer uma tela padro, conforme a figura VII.13.
Figura VII.13
Pressione ESC e salve a tela. Selecione a opo
Chaves de acesso. Podemos definir at 8 conjuntos
de pesquisa (arquivos ndices associados). No caso
deste subsistema, vamos definir dois conjuntos. Na
definio de um conjunto de pesquisa, informamos um
ttulo para constar no menu da aplicao, e um ou mais
campos, em seqncia, para compor a chave de
indexao do arquivo DBF. Vamos definir o primeiro
deles: informe Cdigo para ttulo de menu e marque
o campo codigo, para servir de chave de indexao.
Pressione ESC para voltar ao menu de conjuntos de
pesquisa e pressione a tecla INS para criar um outro
conjunto. Informe Nome para outro conjunto de
pesquisa, selecione o campo nome e pressione ESC
em seguida.
Aps essas informaes, a tela da figura VII.14 ser
apresentada.
Manual do Usuri o
302
Figura VII.14
Pressione ESC para retornar ao menu anterior.
Como dissemos anteriormente no incio da definio
deste projeto, se desejarmos ir documentando o
projeto, podemos selecionar Descrio do
subsistema e complementar a planilha de descrio do
subsistema, que o GAS-Pro coloca semi pronta dentro
do seu editor interno.
Vamos a seguir, criar sob a opo de menu Tabelas,
outro subsistema para conter a tabela de
Indexadores.
Pressione ESC para retornar ao modelador do projeto,
posicione a barra seletora sobre a opo Tabelas e
pressione INS. Crie um outro subsistema com os
seguintes dados genricos:
Arquivo (DBF).......: INDEXAD
Ttulo cabealhos..: Tabela do indexador
Ttulo abreviado.....: Indexador
Cdigo da ajuda......: 5
Manual do Usuri o
303
Insira este subsistema logo abaixo da tabela de
fornecedores, conforme aparece na figura VII.15.
Figura VII.15
Vamos agora definir a tabela de indexadores que
acabamos de inserir. Selecione Indexador e
Opes. Desta vez, vamos marcar a opo de
Digitao com rolagem, para vermos a sua utilidade.
Pressione ESC para retornar ao menu anterior.
Faremos tambm outra coisa diferente: selecione
Menu do subsistema e apague as duas primeiras
opes Incluso e Manuteno atravs da tecla
DEL. Em seguida, pressione ENTER sobre a opo
Consulta e altere para Cadastra/consulta.
Pressione ENTER para confirmar o cdigo de ajuda
(8).
Esta terceira opo sempre gerada com
possibilidades de alterao, consulta e digitao de
registros, alm de diversas outras opes. Na aplicao
final, quando esta tabela for selecionada, o usurio
entrar diretamente no mdulo de consulta, sem
qualquer menu intermedirio.
Pressione ESC, entre em Definio de atributos
(campos) e defina os seguintes campos para este
subsistema:
Vamos criar um campo para conter a data de
converso.
Manual do Usuri o
304
Nome............: data
Tamanho......: 8
Tipo...............: Data
N decimais...: 0
Mscara........: @D
Larg. edio..: 8
Ttulo.............: Data
Texto ajuda...: Informe a data de converso
Cmd especial.:
Pr-validao:
Validao.......: !EMPT(data)
Mensagem.....: Necessrio informar DATA
Temos duas novidades: vamos definir um valor inicial
para este campo. Ao estabelecer um valor inicial,
quando a aplicao estiver sendo executada, o usurio
ter como sugesto o que for aqui colocado. Deve-se
ter um cuidado especial com o tipo de campo e o tipo
de dado aqui informado. Como valor inicial, vamos
usar a data atual (do sistema), atravs da funo
DATE( ) do CA-Clipper.
Valor inicial: DATE( )
Vamos tambm, colocar uma seqncia igual a 1. A
seqncia determina um incremento automtico para o
campo. Isto significa que, ao cadastrar dados nesta
tabela, o usurio vai, confortavelmente, pressionando
ENTER e a aplicao vai sugerindo as datas para ele,
incrementando-as automaticamente.
Seqncia: 1
Manual do Usuri o
305
O segundo campo deste subsistema conter o valor
para clculo da converso.
Nome...........: valor
Tamanho.....: 12
Tipo..............: Numrico
N decimais..: 2
Tipo acesso.: Editvel
Mscara........: 999999999.99
Larg. edio..: 12
Ttulo.............: Valor
Texto ajuda...: Informe o valor para a converso
Cmd especial.:
Pr-validao:
Validao.......: valor>0
Mensagem.....: VALOR no aceitvel
Valor inicial....:
Seqncia......:
Pressione ESC para retornar ao menu anterior. Vamos
definir a tela de digitao deste subsistema
selecionando Definio da tela. Vamos deixar que o
GAS-Pro faa todo o trabalho. Pressione ALT-T para
que a tela da figura VII.16 seja feita automaticamente.
Manual do Usuri o
306
Figura VII.16
Observe nesta tela que o GAS-Pro fez uma disposio
de campos diferente da que fez para o subsistema
anterior. Como configuramos a opo de Tela com
rolagem, o GAS-Pro j preparou a tela para que a
digitao de registros seja rolada; ou seja, os campos
dos registros so digitados em uma mesma linha e, ao
atingir a borda inferior da tela, os campos rolam para
cima, permitindo que os ltimos registros digitados
estejam sempre presentes na tela.
Agora, pressione ESC, salve a tela e selecione Chaves
de acesso para definirmos um conjunto de pesquisa
para este subsistema. Responda com Data para o
ttulo do menu da chave de acesso e selecione o campo
data, pressionando ESC at retornar ao menu
Definio do subsistema.
Acabamos de definir o nosso segundo subsistema de
tabelas. Observe que as opes Descrio do
subsistema e Formulrio de entrada de dados
podem ser acessadas, se desejar, para ir construindo a
documentao do projeto.
Pressione novamente a tecla ESC para acessar o
modelador do projeto. Nosso projeto, por enquanto,
dever ter o aspecto da figura VII.17.
Manual do Usuri o
307
Figura VII.17
Definidas as duas tabelas, vamos agora inserir outros
mdulos no projeto. O prximo mdulo a ser inserido
ser o subsistema PRODUTOS, que conter os dados
dos produtos em estoque. Este mdulo ser inserido a
nvel de menu principal, portanto, posicione a barra
seletora sobre o ttulo do projeto e pressione a tecla
INS. Com isto, o mdulo que iremos inserir ficar no
mesmo nvel de Tabelas, no menu principal.
Selecione a insero de um novo subsistema e
responda para Dados genricos do subsistema:
Arquivo (DBF).....: PRODUTOS
Ttulo cabealhos: Cadastro de produtos
Ttulo abreviado...: Produtos
Cdigo da ajuda....: 5
Vamos inserir acima de Tabelas, portanto, no menu
INSERIR APS..., posicione a barra seletora sobre
o ttulo do projeto e pressione ENTER.
Podemos agora passar a definir este subsistema.
Selecione Definio de atributos (campos) e entre
com os campos a seguir:
Manual do Usuri o
308
Nome...........: codigo
Tamanho.....: 4
N decimais..: 0
Mscara........: 9999
Larg. edio..: 4
Ttulo.............: Cdigo
Texto ajuda...: Informe o cdigo do produto
Cmd especial.:
Pr-validao:
Validao.......: !EMPT(codigo)
Mensagem.....: Necessrio informar CDIGO
Valor inicial....:
Seqncia.......:
Observe que o GAS-Pro procura sugerir o que for mais
apropriado. Como sugesto, altere, se necessrio.
Vamos continuar...
Nome............: produto
Tamanho......: 30
N decimais..: 0
Mscara........: @!
Larg. edio..: 30
Ttulo.............: Descrio do produto
Texto ajuda...: Informe a descrio do produto
Cmd especial.:
Manual do Usuri o
309
Pr-validao:
Validao.......: !EMPT(produto)
Mensagem.....: Necessrio informar DESCRIO
DO PRODUTO
Valor inicial.....:
Seqncia........:
Sempre selecionando o ltimo campo definido,
pressione INS para um novo campo e responda:
Nome...........: unid
Tamanho.....: 2
Tipo.............: Caracter
N decimais..: 0
Mscara........: @!
Larg. edio..: 2
Ttulo.............: Unid
Texto ajuda...: Informe a unidade do produto
Cmd especial.:
Pr-validao:
Vamos utilizar a clusula de pr-validao para montar
um menu que permitir o nosso usurio capturar a
unidade do produto atravs de um menu interno (que
no contedo de outro arquivo). Vamos ver como
podemos fazer isso:
Pressione F8 e selecione Interna (utiliza uma tabela
fixa). Agora vamos entrar com as opes possveis
para a unidade do produto. Entre com a informao
que aparece na tela da figura VII.18, pressionado
ENTER em seguida.
Manual do Usuri o
310
Figura VII.18
Ao pressionar ENTER, observe que o GAS-Pro
montou automaticamente uma funo que criar um
menu na aplicao final para o usurio capturar as
iniciais UN, CX, MT, KG ou LT, conforme for o caso.
Pressione ENTER para aceitar o que o GAS-Pro
acabou de montar.
Observe que a validao do campo bem como a
mensagem esto tambm prontas. A expresso que o
GAS-Pro montou automaticamente assegura que o
usurio s poder digitar uma das siglas da tabela de
unidades que definimos. Pressione ENTER, portanto,
para aceitar as duas perguntas a seguir:
Validao..: unid $ [UN|CX|MT|KG|LT]
Mensagem: UNID no aceitvel
Vamos estabelecer aqui um valor inicial para este
campo. Como a unidade mais comum ser UN
(unidade), vamos oferecer este default para o usurio.
Valor inicial: UN
Responda com outro ENTER para a pergunta
Seqncia e este campo estar tambm definido
completamente.
Manual do Usuri o
311
Observando melhor o que definimos para este campo,
podemos melhorar uma coisa. Pressione ENTER sobre
este campo e posicione o cursor sobre a pergunta Pr-
validao.
A funo montada pelo GAS-Pro est perfeitamente
funcional. Porm, se precisarmos utilizar esses
cdigos em outro ponto da aplicao, teremos que
escrever novamente. Portanto, vamos utilizar mais um
recurso do GAS-Pro. Criaremos uma varivel pblica
(acessada por todos os mdulos do sistema) que
contenha esses cdigos. Assim, quando necessitarmos
deles novamente, basta utilizar o nome dessa varivel.
Com o cursor dentro deste campo, pressione ÔC
(CTRL-O-C). Esta operao faz com que o contedo
deste campo seja copiado para uma rea de
transferncia denominada clipboard que poder, mais
tarde, ser recuperada dentro do ambiente do GAS-Pro,
seja em campos, editores ou formatadores de telas,
relatrios ou etiquetas.
Ao pressionar ÔC, parece que nada aconteceu. Porm,
a informao deste campo (pr-validao) foi toda
transferida para o clipboard. Agora, vamos alterar um
pouco este campo. No lugar deste conjunto de cdigos,
vamos colocar um nome de varivel, por exemplo,
TBUNID (tabela de unidades).
Apague o campo (com ^Y) e digite
MTAB(tbunid,[UNID]).
Pressione ENTER at o final da definio deste campo.
Vamos sair momentaneamente deste mdulo e criar a
varivel pblica TBUNID. Pressione ESC at acessar o
modelador do projeto. Uma vez dentro do modelador,
selecione o ttulo do projeto e, em seguida, a opo
Variveis pblicas.
Ao selecionar esta opo, estaremos no editor interno
do GAS-Pro. Este j colocou algumas informaes
dentro do programa, vamos agora digitar uma linha de
programa para criar esta varivel pblica.
Posicione o cursor uma linha acima das palavras SET
EPOCH... e pressione ÔR (CTRL-O-R) para recuperar
o contedo do clipboard. Observe que o contedo vem
Manual do Usuri o
312
como bloco marcado. Pressione ^KH (CTRL-K-H) para
desmarcar o bloco, pressione INS (ou ^V) para ligar o
modo de insero e edite a linha que veio do clipboard
para definir TBUNID, conforme tela da figura VII.19.
Figura VII.19
Observe que deixamos todas as opes com um mesmo
tamanho (10 posies), colocando espaos ao final de
cada uma delas. Acontece que pretendemos decodificar
essas opes na tela de digitao do produto, e a
frmula que iremos construir para extrair o nome da
unidade desta varivel TBUNID necessita que todas
estejam do mesmo tamanho.
Aps definida esta varivel dentro do programa,
pressione ESC e selecione Salvar para gravar este
programa. Vamos retomar a nossa definio.
Pressione ESC novamente e selecione Produtos,
depois Definio de atributos (campos). Vamos
continuar inserindo campos no nosso arquivo de
PRODUTOS.
Coloque a barra seletora sobre o campo Unid e
pressione a tecla INS. Vamos inserir um campo do tipo
memo, que um campo especial que permite a
entrada de textos extensos (64.000 caracteres).
Responda conforme a seguir:
Nome............: reftec
Tamanho.....: 10
Manual do Usuri o
313
Tipo..............: Memo
N decimais..: 0
Mscara.......:
Larg. edio.: 35
Ttulo............: Referncia tcnica
Texto ajuda...: Entre com as especificaes tcnicas
Cmd especial.:
Pr-validao:
Validao.......:
Mensagem.....:
Valor inicial....:
Seqncia.......:
Pressione novamente INS, para inserir o prximo
campo que a quantidade em estoque. Responda com o
seguinte:
Nome.........: qd_est
Tamanho....: 6
Tipo.............: Numrico
N decimais.. 0
Mscara........: 999999
Larg. edio..: 6
Ttulo.............: Qde Est
Texto ajuda...: Informe a quantidade em estoque
Cmd especial.:
Pr-validao:
Validao.......: qd_est>=0
Manual do Usuri o
314
Mensagem.....: QDE EST no aceitvel
Valor inicial....:
Seqncia.......:
Vamos inserir agora um campo para conter a
quantidade mnima em estoque. Esta quantidade
mnima ns usaremos para elaborar, mais adiante, um
relatrio de alerta (produtos em ponto de pedido),
contendo os produtos que esto com a quantidade em
estoque abaixo do mnimo estabelecido. Pressione a
tecla INS e informe:
Nome...........: qd_min
Tamanho.....: 4
N decimais..: 0
Mscara........: 9999
Larg. edio..: 4
Ttulo.............: Qde min
Texto ajuda..: Informe a quantidade mnima para o
produto
Cmd especial.:
Pr-validao:
Validao.......: qd_min>0
Mensagem.....: QDE MIN no aceitvel
Valor inicial....:
Seqncia.......:
Posicione a barra seletora sobre o ltimo campo e
pressione INS. Definiremos agora um campo destinado
ao preo de custo do produto. Responda:
Manual do Usuri o
315
Nome............: preco_cus
Tamanho.......: 12
Tipo...............: Numrico
N decimais...: 2
Mscara........: 999999999.99
Larg. edio... 12
Ttulo.............: Preo custo
Texto ajuda...: Informe o preo de custo do produto
Cmd especial.:
Pr-validao:
Validao.......: preco_cus>0
Mensagem.....: PREO CUSTO no aceitvel
Valor inicial....:
Seqncia.......:
Definiremos um outro campo para armazenar um preo
para o produto. Este preo ser um preo indexado em
funo de um indexador cujos valores iremos colocar
em um outro arquivo definido neste projeto. Pressione
INS e informe:
Nome.........: preco_ind
Tamanho......: 10
Tipo.........: Numrico
N decimais..: 2
Mscara......: 9999999.99
Larg. edio.: 10
Ttulo.......: Preo indexado
Manual do Usuri o
316
Texto ajuda..: Entre com o preo convertido pelo
indexador
Cmd especial.:
Pr-validao:
Validao.......: preco_ind>0
Mensagem.....: PREO INDEXADO no aceitvel
Valor inicial....:
J vimos como definir um valor inicial para um campo
(fizemos isto na definio do subsistema tabela de
indexadores). No caso deste campo, vamos definir um
valor inicial de uma maneira diferente. Vamos
aprender como utilizar a tecla F9 para construir uma
funo em CA-Clipper para retornar um valor inicial
para este campo. Pressione a tecla F9. O GAS-Pro j
cria parte de um programa para que possamos escrever
a nossa funo, usando o seu editor interno. As linhas
de comentrios que aparecem logo abaixo da linha
#include ... (da linha que comea com /* at a linha
que termina com */) podem ser apagadas com ^Y.
Escreva o pequeno programa que aparece na tela da
figura VII.20.
Figura VII.20
Este pequeno programa executar a seguinte tarefa:
quando a aplicao final estiver rodando e for dada
uma entrada de produto no estoque, ele ir abrir o
Manual do Usuri o
317
arquivo que mantm os indexadores financeiros (que j
definimos anteriormente) e de l pegar o valor do
indexador para a data do cadastramento, converter o
preo de custo em funo deste indexador e colocar o
resultado no campo para sugerir ao nosso usurio final.
A frmula acima poderia ser colocada diretamente na
linha da pergunta Valor Inicial, atravs de um IF
linear, conforme exemplo a seguir (numa nica linha):
IF(PTAB(DTOS(DATE( )),'INDEXAD'),;
preco_cus/INDEXAD->valor,0)
Porm, preferimos utilizar a tecla F9 para demonstrar
a utilizao do editor do GAS-Pro para definir funes
mais complexas.
Pressione ESC para sair do editor, salve o programa e
observe que o GAS-Pro j colocou um nome de
programa para a nossa funo. Se desejar, coloque um
comentrio na frente do nome do programa, logo aps
duas barras, como por exemplo:
PRO_01F9( ) // calcula valor inicial do preco
indexado
Pressione ENTER deixando a ltima pergunta
Seqncia em branco.
Criaremos agora um campo para conter o valor do
percentual de lucro bruto para o produto. Este valor
vai ser utilizado para a emisso da tabela de preos de
produtos.
Com a barra seletora posicionada no ltimo campo,
pressione INS e responda:
Nome............: lucrobruto
Tamanho......: 6
Tipo...............: Numrico
Manual do Usuri o
318
N decimais...: 2
Mscara.........: 999.99
Larg. edio...: 6
Ttulo..............: L bruto
Texto ajuda...: Informe o % de acrscimo para preo
de venda
Cmd especial.:
Pr-validao:
Validao.......: lucrobruto>=0
Mensagem.....: L BRUTO no aceitvel
Valor inicial....:
Seqncia......:
Finalmente, vamos colocar um campo para armazenar
a data da ltima atualizao do produto. Este campo
ns definiremos como NO EDITVEL, ou seja, o
usurio no ter acesso para modific-lo. Sua
alimentao ser feita atravs de um processamento
externo a ser definido mais adiante. Na prtica, quando
o usurio digitar registros de baixas ou entradas em
estoque, este campo vai ser alterado pelo
processamento externo que definiremos. Pressione INS
e responda conforme se segue:
Nome..........: dt_ult_atu
Tamanho....: 8
Tipo.............: Data
N decimais.: 0
Tipo acesso: No Editvel
Mscara.......: @D
Larg. edio.: 8
Ttulo............: Data atualiz
Manual do Usuri o
319
Texto ajuda...:
Cmd especial.:
Pr-validao:
Validao.......:
Mensagem.....:
Valor inicial....:
Seqncia......:
Pronto! Acabamos de definir os atributos do
subsistema PRODUTOS. Agora, vamos fazer outras
definies importantes.
Pressione ESC para retornar ao menu anterior e
selecione Definio da tela.
Formate uma tela e posicione os campos de modo
semelhante tela que aparece na figura VII.21.
Figura VII.21
Os atributos definidos foram todos posicionados na
tela, exceto a quantidade em estoque. Por que?
No incio deste captulo, nas explicaes sobre este
sistema exemplo, no tpico Entrada de produtos em
estoque, dissemos que criaramos uma tela
complementar para o arquivo de PRODUTOS para o
ajuste das quantidades dos produtos. Esta tela
complementar ser elaborada mais adiante e, na nossa
Manual do Usuri o
320
definio, s atravs dela, o campo quantidade em
estoque ser acessado, alm dos processos normais de
entrada e sada de produtos que definiremos mais
adiante.
possvel tambm a definio de frmulas e campos
de outros arquivos para mostrar nas telas de digitao.
Vamos abandonar momentaneamente esta tela e definir
algumas frmulas. Mais tarde voltaremos para
posicionar frmulas e campos externos definidos.
Pressione ESC e salve a tela, retornando ao
Modelador do projeto.
Pessoas acostumadas a desenvolver sistemas
aplicativos sabem que uma boa aplicao deve ser
parametrizada, isto , deve estar imune s mudanas de
legislao, polticas econmicas, etc. Uma aplicao
que no se ajuste automaticamente a essas mudanas,
toma muito tempo do seu analista/projetista que
obrigado a executar manutenes peridicas
solicitadas pelos usurios. Para evitar esses
transtornos, boa prtica criar dentro da aplicao um
arquivo de parmetros para conter informaes que
mudam freqentemente e que so necessrias ao
sistema aplicativo. Alguns exemplos so taxa de
inflao, nomes de indexadores, percentuais de juros
de mercado, etc. Estando esses parmetros
armazenados em um arquivo, o prprio usurio executa
as mudanas necessrias para serem referenciadas pela
aplicao.
O GAS-Pro permite a criao de sistemas aplicativos
parametrizados, ou seja, permite a criao de um
arquivo de parmetros para a aplicao.
As principais caractersticas de um arquivo de
parmetros so:
associados;
no possui arquivos relacionados;
no recebe nem gera lanamentos (pode ser alvo de
processamento);
Manual do Usuri o
321
no possui montagem de consultas e nenhum
relatrio pode ser definido.
O captulo V deste manual detalha as caractersticas de
um arquivo de parmetros.
Para demonstrar, criaremos um arquivo deste tipo para
a nossa aplicao de Controle de Estoques.
Coloque a barra seletora sobre a opo Apoio e
pressione INS, selecionando em seguida Arquivo de
parmetros. Para dados genricos, informe o
seguinte:
Arquivo (DBF).....: PAR_ESTO
Ttulo cabealhos: Parmetros do sistema
Ttulo abreviado...: Parmetros do sistema
Posicione a barra seletora sobre Apoio e pressione
ENTER, no menu Inserir aps....
A rvore do nosso projeto dever agora ter o aspecto
mostrado na figura VII.22.
Figura VII.22
Selecione Parmetros do sistema e pressione
ENTER, selecionando Definio de atributos
(campos) em seguida.
Manual do Usuri o
322
Vamos criar dois campos neste arquivo de parmetros:
o nome do indexador financeiro e sua sigla. Esta vai
ser uma das informaes que iremos mostrar na tela do
subsistema PRODUTOS. Crie os seguintes campos:
Nome............: p_nome_ind
Tamanho......: 10
N decimais...: 0
Tipo acesso...: Editvel
Mscara........:
Larg. edio..: 10
Ttulo.............: Nome indexador
Texto ajuda..: Entre com o nome do indexador de
preos
Cmd especial.:
Pr-validao:
Validao.......: !EMPT(p_nome_ind)
Mensagem.....: Necessrio informar NOME
INDEXADOR
Valor inicial....: DLAR
Nome...........: p_sigl_ind
Tamanho.....: 4
N decimais..: 0
Mscara........:
Larg. edio..: 4
Ttulo.............: Sigla indexador
Manual do Usuri o
323
Texto ajuda...: Informe a sigla do indexador financeiro
Cmd especial.:
Pr-validao:
Validao.......: !EMPT(p_sigl_ind)
Mensagem.....: Necessrio informar SIGLA
INDEXADOR
Valor inicial....: US$
Nessas definies, observe que prefixamos o nome da
varivel de arquivo (nome do campo) com p_ para
minimizar a possibilidade de conflitos com outras
variveis do sistema. Isto porque, toda vez que a
aplicao final for executada, variveis de memria
com esses mesmos nomes sero criadas e publicadas,
ou seja, sero vistas por todos os mdulos da
aplicao.
Criados esses dois campos, pressione ESC e formate a
tela de digitao para esses parmetros. Se desejar,
utilize ALT-T para fazer a tela padro, conforme
figura VII.23.
Figura VII.23
Pressione ESC, salve a tela e selecione novamente
Produtos, no Modelador do projeto. Agora
definiremos algumas frmulas para mostrar na tela de
PRODUTOS. Selecione Frmulas & campos
Manual do Usuri o
324
externos e pressione ENTER. Para a primeira frmula,
digite as seguintes informaes:
Ttulo : Preo venda R$
Frmula:
Para a pergunta acima, vamos explorar a facilidade da
interface e do dicionrio de dados ativo do GAS-Pro.
Pressione a tecla F10 e o GAS-Pro apresentar um
menu com os arquivos que esto relacionados com
PRODUTOS para que possamos utilizar seus campos
na frmula em definio. Neste caso, so apresentados
somente os arquivos PAR_ESTO (parmetros) e
PRODUTOS (o prprio arquivo de produtos).
Selecione PRODUTOS para capturarmos um de seus
campos para compor a frmula. A tela da figura
Figura VII.24
Selecione preco_cus e pressione ENTER. Observe
que o nome deste campo foi capturado. Sempre que
precisar referenciar, na frmula, um campo de arquivo,
utilize este recurso. Acabe de definir esta frmula que
dever ficar assim:
Frmula: preco_cus+(preco_cus*lucrobruto/100)
Mscara: @E 99,999,999.99
Manual do Usuri o
325
Largura: 13
Apenas para lembrar, o @E na mscara fora a
permuta de pontos por vrgulas.
V pressionando a tecla INS a partir do menu de
frmulas e defina as frmulas a seguir:
Para mostrar o preo de venda indexado na tela:
Ttulo.: Preo venda ind
Frmula: preco_ind+(preco_ind*lucrobruto/100)
Mscara: @E 99,999,999.99
Largura: 13
Esta frmula mostrar na tela a sigla do indexador
financeiro utilizado.
Ttulo.: Sigla index 1
Frmula: M->p_sigl_ind
Mscara:
Largura: 4
Esta frmula mostrar em outro ponto da tela a sigla
do indexador financeiro utilizado.
Ttulo.: Sigla index 2
Frmula: M->p_sigl_ind
Mscara:
Largura: 4
Por que ser que definimos a mesma frmula duas
vezes? Porque cada frmula a ser posicionada na tela
possui as suas prprias coordenadas linha/coluna onde
Manual do Usuri o
326
dever aparecer. Por isso, como queremos coloc-la
em dois pontos distintos da tela, temos que defin-la
duas vezes.
A frmula seguinte extrair daquela varivel pblica
TBUNID que definimos anteriormente, somente o
nome da unidade do produto.
Ttulo.: Decodif unidade
Frmula: SUBS(tbunid,AT(unid,tbunid)+3,7)
Mscara:
Largura: 7
Finalmente, a frmula a seguir mostrar a quantidade
em estoque na tela de PRODUTOS. Lembre-se de
que, quando definimos a tela de PRODUTOS,
deixamos de posicionar este campo, que ser acessado
por uma tela complementar a ser criada mais adiante.
Portanto, estamos utilizando uma frmula para mostrar
qde estoque, sem perigo de que o usurio tenha
acesso a ele.
Ttulo.: Qde estoque
Frmula: qd_est
Mscara: 999999
Largura: 6
Definidas as frmulas a serem mostradas, vamos agora
posicion-las na tela de produtos. Pressione ESC,
selecione Definio da tela e posicione as frmulas
que definimos, de acordo com a tela da figura VII.25.
O posicionamento de frmulas na tela feita pelo
menu acionado com F6, e pequenos losangos so
utilizados para fazer as marcaes de suas posies na
tela (os campos de arquivo so posicionados com a
tecla F10 e marcados na tela com pequenos blocos de
formato retangular).
Manual do Usuri o
327
Figura VII.25
Pronto! Terminamos a definio da tela de produtos.
Agora podemos continuar as demais definies.
Pressione ESC, salve a tela e selecione Chaves de
acesso para definirmos os conjuntos de pesquisa para
este subsistema. Criaremos dois conjuntos de pesquisa.
A nossa aplicao vai acessar este arquivo atravs do
cdigo do produto e tambm pela descrio (nome) do
produto.
Para o primeiro conjunto de pesquisa, digite Cdigo
em resposta a ttulo para menu e selecione o campo
codigo, pressionando ESC em seguida. Para o
segundo conjunto, pressione a tecla INS e digite
Nome do produto para o ttulo para menu e
selecione o campo produto.
Pressione ESC at retornar ao menu de definio do
subsistema PRODUTOS. Quando criamos o ltimo
campo deste subsistema (data da ltima atualizao),
definimos o tipo de acesso no editvel, para que fosse
atualizado somente atravs de um processamento
externo.
Selecione Processamentos e, mais uma vez,
utilizando os recursos do dicionrio de dados ativo do
GAS-Pro, definiremos o processamento para o campo
data da ltima atualizao.
Primeiramente, escolheremos o arquivo alvo do
processamento. Para a pergunta Arquivo alvo,
pressione F10 para acessar os arquivos relacionados e
selecione o prprio arquivo PRODUTOS
Manual do Usuri o
328
pressionando ENTER. Como pode notar, o GAS-Pro
permite no s a definio de processamentos em
outros arquivos como tambm um arquivo gerando
processamento em si prprio.
Selecionado o arquivo alvo, pressione ENTER para
aceitar o arquivo capturado e vamos estabelecer o
campo alvo do processamento.
Pressione novamente a tecla F10 e selecione o ltimo
campo do arquivo produto, ou seja, dt_ult_atu,
pressionando ENTER para aceitar o campo capturado.
Este processamento dever ser efetuado em qualquer
situao, portanto, deixaremos a condio em branco,
pressionando ENTER.
Um processamento definido sempre com duas
frmulas: uma, direta, para ser executada sempre que
um registro digitado; a outra, inversa, para ser
executada quando um registro for apagado. A frmula
inversa, se definida, deve ser exatamente o inverso da
primeira.
Para frmula direta, neste processamento, vamos
utilizar a funo DATE( ) do CA-Clipper. No vamos
definir uma frmula inversa para processar este
campo. Isto significa que, quando um registro for
apagado, nada afetar este campo.
Aps a definio deste processamento, a tela da figura
Figura VII.26
Manual do Usuri o
329
Pronto, este subsistema est todo definido. Vamos
agora contin uar inserindo outros mdulos no projeto.
Pressione ESC at voltar ao modelador do projeto.
Em qualquer sistema de estoques, na realidade, h
possibilidade de mais de um fornecedor para um
mesmo produto. Criaremos um arquivo para controlar
esta situao.
Vamos inserir imediatamente aps o subsistema
PRODUTOS, um outro subsistema de arquivo
denominado Fornecedores por produto. Posicione a
barra seletora sobre Produtos e pressione a tecla INS
para inserir o novo mdulo.
Subordinado a um mdulo subsistema DBF, somente
um outro subsistema DBF pode ser inserido. Sempre
que inserimos um subsistema abaixo de outro, eles
ficaro automaticamente relacionados (pai/filho) na
aplicao. As entradas de dados para um subsistema
deste tipo sero automaticamente encadeadas. Dessa
maneira, podemos inserir mdulos subordinados em
at 11 nveis, ou seja, pai/filho/neto/bisneto/etc. Um
arquivo pai pode ter diversos filhos, e netos. O
GAS-Pro gera todas as rotinas para manipular esta
famlia.
Continuando, selecione Definir um novo subsistema
e informe o seguinte para os seus dados genricos:
Arquivo (DBF).....: FNDPROD
Ttulo cabealhos: Fornecedores por produto
Ttulo abreviado...: Fornecedores/produto
Observe na tela da figura VII.27 que o arquivo
fornecedores por produto ficou inserido em posio
subordinada ao subsistema PRODUTOS.
Manual do Usuri o
330
Figura VII.27
Agora, selecione Fornecedores/produto para fazer as
definies para este subsistema. Entre em Opes,
marque a opo de Digitao com rolagem e
pressione ESC para retornar. Em seguida, entre em
Definio de atributos para criarmos os campos do
arquivo deste subsistema. Observe que este j veio
com um campo inserido. que os arquivos de
subsistemas subordinados a outros, incorporam
automaticamente os campos chaves (do primeiro
conjunto de pesquisa) do pai. Neste caso, o campo
chave do arquivo pai (cdigo, arquivo PRODUTOS)
foi automaticamente inserido neste subsistema. O
asterisco * na frente do nome de um campo indica
que este campo um campo de relacionamento com o
mdulo de nvel superior (pai).
Vamos inserir outros campos. Pressione INS para
definirmos um campo que conter o cdigo do
fornecedor do produto. Quando definimos a tabela de
fornecedores, ns adicionamos ao banco de campos
o cdigo do fornecedor. Agora ficou fcil... Pressione
a tecla F8, selecione CODIGO.CPO e pressione
ENTER em seguida. Todas as definies que fizemos
naquela oportunidade foram capturadas! Agora s
precisamos alterar o nome deste campo que est em
duplicidade com o nome do campo que foi inserido
automaticamente (campo da chave do pai). Pressione
^Y e digite fornec. Pressione ENTER para confirmar
as informaes at chegar pergunta Validao, onde
vamos montar uma validao em outro arquivo de
Manual do Usuri o
331
dados, ou seja, o nosso usurio s conseguir digitar
uma informao neste campo se esta j estiver contida
em um outro arquivo. No poderemos permitir que seja
digitado um cdigo de fornecedor que no tenha sido
previamente cadastrado no sistema. A montagem desta
validao poder ser feita por seleo de menu,
seguindo os passos a seguir:
pressione ^Y para apagar a informao anterior;
pressione a tecla F8;
como arquivo alvo da pesquisa, selecione FORNEC
(tabela de fornecedores);
como ndice associado ao arquivo FORNEC,
selecione cdigo.
Neste ponto, a tela da figura VII.28 dever aparecer.
Figura VII.28
Neste menu existem trs arquivos dos quais podemos
utilizar campos para pesquisar a tabela de
fornecedores (FORNEC). Por que apareceram esses
trs arquivos? Porque enquanto definimos os arquivos
do nosso projeto, diversos relacionamentos com outros
arquivos foram sendo estabelecidos e, uma vez
estabelecidos, qualquer campo dos arquivos
relacionados podem ser utilizados como se fosse do
arquivo atual:
Manual do Usuri o
332
o primeiro deles, PAR_ESTO o arquivo de
parmetros que criamos, cujas variveis so
pblicas, ou seja, podem ser vistas em toda a
aplicao;
o segundo, PRODUTOS, o arquivo pai do
arquivo que estamos definindo, tendo, portanto, um
relacionamento automtico e, finalmente,
o terceiro, o prprio arquivo que estamos
definindo (FNDPROD).
Selecione o arquivo atual (FNDPROD) para fornecer o
campo para a pesquisa. Em seguida, selecione o campo
fornec. O GAS-Pro montou automaticamente a
funo para pesquisar o arquivo de fornecedores. Esta
funo PTAB( )est documentada no captulo XI deste
manual.
Prosseguindo, altere a mensagem Necessrio informar
CDIGO para Fornecedor no cadastrado no
sistema e pressione ENTER at o final das definies
deste campo.
Como fizemos diversas alteraes nas especificaes
deste campo e, provavelmente teremos a necessidade
utiliz-lo novamente, vamos adicion-lo ao banco de
campos, com as novas definies (agora com o nome
de fornec). Pressione F8 e confirme.
Agora, vamos criar mais um campo para fazer o
controle dos lanamentos sobre este arquivo. Toda vez
que for inserido um item de produto em uma Nota
Fiscal, este campo ser acumulado (incrementado de
1). No momento da criao do lanamento sobre este
aquivo, iremos utilizar este campo para estabelecer
uma condio sob a qual este registro ser excludo ou
no, caso haja uma excluso de um item da Nota
Fiscal.
Nome............: controle
Tamanho......: 6
Manual do Usuri o
333
N decimais..: 0
Tipo acesso.: Invisvel
Mscara........: 999999
Larg. edio..: 6
Ttulo............: Controle
Texto ajuda...:
Cmd especial.:
Pr-validao:
Validao.......:
Mensagem.....:
Valor inicial....:
Seqncia......:
Este arquivo ter somente esses trs campos (um deles
de relacionamento com o pai). Pressione ESC e
vamos definir uma frmula para mostrar na tela de
digitao. Selecione Frmulas & campos externos e
pressione F10. Selecione o arquivo FORNEC e
selecione o campo nome, pressionando ENTER at o
final para confirmar. Pressione ESC e selecione
Definio da tela. Pressione ALT-T para fazer uma
tela padro e complete com as informaes necessrias
para que fique igua tela da figura VII.29. Lembre-se
de que a tecla F5 serve para ativar o modo de desenho
de linhas na tela e que a tecla F6 permite o
posicionamento de frmulas ou campos externos na
tela, os quais no so posicionados automaticamente
na tela padro.
Manual do Usuri o
334
Figura VII.29
Pressione ESC, salve a tela que acabou de ser
formatada e selecione Chaves de acesso. Observe
que j existe um campo definido como chave. Trata-se
daquele campo de relacionamento do arquivo pai.
Vamos ento adicionar um outro campo neste conjunto
de pesquisa. A chave de um subsistema subordinado
como este que estamos defindo tem que ter, pelo
menos, um campo na expresso da chave de acesso,
alm daquele campo ou campos de relacionamento que
vieram do arquivo pai.
Pressione ENTER duas vezes e marque tambm o
campo fornec como chave deste subsistema.
Tecle ESC para retornar ao menu de definio do
subsistema.
Este arquivo que acabamos de definir tem uma
caracterstica especial. Ele receber registros somente
atravs de lanamentos gerados a partir de digitaes
de itens de NF. No desejvel que o usurio digite ou
modifique registros neste arquivo. Vamos utilizar a
opo Condies Especiais para controlar esta
situao. Selecione esta opo e responda conforme
segue:
Excluir registro.............: 1=2
Mensagem ao usurio: No pode ser excludo
Manual do Usuri o
335
Alterar registro............: 1=2
Mensagem ao usurio: No pode ser alterado
Incluir registros...........: 1=2
Mensagem ao usurio: A incluso automtica
Observe que a expresso 1=2 utilizada em todas as
condies especiais, define uma situao FALSA,
portanto, nunca atendida. Com isto, qualquer tipo de
manuteno neste arquivo ser negada.
A seguir, pressione ESC at retornar ao modelador do
projeto.
Nosso projeto est tomando forma! Agora, vamos
preparar a parte que trata da movimentao do nosso
estoque. J dissemos no incio deste captulo que a
movimentao do estoque ser feita atravs de notas
fiscais de fornecedores, no caso de entrada em
estoque; e que haver tambm uma tela complementar
para ajustes de quantidades. Vamos ento trabalhar
esta parte.
Posicione a barra seletora sobre o ttulo do projeto
(vamos inserir a nvel de menu principal) e pressione
INS. Vamos inserir um menu intitulado
Movimentao. Posicione este mdulo logo abaixo
do ttulo do projeto.
Agora, com a barra seletora posicionada em
Movimentao, pressione novamente a tecla INS.
Dessa vez vamos inserir um subsistema de arquivo
DBF. Defina um novo subsistema com os seguintes
dados genricos:
Arquivo (DBF).....: NOTAS
Ttulo cabealhos: Entrada de produtos em estoque
Ttulo abreviado...: Entrada de produtos
Manual do Usuri o
336
Tecla de atalho.....: ALT+N
Aps essas definies, a rvore do nosso projeto
dever estar igual que aparece na tela da figura
VII.30.
Figura VII.30
Pressione a tecla ENTER sobre o mdulo que acabou
de ser inserido para efetuarmos as demais definies.
Vamos modificar o menu de acesso a este subsistema.
Selecione Menu do subsistema e pressione ENTER.
Das trs opes sugeridas pelo GAS-Pro, vamos
modificar as duas primeiras e retirar a terceira.
Pressione ENTER sobre a primeira opo e troque
Incluso por Digita NF. Lembre-se de que ^Y
apaga o contedo do campo.
Pressione ENTER sobre a segunda opo e troque
Manuteno por Altera NF.
Finalmente, posicione a barra seletora sobre
Consulta, pressione a tecla DEL, confirme o
apagamento da opo e pressione ESC em seguida.
Selecione Definio de atributos para a criao dos
campos da nota fiscal de fornecedor.
Para o primeiro campo, defina o seguinte:
Manual do Usuri o
337
Nome............: numero
Tamanho......: 4
N decimais...: 0
Mscara........: 9999
Larg. edio..: 4
Ttulo.............: Nmero NF
Texto ajuda...: Entre com o nmero da NF
Cmd especial.:
Pr-validao:
Validao.......: !EMPT(numero)
Mensagem.....: Necessrio informar NMERO NF
Valor inicial....:
Seqncia......:
O segundo campo, data da nota fiscal, ser definido
assim:
Nome..........: data
Tamanho....: 8
Tipo.............: Data
N decimais.: 0
Mscara.......: @D
Larg. edio.: 8
Ttulo............: Data
Texto ajuda...: Entre com a data da NF
Cmd especial.:
Pr-validao:
Manual do Usuri o
338
Validao.......:
Na pergunta Validao, vamos criar uma expresso
que garanta que o usurio digite somente datas que
tenham sido previamente cadastradas na tabela de
indexadores financeiros. Vamos fazer esta validao
da mesma maneira que fizemos durante a definio do
subsistema de fornecedores por produto (FNDPROD).
Pressione a tecla F8, selecione o arquivo INDEXAD
(indexadores), selecione o arquivo NOTAS (em
definio) e o campo DATA (este campo que ainda
nem terminamos de definir).
Pronto, o GAS-Pro montou a definio da funo
PTAB( ), que j vimos e que est detalhada no Captulo
XI deste manual.
Pressione a tecla duas vezes e estabelea um valor
inicial utilizando a funo DATE( ) do CA-Clipper
para ser sugerido ao usurio final.
Pressione INS opara criar um outro campo e utilize F8
para capturar do banco de campos o campo
FORNEC.CPO.
Pressione ENTER para confirmar as informaes, at
chegar ao ttulo, que deve ser alterado para
Fornecedor. Em seguida pressione ENTER para
completar a informao do Texto de ajuda, como se
segue:
Informe o cdigo do fornecedor.|F8=captura da
tabela
O caracter | forar uma quebra de linha, de modo
que a mensagem acima aparecer em duas linhas
dentro da janela.
Em Cmd Especial, vamos montar a nossa interface
para o usurio. Pressione a tecla F8 para montar um
menu pick e selecione Externa (outro arquivo do
projeto). Em seguida, selecione o arquivo FORNEC
(tabela de fornecedores). Quando perguntado sobre
Manual do Usuri o
339
qual ndice associado ao arquivo FORNEC,
selecione o segundo (NOME).
Agora, vamos selecionar os campos que colocaremos
na janela de consulta para o nosso usurio. Marque
somente o campo nome pressionando ENTER sobre
ele, de modo que fique conforme tela da figura
VII.31.
Figura VII.31
At aqui, informamos ao GAS-Pro que este campo ir
constar em uma janela a ser apresentada ao usurio.
Agora, vamos pressionar ESC e selecionar do prximo
menu, o campo que queremos capturar. Selecione
cdigo pressionando ENTER sobre este campo.
Em seguida, o GAS-Pro solicitar a entrada da
expresso de filtragem inicial do arquivo selecionado.
Pressione ENTER deixando esta resposta em branco.
Pronto! A interface est montada. Quando estiver
digitando dados da nota fiscal, ao entrar com o cdigo
do fornecedor, o usurio poder pressionar a tecla F8
para acionar uma tabela externa onde aparecer o
nome de todos os fornecedores, e de l selecionar o
nome que consta da Nota Fiscal. Pressionando ENTER
sobre ele, o campo cdigo ser capturado e inserido no
arquivo de Notas. Mas, o que acontecer se o
fornecedor da nota que estiver sendo digitada no
estiver ainda cadastrado na tabela de fornecedores?
Basta que o nosso usurio pressione a tecla D (de
Manual do Usuri o
340
digitar) para adicionar o novo fornecedor, na hora,
dentro da tabela.
Continue pressionando ENTER para aceitar as outras
definies para este campo. Observe que a validao
em tabela externa j est pronta, pois capturamos
diretamente do banco de campos.
Finalmente, vamos inserir um ltimo campo neste
arquivo que o valor da NF. Este campo ser
totalizado pelo arquivo filho (itens da NF), atravs
de processos que definiremos mais adiante, razo pela
qual colocaremos seu tipo de acesso como No
Editvel. Defina este campo conforme a seguir:
Nome...........: valor
Tamanho....: 16
N decimais.: 2
Tipo acesso: No Editvel
Mscara.......: 9999999999999.99
Larg. edio.: 16
Ttulo............: Valor da NF
Texto ajuda...:
Cmd especial.:
Pr-validao:
Validao.......:
Mensagem.....:
Valor inicial....:
Seqncia......:
Acabamos de definir os campos do arquivo de dados
da primeira parte da Nota Fiscal. Daqui a pouco
definiremos a segunda parte, para a digitao dos itens
de produtos da NF.
Manual do Usuri o
341
Agora, pressione ESC e defina uma frmula para
mostrar na tela desse subsistema. Como temos um
campo com o cdigo do fornecedor, vamos mostrar o
nome do fornecedor que se encontra no subsistema
Tabela de fornecedores.
Selecione Frmulas & campos externos, pressione
F10, selecione o arquivo FORNEC e o campo
nome deste arquivo. Pressione em seguida a tecla
ENTER at o final das definies da frmula e,
finalmente, pressione ESC para voltar ao menu
anterior.
Selecione Definio da tela e pressione ALT-T para
criar uma tela padro. Vamos abrir um pouco a tela,
horizontalmente via F9, pois a frmula que iremos
posicionar no caber na tela.
Pressione a tecla F6 e posicione a frmula que contm
o nome do fornecedor. A tela dever estar igual que
aparece na figura VII.32.
Figura VII.32
Em todas as explicaes deste nosso sistema exemplo,
estamos utilizando sempre a tela padro porque so
diversas telas a serem definidas e as explicaes se
alongariam. No entanto, se desejar, formate uma tela
posicionando os campos a gosto. S no deixe de
posicionar os campos, para este nosso exemplo. Caso
necessite de informaes adicionais, pressione F1 ou
recorra ao Captulo V deste manual.
Manual do Usuri o
342
Pressione ESC e salve a tela. Vamos agora definir os
campos que comporo a chave de acesso deste
subsistema. Entre em Chaves de acesso, coloque
como ttulo Nmero e selecione o campo de mesmo
nome. Pressione ESC em seguida para retornar ao
menu de Definio do subsistema.
Sabemos que, se desejarmos, podemos ir
documentando cada subsistema que definimos,
bastando selecionar as duas ltimas opes desse menu
e fazer, respectivamente, a descrio e o formulrio de
transcrio de dados.
Podemos definir agora um outro subsistema (arquivo)
para conter os itens de produto que constam da NF do
fornecedor. Vamos inserir este subsistema
imediatamente abaixo do que acabamos de definir.
Eles funcionaro de maneira relacionada 1-N (1
registro de NOTAS para N registros de ITENS).
A partir do modelador do projeto, posicione em
Entrada de produtos, pressione INS e defina um novo
subsistema com os seguintes dados genricos:
Arquivo (DBF).....: ITENS
Ttulo cabealhos: Produtos da Nota Fiscal
Ttulo abreviado...: Produtos da NF
A seguir, pressione ENTER sobre Produtos da NF
para iniciarmos as definies deste subsistema.
Selecione Opes e marque a opo de Digitao
com rolagem. Observe que algumas opes no esto
selecionveis. Essas opes obedecero ao que estiver
configurado para o subsistema de nvel superior (pai).
Entre em Definio de atributos (campos) e
verifique que, o campo chave do subsistema de nvel
superior (pai) j foi incorporado estrutura. Pressione
INS e defina o campo seguinte:
Manual do Usuri o
343
Nome: produto
Bem, j definimos anteriormente o nosso cadastro de
produtos. Este campo dever estar de acordo com o
cdigo de produto que definimos naquela
oportunidade. Mas, qual foi mesmo o tamanho que
deixamos para este campo? E como foi definida a
mscara? E o pior que no adicionamos este campo
ao banco de campos naquela oportunidade! E
agora?!
Novamente, no temos com o que nos preocupar!
Temos duas sadas para esta situao! O GAS-Pro
possui dicionrio de dados ativo...
Primeiro, podemos, ao informar o tamanho do
campo, pressionar F10 para compatibilizar o
tamanho. Se estiver com ajuda ativa ligada (ALT-F1)
poder estar vendo que a tecla F10 permite a
compatibilizao do tamanho do campo. Pressione
F10, selecione o arquivo PRODUTOS e o seu campo
cdigo. O GAS-Pro colocou o tamanho correto
dentro do campo. Podemos fazer isso tambm para a
informao de mscaras.
Vejamos agora, qual a outra alternativa. Pressione
ESC para abandonar as definies deste campo e
pressione novamente a tecla INS para recomear.
Agora, informaremos o nome do campo. Podemos ver,
pela ajuda ativa, que a tecla F8 ativa o banco de
campos; porm, no temos essa definio
armazenada. Ento, vamos pressionar F10, da mesma
maneira que fizemos para compatibilizar o tamanho.
Selecione PRODUTOS e o seu campo cdigo. A
definio completa do campo foi capturada daquele
arquivo. Agora, s nos resta adapt-las.
Sempre que a tecla F10 colocada no Nome do
campo, as informaes completas so capturadas. Em
qualquer outro lugar da definio, somente a
informao necessria quele local capturada.
Altere o nome do campo e o seu ttulo para Produto.
No texto de ajuda, vamos avisar ao nosso usurio que a
Manual do Usuri o
344
tecla F8 poder ativar um comando especial. Altere o
texto para:
Informe o cdigo do produto|F8=captura da tabela
Em Cmd Especial, vamos montar uma interface
semelhante quela que definimos no subsistema
anterior.
Pressione a tecla F8, selecione tabela externa e em
seguida o arquivo PRODUTOS. No ndice associado
ao arquivo, selecione Nome do produto. Marque, em
seguida, o campo Produto para montar o menu e em
seguida a tecla ESC. Finalmente, selecione o campo
cdigo para ser capturado. Est pronta a mesma
interface que fizemos nas definies do subsistema
anterior.
Para Validao, vamos montar uma validao
externa. Pressione ^Y para apagar o contedo existente
e, em seguida, pressione F8. Selecione o arquivo
PRODUTOS e o ndice associado cdigo. A
seguir, selecione ITENS e o campo produto.
Pronto! Est montada a nossa validao externa.
Pressione ENTER, altere tambm a mensagem para
Produto no cadastrado e confirme as demais
informaes para este campo.
Novamente a partir do menu de campos, insira mais
dois campos, conforme se segue:
Nome...........: quant
Tamanho......: 6
N decimais..: 0
Mscara........: 999999
Larg. edio..: 6
Ttulo.............: Quantidade
Manual do Usuri o
345
Texto ajuda...: Informe a quantidade recebida na NF
Cmd especial.:
Pr-validao:
Validao.......: quant>0
Mensagem.....: QUANTIDADE no aceitvel
Valor inicial....:
Seqncia.......:
Nome...........: pre_cus_un
Tamanho....: 12
N decimais..: 2
Tipo acesso: Editvel
Mscara.......: 999999999.99
Larg. edio.: 12
Ttulo............: Custo unitrio
Texto ajuda...: Infome preo de custo unitrio
Cmd especial.:
Pr-validao:
Validao.......: pre_cus_un>0
Mensagem.....: CUSTO UNITRIO no aceitvel
Valor inicial....:
Para esta pergunta, vamos estabelecer um valor inicial
(default) como sugesto ao usurio. Pressione F10
para abrir o menu de arquivos relacionados, selecione
PRODUTOS e, em seguida, o campo preco_cus. O
GAS-Pro colocar a seguinte informao.
PRODUTOS->preco_cus
Manual do Usuri o
346
Definidos os campos, vamos pressionar ESC para
retornar ao menu anterior. Agora, definiremos duas
frmulas para mostrar na tela que criaremos para a
entrada de dados de itens. J que vamos digitar o
cdigo do produto, mostraremos a sua descrio, que
se encontra em outro arquivo. Vamos tambm criar
uma frmula que mostre ao usurio, na tela, o preo
total de cada item recebido.
Selecione Frmulas & campos externos. Para a
primeira frmula, pressione F10 ao entrar com o ttulo
da frmula. Selecione o arquivo PRODUTOS e, em
seguida, o campo produto, a partir da tela que aparece
na figura VII.33.
Figura VII.33
Confirme com ENTER, at o final das informaes que
o GAS-Pro colocou.
Agora, estabeleceremos a frmula (quantidade * custo
unitrio do produto). Pressione INS para inserir uma
outra frmula e acione novamente a tecla F10. As
informaes que utilizaremos nesta frmula pertencem
ao arquivo atualmente em definio, portanto, vamos
selecionar Itens. Quando aparecer o menu de
campos, selecione o campo quant (quantidade).
Agora vamos alterar o ttulo da frmula para Custo
total, pressionando ENTER em seguida. Na frente do
campo quant coloque um asterisco *
(multiplicao), acione novamente a tecla F10,
selecione novamente o arquivo Itens e capture o
Manual do Usuri o
347
campo pre_cus_un. Repare que o GAS-Pro s
colocou o nome do campo para completar a frmula.
Altere a mscara e a largura dessa frmula da seguinte
maneira:
Mscara: @E 99,999,999.99
Largura: 13
Definidas as duas frmulas, vamos pressionar a tecla
ESC e entrar na definio da tela para a digitao dos
itens de produtos da NF. Pressione ALT-T para fazer
uma tela padro. Depois, utilizando os recursos de
formatao do editor de telas, modifique e posicione as
frmulas para ficar igual tela que aparece na figura
VII.34. Lembre-se de que a tecla F1 ajuda a esclarecer
dvidas.
Figura VII.34
Pressione ESC, salve a tela e selecione Chave de
acesso para a formao da chave de indexao deste
subsistema. Observe que o campo Nmero do
subsistema relacionado em nvel superior (pai) j foi
integrado chave. Pressione ENTER duas vezes e
selecione tambm o campo Produto. A chave de
acesso a este subsistema ser formada pelos campos
numero da nota fiscal e cdigo do produto,
concatenados.
Manual do Usuri o
348
Pressione ESC at retornar ao menu anterior.
Agora, vamos definir um lanamento. Lembra-se que
criamos o arquivo FNDPROD, subordinado a
PRODUTOS para controlar as situaes de mais de
um fornecedor para um mesmo produto? Bem, a seguir,
vamos gerar um lanamento para alimentar aquele
arquivo. Funcionar da seguinte maneira: toda vez que
o usurio der entrada em um item de produto, vamos
verificar se o fornecedor est cadastrado com o
produto naquele arquivo. Caso no esteja, vai criar um
novo registro naquele arquivo e colocar a informao
do fornecedor e do produto nesse registro. O GAS-Pro
vai fazer isso tudo, sem esforo! Vamos comear...
Selecione Lanamentos no menu Definio do
subsistema. Ao informar Arquivo alvo, pressione
F10 e selecione o arquivo FNDPROD, pressionando
ENTER ao final, para confirmar.
A segunda pergunta se refere quantidade de
lanamentos (novos registros adicionados) que iro ser
feitos. O sugere 1, neste caso, confirme pressionando
ENTER.
O prximo menu apresentado refere-se execuo ou
no dos processos e lanamentos definidos no arquivo
alvo deste lanamento. Neste nosso exemplo, no
foram definidos processos e lanamentos para o
arquivo alvo (FNDPROD), por esta razo, vamos
selecionar No deste menu.
J definimos que este lanamento s ser feito se o
fornecedor do produto no for encontrado no arquivo
alvo FNDPROD, para o produto cadastrado.
Vamos passar ao GAS-Pro essa informao (condio
para incluso). Se estiver com a ajuda ativa ligada
(ALT-F1 se no estiver), estar vendo que a tecla F8
serve para testar a existncia em outro arquivo.
Portanto, pressione F8, e selecione como arquivo alvo
da pesquisa FNDPROD. Selecione do menu
seguinte, o arquivo ITENS e o seu campo produto.
A tela da figura VII.35 ser apresentada.
Manual do Usuri o
349
Figura VII.35
Pressione ESC em seguida e observe que o GAS-Pro
nos apresentou novamente o menu de arquivos para a
escolha de novos campos. Dessa vez, selecione
NOTAS e o seu campo fornec. OK! O GAS-Pro
automaticamente montou uma expresso.
No pressione ENTER ainda! Temos que completar a
informao do GAS-Pro com um detalhe fundamental.
Sem ele o lanamento funcionar todo ao contrrio.
Pressione a tecla HOME (para ir ao inicio do campo),
ligue a insero (com INS ou ^V) e coloque uma
exclamao (!) seguida de um espao, na frente de
PTAB(.... o GAS-Pro montou a validao, porm, o
lanamento dever ser feito somente se esta validao
falhar. Por isso, temos que colocar o operador NOT
(representado pela !) na frente da expresso. Um
lanamento, como j vimos, cria um registro novo no
arquivo alvo.
A prxima pergunta a ser respondida, a condio
para excluso deste lanamento. Normalmente, em
todo lanamento, quando feita a excluso do registro
que gerou o lanamento, este desfeito atravs da
excluso do registro lanado. Entretanto, neste nosso
exemplo, no queremos que isto acontea pois, podem
existir vrias NF do mesmo fornecedor com o mesmo
produto e, se acontecer de um desses ser excludo,
tambm ser excludo o registro do produto/
fornecedor. Portanto, vamos colocar uma expresso
utilizando o campo controle que definimos no
Manual do Usuri o
350
arquivo alvo, para excluir o lanamento somente se o
produto referenciado no existir em outras NF.
Pressione F10, selecione o arquivo FNDPROD e seu
campo controle. Complete esta informao conforme
abaixo:
FNDPROD->controle = 0
Agora, vamos dizer ao GAS-Pro o que deve ser
colocado nos campos desse novo registro.
Pressione ENTER e a tela da figura VII.36 ser
apresentada.
Figura VII.36
Pressione ENTER sobre o campo cdigo e vamos
dizer ao GAS-Pro que, neste campo dever ser
colocada a informao do cdigo do produto que est
entrando em estoque. Pressione F10, selecione
ITENS e capture produto, pressionando ENTER
em seguida.
Depois, selecione o campo fornec e vamos fazer a
mesma coisa, s que o cdigo do fornecedor ser
capturado do arquivo pai. Pressione F10, selecione
NOTAS e capture o campo fornec, pressionando
ENTER em seguida.
Pronto! Terminamos a definio do lanamento. O
campo controle ser atualizado atravs de processos
Manual do Usuri o
351
que definiremos mais adiante, tendo o seu valor inicial
igual a 0. Por isso, no foi definido contedo para este
campo.
Agora vamos definir os processamentos gerados a
partir da digitao de um item da nota. A medida que
os itens so digitados, temos que:
creditar a quantidade correspondente no estoque
(arquivo PRODUTOS);
atualizar o preo de custo com o preo de custo
unitrio;
atualizar o preo indexado pelo preo de custo
unitrio convertido;
modificar a data da ltima atualizao para a data de
entrada do produto;
atualizar o valor total da NF dentro do arquivo
Notas e
incrementar o campo controle dentro do arquivo
FNDPROD (necessrio para a condio de excluso
dos lanamentos).
Selecione Processamentos e pressione F10
escolhendo PRODUTOS. Pressione novamente a
tecla F10 e selecione o campo qd_est, pressionando
ENTER para aceitar o que foi capturado.
Este processo incondicional; portanto, pressione
ENTER novamente, deixando a informao de
condio em branco.
Para frmula direta, pressione F10, selecione o
arquivo PRODUTOS e seu campo qd_est.
Complete esta informao com a quantidade digitada,
de modo que fique da seguinte maneira:
PRODUTOS->qd_est+quant
Manual do Usuri o
352
Para a frmula inversa, pressione F8 (para trazer a
frmula direta), troque o sinal positivo por negativo e
pressione ENTER, de modo que fique assim:
PRODUTOS->qd_est-quant
O primeiro processamento ficou pronto. Agora,
pressione INS para fazer o segundo:
O arquivo alvo ser sempre o mesmo, ou seja, o
arquivo de PRODUTOS; portanto, escreva
diretamente PRODUTOS pressionando ENTER. Em
seguida, pressione F10 e capture o campo
preco_cus. Pressione ENTER novamente para a
condio, pois o processo ser feito
incondicionalmente. Agora, acione a tecla F10
selecionando ITENS e seu campo pre_cus_un.
Pressione ENTER duas vezes para retornar ao menu de
processamentos.
O terceiro processamento semelhante a este, s que
alteraremos o preo de custo indexado.
Pressione INS para inserir outro processamento e
informe PRODUTOS para arquivo alvo, e
preco_ind para campo alvo. Para condio,
pressione ENTER deixando-a em branco. A seguir,
para a frmula direta, pressione F10, selecione
PRODUTOS e o seu campo preco_cus. Complete
com uma barra / (operador diviso) e pressione
novamente F10 para selecionar o arquivo INDEXAD
e seu campo valor. Pressione ENTER duas vezes
para retornar ao menu de processamentos.
Pressione INS para inserir o processo de atualizao do
valor total da NF. Informe o que segue:
Arquivo alvo...: NOTAS
Campo alvo......: valor
Condio..........:
Frmula direta..: NOTAS->valor+(quant*pre_cus_un)
Manual do Usuri o
353
Frmula inversa: NOTAS->valor-(quant*pre_cus_un)
Pressione INS para inserir o processo no campo
controle, respondendo o que segue:
Arquivo alvo...: FNDPROD
Campo alvo......: controle
Condio..........:
Frmula direta..: FNPROD->controle+1
Frmula inversa: FNPROD->controle-1
Finalmente, pressione INS e informe o ltimo
processamento conforme se segue:
Arquivo alvo....: PRODUTOS
Campo alvo.......: dt_ult_atu
Condio...........:
Frmula direta...: DATE( )
Frmula inversa:
Pronto, criamos os processamentos no arquivo produto
para cada item de produto digitado na nota fiscal.
Pressione ESC at retornar ao modelador do projeto.
O projeto dever estar com o aspecto da figura VII.37.
Manual do Usuri o
354
Figura VII.37
Agora criaremos um tipo de mdulo diferente dos que
criamos at agora. Faremos uma tela complementar
para que o nosso usurio possa fazer ajustes de
estoque.
Normalmente, ao inserir um subsistema de arquivo
DBF, temos que criar uma tela associada para a entrada
das informaes no arquivo. Fizemos isso para todos
os mdulos que criamos neste sistema exemplo. O
GAS-Pro nos permite criar diversas telas
complementares para associar a um subsistema j
existente e definido no projeto. Nessas telas
complementares, poderemos entrar com apenas alguns
campos que interessam ser acessados, atuando
diretamente sobre o arquivo associado a um
subsistema.
Vamos criar uma tela complementar para o subsistema
PRODUTOS que nos permita apenas atuar sobre o
campo quantidade em estoque (lembra-se de que, ao
elaborarmos a tela de PRODUTOS deixamos esse
campo sem posicionar?).
Selecione Movimentao e pressione a tecla INS
para inserir o novo mdulo. Selecione Tela
complementar e, com ou sem o auxlio da tecla F10,
informe os seguintes dados genricos:
Arquivo atributos: AJU_ESTO
Arquivo (DBF).....: PRODUTOS
Manual do Usuri o
355
Ttulo cabealhos: Ajuste de quantidades em estoque
Ttulo abreviado...: Ajuste de estoque
Observe que, no caso de tela complementar, tivemos
de informar ao GAS-Pro um nome de arquivo de
parmetros para armazenar informaes.
Faa a insero deste mdulo, logo abaixo de Entrada
de produtos. Em seguida, pressione ENTER sobre este
mdulo que acabamos de inserir.
Verifique que o menu Definio da tela
complementar semelhante ao que vimos para
subsistema DBF, com menos opes. As definies de
atributos, por exemplo, no esto presentes neste menu
porque foram feitas durante a definio de
PRODUTOS.
Entre em Opes, marque Digitao com rolagem
e retorne com ESC.
Vamos definir uma frmula para mostrar nesta tela
complementar. Entre em Frmulas & campos
externos e, quando for entrar com o ttulo da frmula,
pressione F10, selecione o arquivo PRODUTOS e
capture o campo produto, atravs do menu.
Confirme as demais informaes com ENTER. Quando
chegar ao menu Frmulas, pressione ESC para
retornar ao menu de Definio da tela
complementar.
Agora podemos definir a tela para ajuste de
quantidades em estoque. Entre em Definio da tela
e, utilizando os recursos de formatao da tela, elabore
e posicione a frmula, conforme aparece na figura
VII.38. Observe que, aqui, a tecla ALT-T no ajuda
muito pois, usaremos somente dois campos do arquivo.
Manual do Usuri o
356
Figura VII.38
Somente dois campos do arquivo PRODUTOS e uma
frmula foram posicionados nesta tela: o cdigo do
produto, a quantidade em estoque e a descrio do
produto.
Pressione ESC, salve a tela e pressione ESC novamente
para chegar ao modelador do projeto.
Neste ponto, todo o mdulo e entrada de produtos em
estoque est pronto.
Precisamos agora, criar um subsistema para as
movimentaes de sada de produtos.
Posicione a barra seletora em Movimentao,
pressione INS e defina um novo subsistema DBF com
os seguintes dados genricos:
Arquivo (DBF).....: SAIDAS
Ttulo cabealhos: Sada de produtos do estoque
Ttulo abreviado..: Sada de produtos
Cdigo da ajuda..: 5
Manual do Usuri o
357
Faa a insero deste subsistema exatamente aps a
opo Entrada de produtos.
Agora, selecione este novo subsistema e pressione
ENTER sobre ele.
Entre em Opes, marque Digitao com rolagem.
Retire a marcao de Chave primria. Este
subsistema ter chave do tipo no primria, ou seja,
poder conter diversos cdigos de produtos iguais.
Pressione ESC para retornar.
Selecione Menu de subsistema. Pressione ENTER
sobre a opo Incluso e altere para Baixa
estoque. Em seguida, posicione sobre a opo
Manuteno e pressione a tecla DEL, confirmando o
apagamento. Finalmente, pressione ENTER sobre
Consulta e altere para Consulta sadas,
pressionando ESC em seguida para retornar ao menu
Definio do subsistema.
Vamos definir apenas quatro campos para este ltimo
subsistema DBF. Selecione Definio de atributos
(campos) e inicie a definio.
O primeiro campo do arquivo deste subsistema vamos
definir rapidssimo, utilizando o dicionrio de dados
ativo do GAS-Pro. Antes de digitar qualquer
informao para Nome, pressione a tecla F10,
selecione o arquivo ITENS e, em seguida, o campo
produto. O GAS-Pro colocou tudo o que
precisvamos, inclusive, aquela interface no comando
especial. Pressione ENTER at o final para confirmar.
Vamos agora criar um campo para armazenar a data da
sada do produto e um outro para armazenar um
documento de sada do produto. Pressione INS e
informe o seguinte:
Nome............: data
Tamanho.......: 8
Tipo...............: Data
N decimais...: 0
Manual do Usuri o
358
Mscara.........: @D
Larg. edio...: 8
Ttulo..............: Data
Texto ajuda....: Informe a data de sada do produto
Cmd especial.:
Pr-validao:
Validao.......: !EMPT(data)
Mensagem.....: Necessrio informar DATA DE
SADA
Valor inicial....: DATE()
Seqncia......:
Agora, pressione INS para criarmos o campo a seguir:
Nome...........: quant
Tamanho.....: 6
N decimais..: 0
Mscara........: 999999
Larg. edio..: 6
Ttulo.............: Quantidade
Texto ajuda...: Informe a quantidade que est saindo
Cmd especial.:
Pr-validao:
Validao.......:
Para a validao, teremos que pensar!... Quando o
usurio estiver digitando esta quantidade, s
poderemos deix-lo ir adiante se a quantidade digitada
for maior do que 0 e, ainda, que seja menor ou igual
Manual do Usuri o
359
quantidade existente em estoque (outro arquivo), para
podermos descontar o que sai. Como poderemos fazer
isso? Novamente, com o dicionrio de dados ativo do
GAS-Pro.
Quando o GAS-Pro sugerir quant>0, complete com
.AND. e pressione F10 em seguida. O GAS-Pro
colocar um menu com os arquivos relacionados com
este. Selecione o arquivo PRODUTOS e o campo
qd_est. O GAS-Pro completou com a informao do
campo que iremos comparar no arquivo de
PRODUTOS. Agora, ns mesmos completaremos a
validao. Digite > quant. A expresso completa
dever estar assim:
Validao: quant > 0 .AND. PRODUTOS > qd_est >
quant
Agora trocaremos a mensagem para algo mais
apropriado. Modifique para:
Mensagem: Quantidade ilegal ou insuficiente em
estoque.
Pressione ENTER at o final das definies deste
campo. Finalmente, vamos criar o campo da
quantidade de sada do produto. Pressione INS e
informe:
Nome..........: valor
Tamanho....: 12
N decimais.: 2
Tipo acesso: Editvel
Mscara.......: 999999999.99
Larg. edio.. 12
Ttulo.............: Valor Total
Manual do Usuri o
360
Texto ajuda...: Informe o valor total do item
Cmd especial.:
Pr-validao:
Validao.......: valor>0
Mensagem.....: VALOR TOTAL no aceitvel
Valor inicial....:
Seqncia......:
Pressione a tecla ESC no menu de campos, para
retornar ao menu anterior.
Definiremos uma frmula para mostrar na tela a
descrio do produto. Selecione Frmulas & campos
externos, e pressione F10 antes de entrar com o ttulo
da frmula, no menu de arquivos, selecione
PRODUTOS e, do menu seguinte, o campo
produto. Pressione ENTER para aceitar todas as
informaes e ESC para retornar ao menu anterior.
Selecione Definio da tela e defina uma tela
parecida com a da figura VII.39.
Figura VII.39
Pressione ESC e salve a tela retornando ao menu
anterior.
Manual do Usuri o
361
Entre em Chaves de acesso e informe Produto para
o ttulo. Marque o campo de mesmo nome e pressione
ESC at retornar ao menu anterior.
H ainda uma coisa importante a fazer. Temos de
definir um processamento externo que, no momento da
digitao de sada (este arquivo) desconte a quantidade
que saiu da quantidade existente em estoque (contida
no arquivo PRODUTOS). Vamos ver como podemos
fazer isso.
Selecione Processamentos. Para arquivo alvo,
pressione F10 e escolha PRODUTOS ( neste
arquivo que est armazenada a quantidade em
estoque). Para campo alvo, pressione novamente F10 e
selecione qd_est, seguido de ENTER. No
estabeleceremos condio para o processamento,
portanto, pressione ENTER. A frmula direta dever
descontar a quantidade que sai da quantidade que
existe em estoque. Ento, pressione F10, selecione
PRODUTOS e seu campo qd_est. Coloque um -
(menos) na frente e pressione novamente F10,
selecionando desta vez, o arquivo SAIDAS (que
estamos definindo) e seu campo quant. O GAS-Pro
montou a nossa expresso.
Agora, vamos para a frmula inversa, vamos usar o
clipboard que mais rpido. Dentro do campo da
frmula direta, pressione ÔC (CTRL-O-C). Pressione
ENTER para passar para o campo seguinte (frmula
inversa) e digite ÔR (CTRL-O-R). Troque apenas o
sinal - para + dentro da frmula e pressione
ENTER.
OK! O nosso sistema de estoque est quase pronto! A
parte de cadastro, consultas, relacionamentos,
processamentos, lanamentos, telas, etc. est toda
pronta. Agora, vamos entrar numa segunda fase, que
a de oferecer ao nosso usurio os meios de extrair as
informaes desta aplicao. Muitas informaes
podem ser retiradas dos arquivos definidos neste
projeto; porm, para efeito didtico, vamos formatar
apenas quatro relatrios e um programa emissor de
etiquetas de preo de produtos.
Pressione ESC at retornar ao modelador do projeto.
Manual do Usuri o
362
Como teremos trs tipos de emisso na nossa aplicao
(relatrioo, etiqueta e grfico), vamos criar um menu,
abaixo do menu principal, intitulado Emisso.
Abaixo dele, vamos separar a emisso de relatrios,
etiqueta e grfico.
Tambm, nesta parte da definio, vamos fazer um
pouco diferente. Vamos montar as opes na rvore do
projeto para depois fazer as definies de cada um.
Posicione a barra seletora sobre o ttulo do projeto
Controle de estoques, pressione INS, selecione
Menu e digite Emisso para o ttulo.
Vamos inserir a emisso logo aps Tabelas;
portanto, posicione a barra seletora em Tabelas e
pressione ENTER.
Com a barra posicionada em Emisso, pressione INS
e crie um outro menu entitulado Relatrios.
Agora, com a barra posicionada em Relatrios,
pressione INS e crie um relatrio com os seguintes
dados genricos. Lembre-se de usar a tecla F10 para
ajud-lo, quando necessrio.
Nome do programa: EST_R001
Arquivo principal..: PRODUTOS
Ttulo para menu...: Tabela de preos
Ttulo processos..: Tabela de preos
Reposicione a barra em Relatrios, pressione INS e
crie um novo relatrio como os dados genricos:
Ttulo para menu....: Produtos ponto de pedido
Manual do Usuri o
363
Cdigo da ajuda.....: 11
Insira-o abaixo do relatrio anterior Tabela de
preos.
Mais uma vez, reposicione a barra seletora em
Relatrios, pressione INS e crie o terceiro relatrio
com os dados genricos a seguir:
Arquivo principal..: NOTAS
Ttulo para menu....: Notas fiscais recebidas
Cdigo da ajuda.....: 11
Insira-o abaixo do relatrio anterior Produtos ponto
de pedido.
Aqui existe uma particularidade. Os relatrios
baseados em arquivos de subsistemas relacionados
(pai/filho) devem ser inseridos na rvore da mesma
maneira como foram inseridos anteriormente como
subsistemas. O relatrio que acabamos de inserir ir
tratar dos dados da nota fiscal (NOTAS). Os itens da
nota fiscal esto armazenados em ITENS. Portanto,
vamos inserir um relatrio debaixo do outro. No
momento da gerao dos programas fontes, o GAS-
Pro tratar os dois (ou mais, se houvesse), como se
fossem um s, gerando um nico programa fonte para
eles.
Posicione a barra sobre Notas fiscais recebidas,
pressione INS e crie um relatrio com os seguintes
dados genricos:
Manual do Usuri o
364
Arq de atributos..: EST_R004
Arquivo principal: ITENS
Ttulo para menu.: Produtos da NF
Colocaremos agora o ltimo relatrio deste nosso
exemplo. Posicione a barra sobre Relatrios,
pressione INS e crie um relatrio com os dados
genricos:
Arquivo principal..: SAIDAS
Ttulo para menu...: Sada de produtos
Posicione a barra sobre Notas fiscais recebidas e
pressione ENTER. Este relatrio ficar posicionado em
ltimo lugar no menu de relatrios.
Agora, vamos inserir um programa emissor de
etiquetas.
Posicione a barra seletora em Emisso, pressione
INS e selecionte Etiqueta com os seguintes dados
genricos:
Nome do programa: EST_E001
Ttulo para menu...: Etiqueta de preo
Manual do Usuri o
365
Vamos inserir esta opo aps Relatrios, portanto
pressione ENTER sobre esta opo. A definio do
grfico vamos deixar para mais adiante.
Agora, o nosso projeto dever estar com a sua
aparncia final, conforme a figura VII.40.
Figura VII.40
Podemos, a seguir, selecionar um por um os relatrios
inseridos no projeto e defin-los. Pressione ENTER
sobre Tabela de preos, e entre em Definio dos
contedos. Neste ponto, o GAS-Pro nos oferece duas
opes: definir os contedos um a um (como fizemos
com os campos dos subsistemas) ou encher os
contedos aproveitando os campos do arquivo
PRODUTOS, que informamos nos dados genricos
como bsico para o relatrio.
Selecione a segunda opo e observe que o GAS-Pro
criou todos os contedos a partir daquele arquivo.
Observe tambm que esta interface nos bastante
familiar. Trata-se da mesma interface que usamos na
definio de campos dos subsistemas (DBF). Deste
modo, se precisarmos inserir mais contedos, j
sabemos como fazer. Vamos criar ento, mais um nico
contedo: o preo de venda do produto.
Pressione INS e entre com as seguintes informaes,
lembrando que a facilidade de dicionrio de dados
ativo do GAS-Pro (teclas F8/F10) poder ajud-lo.
Manual do Usuri o
366
Ttulo.......: Preo venda
Contedo: preco_cus+(preco_cus*lucrobruto/100)
Mscara...: @E 99,999,999.99
Tamanho..: 13
Tipo..........: Numrico
Varivel....:
Condio..:
Opes.....:
Como o GAS-Pro j colocou para ns os demais
contedos, para facilitar, vamos apagar alguns deles
que no nos interessam. Utilizando a tecla DEL,
apague os seguintes contedos que no faro parte
deste relatrio.
Referncia tcnica
Qd min
Preo custo
Preo indexado
L bruto
Data atualizao
Aqui, como nas telas de digitao que definimos, a
tecla F4 serve como hot-key para nos colocar
imediatamente na tela de formatao de relatrios e
vice-versa. Se desejar experimentar, pressione F4 e,
quando estiver na janela de formatao, pressione F4
novamente.
Vamos, dessa vez, pressionar ESC para retornar ao
menu anterior e entrar em Opes do relatrio, para
ver o que o GAS-Pro nos sugere.
A tela da figura VII.41 dever estar aparecendo.
Manual do Usuri o
367
Figura VII.41
Normalmente, as opes que o GAS-Pro oferece no
precisam ser modificadas na maioria dos relatrios.
Neste caso, estamos passando ao GAS-Pro a
informao de que o nosso relatrio utilizar uma
pgina de 66 linhas, a primeira coluna de impresso
ser a 0, estamos reservando 6 linhas para o cabealho
do relatrio e 3 para o rodap. Para nosso exemplo,
est satisfatrio.
Pressione ESC e selecione Aspecto. No menu de
aspecto, tambm, as opes atendem maioria dos
relatrios inclusive este nosso primeiro exemplo.
Pressione ESC e selecione Formatao do relatrio.
A formatao de relatrios feita atravs dessa janela,
com a mesma interface utilizada para a formatao da
tela. Temos aqui os mesmos recursos, como por
exemplo, letras expandidas, posicionamento de
campos com setas ou mouse, desenho diretamente
sobre o relatrio, etc. Inclusive, temos a tecla ALT-T
para construir relatrios padro.
Observe que as linhas reservadas para cabealho e
rodap aparecem em cor diferente (dependendo dos
esquemas de cores configurados). Se desejar
experimentar, pressione F10 ou F6, selecione um
contedo qualquer que tenha sido definido e observe
que o posicionamento feito exatamente como na tela.
Quando terminar, pressione ALT-T para construir um
relatrio igual ao que aparece na figura VII.42. Ao
Manual do Usuri o
368
pressionar ALT-T, o GAS-Pro vai solicitar trs
informaes adicionais que so:
Sentido para dispor os contedos - selecione
horizontal
Coluna inicial - informe 1
Espao entre um campo e outro - informe 3
Figura VII.42
Pronto! A est o relatrio. Agora, pressione ESC,
salve o relatrio e retorne para o modelador do projeto.
Agora, vamos definir o relatrio Produtos ponto de
pedido. Este relatrio listar os produtos que esto
com estoque abaixo da quantidade mnima
estabelecida para cada um deles. Pressione ENTER
sobre esta opo.
Selecione Definio dos contedos e Usar campos
de PRODUTOS.
Aqui tambm, no vamos precisar de todos os
contedos. Apague os contedos a seguir,
posicionando a barra seletora sobre eles, pressionando
DEL e confirmando com ENTER.
Preo custo
Preo indexado
Manual do Usuri o
369
L bruto
Data atualizao
Pressione F4 para acessarmos diretamente a janela de
formatao do relatrio.
Para este relatrio, pelo menos, vamos seguir passo a
passo a sua formatao para conhecer os recursos de
posicionamento de campos. O resultado final ser o
mesmo relatrio padro que seria gerado com ALT-T.
As posies de linha e coluna que forem mencionadas
nas explicaes a seguir podem ser vistas na linha
inferior, do lado esquerdo, da janela de formatao.
Sero referenciadas sempre deste modo: linha, coluna.
Por exemplo, para nos referirmos posio linha 6,
coluna 23, diremos apenas 6,23.
Lembre-se de que posicionamento de contedos pode
ser feito com as setas cursoras ou com o mouse (se
existir). Para fixar o contedo em uma posio,
pressione ENTER (ou libere o boto direito do mouse).
Quando falarmos em captura de contedo do menu,
queremos dizer que a barra seletora deve ser
posicionada sobre ele e a tecla ENTER deve ser
pressionada.
Com essas explicaes preliminares, podemos
comear:
Primeiro colocaremos as mensagens fixas e as
variveis de sistema (tecla F6)
Movimente o cursor para 3,1 e digite o ttulo do
relatrio
PRODUTOS EM PONTO DE PEDIDO
Pressione F6, capture a varivel Nome da empresa
posicionando-a em 1,1;
Posicione o cursor em 2,1. Pressione F6, capture a
varivel Ttulo aplicao e pressione ENTER para
fix-la.
Manual do Usuri o
370
Capture Ttulo a definir com F6 e posicione em
4,1.
Tecle novamente F6, capture Nmero da pgina e
posicione em 1,91
Verifique se o modo de insero est desligado
(quando ligado, o cursor tem a forma de um bloco
retangular; desligado, apenas duas linhas na base dos
caracteres) e, um pouco mais esquerda, em 1,84,
escreva Pgina.
Pressione novamente F6 e capture Cdigo
relatrio, posicionando-o em 2,87.
Agora, tecle novamente F6, capture Data do
sistema e posicione em 3,87.
Capture, tambm com F6, a varivel Dia da
semana e posicione em 3,79.
Pronto! Posicionamos as variveis de sistema. Agora
vamos aos contedos, que so todos capturados com
F10.
Pressione F10, capture cdigo e posicione em 7,1.
Repita para o campo Descrio do produto,
posicionando-o em 7,8
Faa o mesmo para Unid e posicione em 7,39.
Capture o contedo Referncia tcnica (campo
memo) e posicione em 7,43.
Capture Qde Est posicionando em 7,80.
Finalmente, capture Qde Min e posicione em 7,91.
Ok! Posicionamos todos os campos. Agora vamos
colocar os ttulos das colunas.
Em 5,1 escreva Cdigo;
Posicione em 5,8 e escreva Descrio do produto;
Manual do Usuri o
371
Em 5,37 digite Unid;
Escreva Referncia tcnica em 5,43;
Em 5,79 escreva Qde Est;
Digite em 5,88 o ttulo Qde Min.
Vamos agora tracejar toda a linha 6, at a posio da
coluna 94 e o nosso relatrio estar pronto, com o
aspecto semelhante ao da figura VII.43.
Figura VII.43
Somente para ilustrar, vamos criar um rodap para este
relatrio.
Posicione o cursor em 6,1 e pressione ^KB para
marcar o incio do bloco;
Movimente para 6,94 (a tecla END faz isso de uma
s vez) e pressione ^KK para marcar o final do
bloco;
Agora, pressione HOME e PGDN trs vezes. Ajuste
a posio do cursor em 64,1 e pressione ^KC para
copiar o bloco para esta posio.
Pressione ^KH para desmarcar o bloco
Posicione o cursor em 65,1 e digite: Emitido
Manual do Usuri o
372
Pressione F6 e capture a varivel Hora da
emisso, posicionando em 65,9.
Pronto! O relatrio est formatado. Pressione CTRL-
PGUP seguido de END para posicionar o cursor na
ltima posio do nmero da pgina. Nosso relatrio
est com 94 posies de largura e no caber em um
formulrio comum de 80 colunas. Vamos dizer ao
GAS-Pro para emit-lo em caracteres elite, com
densidade de 12 caracteres por polegada.
Pressione ESC e salve o relatrio. A seguir, selecione
Aspecto e marque a opo Compresso em 12 cpp.
Sempre que imprimir campo memo no relatrio
bom utilizar espacejamento duplo para separar bem a
ltima linha do campo memo e a linha do prximo
registro impresso. Vamos assinalar tambm esta opo.
Aproveite para marcar tambm a primeira opo,
Quantificar registros. Esta opo forar o GAS-Pro
a criar uma linha ao final do relatrio dizendo quantos
registros fazem parte da listagem. Pressione ESC para
Agora, precisamos dizer ao GAS-Pro que este
relatrio ir conter somente os produtos cuja
quantidade em estoque esteja menor do que a
quantidade mnima estabelecida.
Posicione a barra seletora em Filtragem inicial e
pressione ENTER. A seguir, pressione F10, selecione
PRODUTOS e o seu campo qd_est. Digite na
frente da sugesto do GAS-Pro a expresso <=
(menor ou igual). Em seguida, pressione novamente
F10 e capture de PRODUTOS o campo qd_min e
confirme com ENTER.
Esta expresso selecionar os registros que atenderem
a esta condio.
Pressione ESC para retornar ao modelador do projeto.
Vamos agora fazer o relatrio relacionado que
inserimos no projeto (notas/itens).
Selecione Notas fiscais recebidas e defina contedos
usando campos de NOTAS.
Manual do Usuri o
373
Pressione ESC e selecione Relacionamentos. Vamos
estabelecer um relacionamento para imprimir neste
relatrio o campo Nome do fornecedor, que existe
no subsistema Tabela de fornecedores.
Selecione FORNEC, e o ndice associado Cdigo.
Em seguida, selecione o arquivo NOTAS e seu
campo fornec para terminar o relacionamento.
Pressione ESC para abandonar Relacionamentos e
entre novamente em Definio de contedos,
utilizando-se dos campos de NOTAS. Posicione a barra
seletora sobre Fornecedor e pressione INS para
inserir um outro contedo. Utilize a tecla F10 para
apresentar os arquivos relacionados e selecione
FORNEC e seu campo nome. Pressione ENTER
at o final das definies para aceitar o que o GAS-
Pro sugeriu. A tela de contedos dever estar
conforme a figura VII.44.
Figura VII.44
Agora podemos pressionar F4 e formatar o relatrio
(parte dos dados principais da nota fiscal).
Pressione ALT-T para fazer um relatrio padro.
Selecione a disposio horizontal, informando 1 para
coluna inicial e 1 para espao entre os campos.
Posicione o cursor na linha 1 e pressione END.
Observe que este relatrio, pelos parmetros que
informamos, ficou com posies adicionais de largura.
Faa alguns ajustes para que fique com a largura de 77.
Manual do Usuri o
374
Pressione ESC salve o relatrio, entre em Aspecto e
marque a opo Usar espacejamento duplo.
Fizemos a primeira parte deste relatrio! Agora,
retorne ao modelador do projeto e selecione Produtos
da NF para criarmos a parte dos itens de produtos da
nota fiscal.
Selecione Definio dos contedos e utilize os
campos de ITENS.
Posicione a barra seletora sobre Produto e pressione
INS. Vamos inserir contedos de campos de outros
arquivos, utilizando uma outra maneira de fazer
relacionamento.
Pressione F8 de dentro do titulo do contedo,
selecione o arquivo PRODUTOS e o ndice
associado cdigo. Selecione em seguida o arquivo
ITENS (que o que estamos utilizando) e o seu
campo produto. Finalmente, do menu Campo a ser
capturado selecione produto. Pronto! J temos a
descrio do produto para colocar no relatrio. Agora
v pressionando ENTER para aceitar as informaes
que o GAS-Pro sugeriu.
A seguir, com a barra seletora posicionada em
Descrio do produto, pressione novamente a tecla
INS. Desta vez, vamos utilizar a tecla F10 para pegar
os arquivos relacionados. Selecione PRODUTOS
(que acabamos de relacionar) e seu campo Unid,
pressionando ENTER para aceitar as demais
informaes.
Vamos definir s mais um contedo para este relatrio.
Podemos definir um preo total, formado pela
multiplicao da quantidade do item de produto pelo
seu preo unitrio.
Posicione a barra seletora sobre Custo unitrio e
pressione INS. Vamos, para variar, escrever
manualmente este contedo. Responda:
Ttulo.......: Custo total
Contedo: quant*pre_cus_un
Mscara...: @E 99,999,999.99
Manual do Usuri o
375
Tamanho..: 13
Tipo...........: Numrico
Condio...:
Opes.......:
A seguir, vamos solicitar uma totalizao desta coluna.
Quando aparecer o menu de opes do contedo,
marque a opo Totalizar a coluna, conforme
aparece na tela da figura VII.45.
Figura VII.45
J temos todos os contedos que precisamos. Agora
podemos acionar F4 para formatar o restante do
relatrio.
Observe que a janela veio diferente. A primeira parte
do relatrio que fizemos anteriormente aparece por
baixo da janela do relatrio atual. Quando for gerar os
programas fontes, o GAS-Pro ir gerar um s
programa contendo o que foi definido nas duas (ou
mais) janelas.
Vamos utilizar ALT-T para fazer o relatrio padro. S
que vamos usar um nmero maior para a coluna inicial,
forando o relatrio um pouco para a direita. Pressione
ALT-T, com disposio horizontal, e informe:
Coluna inicial: 40
Manual do Usuri o
376
Espao entre um campo e outro: 2
O nosso relatrio dever estar de acordo com a figura
VII.46.
Figura VII.46
No se preocupe pelo fato deste relatrio ficar
deslocado para a direita. Vamos utilizar caracteres
comprimidos para imprim-lo, de modo que ficaro
com uma boa disposio.
Pressione ESC e salve este relatrio. Em seguida,
vamos interferir no aspecto deste relatrio. Selecione
Aspecto e marque a opo Compresso 17,5 cpp.
Retorne ao modelador do projeto. Vamos formatar o
ltimo relatrio colocado no projeto.
Selecione o relatrio Sada de produtos.
Vamos, primeiramente, estabelecer um
relacionamento. Selecione Relacionamentos. Do
menu de arquivos a relacionar, selecione
PRODUTOS e do prximo menu, o ndice
relacionado cdigo.
Depois, selecione o arquivo SAIDAS e o seu campo
produto. Tecle ESC em seguida.
Selecione e defina os contedos usando campos de
SAIDAS. Pressione DEL sobre o primeiro campo
Manual do Usuri o
377
Produto deixando apenas os contedos data,
quantidade e valor total.
Pressione F4 para acessar a janela de formatao.
Vamos fazer um relatrio padro utilizando ALT-T,
com disposio horizontal. Responda com:
Coluna inicial: 1
Espao entre um campo e outro: 12
Vamos informar alguns detalhes a mais ao GAS-Pro.
Pressione F4 e salve o relatrio para acessar o menu de
contedos.
Selecione o contedo Data e v pressionando
ENTER at que o menu de opes do campo fique
disponvel. Marque a opo Omitir, se igual anterior
e selecione Continuar definio e pressione ENTER
para voltar ao menu.
Vamos agora definir uma quebra ou agrupamento para
este relatrio. Pressione ESC para retornar ao menu
Definio do relatrio e selecione Quebras
(agrupamentos).
Para ttulo da quebra, pressione F10 e selecione o
prprio arquivo SAIDAS e o campo produto em
seguida.
Complete a informao que o GAS-Pro colocou para
que fique como se segue:
Ttulo: produto+-+
Deixe o cursor posicionado aps o ltimo + e
pressione novamente F10 para utilizarmos aquele
relacionamento que fizemos no incio da definio
deste relatrio. Selecione o arquivo PRODUTOS e o
campo produto em seguida. Pressione ENTER para
aceitar a montagem e vamos agora definir a expresso
que comandar a quebra.
Manual do Usuri o
378
Pressione F10, selecione o arquivo SAIDAS e, em
seguida, o campo produto.
Quando aparecer o menu de opes da quebra,
selecione Continuar definio e pressione ESC.
Selecione Ordem inicial, pressione F10, selecione o
arquivo SAIDAS e o campo produto teclando
ENTER. Pressione ESC at retornar ao modelador do
projeto.
Todos os relatrios, esto prontos. Para terminar toda a
aplicao, falta somente definir o programa de
etiquetas.
A definio da etiqueta em quase nada difere da
definio de relatrios, como veremos a seguir:
Selecione Etiqueta de preo e entre em Opes da
etiqueta. Vamos alterar a altura da etiqueta para
apenas 4 linhas. Pressione ENTER sobre esta opo e
digite 4 seguido de ENTER. Depois, tecle ESC para
Selecione Definio dos contedos. Observe que
para a etiqueta no temos a opo de aproveitar os
campos do arquivo bsico da etiqueta.
Para ttulo do primeiro contedo, pressione F10,
selecione o arquivo PRODUTOS e o campo
produto. Confirme com ENTER at o final.
V pressionando INS e repetindo esta operao para os
campos cdigo e Unid.
A seguir, vamos montar um contedo que nos d o
preo de venda.
Para o ttulo deste contedo escreva Preo venda e
pressione ENTER. Este contedo envolve dois campos
do arquivo bsico da etiqueta, de modo que mais
fcil escrever diretamente a frmula:
preco_cus+(lucrobruto*preco_cus/100)
Manual do Usuri o
379
Digite o restante das informaes. Ao final, este
contedo dever estar igual ao que aparece na tela da
figura VII.47.
Figura VII.47
Neste momento conheceremos mais um recurso que o
GAS-Pro permite em etiquetas e relatrios. Vamos
imprimir dois desses contedos com atributo
expandido.
Selecione os campos Cdigo e Preo venda e v
pressionando ENTER at que o menu de opes
aparea, e ento marque a opo Imprimir em
expandido neste menu e continue a definio.
Agora, s nos resta formatar a etiqueta. Pressione F4
para acessar diretamente a janela de formatao.
Pressione ALT-T para formatar uma etiqueta padro.
Utilizando a tecla F10, reposicione alguns campos
para ficar igual ao que aparece na tela da figura
VII.48.
Manual do Usuri o
380
Figura VII.48
A palavra Cdigo que aparece no meio da etiqueta,
foi digitada diretamente na janela de formatao.
Pressione ESC, salve a etiqueta e retorne ao menu
Modelador do projeto.
Finalmente, vamos definir um grfico para demonstrar
as sadas mensais, em valores, dos produtos ms a ms.
Posicione a barra seletora sobre a opo Emisso e
pressione a tecla INS. Do menu seguinte, selecione a
opo Grfico e responda s seguintes perguntas:
Nome do programa..: EST_G001
Arquivo principal....: SAIDAS
Ttulo para menu......: Sadas mensais
Ttulo processos......: Sadas mensais
Cdigo de ajuda.......: 57
Condio para menu: Em branco
Tecla de atalho.........: Nenhuma
Tipo do grfico.........:
Para escolher o tipo do grfico, pressione a tecla F10 e
selecione o tipo nmero 4 a partir da galeria de
grficos disponveis. A tecla F8 apresenta dicas
Manual do Usuri o
381
bastante importantes para a definio de um grfico.
Leia atentamente, quando estiver definindo grficos.
Ttulo do grfico..: SAIDAS MENSAIS
Ttulo do eixo X: PRODUTOS
Ttulo do eixo Y: VALORES
Ttulo da legenda.: Valores
Na tela de Inserir aps..., tecle ENTER sobre o
mdulo Etiqueta de preo.
No momento da emisso deste grfico na aplicao
final, precisamos receber uma informao do usurio,
que o ano base a ser grafado. Vamos utilizar o
recurso denominado Variveis complementares para
fazer isto para ns. Esta opo, que pode ser utilizada
em grficos, relatrios e etiquetas, abrir uma tela
antes da emisso e permitir que o usurio digite as
informaes que iremos definir. A definio dessas
variveis dentro deste mdulo idntica s definidas
para subsistemas (DBF).
Aps pressionar ENTER sobre Variveis
complementares, escolha a opo Definio de
atributos e responda:
Nome...........: ano
Tamanho.....: 4
N decimais..: 0
Mscara........: 9999
Larg. edio..: 4
Ttulo.............: Ano
Texto ajuda...:
Cmd especial.:
Pr-validao:
Manual do Usuri o
382
Validao.......: !EMPTY(ano)
Mensagem.....: Necessrio informar ANO
Valor inicial....:
Para valor inicial, vamos montar uma pequena frmula
para retornar o ano da data corrente. Responda com:
LEFT(DTOS(DATE( )),4)
Pressione F4, a partir do menu de campos, para ir
diretamente definio da tela. Defina-a conforme a
figura VII.49.
Figura VII.49
Agora, pressione ESC, salve a tela e pressione
novamente a tecla ESC para voltar ao menu de
definio do grfico.
Selecione Relacionamentos e estabelea um
relacionamento com o arquivo Produtos. Deste
arquivo tiraremos a descrio dos produtos para
usarmos nas legendas do grfico. Selecione Produtos
e o ndice associado codigo. Em seguida, selecione o
arquivo Saidas e o seu campo produto, para
terminar o relacionamento. Tecle ESC para abandonar
os relacionamentos.
Manual do Usuri o
383
Agora, precisamos definir o contedo do grfico.
Selecione a opo Definio dos contedos e
responda:
Ttulo......: Valor total
Contedo: valor
Condio.:
Pressione ESC para retornar ao menu de definio do
grfico.
Precisamos agora estabelecer regras para agrupar os
registros do arquivo da maneira que possam ser
totalizados para fornecer os valores para o grfico.
Neste caso, vamos ter dois nveis de agrupamentos
(quebras). O primeiro, ser comandado pelo ano/ms
das sadas dos produtos. Dentro do ms, vamos
estabelecer o segundo agrupamento, que a separao
de cada produto.
Selecione a opo Quebras (agrupamentos) e
informe:
Ttulo: LEFT(NMES(data),3)
Esta frmula nos retorna as trs primeiras letras do
nome do ms.
Expresso: LEFT(DTOS(data),6)
A expresso acima transforma a data (campo do
arquivo) em um caracter no formato: AAAAMMDD
(ano, ms e dia) e pega as 6 primeiras posies desta
data, ou seja, o ano e o ms.
Agora, a partir do menu de quebras, pressione INS e
informe os dados da segunda quebra:
Manual do Usuri o
384
Ttulo......: PRODUTOS->produto
Expresso: produto
Convm observar que os ttulos das quebras, no caso
de grficos, , geralmente, o desdobramento de uma
expresso. Devemos ter o cuidado de no defin-los
muito extensos pois, estes sero usados em legendas,
as quais podero se sobrepor no momento da plotagem
do grfico. Utilize, sempre que puder, a funo LEFT()
para truncar expresses e diminuir o tamanho dos
valores retornados.
Pressione ESC para retornar ao menu de definio do
grfico.
Estamos quase prontos! Vamos apenas estabelecer
mais dois aspectos importantes: a ordenao e
filtragem iniciais.
Selecione a opo Ordem inicial e responda a
prxima pergunta com a expresso:
DTOS(data)+produto
Sempre que puder, utilize a tecla F10 para trazer os
campos para dentro da expresso de ordenao. Este
procedimento trata automaticamente os diversos tipos
de campos, compatibilizando-os conforme a
necessidade.
Observe que a nossa expresso de ordenao est de
acordo com as quebras definidas: DATA (primeira
quebra) e PRODUTO (segunda quebra).
Finalmente, selecione Filtragem inicial para
selecionar os registros do ano a ser grafado. Para isto,
responda com:
LEFT(DTOS(data),4)=M->ano
Manual do Usuri o
385
Para a montagem da expresso, utilize as teclas F7 e
F10. Pressione ESC para retornar ap Modelador do
Projeto.
Antes de gerar os programas fontes para a nossa
aplicao exemplo, vamos inserir uma opo a mais no
mdulo de apoio. A opo Configura ambiente
possui diversos submdulos que o GAS-Pro coloca
automaticamente como sugesto. Vamos inserir mais
um mdulo, que ele no sugere, para permitir ao
usurio trocar o diretrio de trabalho, quando a
aplicao final estiver rodando. Posicione a barra
seletora em Configura ambiente, e pressione INS
para inserir um novo mdulo. Selecione Diretrio de
trabalho e insira na rvore do projeto, na ltima
posio. Pressione ESC para retornar ao menu
principal.
Pronto! S nos resta agora gerar os programas fontes
da aplicao e criar o programa executvel para que a
aplicao possa ser utilizada. E isso o GAS-Pro faz,
em questo de segundos.
Pressione ENTER sobre a opo Gera fontes. O
GAS-Pro assumir o nome do nosso projeto, portanto,
pressione ENTER novamente e confirme a gerao dos
programas fontes.
Criados os programas fontes, selecione Executvel e
pressione ENTER duas vezes.
Manual do Usuri o
386
Manual do Usuri o
387
Captulo 8: Utilizando a
Aplicao Gerada
Para uma melhor compreenso da operao do sistema
gerado, as instrues aqui apresentadas correspondem
aplicao gerada como exemplo no captulo anterior
denominado Um exemplo prtico.
Ativando a aplicao gerada
A aplicao ativada digitando-se o seu nome a partir
do prompt do DOS. No nosso exemplo:
ESTOQUE
Como nesta aplicao exemplo foi definido um
grfico, o GAS-Pro criou um programa batch
(ESTOQUE.BAT) para carregar o SGR - Servidor
Grfico Residente na memria, antes de carregar o
programa executvel da aplicao (ESTOQUE.EXE).
Se o programa executvel da aplicao for executado
primeiro, este testar a existncia do SGR na memria
e, caso no o encontre, apresentar mensagem
avisando que o grfico no poder ser apresentado.
Informando os diretrios de trabalho
Ao ser ativado, a aplicao apresenta uma tela,
solicitando a entrada dos diretrios onde iro residir os
arquivos manipulados pela aplicao. Esses arquivos
so:
Manual do Usuri o
388
Dados (com extenso DBF e DBT)
So os arquivos que contm as informaes digitadas
durante a operao da aplicao.
ndices (com extenso NTX)
So os arquivos que contm as chaves indexadoras
associadas aos arquivos de dados. Esses arquivos
permitem a manuteno da ordem dos arquivos, bem
como possibilita pesquisas aos seus registros.
Arquivos de apoio aplicao
So arquivos necessrios ao funcionamento da
aplicao, que so: o arquivo de erros, o arquivo de
impressoras e o arquivo de fontes VGA. As aplicaes
geradas pelo GAS-Pro so providas de rotinas de
manipulao de erros que visam dar o maior
detalhamento possvel ao usurio. Quando ocorre um
erro de execuo na aplicao, o usurio recebe as
informaes em um menu, de onde pode selecionar a
visualizao de janelas informativas, como por
exemplo, qual a causa do erro, o que fazer para corrig-
lo, em qual linha e programa ocorreu, etc., conforme
exemplo da tela da figura VIII.1.
Figura VIII.1
Manual do Usuri o
389
Para que isso seja possvel, necessrio existir no
disco um arquivo de nome ERROS.DBF, onde esto
gravadas, em forma criptografada, todas as
informaes necessrias.
O arquivo PRINTERS.DBF contm as configuraes
das impressoras que podem ser utilizadas pela
aplicao e o arquivo VGALIB.FTS contm as fontes
de caracteres VGA para serem utilizados nas telas da
aplicao.
Recomendamos que este grupo de arquivos seja
colocado no diretrio raiz do disco rgido de modo
que, se existirem outras aplicaes instaladas no
equipamento, estas podero compartilhar as mesmas
informaes destes arquivos.
Arquivo de senhas
So os arquivos que contm as informaes referentes
s permisses de acesso aplicao.
Confirme os diretrios de trabalho e tecle ENTER para
prosseguir, a partir da tela da figura VIII.2.
Figura VIII.2
No h impedimento de que esses arquivos residam no
mesmo drive ou subdiretrio da aplicao, sendo essas
informaes solicitadas apenas para iniciar a operao
Manual do Usuri o
390
da aplicao, mesmo porque, essa situao poder ser
alterada dentro do mdulo Apoio, conforme veremos
mais adiante.
Informando senha e entrando na apli-
cao
Como o nosso sistema de estoques foi criado com um
plano de senhas, a tela da figura VIII.3 ser
apresentada, solicitando a entrada da senha:
Figura VIII.3
Na primeira vez que a aplicao executada, um nome
igual a SUPERVISOR e uma senha igual s 3 primeiras
letras do nome da aplicao final (EST neste caso) so
criados automaticamente, com nvel de acesso igual a
Gerncia (irrestrito). Por isso, na primeira vez que a
aplicao acessada, deve-se efetuar o
credenciamento dos seus usurios, o que ser
demonstrado um pouco mais adiante, neste captulo.
Digite portanto, EST (sem as aspas), se este for a
primeira vez que a aplicao estiver sendo executada.
Se os arquivos de dados e de ndices j existirem nos
diretrios especificados, a nossa aplicao de estoque
far uso deles, caso contrrio, criar, aps confirmao
Manual do Usuri o
391
do usurio, os arquivos necessrios, vazios, prontos
para receber os dados.
Confirme a data atual, e a aplicao mostrar a tela da
figura VIII.4, que corresponde ao menu principal da
nossa aplicao.
Figura VIII.4
Operando a aplicao com o teclado
Antes de abordarmos os aspectos da operao da
aplicao exemplo que foi gerada, vamos conhecer
algumas operaes e o funcionamento de algumas
teclas com funes especiais.
Movimentao
A movimentao (ou navegao) atravs do sistema
feita utilizando-se as teclas marcadas com setas,
PGUP (pgina acima), PGDN (pgina abaixo), HOME
(incio) e END (fim), existentes direita do teclado.
Seleo de opes
A seleo nos menus da aplicao pode ser feita
apertando a primeira letra da opo desejada
(normalmente em maiscula) ou posicionando a barra
Manual do Usuri o
392
de seleo sobre a mesma e pressionando a tecla
ENTER.
Cancelamento ou retorno a telas anteriores
A tecla ESC serve para voltar a telas ou menus
anteriores. Em alguns casos, quando alguma operao
estiver sendo executada, esta tecla serve para fazer o
cancelamento da operao.
Teclas com funes especiais
A gerao de aplicaes que possibilitem a sua
operao em todos os nveis de usurio, o principal
objetivo do GAS-Pro. Tendo em vista este propsito,
foram programadas algumas teclas que auxiliam
aoperao do sistema.
Tecla F1 - Ajuda sensitiva ao contexto
A tecla F1 quando ativada mostrar uma janela
contendo um texto descritivo com as instrues
especficas situao. Em algumas situaes, no ser
possvel mostrar em uma janela todo o texto de ajuda;
entretanto o usurio poder avanar no texto para
baixo, utilizando a seta para baixo ou teclando PgDn e
retroceder o mesmo texto usando a seta para cima ou
teclando PgUp. Quando desejar retornar aplicao,
dever teclar ESC.
Os textos de ajuda so padronizados para todas as
aplicaes geradas pelo GAS-Pro, mas o usurio ou o
projetista da aplicao poder criar os seus prprios
textos de ajuda. Para maiores esclarecimentos, leia o
tpico Editando o arquivo de ajuda ao usurio, neste
manual. A tela da figura VIII.5 exemplifica uma tela
de ajuda.
Manual do Usuri o
393
Figura VIII.5
Tecla ALT-F1
A tecla ALT-F1 pode ser utilizada para ligar e desligar
a ajuda ativa de campos (onde tenha sido definida).
Com esta ajuda ativa ligada, sempre que o cursor
estacionar em um campo, uma pequena janela com
texto de ajuda aparecer junto ao campo, para servir de
orientao sobre a informao a ser digitada.
Tecla ALT-F2 - Comandos do DOS
A tecla ALT-F2, quando ativada, permite um acesso
direto ao ambiente do DOS, tornando disponvel para o
usurio todos os comandos do sistema operacional.
Durante esta operao, o usurio no deve executar
programas do tipo TSR (os que ficam residente na
memria) para no comprometer o funcionamento da
aplicao. Quando desejar retornar ao ponto que se
encontrava no sistema, o usurio dever digitar EXIT
na linha de comando do DOS.
Tecla F5 - Calendrio (figura VIII.6)
A tecla F5, quando ativada, mostrar na tela um
calendrio do ms atual. As teclas de setas cursoras
podem ser usadas para avanar ou retroceder meses e
anos, permitindo ao usurio consultar datas passadas e
futuras.
Manual do Usuri o
394
Figura VIII.6
Tecla F6 - Calculadora (figura VIII.7)
A tecla F6, quando ativada, mostrar na tela uma
calculadora que poder ser operada pelo prprio
usurio, possuindo os mesmos princpios de uma
calculadora de bolso e contendo as seguintes teclas de
controle:
Figura VIII.7
Tecla Efeito
C Inicializa o valor do display com zeros
+ Adiciona o prximo valor digitado ao valor atual
- Subtrai o prximo valor digitado do valor atual
Manual do Usuri o
395
Tecla ALT-F8 - Reposiciona janelas
As janelas ou retngulos que aparecem na tela da
aplicao, inclusive as que desaparecem
espontaneamente (aps certo tempo), podem ser
posicionadas dentro da tela do micro. Ao pressionar
ALT-F8, o usurio poder fazer uso das setas cursoras
para escolher a nova posio da janela corrente,
pressionando ENTER quando desejar fix-la em uma
posio.
Esta facilidade permite que o prprio usurio altere, se
desejar, o aspecto da aplicao. Quando rodando em
um ambiente de rede local, cada usurio poder
escolher o aspecto de sua aplicao sem interferir nas
dos demais usurios.
Esta tecla no est disponvel nas seguintes janelas:
Cabealho da tela
Janela onde sejam digitadas senhas
* Multiplica o prximo valor digitado ao valor atual
/ Divide o valor pelo prximo valor di-gitado
%
Calcula o percentual do prximo valor digitado em
relao ao valor atual
^
Eleva o valor atual a potncia do prximo valor digi-
tado
# Retorna a raiz quadrada do valor atual
$
Troca o formato do valor contido no display, de fra-
cionrio para inteiro e vice-versa
R
Transfere o valor da calculadora para o contedo do
campo que porventura estiver pendente.
ENTER Retorna o resultado da operao
ESC Desativa a calculadora
Tecla Efeito
Manual do Usuri o
396
As teclas a seguir funcionam somente durante a
operao de digitao de informaes nos arquivos
(incluso de registros):
Tecla F3 - Repete informao do registro anterior
A tecla F3, tem a finalidade de repetir, na tela de
incluso, o ltimo registro digitado, facilitando o
cadastramento dos dados. Quando esta tecla for
ativada, ser mostrada na parte inferior da tela a
mensagem Rep, para desativar esta funo de
repetio deve-se teclar novamente F3.
Tecla F4 - Confirma com ENTER para passar para prximo
campo
Quando da digitao de informaes nos arquivos de
dados, sempre que o cursor alcana a ltima posio
do campo, salta automaticamente para o incio do
prximo campo. Com a confirmao ligada, isto no
acontece, ou seja, o usurio ter que confirmar,
atravs da tecla ENTER, o contedo do campo que
acabou de digitar.
A tecla F4, tem a finalidade de ligar e desligar esta
situao, permitindo que o usurio do sistema escolha
a maneira que seja mais adequada. Quando ativada,
ser mostrada na parte inferior da tela a mensagem
Conf.
Mais adiante veremos que esta opo pode tambm ser
configurada em outra parte da aplicao, dentro do
mdulo de Apoio.
Tecla F8 - Executa comando especial ou permuta de telas
Esta tecla pode ser utilizada dentro de campos para
executar comandos especiais que tenham sido
definidos na fase do projeto. Nesta nossa aplicao
exemplo, foram definidos alguns comandos especiais
para capturar contedos de campos de tabelas. No
modo de alterao de registros de arquivos
Manual do Usuri o
397
subordinados (pai/filho), esta tecla pode ser utilizada
para permutar a janela ativa, ou seja, serve para tornar
ativa, alternativamente, a janela do arquivo de nvel
superior (pai) e a do arquivo de nvel inferior (filho).
Se existir mais de um arquivo em nvel inferior (filho),
um menu apresentado para a seleo do arquivo cuja
tela dever ficar ativa.
TAB - Permuta janelas de arquivos relacionados
A tecla TAB tem a mesma funo da tecla F8 quando
alterando registros de arquivos subordinados, porm,
no apresenta menus para seleo de arquivos. Vai,
alternadamente, trocando de um para outro.
Tecla F9 - V outros
Esta tela permite que outros arquivos de dados sejam
exibidos e consultados pelo usurio da aplicao. Esta
facilidade, que est disponvel tambm durante as
operaes de alteraes de arquivos, muito til
quando se trabalha com tabelas dentro da aplicao,
sendo explicada detalhadamente mais adiante neste
manual.
Operando a aplicao com um mouse
Dentro da aplicao gerada, o funcionamento do mouse
tem as seguintes caractersticas:
o boto da ESQUERDA serve para selecionar
opes, campos e arrastar objetos (janelas) atravs
da tela.
o boto do MEIO, se o mouse conectado o possuir,
no tem qualquer finalidade na operao da
aplicao;
Manual do Usuri o
398
em qualquer situao, o boto da DIREITA funciona
como se a tecla ESC tiver sido pressionada, servindo
para cancelar, retornar telas ou abandonar operaes;
Selecionando opes de menus
Para selecionar uma opo dentro de um menu, basta
clicar o mouse sobre a opo desejada e a barra
seletora posicionada na opo escolhida. Um
segundo clique sobre a barra seletora ativar
definitivamente a opo.
Cancelando ou retornando a telas anteriores
Basta clicar o boto da direita, no importando onde o
cursor do mouse estiver posicionado.
Mudando a posio de uma janela
Alternativamente tecla ALT-F8, para mudar janelas
de posio utilizando o mouse, basta pressionar o
boto da esquerda sobre uma das opes (que no
estiver em reverso, pois provocaria a seleo) e reter
pressionado durante meio segundo. A partir deste
tempo, pode-se arrastar o mouse, mantendo o boto
pressionado, e escolher o local desejado para fixar a
janela, pressionando o boto da direita.
Acessando opes que no aparecem no menu
Sempre que a quantidade de opes em um menu no
puderem ser exibidas ao mesmo tempo na janela, uma
barra de rolagem criada automaticamente na borda
direita da janela mostrando a posio relativa
quantidade total de opes. Aparecem tambm nas
partes superior e inferior desta barra de rolagem, duas
setas que podem ser clicadas com o mouse para
provocar a rolagem das opes.
Manual do Usuri o
399
Editando campos
Para editar um campo durante a opo de
Manuteno ou dentro da Tela Paginada (opo
Consulta), pode-se clicar diretamente sobre um
campo para selecion-lo para edio. Ao digitar
informaes dentro dos campos, o boto direito do
mouse poder tambm ser utilizado para cancelar a
edio.
Rolagem de telas
Sempre que existir caracteres com setas nas bordas das
janelas, o mouse pode ser utilizado para fazer a
rolagem de registros para a frente e para tras,
dependendo da seta que for clicada.
Operando a aplicao exemplo
Agora que vimos, genericamente, a utilizao das
teclas especiais e os aspectos de utilizao do mouse,
vamos iniciar as explicaes para a operao da nossa
aplicao exemplo.
Algumas opes de menu devero ser selecionadas em
seqncia e sero referenciadas nas explicaes que se
seguiro da seguinte maneira:
Opo 1/Opo 4/Opo 2
O exemplo acima significa que as opes Opo 1",
Opo 4" e Opo 2" devem ser selecionadas, nesta
ordem.
Se esta for a primeira utilizao desta aplicao, uma
seqncia deve ser seguida para a colocao dos dados
no arquivo. Por exemplo, os dados das tabelas e de
parmetros devem ser informados primeiro pois, so
informaes vitais para o funcionamento da
aplicao, visto que os demais subsistemas da
aplicao referenciam as tabelas em validaes,
relacionamentos, etc.
Manual do Usuri o
400
Tambm, na primeira vez que a aplicao executada,
interessante fazer o credenciamento dos usurios que
acessaro a aplicao.
Para este nosso exemplo, vamos assumir que a
implantao ainda no tenha sido feita, portanto,
teremos de digitar alguns poucos registros fictcios nos
arquivos, para que o funcionamento da aplicao possa
ser acompanhado.
Durante o processo de digitao (incluso) de
registros, existem diversas teclas com funes
especiais para a edio do campo digitado. A relao a
seguir mostra algumas delas, observando sempre que o
caracter ^ significa que a tecla marcada com CTRL
deve ser pressionada e retida, at que a tecla seguinte
seja pressionada.
Teclas de controle de edio
Tecla Funo
Seta para direita Move cursor 1 posio para a esquerda
Seta para esquerda Move cursor 1 posio para a direita
^F Move cursor 1 palavra para a direita
Â Move cursor 1 palavra para a esquerda
^G ou DEL Apaga o caracter sob o cursor
^V ou INS Liga e desliga insero
^Y Apaga o campo a partir do cursor
^T Apaga a palavra frente
Û Restaura a situao original do campo
ESC Cancela a digitao de toda a tela
ENTER Aceita o contedo digitado no campo
Manual do Usuri o
401
Incluso de registros nas tabelas
Selecione Tabelas/fornecedores/incluso. Vamos
cadastrar os cinco fornecedores seguintes, a partir da
tela da figura VIII.8.
Figura VIII.8
Cdigo........................: 1
Nome do fornecedor: INDUSTRIAS QUIMICAS IQL
LTDA
Contato.......................: JOAO DA SILVA
Telefone.....................: (111)111-1111
Ramal..........................: 1111
Fax..............................: (111)010-1010
Cdigo........................: 2
Nome do fornecedor: ABC CELULOSE S.A.
Contato......................: MARCIO
Telefone.....................: (222)222-2222
Ramal..........................:
Fax..............................: (222)121-2121
Manual do Usuri o
402
Cdigo..................................: 3
Nome do fornecedor: XP CELULOSE E
DERIVADOS LTDA
Contato.................................: PEDRO ANTONIO
Telefone................................: (333)333-3333
Ramal.....................................: 3
Fax..........................................: (333)323-2323
Cdigo....................................: 4
Nome do fornecedor: SANTA MARTA
EQUIPAMENTOS LTDA
Contato...................................: MARLENE
Telefone.................................: (444)444-4444
Ramal......................................:
Fax..........................................: (444)434-3434
Cdigo.......................: 5
Nome do fornecedor: ATILA FABRIL LTDA
Contato.....................: JORGE
Telefone....................: (555)555-5555
Ramal.........................: 5
Fax.............................: (555)545-4545
A seguir, pressione ESC duas vezes e selecione
Indexador. Vamos cadastrar a cotao do dlar para
o dia. Observe que quando selecionamos esta opo,
no apareceu para ns as opes Incluso,
Manuteno e Consulta, conforme aconteceu quando
entramos em Fornecedores. Lembre-se de que,
Manual do Usuri o
403
quando definimos esse subsistema, no captulo
anterior, ns retiramos as duas primeiras opes que o
GAS-Pro sugeriu, deixando apenas a ltima
Consulta, cuja mensagem trocamos para Cadastra/
Consulta. Dessa maneira, o GAS-Pro gerou rotinas
que nos coloca agora diretamente dentro do mdulo de
consulta agrupada, a partir da qual, tambm podemos
digitar registros pressionando a tecla D. Se
pressionarmos F10, veremos tudo o que pode ser feito
atravs dessa tela porm, por enquanto, vamos abordar
somente o comando D e deixar as outras opes para
serem melhor detalhadas em outra parte deste captulo,
na montagem de consultas aos arquivos.
Digite, apenas como exemplo, a data e, como
pretendemos utilizar o indexador dlar, digite
tambm o valor do dlar correspondente data
informada.
Pressione ESC trs vezes para retornar ao menu
principal da aplicao. Agora, vamos entrar no mdulo
de apoio e digitar informaes no arquivo de
parmetros do sistema, que criamos na aplicao.
Selecione Apoio/Parmetros do sistema e digite as
informaes dos campos conforme exemplo da tela da
figura VIII.9.
Figura VIII.9
Manual do Usuri o
404
Incluso de registros de produtos
Pronto! Agora que j cadastramos os dados das tabelas
e dos parmetros da aplicao, selecione Produtos/
Incluso e vamos digitar alguns registros de produtos
para exemplificar a nossa aplicao. Em geral, esta
opo utilizada somente na implantao da
aplicao, para digitar o resultado do inventrio inicial
feito no estoque. Nos demais casos, as modificaes
neste arquivo sero feitas atravs das movimentaes
de entrada e sada, conforme veremos mais adiante.
Observe que duas telas superpostas foram abertas para
a digitao de dados, confome exemplo da figura
VIII.10. Quando definimos este subsistema
(PRODUTOS) no projeto, criamos um subsistema a ele
subordinado (FNDPROD) para controlar mais de um
fornecedor para um mesmo produto. A tela que aparece
por baixo (no ativa) corresponde tela deste
subsistema.
Figura VIII.10
As informaes referentes ao campo referncia
tcnica (campo memo) no so relevantes para o
nosso exemplo, podendo ser digitadas quaisquer
informaes. Para digitar informaes em campos do
tipo memo, o usurio dever pressionar a tecla F7 e
poder entrar com aproximadamente 64.000 caracteres
para o campo. As teclas que permitem a edio das
informaes neste tipo de campo so as seguintes:
Manual do Usuri o
405
Tecla Funo
^S ou Seta para a esquerda Move cursor 1 posio para a esquerda
^D ou Seta para a direita Move cursor 1 posio para a direita
Ê ou Seta para cima Move cursor 1 linha acima
^X ou Seta para baixo Move cursor 1 linha abaixo
^F Move cursor 1 palavra para a direita
Â Move cursor 1 palavra para a esquerda
^Y Apaga toda a linha
^T Apaga a palavra frente
^G ou DEL Apaga o caracter sob o cursor
^V ou INS Liga e desliga insero
ESC Cancela a digitao de todo o campo
ENTER Move o cursor para uma nova linha
^W ou F7 Aceita e grava o que foi digitado
HOME Move para o fim da linha
END Move para o incio da linha
^HOME Move para o incio da janela
ÊND Move para o fim da janela
PGUP Move para janela anterior
PGDN Move para prxima janela
^PGUP Move para o incio do texto
^PGDN Move para o fim do texto
Manual do Usuri o
406
Digite os registros a seguir:
Ao digitar os registros acima, voc deve ter observado
o efeito de diversas definies que fizemos na fase do
projeto, como por exemplo:
ao digitar o campo unidade, um menu com as opes
vlidas apareceu automaticamente, e quando
capturamos uma das opes, a sua sigla foi
decodificada ao lado, atravs de uma frmula que
definimos;
o cursor no estacionou no campo quantidade em
estoque para ser digitado. Este campo no foi
posicionado na tela, sendo acessado apenas pela tela
complementar que criamos e que experimentaremos
mais tarde;
o preo de custo em dlar foi sugerido a partir da
frmula que estabelecemos acessando a tabela de
indexadores;
Cod. Descrio UN. Q Min Pr Custo Pr Inc Lucro
1 Lapis preto n.1 UN 200 0,23 0.23 75.00
2 Lapis preto n.2 UN 200 0.23 0.23 75.00
3 Caneta BIC Azul UN 200 0.75 0.75 60.00
4 Pincel atomico azul UN 100 1.50 1.50 80.00
5
Borracha macia para
desenho
UN 400 0.70 0.70 70.00
6 Borracha bicolor UN 300 0.70 0.70 50.00
7 Caderno 100 fls espiral UN 1000 2.50 2.50 70.00
10
Grampeador Inox
modelo 1
UN 30 4.50 4.50 90.00
Manual do Usuri o
407
a informao US$ que aparece na tela em dois
lugares diferentes foi trazida do arquivo de
parmetros, atravs de frmulas que definimos;
as informaes do quadro intitulado Preo de
venda so atualizadas automaticamente. Porm,
como a frmula que definimos utiliza informaes
do campo lucro bruto, elas aparecem somente
depois de digitado este campo;
ao tentar digitar um registro de produto com o
mesmo cdigo de um j anteriormente digitado, o
programa avisar que j existe um igual mostrando o
registro anterior e permitir, atravs de escolha de
menu, a alterao de seus dados, se desejar. Isto
acontece somente quando a chave de acesso definida
para o arquivo do tipo primria, igual a que
definimos para este subsistema, na fase do projeto.
Durante a digitao de registros (e tambm durante a
alterao, como veremos adiante) o usurio poder
pressionar a tecla F9 para consultar e manipular
qualquer um dos arquivos de dados da aplicao.
Ao pressionar F9, se houver mais de um subsistema na
aplicao, ser apresentado um menu de onde poder
ser selecionado qualquer um dos arquivos da
aplicao, conforme mostra a figura VIII.11.
Figura VIII.11
Manual do Usuri o
408
Selecionado o arquivo, a janela de consulta desse
arquivo aparecer exibindo os dados do arquivo
selecionado (figura VIII.12). O usurio poder ento
usar as teclas de navegao para consultar os registros.
Figura VIII.12
A rotina que apresenta esta janela, a mesma utilizada
para a opo Consulta, a ser explicada neste
captulo, com todos os seus recursos.
Uma importante caracterstica desta facilidade
propiciar o cadastramento simultneo em tabelas (ou
em qualquer outro arquivo), quando os registros do
primeiro arquivo esto sendo nelas validados.
Enquanto estiver operando esta consulta, o usurio
poder tambm pressionar F9 sobre um de seus
campos para capturar o seu contedo e levar para o
campo que estava sendo digitado no outro arquivo.
Com a digitao desses produtos fictcios, temos todos
os elementos para utilizar a nossa aplicao. Porm,
vamos aprender primeiramente como funciona o plano
de senhas e como cadastrar e cercear rotinas aos
usurios:
Operando o plano de senhas
Selecione Apoio/Plano de senhas e a tela da figura
VIII.13 aparecer.
Manual do Usuri o
409
Figura VIII.13
A partir desta tela, que s aparece quando o usurio
tem nvel de acesso igual a 3 (gerncia) podemos fazer
um completo gerenciamento do plano de senhas da
aplicao. Esta tela funciona de modo similar s telas
criadas na aplicao para apresentar consultas aos
arquivos de dados. Se desejar pressione F10 para ver o
que possvel fazer aqui.
Como j vimos no incio deste captulo, o GAS-Pro
cria o usurio SUPERVISOR cuja senha formada
pelas primeiras trs letras do nome da aplicao e cujo
nvel de acesso igual a 3 (gerncia). Vamos
descredenciar este usurio fictcio.
Movimentando entre as tabelas do plano de senhas
Para se movimentar entre as tabelas do plano de senhas
basta teclar TAB, alternando-se entre as 3 tabelas
existentes.
Descredenciando um grupo ou usurio na aplicao
Coloque a barra seletora sobre o primeiro registro da
tabela GRUPOS DE USURIOS, pressione E de
excluir e confirme a excluso. Com esse processo
sero excludos todos os usurios pertencentes a tal
grupo. Vamos agora credenciar um grupo de gerncia e
um respectivo gerente da aplicao, com o nvel 3.
Manual do Usuri o
410
Credenciando um grupo ou usurio na aplicao
Pressione D de digitar e informe os dados a seguir:
Nome.: (digite o nome do grupo master aqui)
Agora, vamos credenciar um usurio com nvel de
acesso master ao nosso aplicativo. Ao se cadastrar um
novo grupo, automaticamente, o sistema solicitar o
cadastramento de um usurio para tal grupo. Digite,
ento:
Nome.: (digite seu nome aqui)
Nivel: 3
Obs..: Em branco
Senha: 1234
Pressione ESC e ento, automaticamente, ser
habilitada a tabela de GRUPO DE USURIOS para
possvel cadastramento. Pressione D novamente para
que possamos incluir ao nosso sistema um grupo que
possua nveis de acesso diferentes aos do grupo master
obrigando todos os usurios cadastrados para tal grupo
sofrerem certo cerceamento que veremos no prximo
tpico.
Nome.: Operadores
Agora, poderemos credenciar um usurio que pertena
ao grupo OPERADORES. Digite, ento:
Nome.: PEDRO
Nivel: 1
Obs..: Em branco
Senha: 0101
Manual do Usuri o
411
Tecle ESC e pronto! Credenciamos um usurio
chamado PEDRO com nvel de acesso igual a 1
(operao) e pertencente ao grupo OPERADORES.
Agora, podemos continuar a definio do acesso
aplicao.
Cerceando rotinas ao grupo de usurios
Pressionando-se TAB por duas vezes, poderemos
verificar os cerceamentos que so passveis de
definio para todas as tabelas de nosso aplicativo.
Teclando-se F10, ser apresentado um menu com as
opes de cerceamento possveis.
A partir da janela entitulada TABELAS, cada arquivo
de dados na aplicao tem uma linha correspondente
nesta tela. Toda e qualquer restrio s tabelas
apresentadas referir-se-o ao grupo selecionado logo
acima (OPERADORES). Vamos por, exemplo, fazer o
cerceamento ao grupo supracitado, de rotinas no
arquivo Entrada de Produtos. Mova a seta para
baixo, selecionando-se a linha correspondente ao
arquivo desejado e pressione M de modificar. Para
proibir o usurio de executar uma rotina qualquer,
basta digitar a sua inicial dentro deste campo, no
importando a sua ordem. Observe a tela da figura
VIII.14:
Figura VIII.14
Manual do Usuri o
412
A sequncia DMERIG que foi digitada para este grupo
de usurios, impedir que tal grupo tenha acesso s
rotinas correspondentes a essas letras. Podemos fazer
isto para todos os arquivos da aplicao, inclusive o
arquivo de parmetros.
Sempre que for necessrio alterar algum tipo de
acesso, s colocar ou retirar letras deste campo, para
o arquivo correspondente.
Para o grupo de acesso master (nvel de gerncia), no
efetivaremos cerceamentos a nenhuma das tabelas.
Nesta primeira vez, como entramos com nome e senha
do usurio SUPERVISOR, que inclusive j foi
descredenciado da aplicao, vamos pressionando ESC
para abandonar a operao da aplicao e ativ-la
novamente com a senha 1234.
Digitando Notas Fiscais de fornecedores
Vamos agora fazer algumas operaes de
movimentao de estoque. Selecione Movimentao/
Entrada de produtos/Digita NF e vamos digitar os
dados da Nota Fiscal de produtos recebidos a seguir:
Nmero: 1
Data..:
Pressione ENTER para aceitar a sugesto
colocada no campo. Veja que no ser
possvel a prosseguio se no cor
cadastrada a data do indexador para o
referido dia. Pressione F9 e selecione a
tabela INDEXADOR. Pressione D para
digitar um novo registro e estabelea o
valor para necessria data. Pressione ESC
por trs vezes para que retornemos janela
de cadastro de notas fiscais. A data da
ENTRADA DE PRODUTOS foi sugesto
inserida atravs do atributo Valor inicial,
na fase do projeto, conforme explicado no
captulo anterior.
Manual do Usuri o
413
Cdigo:
Para o cdigo do fornecedor, vamos
pressionar F8 para capturar a informao
da tabela de fornecedores. Selecione
ATILA FABRIL LTDA e observe que o
cdigo desse fornecedor veio diretamente
para o campo em digitao, bastando
pressionar a tecla ENTER para aceitar.
Repare que, quando acabamos de digitar os dados da
NF, a tela de produtos da NF fica na cor ativa, para que
os itens possam ser digitados. Digite os produtos
hipotticos da lista a seguir observando que:
quando definimos no nosso projeto, colocamos uma
interface semelhante que fizemos para o cdigo do
fornecedor visto h pouco, para capturar cdigos de
produto atravs da tecla F8. Faa uso dela;
a coluna Descrio do produto e a coluna Custo
total sero preenchidas automaticamente, porque
definimos frmulas no projeto para mostrar estas
informaes;
a informao de Custo unitrio ser sempre
sugerida com o valor do custo unitrio que existe no
arquivo de produtos, conforme definimos no projeto;
diversos registros so digitados para uma s NF,
caracterizando o relacionamento 1-N (um para N)
que estabelecemos na fase do projeto;
o valor total da NF ser calculado e mostrado a cada
item digitado.
Cdigo Quantidade Custo unitrio
5 5000 1000
6 5000 800
7 200 4000
Manual do Usuri o
414
Pressione ESC trs vezes para terminar a digitao de
Notas Fiscais e retornar ao menu principal.
Alterao de registros de produtos
Agora, aprenderemos como fazer correes em
registros j digitados e tambm, como digitar mais
itens em arquivos relacionados em nveis inferiores
(filhos).
Selecione Produtos/Manuteno. A tela da figura
VIII.15 ser apresentada. As explicaes que veremos
a seguir, para o arquivo de produtos, serve para
qualquer um dos arquivos da aplicao.
Figura VIII.15
Estamos agora no mdulo de alterao de produtos.
Vamos fazer algumas experincias:
pressione F8 algumas vezes e veja o que acontece. A
tela de digitao ativa passa, alternadamente, de um
arquivo para o outro. Se existissem mais arquivos
relacionados neste exemplo, a tecla F8 apresentaria
um menu para que um deles fosse selecionado. A
tecla TAB pode ser usada exatamente como a tecla
F8 porm, no caso de existir mais arquivos
relacionados, nenhum menu apresentado e as telas
ativas vo se alternando de um para outro, em
seqncia. Se estiver operando com um mouse, um
clique na rea de qualquer uma das janelas faz com
Manual do Usuri o
415
que a mesma fique ativa, podendo ser selecionadas
as opes de edio para aquele arquivo.
pressione a seta para a direita e verifique que os
registros vo sendo passados seqencialmente, at
atingir o final do arquivo. A medida que o registro
mudado na tela superior (pai), os registros
relacionados no mdulo de nvel inferior (filho)
tambm vo sendo mostrados na tela inferior.
Agora que vimos como alternar as janelas de edio,
deixe a janela de produtos ativa e pressione F10 para
ver o menu de comandos disponveis para a edio dos
campos, conforme figura VIII.16.
Figura VIII.16
Procura Esta opo serve para pesquisar rapidamente o arquivo
de dados para encontrar registros especficos. Ao ser
acionada, o usurio poder escolher um dos conjuntos
de pesquisa estabelecidos atravs do menu que
apresentado. Selecionado o conjunto de pesquisa, o
usurio poder digitar o contedo da chave de cujo
registro deseja visualizar. Uma vez encontrado, este
registro imediatamente colocado na tela.
Para exemplificar, digite P (ou pressione F10 e
selecione Procura) e selecione Nome do produto.
Digite BORRACHA (sem aspas) e pressione a tecla
ENTER. Observe que foi colocado na tela o primeiro
registro cuja descrio comea com BORRACHA.
Manual do Usuri o
416
Cabe ressaltar que, em telas de consulta, poder-se-
utilizar do recurso de pesquisa dinmica, na qual,
medida que se digita um caracter, automaticamente, j
efetuada busca que atenda condio de pesquisa. A
funo de pesquisa dinmica poder ser habilitada/
desabilitada nas consultas por meio da tecla F3.
Seguinte Esta opo exibir na tela, o prximo registro do
arquivo, segundo a ordem e filtragem que estiver
vigorando (ver os tpicos Filtra e Ordena mais adiante,
neste captulo). Para ativ-la, alm da tecla S, pode
ser utilizada as tecla de seta direita, conforme
explicado anteriormente.
Anterior Semelhante ao que foi explicado para Seguinte,
retrocede um registro de cada vez, tendo como
alternativa, a tecla de seta para a esquerda.
Digita Esta opo permite a entrada de mais produtos no
arquivo, como se Incluso tivesse sido selecionado
atravs do menu anterior.
Copia Esta opo cria um novo registro, disponibilizando
uma cpia do registro anteriormente visualizado para
que sejam efetivadas as devidas adaptaes..
Modifica Posiciona o cursor no primeiro campo editvel do
arquivo, permitindo ao usurio alterar todos os dados
do registro presente na tela, exceto o campo chave,
quando se tratar de chave primria. Para exemplificar,
vamos alterar a descrio do item GRAMPEADOR.
Pressione a tecla P, selecione o conjunto de pesquisa
Nome do produto e informe GRAMPEADOR. Em
seguida, pressione M (ou aperte F10 e selecione
Mofifica) e escreva qualquer coisa, diretamente
sobre o campo Descrio do produto. Em seguida,
pressione Û para restabelecer o contedo anterior.
Para evitar teclar ENTER at o ltimo campo,
pressione ÊND ou ^W.
Exclui Esta opo, quando selecionada, marcar o registro da
tela como excludo do cadastro. Durante este processo
poder haver ou no uma solicitao de confirmao
do apagamento do registro, dependendo do que foi
configurado no tpico Apoio a ser visto mais
adiante, neste captulo.
Manual do Usuri o
417
A excluso definitiva do registro dar-se- somente
atravs da opo Elimina reg apagados a ser descrita
mais adiante.
Recupera Permite recuperar o registro que se encontra na tela,
marcado como excludo, para corrigir eventuais
enganos.
Filtra Serve para selecionar registros do arquivo com que se
quer trabalhar, ou seja, define uma condio comum
para agrupar os registros que estaro sujeitos a um
determinado processo selecionado. Sempre que for
selecionada esta opo, a tela da figura VIII.17
aparecer.
Figura VIII.17
Existem duas maneiras de se obter um critrio de
seleo ou filtragem:
Informar, livremente, um critrio de seleo: Para
se utilizar desta opo, o usurio poder necessitar
de conhecimentos da linguagem CA-Clipper verso
5.2. Neste tipo de montagem de critrio, o usurio
dever escrever, literalmente, a frase a ser utilizada
como expresso de comparao. Para exemplo,
selecione Filtra (ou pressione F). Selecione
Critrio livre e entre com a expresso que aparece
na tela da figura VIII.18.
Manual do Usuri o
418
Figura VIII.18
Esta filtragem ou critrio de seleo de registros nos
permitir operar somente com os registros de produto
que tiverem Cdigo entre 0005" e 0010",
inclusive. Tecle ENTER e verifique.
Neste caso, a frase escrita acima ser passada
integralmente ao CA-Clipper que, se no for capaz de
interpret-la devido a erros, interromper o processo,
apresentando uma mensagem de erro de execuo, sem
maiores conseqncias.
Para a montagem de um critrio livre, o usurio poder
utilizar a tecla F10 para auxili-lo a referenciar nomes
de campos.
Montagem de um novo critrio de seleo: A
montagem de uma nova filtragem pode ser feita
conforme descrito a seguir, em trs etapas:
1a. Etapa
Na primeira etapa o usurio deve escolher, a
partir do menu da figura VIII.17, qual campo
do arquivo ser usado para a comparao entre
registros. Os ttulos dos campos do arquivo
aparecem a partir da segunda opo daquele
menu.
Manual do Usuri o
419
2a. Etapa
Determinado o campo alvo de comparao, a
prxima etapa consiste na escolha do operador
relacional a ser utilizado na comparao,
conforme aparece na tela da figura VIII.19.
Figura VIII.19
Diversos operadores relacionais esto
disponveis para a comparao. Sempre que o
campo selecionado para ser comparado seja do
tipo caracter, as opes contm e no
contm tambm aparecero.
3a. Etapa
Escolhido o operador relacional, a etapa
seguinte ser informar um dado a ser usado na
comparao ou segundo operando, atravs da
tela da figura VIII.20. Este dado estar sempre
de acordo com o tipo de campo selecionado.
Manual do Usuri o
420
Figura VIII.20
At este ponto, com a entrada do segundo
operando, montou-se um critrio de seleo, ou
seja, uma condio de agrupamento de registros.
Da maneira j descrita, pode-se montar at trs
critrios semelhantes a este, atravs dos
operadores lgicos denominados E e OU,
bastando selecionar do terceiro menu o operador
lgico desejado.
Para ilustrar o que foi dito at aqui, poderamos
facilmente, sem conhecer a linguagem CA-
Clipper, montar o critrio de seleo feito no
tpico Critrio livre, explicado anteriormente:
CODI>="0005" .AND. CODI<="0010"
Estabelecidos os critrios para agrupamento dos
registros, basta selecionar OK a partir do ltimo
menu (operadores lgicos).
Como a filtragem de registros envolve
um processo de indexao do arquivo de dados,
a aplicao sempre dar a oportunidade ao
usurio de escolher se tambm deseja ordenar o
arquivo, fazendo assim as duas operaes de
uma s vez.
Manual do Usuri o
421
Aps efetuar um primeiro filtro, poder-se-
reaproveitar a clusula de filtragem anteriormente
utilizada por meio da opo FILTRO ANTERIOR.
Ordena Esta opo serve para estabelecer diferentes
classificaes para apresentar os registros dentro da
opo de Manuteno. O processo de ordenao est
descrito detalhadamente em outro tpico deste manual,
denominado Consulta.
Global Esta opo bastante poderosa, permitindo ao usurio
modificar completamente um arquivo ou somente
alguns registros selecionados. Como esta opo atinge
registros mltiplos, ao ser acionada, o usurio recebe
um alerta da aplicao sobre a importncia de fazer
uma cpia de segurana do arquivo antes de continuar.
Para o estabelecimento de um processamento global,
dever seguir os seguintes passos:
Filtrar ou agrupar os registros a serem processados,
utilizando a opo Filtra, descrita anteriormente. Se
no for estabelecida uma filtragem, TODOS os
registros do arquivo sofrero o processamento.
Selecionar o tipo de processamento desejado, a partir
da tela da figura VIII.21 a seguir.
Figura VIII.21
Deste menu o usurio poder escolher o tipo de
processamento desejado. importante lembrar que, o
Manual do Usuri o
422
processamento global atingir somente os registros
que foram agrupados pela opo Filtra, vista
anteriormente. Esse processamento pode ser
apagamento de registros, recuperao de registros e
ainda, alterao de campos de registros.
Apaga determinados registros
Os registros agrupados pelo processo de filtragem
sero marcados para apagamento (excluso do
arquivo). A excluso definitiva dar-se- somente
atravs da opo Elimina reg apagados a ser
explicada no captulo Apoio, neste manual.
Recupera determinados registros
Consiste no inverso do processamento anterior. Os
registros agrupados pela filtragem, caso estejam
marcados para apagamento, sero desmarcados.
Modifica campos de determinados registros
Neste tipo de processamento global existe uma passo
preliminar que a definio dos campos do arquivo a
serem modificados e quais as frmulas a utilizar nas
modificaes.
Um processo global de modificao pode ser feito
simultaneamente em diversos campos do arquivo, cada
um segundo uma frmula especfica a ser estabelecida.
Para informar um processo de modificao global, siga
as duas etapas seguintes e depois oriente-se pelo que
foi descrito para o processo de apagamento e
recuperao. Vamos descrever este processo com um
exemplo. Suponhamos que pretendemos colocar o
percentual de lucro bruto igual a 90% somente nos
tens BORRACHA do nosso estoque. Primeiramente
teramos de filtrar os registros para que somente esses
itens fossem atingidos. Faa esta filtragem seguindo as
explicaes anteriores para o tpico Filtra (a
expresso deve ser PRODUTO='BORRACHA' ), e
Manual do Usuri o
423
vamos montar o nosso processamento global de
modifiao.
Primeira etapa da modificao global
A primeira etapa consiste em selecionar o campo que
deve sofrer o processo de alterao, a partir do menu
da figura VIII.22. Selecione o campo L Bruto que
ser nosso campo alvo.
Figura VIII.22
Importante observar que os campos envolvidos na
chave de indexao, os campos do tipo memo bem
como os no editveis, no podem ser processados,
sendo por isso, no selecionveis.
Segunda etapa da modificao global
A segunda etapa consiste no estabelecimento da
frmula a ser utilizada para o processo de alterao do
campo selecionado. Nesta operao, deve-se ter o
cuidado de entrar com expresses vlidas para a
linguagem CA-Clipper. No nosso caso, digite o nmero
90, conforme a figura VIII.23:
Manual do Usuri o
424
Figura VIII.23
Informada a frmula para modificao do campo, a
aplicao apresenta novamente o menu de campos do
arquivo para serem escolhidos outros campos a serem
modificados.
Como s vamos modificar o campo L Bruto,
podemos pressionar ESC para abandonar esta tela.
Finalmente, podemos escolher de um menu se o
processamento de cada registro ser feito de modo
confirmado ou no. Se for selecionado o modo
confirmado, a aplicao mostrar ao usurio cada
registro a ser processado solicitando confirmao. Se
for selecionada a opo Altera sem confirmar o
sistema efetuar os processamentos sem formular
qualquer pergunta.
Selecione Altera sem confirmar depois verifique que
os percentuais de lucro bruto dos itens BORRACHA
foram modificados para 90.
Consulta de registros de produtos
Esta opo proporciona ao usurio a manipulao total
do arquivo, a partir de uma tela cheia, na qual os
registros so apresentados em grupos, com os campos
mostrados dentro de colunas que podem estar contidas
em janelas horizontais. Por esta razo, algumas vezes
vamos nos referir a esta consulta como Tela
paginada.
Manual do Usuri o
425
Nesta consulta em tela paginada o usurio tem
poderosos recursos para manipular os dados existentes
nos arquivos, desde a definio de consultas at a
montagem de relatrios. Sempre que uma consulta for
definida na tela paginada, utilizando os recursos de
apagamento de colunas, insero de novas colunas,
ordenaes, etc, o usurio poder grav-la sob uma
identificao qualquer, para utiliz-la sempre que
necessrio.
Antes da abordagem dos recursos existentes na tela
paginada, necessrio conhecer as teclas utilizadas
para a navegao ou movimentao. Na tabela a seguir,
o smbolo ^ significa que a tecla marcada CTRL deve
ser pressionada e retida at que a tecla seguinte seja
apertada:
Tecla Funo
Seta para direita Move para o campo seguinte do registro
Seta para esquerda Move para o campo anterior do registro
Seta para cima Move para o registro anterior
Seta para baixo Move para o registro seguinte
^ + Seta para direita Move para a prxima janela
^ + Seta para esquerda Move para a janela anterior
PgUp Mostra o grupo de registros anterior
PgDn Mostra o prximo grupo de registros
^ + PgUp Move para o primeiro registro do arquivo
^ + PgDn Move para o ltimo registro do arquivo
Home Move para o primeiro campo da janela
End Move para o ltimo campo da janela
^ + Home Move para o primeiro campo, primeira janela
^ + End Move para o ltimo campo, ltima janela
Enter
Move na direo ajustada para o cursor
(TAB)
Esc Retorna tela anterior
Manual do Usuri o
426
Se estiver operando com um mouse, o usurio poder
clicar diretamente dentro de campos para modific-los
bem como nas mensagens e smbolos que aparecem na
linha inferior da janela de consulta.
Ao ser ativada a opo de Consulta, a aplicao
apresentar a tela da figura VIII.24.
Figura VIII.24
Se existissem consultas gravadas (mais tarde veremos
como grav-las), a aplicao as apresentaria em um
menu permitindo que o usurio escolhesse uma delas.
Algumas teclas tm significados especiais na operao
da tela paginada:
Tecla F3 Tem como finalidade a habilitao/desabilitao da
pesquisa dinmica, na qual, medida que se digita um
caracter, automaticamente, j efetuada busca que
atenda condio de pesquisa. Quando houver um
sinal como {*Procura*}, ao topo da tela de consulta, a
funcionalidade de pesquisa dinmica estar habilitada.
Alt - Z Amplia a janela de consulta (zoom)
Alt - F10 Mostra/esconde registros apagados
Tecla Funo
Manual do Usuri o
427
Tecla TAB Serve para mudar a direo que o cursor assume a cada
vez que a tecla ENTER pressionada. Esta tecla pode
ser acionada mesmo durante as alteraes dos
contedos dos campos, sendo bastante til para se
modificar os campos de um mesmo registro
(horizontal) ou para modificar um mesmo campo em
diversos registros (vertical).
Tecla F9 Quando estiver aparecendo na tela, permite abrir outro
arquivo para ser consultado, em outra janela. Serve
tambm para transferir o contedo de um campo para
outros arquivos, onde estiverem sendo digitados
registros.
Alm dos controles acima, existem ainda outras opes
que podem ser acessadas atravs de menu ativado pela
tecla F10 (figura VIII.25), ou atravs da 1 letra de
cada uma delas.
Figura VIII.25
Procura determinado registro
Esta opo exatamente igual quela explicada
anteriormente no tpico Procura, na operao de
Manuteno. Permite posicionar o cursor sobre
qualquer um dos registros do arquivo, para ser
consultado ou alterado. Esta pesquisa sempre feita
atravs das chaves de acesso de cada um dos conjuntos
de pesquisa estabelecidos para o arquivo. Caso haja
mais de um conjunto de pesquisa, um menu ser
apresentado, podendo o usurio escolher o conjunto de
Manual do Usuri o
428
pesquisa desejado. Para exemplificar, selecione
Procura/Cdigo e digite 10. Verifique que o produto
de cdigo 0010" foi selecionado.
Filtragem (seleciona/ordena)
Aciona a rotina de filtragem que permite a seleo ou
agrupamento dos registros que faro parte da consulta,
ou seja, uma vez estabelecida uma filtragem, somente
os registros que atendam a uma determinada condio
estaro presentes na tela. O processo de filtragem j
foi detalhado na opo Filtra no tpico
Manuteno deste captulo.
Digitao - inclui registros
Permite a digitao (incluso) de novos registros
dentro do arquivo de dados corrente. Esta operao
est sujeita s mesmas validaes (crticas)
estabelecidas para a incluso normal de registros no
arquivo de dados, sendo bastante til para se inserir
registros em tabelas (arquivos onde informaes
digitadas so validadas).
Modifica contedo do campo
Permite a alterao das informaes contidas no
campo onde o cursor estiver posicionado. A alterao
de campos est sujeita s mesmas validaes
estabelecidas para a digitao de registros.
Exclui (marca apagamento)
Marca para excluso, o registro que estiver sendo
acessado no momento. A excluso definitiva do
registro s feita atravs das rotinas de Apoio/
Elimina reg apagados. Conforme o ambiente da
aplicao esteja configurado, uma confirmao poder
Manual do Usuri o
429
ser solicitada ao usurio, antes do processo de
marcao do registro.
Recupera (desmarca apagamento)
Recupera o registro marcado pela opo anterior
(retira a marcao).
V todo o registro na tela
Mostra a tela de digitao do arquivo corrente,
somente para consulta, com os respectivos contedos
de campos. Se houver mais de uma rea de tela para o
arquivo, o usurio poder utilizar as teclas PGUP e
PGDN para exib-las.
Nova coluna
Possibilita que uma nova coluna seja criada e inserida
na consulta. Ao ativar este comando, o usurio poder
entrar com o ttulo e o contedo da nova coluna, bem
como com a respectiva mscara. O contedo dessas
colunas pode se constituir de campos de outros
arquivos, frmulas envolvendo campos, etc.
Para inserir uma nova coluna na janela de consulta,
basta responder algumas perguntas feitas pela
aplicao. Para exemplificar, vamos criar uma nova
coluna para mostrar ao lado do preo de custo, uma
frmula incrementando-o em 10%.
Utilizando as setas, posicione a barra sobre a coluna
Preo Indexado e pressione N.
Ttulo da nova coluna
Essa informao servir para intitular a coluna a ser
criada na consulta. O usurio deve entrar com uma
informao que possa identificar o contedo da nova
coluna. Se desejar criar coluna contendo um campo de
outro arquivo de dados, basta pressionar F10, escolher
Manual do Usuri o
430
o arquivo desejado e o campo desse arquivo para ser
mostrado na nova coluna. Para este exemplo, digite
MAIS 10% conforme tela da figura VIII.26.
Figura VIII.26
Expresso contedo
Informe uma expresso para contedo da nova coluna.
So vlidas as expresses da linguagem CA-Clipper
bem como nomes de campos. O usurio pode
pressionar a tecla F10 para apresentar um menu com
os nomes dos campos do arquivo em uso. Entre com a
frmula que aparece na tela da figura VIII.27.
Figura VIII.27
Manual do Usuri o
431
Com a mscara
A mscara um gabarito segundo o qual as expresses
so mostradas. Alguns exemplos de mscaras:
mostrado naquela posio aparea sempre em
maisculo;
@! - todos os caracteres dentro do campo sero
transformados para maisculo;
99999999 - somente dgitos numricos na mesma
quantidade de 9" existentes sero mostrados;
@R 999-9999 - @R na mscara faz com que barras,
pontos, hfens ou vrgulas sejam apresentados nas
posies, mesmo que no existam no contedo do
campo;
decimais, ajustando-se ao formato numrico
utilizado no Brasil.
Para este nosso exemplo, entre com a mscara: @E
99,999,999.99 e verifique que uma nova coluna foi
criada, contendo o preo de custo majorado em 10%.
Apaga coluna do cursor
Permite ao usurio retirar da consulta, a coluna onde o
cursor estiver posicionado. Observar que somente a
coluna desaparece, no existindo qualquer alterao na
estrutura do arquivo DBF.
Imprime a consulta
Possibilita o envio da consulta montada na tela
paginada para a impressora. Todos os campos
numricos so automaticamente totalizados. Os
campos do tipo MEMO, se existirem, sero ignorados
nesta impresso. Se existir mais de uma janela aberta
Manual do Usuri o
432
(atravs da tecla J), e a mesma estiver relacionada
(arquivos sincronizados), os registros desta tambm
sero impressos.
Ordena os registros
Estabelece uma nova ordem para os registros que
aparecem na consulta, ou seja, possibilita a
apresentao da consulta com ordenaes comandadas
por outros campos do arquivo ou por qualquer coluna
que tenha sido criada. Mesmo que o arquivo seja
ordenado, as pesquisas ao arquivo continuam a ser
feitas em funo dos campos definidos nos conjuntos
de pesquisa. Ao ser escolhida a ordenao poder
aparecer um menu oferecendo opes de utilizao dos
ndeices j existentes para o arquivo. Selecionada a
opo outra ordem, a tela da figura VIII.28 ser
apresentada.
Figura VIII.28
A partir da tela da figura VIII.28, o usurio poder
selecionar os campos que determinaro a classificao
da consulta. A ordem pode ser estabelecida em funo
de mais de um campo, porm, campos do tipo memo,
se existirem, no podero ser selecionados.
A exemplo do processo de filtragem, explicado
anteriormente neste captulo, existe a possibilidade de
se estabelecer uma ordenao livre. No entanto, para
Manual do Usuri o
433
usar este recurso, o usurio poder necessitar do
conhecimento de algumas funes do CA-Clipper.
Pode-se ainda, aps a escolha de cada um dos campos,
determinar se a ordenao ser crescente ou
decrescente.
Quantifica registros
Efetua a contagem de registros que atendam a uma
determinada condio definida pelo usurio. A
condio sempre estabelecida atravs do processo de
filtragem, explicado anteriormente neste captulo.
Estabelecida a condio, a aplicao far a contagem
dos registros, apresentando o resultado final em uma
janela centralizada na tela.
Localiza um registro
Localiza determinado registro no arquivo, por pesquisa
seqencial. A localizao de registros pode ser feita
por argumento ou por uma condio atendida. Ao ser
ativada esta opo, com a tecla L ou atravs da
seleo de menu, a posio da barra seletora
relevante pois, o campo em que esta estiver
posicionada que servir de alvo da comparao. Por
exemplo, a figura VIII.29 mostra a tela que
apresentada aps pressionar L sobre o campo
Descrio do produto.
Manual do Usuri o
434
Figura VIII.29
Por argumento
Na pesquisa por argumento, o sistema solicita ao
usurio a informao do argumento a ser pesquisado
no campo que a barra seletora estava posicionada e
proceder conforme se segue:
Se o campo for do tipo caracter ou memo,
tentar localizar o primeiro registro do arquivo que
CONTENHA o argumento informado, em qualquer
posio do campo. Neste caso, se a mscara desse
campo for diferente de @! (tudo maisculo) o
usurio poder escolher ainda, atravs da pergunta
A=a?, se a pesquisa ser feita com ignore case,
ou seja, se caracteres maisculos ou minsculos
sero tratados como idnticos durante a pesquisa.
Se o campo for do tipo numrico ou data, o
sistema tentar localizar o primeiro registro que
tenha como contedo do campo selecionado o
argumento informado.
Por condio atendida
Na localizao por uma condio, o usurio poder
estabelecer uma condio qualquer, utilizando o
processo de filtragem j descrito neste capitulo, e o
sistema tentar localizar o primeiro registro que atenda
a essa condio.
Manual do Usuri o
435
Seguinte - localiza seguinte
Continua uma pesquisa seqencial ao arquivo,
encontrando o prximo registro, que satisfaa a
condio ou argumento de localizao estabelecido
pelo processo anterior (L). Por essa razo, esta opo
poder no estar figurando no menu, o que acontecer
somente quando a opo L tiver sido ativada com
sucesso.
Global - processa os registros
Possibilita o processamento global dos registros que
aparecem na consulta. Este processamento pode ser
feito para modificaes de campos, apagamento e
recuperao de registros. A montagem de um
processamento global j foi descrita detalhadamente
neste manual, no tpico Manuteno.
Congela/descongela colunas
Fixa ou congela as colunas que esto esquerda da
barra seletora mantendo-as na tela, mesmo que as setas
esquerda e direita sejam utilizadas para rolagem
horizontal da tela. Quando colunas so congeladas,
uma barra vertical mais larga aparece para delimitar as
reas que podem e no podem ser roladas. Por
exemplo, a tela da figura 8.30 aparece quando a tecla
C foi pressionada com a barra seletora posicionada
em Descrio do produto.
Manual do Usuri o
436
Figura 8.30
Quando desejar descongelar colunas, basta
posicionar a barra seletora sobre a primeira coluna da
janela, pressionando novamente a tecla C.
Tamanho - muda tamanho da coluna
Permite alterar o tamanho ou a largura de exibio de
uma coluna. Ao pressionar a tecla T, dever entrar
com a largura a ser assumida para a coluna onde
estiver posicionada a barra seletora.
Janela - abre uma nova janela
Abre uma nova janela de consulta ou, se j existir
duas, permite a permuta de operao entre elas. Esta
opo muito til para a visualizao de dois arquivos
ao mesmo tempo, relacionados entre si, atravs de um
dos seus campos. Para abrir uma segunda janela, o
usurio pressiona J e seleciona atravs de menu, o
novo arquivo a ser aberto. Se o arquivo for diferente
do que estiver em uso na primeira janela, o usurio
poder estabelecer um relacionamento entre os dois
arquivos, atravs da tela da figura VIII.31.
Manual do Usuri o
437
Figura VIII.31
Para que exista um relacionamento, o contedo do
campo utilizado para sincronizar os dois arquivos tem
que, obrigatoriamente, existir nos dois arquivos,
mesmo com nomes diferentes, isto , os contedos dos
campos dos dois arquivos devero ser compatveis.
Finalmente, o campo aqui informado, dever ser o
primeiro campo da expresso chave do outro arquivo
de dados.
Exporta dados (TXT, SDF, DBF)
Exporta os dados constantes da consulta para outras
aplicaes, criando arquivos nos seguintes formatos:
Formato TXT (texto)
Neste formato, normalmente usado por processadores
de texto, os dados so delimitados por aspas e outro
caracter qualquer (geralmente a vrgula). Se for
escolhido este formato, o usurio poder informar o
delimitador desejado para satisfazer o seu processador
de texto.
EX.: 0017",RGUA PLSTICA 30CM","UN"
Manual do Usuri o
438
Formato SDF
No formato (Standard Data Format ou Formato Padro
de Dados) as informaes so gravadas sem
delimitadores, sendo identificados apenas pelos seus
tamanhos. til para transferir dados para serem
manipulados por outras linguagens.
EX.: 0017RGUA PLSTICA UN
Formato DBF
Este o mesmo formato que se encontra nos arquivos
de dados. Esta opo til para criar subconjuntos de
qualquer arquivo de dados manipulado pela aplicao.
Totaliza coluna
Permite realizar o somatrio da coluna onde est
posicionado o cursor, para os registros contidos na
consulta. Naturalmente se aplica somente para
contedos do tipo numricos.
Estabelece condio para marcar
Permite a entrada de uma condio para que os
registros que a atendam, apaream de cores
diferenciadas dentro da consulta. O esquema de cor
utilizado para marcar registros na consulta o mesmo
da JANELA DE AJUDA.
Em ambiente de REDE LOCAL, existem ainda duas
teclas (+) e (-) que servem para adiantar ou atrasar, em
5 segundos, o tempo de atualizao da tela de consulta,
ou seja, o tempo utilizado pela aplicao para fazer o
refresh da tela, de modo que os registros digitados ou
atualizados por outros usurios da rede possam
aparecer na sua tela de consulta. Este tempo, que
ajustado inicialmente para 25 segundos, utilizado
Manual do Usuri o
439
tambm nas telas que aparecem quando a opo
Manuteno, explicada anteriormente, selecionada.
Caso o seu valor seja 0, a aplicao no executar o
refresh automtico da tela.
Com o tempo de utilizao, o usurio assimilar as
opes existentes, no precisando mais pressionar F10
para ver o menu, podendo apertar diretamente a letra
inicial da opo desejada.
Ao abandonar as operaes de consulta, se tiver
utilizado os recursos de criao de colunas, ordenao,
filgragem, etc., o usurio poder gravar em disco a
consulta, identificando-a atravs de uma frase com at
58 caracteres, conforme tela da figura VIII.32.
Sempre que desejar novamente esta mesma consulta,
basta selecionar esta frase atravs do menu de
consultas, que aparece sempre que uma nova consulta
solicitada.
Figura VIII.32
Emitindo informaes
A opo de emisso tem a finalidade de permitir a
extrao das informaes contidas nas bases de dados
atravs da impresso de relatrios ou etiquetas. Na
nossa aplicao exemplo, definimos alguns relatrios
para serem emitidos, alm de uma etiqueta de preos
de produtos. Veremos agora quais os recursos que
temos para emitir essas informaes.
Manual do Usuri o
440
Relatrios
Aps selecionar Emisso/Relatrios/Tabela de
preos, a tela da figura VIII.33 ser apresentada.
Figura VIII.33
Atravs deste menu, pode-se selecionar as seguintes
opes:
Prosseguir
Selecionar esta opo quando desejar emitir o
relatrio.
Sada
Atravs desta opo, pode-se selecionar o dispositivo
para onde ser enviado o relatrio. Escolhendo esta
opo, um menu apresentado, de onde pode ser
selecionada a impressora/porta para envio do relatrio.
Outra opo constante deste menu a emisso deste
relatrio em arquivo/vdeo. A impresso direcionada
para arquivo/vdeo permite que o relatrio seja
visualizado a qualquer momento, e ainda, que seja
posteriormente emitido em papel. Quando utilizar este
recurso, lembre-se de, primeiramente, configurar a
impressora pois, os cdigos desta so gravados
juntamente com os dados do relatrio e no podem ser
mudados depois.
Manual do Usuri o
441
Filtrar
Esta opo possibilita o agrupamento dos registros a
serem considerados no relatrio, atravs do processo
de filtragem explicado anteriormente no tpico
Manuteno deste captulo.
Cpias
Selecionada esta opo, o sistema solicita que o
usurio informe o nmero de vezes (originais) que o
relatrio ser emitido.
Ordenar
Esta opo permite ao usurio determinar uma ordem
para a emisso, em funo de qualquer um dos
contedos do relatrio. O processo de ordenao j foi
explicado no tpico Consulta deste captulo.
Ttulo
Possibilita a entrada de uma frase para intitular o
relatrio a ser impresso.
Para exemplificar, vamos emitir o relatrio Tabela de
preos em um arquivo de nome TBPRECO.PRN.
Selecione Sada, pressione ENTER e selecione a
opo Arquivo/vdeo. A mensagem frente da
palavra Sada ser alterada para ARQUIVO/
VDEO.
A seguir, selecione Prosseguir e informe o nome de
arquivo TBPRECO, conforme aparece na tela da
figura VIII.34.
Manual do Usuri o
442
Figura VIII.34
A extenso no precisa ser informada pois, .PRN
ser assumida.
Informado o nome do arquivo, o sistema gravar no
disco um arquivo de nome TBPRECO.PRN contendo
a imagem do relatrio Tabela de preos.
Posteriormente, a partir da opo V relatrio
gravado (menu de apoio), pode-se visualiar e
imprimir este relatrio.
Etiquetas
Como definimos a emisso de etiqueta no nosso
exemplo, vamos selecionar Etiqueta de preo a partir
do menu de emisso. Sempre que uma opo de
emisso de etiqueta selecionada, o sistema
apresentar a tela da figura VIII.35.
Manual do Usuri o
443
Figura VIII.35
As cinco primeiras opes deste menu j foram
detalhadas na emisso de relatrios, portanto, veremos
apenas as quatro ltimas. Os nmeros que aparecem
entre parnteses so os nmeros correspondentes ao
que foi definido na fase do projeto, podendo ser
alterados, se necessrio.
Para alterar esses parmetros, utilizaremos a emisso
de um teste de posicionamento, que veremos a seguir.
Altura
Este parmetro corresponde altura em linhas de uma
etiqueta na qual ser impressa a informao do
registro.
Largura
Corresponde quantidade de caracteres permitidos na
horizontal em uma etiqueta.
Separao
a quantidade de colunas (caracteres) que cabem no
intervalo existente entre uma etiqueta e outra, na
horizontal.
Manual do Usuri o
444
Carreiras
a quantidade de etiquetas que existe na horizontal,
no formulrio.
Qtde/Reg
a quantidade de etiquetas a ser emitida para registro
lido no arquivo. Esta quantidade, pode ser fixa ou
varivel, de acordo com um dado (campo) do arquivo.
Grficos
Um grfico foi definido nesta aplicao. A sua
apresentao feita atravs do utilitrio SGR -
Servidor Grfico Residente, que foi carregado na
memria antes do programa executvel desta
aplicao. Para que este grfico seja apresentado,
necessrio que tenham sido feitas algumas operaes
de sada de estoque. Se ainda no o fes, retorne e
comande algumas sadas de material em meses
diferentes. Para apresentar o grfico, selecione a opo
Sadas mensais a partir do menu de emisso. Como
foi definido no projeto uma tela complementar para
receber a informao do ano referncia, pressione
ENTER para aceitar o ano sugerido pela aplicao.
A seguir, o sistema apresentar um menu de onde
podem ser acertados alguns parmetros do grfico,
conforme figura VIII.36.
Manual do Usuri o
445
Figura VIII.36
As opes Prosseguir, Sada, Filtrar e Ttulo
deste menu, j foram detalhadas na descrio da
emisso de relatrio, dentro deste captulo. As outras
duas so:
Resoluo
Diz respeito ao tamanho que o grfico ter, se for
emitido em papel. Esta opo s relevante para
impressoas de pgina (LaserJet, DeskJet, etc.). Em
impressoras matriciais ela no utilizada. As
possibilidades so:
075 - muito grande
100 - grande
150 - pequena
300 - muito pequena
Pintar reas
Esta opo permite ao usurio optar por encher as
reas internas do grfico com as cores disponveis ou,
plotar somente os contornos do grfico.
Quando o grfico estiver sendo apresentado (figura
VIII.37), diversos parmetros podem ser mudados
Manual do Usuri o
446
para alterar o aspecto do grfico, podendo ser alterado
inclusive o tipo de grfico apresentado.
Figura VIII.37
Para o grfico criado nesta aplicao, esto
disponveis os seguintes comandos:
F1 - apresenta os comandos disponveis
F2 - altera o tipo de apresentao de grades no
grfico. Essas grades podem ser apresentadas na
parede esquerda do grfico, na parede direita ou em
ambas as paredes.
F3 - altera a posio do ttulo do grfico (esquerda,
centro ou direita).
F4 - permite ligar ou desligar a enfatizao dos
textos na tela do grfico.
F5 - permite a colocao o retirada de hachuras nas
paredes do grfico.
F6 - permite alterar a posio da legenda do eixo Y
(esquerda, direita ou ambos os lados).
F7 - tira ou coloca borda no grfico.
F9 - permite encher com cores as areas internas das
barras ou apresentar somente os seus contornos.
Manual do Usuri o
447
F10 - apresenta um menu com os tipos de grficos
possveis de serem plotados com os mesmos dados.
ESC - finaliza a apresentao do grfico
ALT-F1 - imprime o grfico em papel (rotinas
internas do SGR)
ALT-F2 - imprime o grfico em papel, atravs do
utilitrio GRAPHICS.EXE do DOS (tem de estar
carregado na memria).
ALT-F3 - permite a alterao do tamanho do ttulo
do grfico.
ALT-F4 - salva a imagem do grfico em um arquivo
de formato .PCX a 16 cores.
ALT-F7 - alterna a largura das colunas do grfico,
ocupando ou no toda a rea de sua base.
CTRL-N - Inverte cores preto e branco da rea
plotada, ideal para captura em arquivo PCX.
+/- - muda as cores utilizadas nas barras.
Sempre que um grfico vai ser apresentado, a
aplicao gera um arquivo de parmetros para o SGR,
antes de invoc-lo. Numa segunda apresentao deste
grfico, a aplicao verificar a existncia deste
aquivo e perguntar, atravs de menu, se o usurio
deseja utilizar os mesmos dados ou se necessrio um
reclculo. Se tiver certeza de que no houve insero
de novos registros ou alterao nos arquivos de dados
utilizados pelo grfico aps a ltima plotagem com
reclculo, selecione Utilizar as especificaes. Caso
contrrio, selecione Recalcular.
Apoio
A finalidade principal das rotinas de Apoio
auxiliar o usurio na administrao da sua aplicao. A
partir deste mdulo, poder fazer cpias de segurana,
Manual do Usuri o
448
recuperao de dados, indexao de arquivos,
eliminao definitiva de registros dos arquivos,
manipulao de senhas e ainda, fazer algumas
configuraes para mudar o comportamento da
aplicao. A nossa aplicao exemplo foi criada com
as rotinas de apoio que aparecem na tela da figura
VIII.38.
Figura VIII.38
Parmetros do sistema
Esta opo foi colocada em Apoio apenas para
exemplificar a flexibilidade de modularizao do
GAS-Pro. Anteriormente, j acessamos esta opo e
cadastramos alguns parmetros a serem utilizados pela
aplicao.
Backup
Esta opo permite que o usurio copie os arquivos de
dados da aplicao, a fim de assegurar a integridade
das informaes manipuladas pela aplicao. Ao ser
selecionada esta opo, o usurio poder escolher de
um menu qual o drive/diretrio (A, B ou Outro...) a ser
utilizado para a execuo das cpias. Escolhido este
drive/diretrio, o sistema executar as cpias e
fazendo o controle dos disquetes/diretrios que esto
sendo utilizados.
Manual do Usuri o
449
Para a execuo dessa opo, utilizando-se disquetes,
o usurio dever preparar tais mdias formatadas em
nmero suficiente para receberem as cpias.
Restaura backup
Esta opo permite que o usurio recupere os arquivos
de dados, a partir das cpias de segurana (backup)
que gerou na opo anterior, se porventura, foram
perdidos ou danificados, os arquivos atuais.
Selecionada esta opo, o sistema mostrar um menu
para que o usurio possa escolher o drive com o qual
deseja trabalhar. Aps a escolha do drive/diretrio, se
utilizados disquetes, o sistema solicitar, em
seqncia, as referidas mdias que contm as cpias,
na mesma ordem em que foram gravados, at que a
operao esteja completa.
Reconstri ndices
Esta opo permite que o usurio reconstrua os ndices
dos arquivos, quando estes apresentarem problemas
ocasionados geralmente por quedas ou picos de
energia. Um sintoma seguro de que um arquivo de
ndice no est funcionando bem, quando se procura
durante uma consulta um registro seguramente
existente no arquivo e a aplicao no consegue
localiz-lo. Se notar algo semelhante, o usurio dever
ativar esta opo.
Quando selecionada, esta opo mostra uma janela
com o nome das bases de dados disponveis para
indexao, de onde o usurio poder selecionar qual
dos arquivos ser indexado.
Exclui registros marcados
Esta opo possibilita que o usurio efetue a
eliminao fsica e definitiva dos registros marcados
Manual do Usuri o
450
para apagamento durante as operaes de consulta e
manuteno.
Quando selecionada, mostrar uma janela com o nome
dos arquivos de dados que esto disponveis para
eliminao de registros apagados, de onde o usurio
poder selecionar com qual deseja operar. Nesse
instante, o sistema emitir a mensagem de advertncia
que a operao poder ser demorada. De fato,
dependendo do tamanho do arquivo de dados, a
operao poder demorar um pouco, razo pela qual o
usurio dever escolher o momento mais propcio para
acionar esta opo.
V relatrio gravado
Esta opo permite a visualizao de um relatrio que
tenha sido emitido atravs da opo arquivo/vdeo.
Durante a visualizao do arquivo, existe a
possibilidade de imprim-lo na impressora, inclusive
escolhendo a pgina inicial.
Configura ambiente
Esta opo possibilita, atravs da tela da figura
VIII.39, mudar o comportamento e aspecto da
aplicao:
Figura VIII.39
Manual do Usuri o
451
Impressora
Se, por alguma razo, a impressora conectada ao micro
precisar ter suas caractersticas alteradas, ou se queira
cadastrar uma nova impressora, esta opo poder ser
utilizada.
Ao ser acionada esta opo, o sistema apresenta um
menu com as impressoras mais comuns, para serem
selecionadas e modificadas. Se nenhuma delas atender
s necessidades, pode-se fazer a incluso de outras
impressoras, atravs da opo * NOVA *, entrando-
se com os seus cdigos relativos aos efeitos desejados,
a partir da tela da figura 8.40. Esses cdigos devem
estar de acordo com o especificado no manual do
fabricante da impressora.
Figura 8.40
Pano de fundo
Possibilita a seleo, atravs de menu, do caracter a
ser utilizado para preencher a tela de fundo da
aplicao, sobre a qual iro aparecer as diversas
janelas de menu, mensagens e caixas de dilogo.
Fontes de caracteres
Carrega fonte de caracteres para serem mostrados em
monitores de vdeo do tipo VGA/SVGA, em
substituio aos caracteres normais.
Manual do Usuri o
452
Esquemas de cores
Permite selecionar um novo esquema de cor para a
exibio dos objetos na tela. Um esquema de cor
sempre caracterizado por dois parmetros: a cor
utilizada na frente combinada com a cor utilizada no
fundo.
Pano de fundo
Esquema de cor a ser aplicado ao caracter utilizado
para preencher a tela inicial da aplicao.
Janelas
Retngulos onde aparecem as mensagens fixas da
aplicao. Este esquema tambm utilizado para
apresentar a janela da opo Consulta.
Caixas de dilogo
Janelas onde as informaes solicitadas pela aplicao
sero digitadas pelo usurio. Constam de um ttulo,
mensagem ao usurio e um campo onde so digitadas
as informaes solicitadas. Este esquema tambm
utilizado para apresentar o cabealho e rodap da tela
da opo Consulta.
Avisos e erros
Janelas onde aparecem as mensagens de erros ou
avisos ao usurio, durante a operao da aplicao.
Menus e campos
Janelas de menus de onde so selecionadas as opes
de operao, bem como dos campos onde so digitadas
as informaes.
Manual do Usuri o
453
Tela de digitao
Tela onde so digitados os dados que iro para os
arquivos de dados. Este esquema tambm utilizado
para apresentar a segunda janela de Consulta, se
alguma foi aberta com a opo J, j explicada.
Tela de digitao no ativa
Tela de digitao dos dados do arquivo relacionado
no utilizado no momento. S aparece quando existem
dois arquivos com relacionamento 1-N. No nosso
exemplo, a tela de digitao de Notas Fiscais e a de
digitao de Produtos da Nota Fiscal.
Janela de ajuda
o esquema de cor utilizado nas janelas que
apresentam ajuda ao usurio sempre que a tecla F1
pressionada.
A tela de configurao de cores aparece na figura
8.41.
Figura 8.41
Para configurar um esquema de cor, proceda da
seguinte maneira:
a. Atravs do menu, selecione o esquema
desejado;
Manual do Usuri o
454
b. Movimente as setas (cima, baixo, esquerda e
direita) e observe o efeito na janela exemplo
intitulada EXEMPLO DO ESQUEMA
SELECIONADO que aparece a seguir. Observe
que, as setas cima/baixo alteram a cor da frente
e as setas esquerda/direita alteram a cor do
fundo;
c. Pressione a tecla ENTER quando a cor do
exemplo estiver de acordo com o pretendido.
Se estiver utilizando mouse, basta clicar diretamente
sobre o esquema desejado para fazer a seleo.
Quando terminar, basta pressionar ESC para que a
aplicao assuma a nova configurao.
Confirma em campos
Ao operar a aplicao, sempre que o usurio estiver
digitando algo, como por exemplo, incluindo registros,
informando nomes de arquivo, etc., quando o cursor
chega ao final do campo, a informao nele digitada
aceita automaticamente, sem a necessidade de
pressionar a tecla ENTER.
Atravs dessa opo, o usurio poder ligar e desligar
este efeito, com abrangncia para toda a operao do
sistema. Neste caso, se a opo Confirma em campos
estiver assinalada, o usurio dever apertar a tecla
ENTER sempre que estiver entrando com informaes
na aplicao.
Confirma excluses
Durante as operaes de Manuteno ou Consulta
de registros, ao pressionar a tecla E, o registro
atualmente acessado marcado para ser excludo do
arquivo de dados. Se esta opo estiver assinalada, o
usurio dever confirmar a excluso do registro, caso
contrrio, o registro ser excludo automaticamente.
Manual do Usuri o
455
Confirma incluses
Se esta opo estiver assinalada, a entrada de cada
registro digitado ser confirmada atravs de mensagem
apropriada. Se estiver desligada, os registros digitados
sero includos no arquivo automaticamente.
Efeitos sonoros
Os efeitos sonoros emitidos durante a operao da
aplicao, na apresentao de mensagens, etc, podem
ser ligados ou desligados a partir desta opo.
Ajuda de campo ativa
A ajuda de campo ativa se constitui em uma pequena
janela que aparece ao lado de campos em digitao,
contendo ajuda especfica para cada campo. Esta ajuda
ativa pode ser ligada e desligada atravs deste menu,
embora a tecla ALT-F1 tambm possa ser utilizada
para este fim, quando um campo estiver sendo
digitado.
Utiliza mouse
Esta opo permite desligar e ligar a operao da
aplicao atravs de mouse. Se um mouse estiver
conectado e esta opo for desmarcada, o cursor do
mouse ser desligado e a operao com o mouse no
ser permitida, at que, novamente, esta opo seja
marcada.
Sensibilidade mouse
Possibilita a regulagem da sensibilidade de
movimentao do mouse. Basta clicar sobre as setas
esquerda e direita para mudar os valores da
sensibilidade de movimento vertical e horizontal.
Quanto maiores os valores, menor a sensibilidade, ou
seja, o mouse necessita ser arrastado um espao maior
para movimentar o cursor.
Manual do Usuri o
456
Diretrio de trabalho
Esta opo permite a troca de diretrios onde ficam
residindo os arquivos de dados e de ndices
manipulados pela aplicao. Neste caso, se o diretrio
informado contem arquivos compatveis com a
aplicao, estes sero utilizados e manipulados. Esta
facilidade bastante til quando se trabalha com dados
de reas ou empresas separadamente.
Abandonando a aplicao
Para abandonar a aplicao, o usurio dever
pressionar a tecla ESC a partir do menu principal e
selecionar Finalizar operaes no menu que
apresentado.
Manual do Usuri o
457
Manual do Usuri o
458
Captulo 9: Utilizando a
Documentao do GAS-
Pro (Norton Guides)
No CD do GAS-Pro fornecido um arquivo de nome
GASPRO.NG que contm uma base de consulta com
informaes auxiliares para a sua operao. Esta base
de consulta est no formato do utilitrio The Norton
Instant Access Engine e acessada atravs do utilitrio
NG.EXE, fornecido juntamente com o CA-Clipper 5.x.
Este captulo aborda os aspectos da utilizao deste
utilitrio.
Carregando o Instant Access Engine
O programa Instant Access Engine (NG.EXE) pode ser
carregado de duas maneiras:
Em modo residente, onde o Instant Access Engine
carregado como um programa TSR (Terminate and
Stay Resident), ou seja, permanecendo na memria
at que seja explicitamente removido pelo usurio.
Em modo pass-through, onde o Instant Access
Engine carregado na memria executando tambm
um determinado programa aplicativo. Ele continuar
na memria at que este programa aplicativo
termine.
Em ambos os modos, o programa Instant Access
Engine ocupa aproximadamente 65Kb de RAM, no
importando o tamanho do banco de dados de
documentao que voc acesse.
Para utilizar um banco de dados de documentao,
voc deve primeiro carregar o NG.EXE, o programa
Instant Access Engine. A sintaxe de utilizao a
seguinte:
Manual do Usuri o
459
NG [<linha-de-comando>]
onde, <linha-de-comando> qualquer comando
vlido do DOS, incluindo os argumentos do
comando. Se o <linha-de-comando>
especificado, o NG carregado no modo pass-
through. Caso contrrio, ele carregado no
modo residente.
Caso voc tenha instalado a configurao padro do
sistema de desenvolvimento CA-Clipper, o NG.EXE
est localizado no diretrio \NG e este foi adicionado
ao path do seu arquivo AUTOEXEC.BAT. Isto
permite a voc acessar facilmente o programa Instant
Access Engine a partir de qualquer unidade de disco e/
ou diretrio.
Utilizando o modo residente
No modo residente, o programa Instant Access Engine
permanecer na memria at que voc o remova
usando as opes Options:Uninstall ou desligando o
seu computador. Isto significa que voc tem acesso ao
banco de dados corrente da documentao dentro de
qualquer tipo de programa, incluindo seu editor, ou a
partir do prompt do DOS.
Utilizando o modo pass-through
No modo pass-through, o programa Instant Access
Engine carregado para a memria e ento o programa
especificado na linha de comando executado. Ao
terminar a execuo deste programa. O Instant Access
Engine removido da memria. Isto significa que voc
somente tem acesso ao banco de dados da
documentao enquanto o programa mencionado na
linha de comando estiver sendo executado. Por
exemplo:
Manual do Usuri o
460
C>NG GAS
carrega o Instant Access Engine e logo aps o
GAS-Pro. Durante a operao do GAS-Pro,
voc pode ativar o Instant Access Engine a
qualquer momento para visualizar o banco de
dados da documentao corrente. Quando
abandonar a operao do GAS-Pro, o Instant
Access Engine automaticamente removido da
memria.
Acessando o programa Instant Access
Engine
Uma vez carregado o Instant Access Engine, voc pode
acessar o banco de dados da documentao atual
pressionando a hot-key de ativao. A hot-key padro
SHIFT-F1. Se esta configurao conflitar com alguma
tecla utilizada por um outro programa, voc pode
troc-la por uma outra usando o item de menu Options/
Hot-key descrito a seguir:
O programa Instant Access Engine no ser exibido se
o seu vdeo estiver trabalhando no modo grfico. Se,
contudo, ele estiver operando no modo 50 linhas
(VGA), o Instant Access Engine ser exibido, porm,
tratando a tela como se tivesse somente 24 linhas.
O Instant Access Engine pode exibir os arquivos de
banco de dados de documentao a partir de qualquer
unidade de disco ou diretrio, desde que eles estejam
localizados no mesmo diretrio que o NG.EXE ou no
diretrio corrente. Quando voc acessa o item de menu
Options/Database para selecionar um novo arquivo de
banco de dados de documentao a ser visualizado, o
Instant Access Engine apresenta uma lista na forma de
menu dos arquivos de banco de dados de
documentaes existentes no diretrio do NG.EXE,
Manual do Usuri o
461
seguido daqueles que foram encontrados no diretrio
corrente.
Se voc instalou a configurao padro do sistema de
desenvolvimento em CA-Clipper 5.x, todos os arquivos
de banco de dados de documentao presentes foram
copiados para dentro do diretrio \NG e o path
atualizado com mais este diretrio. Nesta
configurao, voc pode invocar o Instant Access
Engine a partir de qualquer drive ou diretrio.
Utilizando a janela do Instant Access
Engine
Quando o Instant Access Engine ativado, de incio
aparece uma janela semelhante que temos na figura
IX.1.
Figura IX.1
Na parte superior da tela est o nome do banco de
dados da documentao corrente seguida pelos nomes
das categorias (tpicos selecionados) maior e menor.
Logo abaixo temos o menu de barra.
Manual do Usuri o
462
O menu de barra
O menu de barra fornece a voc as opes via menu do
tipo pull-down para selecionar e ativar diferentes
bancos de dados de documentao, procurar palavras-
chave na lista corrente dos tpicos selecionveis (short
entries), e trocar a configurao padro do Instant
Access Engine. Os trs primeiros menus exibidos so
os menus de sistema do Instant Access Engine e que
sempre so mostrados. Os menus restantes so
colocados no menu de barra pelo banco de dados da
documentao corrente.
Cada menu pode executar diretamente uma
determinada operao ou abrir um outro menu. Dos
menus de sistema, Expand e Search executam a
operao automaticamente. Search exibe uma janela
para a entrada de um dado, e Options abre um menu
com os itens de configurao.
Selecionando menus e opes
Quando o menu de barra est ativo, voc pode
selecionar um determinado menu pressionando a
primeira letra do item ou movendo a barra seletora
para a direita ou para esquerda. Se voc utiliza o
mtodo da primeira letra para selecionar os menus
Expand ou Search, a letra executa automaticamente o
menu. Caso utilize o mtodo da navegao, voc deve
pressionar ENTER para executar a opo de menu.
Quando voc acessa um menu do tipo pull-down,
aparece a lista de itens de menu. Voc ento seleciona
um dos itens de menu da mesma maneira que seleciona
um menu, ou seja, atravs do mtodo da primeira letra
ou movendo a barra seletora para o item desejado e
pressionando ENTER.
Para cancelar um menu pull-down, pressione ESC e a
barra seletora voltar ao menu Expand.
Definindo tamanho e movendo a janela do Instant
Access Engine
Normalmente, a janela do Instant Access Engine ocupa
a tela inteira. Se voc necessita ver a tela de seu
Manual do Usuri o
463
programa aplicativo sem sair do Instant Access
Engine, o item de menu Options/Full screen ou F9
comuta o tamanho da janela de visualizao entre os
modos tela inteira (full-screen) e meia tela (half-
screen). Um caracter indicador presente ao lado do
item de menu mostra que o modo corrente tela
inteira.
Quando a janela do Instant Access Engine ativada no
modo de meia tela, ela se abre ao lado oposto ao
cursor, ou na parte superior da tela ou na inferior. Se
esta janela cobrir informaes importantes da tela do
seu programa aplicativo, voc pode mover a janela do
Instant Access Engine para cima ou para baixo na tela.
Para fazer isto, pressione Scroll-Lock e ento use as
teclas de setas para cima e para baixo para mover a
janela para uma nova posio. Quando voc tiver
terminado, pressione Scroll-Lock novamente para
congelar a tela nesta nova posio. Note que o Instant
Access Engine no guarda o novo posicionamento da
tela. Cada vez que voc sair do Instant Access Engine
e reativ-lo no modo de meia tela, a janela sempre ser
aberta do lado oposto ao que se encontra o cursor.
Obtendo ajuda de operao
Enquanto estiver operando na janela do Instant Access
Engine, voc poder chamar a tela de ajuda tal como
mostra a figura IX.2, pressionando F1.
Manual do Usuri o
464
Figura IX.2
Esta janela d a voc todas as informaes sobre o
programa Instant Access Engine e o banco de dados da
documentao corrente. Se o banco de dados corrente
o GAS-Pro 1.1 ou o The Guide to CA-Clipper , haver
uma legenda dos smbolos utilizados nos tpicos
selecionveis da lista.
Visualizando um banco de dados de doc-
umentao
Basicamente, um banco de dados de documentao
uma estrutura hierrquica formada dos seguintes itens:
Menus
Itens de menu
Tpicos selecionveis
Textos explicativos
Tpicos relacionados (See also)
Em um banco de dados de documentao tpico, um
menu exibe uma srie de categorias como seus itens.
Cada item de menu, por sua vez, refere-se a uma lista
de tpicos selecionveis ou a um simples texto
Manual do Usuri o
465
explicativo. Cada tpico selecionvel tambm pode se
referir a uma outra lista de tpicos ou a um texto
explicativo. Se voc considerar um banco de dados de
documentao como sendo uma estrutura em forma de
rvore, os textos explicativos so as ramificaes da
rvore e contm a informao dos tpicos atuais. Estes
textos explicativos somente podem referir-se a outros
textos explicativos atravs da lista de tpicos
relacionados, ou identificada como see also.
A lista de tpicos selecionveis
Uma vez tendo selecionado um determinado assunto
do banco de dados da documentao corrente
utilizando o sistema de menus, geralmente
apresentada a voc uma lista de tpicos selecionveis.
Os tpicos selecionveis so apresentados na forma de
uma palavra-chave, tal como o nome de uma funo,
seguida de uma breve descrio. por exemplo, a figura
IX.1 mostra a lista de tpicos selecionveis sobre
funes do GAS-Pro 4.0.
Para navegar na lista de tpicos, voc pode utilizar as
teclas de movimentao do cursor (veja tabela logo a
seguir) ou utilizar o menu Search.
Procurando uma lista de tpicos selecionveis
Ao invs de ficar navegando ou paginando a tela
atravs de uma lista de tpicos, voc pode procurar um
determinado tpico que contenha uma seqncia de
caracteres especfica utilizando o menu Search.
Quando voc seleciona o menu Search, uma pequena
janela se abre para que voc digite a seqncia de
caracteres a ser pesquisada. Caso voc j tenha
realizado uma busca, o contedo desta busca
reaparecer. Para entrar com uma nova seqncia de
caracteres, inicie a digitao e o texto anterior ser
apagado. Se voc desejar alterar o trecho de texto
existente, pressione HOME (ou qualquer outra tecla de
movimentao do cursor) antes de digitar o novo texto.
Manual do Usuri o
466
Uma vez informada a seqencia de caracteres a ser
procurada, a tecla ENTER iniciar a operao de
busca. A procura inicia-se a partir do prximo tpico
selecionvel e continua at o final da lista de tpicos.
Se a busca no tiver sucesso, ela se reiniciar a partir
do topo da lista.
O processo de busca no faz diferenciao entre letras
maisculas e minsculas, permitindo a voc utilizar
qualquer combinao de letras nos trechos de texto. E
ainda, a busca tambm realizada nos tpicos atravs
da comparao da parte (esquerda) da seqncia de
caracteres, dando a voc a oportunidade de especificar
apenas uma seqncia parcial de caracteres.
Para continuar a procurar pela prxima ocorrncia da
seqncia de caracteres especificada, execute
novamente a opo de menu Search ou pressione
CTRL-S.
Expandindo um tpico - descendo um
nvel
Uma vez localizado um tpico de seu interesse, voc
pode mover-se para um nvel inferior na hierarquia do
banco de dados atravs da execuo do menu Expand.
O tpico referenciado pode ser uma outra lista de
tpicos selecionveis ou um texto explicativo. Se for
um texto explicativo, a janela de visualizao do
Instant Access Engine toda substituda pelo texto e o
menu de barra inicial tambm substitudo pela lista
de tpicos relacionados (See also).
J dentro do texto explicativo, voc pode navegar
utilizando as teclas de movimentao do cursor. Por
exemplo, seta para cima, seta para baixo. PgUp, e
PgDn movem o texto dentro da janela, enquanto que
seta para esquerda e seta para direita movimentam a
barra seletora sobre o menu de tpicos relacionados
(caso haja algum).
O menu Expand sempre o padro que permanecer
selecionado a menos que voc explicitamente acesse
Manual do Usuri o
467
um outro menu. Mesmo assim, depois de fazer a
seleo do outro menu, a barra seletora
automaticamente volta para o menu Expand. Isto faz
com que voc desa um nvel mais facilmente j que
pressionando ENTER, invariavelmente, executa-se o
menu Expand.
Tpicos relacionados (See also)
Dentro de um texto explicativo, o menu de barra
substitudo pela lista de tpicos relacionados (See
also). Estes tpicos permitem a voc navegar
diretamente para um outro texto explicativo sem a
necessidade de movimentar-se atravs dos menus e
lista dos tpicos selecionveis. Para selecionar um
destes tpicos de relacionamento, mova a barra
seletora utilizando seta para esquerda ou seta para
direita e pressionando ENTER. Voc tambm pode
selecionar um tpico destes utilizando o mtodo da
primeira letra e pressionando ENTER. A figura IX.3
demonstra um texto explicativo e a lista de tpicos
relacionados a ele.
Figura IX.3
Se voc movimentou para o texto explicativo corrente
atravs do menu de tpicos relacionados (See Also), o
Instant Access Engine fornece duas maneiras para
Manual do Usuri o
468
retornar ao texto explicativo inicial, ou seja, aquele a
que nos referimos da primeira vez.
Se o texto explicativo corrente tiver sido acessado
atravs do menu See also, a barra seletora ficar
posicionada nesta referncia. Ento, para retornar ao
texto explicativo referenciado no incio, pressione
ENTER. Por exemplo, se voc iniciar a visualizao do
texto explicativo da funo DECRIPT( ) e logo aps
executar a exibio do tpico relacionado ENCRIPT( ),
o tpico anterior DECRIPT( ) se tornar um item de
relacionamento para o texto explicativo da funo
ENCRIPT( ), sendo a barra seletora posicionada sobre
este. Portanto, pressionando ENTER voc retornar
para o texto explicativo sobre a funo DECRIPT( ) e
o tpico ENCRIPT( ) se tornar outra vez opo do
menu See also sendo iluminado pela barra seletora.
Desta maneira, voc poder mover-se rapidamente
entre dois textos explicativos que estiverem
relacionados, bastando para isso pressionar ENTER
consecutivamente.
Se porventura no houver tpico relacionado ao texto
explicativo que estiver sendo visualizado, e este tendo
sido chamado atravs do menu See also, o Instant
Access Engine coloca a referncia especial Previous
como item de menu ao final da lista corrente. Como
visto anteriormente, voc pode pressionar ENTER para
retornar ao texto explicativo. Note que, o Instant
Access Engine guardar um nico nvel de referncia
quando estiver utilizando o Previous.
Subindo um nvel
De qualquer nvel na hierarquia do banco de dados,
voc pode mover-se para o nvel anterior atravs da
tecla ESC. Se voc, em determinado momento, estiver
localizado em um texto explicativo, pressionando esta
tecla voc se mover para o tpico selecionado
marcado pela barra seletora. Se voc estiver no ltimo
nvel possvel na hierarquia do banco de dados, o
Instant Access Engine encerrado automaticamente.
Manual do Usuri o
469
A tabela apresenta as teclas de navegao do Instant
Access Engine.
Tecla Funo Modo
F1 Auxlio Todos
F9 Comuta tela toda/metade Todos
F10 / Shift+F1 Sai Todos
Esc Move para cima um nvel Tpicos, Textos
Esc Sai Primeiro Nvel
Return Move para baixo um nvel Texto explicativo
Return Seleciona tem Barra de menu, Menu
Return Seleciona tem relacionado Texto explicativo
Cinza - Exibe tem explicativo anterior Texto explicativo
Cinza + Exibe prximo texto explicativo Texto explicativo
Ctrl+S Continua busca Tpico Selecionvel
Scroll-Lock Habilita/Desabilita movimentao Todos
Seta para cima Vai para tem anterior Menu
Seta para cima Vai para linha anterior Tpicos Selecionveis
Seta para baixo Vai para prximo tem Menu, Tpicos
Seta para baixo Vai para prxima linha Texto explicativo
Seta para baixo Move para linha abaixo Movimentao
Seta para direita Vai para prximo tem Menu, See Also
Seta para esquerda Vai para tem anterior Menu, See Also
PgUp Retrocede uma pgina na lista Tpicos Selecionveis
PgUp Retrocede uma pgina no texto Texto explicativo
PgUp Move janela para topo da tela Movimentao
PgDn Avana uma pgina na lista Tpicos Selecionveis
PgDn Avana uma pgina no texto Texto explicativo
Manual do Usuri o
470
Selecionando um novo banco de dados de
documentao
Voc pode selecionar um outro banco de dados de
documentao utilizando o item de menu Options/
Database. Isto permitir a voc selecionar um outro
banco de dados de documentao a partir de uma lista
de menu com todos os bancos de dados disponveis
localizados no diretrio corrente e no diretrio em que
se encontra o NG.EXE. Na configurao padro do
sistema de desenvolvimento CA-Clipper 5.x, o
diretrio assumido o \NG. Quando voc seleciona as
opes Options/Database, uma tela exibida conforme
a figura IX.4.
PgDn Move janela para o fim da tela Movimentao
Home Vai para o primeiro tpico Tpico Selecionvel
Home Vai para primeira linha do texto Texto explicativo
Home Move janela para o canto esquerdo Movimentao
End Vai para o ltimo tem da lista Tpicos Selecionveis
End Vai para a ltima linha do texto Texto explicativo
End Move janela para canto direito Movimentao
Tecla Funo Modo
Manual do Usuri o
471
Figura IX.4
Bancos de dados de documentaes encontrados no
diretrio NG.EXE so mostrados primeiro, seguidos
por aqueles que foram encontrados no diretrio
corrente. Os bancos de dados das documentaes so
ordenados pelos prprios nomes dos arquivos (.NG)
encontrados no diretrio. Para mudar esta ordem, voc
deve classificar fisicamente o diretrio \NG com
algum utilitrio para discos.
Para selecionar um novo banco de dados de
documentao, navegue atravs do menu
movimentando a barra seletora utilizando seta para
cima, seta para baixo, HOME ou END. Pressionando
ENTER, voc ativar o banco de dados selecionado.
ESC cancela a seleo.
Configurando o Instant Access Engine
O menu Options permite a voc trocar determinados
parmetros que afetam a exibio e a operao do
Instant Access Engine. O menu contm as seguintes
opes:
Database
Color
Full screen - F9
Manual do Usuri o
472
Auto lookup
Hot-key
Uninstall
Save options
Comutando as cores
A opo Color ativa e desativa o modo de exibio em
cores do Instant Access Engine, sendo til somente
quando voc tiver um monitor colorido. A
configurao padro ativado e reconhecida por uma
marca indicadora colocada ao lado do item de menu.
Comutando o auto lookup
O item de menu Options/auto lookup ativa e desativa o
modo de busca automtica. Uma marca indicadora ao
lado do item de menu mostra que o modo est ativado.
Quando esta opo est ativa, ao chamar o Instant
Access Engine automaticamente inicia-se a procura
pelo tpico selecionvel para a palavra que est sob o
cursor do programa aplicativo. Se encontrado, este
tpico na lista iluminado pela barra seletora. Se o
modo de Auto lookup est desligado, o ltimo tpico
selecionado por voc antes de deixar o Instant Access
Engine continuar selecionado quando voc tornar a
ativ-lo.
Este item de menu muito til se voc est acessando
o Instant Access Engine a partir do seu editor de textos
enquanto escreve ou edita um programa. No caso de
no saber a sintaxe correta de uma determinada
funo, voc pode digitar o nome da funo no seu
editor e pressionar SHIFT-F1. O tpico sobre a funo
ser mostrado automaticamente pela barra seletora e
pressionando ENTER voc visualizar o texto
explicativo sobre a sintaxe da funo.
Manual do Usuri o
473
Alterando o comando de acionamento
O item de menu Options/Hot key permite trocar as
teclas que voc pressiona para ativar ou desativar o
Instant Access Engine. O comando de acionamento
padro SHIFT-F1, mas voc pode troc-lo por
qualquer tecla ou combinao de teclas vlidas,
incluindo o SHIFT, ALT, e CTRL.
Para trocar o comando de acionamento, pressione a
nova tecla ou combinao de teclas que voc deseja
utilizar como comando de acionamento. Pressionando
ENTER confirmada sua escolha. Pressionando ESC
cancelada qualquer alterao que voc tenha feito.
J que o comando de acionamento do Instant Access
Engine tem precedncia sobre a definio de teclas dos
seus programas aplicativos, caso as teclas sejam as
mesmas, assegure-se de que a escolha de um comando
de acionamento no conflite com outro software que
voc esteja usando.
Gravando a nova configurao
Enquanto voc est utilizando o Instant Access Engine,
os itens que so alterados no menu Options
permanecem com seu efeito at que voc remova o
Instant Access Engine da memria. Se voc quer
gravar as alteraes como uma nova configurao
padro, execute o item de menu Options/Save options.
Ento, da prxima vez que voc carregar o Instant
Access Engine, estas configuraes sero trazidas para
a memria automaticamente.
Quando voc executa o item de menu Options/Save
options, o Instant Access Engine grava as opes
correntes no arquivo NG.INI localizado no mesmo
diretrio que o NG.EXE.
Manual do Usuri o
474
Terminando a operao do Instant Access
Engine
Para terminar de utilizar o Instant Access Engine, voc
pode optar por retornar para onde voc se encontrava
em seu programa aplicativo, ou remover o Instant
Access Engine da memria.
Terminando o Instant Access Engine
Quando terminar de utilizar o Instant Access Engine,
voc pode retornar para onde estava em seu programa
aplicativo atravs do comando de acionamento F10 em
qualquer nvel que voc se encontre. Da prxima vez
que o Instant Access Engine for ativado, voc ir
visualizar a mesma tela tal qual como voc a deixou.
Isto muito til para mover-se rapidamente entre a
visualizao corrente de um tpico ou texto
explicativo e a tela de seu programa aplicativo.
Voc pode tambm voltar tela de seu programa
aplicativo pressionando ESC a partir do primeiro nvel
da lista de tpicos selecionveis. Note que esta
operao pode causar uma sada acidental de tempos
em tempos, j que o ESC tambm faz a visualizao de
nveis superiores. Quando isto acontecer, reative o
Instant Access Engine utilizando o comando de
acionamento.
Desinstalando o Instant Access Engine
Se voc carregou o Instant Access Engine no modo
residente, este pode ser removido da memria
utilizando o item de menu Options/Uninstall. Caso
voc tenha carregado o Instant Access Engine no modo
pass-through, este automaticamente eliminado da
memria quando a execuo da aplicao que foi
especificada na linha de comando terminada e o item
Options/Uninstall no est operacional.
Em alguns casos, voc no conseguir remover o
Instant Access Engine da memria. O caso mais
Manual do Usuri o
475
comum quando voc carrega um outro programa
residente em memria aps ter carregado o Instant
Access Engine e este ltimo permanece residente. Se
isto acontecer, desinstale o programa residente que foi
carregado aps o Instant Access Engine, e s ento
desinstale o Instant Access Engine. Caso no der
resultado, voc ter que reinicializar o seu computador
utilizando CTRL-ALT-DEL.
Manual do Usuri o
476
Manual do Usuri o
477
Captulo 10: Utilizando o
Programa Adaptador de
Arquivos DBF
Sempre que uma modificao no projeto da aplicao
alterou campos de qualquer de seus arquivos ou
modificou opes de integridade referencial, ou um
novo relacionamento foi estabelecido, na prxima
gerao de programas fontes que o GAS-Pro executar,
ser tambm criado um programa fonte cuja finalidade
adaptar os arquivos de dados (DBF) que porventura
j tenham sido criados pela verso anterior da
aplicao.
Toda vez que o GAS-Pro cria este programa, mostra
na tela, ao final da gerao dos programas fontes, um
aviso de que a sua criao foi efetuada e, portanto,
algum tipo de adaptao se faz necessria.
Se os arquivos de dados (DBF) da verso anterior j
possuem registros digitados, recomendamos compilar
e executar este programa toda vez que este for criado
pois, em um projeto definido pelo GAS-Pro, existem
diversas definies que acontecem de modo
transparente para o projetista, como por exemplo, a
criao de campos de controle de integridade
referencial, campos de arquivos relacionados que so
colocados em outras estruturas (pai/filho), campos
para controle de integridade de lanamentos, etc.
Caso no queira executar este programa por no terem
sido digitados dados nos arquivos .DBF, apague
manualmente, a nvel do DOS os arquivos de ndice do
diretrio da aplicao, alm dos *.DB* e *.SYS.
Observe que alguns deles podero ter atributo read
only, dependendo com quais opes a aplicao foi
gerada.
O programa adaptador, de nome XXX_ADAP.PRG,
onde XXX representa as trs primeiras letras do
nome da aplicao, pode ser compilado atravs do
Manual do Usuri o
478
menu principal do GAS-Pro, opo Executvel.
Uma vez compilado, este poder ser executado
normalmente a nvel do DOS, pelo prprio usurio da
aplicao.
Ao ser executado, este programa apresenta uma tela
semelhante que aparece na figura X.1, solicitando o
nome do diretrio onde se encontram os arquivos de
dados da aplicao para serem adaptados, bem como o
diretrio dos arquivos de ndices, para serem
apagados, caso haja necessidade de adaptao do DBF
a que est associado. Tambm, se a aplicao foi
gerada com plano de senhas, este programa solicita o
nome do diretrio da aplicao, para adaptar o arquivo
que armazena as senhas.
Figura X.1
Aps a informao dos diretrios, o programa
executar uma verificao nos arquivos DBF da
aplicao, se existirem, comparando-os com as novas
definies feitas no projeto. Ao encontrar alguma
diferena, apresenta uma tela semelhante tela da
figura X.2, mostrando, do lado esquerdo, os atributos
da nova estrutura, e do lado direito, os campos da
estrutura anterior, que iro ser trocados,
respectivamente.
Manual do Usuri o
479
Figura X.2
Nesta oportunidade, o usurio poder modificar ou
inserir novos contedos dentro de cada campo da nova
estrutura, pressionando ENTER sobre o campo que
deseja modificar, conforme tela da figura X.2.
Atravs dessa tela, o usurio poder digitar o novo
contedo para o campo, devendo ter o cuidado de
observar os tipos corretos dos campos a serem
modificados.
Caso tenha definido um campo sequencial em um
arquivo aps a ltima verso da aplicao, utilize o
nmero do registro (funo RECN( )) para inicializar
este campo. Caso este seja do tipo caracter, deve-se
proceder da seguinte maneira:
RIGHT(STR(10000000000+RECN( )),TamaCampo).
Esta dica se aplica diretamente sobre o campo
INTREF (integridade referencial de lanamentos, onde
TamaCampo=8).
A tecla F10 pode ser pressionada para mostrar os
campos da estrutura anterior do arquivo, de onde
podem ser capturados os nomes dos campos atravs da
tecla ENTER.
Confirmados os contedos a serem colocados na nova
estrutura, basta pressionar ESC e confirmar o
prosseguimento da operao.
A partir deste ponto, o programa adaptador far todo o
trabalho de converso e adaptao do arquivo DBF e
Manual do Usuri o
480
continuar a verificao de outros arquivos que
necessitam ser adaptados.
O arquivo de senhas, se existir, ser adaptado
automaticamente, sem formular qualquer pergunta ao
usurio.
Manual do Usuri o
481
Manual do Usuri o
482
Captulo 11: O GAS-Pro
como Ferramenta de
Desenvolvimento
O presente captulo voltado para pessoas ligadas
rea de informtica, pois apresenta as instrues
especficas que possibilitam e facilitam a modificao
dos programas fontes gerados pelo GAS-Pro, para
atender s suas prprias necessidades.
Funes da biblioteca do
GASPRO5x.LIB e GASP5xPM.LIB
Os arquivos de nome GASPRO51.LIB,
GASPRO52.LIB,GASPRO53.LIB,GASP51PM.LIB,
GASP52PM.LIB e GASP53PM.LIB contidos no CD
do GAS-Pro, so as bibliotecas contendo as funes
desenvolvidas para implementar o CA-Clipper 5.x.
Desenvolvidas na prpria linguagem CA-Clipper e
tambm na linguagem Assembly, essas funes so
largamente utilizadas nos programas fontes gerados
pelo GAS-Pro e esto documentadas a seguir.
Nas explicaes seguintes, deve ser observado que os
argumentos entre os smbolos < e > so
obrigatrios e os argumentos entre [ e ] so
opcionais.
ALERTA( [Nvezes] )
Emite efeito sonoro de Nvezes vezes, com tons
variando do mais grave para o mais agudo. O valor de
Nvezes dever estar entre 1 e 20, e se no existir,
ser assumido o valor 3.
Manual do Usuri o
483
Exemplo
ALERTA( ) //emite 3 notas
ALERTA(2) //emite 2 notas
BLOARQ( [Nvezes][,Nseg] )
Tenta bloquear o arquivo corrente em uso
compartilhado (ambiente multi-usurio). Tenta durante
Nvezes vezes, a cada Nseg segundos. Se Nvezes
for 0 ou omitido, tenta indefinidamente. Se Nseg for
omitido, ser assumido 1 segundo ou, se passado o
valor 0, a tentativa dar-se- a cada tecla pressionada
pelo usurio, podendo ser cancelado o processo atravs
da tecla ESC.
Enquanto perdurar a tentativa de bloqueio, o usurio
poder ver a mensagem Tentando bloquear....
Exemplo
IF BLOARQ(5,.5)
@ 24,1 SAY Apagando registros do ;
+"arquivo. Aguarde..."
PACK
UNLOCK
ENDIF
BLOREG( [N1] [,N2] )
Tenta bloquear o registro corrente de um arquivo de
uso compartilhado (ambiente multi-usurio). Tenta
durante N1 vezes, a cada N2" segundos. Se N1
for 0 ou omitido, tenta indefinidamente. Se N2" for
omitido, ser assumido 1 ou, se passado o valor 0, a
tentativa dar-se- a cada tecla pressionada pelo
usurio, podendo ser cancelado o processo atravs da
tecla ESC.
Manual do Usuri o
484
Enquanto perdurar a tentativa de bloqueio, o usurio
ver a mensagem Tentando bloquear...
Exemplo
IF BLOREG(10,.5)
@ 1,1 GET campo
READ
UNLOCK
ENDIF
CAIXA(
<Mold>,<Lsup>,<Csup>,<Linf>,<Cinf>[,Freq] [,L] )
Produz caixa nas diagonais de coordenadas Lsup,
Csup, Linf e Cinf, usando a moldura contida em
Mold. Se Freq for informado, aps a montagem da
caixa ser produzido um beep de freqncia igual
Freq. A expresso lgica L indica se a caixa
apresentar projeo de sombra sobre a tela.
Exemplo
Moldura=REPL(CHR(219),8)
CAIXA(moldura,4,1,18,79,500,.T.)
CALCDATA(<Data>, <Ndias>)
Gera uma data futura, em formato caracter, Ndias
dias aps a data informada em Data. Se Ndias for
menor que 0, uma data anterior a Ndias dias ser
retornada.
Exemplo
? CALCDATA(10/10/87",5)
// retorna 15/10/87"
Manual do Usuri o
485
? CALCDATA(101087",5)
// retorna 151087"
? CALCDATA(DATE( ),112)
// retorna campo tipo data
CALLINT( <num> )
Executa uma chamada ao interrupt nmero num do
DOS ou da BIOS. O argumento num pode ser um
valor numrico ou caracter representando um valor
hexadecimal. Esta funo pode ser utilizada para
acessar rotinas de baixo nvel do DOS ou da BIOS.
Exemplo
CALLINT(16)
// chama o interrupt 10 da BIOS (16D=10H)
CALLINT(21")
// chama o interrupt 21H do DOS
O exemplo a seguir, utilizando a funo CALLINT( )
pode ser usada para inicializar e verificar o nmero de
botes do mouse:
FUNCTION MOUSE( )
LOCAL d_s, e_s, s_i, d_i
d_s=VAL_DS( ) // salva DS
e_s=VAL_ES( ) // ES
s_i=VAL_SI( ) // SI
d_i=VAL_DI( ) // DI
VAL_BX(00") // zera BX
Manual do Usuri o
486
VAL_AX(00") // servio 0 inicializa mouse
CALLINT(33") // int 33h DOS, fala com
//driver do mouse
VAL_DS(d_s) // restaura DS
VAL_ES(e_s) // ES
VAL_SI(s_i) // SI
VAL_DI(d_i) // DI
RETU VAL_BX( ) // nmero de botoes est em BX
IMPORTANTE!
A utilizao desta funo s recomendada para
programadores que tenham alguma experincia
com a linguagem Assembly. Resultados
imprevisveis podero ocorrer se for utilizada
inadequadamente.
CARDTYPE( )
Esta funo utiliza o interrupt 10 da BIOS para checar
o tipo de placa de vdeo instalada no microcomputador,
retornando:
0 = CGA
1 = MONO/HERCULES
2 = EGA
3 = VGA
Exemplo
x = CARDTYPE()
? Tipo de placa de vdeo:
IF x = 0
?? CGA
ELSEIF x = 1
Manual do Usuri o
487
?? MONO/HERCULES
ELSEIF x = 2
?? EGA
ELSE
?? VGA
ENDIF
CHDIR( <nomedir> )
Tenta se posicionar no diretrio de nome nomedir no
disco especificado. Retorna .T. se a operao teve
sucesso.
Exemplo
IF ! CHDIR(C:\FOLHA)
? Diretrio inexistente
ENDIF
CHDRIVE( <drive> )
Tenta se posicionar no drive de letra drive. Sempre
retorna NIL.
Exemplo
CHDRIVE(C)
CODBARRAS(<aDefCB> [,nCpp] [,nDens])
Esta funo permite a impresso de um ou mais
cdigos de barras em uma linha da impressora. So os
seguintes parmetros para tal funo:
DefCB - representa um arranjo de 4 dimenses com
os parmetros dos cdigos de barras a serem
impressos;
Manual do Usuri o
488
Para cada cdigo de barra existente na mesma linha,
temos a seguinte estrutura:
{Num, Tipo, Largura, Posio}
Onde:
Num
Expresso caracter contendo o nmero ou
cdigo a ser impresso como cdigo de barra.
Tipo
o nmero do tipo de cdigo de barras a
imprimir:
1 = EAN-13
2 = EAN-8
3 = 3 de 9
4 = 2 de 5
5 = UPC-A
Largura
Largura da barra em caracteres.
Posio
Coluna inicial de impresso do cdigo.
nCpp - caracteres por polegada (default=10);
nDens - densidade de impresso de linhas 6 ou 8
lpp. (default=6).
Exemplo
CODBARRAS({{"12345678",2, 8, 5},{"GAS-
Pro",3,21,20}}, 10, 6)
Manual do Usuri o
489
O exemplo acima imprime dois cdigos de barras na
mesma linha. Um do tipo EAN-8 (na coluna 5, com
largura de 8 caracteres) e o outro do tipo 3/9 (na
coluna 20, com uma largura de 21 caracteres).
CONTA( <Letra>, <Msg> )
Conta ocorrncias de um determinado caracter em um
conjunto de caracteres. O parmetro Letra o
caracter a ser contado dentro de um conjunto
especificado no parmetro Msg. Essa funo case
sensitive, isto , considera maisculas diferentes de
minsculas.
Exemplo
x=CONTA(a,"Abacadabra") // retorna 4
DBOX(<Msg>[,lin][,col][,nseg/
menu][,apaga][,tit][,var][,msc][,P][,EC])
Monta caixas de dilogo, menus ou janelas de avisos,
dependendo dos parmetros passados, que so os
seguintes:
Parmetro Tipo Descrio
Msg C
a mensagem que aparecer dentro da janela. Pode conter o car-
acter | para forar a quebra de linhas
lin N
Linha do canto superior esquerdo da janela. Se no informada, a
janela aparecer centralizada verticalmente
col N
Coluna do canto superior esquerdo da janela. Se no informada, a
janela aparecer centralizada horizontalmente
Manual do Usuri o
490
Se for chamada como menu, essa funo retorna o
nmero da opo escolhida. Se chamada como caixa de
dilogo, retorna a expresso caracter digitada dentro
do campo e, para qualquer outro tipo de chamada,
retorna 1.
DDMM( <ExpC> )
Executa a validao da data dia/ms no formatos dd/
mm ou ddmm, contida em ExpC. Esta funo
assume datas (tipo caracter) em branco como vlidas.
Exemplo
@ 23,1 GET data VALID DDMM(data)
Nseg/Menu N/L
Se for parmetro do tipo numrico, aguarda a quantidade de segun-
dos especificada (Se 0, aguarda usurio pressionar uma tecla); caso
seja do tipo lgico, no importando o seu valor, ser apresentado
um menu cujas opes sero as linhas de Msg que foram separa-
das com |
Apaga L
Se .T., aps terminado o dilogo, a janela desaparecer da tela,
caso contrrio (.F.), a janela permanecer. Se no informado, a
funo assumir o valor .T.
Tit C
a mensagem que aparecer no ttulo da janela. Pode conter o car-
acter | para ocasionar a quebra de linhas
Var C
a expresso default que aparecer dentro do campo a ser digi-
tado. Caso este parmetro seja informado, a funo apresentar a
caixa de dilogo
Msc C a mscara a ser utilizada para receber o campo a ser digitado
P N
o nmero da opo que aparece selecionada, quando se tratar de
menu (default)
EC C O esquema de cor a ser utilizado na apresentao da janela
Parmetro Tipo Descrio
Manual do Usuri o
491
DDMMAA( <ExpC> )
Retorna .T. lgico se a data em ExpC for vlida. A
data especificada em ExpC poder conter as barras
de separao (formato 99/99/99 com 8 posies) ou
no (formato 999999 com 6 posies).
Exemplo
@ 23,1 GET data VALID DDMMAA(data)
Esta funo assume datas (tipo caracter) em branco
como vlidas.
DECRIPT( <Frasecript> [,senha] )
Descriptografa a expresso em Frasecript usando o
argumento opcional senha como chave. Trabalha em
conjunto com a funo ENCRIPT( ), explicada neste
captulo.
Exemplo
Var=DECRIPT(varcript,"1234")
A descriptografao de uma expresso utilizando esta
funo s ter sucesso se for utilizada a mesma
senha utilizada quando da criptografao pela
funo ENCRIPT( ).
DLAPSO( <E1> [,C2] )
Retorna uma string correspondendo ao lapso de tempo
contido em E1, no formato xx anos, yy meses e zz
dias. Se for passado somente o primeiro parmetro
E1" e, se for numrico, ser assumido como se fosse o
nmero de dias. Se passada C2, ambos os parmetros
sero tratados como sendo datas (tipo C ou D), e a
funo operar com a diferena entre elas. Se as datas
forem do tipo C, poder ter os tamanhos de 6 ou 8
(ambos manipulados pelo GAS-Pro).
Manual do Usuri o
492
Exemplos
? DLAPSO(01/01/89",01/02/90")
// 1 ano e 1 mes
? DLAPSO(010189",010290")
// 1 ano e 1 mes
? DLAPSO(d_hoje-d_aniv)
// 10 anos, 2 meses e 9 dias
? DLAPSO(d_hoje,d_aniv)
// 10 anos, 2 meses e 9 dias
? DLAPSO(365)
// 1 ano
? DLAPSO(200)
// 6 meses e 17 dias
? DLAPSO(366)
// 1 ano e 1 dia
Esta funo no deve ser usada se o clculo retornado
necessitar de muita preciso pois, por aceitar tambm
parmetros numricos ou trabalhar com a diferena
absoluta em dias entre datas, poder ocorrer pequenas
diferenas no caso de anos bissextos, quando o ms de
fevereiro estiver intercalado entre as mesmas.
DOSDATA(<data>)
Acerta a data interna do DOS segundo o argumento
data, que deve ter o formato de 8 bytes (dd/mm/aa).
Exemplo
DOSDATA(07/12/92")
Manual do Usuri o
493
DRIVES( )
Essa funo, que no tem argumentos, retorna uma
string contendo as letras dos drives disponveis no
equipamento, inclusive os diretrios substitudos pelo
comando SUBST do DOS.
Exemplo
dr=DRIVES( )
? dr // resultado: ABCFGWXZ
EDBF( <Arq[.Ext]> [,ExpL] )
Protege, desprotege ou simplesmente informa se o
arquivo contido em Arq (com extenso Ext) pode
ser acessado no modo interativo pelo dBASE. Se
ExpL for passado .F., o arquivo ser protegido, se .T.
ser desprotegido. Se no passado este parmetro, a
funo retorna o status (.T. ou .F.).
Para proteger o arquivo, esta funo criptografa o
header do arquivo DBF e muda o seu atributo para
read-only. Ao desproteger, volta situao original.
Exemplo
EDBF(salarios,.f.)
// protege o arquivo SALARIOS.DBF
? EDBF(salarios)
// resultado = .f.
EDIMEMO( <Var>, <Tit>, <Ls>, <Cs>, <Li>, <Ci> )
Abre janela com ttulo Tit nas coordenadas Ls,
Cs, Li e Ci para a edio atravs da funo
MEMOEDIT( ) do campo ou varivel contida em
Var. Esta funo permite a acentuao direta pelo
usurio, durante a edio, digitando o acento e, logo
Manual do Usuri o
494
em seguida, a vogal a ser acentuada. O pode ser
obtido digitando-se a , e o C em seguida.
Exemplo
REPLACE obs WITH;
EDIMEMO(var,"Observao",1,1,10,79)
Abre janela com ttulo Observao nas coordenadas
1,1,10,79 com preenchimento obrigatrio. O resultado
da edio ser colocado no campo obs.
ENCRIPT( <Frase> [,senha] )
Criptografa a expresso em Frase usando o
argumento opcional senha como chave. Trabalha em
conjunto com a funo DECRIPT( ), explicada neste
captulo.
Exemplo
Var=ENCRIPT(Mensagem a esconder,"1234")
ERROMSG( <ClasseErro> )
Manipula os erros de execuo runtime das
aplicaes geradas pelo GAS-Pro. Recebe o
argumento ClasseErro atravs da ERRORSYS( ),
dando uma srie de alternativas ao usurio, como por
exemplo, as provveis causas, possveis solues,
programa e linha onde ocorreu o erro, etc.
EXT(<Valor> [,Larg] [,ExpN] [,Sing] [,Plur])
Retorna o valor por extenso com frase em portugus
correspondente a Valor separadas por hfen, em linha
de tamanho igual a Larg. Se Larg no for
especificado, ser considerado 80. Se Larg for
menor que 50 ou maior que 80, a frase ser retornada
sem separao por hfen, em uma s linha. Se ExpN
Manual do Usuri o
495
for especificada, a frase no conter o nome da moeda
(podendo ser acrescentado habitantes, peas, etc.
ao final da frase). Os argumentos opcionais Sing e
Plur, se passados, sero assumidos com nome da
moeda circulante, no singular e plural,
respectivamente.
Exemplos
extenso=EXT(12345678.99,56)
@ 1,1 SAY LEFT(extenso,56)
@ 2,1 SAY SUBS(extenso,56+1,56)
@ 3,1 SAY RIGHT(extenso,56)
RESULTADO:
Doze Milhes Trezentos e Quarenta e Cinco Mil
Seiscentos e Setenta e Oito Reais e Noventa e
Nove Centavos///
? EXT(12345,0,0) + Habitantes
Doze Mil Trezentos e Quarenta e Cinco
Habitantes
? EXT(123,0,0,"Cruzado","Cruzados")
Cento e Vinte e Trs Reais
Note que, dependendo dos valores dos argumentos, a
frase poder ocupar uma, duas ou at trs linhas - a
separao silbica estar sempre posicionada em
relao ao tamanho especificado, de modo que se
possa separar as linhas e imprimi-las onde desejado,
conforme no exemplo acima, utilizando as funes
LEFT( ), SUBSTR( ), etc.
O nome da moeda pode ser trocado diretamente dentro
dos arquivos GASPRO51.LIB e GASPRO52.LIB,
Manual do Usuri o
496
caso seja necessrio, a partir do menu do GAS-Pro,
selecionando-se Utilitrios e Nome da Moeda.
FONETICA(<ExpC>)
Retorna cdigo fontico de uma palavra ou frase. Esta
funo semelhante funo SOUNDEX( ) do CA-
Clipper porm, aceita a fontica da lngua portuguesa
e retorna uma string de 8 dgitos representando o
cdigo fontico do argumento passado.
Exemplo
USE clientes
INDEX ON FONETICA(nome) TO CLIENTES
SEEK FONETICA(HOTEL)
? FOUND( ) // retorna .T.
SEEK FONETICA(XAVIER)
Agora, as mesmas pesquisas com argumentos errados:
SEEK FONETICA(OTEL)
SEEK FONETICA(CHAVIER)
Esta funo no case sensitive, isto , trata
maisculas como se fosse minsculas, e vice-versa.
GDV1( <ExpC> )
Retorna o dgito verificador (DV de 1 dgito), de
mdulo 11, da expresso ExpC.
Manual do Usuri o
497
Exemplo
num = 1
DO WHILE num <= 1000
? STR(num) + - + GDV1(STR(num))
num = num + 1
ENDDO
A rotina acima gera a tabela de DV para os nmeros de
1 a 1000.
GDV2( <ExpC> )
Semelhante funo anterior, porm retorna os DV
(dois dgitos), de mdulo 11, de ExpC.
GRELA( <ExpN>)
Grava parmetros de relatrio que ativado, a partir
do menu da aplicao, atravs da opo de nmero
ExpN. Esta funo conjugada com a opo
LRELA(), a ser explicada mais adiante.
GETSYS
Esta funo a mesma GETSYS fornecida juntamente
com o CA-Clipper. Est aqui mencionada porque a
verso da GETSYS utilizada nas bibliotecas do GAS-
Pro est bastante modificada para a implementao
dos recursos de suporte a mouse, ajuda ativa na
aplicao final, etc. O seu programa fonte
GETSYS.PRG, com todas as modificaes feitas, est
sendo enviado no CD do GAS-Pro.
Manual do Usuri o
498
IDATA( <ExpC>)
Inverte a data ExpC para ser utilizada em pesquisas,
indexaes e comparaes. Suporta os formatos DD/
MM/AA, DDMMAA, DD/MM, DDMM, MM/AA ou
MMAA.
Exemplo
? IDATA("01/09/96") // retorna 96/09/01
? IDATA("010996") // retorna 960901
IMGEXTRAI( <ExpC1> <,ExpC2> <,ExpC3> )
Extrai uma imagem contida na posio (offset)
ExpC3 do arquivo .DBI de nome ExpC2 e grava
um arquivo .PCX de nome ExpC1.
IMGGRAVA( <ExpC1> <,ExpC2> )
Carrega um arquivo .PCX de nome ExpC2 e o
apenda ao final do arquivo de extenso .DBI de nome
ExpC1.
IMGPACK( <ExpC> )
Compacta (pack) um arquivo de imagens (.DBI) de
nome ExpC. O arquivo DBF a ele associado dever
estar aberto em modo exclusivo, para que esta funo
seja chamada. Durante o processo de compactao, as
imagens que no estejam vinculadas a registros do
arquivo DBF correspondente sero descartadas.
IMPAC(<frase> [,Lin] [,Col] [,Just] )
Converte todos os caracteres acentuados extendidos
(cdigo ASCII maior que 127) de frase para os seus
correspondentes no acentuados, seguidos de um
comando de retrocesso do carro da impressora e do
Manual do Usuri o
499
acento correspondente. Algumas impressoras no tm
a capacidade de imprimir os caracteres extendidos (ou
no esto ajustadas para isso), e esta funo permite
que esses caracteres sejam descartados e convertidos
em acentuao lgica, que toda impressora com
capacidade de retrocesso aceita.
Se passados os parmetros de linha e coluna (Lin,
Col), essa funo executa a impresso nas
coordenadas, caso contrrio, retorna a string
convertida.
O parmetro Just, se passado como .T., a impresso ou
o retorno da string ser feita justificada (alinhada) no
seu tamanho.
Exemplo
? IMPAC(Criana)
Crianc.,a //onde est o ponto
//enviado um retrocesso
? IMPAC(GAS Informtica Ltda,.T.)
GAS Informa.'tica Ltda
IMPGRANDE( <Msg> <,Lin> <,Col> [,Alinha] [,Larg]
[,Cor])
Esta funo permite a impresso de mensagens em
destaque nas telas da aplicao. As letras utilizadas
tm um tamanho de 3 linhas por 3 colunas, sendo til
por exemplo, para aplicaes tipo PDV onde nas quais
o cliente deseja ver valores na tela (por exemplo, valor
de compras). Os parmetros utilizados so:
Msg - a mensagem que deve ser impressa. Este
parmetro deve ser utilido com cuidado, pois existe
uma certa limitao no seu tamanho. Para ser
impresso na tela inteira, o mximo de caracteres
seria 20;
Manual do Usuri o
500
Lin - a linha inicial do canto superior esquerdo
onde ser mos trada a mensagem;
Col - a coluna inicial do canto superior esquerdo
onde ser mostrada a mensagem;
Alinha - se true, o texto ser alinhado direita
(ideal para valores numricos). Deve ser conjugado
com o parmetro a seguir;
Largura - a largura a ser utilizada para o ajuste do
valor, caso o parmetro anterior Alinha seja true.
Cor - o esquema de cor a ser utilizado na
impresso dos caracteres. Se no passada, o atributo
da tela ser utilizado.
Exemplo
IMPGRANDE(TRAN(123.45,@E 99.999,99), 4, 4, ,
, GR+/B)
Para imprimir dentro da tela definida para aplicao,
utilize as como ponto de partida de clculo de
posies, as variveis l_s e c_s que correspondem ao
canto superior esquerdo da tela do mdulo em
definio.
IMPOK(<Porta>)
Checa se a porta paralela nmero ExpN da
impressora est pronta para receber informaes.
Retorna .T. se estiver pronta.
Exemplo
IF ! IMPOK(1)
Manual do Usuri o
501
?? Impressora no est pronta!
ENDIF
INVCOR(<EsqCor>)
Inverte o esquema de cor especificado por EsqCor.
Exemplo
? INVCOR(W+/BG)
BG/W //o + no funciona em fundo
LEMANU(<Arq>, <Codajuda>)
Abre o arquivo Arq e apresenta uma janela contendo
o bloco de texto correspondente a Codajuda, como
ajuda de operao ao usurio da aplicao. O arquivo
texto Arq precisa estar previamente preparado
atravs da opo Prepara ajuda do menu de
utilitrios do GAS-Pro.
LPAD( <ExpC|ExpN> [,ExpN1] [,CHR] )
Retorna uma expresso caracter com o argumento
ExpC|ExpN com ExpN1" caracteres CHR
esquerda, forando um tamanho igual a ExpN1. Se o
argumento CHR no for especificado, sero
assumidos espaos, e se ExpN1 no for especificada,
ser assumido o tamanho em caracteres de ExpC ou
o tamanho de STR(ExpN) se o argumento for
numrico. A diferena entre esta funo e a PADL( ) do
CA-Clipper que a funo LPAD( ) retira brancos
esquerda e direita do argumento antes de colocar o
caracter de enchimento, alm de considerar como
default de tamanho, o prprio tamanho do argumento.
Tambm nesta funo LPAD( ) o primeiro argumento
poder ser do tipo numrico ou caracter.
Essa funo muito til para a colocao de zeros
esquerda de variveis, ou para alinhamento direita de
variveis do tipo caracter (strings).
Manual do Usuri o
502
Exemplos
? LPAD(1",5,0")
00001
? LPAD(1",5)
1
var=">> ? LPAD(var,=")
======>>
LRELA( <ExpN1><,ExpN2><,ExpN3> )
L parmetros do relatrio da opo de menu nmero
ExpN3 gravados atravs da funo GRELA( ) vista
anteriormente neste captulo. As expresses ExpN1
e ExpN2 correspondem s coordenadas (linha,
coluna) onde o menu contendo todos os relatrios
gravados aparecer.
LTOC( <ExpL> )
Converte o argumento lgico para caracter. O
parmetro ExpL a expresso lgica a ser
convertida.
Exemplo
? LTOC(.T.) // retorna T
MAIUSC( <ExpC> )
Transforma a expresso caracter contida em ExpC
para maisculas. Esta funo funciona como se fosse a
funo UPPER( ) do CA-Clipper, porm, aceita letras
acentuadas e cedilha, transformando-as para os seus
Manual do Usuri o
503
correspondentes maisculos, quando estes existirem na
tabela ASCII.
Exemplo
MAIUSC(Corao) // resulta CORAO
MKDIR( <nomedir> )
Tenta criar o diretrio de nome nomedir no disco
especificado. Retorna .T. se a operao teve sucesso.
Exemplo
IF ! MKDIR(C:\FOLHA)
? Erro ao criar diretorio
ENDIF
MMAA( <ExpC> )
Idntica funo DDMM( ), para datas do tipo
caracter, com os formatos mm/aa e mmaa.
MOUSE( )
Esta funo inicializa a comunicao com o driver de
mouse instalado na memria, ajustando-o para os seus
parmetros default (cursor no visvel, posio do
cursor centralizada, rea de ao na tela inteira, etc.).
Se o driver estiver presente, retorna o nmero de
botes do mouse; caso no esteja instalado, retorna 0.
Ateno para o fato de que esta funo no exibe
automaticamente o cursor do mouse (ver os default
acima), significando que a funo MOUSECUR( ) tem
de ser chamada para exib-lo.
Exemplo
Manual do Usuri o
504
Nbot=MOUSE( )
IF Nbot>0
? MOUSE instalado. Nmero de botes:+;
LTRIM(STR(Nbot))
MOUSECUR(.t.) // exibe o cursor do mouse
ELSE
? Mouse no instalado!
ENDIF
MOUSEBOX( <L1> <,C1> <,L2> <,C2> )
Esta funo serve para definir uma rea retangular na
tela para delimitar a ao do cursor do mouse. Os
parmetros L1 e C1 definem respectivamente a linha e
coluna do canto superior esquerdo do retngulo,
enquanto L2 e C2 definem linha e coluna do canto
inferior direito. Os parmetros de linha devem estar na
faixa de 0 a 24 e os de coluna entre 0 e 79.
Exemplo
MOUSEBOX(10,10,20,70)
// define retngulo de ao
MOUSECUR( <ExpL> )
Se ExpL for verdadeira (.T.), o cursor do mouse
exibido, caso contrrio (.F.), o cursor desaparecer.
Deve-se ter o cuidado de apagar o cursor do mouse
antes de usar qualquer comando ou funo do CA-
Clipper que escreva na tela do micro como @ SAY,
SCROLL( ), BOX( ), @ GET, etc. Logo aps, deve-se
exib-lo novamente com a mesma funo, com
parmetro igual a .T. Esta providncia evita que o
cursor do mouse seja sobrescrito causando efeitos
estticos indesejveis.
Exemplo
Manual do Usuri o
505
MOUSECUR(.f.)
// esconde o cursor do mouse
@ 0,0 CLEA
// limpa a tela a partir de 0,0
MOUSECUR(.t.)
// exibe o cursor do mouse
MOUSEDN( <botao> <,L> <,C>)
Coloca nos parmetros <L> e <C> (linha e coluna) as
coordenadas do mouse da ltima vez em que botao
foi pressionado. Retorna .T. se <botao> ainda est
pressionado, .F. se no.
Valores possveis para botao:
0 = boto da esquerda
1 = boto da direita
IMPORTANTE!
Os parmetros <L> e <C> devem ser passados como
referncia (pointer), ou seja, devero ser precedidos do
caracter @.
Exemplo
Linha:= Coluna :=0
Press = MOUSEDN(0, @Linha, @Coluna)
/*
as variveis linha e coluna recebero os valores
das coordenadas da posio do mouse no momento em
que o boto esquerdo for pressionado, mesmo que o
mouse tenha sido movimentado e o boto continue
pressionado. A varivel lgica Press conter .T. se o
boto ainda estiver pressionado.
*/
Manual do Usuri o
506
MOUSEGET( <L> <,C> )
Coloca nos parmetros <L> e <C> (linha/coluna) as
coordenadas atuais do mouse. A tabela a seguir mostra
os valores retornados de acordo com a combinao de
botes do mouse que foram pressionados.
IMPORTANTE!
referncia (pointer), ou seja, devero ser precedidos do
caracter @.
Exemplo
x=MOUSEGET(@Linha, @Coluna)
// x assume os valores da tabela acima
MOUSERAT( <Sh> <,Sv> )
Ajusta a sensibilidade do mouse, horizontal e
verticalmente (Sh/Sv) em mickeys (1/200 polegada).
Os valores default so 8 para horizontal e 16 para
vertical.
8
Valor Boto pressionado
1 esquerdo
2 direito
3 esquerdo e direito
4 meio
5 esquerdo e meio
6 direito e meio
7 todos os botes
Manual do Usuri o
507
Exemplo
MOUSERAT(1,2)
// diminui a velocidade de ao do mouse
MOUSESET( <L> <,C> )
Posiciona o cursor do mouse na linha L e coluna C
do vdeo.
Exemplo
MOUSESET(10,20)
// coloca o cursor em linha 10, coluna 20
MOUSEUP( <botao> <,L> <,C>)
Coloca nos parmetros <L> e <C> (linha e coluna) as
coordenadas do mouse da ltima vez em que <botao>
foi liberado. Retorna .T. se <botao> ainda est
liberado, .F. se no.
Valores possveis para <botao>:
0 = boto da esquerda
1 = boto da direita
IMPORTANTE!
referncia (pointer) ou seja, devero ser precedidos do
caracter @.
Exemplo
Linha:=Coluna:=0
naopress=MOUSEUP(0, @Linha, @Coluna)
Manual do Usuri o
508
As variveis linha e coluna recebero os valores
das coordenadas da posio do mouse no momento em
que o boto esquerdo for liberado. A varivel lgica
naopress conter .T. se o boto ainda estiver
liberado.
MTAB( <Msg|Amsg> [,Tit] [,Lin] [,Col] )
Monta um menu do tipo pick, nas coordenadas Lin,
Col, com as opes contidas em Var separadas
pelo caracter | (pode tambm ser passado um arranjo
de opes), retornando as letras iniciais da opo
selecionada (quantidade de letras igual ao tamanho do
campo). Se desejado, esta funo pode ser montada
automaticamente pelo GAS-Pro, sendo muito til para
oferecer opes ao usurio da aplicao, na entrada de
informaes de pequenas tabelas.
Exemplo
cp=SPACE(2)
@ 2,1 GET cp WHEN;
MTAB (ME=mensalista | DI=diarista,"M.OBRA")
/*
as letras ME ou DI so colocadas
automaticamente no campo cp dependendo do que
for selecionado (duas letras so capturadas, pois cp
tem tamanho igual a 2)
*/
MUDA_PJ( <LSup> <,CSup> <,LInf> <,CInf>
<,Vartela> <,Borda> )
Permite a mudana da posio da janela, menu, ou
caixa de dilogo com cantos nas coordenadas LSup,
CSup, LInf e CInf. A varivel Vartela usada
para salvar a tela por baixo da janela. O parmetro
Manual do Usuri o
509
Borda pode ser passado .T. ou .F. para indicar se a
janela ter ou no bordas.
Os argumentos das coordenadas tm que ser passados a
essa funo por referncia, ou seja precedidos do
caracter @ (pointer), para que as novas coordenadas
escolhidas sejam vistas no programa chamador.
Exemplo
Lin1=10
Col1=15
Lin2=20
Col2=40
stela=SAVESCREEN(0,0,24,79)
CAIXA(moldura, Lin1, Col1, Lin2, Col2)
MUDA_PJ(@Lin1,@Col1,@Lin2,@Col2,stela)
? Lin1, Col1, Lin2, Col2
MUDAFONTE(<ExpN>)
Carrega fonte de caracteres 8x16 para serem mostrados
em monitores de vdeo do tipo VGA/SVGA, em
substituio aos caracteres normais. A varivel
ExpN contm o nmero da opo de fonte escolhida.
Esta funo utilizada para permitir que a aplicao
final, quando executando em micros providos de
monitores VGA, possam utilizar diversas fontes de
caracteres, contidas no arquivo VGALIB.FTS que
fornecido no CD do GAS-Pro.
Se, para ExpN for passado o valor 999, ento esta
funo retornar uma string contendo os nomes das
fontes de caracteres existentes no arquivo
VGALIB.FTS, separados por | (para montar menu).
Se a aplicao estiver sendo executada em modo de 50
linhas ou se o utilitrio VIDRAM do QEMM estiver
sendo utilizado na memria de vdeo, as fontes de
caracteres no sero mostradas.
Manual do Usuri o
510
NAOPISCA( )
Esta funo serve para resetar o atributo piscante em
vdeos padro EGA ou VGA para permitir o acesso a
256 cores para configurao. Essa funo retorna NIL.
NARQ( <Nomearq> )
Retorna .T. se o nome de arquivo contido em
Nomearq vlido, segundo as especificaes do MS-
DOS.
Exemplo
@ 20,1 GET arquivo VALID NARQ(arquivo)
NMES( <ExpN | ExpD> )
Retorna o nome do ms referente a ExpN, cujo valor
deve variar entre 1 e 12. Esta funo poder receber
tambm uma data (ExpD) como parmetro.
Exemplos
? NMES(12)
Dezembro
dt=CTOD(07/12/95")
mes=NMES(dt)
? mes
Dezembro
NSEM( <ExpN | ExpD> )
Retorna o nome do dia da semana referente a ExpN,
cujo valor deve variar entre 1 e 7. Esta funo poder
receber tambm uma data (ExpD) como parmetro.
Manual do Usuri o
511
Exemplos
? NSEM(1)
Domingo
? NSEM(CTOD(03/06/95"))
Sabado
PARALELA( <NPorta> )
Esta funo serve para testar uma porta paralela,
retornando .T. se estiver ativa. O argumento NPorta
1 para LPT1, 2 para LPT2, etc.
Exemplo
IF PARALELA(1)
? LPT1 ativa
ELSE
? LPT1 no est ativa
ENDI
PARSE( <Frase> [,Caracter] )
Extrai palavras contidas na expresso Frase,
delimitadas pelo caracter Caracter. Se Caracter
no for especificado, a vrgula ser assumida. Para que
funcione apropriadamente extraindo vrias palavras,
deve ser colocada dentro de um loop e a varivel que
contm a expresso alvo deve ser passada com o
caracter @ na frente (pointer).
Exemplo
frase="Jos+Maria+Antonio+Joo"
DO WHILE LEN(frase) > 0
nome = PARSE(@frase,"+")
Manual do Usuri o
512
? nome
ENDDO
Resultado:
Jos
Maria
Antonio
Joo
PCOND( <Cond>, <Arq> [,Par] )
Esta funo executa a pesquisa seqencial de uma
condio dentro de um arquivo. Por ser seqencial,
deve ser usada em arquivos que no contenham uma
quantidade muito grande de registros. muito til
quando precisamos pesquisar, por exemplo, se um
salrio est dentro de uma faixa, etc.
Cond contm a condio chave a ser pesquisada no arquivo
especificado;
Arq contm o nome do arquivo de dados a ser pesquisado, e
Par de qualquer tipo, se passado, fora que a pesquisa seja
feita a partir do registro subseqente ao atual
(semelhante ao comando CONTINUE do CA-Clipper).
Exemplo
PCOND(salario >= lim1 .AND.;
salario <= lim2", TABELA)
@ 10,1 SAY TABELA->aliquota
PEEK( <seg> <,pos> )
Pega contedo da memria na posio pos, do
segmento seg. Esta funo recebe dois parmetros
correspondentes ao endereo na forma
Manual do Usuri o
513
segmento:posio e retorna o contedo deste
endereo. Os argumentos podem ser passados na forma
inteira (decimal) ou hexadecimal (na forma de string).
Ambos tm que estar na mesma forma.
Exemplo
x=PEEK(B800",00")
// l o caracter da 1a. posiao do video
O exemplo a seguir, que consta dos programas fontes
do GAS-Pro, utiliza a funo PEEK( ) alm de outras,
para captar o nome completo do programa em
execuo a partir do PSP (Program Segment Prefix)
que o DOS coloca em cada programa executvel, no
momento em que o carrega na memria.
/*
rotina utilizando funcoes assembly para pegar o nome
do programa que colocado pelo DOS no PSP
(Prefixo de Segmento do Programa) do programa que
est sendo executado. O segmento do ambiente
apontado pelos endereos 44 e 45 do PSP
*/
VAL_AX(6200") // funcao 62h retorna seg do PSP
em BX
CALLINT(21") // executa interrupt 21h do DOS
x=VAL_BX( ) // pega o segmento do PSP
Sg=PEEK(x,44)+PEEK(x,45)*256
// calcula endereo do seg de ambiente
/*
Agora, procura no segmento de ambiente, por dois
ZEROs seguidos. O nome do programa comea 2
bytes aps os ZEROs
*/
Manual do Usuri o
514
x=0
DO WHIL .t.
IF PEEK(Sg,x)=0 // este o primeiro ZERO
IF PEEK(Sg,x+1)=0// se o prximo for 0
x+=2// ento pula ambos
EXIT// e sai
ENDIF
ENDIF
x++// continua procurando
ENDDO
Exe=""
IF PEEK(Sg,x)=1// se byte = 1, ento
x+=2// nome vai daqui
DO WHIL PEEK(Sg,x)>0 // at prximo 0
exe+=CHR(PEEK(Sg,x))// pega + uma letra do
x++// nome e etc...
ENDDO
ENDI
Exe=UPPER(Exe)// captaliza nome/path do programa
PODE_ABA( )
Esta funo avalia a condio estabelecida para
abandono de alterao de um subsistema, retornando
.T. (true) se a condio foi atendida, .F. (false) se
no.
POKE( <seg> <,pos> <,valor> )
Coloca o valor valor na memria, na posio pos,
segmento seg. Esta funo recebe trs parmetros,
os dois primeiros correspondentes ao endereo na
Manual do Usuri o
515
forma segmento:posio, e o ltimo o valor que se
deseja colocar no endereo. Os argumentos podem ser
passados na forma inteira (decimal) ou hexadecimal
(na forma de string). Os trs tm que ser passados na
mesma forma.
Exemplo
POKE(B800",00","41") // poe um A na 1a.
//posio do vdeo
// POKE(B800",01","1F") e
// poe atributo branco
// sobre azul.
IMPORTANTE!
A utilizao desta funo s recomendada para
imprevisveis podero ocorrer se for utilizada
inadequadamente.
PWORD( [ExpC] [,Lin], [,Col] )
Recebe 6 caracteres na posio Lin, Col e gera o
cdigo numrico hashing correspondente senha de
ExpC. Se Lin e Col no forem informados,
retorna apenas o cdigo gerado, para ser comparado
dentro do programa.
Exemplo
senha = PWORD(23,20)
// recebe senha na linha 23, coluna 20.
passw = PWORD(ABC)
// retorna o cdigo de ABC
Manual do Usuri o
516
QDRIVES( )
Retorna a quantidade de drives disponveis no
equipamento, inclusive os diretrios substitudos pelo
comando SUBST do DOS.
Exemplo
dr=QDRIVES( ) ? dr // resultado: 8
QUALDIR( [LetraDrive] )
Retorna o diretrio corrente. A diferena dessa funo
para a funo CURDIR( ) do CA-Clipper verso 5.2
que esta no retorna a letra do drive corrente.
Exemplo
dir=QUALDIR(C)
// retorna: C:\GASPRO
REPBLO( <Campo> <,Conteudo> )
Faz processamento (replace) em rede local, do campo
Campo com o contedo Conteudo, com tentativa
perene de bloqueio, atravs da funo BLOREG( ).
Aps o processamento, desbloqueia o registro e
retorna para a rea e registro originais.
Exemplo
REPBLO(ESTOQUE->quant, quant+1)
RMDIR( <nomedir> )
Tenta remover o diretrio de nome nomedir do disco
especificado. Retorna .T. se a operao teve sucesso.
Manual do Usuri o
517
Exemplo
IF ! RMDIR(C:\FOLHA)
? Erro ao remover diretrio/Diretrio ;
+"inexistente"
ENDIF
RONLY( <NomeArq> )
Protege o arquivo NomeArq contra gravao,
trocando o seu atributo para R/O (somente leitura), e
retorna .T. se teve sucesso.
Exemplo
? RONLY(EMPRE.SYS)
// .T. se conseguiu proteger
RWRITE( <NomeArq> )
Desprotege o arquivo NomeArq trocando o seu
atributo para R/W (gravao e leitura), e retorna .T. se
teve sucesso.
Exemplo
? RWRITE(EMPRE.SYS)
// .T. se conseguiu desproteger
SEPLETRA( <ExpC>, [,NumEsp] )
Retorna ExpC separadas, caracter a caracter por
NumEsp espaos. Se NumEsp no for informado,
ser assumido 1.
Exemplo
? SEPLETRA(GAS,2) // retorna: G A S
Manual do Usuri o
518
SERIAL( <ExpN> )
Verifica se a porta serial de nmero ExpN,
retornando .T. se esta estiver ativa. O argumento
ExpN 1 para COM1, 2 para COM2, etc...
Exemplo
IF SERIAL(1)
? COM1 existente e ativa
ENDIF
SETS( <Asets> )
Salva e restaura as configuraes globais da aplicao
(modificadas pelo comando SET do CA-Clipper).
Exemplo
Arr=SETS( )
// salva as configuraes no campo Arr SETS(Arr)
// restaura configuraes em Arr
SGRAFICO( [ExpN] )
Estabelece a interface entre a aplicao em CA-Clipper
e o SGR - Servidor Grfico Residente, programa que
cuida das apresentaes dos grficos nas aplicaes. O
parmetro ExpN comanda o tipo de ao que esta
funo desempenha:
Se ExpN for igual a 1 (default), esta funo apenas
verifica e retorna .T. se o SGR estiver residente na
memria. Se ExpN tiver o valor 2, esta funo fora
o pop-up daquele utilitrio para a apresentao dos
grficos.
Exemplo
Manual do Usuri o
519
IF SGRAFICO() // SGR est residente na memria?
SGRAFICO(2)
ELSE
? SGR no est residente na memria
ENDIF
STRING( <seg> <,pos> )
Esta funo retorna uma string armazenada em um
endereo de memria especificado pelos parmetros
seg (segmento) e pos (posio).
Exemplo
nome="MICROCOMPUTADOR"
offs=STRPTR(@nome)
// retorna o endereco de nome
segm=STRSEG(@nome)
// retorna o segmento do nome
? STRING(segm,offs)
// imprime MICROCOMPUTADOR
STRPTR( <@varstring> )
Esta funo retorna o endereo onde est armazenada
varstring na memria. O argumento deve ser passado
com o caracter @ prefixando o nome da varivel
(pointer). Esta funo deve ser utilizada em conjunto
com a funo STRSEG( ), que retorna o segmento do
endereo da varivel string.
Esta funo, juntamente com a STRSEG( ) serve para
passar endereos na forma segmento:posio de
strings e localizao de buffers para outras funes de
baixo nvel, quando requeridos.
Manual do Usuri o
520
Exemplo
offs=STRPTR(@nome)
segm=STRSEG(@nome)
STRSEG( <@varstring> )
Esta funo retorna um valor inteiro representando o
segmento do endereo onde est armazenada a varivel
varstring na memria. O argumento deve ser passado
com o caracter @ prefixando o nome da varivel
(pointer). Esta funo deve ser utilizada em conjunto
com a funo STRPTR( ), que retorna o endereo
(offset) da varivel string.
Esta funo, juntamente com a STRPTR( ) serve para
passar endereos na forma segmento:posio de
strings e localizao de buffers para outras funes de
baixo nvel, quando requeridos.
Exemplo
segm=STRSEG(@nome)
offs=STRPTR(@nome)
TAMDISCO( [LetraDrive] )
Retorna a capacidade total em bytes do disco
especificado pela letra LetraDrive. Se LetraDrive
for omitida ser assumido drive default.
Exemplo
? TAMDISCO(C) // retorna: 244338688
?
TRANSFORM(TAMDISCO(C),"999,999,999")+"
bytes"
Manual do Usuri o
521
// retorna: 244.338.688 bytes
TLAPSO(<E1> [,C2])
Retorna uma string correspondendo ao lapso de tempo
contido em exp1, no formato xx horas, xx minutos
e zz segundos". Se for passado somente o primeiro
parmetro E1 e, se for numrico, ser assumido
como se fosse o nmero de segundos aps as 00h. Se
passada C2, ambos os parmetros sero assumidos
como sendo strings (tipo C), no formato (hh:mm:ss),
e a funo opera com a diferena entre eles.
Exemplo
? TLAPSO(TIME( ))
// 1 hora, 1 minuto e 1 segundo
? TLAPSO(3600)
// 1 hora
? TLAPSO(10:00:00",12:01:01")
// 2 horas, 1 minuto e 1 segundo
? TLAPSO(12:10:00")
// 12 horas e 10 minutos
VAL_??( [<Exp>] )
Nesta funo, os dois caracteres ?? podem ser
substitudos pelas letras a seguir, correspondentes aos
registradores do micro:
AX, BX, CX, DX, DI, SI, DS, ES,
AH, AL, BH, BL, CH, CL, DH, DL
alm de:
CF e FLAGS
Esta funo serve para colocar um valor em um
registrador do micro (passado como parmetro), ou
Manual do Usuri o
522
para retornar o seu contedo (se nenhum parmetro for
passado). Os dois ltimos (CF e FLAGS) no podem
ser designados, podendo no entanto retornar os valores
abaixo:
VAL_CF( ) retorna um valor lgico dos status da
carry flag
VAL_FLAGS( )retorna um valor inteiro contendo as
flags
O argumento, quando existir, pode ser passado na
forma inteira (decimal) ou na forma hexadecimal
(string).
IMPORTANTE!
A utilizao destas funes s recomendada para
imprevisveis podero ocorrer se forem utilizadas
inadequadamente.
Exemplo
// rotina para captar espao livre em disco
drive=0 // 0=drive default, 1=A, 2=B, etc
VAL_DX(drive)// coloca drive em DX
VAL_AH(36")// funo 36h (espao livre)
CALLINT(21")// chama interrupt 21h do DOS
espaco=VAL_BX() * VAL_CX() * VAL_AX()
? Espaco disponvel:
?? TRANSFORM(espao,"@E 999,999,999 Kbytes")
VCGC( <ExpC> )
Valida o CGC (Nmero do Cadastro Geral do
Contribuinte) contido em ExpC.
Exemplo
Manual do Usuri o
523
@ 23,1 SAY CGC..: GET num ;
PICT @R 99.999.999/9999-99" VALID
VCGC(num)
VDV1( <ExpC> )
Valida o DV de ExpC, retornando .T. lgico se o DV
informado no ltimo caracter de ExpC for vlido. O
DV incorporado em ExpC tanto poder estar junto
(formato 999999") ou separado por hfen, barra ou
ponto (formato 9999/9").
Exemplo
num = SPACE(6)
@ 20,1 GET num PICTURE 9999-9" VALID
VDV1(num)
VDV2( <ExpC> )
Valida o DV (2 dgitos) de ExpC, retornando .T.
lgico se os DV informados (nos dois ltimos
caracteres de ExpC) forem corretos. Os dgitos
informados em ExpC podem tambm estar juntos ou
isolados por hfen, barra ou ponto (formatos 9999-99"
ou 999999").
Exemplo
cpf = SPACE(12)
@ 2,1 GET cpf PICT 999999999-99" VALID
VDV2(cpf)
VDVCB( <ExpC> )
Alguns cdigos de barras (EAN-8, EAN-13 e UPC-A)
possuem um dgito verificador (DV) com clculo
especial. Esta funo serve para fazer a sua validao.
Exemplo
Manual do Usuri o
524
codigo = SPACE(13) // cdigo EAN-13
@ 2,1 GET codigo PICT 9999999999999 VALID
VDVCB(codigo)
VHORA( <ExpC> )
Valida a hora nos formatos hh:mm:ss, hhmmss, hh:mm
e hhmm contida na expresso ExpC.
Exemplo
horamin=SPACE(5)
@ 1,1 GET horamin PICTURE 99:99";
VALID VHORA(horamin)
READ
VUF( <ExpC> )
Valida a UF (Unidade da Federao) informada em
ExpC segundo tabela de UF.
Exemplo
estado=SPACE(2)
@ 20,1 GET estado PICTURE !!
VALID VUF(estado)
Funes dos mdulos gerados
Alm das funes da biblioteca GASPRO5x.LIB e
GASP5xPM.LIB j documentadas, existem outras
residindo em outros mdulos da aplicao gerada
(XXX_FUNC.PRG e XXX_PROC.PRG) que
merecem certo destaque:
Manual do Usuri o
525
CRIT( <ExpC> <,Lin> [,Form] )
Efetua a avaliao da expresso contida em ExpC.
Se for falsa (.F.), mostra a mensagem tambm contida
em ExpC em uma janela centralizada, com canto
superior esquerdo na altura da linha especificada por
Lin. O parmetro Form opcional e contm os
nmeros das frmulas a serem mostradas na tela, no
seguinte formato: nn| nn|nn| ..., onde nn
corresponde aos nmeros das frmulas especificadas
no vetor sistema, que definido no mdulo
XXX_ATRI.PRG da aplicao.
A expresso de validao e a mensagem a ser mostrada
esto contidas em ExpC, separadas pelo caracter
~.
Exemplo
@ 10,10 SAY Informe a DATA: ;
GET data PICT @R 99/99/99";
VALID CRIT (DDMMAA (data) ~Data
ilegal,12,"01|02")
O exemplo acima valida a entrada da data (tipo
caracter) e mostra na tela as frmulas 1 e 2 definidas
no vetor sistema, em suas posies correspondentes.
ERRORSYS( )
Criada apenas para que o CA-Clipper d preferncia
para a rotina de manipulao de erros do GAS-Pro,
essa funo tem a finalidade apenas de fazer a
chamada funo ERROMSG( ) que existe na
biblioteca de funes do GAS-Pro.
PTAB( <Chave> <,Arqdad> [,Ordem] [,FixaOrdem] )
Executa pesquisa indexada no arquivo Arqdad,
atravs da chave especificada em Chave, usando o
ndice de ordem Ordem associado ao arquivo
Arqdad. Se Ordem no for especificado, ser
Manual do Usuri o
526
usado o valor 1. Esta funo utiliza a funo
USEARQ() a seguir para abrir o arquivo de dados. Se
FixaOrdem for .T., esta funo, ao retornar, deixar
o arquivo pesquisado ligado ao ndice especificado por
Ordem. Se omitido ou passado .F., o arquivo ser
religado ao ndice em que se encontrava antes da
pesquisa.
Exemplo
@ 23,20 GET chvpesq VALI
PTAB(chvpesq,"UFTAB",2)
chvpesq ser aceito somente se existir no
arquivo UFTAB.
a = PTAB(var1,cliente)
Aps a utilizao dessa funo, o arquivo pesquisado
deixado ABERTO, para facilitar e agilizar as eventuais
pesquisas que podero ocorrer.
Esta funo retorna .F. se o registro encontrado estiver
marcado para ser apagado.
USEARQ( <Arqdad> [,Excl] [,Nvezes], [,Nseg]
[,ComNtx] )
Esta funo abre o arquivo de dados Arqdad e todos
os ndices que estiverem a ele associados. Se
ComNtx for omitido ou passado .T., esta funo abre
os ndices associados. Se o parmetro Excl for
passado como .T., o arquivo ser aberto em modo
exclusivo. Nvezes indica o nmero de vezes que ser
tentada a abertura. Se passado 0, tenta para sempre.
Finalmente, Nseg determina o tempo em segundos
entre uma tentativa e outra.
No caso do arquivo Arqdad ser um arquivo externo
aplicao, isto , no especificado no vetor sistema
(ver programa fonte XXX_ATRI.PRG da aplicao),
esta funo tentar abrir o ndice a ele associado no
formato do GAS-Pro, ou seja XXX1.NTX. Caso no
Manual do Usuri o
527
seja encontrado esse ndice, a funo assumir um
nome idntico a Arqdad.
Exemplo
? USEARQ(MATERIAL,.t.)
// retorna .T. se conseguiu
Os mdulos gerados pelo GAS-Pro
Por utilizar a programao modular, o GAS-Pro
quebra as tarefas a serem executadas em diversos
subprogramas e funes para compor a aplicao
gerada. Assumindo-se que o nome escolhido para a
aplicao seja CADASTRO, e que esta aplicao
manipule somente um arquivo de nome CLIENTE,
as funes desempenhadas pelos mdulos fontes
gerados, so:
CADASTRO.PRG
Este o mdulo gerenciador geral da aplicao e tem o
mesmo nome do projeto. Este mdulo, entre outras
coisas, cria e inicia variveis pblicas necessrias, cria
arquivo de senha, se necessrio, e monta o menu geral
da aplicao para receber as opes do usurio.
CAD_ATR[n].PRG
Este mdulo serve para definir o vetor sistema
contendo todos os atributos das entidades da aplicao.
No vetor sistema esto praticamente todas as
definies que dizem respeito a arquivos de dados,
como campos, validaes, frmulas, processamentos,
lanamentos, etc. Dependendo das dimenses do
projeto, mais de um mdulo desses pode ser gerado. O
primeiro deles sempre denominado
CAD_ATRI.PRG e, caso sejam necessrios outros, o
Manual do Usuri o
528
GAS-Pro substituir o I final do nome por um
nmero sequencial que vai de 1 a 9.
CAD_ESTR
Este mdulo contm o cdigo para criar estruturas
vazias de todos os arquivos de dados manipulados pela
aplicao. chamado somente quando os arquivos de
dados no existirem, no momento em que a aplicao
executada pela primeira vez.
CAD_G00N
Contm o programa fonte do ensimo programa
plotador de grfico definido para a aplicao. Os
nomes dos programas so montados automaticamente
durante a sua definio, com o prefixo do nome do
projeto, mais _G, seguido do nmero seqencial do
grfico.
CAD_P00N
Contm o programa fonte do ensimo programa de
processamento pr-definido da aplicao. Os nomes
dos programas so montados automaticamente durante
a sua definio, com o prefixo do nome do projeto,
mais _P, seguido do nmero seqencial do processo
pr-definido.
CAD_R00N
Contm o programa fonte do ensimo relatrio
definido para a aplicao. Os nomes dos relatrios so
montados automaticamente durante a sua definio,
com o prefixo do nome do projeto, mais _R, seguido
do nmero seqencial do relatrio.
Manual do Usuri o
529
CAD_E00N
Contm o programa fonte do ensimo programa de
emisso de etiquetas da aplicao. Os nomes dos
programas emissores de etiquetas so montados
automaticamente durante a sua definio no projeto,
com o prefixo do nome do projeto, mais _E, seguido
do nmero seqencial do programa emissor de
etiquetas.
CADASTRO.CH
Contm as definies das constantes manifestas
necessrias ao desempenho da aplicao final gerada,
alm das diretivas de pr-processamento de como o
sistema ir se comportar.
CADASTRO.RMK
Contm instrues a serem utilizadas pelo utilitrio
RMAKE para montar o sistema aplicativo final
executvel.
CADASTRO.LNK
Contm a lista de programas e o nome da biblioteca a
ser utilizada pelo link editor RTLINK.
CADASTRO.SOS
Contm o texto de ajuda on-line da aplicao, que
apresentado ao usurio a cada vez que pressionar a
tecla F1.
CADASTRO.INX
Contm o arquivo ndice associado ao arquivo
CADASTRO.SOS, permitindo um acesso imediato s
informaes pertinentes situao do momento.
Manual do Usuri o
530
CAD_PUBL.CH
Contm diversas variveis pblicas definidas pelo
projetista da aplicao.
CLIENTE.PRG
o mdulo gerente do subsistema gerado. Cada
subsistema (DBF) existente na aplicao possui um
mdulo semelhante. Daqui so selecionadas as
principais funes disponveis no subsistema. Dentro
deste mdulo so geradas outras rotinas:
CLI_INCL
Manipula todo o processo de incluso de novos
registros no arquivo de dados, criando variveis de
memria idnticas s do arquivo para permitir a
incluso de registros.
CLI_MEMO
Criada sempre que houver um campo do tipo memo
no subsistema. Esta funo criada para trabalhar em
conjunto com a funo EDIMEMO( ), que executa a
edio deste tipo de campo.
CLI_TELA
Apresenta a janela da tela definida para a entrada de
dados do subsistema.
CLI_GETS
Mostra as variveis do arquivo CLIENTE na tela.
Manual do Usuri o
531
CLI_GET1
Capta variveis do arquivo CLIENTE para serem
includas ou modificadas. Executa tambm todos os
processamentos, frmulas e lanamentos que tiverem
sido definidos. As excluses e recuperaes de
registros so feitas tambm por este mdulo. Por isso,
podemos dizer que este mdulo um dos que tm mais
importncia na aplicao.
CLI_ANT_SEQ
Criado sempre que houver um campo do tipo
sequencial ou quando houver um lanamento originado
pelo arquivo CLIENTE. Serve para retroceder um
campo sequencial caso este nmero tenho sido gerado
e no tenha sido utilizado (includo no arquivo).
CLI_CRIA_SEQ
pelo arquivo CLIENTE. Serve para criar o arquivo
DBF que conter o ltimo campo sequencial utilizado.
CLI_GERA_SEQ
pelo arquivo CLIENTE. Serve para gerar
(incrementar) um nmero sequencial para ser utilizado
na incluso do registro.
CLI_GRAVA_SEQ
pelo arquivo CLIENTE. Serve para gravar no
arquivo CLIENTE e no arquivo DBF controlador de
sequenciais, o nmero sequencial utilizado na incluso
de registro.
Manual do Usuri o
532
CAD_PROC.PRG
Este mdulo contm diversas subrotinas (procedures)
requisitadas pelos demais mdulos da aplicao. Nem
todas as rotinas listadas a seguir aparecero nos
programas fontes gerados, pois, elas so criadas
somente se forem necessrias aplicao. As rotinas
nele contidas, so as seguintes, em ordem alfabtica:
AJMOUSE
Contm as rotinas que permitem o ajuste da
sensibilidade do mouse utilizado para operar a
aplicao.
BROWSE_REL
Exibe um relatrio gravado em arquivo, permitindo
que seja paginado e consultado em uma janela na tela,
com diversos recursos de navegao.
CALE
Exibe um calendrio na tela, no canto superior direito,
aproveitando a data informada no acionamento do
sistema.
CBC1
Exibe o pano de fundo e a tela inicial da aplicao,
caso tenham sido definidos.
CLASS
Capta o campo ou seqncia de campos para a
ordenao de uma emisso de relatrio ou arquivo.
Manual do Usuri o
533
COMPACTA
Compacta os arquivos de dados (pack), eliminando
definitivamente os registros marcados para
apagamento.
CONF
Liga/desliga a confirmao de entradas (tecla ENTER)
durante a digitao de registros, quando a tecla F4
pressionada.
CONFPRN
o mdulo que permite a manuteno do arquivo de
impressoras cadastradas na aplicao
(PRINTERS.DBF). Permite inserir, apagar ou
modificar caractersticas das impressoras.
CONFCORES
Contm as rotinas que permitem a configurao de
esquemas de cores dentro da aplicao final.
DOSCOM
Executa comandos a nvel do DOS (DOS-SHELL). Para
retornar aplicao, o usurio dever teclar EXIT.
EDIT
Realiza a manuteno das informaes no arquivo de
dados (edio). Permite o acesso aos registros, de
modo seqencial ou indexado para modificaes.
ERRORSYS
Executa a chamada funo ERROMSG( ), para
manipular os erros de execuo da aplicao (ver final
do tpico Funes da biblioteca GASPRO5x.LIB e
GASP5xPM.LIB, neste captulo).
Manual do Usuri o
534
FAZ_LANC
Faz o lanamento no arquivo alvo, quando um registro
digitado no arquivo gerador do lanamento.
FILTRA
Capta os parmetros de seleo de registros para os
diversos tipos de emisso e consultas do sistema.
FIM_ARQ
Move o ponteiro para o ltimo registro do arquivo,
caso nenhum critrio de filtragem ou nenhum
relacionamento estejam estabelecidos. Caso contrrio,
posiciona no ltimo registro que esteja atendendo
condio de relacionamento e filtragem.
GBAK
Faz as cpias backup dos arquivos de dados da
aplicao.
GLOBAL
Contm as rotinas que realizam operaes de
alterao, excluso e recuperao agrupada de
registros.
HELP
Faz o gerenciamento da apresentao dos textos de
ajuda ao operador, quando a tecla F1 pressionada.
IMP_FORM
Serve para fazer o desmembramento e a impresso nas
telas da aplicao, de frmulas definidas no programa
CAD_ATRI.PRG, dentro do vetor sistema{}.
Manual do Usuri o
535
IMPRELA
Coloca no vdeo todas as telas dos arquivos
relacionados (pais e filhos), exceto a tela do arquivo
atual.
INDTMP
Cria os ndices temporrios para consultas e relatrios,
quando estes se fizerem necessrios.
INFOSIS
Coloca informaes especiais no rodap da tela de
digitao, como por exemplo, as teclas que esto
ativas, se o registro est ou no excludo e o tipo de
operao executada (incluso/alterao).
INI_ARQ
Move o ponteiro para o primeiro registro do arquivo,
caso nenhum critrio de filtragem ou nenhum
relacionamento estejam estabelecidos. Caso contrrio,
posiciona no primeiro registro que esteja atendendo
condio de relacionamento e filtragem.
INTREF
Manipula a integridade referencial de arquivos
subordinados, excluindo ou recuperando os registros
do arquivo filho.
MASENHA
Contm as rotinas de manipulao das senhas da
aplicao
.
Manual do Usuri o
536
MENU_CAD
Apresenta o menu das opes disponveis no
gerenciador de cada um dos subsistemas, e obtm a
opo escolhida.
MONTALIN
Associada ao mdulo BROWSE_REL, esta rotina
serve para retirar uma linha de arquivo binrio (no
qual est gravado o relatrio) para ser impressa no
vdeo. Ao retirar uma linha do arquivo, esta rotina
filtra os caracteres de controle e os caracteres de
efeito de impressora, para que possam ser visualizados
na tela.
MONTA_IMP
Associada ao mdulo BROWSE_REL, esta rotina
serve para enviar para a impressora as linhas do
relatrio gravado em disco.
NADAFAZ
Serve somente para desativar as teclas ^W, PgUP e
PgDn quando da incluso de registros. Essas teclas
tm que ser desativadas, pois as mesmas, se
pressionadas durante a incluso, ignoram todas as
crticas estabelecidas para os campos.
PARAMETROS
Serve para atualizar o arquivo de parmetros, caso
tenha sido gerado na aplicao, criar variveis de
memria idnticas s desse arquivo e public-las para
serem vistas por todos os mdulos da aplicao.
PEGACHV2
Pega o contedo da condio de relacionamento do
primeiro e do ltimo registro do arquivo relacionado,
ou seja, o primeiro registro que atende o
Manual do Usuri o
537
relacionamento e o primeiro registro seguinte que no
atende ao relacionamento.
POSI
Recebe dados para pesquisa indexada ao arquivo de
dados, segundo o conjunto de pesquisa selecionado.
PW_INCL
Contm as rotinas para cadastramentos e cerceamentos
de operadores da aplicao no seu plano de senhas.
RBAK
Executa a tarefa de recuperar os arquivos de dados da
aplicao atravs das cpias backup.
RCLA
Reconstri os ndices dos arquivos DBF da aplicao.
REIMPTEL
Reimprime as telas dos arquivos relacionados, usando
a funo IMPRELA sem modificar a situao da tela
atual.
REGINICIO
Testa se est fora do filtro/relacionamento e, se
afirmativo, posiciona no primeiro registro que atende
ao filtro e ao relacionamento.
Manual do Usuri o
538
REP
Liga/desliga a repetio automtica do registro
anteriormente digitado, quando a tecla F3
pressionada.
SINAL_DIG
Trabalha em conjunto com a procedure MAQCALC(),
recebendo o sinal digitado e forando a sada do
display com ENTER simulado.
SUBNIVEL
Manipula a incluso de registros em arquivos
subordinados (filhos).
TELA_ANT
Prepara a volta da tela anterior, quando a aplicao
tem mais de uma tela de digitao (PGUP).
TELA_SEG
Prepara o avano para a tela seguinte, quando a
aplicao tem mais de uma tela de digitao (PGDN).
TIRA_LANC
Retira (apaga) o lanamento feito no arquivo alvo
quando um registro do arquivo gerador do lanamento
apagado.
VEOUTROS
Abre opo para a consulta aos demais arquivos da
aplicao, atravs da tecla F9, quando o operador
estiver digitando ou alterando registros.
Manual do Usuri o
539
VE_CAMPOS
Abre janela mostrando os nomes dos campos do
arquivo corrente, nos quais o operador se basear para
entrar com um critrio livre de filtragem ou insero
de nova coluna em consultas de tela paginada.
CAD_FUNC.PRG
Este mdulo contm diversas funes requisitadas
pelos demais mdulos da aplicao. Nem todas as
funes listadas a seguir estaro presentes nos
programas fontes gerados pois, elas so criadas
somente se forem necessrias aplicao. As funes
nele contidas, so as seguintes, em ordem alfabtica:
ABRE
Abre arquivo em formato binrio para as operaes de
backup.
ABREOUTRO
Divide a tela em duas partes, abrindo o segundo
TBrowse, alm de inicializar algumas variveis.
ARQGER
Capta nome do arquivo (TXT ou PRN) proveniente da
rotina de exportao de dados ou de relatrios
direcionados para disco.
BRWFUNC
Funo UDF associada funo EDITA( ). Realiza a
maioria das tarefas da funo EDITA( ), como por
exemplo, excluso e recuperao de registros, incluso
de novos registros, etc.
Manual do Usuri o
540
CABBRW
Monta o cabealho da funo EDITA( ).
CABCONS
Imprime o cabealho do arquivo pai para a consulta
programada pela funo EDITA( ).
CABCONS_O
Imprime o cabealho do arquivo filho para a
consulta programada pela funo EDITA( ).
COLNOVA
Capta parmetros para criar novas colunas com
campos de outros arquivos, na consulta da funo
EDITA( ).
CRIADBF
Verifica e cria os arquivos DBF e NTX, quando estes
no existirem.
CRIADRV
Testa existncia de diretrio, criando-o se no existir.
CANC
Executa o cancelamento de relatrios. Dentro desta
rotina, dada ao operador a oportunidade de desistir
do cancelamento.
Manual do Usuri o
541
CONFALT
Verifica se o registro atual pode ser modificado (pela
condio alterao do registro definida no vetor
sistema{}.
CONFINCL
Apresenta mensagem e pede ao usurio uma
confirmao para incluso ou no do registro que est
sendo digitado.
CONFEXCL
Apresenta mensagem e pede ao usurio uma
confirmao para excluso ou no do registro atual.
CRIT
Executa a validao de campos e mostra mensagem de
erro ao operador da aplicao, se necessrio (ver final
do tpico Funes da biblioteca GASPRO5x.LIB,
neste captulo).
DIR_CUR
Muda o direcionamento da movimentao do cursor
(barra reversa) dentro da funo EDITA( ).
EDITA
Apresenta a tela de consulta no objeto TBrowse com
diversos recursos.
FORCABRW
Imprime novamente os dados mostrados pela funo
EDITA( ) do arquivo aberto na segunda janela.
Manual do Usuri o
542
IMP_BRW
Executa a impresso da consulta programada pela
funo EDITA( ).
IMPCTL
Imprime cdigo de controle na impressora, sem
desalinhar os valores de PROW( ) e PCOL( ) do CA-
Clipper.
IMPEXP
Imprime um contedo em caracteres expandidos para a
impressora.
IMPMEMO
Imprime uma linha de campo memo, justificada ou
no, acentuada ou no. A ltima linha do campo
memo nunca justificada.
LDBEDIT
Carrega do disco os parmetros de consultas
programadas pela funo EDITA(), gravadas
anteriormente.
MANUREF
Executa a manuteno da integridade referencial de
tabelas.
MENURELA
Esta funo tem dupla finalidade. Uma delas retornar
uma string com os ttulos dos arquivos relacionados,
separados por |. A outra retornar a subscrio do
Manual do Usuri o
543
vetor sistema correspondente ao ensimo arquivo da
lista passada como parmetro.
MONTABRW
Monta a janela de visualizao da funo EDITA( ) e
inicializa algumas variveis de ambiente.
MONTA_COL
Enche uma coluna da EDITA( ) com os atributos do
campo do arquivo definido no vetor sistema.
MOSTRA_RELA
Associada ao mdulo EDITA, verifica e mostra os
registros da janela inferior, caso esteja relacionada
com a janela superior.
MOUSETECLA
Aguarda que uma tecla seja digitada controlando a
ao do mouse, retornando a tecla digitada ou clicada.
MOV_PTR
Move o ponteiro dentro do arquivo relacionado N
registros para frente ou para trs, verificando se o
registro encontrado est no escopo da filtragem ou do
relacionamento.
OPCOES_ETQ
Abre opes para filtragem, ordenao, nmero de
cpias e escolha do tipo de sada, configurao da
etiqueta, etc., para as etiquetas, antes de cada emisso.
Manual do Usuri o
544
OPCOES_REL
Abre opes para filtragem, ordenao, nmero de
cpias e escolha do tipo de sada, etc., para os
relatrios do sistema, antes de cada emisso.
OPCOES_SGR
Abre a janela de opes para a plotagem do grfico.
Possibilita algumas alteraes nos parmetros do
grfico, como cor, resoluo, ttulo, etc.
PEGADIR
Capta o novo diretrio de trabalho para a aplicao.
PEGAPAI
Capta e retorna o nmero da subscrio do vetor
sistema correspondente ao arquivo pai.
PEGARELA
Monta menu com arquivos e campos para estabelecer a
expresso de relacionamento entre o arquivo
correntemente aberto e o arquivo a ser relacionado.
POINTER_DBF
Salva e restaura os ponteiros e o ndice utilizado pelos
diversos arquivos DBF definidos no vetor sistema{}.
PREPIMP
Apresenta mensagem solicitando o preparo da
impressora para emisso de relatrios, recebendo a
resposta.
Manual do Usuri o
545
PTAB
Executa pesquisa em tabelas (ver final do tpico
Funes da biblioteca GASPRO5x.LIB e
GASP5xPM.LIB, neste captulo).
QUALRELA
Pega a subscrio no vetor sistema{}, do ensimo
arquivo de uma relao (pai/filho).
CLICK_EM
Trabalha em conjunto com a MOUSETEC( ),
verificando se o mouse foi clicado sobre uma
mensagem qualquer nas bordas das janelas, como por
exemplo, F10, TAB, PGUP, PGDN, etc.
RELACAO
Capta os campos chaves de relacionamento entre dois
arquivos pai e filho.
ROLAPOP
Efetua a rolagem do segundo nvel do menu pop-down,
para a esquerda ou para a direita.
ROLATELA
Executa a mudana de posio das janelas da tela, em
conjunto com a funo MUDA_PJ explicada
anteriormente, quando a tecla ALT-F8 pressionada.
SEPARA
Efetua a separao do nome do campo, mscara, ttulo
e expresso de validao da coluna requerida dentro da
funo EDITA( ), armazenados na varivel de instncia
cargo do objeto da tbcolumn.
Manual do Usuri o
546
SETARELA
Estabelece o relacionamento (SET RELATION TO ...)
de arquivos dentro da consulta programada pela funo
EDITA( ).
TP_SAIDA
Permite a escolha das diversas configuraes da
impressora cadastrada no arquivo PRINTERS.DBF.
TRANSCAMPO
Adapta o campo para pesquisas e relacionamentos,
segundo o seu tipo, isto , coloca todos os campos para
o formato caracter, coloca DTOS( ) nos campos do tipo
data, STR( ) nos campos numricos, LTOC( ) nos
campos lgicos.
USEARQ
Abre arquivos de dados e seus ndices associados (ver
final do tpico Funes da biblioteca
GASPRO5x.LIB e GASP5xPM.LIB, neste captulo).
VDBF
Abre janela para consulta a outro arquivo da aplicao,
atravs da funo EDITA( ).
CAD_OUTR.PRG
Este mdulo contm as definies das funes de
calculadora e calendrio, bem como as funes
definidas pelo projetista, durante a elaborao do
projeto, pela opo Funes complementares.
Manual do Usuri o
547
CALE
Exibe um calendrio na tela, no canto superior direito,
aproveitando a data informada no acionamento do
sistema gerado.
MAQCALC
Apresenta na tela uma calculadora, possibilitando que
o usurio faa operaes de clculos e, opcionalmente,
transfira o resultado do display para o contedo de um
campo que esteja pendente de informao.
Manual do Usuri o
548
Manual do Usuri o
549
Captulo 12: Dicas &
Truques
Neste captulo voc poder encontrar algumas dicas e
solues para uma utilizao plena do GAS-Pro.
Alguns aspectos da operao do GAS-Pro esto
tambm detalhados neste material, sempre visando
fornecer subsdios para solucionar problemas e
utilizando um pouco de criatividade para utilizar
melhor o GAS-Pro.
Como implementar a impresso fiscal em
uma aplicao?
Tendo em vista a legislao vigente que no permite a
bufferizao do cupom fiscal antes da sua emisso, o
GAS-Pro implementa as rotinas de impresso fiscal
dentro das rotinas de entrada de dados. Por isso, tenha
em mente que, o mdulo escolhido para implementar a
impresso fiscal, deve ser criado unicamente para este
fim, no devendo existir permisses para excluses ou
alteraes de registros.
O mdulo definido para a impresso fiscal dever
obedecer seguinte estrutura na rvore do projeto:
Vendas
Dentro do mdulo de vendas, devero estar os dados
relativos ao cupom, como por exemplo, data,
Manual do Usuri o
550
informao sobre o cliente, etc. e, se desejar, um
campo do tipo caractere com 5 posies para guardar
o nmero do cupom que est sendo emitido.
Para iniciar a definio do impresso fiscal, voc
dever proceder conforme segue:
selecionar o menu Opes e marcar Abrir cupom
fiscal incluso;
acionar no menu anterior (Definio do
subsistema), a opo Impressora fiscal (que
dever estar disponvel);
definir a mensagem promocional a ser utilizada no
cupom, como por exemplo, Obrigado! Volte
sempre...;
Itens
No mdulo de itens, acione o menu Impressora fiscal
e a seguir, a opo Dados dos itens, entrando com as
informaes que forem solicitadas. A cada uma
dessas informaes voc deve acionar a tecla F1 para
obter informaes detalhadas sobre a forma de
preenchimento;
Formas de pagamento
No mdulo de formas de pagamento, acione o menu
Impressora fiscal e a seguir, a opo Formas de
pagamento, entrando com as informaes que forem
solicitadas. A cada uma dessas informaes voc deve
acionar a tecla F1 para obter informaes detalhadas
sobre a forma correta de preenchimento.
Quando as definies de Forma de pagamento so
feitas dentro de um mdulo filho, voc poder criar
diversas formas de pagamento para o mesmo cupom.
Por exemplo, para um cupom de valor total igual a
50,00 voc poderia efetuar a forma de pagamento da
seguinte maneira:
Manual do Usuri o
551
DINHEIRO........05,00
TICKET............ 20,00
CHEQUE.......... 10,00
CARTO..........15,00
Uma outra maneira de definir Formas de pagamento
coloc-las no mdulo onde voc abriu o cupom fiscal
para incluso (VENDAS no nosso exemplo). Porm,
neste caso, no haver a possibilidade de usar mais de
uma forma de pagamento para um mesmo cupom.
Considerando o exemplo anterior, a forma de
pagamento poderia ser:
DINHEIRO........ 50,00
ou
CHEQUE...........50,00
ou
CARTO...........50,00
etc...
Apoio impresso fiscal
Algumas opes precisam ser inseridas no mdulo de
apoio. Essas opes permitiro que o seu usurio
execute algumas operaes vitais na impressora fiscal.
Acesse a opo Apoio na rvore do projeto e insira o
mdulo Impressora fiscal. Subordinadas a este novo
mdulo, insira as demais opes que desejar
disponibilizar para o usurio. Lembre-se de que
algumas delas podem ser essenciais, como por
exemplo, Fechamento de caixa, Sangria,
Suprimento, etc.
Manual do Usuri o
552
Como implementar uma AGENDA na
aplicao?
Opcionalmente, o GAS-Pro poder gerar um mdulo
de agenda com alarme na aplicao final. Para isto,
voc dever primeiramente inserir um mdulo na
rvore do projeto, sob o nome que desejar, e criar
pelo menos trs campos:
um campo do tipo data;
um campo do tipo caracter de 5 posies com
mscara 99:99;
um campo do tipo caracter com 1 posio e mscara
de maiscula (!).
Esses campos recebero informaes especiais que
sero pedidas durante as definies da agenda. A tela
definida ser apresentada no momento do disparo do
alarme. Ser permitida a reprogramao do alarme
quando este for apresentado ao usurio.
Em ambiente de rede, se voc desejar separar a
visualizao da agenda para um s usurio ou grupo,
voc ter que marcar a opo Pedir diretrio de
trabalho, no menu Opes, dentro do mdulo que
ir conter os dados da agenda. Assim, quando cada
usurio entrar no sistema, poder separar os arquivos
em diretrios diferentes. Se dois ou mais usurios
informarem um mesmo diretrio, isto significa que
esses usurios iro compartilhar da mesma agenda.
Aps ter definido o mdulo que conter os dados da
agenda, voc dever acessar o menu Definio do
projeto, opo Criao de agenda para informar o
nome do arquivo da agenda bem como os 3 campos
previamente definidos.
Manual do Usuri o
553
Como implementar uma aplicao multi-
empresa?
De modo semelhante ao mdulo de agenda, voc
dever criar primeiro um mdulo para conter as
informaes das empresas. Neste arquivo, voc
poder colocar todos os campos que julgar necessrio
para o controle das empresas, incluindo um campo
especial que ser utilizado para identificar a empresa
no menu que aparecer no momento da ativao da
aplicao. Por esta razo, este campo de identificao
no pode ser muito grande (menor que 75 posies).
Os campos deste arquivo sero publicados em
variveis de mesmo nome, podendo, por isso, ser
utilizadas em qualquer ponto da aplicao. Por esta
razo, muito importante que os nomes dos campos
desse arquivo sejam escolhidos com cuidado para no
conflitarem com outras variveis pblicas da
aplicao. Sugerimos que seus nomes iniciem com
uma seqncia de caracteres qualquer, para que se
diferenciem das demais variveis do sistema, por
exemplo:
Empr_nome, Empr_endereo, etc...
Aps a definio deste mdulo, selecione a opo
Apoio do modelador do projeto e insira o mdulo
Muda empresa atual na rvore do projeto e
pressione ENTER para completar os dados desse
novo mdulo.
Um aspecto que merece ateno especial a opo
Diretrios diferentes. Se for marcada a opo SIM,
o usurio da aplicao ter que informar um diretrio
para dados de cada empresa cadastrada.
Isto significa que voc ter os arquivos de dados da
aplicao duplicados, com o mesmo nome, em
diretrios diferentes, porm contendo dados de uma
s das empresas cadastradas. Esta opo deve ser
selecionada quando as empresas em questo no tm
Manual do Usuri o
554
nenhum tipo de vnculo que implique em informaes
de mais de uma empresa nos relatrios da aplicao.
Marcando a opo NO, todos os arquivos de dados
sero compartilhados entre todas as empresas
cadastradas. Por isso, voc dever utilizar um campo
identificador de empresa, como por exemplo, cdigo,
CGC, etc para separar os registros de uma cada
empresa cadastrada nos arquivos da aplicao.
Como implementar letras grandes (tipo
PDV)?
A funo ImpGrande( ) pode ser utilizada para
mostrar um valor ou uma descrio com destaque nas
telas das aplicaes. As letras utilizadas pela funo
tm um tamanho de 3 linhas por 3 colunas, de modo
que existe uma certa limitao na quantidade de
informao que pode ser mostrada de uma s vez. Para
mostrar o valor total de uma venda, basta definir uma
frmula a ser impressa na tela, com as seguintes
informaes:
Ttulo: Valor total;
Frmula:
ImpGrande(TRAN(vTot,@E999,999.99),l_s+2,
c_s+5);
Mscara: Em branco
Largura: 40
Desta forma, o contedo do campo/varivel vTot ser
impresso em 3 linhas de 40 posies (3 caracteres por
letra + 1 espao de separao) * 10 caracteres totais.
As variveis l_s e c_s correspondem ao canto
esquerdo da tela do mdulo em definio. Esta funo
tem outros parmetros que permitem, por exemplo,
ajustar o valor direita, mudar cores de frente e
fundo, etc.
Manual do Usuri o
555
Como funciona o plano de senhas da apli-
cao?
As aplicaes geradas pelo GAS-Pro podero estar
providas de um plano de senhas para cercear o acesso
de usurios aplicao. Basta que o projetista deixe
inserido na rvore do projeto esta opo - que
colocada por default - para que o GAS-Pro coloque o
cdigo necessrio nos programas fontes da aplicao.
O esquema utilizado permite o cadastramento de
grupos de trabalho e de usurios dentro desses grupos.
A cada grupo podem ser designadas permisses
diversas em cada uma das tabelas que compem a
aplicao. Um usurio cadastrado dentro de um grupo
herda as permisses do seu grupo e, durante a
operao da aplicao, as operaes sero negadas
segundo as permisses designadas.
Alm disso, o plano de senhas que o GAS-Pro coloca
nas aplicaes possui 3 nveis globais de cerceamento
de usurios:
Nvel 3 - Gerncia
Nvel 2 - Manuteno
Nvel 1 - Operao
O nvel 3 (gerncia) so tem restries dentro da
aplicao, podendo credenciar e descredenciar
usurios. O nvel 2 (manuteno) um nvel
intermedirio que pode ser utilizado para um
cerceamento menos severo e, finalmente, o nvel 1
(operao) que o nvel mnimo de qualquer usurio.
Alm dos nveis globais, o GAS-Pro permite um
cerceamento mais apurado, a nvel de rotina, por
arquivo da aplicao, proporcionando uma
flexibilidade muito grande. Isto significa que
possvel credenciar dois usurios na aplicao com
mesmo nvel, porm com permisses diferentes para
as rotinas que acessam cada arquivo de dados. O
controle de rotinas feito da seguinte maneira: ao criar
Manual do Usuri o
556
um novo grupo, pode-se informar um conjunto de
caracteres (string), para cada um dos arquivos da
aplicao, para controlar o acesso dos usurios
cadastrados dentro do grupo, ao arquivo especificado.
Este conjunto ser vinculado senha de cada um dos
usurios do grupo. Cada caracter componente deste
conjunto corresponde letra da opo da rotina que os
usurio credenciados NO PODERO ACESSAR,
PARA AQUELE ARQUIVO.
Essas rotinas so:
Tecla Funo
P Procura
F Filtragem
D Digitao
M Modifica
E Exclui
R Recupera
V V global
N Nova coluna
A Apaga coluna
I Imprime consulta
O Ordena
Q Quantifica
L Localiza
G Global
C Congela colunas
T Tamanho
J abre nova Janela
X eXporta dados
Z totaliZa coluna
Manual do Usuri o
557
Assim, um usurio credenciado em um grupo ao qual
tenha sido vinculado o conjunto de caracteres
DEOFNZ para um determinado arquivo, no tem
acesso s rotinas que comeam com essas letras nos
menus de opes que manipulam este arquivo, ou
seja, no Digita, no Exclui, no Ordena, no Filtra,
no abre Novas colunas nem totaliZa colunas, no
arquivo especfico, embora em outros arquivos, possa
ter acesso pleno.
Como so controlados os lanamentos na
aplicao?
O GAS-Pro permite a definio de lanamentos para
serem feitos em outros arquivos de dados da aplicao,
durante a digitao de registros.
Um lanamento bastante semelhante a um
processamento. Neste ltimo, nenhum registro
gerado dentro do arquivo alvo, somente os campos de
um determinado registro so modificados. Por isso, um
arquivo que sofre processamento sempre est
relacionado com o arquivo que gerou este
processamento atravs da funo PTAB( ). No caso do
lanamento, novos registros so colocados no arquivo
alvo e seus campos imediatamente modificados com os
valores estabeledos, no havendo a necessidade de
existir relacionamento entre os arquivos.
As aplicaes geradas pelo GAS-Pro so capazes de
controlar no s a gerao desses lanamentos como
tambm a sua manuteno. Por exemplo, se o usurio
tentar apagar de um arquivo, um registro que tenha
sido criado atravs de um lanamento, a aplicao no
permitir e mostrar um aviso ao usurio de que aquele
registro um registro de lanamento.
Vamos ver agora como que a aplicao controla quais
registros foram gerados atravs de lanamentos e a
partir de qual arquivo foram originados.
Manual do Usuri o
558
Sempre que um lanamento definido no projeto, o
GAS-Pro cria, automaticamente, dois campos
especiais nas estruturas dos arquivos envolvidos:
um campo invisvel e seqencial (incremento
automtico) de nome INTLAN criado dentro do
arquivo gerador do lanamento, para servir como
parte da ligao com os registros lanados no
arquivo alvo.
o campo invisvel, de nome CODLAN criado
dentro do arquivo alvo do lanamento, para conter a
seguinte informao:
Exemplo
Observe o seguinte arquivo:
Arquivo: NOTA FISCAL (FISCAL.DBF)
Atravs da sada de uma Nota Fiscal desejamos gerar
no arquivo de Contas a Pagar e Receber, dois
lanamentos: um deles lanando um pagamento da
comisso do vendedor e um outro lanando o valor
recebido em 3 parcelas. Note que so DOIS
Nmero 3452
Valor 150.000,00
Data 01/06/94
Parcelas 3
Vendedor PEDRO
INTLAN 00000001
Manual do Usuri o
559
lanamentos distintos, em um mesmo arquivo e, um
deles, com mltiplos registros no arquivo alvo (3 no
nosso exemplo).
Aps a sada da Nota Fiscal acima, nosso arquivo de
Contas a Pagar e a Receber ficaria assim:
Arquivo: CONTAS A PAGAR E A RECEBER
(PAGREC.DBF)
Note que os valores colocados nos campos, dependem
do que for definido na fase do projeto, para esses
lanamentos.
Os registros gerados por um lanamento externo
podem ser modificados (mas no apagados)
diretamente da tela definida para o arquivo. Caso
deseje impedir essa modificao, a dica utilizar o
campo CODLAN para montar uma pr-validao que
impea o cursor de estacionar em todos os campos do
arquivo ou somente em alguns deles. Esta expresso de
pr-validao poder ser definida assim:
EMPT(codlan)
Como j vimos anteriormente, o campo CODLAN
conter informaes sempre que o registro for gerado
por um lanamento e esta expresso ser sempre falsa,
para esse tipo de registro.
Data Nat. Valor Histrico CODLAN
01/06/94 D 105,00 COMISSO PEDRO FIS-00000001-001
01/06/94 C 50.000,00 NF 3452 FIS-00000001-002-001
01/07/94 C 50.000,00 NF 3452 FIS-00000001-002-002
01/08/94 C 50.000,00 NF 3452 FIS-00000001-002-003
Manual do Usuri o
560
Outro aspecto que merece ser abordado para
lanamentos que, as modificaes feitas sobre
registros gerados por lanamentos, podero se perder,
caso o arquivo gerador desses lanamentos seja
modificado pois, a cada modificao, os registros de
lanamentos so eliminados e gerados novamente,
conforme necessrio.
Algumas dicas de programao
Este tpico aborda alguns aspectos sobre o
funcionamento das aplicaes geradas e seus
programas fontes, com o propsito de facilitar
alteraes que possam ser necessrias nos mesmos.
Naturalmente, para serem feitas essas alteraes,
necessrio que se tenha conhecimento da linguagem
CA-Clipper verso 5.2 e do manejo de um editor de
textos qualquer.
Como gerar aplicaes protegidas contra pirataria?
O GAS-Pro poder opcionalmente, criar rotinas dentro
de uma aplicao gerada que impeam ou dificultem
ao seu cliente ou usurio instal-la em outros
equipamentos, ou passar uma cpia a terceiros, sem o
seu consentimento. No intuito da GAS Informtica
apresentar esta proteo como uma soluo final e
infalvel para proteger o seu trabalho, mas to
somente oferecer uma facilidade a mais para ajud-lo
a colocar a sua aplicao no mercado sem prejuzos.
Embora a GAS Informtica tenha feito testes bastante
satisfatrios, recomendvel que voc analise e
execute tambm seus prprios testes.
O esquema utilizado NO PROTEGE o kit de
instalao contra cpias, porm impede que esta seja
instalada sem o seu consentimento! Aproveitando-se
deste detalhe, fica bastante fcil colocar a sua
aplicao para ser comercializada por telefone,
InterNet, etc. No momento da primeira instalao, o
Manual do Usuri o
561
usurio ter de falar com voc, por telefone, para que
voc o autorize, atravs de uma contra-senha (que
nunca igual, nem mesmo para a mesma aplicao).
Para criar uma aplicao com proteo
Para criar uma aplicao com rotinas de proteo
basta marcar a opo Proteger aplicao, em
rotinas especiais e proceder normalmente, gerando
os programas fontes e o programa executvel, tudo
atravs do GAS-Pro. Poder ser gerada uma contra-
senha para cada instalao da aplicao por clientes
(opo Gera contra-senha), alm de uma senha
master para instalao pelo prprio desenvolvedor
(opo Cria gazua).
Sempre que esta opo esteja marcada, a opo
Utilizar PLL tambm ficar marcada. Sempre que
utilizar uma PLL voc estar dificultando ou
impedindo que decompiladores (Valkyrie, Unclip e
outros) possam abrir o seu cdigo fonte em CA-
Clipper.
Gerar um kit de instalao atravs do GAS-Pro. O
GAS-Pro colocar dentro do utilitrio instalador,
todas as rotinas para proteger a sua aplicao na
mquina do usurio. Voc poder ento entregar
este kit para o seu usurio, que poder copi-lo
vontade. No existe qualquer esquema de proteo
contra a sua cpia, nem necessrio.
Quando o seu usurio ativar o utilitrio instalador
(INSTALAR.EXE), no equipamento dele, este
apresentar um nmero de 10 dgitos, solicitando
uma contra-senha tambm de 10 dgitos, que
somente voc poder fornecer. Sem esta contra-
senha impossvel instalar a aplicao!
Neste momento, com esta janela aberta, o seu
usurio ter de telefonar para voce para informar o
nmero que aparece na janela e solicitar a contra-
senha.
Manual do Usuri o
562
Execute o GAS-Pro e selecione a opo Gera
contra-senha, no menu de definio do projeto.
Digite o nmero que o usurio solicitou tal contra-
senha. Ao digitar o nmero passado pelo usurio, o
GAS-Pro gerar a contra senha para a instalao.
Informe-a ao seu usurio e ele poder prosseguir
com a instalao normalmente.
Se, devido a algum problema, o usurio precisar
instalar novamente a aplicao COM AQUELE
MESMO KIT, ele no mais necessitar ligar para
voc, DESDE QUE V REINSTAL-LA NO
MESMO EQUIPAMENTO E NO MESMO DISCO
RGIDO! Se for instalar em outro equipamento ou
em outro disco rgido do mesmo equipamento, nova
contra-senha ser pedida e ele ter de solicit-lo.
Fornea-a, se achar conveniente, porm esteja ciente
de que ele poder estar instalando em um outro
equipamento qualquer.
O esquema de proteo utilizado pelo GAS-Pro
coloca no diretrio de trabalho da aplicao um
arquivo oculto, com o mesmo nome da aplicao e
extenso .SYS. Seus atributos no podem ser
mudados nem ele pode ser apagado, sob pena da
aplicao no funcionar mais. O seu usurio
alertado para este detalhe nas mensagens do
utilitrio instalador. O usurio poder reinstal-lo,
porm, sempre nas condies descritas no item
acima.
Normalmente, na primeira vez que a aplicao
instalada no equipamento do usurio, o projetista
executor da aplicao est presente. Neste caso,
como no ser possvel o fornecimento da contra-
senha para a instalao por parte do projetista, foi
criada a opo GAZUA, vinculada ao projeto, que,
em nenhuma hiptese, deve ser do conhecimento do
usurio! Uma gazua pode ser opcionalmente
criada pela opo Gazua no menu de definio do
projeto. Esta gazua ou senha master lhe permitir
tambm instalar a aplicao, sem precisar da contra-
senha. Para isto, quando o instalador solicitar a
contra-senha (item 3), voc dever
Manual do Usuri o
563
PESSOALMENTE, pressionar F8 e digitar a gazua
para a aplicao. Durante esta digitao, nada
aparece no campo em digitao.
importante lembrar que, para uma gazua
funcionar necessrio que ele tenha sido
estabelecida ANTES DA GERAO DO KIT DE
INSTALAO para a aplicao. Tambm,
opcionalmente, esta gazua pode ser desativada
aps a primeira instalao da aplicao, no
funcionando mais da em diante, para aquele kit.
Devido arquitetura do Windows95/98, se a sua
aplicao for instalada em uma janela DOS no
ambiente Windows95/98, esta ter de ser gerada
como se fosse para REDE LOCAL. Para isto, basta
marcar a opo Gera para rede local no menu de
rotinas especiais.
Como aumentar a quantidade de critrios de seleo ou
filtragem?
As aplicaes geradas pelo GAS-Pro permitem,
atravs de interface amigvel, o estabelecimentos de
filtros (queries) para selecionar registros do banco de
dados (DBF). A rotina gerada pelo GAS-Pro para o
estabelecimento desses filtros permite um mximo de
3 critrios de seleo. Para aumentar a quantidade de
critrios, basta manipular a varivel selnum que se
encontra dentro da procedure FILTRA( ), do programa
XXX_PROC.PRG:
op_6=1
m_criterio=
DO WHIL selnum<3 .AND. cpsel!=SPAC(10)
selnum++
IF selnum>1
Manual do Usuri o
564
m_tit=FILTRAGEM|OPERADORES
LGICOS|*+m_criterio
op_2=DBOX(*Ok*|E|OU,,,E_MENU,,m_tit)
IF op_2=0
criterio=; cn=.t.
EXIT
. . .
Como aumentar manualmente o tamanho de um
campo de um arquivo da aplicao?
Abrir com um editor o programa XXX_ESTR.PRG e
procurar a rotina correspondente (PROC XXX_ESTR)
ao arquivo a ser modificado. Alterar o tamanho do
campo desejado.
DBCREATE(dbf,{;
{codi ,C,004, 0 },; // 9999
{desc ,C,030, 0 },; // @!
{retec ,M,010, 0 },; // @S50
{qmin ,N,004, 0 },; // 9999
{qest ,N,004, 0 },; // 9999
{ultp ,N,010, 2 },; // 9999999.99
{pmedio ,N,010, 2 }; // 9999999.99
};
)
. . .
Abrir o programa XXX_ATRI.PRG, e alterar a
mscara referente ao campo cujo tamanho tenha sido
modificado, se for necessrio.
Manual do Usuri o
565
AADD(sistema[01,O_CAMPO],{;
/* mascara */ 9999,;
/* titulo */ Cdigo,;
/* cmd especial */ ,;
. . .
Modificar a estrutura do arquivo DBF, caso j existam
registros digitados. Se no houver sido feitas
digitaes, o melhor e mais rpido deletar (apagar)
o arquivo DBF.
Para modificar a estrutura de um arquivo DBF, fazer
uso de uma linguagem interativa xBASE (dBASE, FOX,
etc), digitando a partir do prompt da linguagem:
USE nomearq MODIFY STRU
Aps feitas as modificaes, pressionar ^W e digitar
QUIT.
Como construir sua prpria rotina de validao de
DV?
As rotinas de validao de dgitos verificadores (DV)
que vm nas bibliotecas foram elaboradas obecendo o
algortmo de mdulo 11, que a mais utilizada pela
maioria das organizaes.
Essas funes, em nmero de 4, so as seguintes:
GDV1( ) // para gerar um dgito
GDV2( ) // para gerar dois dgitos
VDV1( ) // para verificar 1 dgito
VDV2( ) // para verificar 2 dgitos
Manual do Usuri o
566
Para facilitar a implementao de uma rotina diferente,
quando se fizer necessria, abaixo est o cdigo
completo em CA-Clipper das quatro funes acima,
para serem modificadas conforme desejado. Essas
funes, aps serem modificadas, devem ser colocadas
no final do programa XXX_PROC.PRG, com o
mesmo nome original, para que sejam consideradas
pelo CA-Clipper, em substituio s que existem nas
bibliotecas.
FUNCTION GDV1(cl_1)
* Sintaxe: GDV1( <expC> )
* funo.: calcula O DV mdulo 11 (de
* 1 dgito) de <expC> string
* Retorna: o DV (string)
*
LOCAL num_,qu_,rest_,dvc_valo_,soma_,posi_
cl_1 = TRIM(cl_1)
num_ = cl_1
qu_ = LEN(num_)
soma_:=posi_:=0
DO WHIL posi_ < qu_
posi_++
valo_=VAL(SUBS(num_,qu_+1-posi_,1))*(posi_+1)
soma_+=valo_
ENDD
rest_=soma_%11
dvc_=IF(rest_<2,0,11-rest_)
RETU LTRIM(STR(dvc_,1))
FUNCTION GDV2(cl_1)
* Sintaxe: GDV2( <expC> )
* Funo.: calcula O DV mdulo 11 (dois
Manual do Usuri o
567
* dgitos) de expC string
* Retorna: o DV (string)
*
LOCAL num_,dvc_
cl_1 = TRIM(cl_1)
num_ = cl_1
dvc_ = GDV1(num_) // primeiro digito
num_ = num_+dvc_ // incorpora segundo digito
RETU dvc_+GDV1(num_)
FUNCTION VDV1(cl_1)
* Sintaxe: VDV1( <expC> )
* Funo.: verifica se o DV mdulo 11 (1 dgito)
* de <expN> est correto suporta
* os formatos 9999999 e 9999999-9
* Retorna: lgico
*
LOCAL f_,num_,dvf_
cl_1 = TRIM(cl_1)
f_ = IF(ASC(SUBS(cl_1,LEN(cl_1)-1,1))<48,.T.,.F.)//
formato 99999-9=.t.
num_=;
IF(f_,SUBS(cl_1,1,LEN(cl_1)-2),SUBS(cl_1,1,LEN(cl_1)-
1))
dvf_ = VAL(SUBS(cl_1,LEN(cl_1),1))
RETU IF(VAL(GDV1(num_))=dvf_,.T.,.F.)
FUNCTION VDV2(cl_1)
* Sintaxe: VDV2(<exp>)
Manual do Usuri o
568
* Funo.: verifica se DV mdulo 11 (de dois digitos) do
nmero informado est correto. Suporta os formatos
999999999-99 e 99999999999
* Retorna: lgico
*
LOCAL f_,num_,dvf_,dvc_
cl_1 = TRIM(cl_1)
f_ = ;
IF(ASC(SUBS(cl_1,LEN(cl_1)-2,1))<48,.T.,.F.)
// formato 999999999-99=.T.
num_=;
IF(f_,SUBS(cl_1,1,LEN(cl_1)-3),SUBS(cl_1,1,LEN(cl_1)-
2))
dvf_ = VAL(SUBS(cl_1,LEN(cl_1)-1,2))
dvc_ = GDV1(num_) // primeiro digito
num_ = num_+dvc_ // incorpora segundo digito dvc_ =
dvc_+GDV1(num_) // calcula dv
RETU IF(VAL(dvc_)=dvf_ .OR. EMPTY(cl_1),.T.,.F.)
Como definir a tecla F8 para calcular o Dgito
Verificador (DV)?
Durante a fase do projeto de uma aplicao com o
GAS-Pro, a tecla F8 pode ser definida para executar
uma funo qualquer, se acionada quando o usurio
estiver digitando um campo. Uma utilizao
interessante para esta facilidade pode ser criada para
calcular o dgito verificador (DV) do campo que
estiver sendo digitado naquele momento. Vejamos
como poderamos fazer:
Durante a entrada de atributos para um campo que
tenha validao de DV, quando chegar a pergunta
comando F8, pressione F9 para editar uma funo e
digite o trecho de programa abaixo:
x=DBOX(Nmero para calcular o DV,,,,,;
DV,SPACE(Tam),@9)
Manual do Usuri o
569
RETU ALLTRIM(x)+GDV1(x)
Ao digitar este fragmento de programa no editor do
GAS-Pro, este criar uma funo que, permitir ao
nosso usurio pressionar a tecla F8, receber um
nmero, calcular qual o seu DV e coloc-lo no campo
em edio.
Manual do Usuri o
570
Manual do Usuri o
571
Apndices
Apndice A - Arquivos Auxiliares do
GAS-Pro
Durante o desenvolvimento do projeto, o GAS-Pro
cria e modifica diversos arquivos para armazenar
definies, que so incorporados ao projeto. Esses
arquivos de formato ASCII, cujos layouts esto
descritos na documentao on-line do Norton Guides,
so classificados de acordo com a sua extenso:
.PRO Contm todas as informaes de um projeto definido
pelo GAS-Pro, com seus mdulos, rvore hierrquica
e configuraes globais.
.ATR Contm as definies de cada subsistema, arquivo de
parmetro ou tela complementar definidos no projeto.
Este arquivo contm tambm as definies das
variveis complementares estabelecidas nos mdulos
de relatrios, grficos, etiquetas, etc.
.REL Armazena as definies de um relatrio definido no
projeto.
.ETQ Armazena as defines de uma etiqueta definida no
projeto.
.CEX Contm as definies relativas a um mdulo de
consulta extra definida no projeto.
.SGR Contm parmetros de definio e um grfico definido
no projeto.
.GLO Contm as definies de um mdulo de processamento
pr-definido dentro do projeto.
.CPO Contm os atributos de um campo definido no projeto.
O conjunto desses arquivos se constitui no banco de
campos.
Manual do Usuri o
572
Apndice B - Comandos de Edio para
Formatao de Telas e Relatrios
Movimentao
Â ^ + Seta para esquerda Move para a palavra anterior
^C PgDn Move para a tela seguinte
^D Seta para direita Move o cursor uma posio para direita
Ê Seta para cima Move o cursor para a linha acima
^F ^ + Seta para direita Move o cursor para palavra seguinte
^QC ^ + PgDn Move para a ltima janela da tela
^QD END Posiciona no fim da linha
^QR ^ + PgUp Move para a primeira janela da tela
^QS HOME Posiciona cursor no incio da linha
^R PgUp Move para a tela anterior
^S Seta para esquerda Move uma posio para esquerda
^X Seta para baixo Posiciona na linha abaixo
^W Rola a tela para cima (scroll up)
^Z Rola a tela para baixo (scroll down)
Ins / Del
^G DEL Apaga caracter sob o cursor
^H BackSpace Apaga caracter esquerda
^N Insere nova linha no cursor
^QY Apaga a linha a partir cursor
^T Apaga palavra direita do cursor (se sobre campo ou frmula, retira)
^V INS Liga/desliga modo de insero
^Y Apaga a linha corrente
Manual do Usuri o
573
Blocos
^KB Marca o incio do bloco
^KC Copia bloco para a posio cursor
^KH Liga/desliga a marcao do bloco
^KK Marca o final do bloco
^KP Imprime a tela na impressora
^KR L bloco de texto do disco
^KV Move o bloco para a posio cursor
^KW Grava bloco marcado em disco
^KY Apaga o bloco marcado
ÔC Copia bloco marcado para o clipboard
ÔR Insere contedo do clipboard no texto
Miscelnia
ESC Abandona a edio e grava definio
ALT-F2 Aceita comandos do DOS (shell)
ALT-E Acessa o modo de letras expandidas
ALT-M Liga/desliga operao com mouse
ALT-Q ^KQ Abandona e descarta modificaes
ALT-T Tela, relatrio ou etiqueta padro
F1 Apresenta esta ajuda
F2 ^W Grava a tela ou layout de relat/etq
F3 ^L Carrega tela/relatrio gravado
F4 Muda p/janela de atributos (se tela)
F5 Seleciona molduras para desenhar
F6 Seleciona frmula ou varivel
F7 Borracha - desenha apagando
Manual do Usuri o
574
F8 Seleciona caracter para desenhar
F9 Expande, contrai ou move a janela
F10 Seleciona campo ou contedo
^J Centraliza texto na janela
^QL Restaura linha modificada
Û Recupera linhas apagadas
5 (Keypad) Copia o caracter da linha acima
Miscelnia
Manual do Usuri o
575
Apndice C - Comandos de Edio em
Campos Durante a Operao do GAS-
Pro
Tecla Alternativa Ao
Â ^ + Seta para esquerda Move para a palavra anterior
^D Seta para direita Move o cursor uma posio para direita
^F ^ + Seta para direita Move o cursor para palavra seguinte
^QS HOME Posiciona cursor no incio da linha
^QD END Posiciona o cursor no fim da linha
^R PgUp Move para a tela anterior
^S Seta para esquerda Move uma posio para esquerda
^X Seta para baixo Passa para o prximo campo
^G DEL Apaga caracter sob o cursor
^H BackSpace Apaga caracter esquerda
^T Apaga palavra direita do cursor
^V INS Liga/desliga modo de insero
^Y Apaga o contedo do campo
ÔC Copia campo para o clipboard
ÔR Copia do clipboard para o campo
ESC Abandona a edio do campo
Alt-F1 Liga/desliga ajuda ativa para o campo
Alt-F2 Aceita comandos do DOS (shell)
Alt-M Liga/desliga operao com mouse
F1 Apresenta esta ajuda
Û Restaura contedo anterior
ENTER Aceita contedo do campo
Manual do Usuri o
576
Manual do Usuri o
577
Apndice D - Palavras Reservadas
As palavras relacionadas nas tabelas a seguir so
palavras reservadas do CA-Clipper e do GAS-Pro. As
palavras reservadas no podem ser utilizadas para dar
nomes a campos, arquivos, variveis, funes ou
procedures.
Alm disso, no pode ser utilizada qualquer abreviao
com mais de trs letras das palavras reservadas do CA-
Clipper. O CA-Clipper ainda reserva o caracter _
(underscore) no incio de identificadores, significando
que este caracter no poder tambm ser utilizado no
incio de nomes de variveis, campos, arquivos, etc.
Palavras reservadas do CA-Clipper
AADD EOF RECCOUNT
ABS EXP RECNO
ASC FCOUNT REPLICATE
AT FIELDNAME RLOCK
BOF FILE ROUND
BREAK FLOCK ROW
CDOW FOUND RTRIM
CHR FUNCTION SECONDS
CMONTH IF SELECT
COL IIF SET
CTOD INKEY SETPOS
DATE INT SPACE
DAY LASTREC SQRT
DELETED LEN STR
DEVPOS LOCK SUBSTR
Manual do Usuri o
578
Palavras reservadas do GAS-Pro
DOW LOG TIME
DTOC LOWER TRANSFORM
DTOS LTRIM TRIM
ELSE MAX TYPE
ELSEIF MIN UPPER
EMPTY MONTH VAL
END PCOL VALTYPE
ENDCASE PCOUNT WHILE
ENDDO PROCEDURE WORD
ENDIF PROW YEAR
ABRE DRIVES MARCAIMP QUALDIR
AJMOUSE EDBF MASENHA QUALRELA
ALERTA EDIMEMO MENURELA RBAK
ARQGER EDIT MKDIR RCLA
BLOARQ EDITA MONTABRW RELACAO
BLOREG EDRELA MOUSE RELAPAI
BRWFUNC ENCRIPT MOUSEBOX REP
CABBRW ERROMSG MOUSECUR REPBLO
CABCONS EXT MOUSEDN RMDIR
CAIXA FILTRA MOUSEGET ROLAPOP
CALCDATA GBAK MOUSERAT ROLATELA
CALE GDV1 MOUSESET RONLY
CALEN GDV2 MOUSEUP RWRITE
CALLINT GLOBAL MTAB SENHA
Manual do Usuri o
579
CANC GRELA NADAFAZ SEPARA
CARDTYPE HELP NAOPISCA SEPLETRA
CBC1 IMPAC NARQ SETARELA
CHDIR IMPCTL NIVELOP SETS
CLASS IMPEXP NMES SISTEMA
CODLAN IMPMEMO NSEM STRING
COLNOVA IMPRELA PARALELA STRPTR
COMPACTA INDTMP PARSE STRSEG
CONF INFOSIS PCOND SUBNIVEL
CONTA INTLAN PEEK TAMDISCO
CPORD INTREF PEGACHV2 TLAPSO
CRIADBF INVCOR PEGADIR USEARQ
CRIADRV LDBEDIT PEGAPAI USUARIO
CRIT LEMANU PEGARELA VCGC
CRITERIO LPAD POKE VDBF
DBOX LRELA POSI VDV1
DEFA LTOC PREPIMP VDV2
DLAPSO MAIUSC PTAB VEOUTROS
DOSCOM MANUREF PWORD VHORA
DOSDATA MAQCALC QDRIVES VUF
Manual do Usuri o
580

Gaspro PDF

Încărcat de

Informații document

Titlu original

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

Gaspro PDF

Încărcat de

Drepturi de autor:

Formate disponibile

GAS Pro

Gerador Automtico de Sistemas

S-ar putea să vă placă și