INDICE DOS CAPITULOS: DF1 - INTRODUO AO DATAFLEX DF2 - CRIANDO A BASE DE DADOS DF3 - TELAS DE UM PROGRAMA DATAFLEX DF4 - COMEANDO A PROGRAMAR (EXEMPLO PRATICO) DF5 - LAOS, INDICADORES, OPERADORES LGICOS E ALGUNS COMANDOS DF6 - COMANDOS DATAFLEX DF7 - FORMATAO DE JANELAS E KEYPROCS DF8 - ALGUMAS DICAS PRA PROGRAMAR COM EXEMPLOS DF9 - A MACRO ENTER (EXEMPLO PRATICO) E RELACIONAMENTOS DF10- A MACRO ENTERGROUP (C/EXEMPLOS) DF11- A MACRO REPORT DF12- MAIS EXEMPLOS COM A REPORT DF13- IMPRESSO DE ETIQUETAS DF14- CRIANDO COMANDOS DF15- GRAFICOS DF16- OUTRAS TECNICAS OBS: Este tutorial presume que voce j tenha conhecimentos bsicos sobre arquivos, registros, indices e demais estruturas de programao como laos, variveis, etc. Ele no pretende esgotar o assunto mas apenas iniciar o leitor no dataflex verso 2.3 e 3.0 procedural. Dvidas consulte o autor. AUTOR : Paulo Miranda DATA : fev/2003 E-MAIL: phbm@webcable.com.br BIBLIOGRAFIA: "Dataflex-Bancos de Dados de 4a Gerao" Editora McGraw-Hill Autor: Daniel Jos Burd

Captulo 1- Introduo ao Dataflex O Dataflex uma linguagem de programao e acesso a banco de dados (tambm Dataflex), voltada para o desenvolvimento rpido de arquivos de dados e ferramentas de consulta, cadastro, relatrios, e muitas outras voltadas a esta base de dados. Suas principais vantagens so a facilidade de desenvolvimento de aplicativos com grande portabilidade para diferentes sistemas operacionais (Windows, DOS, Unix, AIX, Linux, Solaris,etc), bastando apenas a recompilao dos arquivos fontes. Para os usarios do sistema exitem as vantagens da facilidade de uso, rapidez de cadastro, velocidade e confiabilidade no acesso aos dados, interface agradvel podendo ser grfica ou modo texto. Existe o Visual Dataflex para windows, mas nesta apostila falaremos apenas do dataflex para DOS e UNIX verses 3.0 e 2.3 usando lgica de programao procedural (a 3.0 suporta P.O.O. e procedural). Com o dataflex vem diversos aplicativos, eis os principais deles que sero explicados com maiores detalhes mais adiante: DFCOMP - Compilador dataflex que compila o arquivo texto de extenso (.FRM por padro) para um arquivo executvel de extenso .FLX. Usa-se DFCOMP . DFRUN - Executa um programa dataflex. Note que o FLX no pode rodar sozinho precisa do programa dfrun para poder executar. Um programa dataflex s funciona numa mquina que tenha pelo menos instalado o runtime do dataflex. Mas se a empresa precisa frequentemente mexer nos programas ai vai precisar do dataflex verso desenvolvedor (completo e mais caro).Usa-se: DFRUN DFFILE - Usado para criar arquivos de dados (.DAT) , arquivos de indices (.K1,.K2,etc) e tambm relacionamentos. Com este utilitrio voce cria todos os campos do arquivo e depois cria os indices. Voce tambm pode gerar arquivo de dados (vazio claro!) tambm a partir de definies de arquivos (.DEF) que so arquivos textos. DFQUERY - Consultas rpidas a arquivos. Voce v a estrutura do arquivo, campos, indices, quantidade de registros e pode selecionar padres de consulta comparando um ou vrios campos com faixas de valores que voce fixa (semelhante a clasula where do SQL). As consultas podem ser direcionadas para arquivos texto, vdeo ou impressora e podem ser ordenadas por um indice opcionalmente. muito usado este utilitrio na exportao (gerando arquivo texto) e conferncia dos dados. READ - importa arquivos textos pra arquivo de dados em formatos separados por linhas ou ponto e virgla. usado para gerar programas de importao de dados. ENTERDEF - Gera executveis de entrada de dados com macro enter automaticamente a partir de arquivos texto de definio de arquivo(.DEF) DFINDEX - Ferramenta para reindexar arquivos de dados. DFSETUP - Utilitrio para alterar configuraes internas do dataflex. AUTODEF - utilitrio pra se criar uma aplicao de cadastro (macro enter) atravs de uma imagem. MENUDEF - usado pra se criar menus e sub-menus. Ex: menu pricipal, menu da expedio, menu da vendas, etc. Note que o banco de dados dataflex (verses 3.0 e 2.3) no relacional. Para um nico arquivo de dados (.DAT) criado so criados alguns arquivos adicionais como indices(.K1,.K2,.K3,etc) definio de arquivo(.DEF), "apelidos" de campos de arquivos usados na compilao (.FD), arquivo de dados compactado da verso 3.0 (.VLD), arquivo de nomes de campos de arquivos (.TAG). Veremos adiante mais detalhes sobre estes arquivos. Tenha em mente que o dataflex uma exelente ferramenta multi-sistema operacinal, com grande confiabilidade e velocidade de acesso. Eu trabalhei alguns anos com esta linguagem num ambiente Unix com servidor RISC da IBM com a verso 2.3 com terminais e micros emulando terminias numa firma de grande volume de cadastros e consultas, com cerca de 100 usurios, 500 arquivos alguns com quase 1 milho de registros e nunca tive problemas srios com arquivos (bom o RISC ajudou muito...). Os problemas que raramente ocorreram foram nada que no pudesse ser resolvido com simples reindexao de arquivo. Bom ai quem gosta de horas-extras em CPD vai preferir outras tecnologias "modernas"... No dataflex voce trabalha com um registro por vez do arquivo em disco que lido no buffer do arquivo (na memria) e do buffer pra tela, segundo o esquema abaixo: TELA(Campos de entrada ou janelas) buffer do arquivo arquivo disco Quando voce edita ou grava um registro voce esta fazendo isto na tela mas atravs de um comando (entry) que ja tambem edita o buffer e depois no final da entrada ou edio vem a gravao fsica dos dados no HD.

Isto a nvel do usurio muito pratico porque ele vai colocando os dados e apertando enter at receber uma mensagem de confirmao (opcional) e com novo enter grava os dados. As busca por valores so extremamente simples tambm. O usurio preenche uma entrada parcialmente (desde que ele faa parte de um indice) e aperta F8 ou TAB e j vem o registro mais prximo para a tela que esta pronto pra ser editado. Aps a edio de um campo aperta F10 e salva os dados ou aperta F9 e limpa a tela tudo sem a lentido do mouse. Voce j percebeu como lento cadastrar procurando os campos com o mouse? Ou como complicado usar aquelas barras de navegao com inmeros botes, tipo o dbnavigator do delphi? Pro usurio o dataflex permite uma enorme facilidade e desempenho tanto no cadastro, na edio e na busca por registros. Outra vantagem so a versatibilidade da linguagem que permite relatrios de qualquer tipo e tambm grficos na tela ou impressos, alm de leitura e impresso de cdigo de barras. Bom com o decorrer do tempo voce ver como o dataflex uma tima ferramenta com grande produtividade e aceitao pelos usurios!

Captulo 2 - Criando a base de dados O utilitrio para criao e edio de arquivos o DFFILE. Assim o primeiro passo para a criao de um programa verificar quais arquivos ele vai usar e com o dffile imprimir uma listagem de cada arquivo. A listagem de um arquivo impressa (que o .DEF do arquivo) fica mais ou menos assim: ----------------------------------------------------------------------------DATA: 28/05/2002 HORA: 14:50 PAGINA: 1 DEFINICAO PARA O ARQUIVO: PRODUTOS (# 4) ----------------------------------------------------------------------------NOME BASE : PRODUTOS NOME PARA USUARIO : PRODUTOS NOME PARA DATAFLEX : PRODUTOS ----------------------------------------------------------------------------TAMANHO DO REGISTRO : 256 (USADO: 178 ) No. MAXIMO DE REGISTROS : 16711679 (USADO: 12520) COMPRESSAO DO ARQUIVO : Rapida REUTILIZAR ESPACOS EXC. : Sim RELEITURA MULTI-USUARIA : Sim ----------------------------------------------------------------------------NUM NOME DO CAMPO TIPO TAM OFFST IN RELACIONA AO ARQUIVO.CAMP --- --------------- ---- ----- ----- -- --------------------------------1 COD_TIPO NUM 6.0 1 1 TIPOS.CAMPO_1 (2,1) 2 COD_PRODUTO ASC 12 4 1 3 DESC_PRODUTO ASC 40 16 2 4 FLG_INATIVO ASC 1 56 5 ESTOQUE_ATUAL NUM 6.2 57 6 ESTOQUE_MINIMO NUM 6.2 61 7 ESTOQUE_MAXIMO NUM 6.2 65 8 PRECO_ATUAL NUM 8.2 69 9 PRECO_MINIMO NUM 8.2 74 10 VALOR_IPI NUM 4.2 79 11 EMBALAGEM ASC 10 82 12 UNIDADE ASC 20 92 13 CONSER ASC 9 112 14 PESO_LIQ NUM 4.4 121 15 COD_FISCAL ASC 14 125 16 DT_CAD DAT 3 139 17 DT_ULT_ALT DAT 3 142 18 QUANT_PEND NUM 6.2 145 19 COD_INT NUM 10.0 149 4 20 REF_INT ASC 15 154 21 FLG_IMPORTADO ASC 1 169 22 FORN1 NUM 6.0 170 23 FORN2 NUM 6.0 173 24 FORN3 NUM 6.0 176 INDIC# CAMPOS DES MAI TAMANHO NIVEIS SEGMENTO MODO ------ --------------- --- --- ------- ------ -------- ------1 COD_TIPO Nao Nao 18 5 2 On line COD_PRODUTO Nao Nao 2 COD_TIPO Nao Nao 46 DESC_PRODUTO Nao Nao 7 3 On line

RECNUM 3 4

Nao Nao 15 8 5 5 2 2 On line

COD_PRODUTO Nao Nao RECNUM Nao Nao COD_INTER Nao Nao RECNUM Nao Nao

On line

Bem acima est a data e hora de criao do arquivo. Depois vem sua posio no FILELIST que um numero que corresponde geralmente a ordem de criao do arquivo e que o dataflex utiliza internamente, junto com o numero do campo. Com relao aos campos temos o numero do campo que sequencial, depois o nome do campo, depois o tipo do campo, seu tamanho, a posio, o indice a qual ele faz parte e finalmente a qual outro campo de outro arquivo que ele est relacionado. O Filelist mais ou menos assim: 1 - Produtos - arq001 2 - Unidades - arq002 3 - Embalagens - embs01 etc... Existem os seguintes tipos de campos de arquivo: ASCII - alpha-numrico ou string ate 255 caracteres NUM - numricos que pode ser inteiro ou ponto flutuante. Exemplo: COD_INT NUM 10.0 inteiro de dez dgitos tipo 1020400231 PRECO_ATUAL NUM 8.2 float de 8 dgitos na parte inteira e 2 DATE - campos para data no formato "dd/mm/aaaa" TEXT - campo para texto sem formatao (na verso 2.3 no existe) BLOB - campo para grandes objetos tipo fotos (na verso 2.3 no existe) OVERLAP - campo de juno de campos usado para diminuir o tamanho de indices Logo depois dos campos vem as informaes sobre indices. No caso acima o indice 1 exclusivo porque no aparece nele o recnum. Quando voce deseja tirar a exclusividade de um indice acrescente no final dele o recnum. RECNUM um campo tipo numero inteiro (>0) que corresponde geralmente a ordem de criao do registro, tipo o primeiro registro gravado tem recnum= 1 o segundo registro gravado tem recnum= 2 e assim por diante. O recnum um campo que sempre existe num arquivo e tem valor exclusivo. Mesmo se um arquivo for criado sem indices o recnum pode ser usado como indice. Quando voce deleta um registro aquele recnum reutilizado pelo dataflex numa futura insero de registro. Em arquivos onde no se deleta registros o recnum pode ser usado como um cdigo sequencial exclusivo. Bom falamos no caso do arquivo j estar criado. Se no existir o arquivo que voce quer muito fcil cria-lo usando o DFFILE, porque ele um utlitario que cria tudo passo a passo sem codificao. Recomendaes: 1-Use nome de campos claros tipo COD_PRODUTO e nao CPR, vai te facilitar a vida e dos outros programadores.

decimais tipo 12560,50

2-Use o mesmo nome do campo em diferentes arquivos, exemplo: PRODUTOS.COD_PRODUTO e MOVIMENTOS.COD_PRODUTO pois tambm facilita! 3-Procure colocar os campos principais que faro parte do indice principal no comeo do arquivo na mesma ordem que vo aparecer no indice. 4-Evite indices com muitos campos grandes, use overlaps. 5-Crie indices inteligentes e s os crie na medida da necessidade. 6-No duplique informao desnecessariamente gravando a mesma informao em dois arquivos, normalize os arquivos. 7-No crie muitos indices exclusivos prefira indices no exclusivos. 8-Lembre que o FILELIST comporta 255 arquivos no crie arquivos desnecessariamente. 9-Crie os arquivos que no existem, imprima as definies de todos os arquivos que sero abertos no programa e s ai comece a programar.

Captulo 3 - Telas de um programa dataflex (procedural) //************************************** //programa P-001 //sistema: agencia de empregos //finalidade: cadastro de profissionais //feito por Paulo Miranda 17/01/2003 //atualizado por Simone 25/02/2003 //************************************** /Tela1 Codigo: _________. Nome: __________________________________________________ Endereco: __________________________________________________ Cidade: ___. _____________________________ CEP: _________ Data Nasc: __/__/____ UF: __

Anos: _.

Res: (__.) _________ RG: _______________

Cel: (__.) _________ CIC: _______________

E-mail: __________________________________________________ Profissao: ___. __________________________________________ Salario Pretendido: _______.__ /Telamens ___________________________________________________ _ /Aviso Este um exemplo de tela sem janelas... /* //****Exemplo de comentrio em Dataflex**** Acima temos o exemplo da declarao de 3 telas em dataflex. Observe que o nome da tela deve comear com "/" tipo "/Nome_da_tela". A primeira etapa desenhar as telas, claro que d pra caprichar mais do que no exemplo acima e fazer sombra, contorno e se for modo grfico ento nem se fala. Todo programa comea com as telas e depois vem o simbolo "/*" colocado sempre totalmente a esquerda e depois das telas pra iniciar o cdigo. Janelas so chamados os locais de entradas de dados (diferente de janela no windows). Por exemplo "____.__" uma janela para entrada numrica de 4 inteiros e dois decimais. Tipos de janelas: ASCII: ______________________ So para entradas de dados ascii Numricas: _________. Inteiro de 10 digitos no maximo

_________.____ Float de 10 digitos e 4 decimais ___,___.__ Float formatada Datas: __/__/____ Para entrada de datas tipo dd/mm/aaaa Observe que uma boa prtica dimensionar a janela com o mesmo tamanho e tipo do campo de arquivo. Mais tarde voce vera como conectar a janela com seu campo de arquivo respectivo. Quando voce cria uma tela as janelas tem nomes padro que depois podero ser redefinidos. A nomenclatura funciona assim: TELA1.1 seria o codigo TELA1.2 a primeira janela que corresponde ao nome. TELA1.3 o endereo TELA1.4 a terceira janela da direita pra esquerda e de cima pra baixo que coresponderia ao codigo da cidade TELA1.5 corresponderia ao nome da cidade TELA1.6 seria a UF ou estado E assim sucessivamente seguindo a regra: Nome_da_tela.indice_janela Teriamos Telamens.1 e Telamens.2 na outra tela. Obseve que nem todas telas tem janelas (pode ser uma tela apenas pra help ou aviso) mas toda janela tem que estar definida numa tela. Quando o usurio estiver usando o programa ele inserir uma informao numa janela em seguida apertar ENTER e o cursor vai pr janela seguinte pra nova entrada, isto veremos melhor depois. IMPORTANTE: O simbolos "/" sempre deve estar encostado no inicio da linha quando se referir a nome de tela ou "/*" inicio de programaao. Recomendaes: 1-Capriche no layout das telas e procure seguir padres que seus usuarios ficaram satisfeitos. Evite telas muito carregadas de janelas e tambm evite programas com muitas telas pra entrada de dados. No proximo captulo veremos um pouco de cdigo, calma...

Capitulo 4- Comeando a programar No capitulo anterior fizemos as telas do nosso primeiro programa. Agora vamos comear a codificar. Logo aps o simbolo "*\" comearemos cdigo: /* //=======[ Inicio da Programao ]=========== // Usa-se barra barra para comentrio! //=======[ Includes de arquivos ]============ #include biblioteca.inc #include fmar.inc //=======[ Page set das telas ]============== page set tela1 at 04 03 colors 05 15 page set telamens at 20 00 page set aviso at 06 15 //======[ Abertura de arquivos ]============= open "empregados" as empregados //***[ Cadastro dos candidatos para vagas open "cidades" as cidades //***[ Cadastro das cidades open "profissoes" as profissoes //***[ Cadastro das profisses At aqui parece que d pra entender no ? INCLUDE para incluir bibliotecas com seus prprios comandos. Falaremos como criar comandos depois. PAGE SET o comando que posiciona a tela no vdeo. Aqui estamos usando modo texto de 80 colunas X 25 linhas. OPEN pra abrir o arquivo e AS opcional. Depois vem: //======[ Names das janelas ]================ name tela1 cod_candidato nome_candidato endereco cod_cidade ; desc_cidade sigla_estado cep data_nasc name idade ddd_res tel_res ddd_cel ; tel_cel RG CIC e_mail name cod_profissao desc_profissao salario name telamens mens resp Esta parte de names opcional mas bom sempre colocar, procurando colocar o nome da janela igual o nome do campo de arquivo. Observe que isto ir facilitar a programao mas a janela pode ter o nome que voce quizer menos nome de comando ou palavras reservadas do dataflex. Se voce bom observador precebeu que coloquei name tela1 na primeira linha e depois acaba com ponto e vrgula. O ponto e virgula pra string no dataflex continuar na outra linha. O comando name aceita uma string com um mximo de 255 caracteres por isso depois eu coloco outro NAME pras prximas janelas pra no estourar o tamanho da string de comando, observando que no repito o nome da tela porque o dataflex entende que estou me referindo a tela1. Se eu no colocar names nas janelas quando precisar inserir uma janela ser necessrio varias alteraes no programa. Observe: Se no tenho names os nomes padro ficam tela1.1, tela1.2, tela1.3 at tela1.19. Imagine que eu queira inserir uma nova janela entre tela.4 e tela.5, esta janela passar a ser a tela.5, a tela.5 passa ser a tela.6 e assim por diante. Como no dataflex muitos comandos fazem referencias a nomes de janelas se eu tiver muito cdigo no

programa precisarei fazer muitas alteraes porque na insero da tela.5 nova todas as janelas seguintes mudaram seu names. Ento USE SEMPRE NAMES! Vamos continuar com nosso programa exemplo: //=========[ definio de variaveis ]========= integer num cont number valor preco_unitario string linha letra 1 frase 20 ; outra_linha date data data2 indicator ok existe //============================================ TIPOS DE VARIAVEIS NO DATAFLEX: INTEGER - Numero inteiro positivo ou negativo na faixa de +/- 2,147,483,647. NUMBER - Numero com ponto flutuante tipo o float do C. STRING - String de tamanho padro 80 caracteres se voce cita o comprimento depois do nome da string voce redefine este valor, observe que no existe o tipo char ento quando se usa uma string de tamanho 1 como um char. Ex: string letra 1 DATE - Data no formato dd/mm/aaaa. O dataflex suporta todas operaes com datas, tipo somar data com inteiro e outras. INDICATOR - o tipo booleano de valor FALSE ou TRUE, so de grande utilidade no controle do fluxo do programa. No proximo captulo veremos laos e comandos bsicos no dataflex.

Capitulo 5 - Laos, indicadores, operadores lgicos e mais alguns comandos No dataflex como toda linguagem de programao que se preze existem laos, antes porm vamos dizer mais sobre indicadores, que so importantes controladores de fluxo nos programas. Declaramos indicadores assim: INDICATOR meu_indicador outro_indicador Pra mudar seu valor (quando criado esta falso) usamos o comando indicate: INDICATE meu_indicador TRUE INDICATE outro_indicador FALSE Podemos atribuir o valor de um indicador ao valor do outro: INDICATE meu_indicador AS [ outro_indicador ] na sentena acima o valor de meu_indicador (true ou false) ser o mesmo do valor de outro_indicador. No exemplo acima meu_indicador ser false aps a sentena porque ele copiou o valor de outro_indicador que era false. Ou atribuimos indicadores comparando de outras formas: INDICATE dados_ok AS resp.1 EQ "S" INDICATE salario_certo AS salario LE 300 Podemos usar tambm INDICATE outro_indicador AS [ ~meu_indicador ] que o simbolo "~" significa NOT e no caso acima outro_indicador recebe o valor oposto de meu_indicador ou not meu_indicador. No programa o indicador aparece entre colchetes tipo [ MEU_INDICADOR ] quando esta controlando blocos de cdigo, laos, ou depois do AS. Falaremos deles muito mais vezes no se preoculpe. Mas observe que um indicador SEMPRE contm um valor que falso (false) ou verdadeiro (true). INDICADORES ANTES DE COMANDOS: [ meu_indicador ] comando_x [~meu_indicador ] comando_y Se meu_indicador estiver true s o comando_x ser excutado caso contrrio s o comando_y ser executado. INDICADORES ANTES DE BLOCOS DE COMANDOS: [ meu_indicador ] BEGIN comando_x comando_y [ outro_indicador ] BEGIN comando_z comando_k END END INDICADORES COMBINADOS: [ meu_indicador outro_indicador ] comando_k [ meu_indicador ~outro_indicador ] comando_w [~meu_indicador ] comando_x

Podemos combinar inmeros indicadores mas o usual usar uns 2 ou 3 no mximo numa sentena pra evitar uma programao confusa e ilegvel. Voce acabou de ver tambm que os blocos de comando so delimitados por BEGIN e END como no pascal. Vamos aos operadores lgicos agora: EQ o igual (= no pascal e == no C) NE o diferente ( no pascal e != no C) LT o menor (=) NOT a negao e tambm representado por ~ dependendo do caso. OR o ou (or no pascal e || no C) Obs: infelizmente o AND no exite e tem que ser feito com if ou indicadores. O comando MOVE usado pra mover valores pra vriveis, janelas e campos de arquivos. bom frisar que uma grande vantagem do dataflex que podemos mover dados de inmeras formas, como por exemplo variavel pra uma janela, somar variavel com campo de arquivo, somar janela data com inteiro, e muito mais. Sintaxe do move: MOVE valor TO variavel MOVE valor TO janela MOVE valor TO arquivo.campo Exemplos: MOVE TELA1.1 TO CODIGO MOVE PRECO TO MENS MOVE 10201 TO CLIENTES.CODIGO MOVE "PAULO" TO TELA.2 MOVE TELA.1 TO TELA.2 MOVE PRODUTOS.COD_PRODUTO TO MOVIMENTOS.COD_PRODUTO MOVE "" TO TELA.3 Agora os LAOS: (1) IF - pode ser usado de vrias formas mas sua lgica IF comando sua traduao se a condiao for verdadeira executado o comando. exemplos: IF numero LT 10 BEGIN END ELSE BEGIN END IF numero GE 10 IF numero LE 30 comando_x OBS: Podemos usar no mximo 3 ifs por sentena tipo if condio1 if condio2 if condio3 comando_ou_bloco (2) REPEAT ... UNTIL repete comandos at a condio ser verdadeira

exemplos: REPEAT comando_x comando_y UNTIL [ MEU_INDICADOR ] REPEAT comando_z UNTIL numero LE 10 (3) FOR ... LOOP exemplos: FOR num FROM 1 TO 50 comando_x comando_y comando_z LOOP FOR valor FROM 20 DOWN 0 STEP 2 LOOP down significa que esta decrescendo e step o valor que a vriavel de controle decrementada (o default 1) FOR num FROM 0 TO 100 STEP 10 LOOP se dentro do for forarmos a variavel de controle chegar no valor limite isto uma forma de sair do for. Ex acima: move 100 to num (4) WHILE .. LOOP exemplos: WHILE [ indicador ] comando_x comando_y LOOP WHILE valor1 LT valor2 LOOP (5) REPEAT .. LOOP este o lao infinito. (6) GOTO Label um recurso que existe mas deve ser usado com cuidado, procure usar os outros laos que daro mais legibilidade e coerencia para os seus programas. exemplos: LB_INICIO:

IF resp EQ "N" GOTO LB_INICIO (7) CASE usado da mesma forma que o switch do C ou case do pascal Exemplo: CONDITIONAL CASE MES EQ 1 CASEEND CASE MES EQ 2 CASEEND CASE MES EQ 3 CASEEND CASEELSE CASEEND CONDITIONALEND (8) ON variavel_inteira GOSUB sub1 sub2 sub3 ... se a variavel inteira contm 1 vai pra rotina sub1 se contm 2 vai pra segunda rotina e assim por diante. (9) ON variavel_inteira GOTO label1 label2 label3 ... Mesma coisa do on gosub s que com desvio em vez de sub-rotina. Evite usar... No prximo capitulo veremos mais comandos... no entrei em detalhes nos laos porque voce deve te-los visto em outras linguagens espero.

Capitulo 6 - Mais comandos dataflex (os mais usados) ABORT - este comando termina um programa dataflex e volta pro programa pai que pode ser um menu dataflex, outro programa ou o sistema operacional. ACCEPT - aceita uma entrada de tecaldo numa janela, a entrada terminada com o pressionamento da tecla enter. Exemplo: name telamens mens resp inicio: move "Dados corretos para gravar? (S/N)" to mens //mosta a mensagem move "S" to resp //valor padro da resposta accept resp {Capslock,check="SN"} //opa isso de capslock falaremos depois if resp eq "N" goto inicio abort //fim do programa APPEND - appenda uma string ou mais na primeira. Ex. append str tela.10 str2 cliente.nome AUTOPAGE - pra poder dar entry's sem precisar citar a janela, mas segue a ordem das janelas. EX: autopage tela1 entry produtos.cod_tipo entry produtos.cod_produto entry produtos.desc_produto ... ASCII - usa-se ascii str to var_int, isto , obtem o valor inteiro de um caracter ascii e guarda-o numa varivel. Veja CHARACTER. BACKFIELD - faz o cursor voltar pra janela anterior. BLANKFORM - limpa tela, janela, ou intervalo de janelas (usa c/THRU).Ex: blankform tela1 //limpa todas janelas da tela1 blankform tela1.1 //limpa 1 unica janela blankform tela.5 THRU tela.10 //limpa 6 janelas obs: se usar CLEARFORM sero limpas as janelas mas os caracteres "_" sero mantidos. CALC - executa um calculo no destino pra uma fonte. Exemplos: calc ( (10.23 * tela.1) + (arquivo_taxas.IPI * valor ) / taxa ) TO tela.2 calc (10 + tela.5) to tela.5 CHARACTER - var_int to str. Obtem o caracter ascii correspondente ao inteiro e quarda-o numa variavel string.

CIC_CHECK, CGC_CHECK testam a validade do cic e do cgc e devovlvem o resultado em ERR = true se invlido, ERR = false se vlido. Ex: repeat entry clientes.cgc cgc cgc_check cgc until [~err] CLEAR - limpa o buffer de arquivo. CLEARFORM - veja blankform. CLEARSCREEN - limpa a tela de video. CMDLINE - pega parametros do programa pai ou chamador, exemplo: string programa move "" to programa append programa "filho " cod_cliente " " data_cad " " cgc_cli cmdline cod_cli cmdline data_cadastro cmdline cgc_cliente OBS: as variaveis que vo receber os parametros precisam ser do mesmo tipo do parametro passado pelo pai ou chamador. COPYFILE TO , copia o arquivo. CURRENT_WINDOW - varivel inteira interna do dataflex que guarda o valor da janela corrente. CURRENT_IMAGE - varivel inteira interna do dataflex que guarda o valor da imagem (tela) corrente. DISPLAY - sintaxe: display to janela. Mostra o conteudo do campo com formataes diferentes do entry. (signrt,fill,float$,etc) ENTDISPLAY - mostra os campos nas janelas com entrys, geralmente aps uma busca. Ex: entry produtos.codigo codigo entry produtos.desc desc entry produtos.val_unit val_unit findkey eq produtos by index.1 ; for produtos.codigo eq 11135 [ found] entdisplay produtos ENTERMODE - impede o cusor de voltar pra janelas anteriores a sua chamada. Este comando no deve ser usado no meior de entrys.

ENTRY - opa este um comando importante que mostraremos com detalhes nos prximos captulos. Ele faz a ligao da janela com o campo de arquivo. Ele da um accept e joga o valor da janela no buffer. usado na macro enter ou entergroup, nunca fora delas! Exemplo: ENTRY Produtos.Cod_produto Cod_produto ENTRY Clientes.Nome Tela1.4 {Capslock} DELETE - deleta o registro no buffer, se no tiver registro mostra erro. Usa-se delete nome_arquivo DIRECT_INPUT - abre um arquivo texto ou dispositivo pra leitura.CLOSE_INPUT fecha. DIRECT_OUTPUT - abre um arquivo texto ou dispositivo pra escrita.CLOSE_OUTPUT fecha. ENTAGAIN - impede que o cursor avance de janela. ENTER - macro enter, proporciona um ambiente completo de entrada de dados, ser vista em breve. ENTERGROUP - ser vista posteriormente. ERASEFILE - deleta arquivo, usa-se erasefile ERR - indicador pr-definido do dataflex setado por alguns comandos. ERROR - Da uma mensagem de erro pro usurio com numero e com beep. Ex: error 200 "Codigo invalido!" FIELDINDEX - funciona igual windowindex s que pra campo de arquivo. Ex: arquivo: campo1 campo2 ... campoN usa-se: for fieldindex from 0 to (N-1) move valor to arquivo.campo1& //usa-se "&" pra acessar loop FIND, FINDKEY, SEARCHKEY - So comandos de busca de registros no dataflex que setam found e finderr aps a busca ser efetuada Exemplos: (1) move "P" to clientes.nome //inicializa a chave find gt clientes by index.2

[ found ] move clientes.codigo to tela1.3 vai mostrar o prximo nome c/valor maior que "P",por exemplo "Patricia Souza" find pode ser find gt, find ge, find le, find le (2) findkey eq produtos by index.1 ; for produtos.cod_tipo eq 10202 ; produtos.cod_produto eq "1166665P" findkey usado quando o indice exclusivo e todos campos esto preenchidos (3) searchkey ge produtos by index.4 ; comparing produtos.cod_inter eq cod_inter searchkey usado para indices no exclusivos FINDERR - indicador pr-definido que indica se foi achado registro numa busca. Se no acho finderr = true. Juntamente com o found setado aps um comando de busca em arquivo (find,findkey,searchkey). FOUND - indicador pr-estabelecido que indica se foi achado registro ou no aps um comando de busca tipo find, findkey, searchkey etc. Quando chega no final do arquivo de dados o found = false e finderr = true. FORMFEED - faz a impressora avanar de folha. GOSUB - subrotinas so muito boas pra dar legibilidade e facilitar a manuteno dos seus programas, infelizmente na verso 2.3 elas no retornam valores, devendo trabalhar sempre com variveis do tipo global declarados no inicio do seu programa. Exemplo: GOSUB Calcula_media ABORT //===[ Subrotinas ]==== Calcula_media: RETURN Observe que o comando RETURN volta pro ponto logo a seguir a chamada da subrotina com GOSUB. GOTOXY - Poe o cursor numa posicao na tela, tipo gotoxy 10 15 GRAPHIC ON/OFF - Entra / sai do modo grfico. LEFT, RIGHT e MID - movem parte de dados de um local pra outro. Exemplo: integer dia mes ano string strdata 10 move clientes.data_cadastro to strdata right strdata to ano 4 mid strdata to mes 2 4 left strdata to dia 2 Peceba que left e right usa-se com um parametro que o tamanho a ser movido e mid tem dois parametros um o tamanho e o segundo a posio de inicio pra mover. So comandos muito uteis.

IFCHANGE - indicador predefinido que indica se houve alterao. Ex: ifchange tela1.1 begin end INCREMENT - incrementa de 1 uma variavel inteira. Ex: increment num O contrrio de DECREMENT que decrementa uma varivel inteira. IN - indica se uma substring contida na string. EX: string uf 2 regiao if uf in "SPxRJxESxMG" move "SUL" to regiao INKEY - captura uma tecla do teclado sem precisar apertar enter. Ex: string letra 1 inkey letra if letra eq "R" gosub relatorio INKEY$ - usado pra capturar teclas em loops, sem parar o loop, bom pra por em loops muito demorados pro usuario poder abortar se quizer.Ex: string letra 1 repeat inkey$ letra if letra eq "A" abort until [ found ] INSERT - insere uma substring numa string numa posio determinada. Ex. insert substr IN str AT 04 KEYCHECK - verifica se uma tecla foi pressinada, usado em loops. Ex: repeat until keycheck KEYPROC OFF/ KEYPROC ON - desabilita ou habilita as keyprocs. LENGTH - retorna o tamanho de uma string. Ex: For num from 1 to length(str) MOVESTR, MOVE - so comandos usados pra mover dados. S que o movestr move exatamente o dado sem formatalo. OPEN e OPEN .. AS - abre arquivo pra leitura/gravao. Se usarmos file_mode podemos abrir s pra leitura. EX: open "C:\bdados\meu_arq" as meu_arq file_mode read_only //==s leitura

OUTFILE - prepara um arquivo ou dispositivo pra ser a saida padro, fecha com OUTCLOSE. Ex: outfile "arquiv1.txt" outfile "LST:", pra impressora OUTPUT - manda uma tela pra saida padro que pode ser redirecionada. Ex: outfile "LST:" output tela1 //imprime a tela1 outclose PAGE - mosta uma tela no video, esta embutido em comandos como accept e entry. Ex: page telamens PAGESET - ajusta uma tela no video. Ex: page set tela1 at 05 06 colors 10 11 o colors opcional. PAUSE - faz uma pausa no programa esperando digitao e mostrando uma mensagem pro usurio. Ex: pause "Pressione tecla para continuar..." POS - posicao de uma substring numa string tipo pos substr in str to num, o pos seta o indicador found tambm. (found = true se achou) PRINT - opo de mover pra janela com formatao. Ex: print tela.1 to tela.1 {fill="0"} //proximo capitulo t explicado REPLACE - muda o valor de uma substring numa string por outra string, e devolve o valor de found = true se achou a substring e found = false se no a achou. Exemplos: move "paula" to str replace "a" in str with "o" //resulta str="poula" move "paula" to str while [ found ] replace "a" in str with "o loop //resulta str= "poulo" move "paula" to str replacle "pau" in str with "" //resulta str="la" REPORT - macro report proporciona grande facilidade pra relatrios, ser estudada c/detalhes posteriormente. REREAD - rele o buffer de registro do arquivo. RETURN - volta de um gosub, se usarmos RETURN RETURN volta da subrotina e da rotina que chamou aquela subrotina (2 nveis). ROUND - arredonda o valor da expresso.

RUNPROGRAM - excuta um outro programa externo e no dataflex e volta se for acompanhado de WAIT.Ex: string programa move "edit arquivo.txt" to programa runprogram programa, executa o edit e sai runprogram wait programa, executa o edit e volta Se for programa dataflex use CHAIN com ou sem WAIT move "cad001" to programa chain programa chain wait programa SAVE - salva o registro no buffer, e move os dados do arquivo principal pros arquivos relacionados secundrios salvando-os em seguida. Nunca use save dentro da macro enter ou entergroup, pois os dados no foram ainda movidos pro buffer. Use-o fora depois do enterend ou depois do endgroup. SAVERECORD - salva o regitro no buffer mas no caso de arquivos relacionados no move os dados do arquivo principal pros arquivos relacionados secundrios. Ex: SAVERECORD CLIENTES No use saverecord dentro de macro enter ou entergroup pelo mesmo motivo do comando save. SCREEMMODE - ajusta o modo de video. Ex: screenmode 31 SEQEOF - indicador pr definido que indica final de arquivo texto. repeat readln linha ... until [ seqeof ] SHOW e SHOWLN pra mostrar uma mensagem direto na tela sem janelas. STATUS - indica se existe registro no buffer do arquivo. Ex: indicate existe status clientes ou if status clientes begin end SUBTOTAL - comando usado na macro report pra totalizar. Ser visto mais adinate com detalhes. Ex: subtotal body.2 to subtotal1.1 SYSDATE - captura a data e hora do sistema em uma variavel, janela ou campo. formato sysdate [data] {hora} {minuto} {segundo} Ex: sysdate tela.1, sysdate clientes.dt_cadastro hora_cad min_cad SYSTEM - sai para o sistema operacional direto.

TRIM - elimina os espacos em branco de uma string. Ex: trim str to str UPPERCASE - converte pra letras maisculas. Usa-se uppercase str WINDOWINDEX - variavel que contm o indice da janela, seu uso facilita muito a programaao.Ex: /tela1 ___. ___. ___. ___. ___. ___. ___. ___. ___. ___. ___. ___. /* move ( mes - 1 ) to windowindex calc ( valor + tela1.1& ) to tela1.1& Observe que a windowindex tem que ser acessada usando o simbolo "&", no exemplo acima se o mes 5 ele acumula o valor na tela1.5 WRITE e WRITELN - escreve linha em arquivo texto.Veremos exemplo depois. ZEROFILE apaga todos os registros de um arquivo de dados. No prximo captulo veremos formatao de janelas.

Captulo 7 - Formatao de janelas, keyprocs. No dataflex verses 2.3 e 3.0 a integridade dos dados dependente das aplicaes de cadastro. Bons programas de cadastro resultam num bom banco de dados. Claro que voce pode criar uma ferramenta pra atualizar a base de dados mas o ideal os dados serem o mais coerentes possveis j na entrada. ***FORMATAES DE JANELAS *** So usadas aps comandos como entry e accept ou no comando format. Sempre usamos os simbolos "{" e "}" para as formataes, tipo {formatao1,formatao3,...formataoN} DISPLAYONLY - quando a janela s de leitura. O displayonly a combinaco de noenter com noput. Ex. ENTRY PRODUTOS.DESC DESC {DISPLAYONLY} NOENTER - impede um enter na janela mas grava seu valor no buffer. usado quando temos 2 ou mais entrys numa janela, para evitar que o usuario tenha que apertar mais de uma vez a tecla enter numa mesma janela. Ex. ENTRY PRODUTOS.COD_PRODUTO COD_PRODUTO {AUTOFIND,FINDREQ} ENTRY MOVIMENT.COD_PRODUTO COD_PRODUTO {NOENTER} ENTRY NOTAS_FI.COD_PRODUTO COD_PRODUTO {NOENTER} observe que a janela cod_produto esta relacionada com 3 arquivos. NOPUT - impede que o conteudo da janela seja colocado no buffer do arquivo. CAPSLOCK - faz com que tudo que o usurio digite seja convertido pra letras mausculas. Ex. ENTRY CLIENTES.ENDERECO ENDERECO {CAPSLOCK} REQUIRED - impede o cursor de sair da janela sem que o usurio digite algo. Ex: ENTRY CLIENTES.ENDERECO ENDERECO {CAPSLOCK,REQUIRED} CHECK - checa se o conteudo da janela esta contido na string de checagem. Ex. ACCEPT {CAPSLOCK,CHECK="SN"} e resp uma janela ascii de tamanho 1. ACCEPT UF {CAPSLOCK,CHECK="SPxRJxMGxES"} e uf janela de tamanho 2. RANGE - impe um limite inferior e superior. Ex. ACCEPT IDADE {RANGE=18,40} //idade janela _. AUTORETURN - quando o usurio preeche o contedo da janela o cursor pula pra prxima janela, sem precisar apertar o enter. AUTOFIND - usado em janelas associadas a um campo que chave exclusiva, pra quando o usurio digitar e apertar enter se o registro existir j trazido pra tela. Todos os campos do indice devem estar completos. Ex. Exemplo1: (index1 = codigo) ENTRY CLIENTES.CODIGO CODIGO {AUTOFIND} Exemplo2: (index1 = cod_tipo + cod_produto) ENTRY PRODUTOS.COD_TIPO COD_TIPO ENTRY PRODUTOS.COD_PRODUTO COD_PRODUTO {AUTOFIND} Exemplo3: (index3 = bairro + rua + numero + apto) ENTRY CLIENTE.BAIRRO BAIRRO ENTRY CLIENTE.RUA RUA ENTRY CLIENTE.NUMERO NUMERO ENTRY CLIENTE.APTO APTO {AUTOFIND} RESP

Quando o indice exclusivo usado possuir mais de um segmento, a opp autofind deve estar no ultimo campo do ndice. Se usarmos AUTOFIND,FINDREQ ser obrigatrio o usurio entrar na janela com uma entrada que seja existente no arquivo. Observe que o findreq impede o usurio de gravar novos regitros porque ele exige que j exista o registro. Exemplo 4: (index2 = cod_inter + cod_material) ENTRY MATERIAL.COD_INTER TELA.2 ENTRY MATERIAL.COD_MATERIAL TELA.3 {CAPSLOCK,AUTOFIND,FINDREQ} AUTOFIND_GE - sua funo a mesma do autofind s que procura por um valor maior ou igual ao da janela. Ex: Exemplo1: (index1 = nome + sobrenome) ENTRY FUNCIONARIO.NOME NOME {CAPSLOCK} ENTRY FUNCIONARIO.SOBRENOME SOBRENOME {CAPSLOCK,AUTOFIND_GE} FILL - substitui valores em branco. Ex: print hora_in to hora_in {fill="0"} // 09 em vez de 9... FORCEPUT - fora gravar no buffer do arquivo, usado quando por existencia de muitos autofind o valor do campo esta sendo destruido no buffer. FORMAT - usado geralmente pra formatar grupos de janelas. Quando for colocar entry ou accepts em loops use format, porque em loops a formatao individual no funciona. Ex: format tela1.1 thru tela1.10 {capslock} format hora_in {required,range=8,18} for windowindex from 0 to 9 accept tela1.1& //nao adianta formatar aqui que no funciona!!! loop RETAIN - Mantm os dados na janela, mesmo quando apertado o F9 (key.clear). Pra limpar estas janelas preciso apertar duas vezes o F9. RETAINALL - Os dados jamais sero apagados com F9, apenas usando o comando blankform eles podero ser apagados. SKIPFOUND - uma opo que aparece normalmente com um autofind ou autofind_ge. Sua funo se caso seja achado um registro, mostrar os dados na janela e pular pra prxima, sem deixar que ela possa ser modificada. ***KEYPROCS*** Keyprocs so teclas de atalho associadas a labels e indicadores. O dataflex possui teclas de atalho padro que podem ser reprogramadas com o dfsetup. Na verso 2.3 funciona assim: F1 F2 F3 F4 F5 F6 F7 F8 F9 - key.help - ajuda - backwind - tela anteriror - superfind - superbusca - key.print - impresso - key.calculte - executa calculos na janela (5+4 retorna 9) - key.delete - deleta registro - key.user - voce define - key.user2 - voce define - key.clear - limpa tela

F10 - key.save - salvar dados TAB - find - procura PGUP - key.previous - registro anterior PGDOWN - key.next - prximo registro -> - key.right - seta pra direita clintes.cod_cli e existe indice exclusivo de campo nico formado por cod_cli nos 2 arquivos. Quando voce busca um registro no arquivo de notas fiscais (FILHO) j traz o registro corespondente do arquivo de clientes (PAI). USO DE VARIAS MACRO ENTER - As vezes temos programas de ITENS E HEADER (ou itens e cabealho), que so programas que voce cadastra um header e pra ele cadastra vrios itens, em arquivos distintos, tipo o cabealho de uma nota fiscal, que tem a razo social da firma, CNPJ, data, numero nota, endereco, etc. E os items da nota de numero variavel que so os produtos, seus valores unitarios, valores totais, etc. Como no podemos usar vrias macro enter mas apenas uma, fazer este tipo de programa da forma tradicional uma coisa chata. Voce poderia usar a entergroup mas tambm no o ideal. O melhor neste caso trabalhar com dois programas como se fosse um s, usando chain! A voce ficar com uma macro enter pro header, totalmente normal, e o subprograma dos items, com outra macro enter simples. Pro seu usurio vai parecer que um programa s, e maior trabalho passar alguns parmetros do programa chamador pro programa filho... No prximo captulo falaremos sobre a entergroup.

Captulo 10 - A macro entergroup Como vimos no captulo anteriror a macro enter nos fornece muitas comodidades pra fazer cadastros: - O arquivo principal salvo automaticamente - Ela cria um loop pra cadastrar o prximo registro - Existem sub-rotinas prontas pra serem usadas: entry.find, enter.save, enter.delete e outras. - As teclas de funo funcionam automaticamente, tipo: F10 - salva registro F6 - deleta registro F9 - limpa a tela PGDOWN - proximo registro PGUP - registro anterior TAB - super-busca etc. Todavia em certas ocasies mais conveniente o programador definir estes procedimentos ele prprio, e isto que faz a ENTERGROUP: permite mais liberdade ao programador ao custo de mais cdigo. Outra diferena da entergroup que ela pode aparecer vrias vezes num programa, ao contrrio da macro enter que s pode ser usada uma nica vez no programa. Sintaxe: ENTERGROUP entry arquivo.campo_1 janela_1 {formatao} entry arquivo.campo_2 janela_2 {formatao} ... entry arquivo.campo_N janela_N {formatao} ENDGROUP ENTERGROUP ENDGROUP Refazendo o exemplo do capitulo anterior com a entergroup teramos: /* //=======[ Inicio da Programao ]=========== //=======[ Includes de arquivos ]============ #include biblioteca.inc //=======[ Page set das telas ]============== page set tela1 at 04 03 colors 05 15 page set telamens at 20 00 page set aviso at 06 15 //======[ Abertura de arquivos ]============= open "empregados" as empregados //***[ Cadastro dos candidatos para vagas open "cidades" as cidades //***[ Cadastro das cidades open "profissoes" as profissoes //***[ Cadastro das profisses

//======[ Names das janelas ]================ name tela1 cod_candidato nome_candidato endereco cod_cidade ; desc_cidade sigla_estado cep data_nasc name idade ddd_res tel_res ddd_cel ; tel_cel RG CIC e_mail name cod_profissao desc_profissao salario name telamens mens resp //=========[ definio de variaveis ]========= integer ultimo date data //=========[ page das telas ]================= //Page tela1 no necessario pq o entry da page automatico Page telamens //=========[ label de inicio ]================ Lb_inicio: clearform tela1 gosub acha_ultimo move (ultimo + 1) to cod_candidato //=========[ inicio da entergroup ]========== repeat // PRECISO FAZER O LOOP INFINITO C/ REPEAT ... LOOP //OBSERVE QUE NA MACRO ENTER ISTO NAO PRECISA entergroup clear empregados blankform telamens entry empregados.codigo cod_candidato {autofind,range=1000,50000}

if cod_candidato gt (ultimo+1) move (ultimo+1) to cod_candidato entry empregados.nome nome_candidato {capslock,required} entry empregados.endereco endereco {capslock,required} entry cidades.cod_cidade cod_cidade {autofind,findreq} gosub entry.find entry empregados.cod_cidade cod_cidade {noenter} entry cidades.desc_cidade desc_cidade {displayonly} entry empregados.uf sigla_estado {capslock,check="SPxRJxMG"} entry empregados.cep cep gosub cep_mask entry empregados.data_nasc data_nasc {required} sysdate data calc (( data - data_nasc ) / 365.25 ) to idade entry empregados.idade idade {noenter} entry empregados.ddd_res ddd_res

entry entry entry entry

empregados.tel_res tel_res empregados.ddd_cel ddd_cel empregados.tel_cel tel_cel empregados.rg rg cic

repeat entry empregados.cic cic_check cic until [~err] entry entry gosub entry entry

empregados.email email {capslock} profissoes.cod_profissao cod_profissao {autofind,findreq} entry.find empregados.cod_profissao cod_profissao {noenter} profissoes.desc_profissao desc_profissao {displayonly} {range=250,5000}

entry empregados.salario salario print salario to salario endgroup

move "Dados corretos para gravar? (S/N)" to mens move "S" to resp accept resp {capslock,check="S/N"} if resp eq "S" begin saverecord empregados // PRECISO SALVAR AGORA!!! clearform tela1 gosub acha_ultimo end loop //========[ subrotinas do programa ]============ entry.find: //AGORA UMA ROTINA NORMAL... PODE TER QUALQUER NOME findkey eq cidades by index.1 for; cidades.cod_cidade eq cod_cidades [ found ] move cidades.desc_cidade to desc_cidade findkey eq profissoes by index.1 for; profissoes.cod_profissao eq cod_profissao [ found ] move profissoes.desc_profissao to desc_profissao return acha_ultimo: clear empregados move 99999999 to empregados.codigo find lt empregados by index.1 [ found ] move empregados.codigo to ultimo [~found ] move 0 to ultimo clear empregados

return cep_mask: string str 9 letra 1 integer num //mesmo definindo aqui so variveis GLOBAIS! move "" to str for num from 1 to ( length(cep)) mid str to letra 1 num if letra ge "0" if letra le "9" append str letra loop for num from 1 to ( 8 - length(str)) insert "0" in str at 1 loop insert "-" in str at 6 move str to cep return //========[ definio das keyprocs ]============ Keyproc key.escape abort Keyproc key.clear return lb_inicio Keyproc key.save entagain return Keyproc key.delete move "Deseja deletar o registro? (S/N)" to mens move "N" to resp accept resp {capslock} if resp eq "S" begin delete empregados return lb_inicio end entagain return //========[ fim do programa ]=================== Neste exemplo no seria sensato usar a entergroup, pois perderiamos muitas facilidades da macro enter sem ganho algum. Mas em alguns casos sua aplicao necessria: Imagine uma situao que voce faz vrias buscas num mesmo arquivo em janelas de uma mesma imagem, como por exemplo, no caso abaixo que eu tenho 3 fornecedores por produto e eu desejo cadastrar estes fornecedores no arquivo de produtos: /tela produto: _________. _______________________

Fornecedor 1: ___. _______________________ Fornecedor 2: ___. _______________________ Fornecedor 3: ___. _______________________ _________________________________________ _ /* open fornecedores open produtos name tela cod_produto desc_produto forn1 desc1 ; forn2 desc2 forn3 desc3 mens resp repeat clear produtos blankform mens blankform resp entergroup entry produtos.cod_produto cod_produto {autofind,findreq} entry produtos.desc_produto desc_produto {displayonly} entry produtos.forn1 forn1 {noenter}//pra se j existir entry produtos.forn2 forn2 {noenter}//fornecedores entry produtos.forn3 forn3 {noenter}//cadastrados gosub mostra_cadastrados //tipo um entry.find endgroup entergroup entry fornecedores.cod_forn forn1 {autofind,findreq} entry fornecedores.desc_forn desc1 {displayonly} entry produtos.forn1 forn1 {noenter} //grava no buffer endgroup entergroup entry fornecedores.cod_forn forn2 {autofind,findreq} entry fornecedores.desc_forn desc2 {displayonly} entry produtos.forn2 forn2 {noenter} endgroup entergroup entry fornecedores.cod_forn forn3 {autofind,findreq} entry fornecedores.desc_forn desc3 {displayonly} entry produtos.forn3 forn3 {noenter}

endgroup move "Dados corretos para gravar? (S/N)" to mens move "S" to resp accept resp {capslock,check="SN"} if resp eq "S" begin saverecord produtos //pecisa salvar!!! clearform tela end loop key.escape abort mostra_cadastrados: for windowindex from 0 to 4 step 2 findkey eq fornecedores by index.1 for; fornecedores.cod_forn eq forn1& [ found ] move fornecedores.desc_forn to desc1& [~found ] blankform forn1& thru desc1& loop return Observe que este programa no funcionaria bem com a macro enter porque quando buscassemos um fornecedor pelo cdigo todas as outras janelas de codigo de fornecedores apresentariam valores iguais, ou seja, se o forn1 fosse 1001 o forn2 e forn3 apareceriam 1001 tambm, que um efeito indesejvel nesta situao. Lembre que queremos 3 fornecedores diferentes! Na entergroup a busca de um bloco no interfere no outro mesmo que se refiram ao mesmo arquivo. Um outro uso comum da entergroup em seleo de dados pra relatrios como veremos mais pra frente. No proximo captulo veremos a macro report.

Captulo 11 - A macro report Do mesmo modo que a macro enter nos fornece vrias facilidades para cadastros a macro report vai facilitar muito a criao de relatrios simples ou complexos. Mas tambm poderemos fazer relatrios sem usar a macro report, escrevendo muito mais cdigo... Do mesmo modo que a macro enter a report aparece uma nica vez no programa. Sintaxe: OUTFILE "LST:" //redireciona saida pra impressora CLEAR arquivo //sempre aparece //INICIALIZAAO OPCIONAL DO ARQUIVO //move valor1 to arquivo.campox //move valor2 to arquivo.campoy REPORT arquivo BY index.n { BREAK campox, campoy, ... campon } [ SELECT ] INDICATE SELECT AS... [ SELECT ] INDICATE SELECT AS... [~SELECT ] RETURN END.OF.REPORT INDICATE SELECT AS... [ SELECT ] INDICATE SELECT AS... SECTION HEADER OUTPUT HEADER SECTION SUBHEADERX OUTPUT SUBHEADERX SECTION SUBHEADERY OUTPUT SUBHEADERY SECTION BODY OUTPUT BODY SECTION SUBTOTALX SECTION SUBTOTALX SECTION SUBTOTALY SECTION SUBTOTALY SECTION TOTAL OUTPUT TOTAL REPORTEND FORMFEED //Geralmente aparece aqui, pra saltar de pgina OUTCLOSE //Geralmente aparece tambm

A macro report composta por sections opcionais: SECTION HEADER - o cabecalho da pgina, impresso a header toda vez que iniciamos uma nova pgina. SECTION SUBHEADER1 - impressa toda vez que o primeiro campo do indice inicia. SECTION SUBHEADER2 - impressa toda vez que o segundo campo do indice inicia. SECTION BODY - impressa a cada novo registro. SECTION SUBTOTAL1 - impressa quando ocorre quebra no indice1. SECTION SUBTOTAL2 - impressa quando ocorre quebra no indice2. SECTION FOOTER - o rodap de cada pagina. SECTION TOTAL - Aparece no final do relatrio, s na ltima pgina. OBS1: Observe que como um indice tem at nove campos no mximo podemos ter at a SUBHEADER9 e SUBTOTAL9 num relatrio. OBS2: Para cada section declarado (opcionalmente) deve haver obrigatoriamente uma tela correspondente com o mesmo nome! Ex. Section Body ==> /BODY Section Header ==> /HEADER A macro report tem algumas variveis, labels e indicadores internos, as vezes ser preciso mudar seus valores. So eles: PAGEEND - varivel inteira que contem o mumero de linhas por pgina. PAGECOUNT - varivel inteira que contm o numero da pgina atual. LINECOUNT - varivel inteira que contm o numero da linha atual. RECCOUNT - varivel inteira que contm o numero de registros selecionados. END.OF.REPORT - label do fim do relatrio. Uas-se return end.of.report pra encerrar o relatrio. SELECT - indicador interno que indica se um registro foi selecionado ou no. No final do arquivo select fica false. SUBTOTAL - comando pra totalizar. Ex: Subtotal body.4 to susbtota1.2 Exemplo de relatrio simples com a report: /header |============|=============================================|================| | *REL001* | Nome da Empresa | Pag ___. | | Paulo | Relatorio do Estoque de Produtos |__/__/____ _.:_.| |============|=============================================|================| | Codigo | Descrio | Qt.Est.| Val. Unit | |--------------+---------------------------------------+--------+-----------| /subheader1 | Setor: ___. ___________________________ | | |

/body | ____________ | _____________________________________ | _____. | __,___.__ | /total |---------------------------------------------------------------------------| | | | Produtos Lidos ==> _____. | |===========================================================================| /tela1 setor: ___. __________________________________ importados? _ (N)acionais,(I)mportados,(T)odos copias: _. _______________________________________ _ /* //===Abertura arquivos======= open "setores" as setores //===plasticos, vidros, cosmticos, etc open "produtos" as produtos //====Page sets============== page set tela1 at 05 10 //====Variaveis============== indicator imp todos integer num //====Names de janelas======= name tela1 setor desc_setor impor copias mens resp //====Loop principal========= Inicio: repeat blankform tela1 gosub seleciona_dados for num from 1 to copias gosub imprime_relatorio loop loop //=====keyprocs============== keyproc key.escape abort keyproc key.clear return inicio //=====subrotinas============ Selecina_dados: repeat entegroup entry setores.setor setor {autofind,findreq} entry setores.desc_setor desc_setor {displayonly}

endgroup move "N" to impor accept impor {capslock,check="NIT"} indicate imp as impor eq "I" indicate todos as impor eq "T" move 1 to copias accept copias {range=1,10} move "Dados corretos para gerar relatorio?" to mens move "S" to resp accept resp {capslock,check="SN"} until resp eq "S" return Imprime_relatorio: clear produtos move setor to produtos.cod_setor //indice.1 = setor + cod_produto report produtos by index.1 break produtos.setor [ select ] indicate select as produtos.setor eq setor [~select ] return end.of.file [~todos imp] indicate select as produtos.flag_impor eq "I" [~todos ~imp] indicate select as produtos.flag_impor eq "N" section header print pagecount sysdadte header.2 print header.3 print header.4 output header to header.1 {fill="0"} header.3 header.4 to header.3 {fill="0"} to header.4 {fill="0"}

section subheader1 print produtos.cod_setor to subheder1.1 findkey eq setores by index.1 for setores.setor eq subheader1.1 output subheader1 section body print produtos.cod_produto to body.1 print produtos.desc_produto to body.2 print produtos.qtd_estoque to body.3 print produtos.val_unit to body.4 output body section total print reccount output total reportend formfeed outclose return //=======fim================= to total.1

No prximo captulo mais exemplos da report.

Captulo 12 - Mais exemplos com a report TEORIA: (1) Uso do BREAK: No dataflex o comando break opcional e significa que quando o indice quebrar, uma imagem sera impressa. Sintaxe: REPORT arquivo BY index.n {BREAK arquivo.campox,arquivo.campoy,...} Vamos exemplificar: Suponha um arquivo de items de notas fiscais cujo index.3 composto dos campos: setor+cod_produto+val_item+recnum. Se quizermos usar report items_nfs by index.3 break cod_produto teremos que definir uma section subtotal2 porque cod_produto o segundo campo do indice. Sempre seguiremos est lgica. E quando no houver breaks, no existiro sections subtotal nem subheader. (2) Quando criamos uma janela tipo body.1 o dataflex automaticamente aloca uma variavel body.1% que acumula o valor dessa janela, pra que esse valor possa ser retornado com o comando subtotal, na section subtotal1 por exemplo. A sintaxe seria SUBTOTAL body.1 TO subtotal1.1 (3) Quando voce precisar de um relatrio com vrias opes de formato, e leituras do arquivo com diferentes indices, o melhor a fazer criar varios subprogramas, usando chain pra executar cada um a partir das opcoes selecionadas no programa principal. Assim voce pode usar vrias macro report usadas de forma simples em cada subprograma. Exemplo: string programa parametros move "relprod" to programa accept opcao {capslock,check="ABCDEF"} //cada opcao um tipo de relatorio append programa opcao parametros chain wait programa ... (4) Pro programa funcionar melhor declare todas as imagens da report como RESIDENT. Exemplo /body resident __. ______________ /total resident Bom acredito que a melhor forma de aprender a usar a report vendo sua aplicao na prtica, ento vamos l: EXEMPLO1 - Usando a section body pra acumular. Veja esta subrotina que usa a macro report: IMPRIME_RELATORIO: CLEAR SCOA233 [ ~TODOS ] MOVE USUARIO TO SCOA233.CODU [ ~TODOS ] MOVE DATA_DE TO SCOA233.DATA REPORT SCOA233 BY INDEX.2 BREAK SCOA233.CODU SCOA233.DATA ; SCOA233.TOT_HS_DECIMAL [ ~TODOS SELECT ] INDICATE SELECT AS SCOA233.CODU EQ USUARIO [ ~TODOS SELECT ] INDICATE SELECT AS SCOA233.DATA LE DATA_ATE [ ~TODOS ~SELECT ] RETURN END.OF.REPORT [ TODOS ] INDICATE SELECT AS SCOA233.DATA LE DATA_ATE [ TODOS SELECT ] INDICATE SELECT AS SCOA233.DATA GE DATA_DE SECTION HEADER PRINT PAGECOUNT TO HEADER.1 SYSDATE HEADER.2 HEADER.3 HEADER.4 PRINT HEADER.3 TO HEADER.3 {FILL="0"} PRINT HEADER.4 TO HEADER.4 {FILL="0"} PRINT DATA_DE TO HEADER.5 PRINT DATA_ATE TO HEADER.6 OUTPUT HEADER SECTION SUBHEADER1 FINDKEY EQ SGSA004 BY INDEX.1 FOR ;

SGSA004.IDEN EQ SCOA233.CODU PRINT SGSA004.NOME TO SUBHEADER1.1 FINDKEY EQ FPCE BY INDEX.1 FOR ; FPCE.CODIGO EQ SCOA233.DEPTO PRINT FPCE.DESCRICAO TO SUBHEADER1.2 OUTPUT SUBHEADER1 SECTION BODY PRINT SCOA233.TOT_HS_DECIMAL TO BODY.1 //***Opa! a body no imprime SECTION SUBTOTAL1 //***ela s acumula... SUBTOTAL BODY.1 TO SUBTOTAL1.1 RIGHT SUBTOTAL1.1 TO MINUTOS 2 LEFT SUBTOTAL1.1 TO HORAS 3 PRINT HORAS TO SUBTOTAL1.2 {FILL="0"} MOVE (ROUND ( MINUTOS * 60 / 100)) TO SUBTOTAL1.3 PRINT SUBTOTAL1.3 TO SUBTOTAL1.3 {FILL="0"} OUTPUT SUBTOTAL1 //***quem imprime a subtotal SECTION TOTAL SUBTOTAL SUBTOTAL1.1 TO TOTAL.1 RIGHT TOTAL.1 TO MINUTOS 2 LEFT TOTAL.1 TO HORAS 3 PRINT HORAS TO TOTAL.2 {FILL="0"} MOVE (ROUND ( MINUTOS * 60 / 100)) TO TOTAL.3 PRINT TOTAL.3 TO TOTAL.3 {FILL="0"} OUTPUT TOTAL REPORTEND OUTCLOSE RETURN EXEMPLO2 - Uma situao que voce quer imprimir varios items pra cada registro, como por exemplo pra cada nota apacem os items que a compe no relatrio. Voce pode criar loops e subrotinas na report bem como imprimir imagens sem ser as imagens padro da report. EMITE_RELATORIO: MOVE 0 TO PAGECOUNT SYSDATE DATAREL HORA MIN CLEAR SCOLA29 BLANKFORM PRODUTOS BLANKFORM CONFIRME REPORT SCOLA29 BY INDEX.4 BREAK SCOLA29.COD_CLIENTE //***(INDICE.4 = COD_CLIENTE +DATA+ RECNUM)*** [ SELECT] INDICATE SELECT AS SCOLA29.DATA GE DATA_DE [ SELECT] INDICATE SELECT AS SCOLA29.DATA LE DATA_ATE SECTION HEADER PRINT PRINT PRINT PRINT PRINT PRINT PAGECOUNT TO HEADER.1 {FILL="0"} DATAREL TO HEADER.2 HORA TO HEADER.3 {FILL="0"} MIN TO HEADER.4 {FILL="0"} DATA_DE TO HEADER.5 DATA_ATE TO HEADER.6

OUTPUT HEADER SECTION BODY FINDKEY EQ SCOLA23 BY INDEX.1 FOR SCOLA23.COD_CLIENTE EQ ; SCOLA29.COD_CLIENTE PRINT SCOLA23.RAZAO_CLI TO BODY.1 PRINT SCOLA23.UF_FAT TO BODY.2 PRINT SCOLA29.NF TO BODY.3 MOVE SCOLA29.NF TO NOTA PRINT SCOLA29.DATA TO BODY.4 PRINT SCOLA29.VAL_NF TO BODY.5 MOVE 0 REPEAT IF FIELDINDEX NE 0 BLANKFORM BODY PRINT SCOLA29.VAL1& TO BODY.6 IF SCOLA29.VAL1& EQ 0 BLANKFORM BODY.6 PRINT SCOLA29.VENC1& TO BODY.7 PRINT SCOLA29.PGTO1& TO BODY.8 CALC ( 1 + FIELDINDEX ) TO FIELDINDEX OUTPUT BODY UNTIL SCOLA29.VAL1& EQ 0 CLEAR SCOLA30 MOVE NOTA TO SCOLA30.NF INDICATE SAIR FALSE REPEAT FIND GT SCOLA30 BY INDEX.1 [ FOUND ] INDICATE FOUND AS SCOLA30.NF EQ NOTA [ FOUND ] BEGIN PRINT SCOLA30.COD_PRODUTO TO PRODUTOS.1 SEARCHKEY GE PRODUTOS BY INDEX.1 COMPARING ; PRODUTOS.COD_TIPO EQ SCOLA30.COD_TIPO ; PRODUTOS.COD_PRODUTO EQ SCOLA30.COD_PRODUTO PRINT PRODUTOS.DESC_PRODUTO TO PRODUTOS.2 PRINT SCOLA30.QTD_PRODUTO TO PRODUTOS.3 MOVE SCOLA30.VAL_UNIT TO PRODUTOS.4 CALC ( PRODUTOS.3 * PRODUTOS.4 ) TO PRODUTOS.5 GOSUB ACUMULA_PRODUTOS PRINT PRODUTOS.4 PRINT PRODUTOS.5 INDICATE FOUND TRUE END [ ~FOUND] OUTPUT PRODUTOS UNTIL [ ~FOUND] SECTION SUBTOTAL1 TO FIELDINDEX

SUBTOTAL BODY.5 SECTION TOTAL SUBTOTAL SUBTOTAL1.1 OUTPUT TOTAL PRINT PRINT PRINT PRINT PRINT CONFIRME.2 TO CONFIRME.2 CONFIRME.4 TO CONFIRME.4 CONFIRME.6 TO CONFIRME.6 CONFIRME.8 TO CONFIRME.8 CONFIRME.10 TO CONFIRME.10

OUTPUT CONFIRME REPORTEND FORMFEED OUTCLOSE RETURN

Captulo 13 - Exemplo de impresso de etiquetas Como a impresso de etiquetas muito comum vamos dar um exemplo de impresso de etiquetas pra mala direta de clientes em impressora de formulrio contnuo. //Cria-se uma tela de seleo como voce j sabe. /TELA

Cliente .: _____. - ________________________________________ Formulario OK.?.(Y/N).: _

Quantidade de Etiquetas Lidas ...: _____. Quantidade de Etiquetas Impressas: _____.

//Cria-se a tela onde vai o texto na etiqueta, isto um pouco trabalhoso //porque temos que ajustar o layout pra sair bom na etiqueta. /BODY RESIDENT ________________________________________ ________________________________________ ________________________________________ ________________________________________ ______________________________ _________ ______________________________ __ ______________________________ __ _____ ______________________________ /* #INCLUDE BIBLIOTE.INC #INCLUDE TITULO.INC //===Variaveis STRING TECLA 1 CEP 9 INTEGER ETIQCORRENTE CONT INDICATOR OK ______________________________ _________ _____ ______________________________

CONT2

//===Abre arquivo de clientes OPEN "C:\DF301B\ALAMAR\SCOLA23" AS SCOLA23 //***CLIENTES //===Redireciona pra impressora padro OUTFILE "LST:" //===Page sets PAGE SET TELA AT 17 05 COLORS 15 143

INICIO: PAGE TELA REPEAT BLANKFORM TELA CLEAR SCOLA23 ENTERGROUP //seleciona um ou ento todos clientes ENTRY SCOLA23.COD_CLIENTE TELA.1 {AUTOFIND} INDICATE TODOS AS [ ~FOUND] [ TODOS] BEGIN MOVE 0 TO TELA.1 MOVE " *** TODOS CLIENTES *** " TO TELA.2 END ENTRY SCOLA23.FANT_RAZAO_CLI TELA.2 {CAPSLOCK,DISPLAYONLY} MOVE "S" TO TELA.3 ACCEPT TELA.3 {CAPSLOCK,CHECK="SN"} INDICATE OK AS TELA.3 EQ "S" ENDGROUP //inicializa variaveis MOVE 1 TO ETIQCORRENTE MOVE 0 TO PAGEEND //pra no pular de folha no formulario MOVE 0 TO CONT UNTIL [ OK ] BLANKFORM BODY CLEAR SCOLA23 [ ~TODOS] MOVE TELA.1 TO SCOLA23.COD_CLIENTE //se apenas 1 cliente REPORT SCOLA23 BY INDEX.1 //***[ INDEX.1 = COD_CLIENTE [ ~TODOS SELECT ] INDICATE SELECT AS SCOLA23.COD_CLIENTE EQ TELA.1 [ ~SELECT ] RETURN END.OF.REPORT MOVE (CONT+1) TO CONT DISPLAY CONT TO TELA.4 //pro usurio ver processando SECTION BODY //usa-se windowindex pra facilitar porque so 2 etiquetas //uma do lado da outra MOVE (ETIQCORRENTE-1) TO WINDOWINDEX PRINT SCOLA23.RAZAO_CLI TO BODY.1& PRINT SCOLA23.ENDER_FAT TO BODY.3&

PRINT SCOLA23.BAIRRO_FAT TO BODY.5& MOVE ((ETIQCORRENTE-1)*3) TO WINDOWINDEX PRINT SCOLA23.CEP_FAT_MASC TO BODY.7& PRINT SCOLA23.CIDADE_FAT TO BODY.8& PRINT SCOLA23.UF_FAT TO BODY.9& MOVE ((ETIQCORRENTE-1)*2) TO WINDOWINDEX IF SCOLA23.CONTATO_FAT NE "" BEGIN PRINT "ATT: " TO BODY.13& PRINT SCOLA23.CONTATO_FAT TO BODY.14& END ELSE BEGIN BLANKFORM BODY.13& BLANKFORM BODY.14& END INCREMENT ETIQCORRENTE //proxima etiqueta

IF ETIQCORRENTE GT 2 BEGIN //acabou as etiquetas da linha? MOVE 1 TO ETIQCORRENTE //posiciona na primeira etiqueta CALC ( CONT2 + 3 ) TO CONT2 OUTPUT BODY //imprime MOVE CONT2 TO TELA.5 BLANKFORM BODY // coloca branco nas etiquetas END REPORTEND IF ETIQCORRENTE NE 1 BEGIN OUTPUT BODY //sobrou alguma etiqueta ? - imprime IF BODY.1& NE "" MOVE (CONT2+1) TO CONT2 END FORMFEED MOVE CONT2 TO TELA.5 OUTCLOSE PAUSE "" ABORT KEYPROC KEY.ESCAPE ABORT KEYPROC KEY.CLEAR BLANKFORM TELA RETURN INICIO //--------------Se fosse uma linha com 3,4 ou mais etiquetas a lgica a mesma e o uso da windowindex facilita bem.

Captulo 14 - Criando comandos Bom j vimos muitos comandos do dataflex e agora chegou a hora de ver como criar nossos prprios comandos. O comando pode ser definido no prprio programa, mas o melhor criar uma biblioteca, que nada mais que um arquivo texto contendo os comandos. Depois se voce precisar daquele comando que voce criou, voce da um include da biblioteca que deve ter extenso ".inc". Tipo nossos programas aparece #include biblioteca.inc mas poderia ser #include sua_biblioteca.inc ou qualquer nome. Antes de mais nada precisamos ver algumas diretivas de compilao do dataflex. Diretivas de compilao do informaes pro DFCOMP de como o nosso programa deve ser compilado. Outra coisa legal do comando: ele aceita vrios parmetros (9 no maximo) e pode modificar todos estes parametros. Sintaxe do comando: #COMMAND nome_do_comando #ENDCOMMAND DIRETIVAS DE COMPILADOR: (sempre comeam com "#") #IF - if de compilador #ELSE - mesma coisa do else normal #ENDIF - usa-se pra delimitar o bloco if de compilador #IFDEF - se j foi definida varivel #IFNDEF - se no foi definida a varivel #IFSAME - se um parametro o memo que... ACESSO AOS PARAMETROS: !0 - numero de parametros !1 - primeiro parametro !2 - segundo parametro !3 - terceiro parametro e assim por diante at !9 EXEMPLO 1 - Este comando usado pra depurar, porque mostra o conteudo de 1 a 9 variveis na tela e da um pause Exemplo de uso: marbreak clientes.cod_cliente valor data #COMMAND MARBREAK //AUTOR: MARCIO LUIZ OLIVEIRA GOTOXY 24 12 //posiciona o cursor SHOW !1 " | " !2 " | " !3 " | " !4 " | " !5 " | " !6 " | " !7 " | " !8 " | " !9 tela PAUSE "" #ENDCOMMAND EXEMPLO 2 - Liga o cursor com CURSOR ON e desliga com CURSOR OFF #COMMAND CURSOR //AUTOR: MARCIO LUIZ OLIVEIRA GOTOXY 23 77 #IFSAME !1 OFF //se o parametro 1 igual OFF //faz uma pausa at uma tecla ser pressionada //mostra os parmetros na

SHOW "[?25l [.0" //sequencia de escape pra desligar o cursor #ELSE SHOW "[?25h [.3" //sequencia pra deixa-lo visvel #ENDIF GOTOXY 23 77 SHOW " " #ENDCOMMAND EXEMPLO 3 - Exelente comando pra formatar e desmembrar datas, seu cdigo mais complexo que os anteriores. Lembre-se o dataflex usa internamente a data como um inteiro que o numero de dias desde 01/01/0001. #COMMAND DATA_CHECK // Sintaxe : DATA_CHECK (DATA) [DIA] [MES] [ANO] [DESCRICAO DO MES]

//AUTOR DESCONHECIDO #IFDEF DATA_VAR //se j esta definida a variavel DATA_VAR no faz nada #ELSE INTEGER DATA_VAR //seno cria a varivel #ENDIF MOVE !1 TO DATA_VAR //move o parametro 1 pra data_var

IF (LENGTH(!1)) EQ 5 ; IF DATA_VAR LT 693975; IF DATA_VAR GE 10958; CALC (DATA_VAR + 693975) TO !1 IF (LENGTH(!1)) EQ 4 ; IF DATA_VAR LT 10958 IF DATA_VAR GT 1 ; CALC (DATA_VAR + 730500) TO !1 IF !1 NE "" ; IF !1 LT "01/01/1900" BEGIN SHOW "" SHOW "" SHOW "" GOTOXY 21 14 SHOW "ATENCAO !! DATA NAO PODE SER INFERIOR A 01/01/1900." GOTOXY 21 14 PAUSE "" SHOW " " END IF !1 GE "01/01/1900" BEGIN #IF !0>1 LEFT !1 TO !2 2 #IF !0>2 MID !1 TO !3 2 4 #ENDIF #IF !0>3 RIGHT !1 TO !4 4 #ENDIF #IF !0>4 MOVE "" TO !5 IF !3 EQ 1 APPEND !5 !2 " de Janeiro de " !4

IF IF IF IF IF IF IF IF IF IF IF #ENDIF #ENDIF END #ENDCOMMAND

!3 !3 !3 !3 !3 !3 !3 !3 !3 !3 !3

EQ EQ EQ EQ EQ EQ EQ EQ EQ EQ EQ

2 APPEND !5 !2 " de Fevereiro de " !4 3 APPEND !5 !2 " de Marco de " !4 4 APPEND !5 !2 " de Abril de " !4 5 APPEND !5 !2 " de Maio de " !4 6 APPEND !5 !2 " de Junho de " !4 7 APPEND !5 !2 " de Julho de " !4 8 APPEND !5 !2 " de Agosto de " !4 9 APPEND !5 !2 " de Setembro de " !4 10 APPEND !5 !2 " de Outubro de " !4 11 APPEND !5 !2 " de Novembro de " !4 12 APPEND !5 !2 " de Dezembro de " !4

OBS: Voce pode chamar comandos do dataflex e tambm seus prprios comandos dentro de 1 comando seu. Mas se um comando usa uma imagem ela obrigatoriamente tem que ser definida no programa seno d erro de compilao. Infelizemte na verso 2.3 uma imagem no pode ser definida dentro de um comando (na 3.0 j possivel!). DICAS: - Ao declarar variveis em comandos procure usar nomes pouco provveis de alguem querer usar tipo confirma$_ok,ou $$$_num_x por exemplo. - Crie comandos o mais independente possivel do seu programa assim eles podero facilmente ser usados em vrios programas. - Evite uso de comandos associados a imagems dentro dos seus comandos, prefira usar show, pause, inkey que so comandos que no usam imagens. - Tenha uma unica biblioteca pra todos os programadores, assim evita de existir comandos diferentes pra fazer a mesma coisa. - Comandos podem fazer tudo que feito no programa, como abrir arquivos usar laos e tudo mais, mas procure cria-los apenas pra resolver coisas que se repetem frequentemente, poupando seu tempo no futuro.

Captulo 15 - Grficos em dataflex Programa exemplo de como gerar grficos no dataflex: /* string temp 1 chart_init graph_value "JAN" 700 graph_value "FEV" 900 graph_value "MAR" 800 graph_value "ABR" 600 graph_value "MAI" 500 graph_value "JUN" 100 graphic on clearscreen 0 chart bar "produtox" "vendas" "meses" //grafico de barras inkey temp chart pie "produtox" "vendas" "meses" //grafico de torta inkey temp chart line "produtox" "vendas" "meses" //grafico de linha inkey temp graphic off abort Este programa precisa de micro ou terminal grfico pra rodar, se voce no tem terminais grficos (como na minha empresa) ento d pra fazer grficos de uma forma mais trabalhosa (com timo resultados) usando windowindex como no exemplo abaixo: Este exemplo um questinrio de avaliao de clientes pra 11 perguntas onde no grfico aparece a mdia das respostas pra cada pergunta. /GRAFICO AVALIACOES DE CLIENTES _.-_______________ (ANO ___. SEMESTRE _.) ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ 10.0 ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ 9.0 ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ 8.0 ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ 7.0 ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ 6.0 ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ 5.0 ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ 4.0 ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ 3.0 ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ 2.0

____ ____ ____ ____ ____ ____ ____ ____ ____ (1) (2) (3) (4) /* ...

____ ____ ____ ____ ____ ____ ____ ____ ____ (5) (6) (7) (8)

____ ____ ____ ____ ____ ____ ____ ____ ____ ____ 1.0 ____ ____ ____ ____ ____ (9) (10) (11)

MOSTRA_RESULTADOS: BLANKFORM GRAFICO MOVE 01 TO GRAFICO.1 MOVE EMPRESA TO GRAFICO.2 MOVE ANO TO GRAFICO.3 MOVE SEMESTRE TO GRAFICO.4 FOR PERG FROM 1 TO 11 MOVE ( PERG - 1 ) TO WINDOWINDEX MOVE NOTAS.1& TO TOT_PERG CALC ( TOT_PERG / NUM ) TO TOT_PERG MOVE TOT_PERG TO AUX.1 GOSUB ENCHE_COLUNA LOOP KEYPROC ON [~RELAT ] BEGIN PAGE GRAFICO GOTOXY 23 72 PAUSE "" END [ RELAT ] GOSUB IMPRIME_RELATORIO RETURN ENCHE_COLUNA: INTEGER COL WIND MOVE 0 TO COL MOVE WINDOWINDEX TO WIND FOR WINDOWINDEX FROM ( 225 + PERG - 2 ) TO ( 5 + PERG - 2 ) DOWN 11 CALC ( TOT_PERG - 0.5 ) TO TOT_PERG IF TOT_PERG GT 0.5 MOVE "" TO GRAFICO.1& IF TOT_PERG GT 0 IF TOT_PERG LE 0.5 MOVE "" TO GRAFICO.1& IF TOT_PERG LE 0 BEGIN INCREMENT COL IF COL EQ 1 IF AUX.1 NE 0 MOVESTR AUX.1 TO GRAFICO.1& ELSE MOVE "" TO GRAFICO.1& END LOOP MOVE WIND TO WINDOWINDEX

RETURN

Capitulo 16 - Outras tcnicas (1) Sysfile - muito util deixar o primeiro arquivo de cada filelist como um sysfile, ou seja, um arquivo de apenas um registro que contem algumas informes do sistema como nmero de sequencia de notas fiscais, numero do usurio, etc. (2) Arquivo temporrio - arquivo que usado por vrios relatrio pra acumular dados. Tanto seus campos como seus indices devem ser o mais reutilizveis possivel e deve usar nome de campos genrico. Exemplo: arquivo: phtemp usuario number 6.0 //sempre o numero do usuario aqui campo_ascii ascii 10 campo_date date campo_float number 8.2 ... index.1 index.2 ... index.3 ... //Todos indices quebram no campo do usurio ... Cada relatorio abre o sysfile pega o numero do usurio e o incrementa salvando novamente no sysfile. integer usuario clear sysfile find gt sysfile by recnum move sysfile.usuario to usuario if usuario eq 999999 move 0 to usuario move (usuario + 1) to sysfile.usuario saverecord sysfile No final de um relatrio o conteudo do temporario apagado apenas dos registros do usurio que terminou aquele relatrio. Perceba que se no hover quebra no indice por usurio, o temporrio misturar registros gravados por diferentes aplicaes. (3) Campo usurio do sysfile - este um campo muito util em ambientes multiusuario, que contem um numero inteiro. Pra cada arquivo temporario a primeira quebra dos indices deve ser o usurio. Porque assim conseguimos separar os resultados dos relatorios tanto pra consulta dos registros como pra sua deleo. Lembre que cabe a cada aplicao limpar os registros por ela gravados. Exemplo de rotina: Limpa_temporario: gotoxy 20 05 showln "Limpando o temporario..." clear phtemp move usuario to phtemp.usuario repeat find gt phtemp by index.1 [ found ] indicate found as phtemp.usuario eq usuario [ found ] delete phtemp until [ ~found ] return (4) Arquivos fantasmas - cria-se com o dffile um arquivo com campos identicos ao original e na abertura fazemos: Exemplo: criamos produtos e produtosfant com o mesmo .def open "produtos" as produtos open "produtos" as produtosfant Isto muito til quando queremos ler o arquivo por dois indices diferentes numa mesma rotina.

(5) Estruturao da programao e hidentao do cdigo - isto bom em qualquer linguagem... Procure separar o cdigo em gosubs: /* page set ... name ... open ... repeat gosub seleciona_dados gosub grava_temporario gosub mostra_grafico gosub imprime_relatorio gosub limpa_temporario loop keyproc key.escape abort hidentao pra deixar os loop mais visveis: subrotina_quaquer: for cont from 1 to num repeat while [ ok] loop until [~found] loop return Sem hidentao ficaria menos visvel e mais dificil a manuteno: subrotina_quaquer: for cont from 1 to num repeat while [ ok] loop until [~found] loop return (6) Uso dos indicadores associados as keyprocs. Toda keyproc tem um indicador associado a ela tipo [ key.save ], [ key.next], [ key.return ] e outros. As vezes precisamos desabilitar as keyprocs e trabalhar direto

com estes indicadores, que indicam se a tecla foi pressionada ou no, mas com a keyproc desabilitada eles no pulam automaticamente pra rotina da keyproc. Ex: keyproc off repeat [ key.escape ] abort until [ key.return ] keyproc on (7) Criao do efeito hi-ligth, ou seja tipo uma caixa de seleo do windows ou uma list-box, com varios items um em cada janela, e voce pressiona seta pra-cima e o hi-ligth vai pro item de cima deixando ele "selecionado", se voce pressiona seta pra baixo volta pro item de baixo. Ele feito com windowindex e screenmode. Se alguem quizer mando esta rotina. Ufa! por ora acho que este tutorial vai ficar por aqui... Sei que t faltando coisas mas tenham pacincia! Vou melhorando se surgiirem duvidas. Duvidas => phbm@webcable.com.br