Apostila PROGRESS ABL v1.5

Dalto Blanco Programando com Progress ABL v.1.
5
(18) 99747-8189
Programando em Progress
Advanced Business Language
Jaison Antoniazzi
Versão 1.5
Copyright © 2021 Neo Step Ltda.
Todos os Direitos Reservados.
Nenhuma parte deste documento pode ser copiada, reproduzida, traduzida ou

transmitida por qualquer meio eletrônico ou mecânico, na sua totalidade ou em parte,
sem a prévia autorização escrita da Neo Step Ltda., que se reserva o direito de efetuar
alterações sem aviso prévio. A Neo Step Ltda não assume nenhuma responsabilidade
pelas consequências de quaisquer erros ou inexatidões que possam aparecer neste
documento.
Dalto Blanco Programando com Progress ABL v.1.5
(18) 99747-8189
Índice
Sumário
Índice ............................................................................................................................................. 2
Sobre esta apostila ...................................................................................................................... 12
Sobre o Progress OpenEdge .......................................................................................................... 2
Alicerces dos sistemas Progress OpenEdge..................................................................................................... 2
Sobre a Linguagem ABL – Advanced Business Language .............................................................. 2
Banco de dados Progress OpenEdge ............................................................................................. 3
Control Area .................................................................................................................................................... 3
Schema Area .................................................................................................................................................... 3
Application Data Area...................................................................................................................................... 3
Primary Recovery Area .................................................................................................................................... 3
After-image Area ............................................................................................................................................. 4
Transaction log Area ........................................................................................................................................ 4
Encryption Policy Area..................................................................................................................................... 4
Audit data and index Area ............................................................................................................................... 4
Componentes lógicos ...................................................................................................................................... 4
Tabelas ......................................................................................................................................................... 4
Registro ........................................................................................................................................................ 4
Campos ........................................................................................................................................................ 4
Chaves.......................................................................................................................................................... 4
Índices.......................................................................................................................................................... 4
Sequências ................................................................................................................................................... 4
Relacionamentos entre tabelas ................................................................................................................... 4
Ferramentas especialistas ............................................................................................................. 6
Principais ferramentas..................................................................................................................................... 6
AppBuilder ................................................................................................................................................... 7
Application Compiler ................................................................................................................................... 7
Procedure Editor (Client) ............................................................................................................................. 8
Data Administration .................................................................................................................................... 8
Data Dictionary ............................................................................................................................................ 8
Desktop........................................................................................................................................................ 9
(18) 99747-8189
Composição da sessão ................................................................................................................. 10

Programas em ambiente TTY e Gráfico ....................................................................................... 11
Programa TTY de exemplo............................................................................................................................. 11
Analisando o código do programa exemplo.................................................................................................. 12
Analisando o código do programa exemplo do Windows ............................................................................ 14
ABL-DÔ - The Way of the ABL Programmer ................................................................................ 16
Debugger ..................................................................................................................................... 17
Anotações ...................................................................................................................................................... 17
O objeto Debugger ........................................................................................................................................ 17
Anotações .................................................................................................................................................. 17
Exercício......................................................................................................................................................... 18
Objetos System Handle ............................................................................................................... 20
FOCUS system handle.................................................................................................................................... 20
Exemplo de Focus ...................................................................................................................................... 20
Habilitando objetos na tela ....................................................................................................................... 21
Anotações .................................................................................................................................................. 22
CLIPBOARD system handle ............................................................................................................................ 22
Anotações .................................................................................................................................................. 22
THIS-PROCEDURE system handle .................................................................................................................. 22
Exemplo de This-Procedure....................................................................................................................... 23
Localizando procedures internas de um programa persistent.................................................................. 23
Pegando a assinatura da procedure .......................................................................................................... 23
Anotações .................................................................................................................................................. 24
LOG-MANAGER system handle ..................................................................................................................... 24
Exemplo de criação arquivo de log em tempo de execução ..................................................................... 24
Limpando o log .......................................................................................................................................... 24
Anotações .................................................................................................................................................. 25
ACTIVE-WINDOW system handle .................................................................................................................. 25
Anotações .................................................................................................................................................. 25
DEBUGGER system handle ............................................................................................................................ 25
Anotações .................................................................................................................................................. 26
ERROR-STATUS system handle ...................................................................................................................... 26
Anotações .................................................................................................................................................. 27
FILE-INFO system handle ............................................................................................................................... 27
Neo Step
Todos os Direitos Reservados 3
(18) 99747-8189
Anotações .................................................................................................................................................. 27
SESSION system handle ................................................................................................................................. 27
Anotações .................................................................................................................................................. 28
SELF System Handle ....................................................................................................................................... 28
Operadores .................................................................................................................................. 30
Anotações ...................................................................................................................................................... 30
Exercício......................................................................................................................................................... 31
Banco de dados, Record Buffer e Screen Buffer ......................................................................... 32
Segmentos ..................................................................................................................................................... 32
Database .................................................................................................................................................... 32
Record Buffer............................................................................................................................................. 32
Screen Buffer ............................................................................................................................................. 32
Instruções de transferência ........................................................................................................................... 32
Buffers, Temp-tables e Datasets ................................................................................................. 34
Buffers ........................................................................................................................................................... 34
Tabelas temporárias ...................................................................................................................................... 36
Datasets ......................................................................................................................................................... 39
Sintaxe do Dataset ..................................................................................................................................... 40
Sintaxe do Datasource ............................................................................................................................... 40
Receita de bolo para o funcionamento ..................................................................................................... 40
Dataset com uma tabela e usando buffer ................................................................................................. 41
Dataset com uma tabela usando query .................................................................................................... 41
Anotações .................................................................................................................................................. 41
Exercício......................................................................................................................................................... 43
Criação, Atribuição e Eliminação de Registros ............................................................................ 44
Instrução Create ............................................................................................................................................ 44
Anotações .................................................................................................................................................. 44
Instrução Insert.............................................................................................................................................. 45
Anotações .................................................................................................................................................. 46
Instrução de Assign........................................................................................................................................ 46
Instrução Delete ............................................................................................................................................ 47
Anotações .................................................................................................................................................. 47
Importante................................................................................................................................................. 47
Exercício......................................................................................................................................................... 48
Neo Step
(18) 99747-8189
Interação com registros............................................................................................................... 49

Instrução For.................................................................................................................................................. 49
Transferência de Dados ................................................................................................................................. 49
Fluxograma da pesquisa com instruções....................................................................................................... 49
For each ..................................................................................................................................................... 50
Find First .................................................................................................................................................... 50
Open Query ............................................................................................................................................... 50
Principais opções da instrução FOR............................................................................................................... 51
Opções do Record phrase.............................................................................................................................. 52
Principais opções das opções Record Phrase ............................................................................................ 52
Anotações .................................................................................................................................................. 53
For Each com Where ..................................................................................................................................... 53
Anotações .................................................................................................................................................. 53
For Each com By ............................................................................................................................................ 53
Anotações .................................................................................................................................................. 54
For each com várias tabelas .......................................................................................................................... 54
Anotações .................................................................................................................................................. 54
For Each Encadeado com Várias Tabelas ...................................................................................................... 54
For Each Encadeado com Fields .................................................................................................................... 55
Instrução For First e For Last ......................................................................................................................... 55
Anotações .................................................................................................................................................. 56
Instrução Find ................................................................................................................................................ 56
Movimentação de registro ........................................................................................................................ 56
Principais Opções do Find.......................................................................................................................... 56
Anotações .................................................................................................................................................. 58
Analisando pontos fortes e fracos ................................................................................................................. 58
Instrução Get ................................................................................................................................................. 59
Open Query ................................................................................................................................................... 59
Anotações .................................................................................................................................................. 61
Uso da função Can-find ................................................................................................................................. 62
Anotações .................................................................................................................................................. 62
Locks de registros .......................................................................................................................................... 62
Exclusive-lock............................................................................................................................................. 62
Share-lock .................................................................................................................................................. 63
Neo Step
(18) 99747-8189
No-lock....................................................................................................................................................... 63
Anotações .................................................................................................................................................. 63
Usando No-lock e Exclusive-lock ................................................................................................................... 63
Exercício......................................................................................................................................................... 64
Exercicios Complementares For Each............................................................................................................ 64
Exercícios complementares de Open Query ................................................................................................. 75
Gatilhos do banco de dados ........................................................................................................ 79
Create ............................................................................................................................................................ 79
Delete ............................................................................................................................................................ 79
Find ................................................................................................................................................................ 79
Write .............................................................................................................................................................. 79
Replication-create ......................................................................................................................................... 79
Replication-delete ......................................................................................................................................... 79
Replication-write ........................................................................................................................................... 79
Retorno de Erro e cancelamento da execução ............................................................................................. 79
Variáveis e tipos de dados ........................................................................................................... 80
Tipos de variáveis .......................................................................................................................................... 80
Tipos primitivos da linguagem ABL................................................................................................................ 80
Exemplos ....................................................................................................................................................... 81
Anotações .................................................................................................................................................. 82
Rótulos ........................................................................................................................................................... 82
Anotações .................................................................................................................................................. 83
Formato padrão ............................................................................................................................................. 83
Anotações .................................................................................................................................................. 84
Valores iniciais ............................................................................................................................................... 84
Tabela de valores iniciais ........................................................................................................................... 84
Anotações .................................................................................................................................................. 84
Variáveis multidimensionais ou vetores........................................................................................................ 84
Anotações .................................................................................................................................................. 85
Opção No-Undo ............................................................................................................................................. 85
Anotações .................................................................................................................................................. 86
Visualização De Variáveis Como Objetos ...................................................................................................... 86
Exemplo ..................................................................................................................................................... 88
Resultado no ambiente Windows ............................................................................................................. 90
Neo Step
(18) 99747-8189
Resultado no Ambiente Caracter .............................................................................................................. 91

Anotações .................................................................................................................................................. 91
Variáveis e herança ....................................................................................................................................... 91
Anotações .................................................................................................................................................. 92
Herdando características de campos de tabela ........................................................................................ 92
Exercício......................................................................................................................................................... 94
Entrada e Atribuição de Valores .................................................................................................. 95
Instrução Assign............................................................................................................................................. 95
Anotações .................................................................................................................................................. 95
Anotações .................................................................................................................................................. 96
Instrução de Prompt-for ................................................................................................................................ 96
Anotações .................................................................................................................................................. 97
Instrução de Update ...................................................................................................................................... 97
Anotações .................................................................................................................................................. 98
Importante................................................................................................................................................. 98
Anotações .................................................................................................................................................. 99
A maldição do Screen buffer ......................................................................................................................... 99
Simulando o problema de Screen buffer................................................................................................... 99
Transferindo valor do Screen Buffer para o Record Buffer ....................................................................... 99
Anotações ................................................................................................................................................ 100
Exercícios ..................................................................................................................................................... 101
Instruções Condicionais ............................................................................................................. 102
Instrução IF, THEN e ELSE ............................................................................................................................ 102
Anotações ................................................................................................................................................ 102
If, Then e Else em Assign ......................................................................................................................... 102
Instrução CASE............................................................................................................................................. 103
Anotações ................................................................................................................................................ 103
Exercícios ..................................................................................................................................................... 104
Includes...................................................................................................................................... 105
Anotações .................................................................................................................................................... 105
Exercício....................................................................................................................................................... 106
Pré-processadores ..................................................................................................................... 107
Constantes locais ......................................................................................................................................... 107
Definindo constantes locais Scoped-define ............................................................................................ 107
Neo Step
(18) 99747-8189
Anotações ................................................................................................................................................ 107

Constantes Globais ...................................................................................................................................... 107
Definindo constantes globais Global-define ........................................................................................... 107
Anotações ................................................................................................................................................ 107
Verificando a declaração de uma constante ............................................................................................... 108
Diferença entre Scoped e Global ................................................................................................................. 108
Anotações ................................................................................................................................................ 108
Eliminando a declaração de uma constante ............................................................................................... 108
Anotações ................................................................................................................................................ 109
Exercício....................................................................................................................................................... 110
Frames e Display........................................................................................................................ 111
Frames de relatórios.................................................................................................................................... 111
Frames para widgets ................................................................................................................................... 111
Opções Para Campos E Constantes ............................................................................................................. 111
Principais Opções dos Campos e Constantes .......................................................................................... 112
Principais opções da Formatação de campos ......................................................................................... 113
Opções para o Frame .................................................................................................................................. 113
Principais Opções da Definição da Frame ............................................................................................... 114
Compartilhamento ...................................................................................................................................... 115
Instrução Display ......................................................................................................................................... 116
Frame de relatório ....................................................................................................................................... 118
Frames Sobrepostas .................................................................................................................................... 120
As sete regras da programação com eventos ............................................................................................. 121
Anotações ................................................................................................................................................ 121
Exercício....................................................................................................................................................... 122
Objetos, Eventos e Gatilhos de Widgets ................................................................................... 124
Tipos de Objetos .......................................................................................................................................... 124
Anotações ................................................................................................................................................ 124
Objetos Estáticos ......................................................................................................................................... 124
Anotações ................................................................................................................................................ 127
Objetos Dinâmicos....................................................................................................................................... 128
Anotações ................................................................................................................................................ 128
Eventos .................................................................................................................................................... 129
Anotações ................................................................................................................................................ 129
Neo Step
(18) 99747-8189
Códigos de Gatilhos ..................................................................................................................................... 129

Anotações ................................................................................................................................................ 129
Exemplo Objetos Estáticos ...................................................................................................................... 129
Anotações ................................................................................................................................................ 132
Exemplo Objetos Dinâmicos .................................................................................................................... 132
Anotações ................................................................................................................................................ 133
Compartilhamento de variáveis e objetos ................................................................................ 134
Compartilhamento de variáveis entre programas ...................................................................................... 134
Anotações ................................................................................................................................................ 135
Compartilhamento de variáveis e objetos na sessão .................................................................................. 135
Anotações ................................................................................................................................................ 135
Exercícios ..................................................................................................................................................... 137
Procedimentos e funções .......................................................................................................... 138
Procedimentos internos .............................................................................................................................. 138
Anotações ................................................................................................................................................ 138
Procedimentos de Bibliotecas Externas ...................................................................................................... 138
Anotações ................................................................................................................................................ 139
Passagem de parâmetros ............................................................................................................................ 139
Por valor .................................................................................................................................................. 140
Por referência .......................................................................................................................................... 140
De retorno ............................................................................................................................................... 141
Passagem de ponteiros de tabelas .......................................................................................................... 142
Passagem de tabelas temporárias........................................................................................................... 142
Exercício................................................................................................................................................... 144
Funções........................................................................................................................................................ 145
Anotações ................................................................................................................................................ 147
Programas e Funções Persistentes .............................................................................................................. 147
As cinco regras dos programas persistentes ........................................................................................... 147
Anotações ................................................................................................................................................ 151
Exercício....................................................................................................................................................... 152
Blocos de instruções e Transações ............................................................................................ 153
Desfazendo a transação .............................................................................................................................. 153
Anotações ................................................................................................................................................ 154
Opção Undo ................................................................................................................................................. 154
Neo Step
(18) 99747-8189
Anotações ................................................................................................................................................ 155

Início e término de uma Transação ............................................................................................................. 155
Exercício....................................................................................................................................................... 165
Laços de repetição ..................................................................................................................... 166
Instrução Do ................................................................................................................................................ 166
Anotações ................................................................................................................................................ 166
Instrução Repeat ......................................................................................................................................... 167
Anotações ................................................................................................................................................ 167
Instrução For................................................................................................................................................ 167
Vários exemplos de For Each ................................................................................................................... 168
Anotações ................................................................................................................................................ 170
Nomeando laços de repetição..................................................................................................................... 170
Exercício....................................................................................................................................................... 173
Tratamentos On Error, On Endkey, On Quit e On Stop ............................................................. 174
Opção On Error ............................................................................................................................................ 174
Anotações ................................................................................................................................................ 174
Opção On EndKey ........................................................................................................................................ 176
Anotações ................................................................................................................................................ 176
Opção On Stop............................................................................................................................................. 178
Anotações ................................................................................................................................................ 178
Opção On Quit ............................................................................................................................................. 178
Anotações ................................................................................................................................................ 179
Captura de erros ........................................................................................................................ 180
Bloco catch .................................................................................................................................................. 180
Bloco de Finally ............................................................................................................................................ 180
Anotações .................................................................................................................................................... 185
Importação e exportação .......................................................................................................... 186
Instrução Output ......................................................................................................................................... 186
Instrução Put ............................................................................................................................................... 190
Instrução Export .......................................................................................................................................... 193
Instrução Display ......................................................................................................................................... 194
Anotações ................................................................................................................................................ 195
Instrução Input ............................................................................................................................................ 195
Anotações ................................................................................................................................................ 197
Neo Step
(18) 99747-8189
Exercício....................................................................................................................................................... 198
Eventos Nomeados em programas ........................................................................................... 199
O Primeiro programa com eventos ............................................................................................................. 199
Anotações ................................................................................................................................................ 201
Cancelando a notificação de Eventos .......................................................................................................... 202
Compilador ................................................................................................................................ 203
Opção Xref ................................................................................................................................................... 203
Anotações ................................................................................................................................................ 203
Opção Preprocess ........................................................................................................................................ 204
Anotações ................................................................................................................................................ 204
Opção Listing ............................................................................................................................................... 204
Anotações ................................................................................................................................................ 205
Anexos ....................................................................................................................................... 206
Prova de certificação ................................................................................................................................... 206
Programa da prova de certificação ......................................................................................................... 206
Janela pesquisar ...................................................................................................................................... 207
Codigo do programa da prova de certificação ........................................................................................ 208
Componentes do banco de dados Sports2000 ........................................................................................... 216
Imagem do MER do banco SPORTS2000 ................................................................................................. 216
Tabelas do banco Sports2000.................................................................................................................. 216
Índices das tabelas do banco Sports2000 ............................................................................................... 217
Relacionamento das tabelas.................................................................................................................... 220
Listagem de campos das tabelas do banco Sports2000 .......................................................................... 223
Neo Step
(18) 99747-8189
Sobre esta apostila

A autoria desta apostila é de Jaison Antoniazzi e não deve ser reproduzida.
Todas as sintaxes de comandos e instruções foram extraídas do arquivo de ajuda da Progress, assim como
alguns exemplos, outros exemplos foram confeccionados pelo autor e somente podem ser reutilizados para
aprendizagem em treinamentos ministrados pela Neo Step em parceria com a IDBA.
Neo Step Todos os Direitos Reservados.
Neo Step
(18) 99747-8189
Sobre o Progress OpenEdge

É um ambiente para desenvolvimento e execução de aplicações empresariais que:
• Possui linguagem interpretada conhecida como ABL - Advanced Business Language,

• Possui uma máquina virtual que o torna multiplataforma (AVM – ABL Virtual Machine),
• Tem banco de dados embutido que suporta 32.000 Petabytes de fácil gestão, mas que pode acessar
nativamente Oracle, Microsoft SQL Server e outros bancos,
• Possui várias ferramentas especialistas.
Alicerces dos sistemas Progress OpenEdge

Sistemas Progress OpenEdge podem ser constituídos por centenas, até dezena de milhares de programas,
por isso, são três alicerces:
1. A máquina virtual AVM que interpreta os programas compilados de um sistema,

2. Propath,
3. Conexão com banco de dados.
Sobre a Linguagem ABL – Advanced Business Language

• É Procedural, Orientada a eventos e Orientada a Objetos, organizada com procedimentos internos,
gatilhos e códigos de gatilho, e com classes e objetos,
• É estruturada em blocos de instruções,
• Possui transações e tratamento de erros,
• É formada por uma ou várias instruções,
• Combina procedimentos, e variáveis, e campos e tabelas implícitos dos diversos bancos conectados,
com elementos de iteração com usuário, utilizando-se de padrões para integrações com objetos
COM.
• Após a compilação gerará um arquivo binário, com extensão .R que depende da Máquina Virtual
para ser executado,
• É muito simples e com a pequena curva de aprendizagem,
• Aceita forma reduzida de comandos e instruções.
(18) 99747-8189
Banco de dados Progress OpenEdge

Seguro, de simples gestão, poderoso e leve.
Control Area
Arquivo .DB que contém os caminhos de todos os arquivos que compõem o banco.
Schema Area
É o meta-schema ou esquema do banco de dados, são as tabelas e campos que um banco utiliza para se
autogerenciar.
Application Data Area

É a área composta pelos vários arquivos do sistema aplicativo ou ERP. Deveria ser em arquivos diferentes do
Schema, mas na grande maioria dos clientes estará na Area do Schema.
Primary Recovery Area

É o primeiro mecanismo do banco de dados para garantir a integridade em caso de falhas e transações.
Neo Step
(18) 99747-8189
After-image Area
São as informações que foram salvas no banco de dados, mas que ainda não estão no backup.
Transaction log Area

São os arquivos que garantem transações distribuídas em rede entre bancos de dados Progress OpenEdge.
Encryption Policy Area

Área onde estão armazenadas todas as informações relacionadas à criptografia do Transparent Data
Encryption.
Audit data and index Area

É a área que mantem o mecanismo de auditoria, quando ativado, do banco dados.
Componentes lógicos
Tabelas
Coleção lógica de informações semelhantes, tabela de clientes, tabela de itens, tabelas de unidades de
medida.
Registro
Uma linha com um ou vários campos das tabelas.
Campos
Cada um dos constituintes de uma tabela que armazenam suas informações, por exemplo, código do cliente,
nome do cliente.
Chaves
Temos dois tipos, chaves únicas e primárias.
Única
São as chaves que garantem a unicidade, não repetição dos registros, por exemplo, código do cliente, cada
cliente tem um código único e que não se repete.
Primária
São as chaves que serão usadas quando o mecanismo de seleção dos índices da linguagem ABL não localizar
um índice apropriado.
Índices
São estruturas semelhantes às tabelas, que mantém informações dos campos que os compõem e do
endereço do registro da tabela, permitindo ao mecanismo de localização de registros localizar os registros
solicitados de forma mais rápida do que varrendo toda a tabela e seus registros.
Sequências
São objetos que permites o sequenciamento de números através de incrementos parametrizáveis e que não
são afetados por transações após o incremento ser acionado.
Relacionamentos entre tabelas

São as interações de interseção de conjuntos entre conjuntos distintos. Podendo ser relacionamento 1x1,
1xN ou NxN.
Neo Step
(18) 99747-8189
O banco de dados Sports2000, que usaremos nesse treinamento, tem suas tabelas relacionadas na seção
Anexo, no final desta apostila.
Relacionamento 1x1
Quando duas tabelas A e B estão relacionadas e esta relação é de um registro da tabela A para um registro
da tabela B, por exemplo, um cliente que possui informações complementares e estas pertencem somente a
este cliente.
Relacionamento 1xN
Quando duas tabelas A e B estão relacionadas e esta relação é de um registro da tabela A para muitos da
tabela B, por exemplo, um cliente possui muitos pedidos.
Relacionamento NxN
Quando duas tabelas A e B estão relacionadas e esta relação é de muitos para muitos, exemplo, muitos
pedidos têm relação com muitos itens.
Neo Step
(18) 99747-8189
Ferramentas especialistas
O OpenEdge contém várias ferramentas que auxiliam desde a construção de programas, manutenção de
dicionário de dados, exportação e importação de programas.
Além destas, as soluções Progress ainda abrangem:
• Soluções Cognitivas como DataRPM e Corticon,

• Conectividade de dados e integração com DataDirect,
• Gerenciamento WEB com Sitefinity e Sitefinity Digital Experience Cloud,
• Desenvolvimento HTML moderno com KENDO UI BUILDER e ROLLBASE,
• Backend na nuvem e sem servidor dedicado conhecido como Kinvey,
• Ainda conta com:
o Kendo UI para construção de HTML moderno usando HTML5 e Javascript,
o NativeScript para desenvolvimento mobile,
o NativeChat para desenvolvimento de ChatBots cognitivos,
o Plataforma Telerik,
o Test Studio para automação de testes.
Ferramentas especialistas da versão OE Studio
Principais ferramentas
• AppBuilder, construtor de programas de programas estruturados para ambiente TTY, Gráfico e Web,
• Application Compiler, compilador de programas,
• Audit Policy Maintenance, gestor da política de auditoria,
• Character Client, editor caracter para desenvolvimento de programas TTY,
Neo Step
(18) 99747-8189
• GUI Procedure Editor, editor de programas com interface gráfica para desenvolvimento de
programas,
• Developer Studio, Eclipse com plugin Progress para desenvolver programas modernos,
• Config, visualizador das licenças instaladas,
• Data Administration, exportação e importação de dados e definições, gestor de conexão com outros
bancos, listagem de programas,
• Data Dictionary, gestor de tabelas, campos, índices e sequências,
• Debugger, debugador de programas,
• Desktop, aplicação com atalho para as principais ferramentas,
• Help, arquivo de ajuda,
• Proenv, ambiente caracter com as variáveis do ambiente OpenEdge já atribuídas,
• OpenEdge Explorer, gestor de agentes de soluções para execução de programas remotos, agentes
webspeed e webservices, iniciador de bancos,
• Results, construtor de relatórios gráficos.
AppBuilder
Application Compiler
Neo Step
(18) 99747-8189
Procedure Editor (Client)
Data Administration
Data Dictionary
Neo Step
(18) 99747-8189
Desktop
Neo Step
(18) 99747-8189
Composição da sessão
A grande maioria das ferramentas utilizam a máquina virtual do OpenEdge, esta aceita
parâmetros muitos parâmetros, pois foi nasceu em ambiente Unix. Para aqueles que estão
acostumados com aplicações Windows pode parecer estranho uma linha de comando, com os
três alicerces (AVM, Propath e Banco de dados) assim:
C:\DLC101B\bin\prowin32.exe -basekey ini -ini scripts\ems2.ini -pf

scripts\ems2mult.pf -p scripts\alias.p
Dissecando este comando:
• Prowin32.exe é o executável OpenEdge da Máquina Virtual que interpreta comandos

de programas .R linguagem ABL.
• -basekey é o parâmetro que determina se as variáveis padrão OpenEdge serão
buscadas do Registry ou de um arquivo INI,
• -Ini é o arquivo INI da sessão,
• -pf são os parâmetros de conexão com os bancos de dados da sessão e outros
parâmetros de sessão,
• -p é o programa a ser executado com a inicialização da sessão.
Abaixo segue um pequeno exemplo de variáveis que deverão estar atribuídas no INI, no
Registry ou no Prompt de comandos (DOS).
Variável Descrição Exemplo

DLC Caminho da instalação do Progress DLC=C:\DLC102B
Promsgs Caminho do arquivo de mensagens PROMSGS=c:\dlc102B\promsgs
do Progress
Propath Lista de pastas dos programas PROPATH=.,C:\\ems206\EMS206-
LOCAL
(18) 99747-8189
Programas em ambiente TTY e Gráfico

Um programa desenvolvido para o ambiente TTY (Unix) pode executar em ambiente Gráfico (Windows) com
nenhuma ou poucas modificações.
Um programa TTY de exemplo.
/* declarando uma variavel */

DEFINE VARIABLE icodigoCliente AS INTEGER NO-UNDO
LABEL 'Codigo Cliente'.
/* criando um laço de repeticao */

REPEAT :
/* lendo um valor na variavel */

UPDATE icodigoCliente.
/* pesquisando no banco de dados */

FIND FIRST customer NO-LOCK
WHERE customer.custnum = icodigoCliente NO-ERROR.
/* se encontrou o cliente */
IF AVAILABLE customer THEN
DO:
/* mostrar o valor do registro para o usuario */
DISPLAY
customer.custnum
customer.NAME
customer.address
customer.city
customer.state
customer.creditlimit
WITH 1 COL.
END.
/* fim do bloco, mas por ser Repeat reiniciará a leitura */

END.
Programa TTY de exemplo
Programa exemplo executando em ambiente TTY (DOS ou UNIX)
Neo Step
(18) 99747-8189
Programa exemplo executando em ambiente gráfico (Windows)
Analisando o código do programa exemplo

1 DEFINE VARIABLE icodigoCliente AS INTEGER NO-UNDO
/* criando um laço de repetição, use ESC para sair*/

2 REPEAT :
/* lendo um valor na variavel */

3 UPDATE icodigoCliente.

4 FIND FIRST customer NO-LOCK
5 IF AVAILABLE customer THEN DO:
6 DISPLAY
customer.custnum
customer.NAME
customer.address
customer.city
customer.state
WITH 1 COL.
7 END.
Neo Step
(18) 99747-8189
/* fim do bloco, mas por ser Repeat reiniciará a leitura */

8 END.
1. Definição de variável do tipo inteiro, será usada para a leitura de um valor para auxiliar na
pesquisa da tabela Customer,
2. Inicio do laço de repetição Repeat,
3. Ler o valor da variável,
4. Pesquisar o cliente (customer) que o código do cliente (customer.custnum) é igual ao valor
digitado no passo 3,
5. Decisão com uso de IF THEN, no caso usamos a função AVAILABLE CUSTOMER para verificar se o
registro de cliente está disponível,
6. Utilizamos a instrução DISPLAY para mostrar o valor do BUFFER da tabela CUSTOMER,
7. Final do bloco IF THEN,
8. Final do bloco de REPEAT.
Um programa para Windows de exemplo.

DEFINE VARIABLE icodigoCliente AS INTEGER NO-UNDO
DEFINE FRAME principal

icodigoCliente
WITH
SIDE-LABELS
SIZE 40 BY 2.
ON RETURN OF icodigoCliente IN FRAME principal

DO:
ASSIGN INPUT icodigoCliente.

DO:
DISPLAY
customer.custnum
customer.NAME
customer.address
customer.city
customer.state
WITH 1 COL.
END.
END.
VIEW FRAME principal.

ENABLE ALL WITH FRAME principal.
DISPLAY icodigoCliente
Neo Step
(18) 99747-8189
WITH FRAME principal.
WAIT-FOR ENDKEY OF FRAME principal.

Programa para Windows de exemplo.
O resultado é:
Programa desenvolvido em ABL para ambiente gráfico (Windows).
Analisando o código do programa exemplo do Windows

1 DEFINE VARIABLE icodigoCliente AS INTEGER NO-UNDO
2 DEFINE FRAME principal

icodigoCliente
WITH
SIDE-LABELS
SIZE 40 BY 2.
3 ON RETURN OF icodigoCliente IN FRAME principal DO:
3.1 ASSIGN INPUT icodigoCliente.

3.2 FIND FIRST customer NO-LOCK
3.3 IF AVAILABLE customer THEN DO:
3.4 DISPLAY
Neo Step
(18) 99747-8189
customer.custnum
customer.NAME
customer.address
customer.city
customer.state
WITH 1 COL.
3.5 END.
3.6 END.
4 VIEW FRAME principal.

5 ENABLE ALL WITH FRAME principal.
6 DISPLAY icodigoCliente WITH FRAME principal.
7 WAIT-FOR ENDKEY OF FRAME principal.
1. Definição de variável para entrada de dados,

2. Definição de frame com a variável,
3. Gatilho de Return (ENTER),
3.1. Atribuir o valor que está no SCREEN-BUFFER para o RECORD BUFFER,
3.2. Localizar o registro no banco de dados e trazê-lo para o RECORD BUFFER,
3.3. Instrução condicional IF THEN (Se então) "Se registro do cliente estiver disponível",
3.4. Exibir os demais campos do cliente em uma tela criada automaticamente,
3.5. Fim do código do Gatilho,
4. Exibir a frame Principal,
5. Habilitar todos os campos da frame Principal, no exemplo, somente há o campo icodigoCliente,
6. Exibir o valor da variável icodigoCliente na tela, neste ponto, o Progress transfere o valor do RECORD
BUFFER para o SCREEN-BUFFER.
7. Aguardar até o ENDKEY (ESC) na tela para encerrar o programa.
Neo Step
(18) 99747-8189
ABL-DÔ - The Way of the ABL Programmer

Em minha experiência consegui formular esta frase que elenca as principais características que o
programador ABL deverá seguir a fim de se tornar um expert em Progress ABL.
FoFOCA Do Dia ToDo, Para Fazer PRograma
Um acrônimo para os principais comandos da linguagem Progress ABL focando a interação com registros em
banco de dados, a estrutura de um programa e a execução destes.
1. FIND, F
2. FOR EACH, F
3. OPEN QUERY, O
4. CREATE, C
5. ASSIGN, A
6. DELETE, D
7. DISPLAY, D
8. TRANSACTION, T
9. DO, D
10. PROCEDURE, P
11. FUNCTION, F
12. PERSISTENT, P
13. RUN, R
Acredito que todo programador, que queira ser um professional diferenciado, tem que dominar estas treze
instruções.
Find, For Each e Open Query para o acesso aos registros no banco de dados.
Create, Assign, Delete e Display para trabalhar com o registro, seja criando, seja atribuindo valores,
removendo ou exibindo o valor dos campos de uma tabela.
Saber trabalhar com Transaction e o bloco Do pode resolver vários problemas que considero problemas
básicos, como a criação de uma transação gigante que se inicia no começo do programa e somente será
completada ao término deste, algo muito ruim para qualquer programa, pois, na maioria das vezes, pode
criar uma Transação gigante e que estoura o parâmetro -L.
Dominar Procedures, Functions, sejam elas locais, ou através da técnica de programas em memória, com a
opção Persistent, assim como dominar a execução delas, sua passagem de parâmetros, usando a instrução
Run, facilitará a execução, a segmentação e o tratamento de código.
Neo Step
(18) 99747-8189
Debugger
Permite acompanharmos a execução passo a passo de programas, visualizarmos valores de variáveis, tabelas
temporárias e valores em registros de tabelas do banco.
Para utilizarmos o debugger precisamos habilitá-lo no nosso ambiente, para isso utilize o comando
ProDebugEnable -enable-all. Este comando deverá ser executado no prompt de comando com o utilitário
Proenv.
Sintaxe
proDebugEnable {-disable-all|-enable-all}
Exemplo
ProDebugEnable –enable-all
Anotações
O objeto Debugger
Para debugarmos um programa manipularemos o objeto Debugger.
É necessário iniciar o objeto Debugger antes de adicionar pontos de parada.
DEBUGGER:INITIATE().
Estando o Debugger iniciado basta adicionarmos os pontos de parada no programa com o comando
Debugger:Set-break().
DEBUGGER:SET-BREAK().
Exemplo
DEFINE NEW SHARED BUFFER CustBuf FOR customer.
DEFINE VARIABLE debug AS LOGICAL.

debug = DEBUGGER:INITIATE().
debug = DEBUGGER:SET-BREAK("r-ordbug.p",6).
FOR EACH CustBuf:

IF CAN-FIND(order OF CustBuf) THEN
RUN r-ordbug.p.
END. /* FOR EACH CustBuf */
debug = DEBUGGER:CLEAR().
Anotações
Neo Step
(18) 99747-8189
Exercício
1. Debug o programa abaixo.
DEFINE VARIABLE icont AS INTEGER NO-UNDO INIT 1.
1 DISP icont.
RUN retornarValor ( INPUT icont).
4 DISP icont.
PROCEDURE retornarValor:
DEFINE INPUT PARAMETER valor AS INTEGER NO-UNDO.
2 valor = valor + 10.
3 DISP valor.
END.
Utilizando a opção Add Watch (botão direito) sobre as variáveis icont e valor anote os valores nos
pontos:
1.
2.
3.
4.
FOR EACH customer NO-LOCK

WHERE custnum > 3 AND custnum < 10:
Neo Step
(18) 99747-8189
DISP custnum NAME.
END.
Utilizando a página Buffers, selecione o buffer Customer e visualize os valores dos campos com a opção
Dataview.

DEFINE VARIABLE iordernum AS INTEGER NO-UNDO.
DEFINE VARIABLE dtorderdate AS DATETIME NO-UNDO.

WHERE custnum > 3 AND custnum < 10:
DISP custnum NAME.
FOR EACH order OF customer:

ASSIGN
iordernum = ordernum
dtorderdate = orderdate.
END.
END.
Utilizando as páginas Buffers e Variables anote os números e datas e dos pedidos (Order) dos clientes 5
(Match Point Tennis), 7 (Aerobics Valine Ky) e 8 (Game Set Match).
Cliente Números dos Pedidos Datas dos Pedidos

Match Point Tennis
Aerobics Valine Ky
Game Set Match
Neo Step
(18) 99747-8189
Objetos System Handle

A linguagem ABL tem vários objetos system handle, que são objetos que não necessitam de define ou create,
pois estão presentes na AVM. Estes objetos desempenham várias funções diferentes, como manipulação da
área de transferência (CLIPBOARD), manipulação do arquivo de log, tratamento de do objeto com foco
(FOCUS) e muitas outras funcionalidades.
Principais objetos:
• FOCUS system handle,

• CLIPBOARD system handle,
• THIS-PROCEDURE system handle,
• LOG-MANAGER system handle,
• ACTIVE-WINDOW system handle,
• DEBUGGER system handle,
• ERROR-STATUS system handle,
• FILE-INFO system handle,
• SESSION system handle,
• SELF system handle,
FOCUS system handle

É o handle do objeto (WIDGET) que tem o foco.
Sintaxe
FOCUS [ :attribute ]
O objeto Focus retorna o handle do objeto com o foco em uma janela.
Os atributos do objetos Focus variarão conforme o tipo do objeto com foco.
Exemplo de Focus
Construa uma janela com alguns objetos
Na sessão Main Block adicione o código
ON 'ctrl-j':U ANYWHERE
Neo Step
(18) 99747-8189
DO:
DEFINE VARIABLE hframe AS HANDLE NO-UNDO.

DEFINE VARIABLE hwindow AS HANDLE NO-UNDO.
hframe = FOCUS:FRAME.
hwindow = hframe:PARENT.
MESSAGE
"nome widget:" FOCUS:NAME SKIP
"tipo do widget:" FOCUS:TYPE SKIP
"nome da frame:" hframe:NAME SKIP
"titulo da janela:" hwindow:TITLE
VIEW-AS ALERT-BOX INFORMATION BUTTONS OK.
END.
Este código mostrará o nome do objeto focado, o tipo, o nome da frame, o título da janela.
Execute o programa e pressione CTRL-J e deverá aparecer a mensagem abaixo se o botão 1 estiver
selecionado.
Agora selecionando o Fill-In e usando o CTRL-J
Habilitando objetos na tela

Este código tem a funcionalidade de habilitar objetos na tela, mas tem que existir pelo menos um objeto que
possa receber foco.
ON 'ctrl-j':U ANYWHERE
DO:
Neo Step
(18) 99747-8189
DEFINE VARIABLE hframe AS HANDLE NO-UNDO.

DEFINE VARIABLE hwindow AS HANDLE NO-UNDO.
hframe = FOCUS:FRAME.
hwindow = hframe:PARENT.
DEFINE VARIABLE hobjeto AS HANDLE NO-UNDO.
/* capturar o primeiro field-group da janela */

hobjeto = hframe:FIRST-CHILD.
/* capturar o primeiro objeto do field-group */
hobjeto = hobjeto:FIRST-CHILD.
DO WHILE VALID-HANDLE(hobjeto) = TRUE:

IF CAN-QUERY(hobjeto, 'SENSITIVE') THEN
hobjeto:SENSITIVE = TRUE.
hobjeto = hobjeto:NEXT-SIBLING.
END.
END.
Anotações
CLIPBOARD system handle

É o handle da área de transferência.
Sintaxe
CLIPBOARD [ :attribute ]
Com este objeto você pode copiar ou gravar informações na área de transferência do Windows.
Exemplo
clipboard:value = "OpenEdege é muito simples!".
MESSAGE clipboard:value
VIEW-AS ALERT-BOX INFO BUTTONS OK.
Anotações
THIS-PROCEDURE system handle

É o handle do programa corrente.
Sintaxe
Neo Step
(18) 99747-8189
procedure-handle [ :attribute | :method ]
Exemplo de This-Procedure
Construa uma janela e adicione o código abaixo
MESSAGE
'Procedures internas='
THIS-PROCEDURE:INTERNAL-ENTRIES SKIP
'Persistent?' THIS-PROCEDURE:PERSISTENT SKIP
'Tipo=' THIS-PROCEDURE:TYPE SKIP
'Bancos do programa=' THIS-PROCEDURE:DB-REFERENCES
Localizando procedures internas de um programa persistent

Também é possível localizar as procedures internas de um programa persistente, basta substituir o THIS-
PROCEDURE pelo handle do programa persistente.
DEFINE VARIABLE hprograma AS HANDLE NO-UNDO.
RUN basico/programaA.p PERSISTENT SET hprograma.
MESSAGE
'Procedures internas=' hprograma:INTERNAL-ENTRIES SKIP
'Persistent?' hprograma:PERSISTENT SKIP
'Tipo=' hprograma:TYPE SKIP
'Bancos do programa=' hprograma:DB-REFERENCES
DELETE OBJECT hprograma.
Pegando a assinatura da procedure

É possível usar o método GET-SIGNATURE para conhecer os parâmetros de entrada e saída das procedures
internas.
Antes de executar o código, adicione a procedure interna abaixo.
PROCEDURE procedure-interna :
/*---------------------------------------------------------------------
---------
Purpose:
Parameters: <none>
Notes:
-----------------------------------------------------------------------
-------*/
DEFINE INPUT PARAMETER p1 AS CHARACTER NO-UNDO.
DEFINE INPUT-OUTPUT PARAMETER p2 AS INTEGER NO-UNDO.
DEFINE OUTPUT PARAMETER p3 AS DECIMAL NO-UNDO.
DEFINE OUTPUT PARAMETER p4 AS DATE NO-UNDO.
END PROCEDURE.
Agora execute o código abaixo.
MESSAGE
'Procedures internas=' THIS-PROCEDURE:INTERNAL-ENTRIES SKIP
Neo Step
(18) 99747-8189
'Persistent?' THIS-PROCEDURE:PERSISTENT SKIP

'Tipo=' THIS-PROCEDURE:TYPE SKIP
'Bancos do programa=' THIS-PROCEDURE:DB-REFERENCES SKIP
'Assinatura procedure-interna=' THIS-PROCEDURE:GET-SIGNATURE('procedure-
interna')
Exibirá esta mensagem
Para mais detalhes sobre THIS-PROCEDURE procure por Procedure object handle.
Anotações
LOG-MANAGER system handle

É o handle do manipulador de log, equivale ao –clientlog da sessão.
Sintaxe
LOG-MANAGER [ :attribute | :method ]
Exemplo de criação arquivo de log em tempo de execução

log-manager:LOGFILE-NAME = session:temp-dir + 'meulog.txt'.
log-manager:LOGGING-LEVEL = 4.
log-manager:log-entry-types = "4GLMessages,4GLTrace,FileID".
log-manager:write-message("gravar este texto no arquivo.").
Limpando o log
log-manager:clear-log().
Neo Step
(18) 99747-8189
A limpeza do Log, através do método CLEAR-LOG não funciona para AppServer e WebSpeed.
Anotações
ACTIVE-WINDOW system handle

É o handle da janela ativa.
Anotações
DEBUGGER system handle

É o handle para “debugar” um programa, para ativá-lo veja o capítulo Debugger.
Sintaxe
DEBUGGER [ :attribute | :method ]
Exemplo
DEFINE STREAM stream1.
PAUSE 0 BEFORE-HIDE.
OUTPUT stream stream1 to "c:\temp\cliente.txt"

paged
page-size 40
convert target 'ISO8859-1'.
FOR EACH customer NO-LOCK:
DISPLAY STREAM stream1

customer.custnume
customer.name
WITH STREAM-IO.
END.
OUTPUT stream stream1 close.

Deverá aparecer a janela abaixo.
Neo Step
(18) 99747-8189
Utilize os botões Step Into, Step Over e Step Out para continuar a execução do programa.
Use as abas Variables, Buffers, Parameters, Temp-tables e Dataset para verificar o conteúdo de cada tipo de
objeto.
Anotações
ERROR-STATUS system handle

É o handle do estado de erro da última instrução com no-error.
Sintaxe
ERROR-STATUS [ :attribute | :method
Exemplo
DEFINE VARIABLE idade AS INTEGER NO-UNDO.
idade = int("A") NO-ERROR.
IF ERROR-STATUS:ERROR THEN
DO:
MESSAGE
"Mensagem: " ERROR-STATUS:GET-MESSAGE(1) SKIP
"Numero de erros: " ERROR-STATUS:NUM-MESSAGES SKIP
END.
Neo Step
(18) 99747-8189
Anotações
FILE-INFO system handle

É o handle de qualquer arquivo do disco, podendo ser programa, pasta ou um arquivo qualquer.
Sintaxe
FILE-INFO [ :attribute ]
Exemplo
FILE-INFO:FILE-NAME = "c:\temp".
MESSAGE
"Tipo: " FILE-INFO:FILE-TYPE SKIP
FILE-INFO:FILE-NAME = 'gui/_dict.r'.
MESSAGE
"Tipo: " FILE-INFO:FILE-TYPE SKIP
"Caminho completo: " FILE-INFO:FULL-PATHNAME
O atributo File-type retornará D para pastas e F para arquivos, R para arquivo acessível e W para arquivo ou
pasta com permissão para gravar.
Anotações
SESSION system handle

É o handle da sessão ativa.
Sintaxe
SESSION [ :attribute | :method ]
Entre os principais atributos, cito:
• CPSTREAM , informa o código de página da sessão.

• CLIENT-TYPE , informa o tipo da sessão em execução, podendo ser 4GLCLIENT, WEBCLIENT,
APPSERVER, WEBSPEED ou ? (desconhecido).
• DATE-FORMAT, indica o formato da data, podendo ser MDY ou DMY.
Neo Step
(18) 99747-8189
• DEBUG-ALERT, deve apresentar o botão HELP na mensagem de erro, para exibir a janela com a pilha
de programas executados.
• DISPLAY-TYPE , indica se o tipo de exibição é gráfico (GUI) ou caractere (TTY),
• NUMERIC-DECIMAL-POINT, indica o caractere utilizado para a formatação de número decimal,
• WORK-AREA-WIDTH-PIXELS, indica a largura da área disponível do desktop Windows que não está
escondida pelas barras do sistema.
• WORK-AREA-HEIGHT-PIXELS, indica a altura da área disponível do desktop Windows que não está
escondida pelas barras do sistema.
Anotações
SELF System Handle

É o handle do objeto em execução do código de gatilho.
Com este handle podemos referenciar os atributos de cada tipo de objeto, vale lembrar que diferentes
objetos possuem diferentes métodos e atributos.
Resultado da execução com o SELF
Neo Step
(18) 99747-8189
Neo Step
(18) 99747-8189
Operadores
Lista de operadores da linguagem.
Operador Descrição
+ Adição
- Subtração
* Multiplicação
/ Divisão
= Igualdade
<> Desigualdade
> Maior que
< Menor que
>= Maior ou igual que
<= Menor ou igual que
AND E
OR OU
NOT NOT
BEGINS Compara o início das letras de duas expressões
MATCHES Compara duas STRINGS
GT Maior que
GE Maior ou igual que
LT Menor que
LE Menor ou igual que
Modulo Retornar o resto da divisão
No Progress ABL não há frescura de outras linguagens e você pode somar, dividir, multiplicar, subtrair e
outras operações com números inteiros, inteiros de 64 bits e decimais sem perda de valores ou erros de
ponto flutuante.
Então somar decimais com inteiros, ou dividir tipos numéricos diferentes não tem problema!
Anotações
Neo Step
(18) 99747-8189
Exercício
Para a nomenclatura dos exercícios, utilize a máscara OPER_<número do exercício>.P (oper_1.p, oper_2.p).
1. Declare duas variáveis do tipo inteiro, faça a somatória e exiba os valores delas (Instrutor).
2. Declare três variáveis caracter para armazenar nome, sobrenome e nome completo, concatene-as e
exiba o valor resultante. Uma variável receberá a soma das outras duas.
3. Faça a somatória de duas variáveis decimais.
4. Utilizando o segundo exercício, faça a concatenação do seu nome completo com a sua idade, utilize
a função String para converter valores para caracter antes de unir nome completo e idade.
5. Some a raiz quadrada de 2 com a raiz quadrada de 3 em uma variável decimal, exibindo este valor.
Utilize a função SQRT.
6. Utilizando o quinto exercício, melhore-o para exibir o valor da soma com 5 casas decimais.
7. Usando três variáveis, obtenha a razão do seu peso pelo quadrado da sua altura.
8. Usando a função MODULO obtenha o resultado da divisão de 3 por 2.
Neo Step
(18) 99747-8189
Banco de dados, Record Buffer e Screen Buffer

A linguagem ABL tem várias áreas de memória, estas áreas possuem diferentes valores para a mesma
variável por questão de segurança, e que anteriormente fora amplamente alardeado, mas hoje é algo básico.
Segmentos
Database
É onde estão os valores dos campos das tabelas, no banco de dados, quando fazemos um FIND o Progress ao
encontrar o registro, o transfere para o Record Buffer.
Record Buffer
É uma área da memória onde o programador pode fazer a manipulação do valor real de um campo de tabela
ou de uma variável.
Screen Buffer
É o valor da variável que é exibido ao usuário.
Instruções de transferência
Temos muitas instruções que transferem os valores entre os vários buffers.
Instrução Descrição
FIND Localizar um registro no banco de dados (Database) e disponibilizá-lo no Record
buffer.
Update É uma instrução complexa, formada pelos comandos Display, Prompt-For e Assign.
A principal função é exibir o valor da variável ou campo, habilitar para o usuário
digitar valor e atribuir do Screen-buffer para o Record Buffer.
Display Transferir o valor, do campo ou variável, que está no Record Buffer para o Screen-
buffer, em outras palavras, exibir o valor da variável.
Neo Step
(18) 99747-8189
Assign Atribuir o valor que está no Screen-buffer para o Record Buffer.
For Localizar um registro no banco de dados (Database) e disponibilizá-lo no Record

Buffer, mas faz um laço de repetição com os muitos registros que uma cláusula
'where' resolver.
Prompt-for Transferir o que foi digitado para o Screen-buffer da variável.
Enable Habilitar campos em uma frame.
Neo Step
(18) 99747-8189
Buffers, Temp-tables e Datasets

Buffers
Buffers são ponteiros para tabelas do dicionário e para tabelas temporárias.
A linguagem ABL disponibiliza um ponteiro por tabela e em algumas situações poderemos necessitar
localizar mais de um registro na tabela pesquisada, para esta situação a utilização de Buffers é obrigatória.
Sintaxe Buffer
DEFINE { [ [ NEW ] SHARED ] | [ PRIVATE | PROTECTED ] [ STATIC ] }

BUFFER buffer-name
FOR [ TEMP-TABLE ] table-name
[ PRESELECT ] [ LABEL label-name ]
[ NAMESPACE-URI namespace ] [ NAMESPACE-PREFIX prefix ]
[ XML-NODE-NAME node-name ]
O Buffer pode ser compartilhado com as opções New e Shared.
Exemplo
DEFINE BUFFER bcustomer FOR customer.
Exemplo de Buffer e Find
/* buffer */
DEF BUFFER buf-customer FOR customer.
FIND FIRST buf-customer

WHERE buf-customer.custnum = 10.
Exemplo de Buffer com For Each
DEFINE BUFFER buf-customer FOR customer.
DISP customer.custnum customer.NAME customer.salesrep.
FIND LAST buf-customer NO-LOCK

WHERE buf-customer.salesrep = customer.salesrep NO-ERROR.
DISP buf-customer.salesrep LABEL 'Representante'.
END.
Exemplo de Buffer com passagem de parâmetro
PROCEDURE receberBuffer:
DEFINE PARAM BUFFER buf-customer FOR customer.
(18) 99747-8189
DISP buf-customer.custnum buf-customer.NAME buf-customer.address WITH 1

COL.
END.
DEF VAR codigo AS INTEGER NO-UNDO.
REPEAT :
UPDATE codigo.

WHERE customer.custnum = codigo NO-ERROR.
IF AVAIL customer THEN DO:
DISP customer.custnum customer.NAME WITH TITLE 'cliente'.
RUN receberBuffer ( BUFFER customer ).

END.
END.
Exemplo de buffer com atualização de dados
PROCEDURE receberBuffer:
DEFINE PARAMETER BUFFER buf-customer FOR customer.
DISPLAY buf-customer.custnum.
UPDATE
buf-customer.NAME
buf-customer.address
WITH 1 COL.
END.
DEFINE VARIABLE codigo AS INTEGER NO-UNDO.
REPEAT :
UPDATE codigo.
FIND FIRST customer EXCLUSIVE-LOCK


DO:
DISPLAY customer.custnum customer.NAME WITH TITLE 'cliente'.
RUN receberBuffer ( BUFFER customer ).

END.
END.
Exemplo de Buffer com Display e Except
35
(18) 99747-8189
/* explicito = declarado */
DEFINE BUFFER buf-customer FOR customer.
FIND FIRST buf-customer.

IF AVAIL buf-customer THEN DO:
DISP buf-customer
EXCEPT buf-customer.comments
WITH 2 COL.
END.
Tabelas temporárias
São Tabelas que podem armazenar temporariamente grande volumes de dados, esses registros de tabelas
temporárias existem somente durante a execução de programas, podem conter índices e demais
características de uma tabela (buffer implícito ou explicito), não disparam qualquer gatilho ou e também não
geram transação.
Quanto a sua estrutura, podem ser imagens de tabelas do banco, com campos e índices, podem-se adicionar
novos campos ou ainda podem ser totalmente novas (campos e índices).
Sintaxe temp-table
DEFINE {[[ NEW [ GLOBAL ]] SHARED ]|

[ PRIVATE | PROTECTED ][ STATIC ]
[ SERIALIZABLE ]}
TEMP-TABLE temp-table-name[ NO-UNDO ]
[ NAMESPACE-URI namespace][ NAMESPACE-PREFIX prefix]
[ XML-NODE-NAME node-name][ SERIALIZE-NAME serialize-name ]
[ REFERENCE-ONLY ]
[ LIKE table-name
[ VALIDATE ]
[ USE-INDEX index-name[ AS PRIMARY ]]...]
[ LIKE-SEQUENTIAL table-name
[ VALIDATE ]
[ USE-INDEX index-name[ AS PRIMARY ]]...]
[ RCODE-INFORMATION ]
[ BEFORE-TABLE before-table-name]
[ FIELD field-name
{ AS data-type| LIKE field[ VALIDATE ]}
[field-options]
]...
[ INDEX index-name
[[ AS | IS ][ UNIQUE ][ PRIMARY ][ WORD-INDEX ]]
{index-field[ ASCENDING | DESCENDING ]}...
]...
Exemplo de Temp-Table
36
(18) 99747-8189
DEFINE TEMP-TABLE ttCustomer LIKE customer.
Sintaxe temp-table com novo campo
DEFINE TEMP-TABLE ttCustomer LIKE customer

FIELD icontador AS INTEGER.
Sintaxe temp-table com novo campo e novo índice*
DEFINE TEMP-TABLE ttCustomer LIKE customer

FIELD icontador AS INTEGER
INDEX ix_contador icontador.
*AO ADICIONAR NOVO ÍNDICE EM UMA TEMP-TABLE NENHUM ÍNDICE SERÁ HERDADO DA TABELA ORIGEM.
Exemplo de Temp-table
/* primeiro tipo - tabela temporaria com estrutura identica à uma tabela do

banco */
DEFINE TEMP-TABLE ttCustomer

LIKE customer.
CREATE ttCustomer.
UPDATE ttcustomer
WITH
1 COL
WIDTH 222.
Exemplo de Temp-table com índices
/* primeiro tipo - tabela temporaria com estrutura identica à uma tabela do

banco */

LIKE customer.
/* like de outra TT */
DEFINE TEMP-TABLE ttCustomerEx LIKE ttCustomer.
DEFINE TEMP-TABLE ttCustomer2

FIELD codigo AS INTEGER
FIELD nome AS CHAR FORMAT 'x(35)' LABEL 'Nome'
FIELD endereco AS CHAR
INDEX
ix_codigo AS UNIQUE AS PRIMARY
codigo
INDEX
ix_nome
nome.
37
(18) 99747-8189
DEFINE TEMP-TABLE ttCustomer3 LIKE customer

FIELD filiacao AS CHAR FORMAT 'x(35)' LABEL 'Filiação'
.
CREATE ttCustomer3.
UPDATE ttcustomer3
WITH
1 COL
SIZE 122 BY 8.
*Neste exemplo nenhum índice da tabela Customer será copiada para a temp-table ttCustomer2 pois houve
criação de índice nesta temp-table, já na ttCustomer todos os índices da tabela Customer serão usados.
Exemplo de Temp-table com Buffer-copy

LIKE customer
FIELD codigo AS INTEGER.
/* copiar todos os dados da tabela customer para a temp-table */

CREATE ttCustomer.
/*
BUFFER-COPY source [ { EXCEPT | USING } field ... ] TO target [ ASSIGN
assign-expression ... ] [ NO-LOBS ] [ NO-ERROR ]
*/
BUFFER-COPY customer
TO ttCustomer
ASSIGN ttCustomer.codigo = customer.custnum.
END.
PAUSE.
FOR EACH ttcustomer:

DISP ttcustomer.custnum ttcustomer.NAME ttcustomer.address
ttcustomer.codigo.
END.
Exemplo de Temp-table com erro 229 - ** Could not find Index <index-name> in table <table>. (229), pois
declaramos um índice na Temp-table, nenhum índice da tabela Customer será incluído, mas forçamos o uso
do índice ContryPost da tabela Customer.

LIKE customer

/* A linguagem progress ABL nao copia nenhum indice da tabela do banco para
a TT */
INDEX ix_name NAME .
/* copiar todos os dados da tabela customer para a temp-table */

38
(18) 99747-8189
CREATE ttCustomer.
/*
BUFFER-COPY source [ { EXCEPT | USING } field ... ] TO target [ ASSIGN
assign-expression ... ] [ NO-LOBS ] [ NO-ERROR ]
*/
BUFFER-COPY customer
TO ttCustomer
ASSIGN ttCustomer.codigo = customer.custnum.
END.
PAUSE.
/*
** Could not find Index CountryPost in table ttCustomer. (229)
** Nao entendi a linha 24. (196)
A linguagem progress ABL nao copia nenhum indice da tabela do banco para a
TT
*/
FOR EACH ttcustomer

USE-INDEX CountryPost:
DISP
ttcustomer.custnum
ttcustomer.NAME
ttcustomer.address
ttcustomer.codigo
WITH STREAM-IO WIDTH 111.
END.
Exemplo de Temp-table com índice único e primário
/* posso fazer like dos campos da TT */

DEFINE TEMP-TABLE ttclientes
FIELD codigo LIKE customer.custnum
FIELD nome LIKE salesre.repname
FIELD endereco LIKE customer.address
INDEX ix_codigo AS UNIQUE AS PRIMARY codigo

.
Datasets
São objetos com uma ou um conjunto de tabelas temporárias, que utilizam um data-source para acessar os
registros no banco de dados através de objetos queries ou através de buffers.
Estes objetos Datasets precisam de tabelas temporárias, e cada uma destas tabelas temporárias precisa de
um data-source para poder carregar seus registros.
As tabelas temporárias de um dataset também podem salvar suas alterações nas tabelas das quais foram
carregadas.
39
(18) 99747-8189
Sintaxe do Dataset
DEFINE {[[ NEW ] SHARED ]|[ PRIVATE | PROTECTED ] [ STATIC ][
SERIALIZABLE ]}
DATASET dataset-name
[ NAMESPACE-URI namespace][ NAMESPACE-PREFIX prefix]
[ XML-NODE-NAME node-name][ SERIALIZE-NAME serialize-name ]
[ XML-NODE-TYPE node-type ][ SERIALIZE-HIDDEN ][ REFERENCE-ONLY ]
FOR buffer-name [ , buffer-name]...
[ DATA-RELATION [data-rel-name ] FOR data-rel-spec ]...
[ PARENT-ID-RELATION [data-rel-name] FOR parent-id-rel-spec]...
À primeira vista o objeto Dataset é complexo, mas vamos detalhar suas opções e incrementar a sua
complexidade em cada exemplo.
Sintaxe do Datasource
DEFINE [ PRIVATE | PROTECTED ] [ STATIC ] DATA-SOURCE data-source-name
FOR [ QUERY query-name]
[source-buffer-phrase[ , source-buffer-phrase]...]
Receita de bolo para o funcionamento

Eis as receitas...
Dataset com data-source usando buffer

1. Definir a tabela temporária,
2. Definir o dataset, relacionando o buffer da tabela temporária ao dataset,
3. Definir o data-source para acessar os dados do banco através do buffer,
4. Linkar o buffer da tabela temporária ao data-source,
a. Opcionalmente, pode-se usar o atributo Fill-Where-String para usar Where da pesquisa à
tabela,
5. Usar o método FILL do dataset para preencher a tabela temporária.
Dataset com data-source usando query

1. Definir a tabela temporária,
40
(18) 99747-8189
2. Definir o dataset, relacionando o buffer da tabela temporária ao dataset,

3. Definir a query,
a. Preparar a query com a cláusula Where,
b. Abrir a query,
4. Definir o data-source para acessar os dados do banco através da query,
5. Linkar o buffer da tabela temporária ao data-source,
6. Usar o método FILL do dataset para preencher a tabela temporária.
Dataset com uma tabela e usando buffer

DEFINE TEMP-TABLE ttcustomer
LIKE customer.
DEFINE DATASET dts-customer FOR ttcustomer.
DEFINE DATA-SOURCE data-source-customer FOR customer.
BUFFER ttcustomer:ATTACH-DATA-SOURCE( DATA-SOURCE data-source-

customer:handle ).
DATASET dts-customer:FILL().
FOR EACH ttcustomer:

DISPLAY
ttcustomer.custnum
ttcustomer.name
ttcustomer.contact.
END.
Dataset com uma tabela usando query

DEFINE TEMP-TABLE ttitem LIKE sports2000.item.
DEFINE DATASET dts-item FOR ttitem.

DEFINE QUERY qitem FOR sports2000.item.
DEFINE DATA-SOURCE data-source-item FOR QUERY qitem.
/* unir o buffer da tt com o data-source */

BUFFER ttitem:ATTACH-DATA-SOURCE(DATA-SOURCE data-source-item:handle).
QUERY qitem:QUERY-PREPARE("for each item where item.itemnum >= 10 and

item.itemnum <= 15 ").
QUERY qitem:QUERY-OPEN().
/* carregar o dataset */
DATASET dts-item:FILL().
FOR EACH ttitem:

DISPLAY ttitem WITH 1 COL.
END.
Anotações
41
(18) 99747-8189
42
(18) 99747-8189
Exercício
Para a nomenclatura dos exercícios, utilize a máscara BF_TT_<número do exercício>.P (BF_TT_1.p,
BF_TT_2.p).
1. Crie uma tabela temporária cópia da tabela customer, copie os dados para esta tabela, exibindo-os
com o For each.
2. Com o For each e Buffer, mostre os campos da tabela pedidos (Order).
3. Crie uma tabela temporária cópia da tabela customer, copie os dados para esta tabela, exibindo-os
com o For each. Localize todos pedidos dos clientes na tabela temporária.
4. Crie uma tabela temporária cópia da tabela customer,
a. Crie um novo índice para o campo custnum.
b. Copie os dados para esta tabela, exibindo-os com o For each e com o uso da cláusula “use-
index Name”.
c. Ocorre erro? Qual? Por quê? Quais as possíveis soluções?
5. No capítulo Importação e Exportação, no quinto exercício, exportamos um arquivo da tabela
salesrep,
a. Crie uma tabela temporária cópia da tabela salesrep, use Like e No-undo,
b. Importe os dados do arquivo para a tabela temporária,
c. Utilize For each para listar os registros importados na tabela temporária.
6. A partir do quinto exercício, substitua a instrução For Each por Open Query, Get e Repeat, exibindo
os registros de forma indistinta ao quinto exercício.
43
(18) 99747-8189
Criação, Atribuição e Eliminação de Registros

Há vários comandos para a manipulação de registros no banco de dados, podemos citar:
• Create e Insert, para inserir registros,

• Delete, para remover registros.
Instrução Create
A instrução Create cria um registro em uma tabela, seja esta uma tabela de banco de dados ou uma tabela
temporária (temp-table, atribui aos campos seus valores iniciais e move o registro para a área de Record
Buffer.
Sintaxe
CREATE record
[ USING { ROWID ( nrow ) | RECID ( nrec ) } ] [ NO-ERROR ]
Exemplo
REPEAT:
CREATE Order.
UPDATE Order.OrderNum Order.CustNum
VALIDATE(CAN-FIND(Customer OF Order), "Customer does not
exist")
Order.CustNum Order.OrderDate.
REPEAT:
CREATE OrderLine.
OrderLine.OrderNum = Order.OrderNnum.
UPDATE OrderLine.LineNum OrderLine.ItemNum
VALIDATE(CAN-FIND(Item OF OrderLine), "Item does not
exist")
OrderLine.Qty OrderLine.Price.
END.
END.
Importante: ao executar a instrução de CREATE o gatilho de CREATE é executado em seguida.
Anotações
Exemplo de Create com verificação de existência de registro
DEF VAR codigoItem LIKE ITEM.itemnum

LABEL 'Codigo item'
NO-UNDO.
REPEAT :
UPDATE codigoItem.
FIND FIRST ITEM NO-LOCK

WHERE ITEM.itemnum = codigoItem NO-WAIT NO-ERROR.
44
(18) 99747-8189
IF AVAIL ITEM THEN DO:
FIND CURRENT ITEM EXCLUSIVE-LOCK.
/* otimizar o update item, validate e release */

UPDATE ITEM
EXCEPT
ITEM.itemnum
WITH
1 COL
THREE-D
FRAME alterar
TITLE 'Atualizacao de item'.
VALIDATE ITEM.
RELEASE ITEM.
END.
ELSE
IF NOT AVAIL ITEM THEN DO:
CREATE ITEM.
UPDATE ITEM
WITH
1 COL
FRAME inserir
THREE-D
TITLE 'Adiçaõ de item'.
VALIDATE ITEM.
RELEASE ITEM.
END.
ELSE
IF LOCKED ITEM THEN DO:
MESSAGE 'Registro ' codigoItem ' em uso por outro usuario'
VIEW-AS ALERT-BOX
ERROR
BUTTONS OK.
END.
END.
Instrução Insert
A instrução Insert é um conjunto de instruções, como Create, Display, Prompt-for e Assign.
Sintaxe
INSERT record [ EXCEPT field ... ]

[ USING { ROWID ( nrow ) | RECID ( nrec ) } ]
[ frame-phrase ]
[ NO-ERROR ]
Exemplo
45
(18) 99747-8189
REPEAT:
INSERT Order WITH 1 COLUMN.
REPEAT:
CREATE OrderLine.
OrderLine.OrderNum = Order.OrderNum.
UPDATE OrderLine.LineNum OrderLine.ItemNum OrderLine.Qty
OrderLine.Price.
/* Verify the ItemNum by finding an Item with that number */
FIND Item OF OrderLine.
END.
END.
Importante: Ao executar a instrução de INSERT o gatilho de CREATE é executado.
Anotações
Instrução de Assign
Utilize esta instrução Assign para atribuir a um campo, ou a vários campos de tabelas o valor desejado. Antes
do término da transação o gatilho de WRITE será executado, e estes valores atribuídos serão gravados no
banco quando a transação chegar ao fim, o término da transação pode ser o END de um DO TRANSACTION,
ou de um REPEAT ou de um FOR EACH, dependendo do escopo desta transação.
Instrucao de Update também pode ser utilizada, assim como somente o uso do operador igual “=”
Sintaxe
Exemplo
DEFINE VARIABLE NOME LIKE SALESREP.REPNAME NO-UNDO.
/* Pesquisando e ALTERANDO os registros

DA Tabela Salesrep usando o first para o primeiro registro da tabela = DKP
*/
FOR FIRST salesrep EXCLUSIVE-LOCK
WHERE Salesrep.SalesRep = 'DKP':
ASSIGN
NOME = Salesrep.RepName.
UPDATE nome.
ASSIGN
Salesrep.RepName = nome.
/* PESQUISANDO E ALTERANDO OS REGISTROS DA CUSTOMER IGUAIS A SALESREP

'DKP' */
FOR EACH CUSTOMER EXCLUSIVE-LOCK
OF SALESREP:
DISPLAY
customer.custnum
46
(18) 99747-8189
customer.name.
UPDATE
Customer.CreditLimit.
END.
END.
Instrução Delete
Elimina o registro do Record Buffer e do banco de dados.
Sintaxe
DELETE record
[ VALIDATE ( condition , msg-expression ) ]
[ NO-ERROR ]
Exemplo
FOR FIRST Customer

WHERE CUSTOMER.CUSTNUM = 5:
DELETE Customer.
END.
Importante: Antes de eliminar o registro da tabela, o gatilho de DELETE é executado, se utilizarmos o
RETURN ERROR é possível parar a eliminação. Vale lembrar que a eliminação do registro está em uma
TRANSAÇÃO e somente ao término desta é que o registro será eliminado.
Anotações
Importante
• Eliminando registros não diminui o tamanho do banco de dados, somente com Dump e Load,
• Se há gatilhos de Delete estas são executadas antes do registro ser eliminado,
o Se ocorrer erro durante a execução da Trigger de Delete ou esta retornar a instrução
“Return ERROR”, o registro não é eliminado.
• Se há validação “Validate” na instrução de Delete e Trigger de Delete, a validação é executada antes
da Trigger.
47
(18) 99747-8189
Exercício
Para a nomenclatura dos exercícios, utilize a máscara INSDEL_<número do exercício>.P (INSDEL _1.p, INSDEL
_2.p).
1. Utilizando a instrução Create e Update dentro de um Repeat, crie novos registros para a tabela
Customer, o usuário deverá preencher os campos Customer.Name e Customer.SalesRep (BBB, DKP,
DOS, GPE, HXM, JAL, KIK, RDR, SLS são valores válidos para o campo SalesRep),
2. Crie um programa que contenha uma Frame para a entrada de dados, conforme a imagem abaixo.
Adicione variável LIKE customer.custnum, em um Repeat leia o código do cliente e localize-o com o
código informado (find com no-lock) e exiba o nome do cliente na Frame (customer.name).
Verifique se o registro existe (If avail) e com um bloco de Do Transaction use o find current, faça um
exclusive-lock.
Questione o usuário sobre eliminar o registro localizado, conforme a imagem abaixo, se confirmar a
eliminação, remova-o.
3. A partir do segundo exercício, adicione tratamento, se ocorrer erro de Delete Customer, retorne ao
bloco do Repeat. Use opção On Error.
4. A partir do segundo exercício, adicione tratamento para retornar ao Repeat se ocorrer erro de
Delete Customer, use Catch.
5. Crie um programa para,
a. Solicitar um número de cliente (customer.custnum), utilize like,
b. Tente localizar o número do cliente que foi infomado,
i. Se não localizou, informe ao usuário que o registro não existe,
1. Crie um novo, utilize Create e Update.
ii. Se for encontrado, pergunte ao usuário se deseja eliminar,
1. Se confirmado, elimine o registro, utilize Delete.
48
(18) 99747-8189
Interação com registros

Servem para localizar registros (get, find e for each) em tabelas dos bancos de dados, temporárias ou
somente validar a existência (can-find).
Podemos utilizar a instrução FOR, FIND e GET.
Tanto o comando Find, Get e o For, e suas variantes find first, find next e for first, são utilizados para
posicionar o ponteiro em um registro disponibilizando-o para leitura, alteração e eliminação. Para as queries
utilize Get First, Get Next, Get Prev, Get Last, Get Current.
Instrução For
Inicia uma iteração com um novo bloco que lê registros de uma ou mais tabelas, permite adicionar cláusulas
where para filtrar registros, implicitamente cria um novo bloco no programa, este possui tratamento de erro
e escopo de frame, se encerra com o uso da instrução END.
Transferência de Dados
Abaixo está a movimentação de dados que a instrução FOR realiza, trazendo dados do banco de dados para
o RECORD BUFFER.
Estando os dados no RECORD BUFFER, instruções de DELETE, ASSIGN ou DISPLAY poderão trabalhar com os
valores dos campos.
Fluxograma da pesquisa com instruções

É possível realizar um fluxograma com as instruções de pesquisa Find, For Each e Open Query.
49
(18) 99747-8189
Este fluxograma determina a forma de pesquisar usando as instruções do Progress ABL.
For each
Para grande volume de dados com pesquisa ascendente ou descendente de forma sequencial.
For First com Fields

Quando for validar ou utilizar poucos campos de um registro, exemplo, pesquisar se o saldo do cliente é
positivo, retornar o campo nome do cliente, localizar a descrição de um produto.
Find First
Para localizar um único registro para alterar ou eliminar.
Open Query
Para grande volume de dados com pesquisa ascendente ou descendente de forma aleatória, exemplo,
localizar o primeiro registro, o último, o próximo, o penúltimo, o anterior.
Sintaxe for each
[ label: ]
FOR [ EACH | FIRST | LAST ] record-phrase
[ , [ EACH | FIRST | LAST ] record-phrase ] ...
[ query-tuning-phrase ]
[ BREAK ]
[ BY expression [ DESCENDING ]
| COLLATE ( string , strength [ , collation ] ) [ DESCENDING ]
50
(18) 99747-8189
] ...
[ variable = expression1 TO expression2 [ BY k ] ]
[ WHILE expression ]
[ TRANSACTION ]
[ on-error-phrase ]
[ on-endkey-phrase ]
[ on-quit-phrase ]
[ on-stop-phrase ]
[ frame-phrase ] :
for-body
Principais opções da instrução FOR

Opção Sobre Indicação
EACH Para trazer todos os Os registros trazidos pelo FOR EACH estão à
registros que se disposição para eliminação, atribuição e exibição.
enquadram na cláusula Para eliminação e atribuição é necessário acessar o
where. registro com EXCLUSIVE-LOCK.
Após o bloco de FOR EACH, que se encerra com o
END deste, os registros da interação não estão
disponíveis.
FIRST Para trazer o primeiro Ao contrario do EACH, não faz interação com todos
registo que a cláusula os registros que se enquadram no where, traz
where filtrou. Se não for somente o primeiro. Para atualização ou eliminação
informado cláusula é necessário acessar o registro com EXCLUSIVE-
where trará o primeiro LOCK. Também possui END para encerrar o bloco,
registro atendido pelo mas o registro CONTINUA DISPONÍVEL após o bloco
índice primário. da instrução FOR FIRST.
LAST Para trazer o último Ao contrario do EACH, não faz interação com todos
registo que a cláusula os registros que se enquadram no where, traz
where filtrou. Se não for somente o primeiro. Para atualização ou eliminação
informado cláusula é necessário acessar o registro com EXCLUSIVE-
where trará o primeiro LOCK. Também possui END para encerrar o bloco,
registro atendido pelo mas o registro CONTINUA DISPONÍVEL após o bloco
índice primário. da instrução FOR LAST.
BREAK Para realizar opções de Poderão ser usadas em conjunto com as instruções
quebra. ACCUMULATE e a função ACCUM. Deve ser usada
em conjunto com BY.
BY expressão Para ordenar a interação Se não for informada, a AVM fornece a ordem
[DESCENDING] pelo campo informado. conforme os critérios usados na cláusula WHERE ou
no índice primário. Opcionalmente podemos
adicionar a opção DESCENDING para ordenar pela
forma descendente à informada no BY.
Campos BLOB e CLOB não podem ser inseridos em
cláusulas BY.
TRANSACTION Para explicitar a A AVM iniciará uma transação para cada interação,
transação durante a mesmo que ela não necessite.
interação do bloco.
On Error Para realizar sobrecarga
do tratamento padrão
de ERRO no bloco.
On Endkey Para realizar sobrecarga
do tratamento padrão
51
(18) 99747-8189
de pressionamento de
tecla ESC no bloco.
On Stop Para realizar a
sobrecarga do
tratamento padrão de
STOP ao bloco.
Frame-phrase O cabeçalho da
instrução de FOR pode
ter opções do FRAME a
ser usado no bloco.
Opções do Record phrase

A instrução FOR é comumente escrita com adaptações na Record phrase, estas opções podem determinar se
todos os campos virão do banco de dados ou se somente alguns, utilizar ou não uma instrução de filtro com
WHERE, informar um índice a ser utilizado com USE-INDEX, determinar o modo como o dado é acesso, se
será com NO-LOCK, SHARE-LOCK ou EXCLUSIVE-LOCK, se a instrução será relacionada com outras tabelas
através de EACH outros EACHs, se estará em transação com a opção TRANSACTION, se poussuirá opções de
ON ERROR, ON ENDKEY ou de ordenação com BY ou de quebra com BREAK.
As opções de Record phrase são uma importante base da instrução FOR.
{ record [ field-list ] }
[ constant ]
[ [ LEFT ] OUTER-JOIN ]
[ OF table ]
[ WHERE expression ]
[ USE-INDEX index ]
[ USING [ FRAME frame ] field
[ AND [ FRAME frame ] field ] ... ]
[ SHARE-LOCK | EXCLUSIVE-LOCK | NO-LOCK ]
[ NO-PREFETCH ]
Principais opções das opções Record Phrase

FIELDS Para determinar quais Pouco usada, mas pode trazer benefício
campos serão trazidos do na performance de programas, pois ao
banco de dados. contrario de trazer centenas de campos
pela rede, pode trazer somente os
campos necessários.
OF tabela Relaciona duas tabelas Para a cláusula OF funcionar é
através de campos em necessário que os campos das tuas
comum. tabelas tenham o mesmo nome e tipo
(caracter, inteiro, decimal...) e que em
uma das tabelas seja índice ÚNICO. Se o
índice ÚNICO for formado por múltiplos
campos, todos os campos participarão
do critério de pesquisa.
52
(18) 99747-8189
WHERE Permite adicionarmos filtros Provavelmente a cláusula mais usada na

nos registros do banco de programação com ABL. Esta cláusula
dados. pode ser formada por operadores como
igualdade “=”, diferença “<>”, maior que
“>=”, menor que “<=”, BEGINS,
MATCHES, Contains e possuir várias
uniões com a opção AND ou OR.
SHARE-LOCK, NO-LOCK e Para determinar a forma Share-lock é lock compartilhado e não
EXCLUSIVE-LOCK como o registro será deve ser usado pela possibilidade de
acessado. criar Dead-lock.
No-lock para acessar registro sem
travamento, normalmente usado em
relatórios ou programas consulta.
Exclusive-lock para acessar o registro em
modo exclusivo.
USE-INDEX índice Para indicar à AVM qual o Se não for usada, a AVM selecionará um
índice a ser utilizado na índice a ser usado baseado na cláusula
pesquisa. WHERE, USING e OF.
Exemplo

DISPLAY NAME.
END.
Anotações
For Each com Where

Exemplo com cláusula Where

WHERE customer.custnum = 5:
DISPLAY
customer.custnum
customer.NAME.
END.
Anotações
For Each com By

Exemplo com cláusula By
53
(18) 99747-8189

WHERE customer.custnum >= 5
BY CUSTOMER.NAME:
DISPLAY
customer.custnum
customer.NAME.
END.
Anotações
For each com várias tabelas

Exemplo com várias tabelas
/* clientes de 5 até 10 */
AND customer.custnum <= 10
BY customer.NAME:
DISPLAY
customer.custnum
customer.NAME.
/* pedidos do cliente */
FOR EACH order NO-LOCK
WHERE order.custnum = customer.custnum:
DISPLAY
order.ordernum
order.orderdate.
/* linhas do pedido do cliente */

FOR EACH orderline NO-LOCK
WHERE orderline.ordernum = order.ordernum:
DISPLAY
orderline.itemnum
orderline.qty.
END.
END.
END.
Anotações
For Each Encadeado com Várias Tabelas

54
(18) 99747-8189
AND customer.custnum <= 10,

EACH order NO-LOCK
WHERE order.custnum = customer.custnum,
EACH orderline NO-LOCK
WHERE orderline.ordernum = order.ordernum
BY customer.NAME:
DISPLAY
customer.custnum
customer.NAME
order.ordernum
order.orderdate
orderline.itemnum
orderline.qty
WITH STREAM-IO.
END.
For Each Encadeado com Fields

FOR EACH customer
FIELDS(custnum NAME)
NO-LOCK
AND customer.custnum <= 10,
EACH order
FIELDS(ordernum orderdate)
NO-LOCK
WHERE order.custnum = customer.custnum,
EACH orderline
FIELDS(itemnum qty)
NO-LOCK
WHERE orderline.ordernum = order.ordernum
BY customer.NAME:
DISPLAY
customer.custnum
customer.NAME
order.ordernum
order.orderdate
orderline.itemnum
orderline.qty
WITH STREAM-IO.
END.
Instrução For First e For Last

Instruções For com a opção First e Last são úteis para localizar os primeiros ou últimos registros, outra
vantagem que torna esta instrução única, se comparada com For, é o fato dos registros continuarem
disponíveis após o END.
Exemplo For First
FOR FIRST ITEM NO-LOCK

WHERE ITEM.itemnum = 10:
END.
55
(18) 99747-8189
IF AVAILABLE ITEM THEN

DISPLAY
ITEM.itemnum
ITEM.itemname
ITEM.price.
Anotações
Instrução Find
Localiza um único registro de uma tabela e o move para a área de record buffer. Deve ser usado para
alteração ou eliminação de registro.
Sintaxe find
FIND [ FIRST | LAST | NEXT | PREV ] record

[ constant ]
[ OF table ]
[ USE-INDEX index ]
[ AND [ FRAME frame ] field ] ...
]
[ NO-WAIT ]
[ NO-PREFETCH ]
[ NO-ERROR ]
e…
FIND CURRENT record

[ NO-WAIT ]
[ NO-ERROR ]
A instrução Find não permite pesquisas com mais de uma tabela como o For Each e a Query.
Movimentação de registro
Principais Opções do Find

FIRST Para trazer o primeiro
registro que atenda a cláusula
WHERE.
56
(18) 99747-8189
LAST Para trazer o último registro

que atenda a cláusula
WHERE.
NEXT Para trazer o próximo registro
WHERE.
PREV Para trazer o registro anterior
WHERE.
OF tabela Relaciona duas tabelas Para a cláusula OF funcionar é
através de campos em necessário que os campos das tuas
comum. tabelas tenham o mesmo nome e tipo
(caracter, inteiro, decimal...) e que em
uma das tabelas seja índice ÚNICO. Se o
índice ÚNICO for formado por múltiplos
campos, todos os campos participarão
do critério de pesquisa.
WHERE Permite adicionarmos filtros Provavelmente a cláusula mais usada na
nos registros do banco de programação com ABL. Esta cláusula
dados. pode ser formada por operadores como
igualdade “=”, diferença “<>”, maior que
“>=”, menor que “<=”, BEGINS,
MATCHES, Contains e possuir várias
uniões com a opção AND ou OR.
SHARE-LOCK, NO-LOCK e Para determinar a forma Share-lock é lock compartilhado e não
EXCLUSIVE-LOCK como o registro será deve ser usado pela possibilidade de
acessado. criar Dead-lock.
No-lock para acessar registro sem
travamento, normalmente usado em
relatórios ou programas consulta.
Exclusive-lock para acessar o registro em
modo exclusivo.
USE-INDEX índice Para indicar à AVM qual o Se não for usada, a AVM selecionará um
índice a ser utilizado na índice a ser usado baseado na cláusula
pesquisa. WHERE, USING e OF.
NO-WAIT Faz a instrução FIND retornar Deve ser usado em conjunto com a
caso o registro esteja em uso função LOCKED e função AVAILABLE para
por outro usuário. determinar se o registro está em uso ou
não foi localizado.
NO-ERROR Evitar a exibição de ERRO Comumente usada para não exibir a
quando não localiza o mensagem que ** FIND FIRST/LAST
registro. failed for table . (565)
Exemplo
FIND LAST customer NO-LOCK NO-ERROR.

IF AVAIL customer THEN
DISP custnum NAME.
57
(18) 99747-8189
Anotações
Analisando pontos fortes e fracos

Descrição Find For Each For First Open Qurery
Indicado para Localizar Para localizar Para localizar Para localizar
registro para grande um registro de grande
alteração e quantidade de uma ou várias quantidade de
eliminação registros de tabelas, registros de uma
uma ou várias usando opção ou várias
tabelas, quando Fields para tabelas, e
a pesquisa poder validar quando a
unidirecional o valor dos pesquisa
(ascendente ou campos da aleatória é
descendente) e Felds. obrigatória.
irrelevante.
Pesquisa com Não Sim Sim Sim
mais de uma
tabela?
Indicado para Sim Não (se a Sim Não (se a
alteração de um localização for localização for
registro? para mais de para mais de um
um registro) registro)
Cuidado Para não tornar Para não varrer Não Para não varrer
o bloco de a tabela inteira. a tabela inteira.
instruções do Para usar fields Para usar fields
find em uma para campos a, para campos a, b
transação. Se b e c e trabalhar e c e trabalhar
for o bloco que com campos d, com campos d,
contém o find e, f... e, f...
for o programa, Para construir o Para construir o
todo o where e a where e a
programa pode relação entre as relação entre as
se tornar uma tabelas. tabelas.
transação Para alterações
demorada. não
transformarem
todo o programa
em uma
transação.
Usa índices? Sim Sim Sim Sim
Permite By Não Sim Sim Sim
Permite Fields? Não Sim Sim Sim (mas a query
deve ser
definida)
58
(18) 99747-8189
Serve para Sim Sim Sim Sim

eliminar
registro?
Transação Não, mas com o Sim Sim Não
protegida em um Do Transaction
bloco? resolve.
Dica Use sempre Cuidado com as Use sempre Cuidado com as
Find First. cláusulas where que possível cláusulas where
eo com o Fields eo
relacionamento para validar relacionamento
entre as conteúdo de entre as tabelas.
tabelas. campos. Cuidado com as
transações.
Instrução Get
Disponibiliza um registro no record buffer de uma query, mas deve ser usada com a Open Query.
Sintaxe Get
GET { FIRST | NEXT | PREV | LAST | CURRENT } query

[ NO-WAIT ]
A instrução GET pode realizar o lock de um registro, mas se não for especificado nenhum, este utilizará o
mesmo lock utilizado na instrução OPEN QUERY.
Exemplo
OPEN QUERY qcust FOR EACH Customer NO-LOCK.
GET FIRST qcust.
DO WHILE AVAILABLE Customer:

DISPLAY Customer.CustNum Customer.Name .
GET NEXT qcust.

END.
Open Query
Abre uma query que pode ter sido definida, disponibilizando os registros desta consulta através da instrução
GET.
Sintaxe Open Query
OPEN QUERY query { FOR | PRESELECT } EACH record-phrase

[ , { EACH | FIRST | LAST } record-phrase ] ...
] ...
59
(18) 99747-8189
[ INDEXED-REPOSITION ]
[ MAX-ROWS num-results ]
record
[[ LEFT ]] [ OF table ]
[ AND [ FRAME frame ] field ] ... ]
[ USE-INDEX index ]
[ NO-PREFETCH ]
QUERY-TUNING
(
[ LOOKAHEAD [ CACHE-SIZE integer ] | NO-LOOKAHEAD ]
[ DEBUG { SQL | EXTENDED } | NO-DEBUG ]
[ SEPARATE-CONNECTION | NO-SEPARATE-CONNECTION ]
[ JOIN-BY-SQLDB | NO-JOIN-BY-SQLDB ]
[ BIND-WHERE | NO-BIND-WHERE ]
[ INDEX-HINT | NO-INDEX-HINT ]
)
Exemplo
DEFINE QUERY q-order FOR

customer FIELDS (customer.cust-num customer.name
customer.phone),
order FIELDS (order.order-num order.order-date),
order-line FIELDS (order-line.line-num order-line.price
order-line.qty),
item FIELDS (item.item-num item.item-name item.cat-desc).
OPEN QUERY q-order FOR EACH customer,

EACH order OF customer,
EACH order-line OF order,
EACH item OF order-line NO-LOCK.
GET FIRST q-order.
DO WHILE AVAILABLE(customer):
DISPLAY customer.cust-num
customer.name SKIP
customer.phone SKIP
order.order-num order.order-date SKIP
order-line.line-num
order-line.price order-line.qty SKIP
item.item-num item.item-name SKIP
60
(18) 99747-8189
item.cat-desc VIEW-AS EDITOR SIZE 50 BY 2 SCROLLBAR-

VERTICAL
WITH FRAME ord-info CENTERED SIDE-LABELS TITLE "Order
Information".
/* Allow scrolling, but not modification, of cat-desc. */

ASSIGN
item.cat-desc:READ-ONLY IN FRAME ord-info = TRUE
item.cat-desc:SENSITIVE IN FRAME ord-info = TRUE.
PAUSE.
GET NEXT q-order.
END. /* DO WHILE AVAIL(customer) */
Anotações
Exemplo de Open Query para Query não definida
OPEN QUERY qSalesrep

FOR EACH salesrep NO-LOCK
WHERE salesrep.salesrep BEGINS 'd',
EACH customer NO-LOCK OF salesrep.
GET FIRST qSalesrep.

REPEAT WHILE AVAILABLE salesrep:
DISPLAY
Salesrep.SalesRep
Salesrep.RepName
Salesrep.Region
WITH
TITLE 'Lista de representantes'
FRAME frameSalesRep.
DISPLAY
Customer.CustNum
Customer.Name
Customer.Phone
WITH
1 COL
TITLE 'Clientes do representante'.
GET NEXT qSalesrep.

END.
Exemplo de Open query com Get e Exclusive-lock
OPEN QUERY qItem

FOR EACH ITEM NO-LOCK
WHERE ITEM.itemnum > 5
AND ITEM.itemnum < 10.
GET FIRST qItem EXCLUSIVE-LOCK.
REPEAT WHILE AVAILABLE ITEM:
DISPLAY
61
(18) 99747-8189
Item.Itemnum
Item.ItemName
Item.Price.
GET NEXT qItem EXCLUSIVE-LOCK.

END.
Uso da função Can-find

A função can-find somente deverá ser usada para testar a existência do registro. A função can-find não
posiciona o ponteiro no registro e não há como fazer leitura, alteração e eliminação.
Sintaxe can-find
CAN-FIND
(
[ FIRST | LAST ] record [ constant ]
[ OF table ] [ WHERE expression ] [ USE-INDEX index ]
[ AND [ FRAME frame ] field ] ...
]
[ SHARE-LOCK | NO-LOCK ] [ NO-WAIT ] [ NO-PREFETCH ]
)
Exemplo

IF NOT CAN-FIND(FIRST salesrep
WHERE Salesrep.SalesRep = customer.salesrep) THEN
DISPLAY customer.custnum.
DISPLAY NAME.
END.
Anotações
Locks de registros
A linguagem possui três formas de “acessar” o registro durante o Find, For e Get:
• Exclusive-lock,
• Share-lock,
• No-lock,
Exclusive-lock
Acessa o registro em modo exclusivo, não permitindo que outros usuários acessem em modo exclusivo
(concorrente exclusive-lock ou share-lock). Permitindo eliminar, alterar e visualizar.
62
(18) 99747-8189
Share-lock
Acessa o registro em modo não exclusivo, permitindo que o “lock” evolua para Exclusive-lock caso ocorra
alteração no bloco corrente. Não utilize com Oracle, pois além do Oracle não ter o Share-lock real, forçara a
linguagem a encontrar o mesmo registro duas vezes.
No-lock
Acessa o registro sem travar o registro, mesmo que outro usuário esteja com Exclusive-lock, e não permite a
alteração. Use sempre que não for realizar alterações.
Recomendação! Use No-lock ou Exclusive-lock.
Anotações
Usando No-lock e Exclusive-lock

DEFINE VARIABLE codigo LIKE customer.custnum.
REPEAT:
UPDATE codigo.
/* pesquisar o primeiro cliente com o codigo informado */

DO TRANSACTION:
/* pesquisa o cliente no Record buffer e
muda o lock para Exclusivo */
FIND CURRENT customer EXCLUSIVE-LOCK.
/* ler o novo nome */
UPDATE customer.NAME.
/* liberar o registro do record buffer */
RELEASE customer.
/* após o comando Release,
o registro pesquisado não está mais disponível
*/
END.
END.
63
(18) 99747-8189
Exercício
Para a nomenclatura dos exercícios, utilize a máscara FND_FRE_<número do exercício>.P (FND_FRE_1.p,
FND_FRE_2.p).
1. Localize todos os clientes do representante (salesrep) DKP. Utilize a opção Of.

2. Localize todos os clientes do representante (salesrep) DOS. Utilize a opção Where.
3. Localize todos os clientes do representante (salesrep) DKP. Utilize a opção Of com um único For
Each.
4. Localize todos os clientes do representante (salesrep) DOS. Utilize a opção Where com um único For
Each.
5. Localize todos os clientes do representante (salesrep) DKP. Utilize a opção Of. Exiba o nome do
representante e o seu código (salesrep.salesrep, salesrep.repname). Informe o título Representante
para o frame salesrep e Cliente para o frame customer.
6. Localize todos os clientes do representante (salesrep) DKP. Utilize a opção Of. Exiba o nome do
representante e o seu código (salesrep.salesrep, salesrep.repname) no frame Representante e
centralize-a, mostre o campo salesrep.region no frame customer.
7. Crie um programa e simule o Dead-lock com Share-lock, necessário abrir duas sessões com o Editor
conectado ao mesmo banco.
Exercicios Complementares For Each

Segue lista de exercícios para FOR EACH, salve cada um como FOR_EACH_1.p, FOR_EACH_2.p e assim por
diante.
1. Solicitar o código do cliente, procurar o cliente que o usuário digitar e mostrar os

campos customer.custnum customer.NAME customer.address
customer.salesrep. Utilize Repeat, For FIRST, Update e Display. Tabela customer
64
(18) 99747-8189
2. Solicitar o código do cliente, procurar o cliente que o usuário digitar e mostrar

seus dados customer.custnum customer.NAME customer.creditlimit.
Para cada pedido do cliente exibir order.ordernum order.orderdate
Order.OrderStatus Order.ShipDate, usar clausula where. Utilize Repeat, For
FIRST, FOR EACH para ORDER, Update e Display.
Tabelas customer e order
3. Solicitar o codigo do cliente, localizar o primeiro cliente (For First)

que o usuario digitar e mostrar seus dados customer.custnum customer.NAME
customer.creditlimit.
Para cada pedido do cliente exibir os campos order.ordernum order.orderdate
Order.OrderStatus Order.ShipDate.
Para cada linha do pedido, exibir os campos OrderLine.Linenum
OrderLine.Itemnum OrderLine.Qty OrderLine.Price
Usar repeat, update, for first, for each e display.
Tabelas customer, order e orderline
65
(18) 99747-8189
4. Solicitar o numero do pedido, utilizar o for first e mostrar Order.Ordernum

Order.OrderDate Order.CustNum Order.SalesRep
Usar like para o campo numero do pedido, repeat, for first e display
Tabela order

66
(18) 99747-8189
Localizar o cliente (customer) atraves do campo order.custnum e mostrar seu

nome e telefone de contato (customer.NAME customer.phone)
Usar like para o campo numero do pedido, repeat, for first, first customer e display
tabelas order e customer

Localizar o cliente (customer) atraves do campo order.custnum e mostrar seu
nome e telefone de contato (customer.NAME customer.phone)
Localizar o representante do pedido pelo campo order.salesrep e mostrar o nome
daquele (salesrep.repname)
Usar like para o campo numero do pedido, repeat, for first, first customer e
display
Tabelas order, customer e salesrep
67
(18) 99747-8189

localizar todos as linhas do pedido (orderline) exibindo OrderLine.Linenum
OrderLine.Itemnum OrderLine.Qty OrderLine.Price OrderLine.Discount
Tabelas order, orderline
68
(18) 99747-8189

Localizar todos as linhas do pedido (orderline) exibindo OrderLine.Linenum
Localizar o item de cada linha do pedido (first item) e exibir o nome deste
Tabelas order, orderline e item

Localizar todos as linhas do pedido (orderline) exibindo OrderLine.Linenum
Exibir o total da linha do pedido que tem a seguinte formula = quantidade
(OrderLine.Qty) multiplicado pelo preco (OrderLine.Price) subtraindo o percentual
(OrderLine.Discount)
Para verificar se o valor total está calculado corretamente, veja o valor do campo
OrderLine.ExtendedPrice
Tabelas order, orderline
69
(18) 99747-8189
10. Solicitar o numero do item e mostrar os pedidos, data do pedido, nome do cliente
e nome do vendedor que este item se encontra.
Usar Like, repeat, update, for each, display e first
Tabelas orderline, order, customer e salesrep
Exibir Order.Ordernum Order.CustNum customer.NAME Order.OrderDate
Order.SalesRep salesrep.repNAME
70
(18) 99747-8189
11. Solicitar o codigo do representante, exibir os campos Salesrep.SalesRep

Salesrep.RepName.
Localizar cada cliente deste representante, exibir os campos Customer.CustNum
Customer.Name Customer.CreditLimit Customer.Contact e customer.phone.
tabelas salesrep e customer
Usar like, update, repeat, for first, for each
Codigos de representantes disponiveis para consulta
BBB
DKP
DOS
GPE
HXM
JAI
JAL
KIK
RDR
SLS
12. Solicitar o codigo do representante, exibir os campos Salesrep.SalesRep

Salesrep.RepName.
Localizar cada pedido deste representante, exibir os campos Order.Ordernum
Order.OrderDate.
Localizar os clientes de cada pedido, mostrando o código e o nome deste cliente.
tabelas order, salesrep e customer
Usar like, update, repeat, for first, for each
Codigos de representantes disponiveis para consulta
BBB
DKP
DOS
71
(18) 99747-8189
GPE
HXM
JAI
JAL
KIK
RDR
SLS
13. Solicitar duas datas de pedidos aos usuarios e exibir os campos pedidos entre
estas datas Order.OrderDate Order.Ordernum Order.OrderStatus Order.CustNum.
Usar like, repeat, update, for each e display
tabela order
As datas dos pedidos estao entre os meses de setembro de 1997 e março de 1998
72
(18) 99747-8189
14. Solicitar duas datas de pedidos e o nome do cliente, exibir os campos

(Order.OrderDate Order.Ordernum Order.OrderStatus Order.CustNum
Customer.Name) dos pedidos entre estas datas e que o nome do cliente inicie com
o nome digitado.
Usar like, repeat, update, for each e display
tabela order, customer
usar like, repeat, update, for each, first customer e begins
73
(18) 99747-8189
15. Localizar todos os pedidos, para cada pedido mostrar o total deste, exibir tambem
o nome do cliente e as linhas dos pedidos
Usar for each, first customer, for each orderline
16. Localizar todos os pedidos, para cada pedido mostrar o total deste, exibir tambem
o nome do cliente e as linhas dos pedidos
Usar for each, first customer, for each orderline
usar a opcao TOTAL para a quantidade e para o campo OrderLine.ExtendedPrice,
proibido o uso de variaveis para acumular
Para a tabela pedidos exibir order.ordernum order.custnum customer.NAME

order.orderdate
Para a tabela orderline exibir OrderLine.Linenum OrderLine.Qty OrderLine.Price
OrderLine.ExtendedPrice
74
(18) 99747-8189
Exercícios complementares de Open Query

1. Ler código inicial e final do cliente (customer), usar like, e com uso de open query listar todos os
clientes que se encaixam na faixa informada. Exiba custnum, name e creditlimit.
2. A partir do primeiro exercício, crie mais uma query para listar os pedidos do cliente, use clausulas
where para realizar a junção entre as duas tabelas.
75
(18) 99747-8189
3. A partir do segundo exercício, crie uma alteração para listar as linhas do pedido em uma outra
frame, listando linenum, itemnum, qty, price e extentedprice. Use clausula where para realizar a
junção entre as tabelas.
4. A partir do terceiro exercício, totalize a coluna extendedprice.
76
(18) 99747-8189
5. A partir do quarto exercício, exiba o total do campo extendedprice, das linhas do pedido, na frame
da order, como segue abaixo.
6. A partir do quinto exercício, conte a quantidade de pedidos e exiba esta contagem na frame do
cliente, conforme abaixo.
77
(18) 99747-8189
78
(18) 99747-8189
Gatilhos do banco de dados

Gatilhos são eventos das tabelas do dicionário, como criação, atribuição e eliminação que executarão
programas Progress ABL, na camada 4GL.
Como são programas Progress ABL, eles devem estar visíveis pelo PROPATH, ou então exceções ocorrerão e
isso não queremos.
Na camada Progress ABL há gatilhos para Create, Delete, Find, Write, Replication-create, Replication-delete
e Replication-write:
Create
Quando ocorre a criação de registro em uma tabela através da instrução Create, Insert ou do método de
Buffer-Create.
Delete
Quando ocorre a eliminação do registro, seja pela instrução Delete ou pelo método Buffer-Delete.
Find
Quando um registro da tabela é lido pelo gerenciador do banco de dados disparado pelo FIND ou FOR EACH
Write
Ocorre quando um registro é validado no banco de dados, seja pela instrução VALIDATE, RELEASE ou
BUFFER-VALIDADE e ou BUFFER-RELEASE.
Replication-create
Quando ocorre a criação do registro através do Create, Insert ou do método Buffer-Create e após a gravação
no log de alteração. Para facilitar, após a execução do gatilho de Create.
Replication-delete
Quando ocorre a eliminação do registro, seja pelo uso do Delete ou pelo Buffer-Delete, e ao gravar a
informação no log de alteração. Após a execução do gatilho de Delete.
Replication-write
Após a efetivação da gravação do registro e da gravação do log de alteração. Após a execução do gatilho de
Write.
Retorno de Erro e cancelamento da execução

É possível utilizar a instrução RETURN ERROR para cancelar a execução do gatilho, no caso do gatilho de
Write o registro não será salvo, para o Delete o registro não será eliminado.
(18) 99747-8189
Variáveis e tipos de dados

São áreas da memória que armazenam dados temporariamente.
Sintaxe
DEFINE {[[ NEW [ GLOBAL ]] SHARED ]|

[ PRIVATE | PROTECTED | PUBLIC ]
[ STATIC ][ SERIALIZABLE ]}
VARIABLE variable-name
{{ AS primitive-type-name
| AS [ CLASS ]{object-type-name}
| LIKE field }[ EXTENT [constant]]}
[ BGCOLOR expression]
[ COLUMN-LABEL label]
[ CONTEXT-HELP-ID expression]
[ DCOLOR expression]
[ DECIMALS n]
[ DROP-TARGET ]
[ FONT expression]
[ FGCOLOR expression]
[ FORMAT string]
[ INITIAL
{ constant |{[ constant[ , constant]...]}}]
[ LABEL string[ , string]...]
[ MOUSE-POINTER expression]
[ NO-UNDO ]
[[ NOT ] CASE-SENSITIVE ]
[ PFCOLOR expression]
{[ view-as-phrase ]}
{[ trigger-phrase ]}
Tipos de variáveis
CHARACTER | COM-HANDLE | DATE | DATETIME | DATETIME-TZ | DECIMAL
| HANDLE | INT64 | INTEGER | LOGICAL | LONGCHAR | MEMPTR | RAW | RECID* |
ROWID
Tipos primitivos da linguagem ABL

BLOB Binary Large Objects, válido para campos do banco de dados e
para tabelas temporárias. Para ser manipulado precisa de
variáveis tipo MEMPTR.
CHARACTER Conjunto de caracteres em geral, como letras, caracteres
especiais e números.
(18) 99747-8189
CLOB Character Large Objects, válido para campos do banco de dados e

para tabelas temporárias. Para ser manipulado deve-se utilizar
variáveis do tipo LONGCHAR.
COM-HANDLE É um manipulador para objetos COM (Activex Automation Object
ou Activex Control).
DATE Para tratar campos data.
DATETIME Composto por duas partes para tratar data e tempo, sendo tempo
os milissegundos desde a meia-noite.
DATETIME-TZ Composto por três partes para tratar a data, o tempo e um inteiro
representando o fuso horário.
DECIMAL Para tratar números decimais com até 50 posições, incluindo até
10 posições para a parte decimal.
HANDLE É um ponteiro para objetos da linguagem ABL.
INT64 Um inteiro de 64 bits.
INTEGER Um inteiro de 32 bits.
LOGICAL Para tratar valores lógicos com YES e NO ou TRUE e FALSE.
LONGCHAR Tipo character que não está limitado a 32 K. Use para tratar
campos CLOB do banco ou de tabelas temporários.
MEMPTR Uma sequência de bytes na memória, pode ser usado para tratar
campos BLOB do banco ou em tabelas temporárias, e para tratar
variáveis passadas como referência em DLLs ou Bibliotecas
Dinâmicas.
RAW Pode ser qualquer tipo de dado, este tipo não tem conversão.
RECID Identificador único de registros em banco de dados ou em tabelas
temporárias, é do tipo inteiro e somente mantido por questões
de retro compatibilidade.
ROWID Identificador único de registros em banco de dados ou em tabelas
temporárias no formato Hexadecimal,
WIDGET-HANDLE É um ponteiro para objetos da linguagem ABL somente mantido
por questões de retro compatibilidade.
Exemplos
DEFINE VARIABLE CONTADOR AS INTEGER NO-UNDO.
DEFINE VARIABLE NOME AS CHARACTER NO-UNDO.
DEFINE VARIABLE TEXTO_LONGO AS LONGCHAR NO-UNDO.
DEFINE VARIABLE DIA-HOJE AS DATE NO-UNDO.
DEFINE VARIABLE AGORA AS DATETIME NO-UNDO.
DEFINE VARIABLE VALOR_REAL AS DECIMAL NO-UNDO.
DEFINE VARIABLE INTEIRO_LONGO AS INT64 NO-UNDO.
DEFINE VARIABLE ESCOLHA AS LOGICAL NO-UNDO.
DEFINE VARIABLE SOBRENOME AS CHARACTER NO-UNDO

LABEL 'Sobrenome'.
DEFINE VARIABLE NOME-MEIO AS CHARACTER NO-UNDO
LABEL 'Nome do Meio'
FORMAT 'x(40)'.
DEFINE VARIABLE OBSERVACAO AS CHARACTER NO-UNDO
LABEL 'Observação'
FORMAT 'x(500)'
VIEW-AS EDITOR
INNER-CHARS 50
INNER-LINES 5
LARGE.
DEFINE VARIABLE SEQUENCIA AS INTEGER NO-UNDO
LABEL 'Sequencia'
81
(18) 99747-8189
FORMAT '9,999,999'.
DEFINE VARIABLE VALOR_MOEDA AS DECIMAL NO-UNDO
LABEL 'Moeda'
FORMAT 'R$ >>>,>>>,>>9.99'.
DEFINE VARIABLE VERDADEIRO AS LOGICAL NO-UNDO
LABEL 'Verdadeiro'
FORMAT 'Verdadeiro/Falso'.
DEFINE VARIABLE ESTADO_PORTA AS LOGICAL NO-UNDO
LABEL 'Estado da Porta'
FORMAT 'Aberta/Fechada'.
DEFINE VARIABLE ASTERISCO AS LOGICAL NO-UNDO
LABEL 'Marcado?'
FORMAT '*/'.
Anotações
Rótulos
Variáveis em linguagem ABL têm rótulos que são exibidos aos usuários:
1. COLUMN-LABEL, quando a visualização da variável na FRAME é em colunas,

2. LABEL, que será exibido na FRAME ao lado da variável.
Exemplo do LABEL
DEFINE VARIABLE credit-percent AS INTEGER

label “Percentual de Crédito”
column-label “Percentual!de Crédito”.
DISP credit-percent WITH SIDE-LABELS.
Resultando em:
Exemplo do COLUMN-LABEL
82
(18) 99747-8189
label "Percentual de Crédito"

column-label "Percentual!de Crédito".
DISP credit-percent.
Resultando em:
Anotações
Formato padrão
A linguagem ABL utiliza formatos para exibir os valores de campos de banco de dados, tabelas temporárias e
variáveis. Esta formatação pode-se manipulada tanto na declaração de uma Frame quanto durante o Display
desta.
Importante: O formato não altera a quantidade de dados que podem ser armazenados em uma variável.
Mesmo uma variável inteira com o formato ‘99’ ainda pode armazenar o valor inteiro de 32 Bits.
BLOB Não pode ser exibido com Display diretamente, somente com
conversão.
CHARACTER X(8)
CLOB Não pode ser exibido com Display diretamente, somente com
conversão.
COM-HANDLE >>>>>>9
DATE 99/99/99
DATETIME 99/99/9999 HH:MM:SS.SSS
DATETIME-TZ 99/99/9999 HH:MM:SS.SSS+HH:MM
DECIMAL ->>,>>9.99
HANDLE >>>>>>9
INT64 ->,>>>,>>9
INTEGER ->,>>>,>>9
LOGICAL yes/no
LONGCHAR Não pode ser exibido com Display diretamente, somente com
conversão.
MEMPTR Não pode ser exibido com Display diretamente, somente com
conversão.
83
(18) 99747-8189
RAW Não pode ser exibido com Display diretamente, somente com
conversão.
RECID >>>>>>9
ROWID Não pode ser exibido com Display diretamente, somente com
conversão.
Anotações
Valores iniciais
Variáveis podem ter valores iniciais, basta atribuir um valor para a opção INITIAL.
DEFINE VARIABLE credit-percent AS INTEGER INITIAL 20.
Tabela de valores iniciais

CHARACTER “” caracter vazio
COM-HANDLE ? desconhecido
DATE ? desconhecido
DATETIME ? desconhecido
DATETIME-TZ ? desconhecido
DECIMAL 0
HANDLE ? desconhecido
INT64 0
INTEGER 0
LOGICAL No
LONGCHAR ? desconhecido
MEMPTR Sequencia de bytes com tamanho zero
RAW Sequencia de bytes com tamanho zero
RECID ? desconhecido
ROWID ? desconhecido
Anotações
Variáveis multidimensionais ou vetores

A linguagem ABL permite variáveis com vetores, adicione a opção EXTENT.

Extent 5
84
(18) 99747-8189
INITIAL 20.
Para exibir somente um valor da variável com vetor, informe o índice do vetor entre [].

Extent 5
INITIAL 20.
DISP credit-percent[3].
Anotações
Opção No-Undo
A opção no-undo informa à ABL que a variável ou temp-table não precisa ter seu valor armazenado se ela
fizer parte de um bloco em transação ou tenha seu valor desfeito quando esta transação também for
desfeita.
85
(18) 99747-8189
Importante: use sempre que possível a opção No-Undo.
Anotações
Visualização De Variáveis Como Objetos

A linguagem ABL permite atribuir uma visualização de objetos para as variáveis, estes objetos podem ser
Caixas de Combinação, caixa grande de digitação de texto, caixa de digitação de texto, botões de rádio, lista
de seleção, botão de deslizar, texto, caixa de marcação.
Algumas visualizações permitem todos os tipos de variáveis, outros somente tipos inteiros.
Caixas De Combinação Todos os tipos de variáveis.

Editor Variáveis do tipo Character e LongChar.
Fill-in Character, Int64, Integer, Decimal, Date, Datetime,
Datetime-Tz E Logical.
Radio-set Character, Int64, Integer, Decimal, Date e Logical.
Selection-list Character
Slider Inteiro
Text Character, Int64, Integer, Decimal, Date e Logical.
Toggle-box Logical.
Sintaxe da Caixa de combinação
VIEW-AS COMBO-BOX
[ LIST-ITEMS item-list | LIST-ITEM-PAIRS item-pair-list ]
[ INNER-LINES lines ] [ size-phrase ] [ SORT ]
[ TOOLTIP tooltip ]
[ SIMPLE | DROP-DOWN | DROP-DOWN-LIST ]
[ MAX-CHARS characters ]
[ AUTO-COMPLETION [ UNIQUE-MATCH ] ]
Sintaxe da Caixa Grande de Digitação de Texto
EDITOR
{ size-phrase
| INNER-CHARS char INNER-LINES lines
}
[ BUFFER-CHARS chars ]
[ BUFFER-LINES lines ]
[ LARGE ]
86
(18) 99747-8189
[ MAX-CHARS characters ]
[ NO-BOX ]
[ NO-WORD-WRAP ]
[ SCROLLBAR-HORIZONTAL ]
[ SCROLLBAR-VERTICAL ]
[ TOOLTIP tooltip ]
Sintaxe Botões de Rádio
RADIO-SET
[ HORIZONTAL [ EXPAND ] | VERTICAL ]
[ size-phrase ]
RADIO-BUTTONS label , value [ , label, value ... ]
[ TOOLTIP tooltip ]
Sintaxe Lista de Seleção
SELECTION-LIST
[ SINGLE | MULTIPLE ]
[ NO-DRAG ]
[ LIST-ITEMS item-list ]
[ SCROLLBAR-HORIZONTAL ]
[ SCROLLBAR-VERTICAL ]
{ size-phrase | INNER-CHARS cols INNER-LINES rows }
[ SORT ]
[ TOOLTIP tooltip ]
Sintaxe do Botão de Deslizar
VIEW-AS SLIDER
MAX-VALUE max-value MIN-VALUE min-value
[ HORIZONTAL | VERTICAL ]
[ NO-CURRENT-VALUE ]
[ LARGE-TO-SMALL ]
[ TIC-MARKS
{ NONE | TOP | BOTTOM | LEFT | RIGHT | BOTH }
[ FREQUENCY n ]
]
[ TOOLTIP tooltip ]
[ size-phrase ]
87
(18) 99747-8189
Exemplo
DEFINE VARIABLE meucombobox
AS CHARACTER
LABEL "Combo"
INITIAL "Joinville"
VIEW-AS COMBO-BOX
LIST-ITEM-PAIRS
"Joinville", "Joinville",
"Itapoa", "Itapoa",
"São Bendo do Sul", "São Bendo do Sul",
"Campo Alegre", "Campo Alegre",
"Curitiba", "Curitiba",
"Barra do Sul", "Barra do Sul"
DROP-DOWN-LIST
AUTO-COMPLETION
INNER-LINES 5
SIZE 30 BY 1.
DEFINE VARIABLE meueditor

AS CHARACTER
LABEL "Editor"
VIEW-AS EDITOR
INNER-CHARS 30
INNER-LINES 5
MAX-CHARS 20
NO-WORD-WRAP
SCROLLBAR-VERTICAL.
DEFINE VARIABLE meuradio

AS INTEGER
LABEL "Radio"
INITIAL 1
VIEW-AS RADIO-SET
HORIZONTAL
RADIO-BUTTONS
"Carro", 1,
"Moto", 2.
DEFINE VARIABLE minhaselection

AS CHARACTER
LABEL "Selection"
INITIAL "SC"
VIEW-AS SELECTION-LIST
MULTIPLE
LIST-ITEMS
"SC", "SP", "PR", "RS", "RJ"
INNER-CHARS 10
INNER-LINES 5
SCROLLBAR-HORIZONTAL
SORT.
DEFINE VARIABLE meuslider

AS INTEGER
LABEL "Slider"
INITIAL 1
VIEW-AS SLIDER
MAX-VALUE 100
MIN-VALUE 1
HORIZONTAL
TIC-MARKS BOTTOM
FREQUENCY 10
88
(18) 99747-8189
SIZE 30 BY 3.
DEFINE VARIABLE meufillinInt

AS INTEGER
FORMAT '999'
LABEL "Fill Int"
INITIAL 10
VIEW-AS FILL-IN
SIZE 10 BY 1.
DEFINE VARIABLE meufillinDec

AS DECIMAL
FORMAT '>>9.99'
LABEL "Fill Dec"
INITIAL 22.33
VIEW-AS FILL-IN
SIZE 10 BY 1.
DEFINE VARIABLE meufillinDate

AS DATE
FORMAT '99/99/9999'
LABEL "Fill Date"
INITIAL 12/31/2013
VIEW-AS FILL-IN
SIZE 15 BY 1.
DEFINE VARIABLE meufillinChar

AS CHARACTER
FORMAT 'x(40)'
LABEL "Fill Char"
INITIAL "Funcionou"
VIEW-AS FILL-IN
SIZE 25 BY 1.
UPDATE
meucombobox
meueditor
meuradio
minhaselection
meuslider
meufillinInt
meufillinDec
meufillinDate
meufillinChar
WITH 1 COL.
89
(18) 99747-8189
Resultado no ambiente Windows
90
(18) 99747-8189
Resultado no Ambiente Caracter
Anotações
Variáveis e herança
Variáveis podem receber características de outras variáveis, de outros campos de tabelas do banco de
dados, de tabelas temporárias e de objetos, para isso use a opção LIKE.
91
(18) 99747-8189
Alguns atributos podem ser sobrescritos mesmo usando a opção LIKE, como:
• Formato ou FORMAT,
• Rótulo ou LABEL,
• Valor inicial ou INITIAL,
• Casas decimais ou DECIMAL,
• Visualização de variáveis como objetos ou VIEW-AS,
Exemplo
DEFINE VARIABLE nome

AS CHARACTER
FORMAT 'x(50)'
LABEL 'Nome'
VIEW-AS FILL-IN
SIZE-PIXELS 90 BY 21
.
DEFINE VARIABLE sobrenome

LIKE nome
LABEL 'Sobrenome'.
UPDATE nome sobrenome.
Resultado
Anotações
Herdando características de campos de tabela

A herança com a opção Like também é válida para campos de tabela.
Exemplo
/*para este exemplo funcionar é necessário que o banco SPORTS2000

esteja conectado*/

LIKE customer.NAME.
DEFINE VARIABLE numero

LIKE customer.custnum.
UPDATE nome numero
92
(18) 99747-8189
WITH SIDE-LABELS.
Resultado
93
(18) 99747-8189
Exercício
Para a nomenclatura dos exercícios, utilize a máscara VAR_<número do exercício>.P (var_1.p, var_2.p).
1. Definir variável do tipo caractere.

2. Definir variável do tipo decimal.
3. Definir variável do tipo data.
4. Definir variável do tipo inteiro.
5. Definir uma variável caractere, decimal, data, inteiro com vetor de cinco posições, utilize a opção
'extent'.
6. Crie um novo programa a partir do segundo exercício, neste a variável decimal deverá ser visualizada
(VIEW-AS) como FILL-IN.
7. Crie um novo programa a partir do quarto exercício, neste adicione uma nova variável, herde as
características da variável existente com a opção like, mostre-a como Slider, com valor mínimo 1,
valor máximo 100, horizontal e com frequência de 20.
94
(18) 99747-8189
Entrada e Atribuição de Valores

Há diversas formas de realizar a entrada e atribuição de valores, as principais são:
• Assign, atribuição de valores em uma única instrução, trazendo os dados do Screen buffer para o
Record buffer.
• Prompt-for, entrada de valores utilizando o Screen-buffer, é uma conjunção de comandos como
Enable, Wait-for e Disable.
• Update, entrada e atribuição de valores com a realização de várias operações como o comando
Display, Prompt-for e Assign.
Instrução Assign
Atribuição de valores em uma única instrução, trazendo os dados do Screen buffer para o Record buffer.
Sintaxe Assign
ASSIGN {
[ [ INPUT ] FRAME frame | BROWSE browse ]
{ field [ = expression ] } [ WHEN expression ]
} ... [ NO-ERROR ]
Exemplo Assign
REPEAT:
PROMPT-FOR Customer.CustNum.
FIND Customer USING Customer.CustNum NO-ERROR.
IF NOT AVAILABLE Customer THEN DO:
CREATE Customer.
ASSIGN Customer.CustNum = 10.
END.
UPDATE Customer WITH 2 COLUMNS.
END.
Anotações
A instrução de Assign também é utilizada para a atribuição de vários valores em uma única instrução com o
uso do igual “=”.
95
(18) 99747-8189
Sintaxe Assign para atribuição
Certo Errado
Assign customer.custnum = 5.
customer.custnum = 5 customer.name = “Jose da
customer.name = “Jose Silva”. Silva”.
Uma única instrução realiza múltiplas

atribuições, sendo mais rápido. Várias instruções são executadas para realizar
as mesmas atribuições.
Anotações
Instrução de Prompt-for
Entrada de valores utilizando o Screen buffer.
É uma conjunção de comandos como Enable, Wait-for e Disable.
Sintaxe
PROMPT-FOR
[ STREAM stream | STREAM-HANDLE handle ]
[ UNLESS-HIDDEN ]
{ { field
[ format-phrase ]
[ WHEN expression ]
}
| { TEXT ( { field
[ format-phrase ]
[ WHEN expression ]
} ...
)
}
| { constant
[ { AT | TO } n ]
[ VIEW-AS TEXT ]
[ FGCOLOR expression ]
[ BGCOLOR expression ]
[ FONT expression ]
}
(18) 99747-8189
| SPACE [ ( n ) ] | SKIP [ ( n ) ] | ^
} ...
[ GO-ON ( key-label ... ) ]
[ IN WINDOW window ]
[ frame-phrase ]
[ editing-phrase ]
Exemplo
REPEAT:
PROMPT-FOR Customer.CustNum.
FIND Customer USING Customer.CustNum NO-ERROR.
IF NOT AVAILABLE Customer THEN DO:
MESSAGE "No such customer number.".
UNDO, RETRY.
END.
DISPLAY Customer.Name Customer.Phone Customer.SalesRep.
END.
Anotações
Neste exemplo é utilizada a leitura do “código do cliente” diretamente no campo Customer.Custnum, mas o
valor digitado está armazenado no Screen buffer, não sendo gravada no banco de dados.
Importante: Utilize a função INPUT para atribuir o valor que está no Screen buffer para o Record Buffer.
Exemplo
Assign Input
customer.custnum
customer.name.
Instrução de Update
Entrada e atribuição de valores com a realização de várias operações como o comando Display, Prompt-for e
Assign.
A instrução de Update faz a transferência entre Screen Buffer para Record Buffer automaticamente.
Sintaxe
97
(18) 99747-8189
UPDATE
[ UNLESS-HIDDEN ]
[ field [ format-phrase ] [ WHEN expression ]
| TEXT ( field [ format-phrase ] ... )
| field = expression
| constant [ AT n | TO n ]
| ^
| SPACE [ ( n ) ]
| SKIP [ ( n )]
] ...
[ GO-ON ( key-label ... ) ]
[ frame-phrase ]
[ editing-phrase ]
[ NO-ERROR ]
Exemplo
FOR EACH Customer:

UPDATE
Customer.Name
Customer.Address
Customer.City
Customer.State
Customer.Country.
END.
Anotações
Importante
• Se algum campo de tabela faz parte da instrução Update, o Lock é primeiramente evoluído para
Exclusive para então atualizar o valor no banco de dados.
• Se somente um qualificador, como o nome de um campo “name”, for utilizado na instrução de
Update, o compilador tenta referenciar o qualificador como dbname.tablename, em caso de falha, o
compilador tenta referenciar tablename.fieldname. Para bancos com muitas tabelas é sugerido
referenciar tablename.fieldname, pois a localização do qualificador tablename.fieldname pode
demorar.
• A instrução de Update faz com que a Trigger de dicionário Assign do campo seja acionada. Se ocorrer
erro durante a execução da Trigger de Assign, a atualização no banco de dados é desfeita.
• Gatilhos de Write são executados em quatro situações:
o Final da transação, pode ser no END ou no final do bloco de instruções de um programa,
98
(18) 99747-8189
o Instrução Release,
o Instrução Validade e
o Ao trocar de registro com um FIND, por exemplo.
Anotações
A maldição do Screen buffer

Três áreas para valores é uma maldição, principalmente quando trabalhamos com comando Prompt-for.
Sempre que usar Screen buffer utilize o comando Input para transferir o valor digitado para o Record Buffer,
que guarda o valor real da variável ou registro do banco.
Simulando o problema de Screen buffer

AS CHARACTER NO-UNDO
VIEW-AS FILL-IN
SIZE-PIX 90 BY 21 .
REPEAT:
PROMPT-FOR nome.
MESSAGE nome
END.
Transferindo valor do Screen Buffer para o Record Buffer

Utilize o comando assign e input para atualizar o valor do Record Buffer.

VIEW-AS FILL-IN
SIZE-PIX 90 BY 21.
REPEAT:
PROMPT-FOR nome.
ASSIGN INPUT nome.
MESSAGE nome
END.
99
(18) 99747-8189
A função Input referencia o valor da variável no Screen Buffer, com o comando Assign este valor no Screen
Buffer é transferido para o Record Buffer.
Anotações
100
(18) 99747-8189
Exercícios
Para a nomenclatura dos exercícios, utilize a máscara ENT_A_<número do exercício>.P (ENT_A_1.p,
ENT_A_2.p).
1. Crie um programa que leia o nome e sobrenome e mostre em uma mensagem os valores digitados,
utilize prompt-for e não esquecer do assign e input.
2. A partir do primeiro exercício substitua os comandos desnecessários pela instrução Update.
101
(18) 99747-8189
Instruções Condicionais
A linguagem possui instruções condicionais IF, THEM e ELSE ou CASE, como a maioria das outras linguagens.
Instrução IF, THEN e ELSE

Sintaxe
IF expression THEN { block | statement }

[ ELSE { block | statement } ]
Exemplo
DEFINE VARIABLE A AS INTEGER NO-UNDO INITIAL 1.
IF A = 1 THEN
DISPLAY "Igual".
ELSE
DISPLAY "Diferente".
Para adicionar várias instruções em condições IF utilize o comando DO.
Exemplo
IF A = 1 THEN
DO:
DISPLAY "Igual".
MESSAGE "igual"
END.
ELSE
DO:
DISPLAY "Diferente".
MESSAGE "diferente"
END.
Anotações
If, Then e Else em Assign

A instrução Assign também pode abrir IF, Then e Else. Por questões de performance, não é indicada.
Exemplo
DEFINE VARIABLE iniciou AS LOGICAL NO-UNDO INITIAL TRUE.

DEFINE VARIABLE iniciado AS CHARACTER NO-UNDO.
UPDATE iniciou.
102
(18) 99747-8189
ASSIGN
iniciado = IF iniciou THEN
"Verdadeiro"
ELSE
"Falso".
DISPLAY iniciado.
Instrução CASE
A instrução CASE permite condições com ramificações baseadas em valores.
Sintaxe
CASE expression :
{ WHEN value [ OR WHEN value ] ... THEN
{ block | statement }
} ...
[ OTHERWISE
{ block | statement }
]
END [ CASE ]
Exemplo
CASE A:
WHEN 1 THEN
DO:
DISPLAY "Igual a 1".
MESSAGE "igual a 1"
END.
WHEN 2 THEN
DO:
DISPLAY "Igual a 2".
MESSAGE "igual a 2"
END.
OTHERWISE
DO:
DISPLAY "Nao é 1 ou 2".
MESSAGE "Nao é 1 ou 2"
END.
END CASE.
Anotações
103
(18) 99747-8189
Exercícios
Para a nomenclatura dos exercícios, utilize a máscara INST_<número do exercício>.P (INST_1.p, INST_2.p).
1. A partir de duas variáveis do tipo inteiro e com valores diferentes mostre se a primeira variável é
maior que a segunda (Instrutor).
2. Repita o primeiro exercício, mas usando desta vez o operador GT.
3. Usando variáveis do tipo decimal mostre se a primeira variável é menor que a segunda.
4. Repita o terceiro exercício, mas usando o operador LT.
5. Verifique se a primeira variável do tipo inteira é maior ou igual que a segunda variável decimal.
6. Repita o quinto exercício, mas agora utilize o operador GE.
7. Verifique se a variável nome completo inicia por 'A', utilize o operador BEGINS.
8. Verifique se a variável nome completo não se inicia por 'A'.
9. Com uma variável inteira e utilizando IF mostre se o valor é maior que 1, ou 2, ou 3, utilize IF THEN e
ELSE.
10. Repita o exercício 9, mas utilize a instrução CASE.
104
(18) 99747-8189
Includes
Includes são segmentos de código que são incorporados aos programas durante a compilação.
Podem receber argumentos, que são os equivalentes aos parâmetros nas procedures.
Sintaxe
{nome-arquivo-include.i}
Exemplo
{minhainclude.i}
MESSAGE “Programa com include incorporada”

Exemplo de include com argumento sem nome
{minhainclude.i 1 ”JAISON”}
MESSAGE “Programa com include incorporada e argumentos”

Exemplo de include com argumentos nomeados
{minhainclude.i
&parametro1=1
&parametro2=”JAISON”}
MESSAGE “Programa com include incorporada e argumentos com nome”

Anotações
105
(18) 99747-8189
Exercício
Para a nomenclatura dos exercícios, utilize a máscara INC_<número do exercício>.P (INC_1.p, INC_2.p).
1. Criar programa que utilize include com três argumentos, data de hoje, nome completo, data de
nascimento e dentro do arquivo include exiba mensagem com estes dados.
2. Criar programa que utilize include com três argumentos, data de hoje, nome completo, data de
nascimento e dentro do arquivo include exiba mensagem com estes dados, utilize argumentos com
nomes.
106
(18) 99747-8189
Pré-processadores
Pré-processadores são constantes utilizadas na compilação e disponíveis para o programa.
Há duas formas de definirmos uma constante: Scoped-define e Global-define.
Constantes locais
São as constantes declaradas dentro das includes que não estão disponíveis para o programa que as
incorpora.
Definindo constantes locais Scoped-define

Sintaxe
&SCOPED-DEFINE preprocessor-name definition
Exemplo
&SCOPED-DEFINE minhaconstante 1
Anotações
Constantes Globais
São as constantes declaradas dentro das includes que estão disponíveis para o programa que as incorpora.
Definindo constantes globais Global-define

Sintaxe
&GLOBAL-DEFINE preprocessor-name definition
Exemplo
&GLOBAL-DEFINE minhaNovaConstante 2
Anotações
107
(18) 99747-8189
Verificando a declaração de uma constante

Pode-se testar se a constante foi definida com a função Defined e eliminar a definição desta com a diretiva
&Undefine.
Sintaxe
DEFINED ( name )
Exemplo
&IF DEFINED(minhaNovaConstante) &THEN

DISPLAY custnum NAME.
&ENDIF
Diferença entre Scoped e Global

Como mencionado acima, a diferença entre ambas é na abrangência destas quando declaradas dentro de
includes. Enquanto que uma constante declarada como Scoped não se propaga para o programa que
declarou esta include, uma constante Global se propaga e está disponível para ser usada no programa que
declarou esta include.
Exemplo minhainclude.i
&SCOPED-DEFINE minha1 1
&GLOBAL-DEFINE minha2 2
Exemplo
{minhainclude.i}
MESSAGE {&minha1} SKIP {&minha2}

Anotações
Eliminando a declaração de uma constante

A linguagem ABL permite eliminarmos a definição de uma constante através do uso do UNDEFINE.
108
(18) 99747-8189
&UNDEFINE preprocessor-name
Exemplo
&UNDEFINE minhaNovaConstante
&IF DEFINED(minhaNovaConstante) > 0 &THEN

&ENDIF
Anotações
109
(18) 99747-8189
Exercício
Para a nomenclatura dos exercícios, utilize a máscara CT_<número do exercício>.P (CT_1.p, CT_2.p).
1. Criar programa que defina uma constante local com o seu nome e mostre-a em uma mensagem.
2. Criar programa que defina uma constante global com o seu nome, mostre-a em uma mensagem e
elimine a definição.
110
(18) 99747-8189
Frames e Display
São áreas retangulares para a exibição de variáveis e seus valores, campos de tabelas ou para interação com
o usuário.
Sintaxe
DEFINE { [ [ NEW ] SHARED ] | [ PRIVATE ] } FRAME frame

[ form-item ... ]
[{ HEADER | BACKGROUND } head-item ... ]
{ [ frame-phrase ] }
Tantos os campos quanto a frame possuem opções, e isto deve-se ser compreendido, são opções segregadas
pois são objetos distintos, algumas opções podem existir em ambos, mas não devem ser confundidas.
Durante os primeiros momentos de aprendizado da linguagem Progress ABL estas opções podem ser
confundidas entre campos e definição de frame.
Os campos possuem Opções dos Campos, conhecido como Form Item options, e ainda contam com a opção
de Formatação, ou Format phrase. Já os frames possuem somente as opções de Frame ou Frame phrase.
Há dois grupos de frames, as de relatórios (em colunas) e as frames para widgets. Esses grupos são distintos
pois suas opções são excludentes.
Frames de relatórios
São os frames padrão e que contém as opções:
down
stream-io
width 128
no-box
Frames para widgets

São os frames que contém as opções:
1 down
three-d
side-labels
size 80 by 20
Opções Para Campos E Constantes

Sintaxe para Opções dos Campos e Constantes (Form item options)
{ field [ format-phrase ]
| constant [ at-phrase | { TO n } ]
111
(18) 99747-8189
[ DCOLOR expression ]
[ FONT expression ]
[ PFCOLOR expression ]
[ VIEW-AS TEXT ]
[ WIDGET-ID id-number ]
| SPACE [ ( n ) ]
| SKIP [ ( n ) ]
}
Principais Opções dos Campos e Constantes

BGColor Especifica a cor de fundo do Janelas com campos ou
campo em ambientes relatórios.
gráficos.
DColor Especifica a cor de fundo do Janelas com campos ou
caracter.
FGColor Especifica a cor do texto do Janelas com campos ou
gráficos.
FONT Determina a fonte do Janelas com campos ou
campo. relatórios.
PFColor Determina a cor de prompt Janelas com campos ou
para o campo em ambientes relatórios.
caracter.
View-as text Determina a exibição do Janelas com campos ou
campo como TEXTO. relatórios. Comumente em
relatórios.
Widget-ID É o identificador único do Janelas com campos.
objeto entre 2 e 65534.
Space Determina a quantidade de Janelas com campos ou
espaços em branco. relatórios.
Skip Determina a quantidade de Janelas com campos ou
saltos de linha. relatórios.
Sintaxe para a Formatação de campos (Format phrase)
[ at-phrase ]
[ AS datatype | LIKE field ]
[ ATTR-SPACE | NO-ATTR-SPACE ]
[ AUTO-RETURN ]
[ BLANK ]
[ COLON n | TO n ]
[ COLUMN-LABEL label ]
[ DEBLANK ]
[ DCOLOR expression ]
[ DISABLE-AUTO-ZAP ]
[ FONT expression ]
[ FORMAT string ]
[ HELP string ]
[ LABEL label [ , label ] ... | NO-LABELS ]
[ NO-TAB-STOP ]
[ PFCOLOR expression ]
[ VALIDATE ( condition , msg-expression ) ]
[ view-as-phrase ]
[ WIDGET-ID id-number ]
112
(18) 99747-8189
Principais opções da Formatação de campos

AT COLUMN coluna ROW Pode determinar a coluna e Janelas com campos ou
linha linha do campo, medida em relatórios.
caracteres.
Pode opcionalmente
determinar o alinhamento
por dois pontos, pela
esquerda ou pela direita do
campo.
AT n Para determinar a coluna de Janelas com campos ou
exibição, medida em relatórios.
caracteres.
AT X x Y y Pode determinar a coluna e Janelas com campos ou
linha do campo, medida em relatórios.
pixels.
Pode opcionalmente
determinar o alinhamento
por dois pontos, pela
esquerda ou pela direita do
campo.
Colon n Determina o número da Janelas com campos ou
coluna que o dois pontos relatórios.
será exibido. Utilizar em
frames com side-label.
To n O número da coluna que Janelas com campos ou
deseja terminar a exibição relatórios.
do campo.
Column-label rótulo Determina o rótulo da Janelas de relatórios.
coluna.
Format Determina a formatação do Janelas com campos ou
campo. relatórios.
Help Determina a ajuda do Janelas com campos.
campo.
Label Determina o rótulo do Janelas com campos ou
campo. relatórios.
No-labels Sem rótulo para o campo. Janelas de relatórios.
Validate (condição, Determina a validação e a Janelas com campos e
mensagem) mensagem do campo. objetos.
View-as Determina a visualização do Janelas com campos ou
campo. relatórios.
Opções para o Frame

Sintaxe da Definição da Frame
WITH [ ACCUM [ max-length ] ]

[ at-phrase ] [ ATTR-SPACE | NO-ATTR-SPACE ]
113
(18) 99747-8189
[ CANCEL-BUTTON button-name ] [ CENTERED ]

[ color-specification ]
[ COLUMN expression ] [ n COLUMNS ]
[ CONTEXT-HELP ] [ CONTEXT-HELP-FILE help-file-name ]
[ DEFAULT-BUTTON button-name ]
[ DROP-TARGET ]
[ [ expression ] DOWN ] [ EXPORT ]
[ WIDGET-ID id-number ] [ FONT expression ]
[ FRAME frame ]
[ INHERIT-BGCOLOR | NO-INHERIT-BGCOLOR ]
[ INHERIT-FGCOLOR | NO-INHERIT-FGCOLOR ]
[ KEEP-TAB-ORDER ] [ NO-BOX ]
[ NO-HIDE ] [ NO-LABELS ] [ USE-DICT-EXPS ]
[ NO-VALIDATE ] [ NO-AUTO-VALIDATE ]
[ NO-HELP ] [ NO-UNDERLINE ]
[ OVERLAY ] [ PAGE-BOTTOM | PAGE-TOP ] [ RETAIN n ]
[ ROW expression ] [ SCREEN-IO | STREAM-IO ]
[ SCROLL n ] [ SCROLLABLE ] [ SIDE-LABELS ]
[ size-phrase ] [ STREAM stream | STREAM-HANDLE handle ] [ THREE-D ]
[ title-phrase ] [ TOP-ONLY ] [ USE-TEXT ]
[ V6FRAME [ USE-REVVIDEO | USE-UNDERLINE ] ]
[ VIEW-AS DIALOG-BOX ] [ WIDTH n ] [ IN WINDOW window ]
Principais Opções da Definição da Frame

Centered Para centralizar a frame Em frames com campos e objetos que precisam
estrar centralidas.
Title titulo Para a frame ter título Em frames que precisam de título, somente
pode ser usada com frame com BOX.
No-box Para retirar a caixa em Em relatórios e em frames que não precisam de
torno do frame caixa.
Use-text Para especificar que os Em relatórios.
objetos do frame serão
textos ao contrário de
FILL-IN
View-as dialog-box Para exibir a janela como Em frames que precisam ser exibidas como
janela de diálogo diálogo.
Width n Para determinar a largura Em relatórios.
em caracteres que o
frame tem.
Three-d Para exibir a frame e os Em janelas que tenham objetos e campos.
objetos em três
dimensões.
Side-labels Para exibir os rótulos ao Em janelas com campos e em relatórios.
lado dos campos
separados por “:” dois
pontos.
Row n Para indicar a linha que a Em janelas com campos e variáveis.
frame será exibida.
Page-bottom Para indicar que a frame Em relatórios.
será exibida no rodapé a
cada término de página.
Page-top Para indicar que a frame Em relatórios.
será exibida no topo a
cada início de página.
114
(18) 99747-8189
Overlay Para indicar que a frame Em janelas que fazem sobreposição sobre
pode sobrepor outro outras janelas.
frame.
No-labels Em frames que não Em relatórios.
exibirão os rótulos dos
campos.
No-underline Para indicar que não Em relatórios.
haverá linha abaixo dos
campos.
No-box Para remover a caixa em Em relatórios.
torno do frame.
Keep-tab-order Para manter a ordem de Em janels com campos e objetos.
tabulação dos campos.
Frame nome-da-frame Para dar nome ao frame. Em relatórios e janelas com campos.
Default-button Para indicar o botão Em janelas com campos e objetos.
padrão, é aquele que
recebe o ENTER.
Column n Para indicar a coluna que Em janelas de campos e objetos.
o frame será exibido.
n Column Para indicar o número de Em janelas com campos de tabela.
colunas que a frame terá
Down Para indicar que a frame Em relatórios.
será DOWN, frames Down
é aquela que exibirá
múltiplas ocorrências dos
campos definidos nela.
n Down Para indicar quantas Em relatórios.
interações uma frame
down terá.
Cancel-button Para indicar o botão que Em janelas de campos e objetos.
receberá o ESC.
Headder Para indicar o cabeçalho Em janelas de campos e relatórios.
do frame.
Stream-io Para indicar que as fontes Em relatórios.
serão ignoradas e a fonte
FIXA será usada, retirando
ainda todo espaço de
borda entre os campos.
Compartilhamento
Frames podem ser compartilhados, entre programas, com o uso de New e ou Shared.
DEFINE { [ [ NEW ] SHARED ] | [ PRIVATE ] } FRAME frame

record [ EXCEPT field ... ]
{ [ frame-phrase ] }
Exemplo
DEFINE VARIABLE bal-avail LIKE customer.balance

COLUMN-LABEL "Credito" NO-UNDO.
DEFINE FRAME frame-Balanco
115
(18) 99747-8189
customer.custnum
customer.name FORMAT "X(20)"
customer.creditlimit LABEL "Limite"
customer.balance
bal-avail
WITH CENTERED ROW 3 TITLE "Credito disponivel" USE-TEXT.
FOR EACH customer NO-LOCK WITH FRAME frame-Balanco:

DISPLAY customer.custnum
customer.name
customer.balance
customer.creditlimit - customer.balance @ bal-avail.
END.
Instrução Display
A instrução Display transporta o valor do Record Buffer de uma variável ou registro para o Screen Buffer ou
para outro destino de saída.
Um frame definido com vários campos e variáveis pode ser usada para a instrução display exibir um único
campo ou variável ou para exibir diversos campos e variáveis, neste mesmo frame.
A linguagem Progress ABL permite que você sobrepõe opções de campos, de formatação de campos ou
opções do frame durante a instrução Display. O mais indicado é manter a definição do frame a fim de evitar
janelas com identidades diferentes das definidas.
Sintaxe
DISPLAY
{ [ STREAM stream | STREAM-HANDLE handle ] [ UNLESS-HIDDEN ] }
[ { expression
[ format-phrase ]
[ ( aggregate-phrase ) ]
[ WHEN expression ]
[ @base-field ]
}
| [ SPACE [ ( n ) ] ]
| [ SKIP [ ( n ) ] ]
] ...
{ [ IN WINDOW window ] [ frame-phrase ] [ NO-ERROR ] }
Para exibir expressões.
Sintaxe
DISPLAY
record [ EXCEPT field ... ]
Para exibir campos de tabelas.
116
(18) 99747-8189
Sintaxe
DISPLAY
{ expression ...
| record [ EXCEPT field ... ]
}
WITH BROWSE browse [ NO-ERROR ]
Para exibir no browser.
Exemplo
/* definindo variaveis idade e nome */

DEFINE VARIABLE iIdade AS INTEGER NO-UNDO INIT 37
LABEL 'Idade'.
DEFINE VARIABLE cNome AS CHARACTER NO-UNDO INIT 'Jaison'
LABEL 'Nome'.
/* definer frame frameA, frameB e frameC com as mesmas variaveis */

DEFINE FRAME frameA
iidade AT ROW 1 COL 10 COLON-ALIGNED

cNome AT ROW 2 COL 10 COLON-ALIGNED
WITH SIDE-LABELS
THREE-D
SIZE 30 BY 4
ROW 1 COL 1
TITLE 'Frame A'.
DEFINE FRAME frameB

WITH SIDE-LABELS
THREE-D
SIZE 30 BY 4
ROW 1 COL 45
TITLE 'Frame B'.
DEFINE FRAME frameC

WITH SIDE-LABELS
THREE-D
SIZE 30 BY 4
ROW 5.5 COL 1
TITLE 'Frame C'.
/* exibir as variaveis na frame frameA */

DISPLAY
iIdade
cNome
WITH FRAME FRAMEA.
117
(18) 99747-8189
/* exibir as variaveis na frame frameB */

DISPLAY
iIdade
cNome
WITH FRAME FRAMEB.
/* exibir as variaveis na frame frameC */

DISPLAY
iIdade
cNome
WITH FRAME FRAMEC.
MESSAGE 'Antes de atribuir e mostrar idade...'

/* atribuir novo valor a idade*/

ASSIGN
iidade = 50.
/* exibir o novo valor da idade na frame frameA */

DISPLAY
iIdade
WITH FRAME FRAMEA.
MESSAGE 'Antes de exibir o novo valor na frameB'

DISPLAY
iidade
WITH FRAME frameB.
Frame de relatório
Abaixo está um exemplo completo de programa com frames e opções page-top e page-bottom, com o
funcionamento e exibição de dados com saída para impressora.
DEFINE VARIABLE titulo AS CHARACTER FORMAT 'x(40)' NO-UNDO.

DEFINE VARIABLE programa AS CHARACTER FORMAT 'x(20)' NO-UNDO.
DEFINE VARIABLE empresa AS CHARACTER FORMAT 'x(30)' NO-UNDO.
ASSIGN
titulo = 'Listagem de clientes'
programa = 'SPP/SPR0004.P'
empresa = 'Neo Step TI Ltda.'.
DEFINE FRAME frameTop

HEADER
titulo
empresa TO 127 SKIP
FILL('-', 120) FORMAT 'x(128)'
WITH
NO-LABELS
STREAM-IO
NO-BOX
/* esta frame sera do tipo page-top */
PAGE-TOP
WIDTH 128.
118
(18) 99747-8189
DEFINE FRAME frameBottom

HEADER
FILL('-', 120) FORMAT 'x(128)' SKIP
programa TO 20
'Pag.' TO 110 PAGE-NUMBER TO 120 SKIP
WITH
SIDE-LABELS
STREAM-IO
NO-BOX
/* esta frame sera do tipo page-bottom */
PAGE-BOTTOM
WIDTH 128.
/* frame normal para exibir os dados do cliente */

DEFINE FRAME frameCustomer
customer.custnum
customer.NAME
customer.address
customer.salesrep
salesrep.repname
WITH
DOWN
STREAM-IO
NO-BOX
WIDTH 128.
OUTPUT TO PRINTER PAGED PAGE-SIZE 60.
/* exibir a frame top com o titulo do programa e empresa */

VIEW FRAME frameTop.
/* exibir a frame bottom com o nome do programa e a pagina */
VIEW FRAME frameBottom.
FOR EACH customer NO-LOCK,

FIRST salesrep NO-LOCK
WHERE salesrep.salesrep = customer.salesrep :
DISPLAY
customer.custnum
customer.NAME
customer.address
customer.salesrep
salesrep.repname
WITH FRAME frameCustomer.
END.
OUTPUT CLOSE.
O programa acima gerará saída:
119
(18) 99747-8189
Frames Sobrepostas
Frames podem ser sobrepostas, mas é necessário informar a frame pai que abrigará as demais filhas.
A figura abaixo exemplifica o código que seguirá.
Exemplo de frames sobrepostas
120
(18) 99747-8189
DEFINE FRAME frameback

WITH
SIZE 60 BY 15
CENTERED.
DEFINE FRAME frametopleft

WITH
SIZE 15 BY 6
AT ROW 3 COL 3
.
DEFINE FRAME framebottomleft

WITH
SIZE 33 BY 2
AT ROW 9.2 COL 3 .
DEFINE FRAME frameright

WITH
SIZE 20 BY 8.2
AT ROW 3 COL 39 .
FRAME frametopleft:FRAME = FRAME FRAMEback:HANDLE.

FRAME framebottomleft:FRAME = FRAME FRAMEback:HANDLE.
FRAME frameright:FRAME = FRAME FRAMEback:HANDLE.
VIEW FRAME FRAMEback.

VIEW FRAME frametopleft.
As sete regras da programação com eventos

1. Declarar variáveis,
2. Declarar frames e colocar variáveis,
3. Codificar eventos, triggers e procedures,
4. Exibir os frames (view frame),
5. Exibir as variáveis nos frames (disp variavel-1 variavel-2),
6. Habilitar objetos nos frames,
7. Aguardar pelo wait-for.
Anotações
121
(18) 99747-8189
Exercício
Para a nomenclatura dos exercícios, utilize a máscara FRM_<número do exercício>.P (FRM_1.p, FRM_2.p).
1. Crie um frame, adicionando o título Olá Mundo,

2. Crie um programa com uma frame conforme a figura abaixo.
3. Criar uma frame conforme a figura abaixo, utilize o banco Sports2000 e tabela CUSTOMER.
4. Criar relatório exportando o representante de vendas e seus pedidos, na frame framesalesrep exibir
os campos Salesrep.SalesRep Salesrep.RepName Salesrep.Region, na frame frameOrder exibir os
campos Order.Ordernum, Order.OrderDate, Order.CustNum, Customer.NAME, Order.Creditcard,
Order.ShipDate e Order.Terms. Os frames frameSalesrep e frameOrder deverão ter a opção DOWN.
Todas os frames deverão ter as opções STREAM-IO, NO-BOX e WIDTH 128. A frame frameTOP
conterá cabeçalho e a opção PAGE-TOP, a frame frameBottom terá a opção PAGE-BOTTOM. Utilizar
a instrução OUTPUT conforme “OUTPUT TO c:\temp\spr0018.txt PAGED PAGE-SIZE 60 NO-
CONVERT.” Não esquecendo de fechar o OUTPUT com “OUTPUT CLOSE.”. Para exibir os frames
FrameTop e FrameBottom utilize a instrução “VIEW FRAME frameTop.” e “VIEW FRAME
frameBottom.”. Para realizar a quebra de página a cada representante use a instrução “PAGE” após
o END do FOR ORDER. (Em conjunto com o Instrutor).
122
(18) 99747-8189
Resultado do exercicio.
123
(18) 99747-8189
Objetos, Eventos e Gatilhos de Widgets

Objetos ou Widgets são os botões, campos de entrada de texto, listas de seleção que permitem interação
com o usuário.
Eventos são as ações disponíveis para cada tipo de Widget, botões possuem evento de clique, campos de
entrada de texto possuem evento de “ao alterar”, alguns eventos são comuns a vários widgets, outros não.
Códigos de Gatilhos são as instruções executadas em um determinado evento.
Tipos de Objetos
Os tipos mais utilizados são:
1. Browse, grade de navegação,

2. Buttons, botões,
3. Combo-box, listas de seleção com um item visível,
4. Editor, caixa de entrada de texto com múltiplas linhas,
5. Fill-in, caixas de entrada de texto,
6. Frames, áreas retangulares contendo widgets,
7. Image, imagens com BMP ou JPEG,
8. Radio-set, conjunto de botões de radio,
9. Rectangle, retângulos para organização de widgets,
10. Selection-list, listas de seleção com vários itens visíveis,
11. Slider, linha de valores com botão de seleção,
12. Text, textos nas frames.
13. Toggle-box, botões de checagem,
Anotações
Estes objetos “widgets” podem ser criados de forma dinâmica ou estática.
Objetos Estáticos
Os objetos são variáveis com a opção “view-as” ou através da instrução “define” .
Sintaxe
VIEW-AS
{ combo-box-phrase
| editor-phrase
| FILL-IN
[ NATIVE ]
(18) 99747-8189
[ size-phrase ]
[ TOOLTIP tooltip ]
| radio-set-phrase
| selection-list-phrase
| slider-phrase
| TEXT
[ size-phrase ]
[ TOOLTIP tooltip ]
| TOGGLE-BOX
[ size-phrase ]
[ TOOLTIP tooltip ]
}
Exemplos de Fill-in
DEFINE VARIABLE fillin1 AS INTEGER NO-UNDO INITIAL 12

LABEL "números"
FORMAT '99999'
VIEW-AS FILL-IN
SIZE-PIXELS 70 BY 21.
DEF VAR teste3 AS INTEGER
LABEL 'Valor'
FORMAT '>>>>9'
VIEW-AS FILL-IN
SIZE 6 BY 1
INITIAL 1986.
Update Fillin1 Teste3.
Exemplos de Combo-box
DEFINE VARIABLE nomes AS CHAR

LABEL 'Nomes'
FORMAT 'x(20)'
VIEW-AS COMBO-BOX
LIST-ITEMS 'Claudiomir','willian','wellington'
INNER-LINES 5
DROP-DOWN-LIST NO-UNDO.
DEF VAR carros AS CHAR
LABEL 'Carros chiques'
FORMAT 'x(20)'
VIEW-AS COMBO-BOX
LIST-ITEM-PAIRS 'Ferrari','F',
'Brasilia','B',
'Passat','P',
'Gurgel','G',
'Lada','L'
DROP-DOWN
SORT
SIZE 10 BY 1
AUTO-COMPLETION
UNIQUE-MATCH
125
(18) 99747-8189
NO-UNDO.
DEF VAR idades AS INT

LABEL 'Idade'
FORMAT '>>>9'
VIEW-AS COMBO-BOX
LIST-ITEMS '1','2','3','4'
INNER-LINES 3
NO-UNDO.
DEF VAR datas AS DATE

LABEL 'Feriado'
FORMAT "99/99/9999"
VIEW-AS COMBO-BOX
LIST-ITEM-PAIRS '01/01/2015',01/01/2015,
'15/07/1975',15/07/1975,
'31/12/2015',31/12/2015
INNER-LINES 3
NO-UNDO.
DEFINE VARIABLE cidades AS CHAR
LABEL 'Cidade'
FORMAT 'x(50)'
VIEW-AS COMBO-BOX
LIST-ITEMS 'Joinville','Sao Francisco do Sul','Sao Paulo','Rio de
Janeiro'
INNER-LINES 5
TOOLTIP 'Cidades do Brasil'
DROP-DOWN-LIST
MAX-CHARS 50
NO-UNDO.
UPDATE
Cidades datas idades carros nomes
WITH
1 COL
THREE-D
SIDE-LABELS
SIZE 80 BY 20.
Exemplos de Editor
DEF VAR texto AS CHAR

LABEL 'Obs'
FORMAT 'x(500)'
VIEW-AS EDITOR
INNER-CHARS 40 INNER-LINES 5
NO-WORD-WRAP
SCROLLBAR-HOR
SCROLLBAR-VER
NO-UNDO.
DEF VAR texto2 AS CHAR
126
(18) 99747-8189
LABEL 'SQN'
FORMAT 'x(50)'
VIEW-AS EDITOR
SIZE 50 BY 5
MAX-CHARS 70
NO-BOX
NO-WORD-WRAP
SCROLLBAR-HOR
SCROLLBAR-VER
NO-UNDO.
Update
Texto text2.
Exemplo de Radio-set
DEF VAR valores AS DECIMAL

LABEL 'valor'
FORMAT '>>,>>9.99'
VIEW-AS RADIO-SET
HORIZONTAL EXPAND
SIZE-PIX
450 BY 70
RADIO-BUTTONS
'B', 30, 'c', 78.90,'M', 39000
NO-UNDO.
Exemplo de Selection-list
DEF VAR lista-selecao AS CHAR

LABEL 'Lista de Seleção'
FORMAT 'x(15)'
VIEW-AS SELECTION-LIST
MULTIPLE
NO-DRAG
LIST-ITEMS 'Janeiro','Fevereiro','Março','Abril'
SCROLLBAR-VERTICAL
INNER-CHARS 20 INNER-LINES 10
INITIAL 'Fevereiro'
NO-UNDO.
Exemplo de Slider
DEF VAR teste1 AS INTEGER

LABEL 'Slider'
VIEW-AS SLIDER
MAX-VALUE 200 MIN-VALUE 2
VERTICAL
TIC-MARKS LEFT FREQUENCY 15
SIZE 20 BY 10
NO-UNDO.
Anotações
127
(18) 99747-8189
Objetos Dinâmicos
Há outra forma de criarmos objetos dinâmicos utilizando a instrução “create widget”, sendo “widget” o tipo
de objeto desejado.
Sintaxe
CREATE { BUTTON | COMBO-BOX

| CONTROL-FRAME | DIALOG-BOX
| EDITOR | FILL-IN
| FRAME | IMAGE
| MENU | MENU-ITEM
| RADIO-SET | RECTANGLE
| SELECTION-LIST | SLIDER
| SUB-MENU | TEXT
| TOGGLE-BOX | WINDOW
| VALUE ( string-expression )
} handle [ IN WIDGET-POOL pool-name ]
[ ASSIGN { attribute = expression } ... ]
[ trigger-phrase ]
Exemplo
CREATE FILL-IN hfillin1

ASSIGN
FRAME = FRAME framemain:handle
X = 70
Y = 10
FORMAT = 'x(80)'
WIDTH-PIXELS = 70
HEIGHT-PIXELS = 21
SCREEN-VALUE = "ola mundo"
VISIBLE = TRUE
SENSITIVE = TRUE
TRIGGERS:
ON 'value-changed':u
DO:
MESSAGE "screen-value = " hfillin1:screen-value
END.
END TRIGGERS.
Anotações
128
(18) 99747-8189
Eventos
Eventos são as ações disponíveis para cada tipo de Widget.
Eventos comumente utilizados:
• Choose, ao pressionar um botão,

• Value-changed, ao alterar o valor de widget fill-in, editor...
• Mouse-select-click, quando ocorre o clique do mouse,
• Mouse-extended-click, quando ocorre o clique do mouse mais o botão CTRL.
Anotações
Códigos de Gatilhos
São as instruções executadas em um determinado evento. Códigos de gatilhos geram novos blocos e
transações.
Podemos aplicar um evento em um outro objeto com a instrução “apply” e parar a execução deste código
com a instrução “return no-apply”.
Anotações
Exemplo Objetos Estáticos
/* definicao do widget - botao */

DEFINE BUTTON button1
LABEL "clique aqui"
DEFINE VARIABLE combo1 AS CHARACTER NO-UNDO INITIAL "joinville"

LABEL "combo exemplo"
FORMAT 'x(30)'
VIEW-AS COMBO-BOX
LIST-ITEMS "joinville","curitiba","sao paulo"
DROP-DOWN-LIST
SIZE-PIXELS 85 BY 71
.
DEFINE VARIABLE fillin1 AS INTEGER NO-UNDO INITIAL 12

LABEL "números"
FORMAT '99999'
VIEW-AS FILL-IN
129
(18) 99747-8189
DEFINE VARIABLE toggle1 AS LOG NO-UNDO INIT TRUE

LABEL "sexo"
VIEW-AS TOGGLE-BOX
DEFINE VARIABLE radio1 AS INTEGER NO-UNDO INIT 2

LABEL "uf"
VIEW-AS RADIO-SET
RADIO-BUTTONS "sc", 1,
"pr", 2.
DEFINE VARIABLE editor1 AS CHARACTER NO-UNDO INIT "openedge é simples"

LABEL "observacao"
VIEW-AS EDITOR
/* definicao da frame com o botao */

DEFINE FRAME framemain
button1
combo1 AT ROW 2 COL 10
fillin1 AT ROW 3.1 COL 10
toggle1 AT ROW 4.1 COL 10
radio1 AT ROW 5.1 COL 10
editor1 AT ROW 7 COL 10
WITH
CENTERED
THREE-D
SIZE 60 BY 20
SIDE-LABELS
TITLE "janela principal".
/* definicao do evento choose e do codigo trigger */

ON 'choose':u OF button1
DO:
/* codigo trigger */
MESSAGE "ola mundo" SKIP button1:dynamic
END.
/* evento de value-changed do combo1 */

ON 'value-changed':u OF combo1
DO:
/* transferir o valor do screen buffer para o record buffer */
ASSIGN INPUT FRAME framemain combo1.
MESSAGE combo1
END.
/* evento de value-changed do fillini1 */

ON 'value-changed':u OF fillin1
DO:
ASSIGN INPUT FRAME framemain fillin1.
MESSAGE fillin1
END.
/* evento de value-changed do toggle1 */
130
(18) 99747-8189
ON 'value-changed':u OF toggle1
DO:
ASSIGN INPUT FRAME framemain toggle1.
MESSAGE "aplicando o evento de choose no botao"
/* aplicar o evento em outro objeto */

APPLY "choose" TO button1.
END.
/* evento value-changed no editor1 */

ON 'value-changed':u OF editor1
DO:
/* condicao if somente para evitar msg 15090*/

IF 1 = 1 THEN
DO:
RETURN NO-APPLY.
END.
MESSAGE "este codigo nao sera executado"

END.
/* evento mouse-select-click para mostrar uso do objeto self */

ON 'mouse-select-click':u OF
button1,
combo1,
fillin1,
toggle1,
radio1,
editor1
DO:
MESSAGE SELF:name
END.
/* visualizar a frame */
VIEW FRAME framemain.
/* habilitar alguns ou todos all widgets */
ENABLE ALL WITH FRAME framemain.
/* exibir o valor inicial das variaveis */
DISPLAY
combo1
fillin1
toggle1
radio1
editor1
WITH FRAME framemain.
/* aguardar por determinado evento para encerrar o programa */

WAIT-FOR ENDKEY OF FRAME framemain.
VIEW FRAME frameMain.
/* habilitar alguns ou todos ALL widgets */
ENABLE ALL WITH FRAME frameMain.
131
(18) 99747-8189
/* aguardar por determinado evento para encerrar o programa */

WAIT-FOR ENDKEY OF FRAME frameMain.
Anotações
Exemplo Objetos Dinâmicos

DEFINE VARIABLE hfillin1 AS HANDLE NO-UNDO.
DEFINE VARIABLE hbuttonok AS HANDLE NO-UNDO.
/* definicao da frame com o botao */

DEFINE FRAME framemain
WITH
CENTERED
THREE-D
SIZE 60 BY 20
SIDE-LABELS
TITLE "janela principal".
CREATE FILL-IN hfillin1

ASSIGN
X = 70
Y = 10
FORMAT = 'x(80)'
WIDTH-PIXELS = 70
HEIGHT-PIXELS = 21
SCREEN-VALUE = "ola mundo"
VISIBLE = TRUE
SENSITIVE = TRUE
TRIGGERS:
ON 'value-changed':u
DO:
MESSAGE "screen-value = " hfillin1:screen-value
END.
END TRIGGERS.
CREATE BUTTON hbuttonok

ASSIGN
WIDTH-PIXELS = 70
HEIGHT-PIXELS = 21
X = FRAME framemain:width-pix - 100
Y = FRAME framemain:height-pix - 50
LABEL = "ok"
VISIBLE = TRUE
SENSITIVE = TRUE
TRIGGERS:
ON 'choose':u PERSISTENT RUN pressionarok.
END TRIGGERS.
DISPLAY
WITH FRAME framemain.
132
(18) 99747-8189
WAIT-FOR ENDKEY OF FRAME framemain.
DELETE OBJECT hfillin1.

DELETE OBJECT hbuttonok.
PROCEDURE pressionarok:
MESSAGE "ola mundo" SKIP
"valor do fill-in = " hfillin1:SCREEN-VALUE
END.
Anotações
133
(18) 99747-8189
Compartilhamento de variáveis e objetos

A linguagem ABL possui duas formas de compartilhar variáveis e objetos:
1. Através do uso das opções New Shared e Shared permitido somente entre programa pai e programa
filho (A que executa B),
2. Através da opção New Global Shared, que permite o valor de variáveis e objetos ficar à disposição
enquanto a sessão estiver ativa.
Estes dois formatos permitem compartilhar quase que todos os objetos da linguagem ABL, sejam estas
variáveis, objetos como as frames, queries, browsers, buffers, datasets, menus, streams e tabelas
temporárias.
Compartilhamento de variáveis entre programas

DEFINE NEW SHARED VARIABLE del AS LOGICAL.
DEFINE NEW SHARED VARIABLE nrecs AS INTEGER.
Exemplo
DEFINE SHARED VARIABLE del AS LOGICAL.

DEFINE SHARED VARIABLE nrecs AS INTEGER.
Mostraremos um exemplo simples, um programa progSharedA executará um programa progSharedB. No

programa progSharedA temos a declaração de uma variável, esta será compartilhada entre ambos.
Exemplo
1 DEFINE
NEW SHARED
VARIABLE nome
FORMAT 'x(30)'
VIEW-AS FILL-IN
SIZE-PIX 90 BY 21
.
2 DO WITH FRAME frameA

TITLE
'Dentro do programa progSharedA'
SIZE 60 BY 3
AT ROW 1 COL 1
SIDE-LABELS:
3 UPDATE nome.
4 RUN progSharedB.p.
5 UPDATE nome.
6 END.
Programa ProgSharedA.p
134
(18) 99747-8189
Durante a execução do programa progSharedB.p a variável nome deve ser declarada como Shared,
indicando que o programa pai a criou com a opção New Shared.
7 DEFINE
SHARED
VARIABLE nome
FORMAT 'x(30)'
VIEW-AS FILL-IN
SIZE-PIX 90 BY 21
.
8 DO WITH FRAME frameB

TITLE
'Dentro do programa progSharedB'
SIZE 60 BY 3
AT ROW 5 COL 1
1 COLUMN:
9 UPDATE nome.
10 END.
Programa ProgSharedB.p
Em todo a execução do progSharedA e do progSharedB, a sessão ativa da linguagem ABL compartilhará o

valor da variável, que pode ser alterada durante o processo.
Anotações
Compartilhamento de variáveis e objetos na sessão

DEFINE NEW GLOBAL SHARED VARIABLE first-time
AS LOGICAL INITIAL TRUE.
O compartilhamento de variáveis e objetos através da opção New Global Shared é bastante diferente da
opção com New Shared, pois não depende que o programa pai crie o compartilhamento da variável através
da opção New Shared e que o programa filho reutilize estes variáveis com a opção Shared.
Anotações
135
(18) 99747-8189
A tabela abaixo mostra algumas características entre as opções New Shared e New Global
Shared.
New Shared New Global Shared

Compartilha valores entre programas? Sim Sim
Depende da execução entre programas e Sim Não
subprogramas aninhados
Variáveis e objetos ficam compartilhados Não Sim
durante a sessão ABL
O compartilhamento se encerra com o fim dos Sim Não
programas
(18) 99747-8189
Exercícios
Para a nomenclatura dos exercícios, utilize a máscara SHARE_<número do exercício>.P (SHARE
_1.p, SHARE _2.p).
1. Crie um programa que chame um subprograma, compartilhe uma variável inteira e

outra lógica entre os dois programas, utilize New Shared e Shared.
2. Crie uma variável do tipo data compartilhada com o New Global Shared e atribua valor
a esta através da instrução Update.
a. Crie um novo programa com o mesmo nome e a mesma declaração desta
variável.
b. Mostre o valor e verifique se está com o valor previamente inserido.
c. Não use programas aninhados.
137
(18) 99747-8189
Procedimentos e funções
Procedimento são segmentos de códigos que podem ser internos ou externos, onde estes, externos, podem
ser chamadas à DLLs do Windows ou Bibliotecas Compartilhadas do UNIX, ou chamadas a outros programas
ABL.
Procedimentos internos
São os segmentos internos de códigos ABL que podem ser executados
Sintaxe procedimentos internos
PROCEDURE proc-name [ PRIVATE ] :
[ procedure-body ]
Exemplo de declaração de procedimento interno
PROCEDURE mostrarValor:
DISPLAY "Ola mundo".
END.
/*mostrar valor passado como parametro*/
RUN mostrarValor ( INPUT 100).
PROCEDURE mostrarValor:
DEFINE INPUT PARAMETER Valor AS INTEGER NO-UNDO.
DISPLAY valor.
END.
Anotações
Procedimentos de Bibliotecas Externas

São as chamadas às DLLs ou Bibliotecas compartilhadas do sistema operacional.
Sintaxe procedimentos externos
PROCEDURE proc-name
{ EXTERNAL "dllname" [ CDECL | PASCAL | STDCALL ]
[ ORDINAL n ] [ PERSISTENT ]
(18) 99747-8189
| IN SUPER } :
[ procedure-body ]
Exemplo com chamada ao procedimento externo
/*executando procedure externa, neste exemplo, da API do Windows*/
DEFINE VARIABLE result AS INTEGER.
MESSAGE "Usando o message do Progress ABL."

VIEW-AS
ALERT-BOX MESSAGE
BUTTONS OK
TITLE "Mensagem".
RUN MessageBoxA (0, "Agora usando a API do Windows",

"Aqui vai o titulo", 0, OUTPUT result).
PROCEDURE MessageBoxA EXTERNAL "user32.dll":

DEFINE INPUT PARAMETER hwnd AS LONG.
DEFINE INPUT PARAMETER mbtext AS CHARACTER.
DEFINE INPUT PARAMETER mbtitle AS CHARACTER.
DEFINE INPUT PARAMETER style AS LONG.
DEFINE RETURN PARAMETER result AS LONG.
END.
Anotações
Passagem de parâmetros
É a passagem de um ou mais valores para um procedimento interno, programa ou função.
Sintaxe
[ INPUT | OUTPUT | INPUT-OUTPUT ]

{ parm
| { { TABLE temp-table-name
| TABLE-HANDLE temp-table-handle
| DATASET dataset-name
| DATASET-HANDLE dataset-handle
} [ APPEND ] [ BY-VALUE | BY-REFERENCE | BIND ]
}
}
A linguagem ABL permite a passagem por valor, por referência e retorno.
139
(18) 99747-8189
Por valor
[ INPUT ]
{ parm
}
}
Exemplo
DISPLAY icont.
PAUSE.
RUN retornarValor ( INPUT icont ).
DISPLAY icont.
DEFINE INPUT PARAMETER valor AS INTEGER NO-UNDO.
valor = valor + 10.
DISPLAY valor.
END.
Anotações
Por referência
[ INPUT-OUTPUT ]
{ parm
}
}
Exemplo
/*passagem de parametros por Referencia

*/
140
(18) 99747-8189
DISPLAY icont.
PAUSE.
RUN retornarValor ( INPUT-OUTPUT icont).
DISPLAY icont.
DEFINE INPUT-OUTPUT PARAMETER valor AS INTEGER NO-UNDO.
valor = valor + 10.

END.
Anotações
De retorno
[ OUTPUT ]
{ parm
}
}
Exemplo
DISPLAY icont.
PAUSE.
RUN retornarValor ( OUTPUT icont).
DISPLAY icont.
DEFINE OUTPUT PARAMETER valor AS INTEGER NO-UNDO.
valor = valor + 10.

END.
Anotações
141
(18) 99747-8189
Podemos passar ponteiros de tabelas e tabelas temporárias.
Passagem de ponteiros de tabelas

BUFFER buffer
Exemplo

RUN meuprograma.p (BUFFER customer).
Exemplo meuprograma.p
DEFINE PARAMETER BUFFER bcustomer FOR customer.
DISPLAY bcustomer.NAME.
Anotações
Passagem de tabelas temporárias

TABLE temp-table-name
Exemplo
DEFINE TEMP-TABLE ttcustomer0 LIKE customer.

DO:
CREATE ttcustomer0.
BUFFER-COPY customer TO ttcustomer0.
END.
RUN meuprogramat.p (INPUT TABLE ttcustomer0).
142
(18) 99747-8189
Exemplo meuprogramat.p
DEFINE TEMP-TABLE ttcustomer0 LIKE customer.
DEFINE INPUT PARAMETER TABLE FOR ttcustomer0.
FIND FIRST ttcustomer0.
DISPLAY ttcustomer0.NAME.
Anotações
143
(18) 99747-8189
Exercício
Para a nomenclatura dos exercícios, utilize a máscara PASS_<número do exercício>.P (PASS_1.p, PASS_2.p).
1. Criar programa que execute procedimento externo, este deverá retornar a data de hoje.
2. Criar programa que execute procedimento interno, este deverá retornar a hora corrente.
3. Criar programa que execute procedimento interno, passe um número decimal, este procedimento
deverá retornar o número multiplicado por 2. Utilize um parâmetro com o número e outro
parâmetro de retorno para o valor calculado.
4. Criar programa que execute procedimento interno, passe um número decimal, este procedimento
deverá retornar o número multiplicado por 2. Utilize passagem por referência.
144
(18) 99747-8189
Funções
A linguagem ABL possui várias funções como Index, Can-find, Lookup, Num-entries, mas em algumas
situações podemos ter a necessidade de criar nossas próprias funções.
São as chamadas User-Defined Functions, ou UDF.
Sintaxe
FUNCTION function-name [ RETURNS ] return-type

[ ( parameter [ , parameter ] ... ) ]
{ FORWARD
| [ MAP [ TO ] actual-name ] IN proc-handle
| IN SUPER
} .
Exemplo
FUNCTION duplicarValor RETURNS INTEGER (INPUT parm1 AS INTEGER):

RETURN (2 * parm1).
END FUNCTION.
FUNCTION retornarNome RETURNS CHARACTER ():

RETURN "Jaison Antoniazzi".
END.
MESSAGE retornarNome()
VIEW-AS ALERT-BOX.
Exemplo de Função em Programa Persistente
DEFINE VARIABLE hprogramaZ AS HANDLE NO-UNDO.
FUNCTION somar RETURNS DECIMAL ( INPUT valor1 AS DECIMAL,

INPUT valor2 AS DECIMAL) IN hprogramaZ.
RUN prog-persist-B-02-z.p
PERSISTENT
SET hprogramaZ.
DEFINE VARIABLE val1 AS DECIMAL NO-UNDO.

DEFINE VARIABLE val2 AS DECIMAL NO-UNDO.
DEFINE VARIABLE soma AS DECIMAL NO-UNDO.
UPDATE val1 val2.
soma = somar( val1, val2 ).
DISPLAY soma.
*A Função SOMAR está no programa prog-persist-b-02-z.p
Conteúdo do programa prog-persist-b-02-z.p
145
(18) 99747-8189

INPUT valor2 AS DECIMAL) FORWARD.
PROCEDURE dividir:
DEFINE VARIABLE valor1 AS DECIMAL NO-UNDO.
UPDATE valor1 valor2.
DISPLAY valor1 / valor2 LABEL 'Divisao'.
END.
PROCEDURE subtrair:
DISPLAY valor1 - valor2 LABEL 'Subtrair'.
END.
PROCEDURE calcularMedia:
UPDATE valor1 valor2 valor3 valor4.
DISPLAY (valor1 + valor2 + valor3 + valor4) / 4

LABEL 'Media'.
END.
PROCEDURE divisivelpor2:
UPDATE valor1.
DISPLAY valor1 MODULO 2 = 0

LABEL 'Divisivel por 2?'
FORMAT 'É divisivel por 2/Nao sou divisivel!'.
END.
PROCEDURE listarClientes:
DEFINE VARIABLE valor1 LIKE customer.custnum
LABEL 'Semifinal PQP'
NO-UNDO.
LABEL 'Final'
NO-UNDO.
146
(18) 99747-8189
WHERE customer.custnum >= valor1

AND customer.custnum <= valor2:
DISPLAY customer.custnum customer.NAME customer.address

WITH
THREE-D
TITLE 'Listagem de clientes'.
END.
END.

INPUT valor2 AS DECIMAL):
RETURN valor1 + valor2.
END.
Anotações
Programas e Funções Persistentes

São programas executados que ficam em memória, permitindo o uso de seus procedimentos e funções
internas que não são privados.
Sintaxe Run
RUN
{ extern-proc-name
| VALUE ( extern-expression )
| path-name<<member-name>>
}
[ PERSISTENT [ SET proc-handle ] ]
[ ON [ SERVER ] { server-handle | session-handle }
[ TRANSACTION DISTINCT ]
[ ASYNCHRONOUS
[ SET async-request-handle ]
[ EVENT-PROCEDURE event-internal-procedure
[ IN procedure-context ] ]
]
]
[ ( parameter [ , parameter ] ... ) ]
[ argument ] ...
[ NO-ERROR ]
As cinco regras dos programas persistentes

1. Declarar uma variável do tipo Handle (ponteiro de memória).
2. Executar um programa e armazenar o endereço de memória na variável Handle.
3. Testar se o programa ainda está em memória.
147
(18) 99747-8189
4. Executar os métodos ou procedimentos internos deste programa.

5. Remover o programa da memória.
Exemplo
Regra Programa
1 DEFINE VARIABLE hPrograma AS HANDLE NO-UNDO.
2 RUN meuprograma PERSISTENT SET hPrograma.
3 IF VALID-HANDLE(hPrograma) THEN
4 RUN metododentrodoPrograma1 IN hPrograma.
4 RUN metododentrodoPrograma2 IN hPrograma (INPUT 123).
4 RUN metododentrodoPrograma3 IN hPrograma (INPUT "Ola
mundo").
3
IF VALID-HANDLE(hPrograma) THEN
4
RUN metododentrodoPrograma4 IN hPrograma.
3
IF VALID-HANDLE(hPrograma) THEN
5
DELETE OBJECT hPrograma.
Para visualizar os procedimentos internos disponíveis em um programa persistente utilize a função Internal-
Entries.
Sintaxe
MESSAGE hPrograma:INTERNAL-ENTRIES
Procedimentos internos privados (Private) não poderão ser executados quando o programa estiver
persistente, pois não serão visíveis externamente.
Exemplo de programa persistente
DEFINE VARIABLE hprogramaB AS HANDLE NO-UNDO.
RUN prog-persist-b-01.p
PERSISTENT
SET hprogramaB.
RUN somar
IN hprogramaB.
148
(18) 99747-8189
RUN multiplicar
IN hprogramaB.
DELETE OBJECT hprogramaB.
Conteúdo do programa prog-persist-b-01.p
MESSAGE 'iniciou do programa B'

PROCEDURE somar:

REPEAT:
DISPLAY valor1 + valor2 LABEL 'Soma'.
END.
END.
PROCEDURE multiplicar:

REPEAT:
DISPLAY valor1 * valor2 LABEL 'Produto'.
END.
END.
MESSAGE 'fim do programa b'

Exemplo de programa persistente com leitura de clients
DEFINE VARIABLE hprogramaNinja

AS HANDLE NO-UNDO.
RUN prog-persist-B-02.p
PERSISTENT
SET hprogramaNinja.
RUN subtrair
IN hprogramaninja.
RUN dividir
IN hprogramaninja.
149
(18) 99747-8189
RUN listarClientes
IN hprogramaninja.
DELETE OBJECT hprogramaninja.

Conteúdo do programa prog-persist-b-02.p
PROCEDURE dividir:
DISPLAY valor1 / valor2 LABEL 'Divisao'.
END.
PROCEDURE subtrair:
DISPLAY valor1 - valor2 LABEL 'Subtrair'.
END.
PROCEDURE calcularMedia:
UPDATE valor1 valor2 valor3 valor4.
DISPLAY (valor1 + valor2 + valor3 + valor4) / 4

LABEL 'Media'.
END.
PROCEDURE divisivelpor2:
UPDATE valor1.
DISPLAY valor1 MODULO 2 = 0

LABEL 'Divisivel por 2?'
FORMAT 'É divisivel por 2/Nao sou divisivel!'.
END.
PROCEDURE listarClientes:
LABEL 'Semifinal PQP'
NO-UNDO.
LABEL 'Final'
NO-UNDO.
150
(18) 99747-8189

WHERE customer.custnum >= valor1
AND customer.custnum <= valor2:
DISPLAY customer.custnum customer.NAME customer.address

WITH
THREE-D
TITLE 'Listagem de clientes'.
END.
END.
Anotações
151
(18) 99747-8189
Exercício
Para a nomenclatura dos exercícios, utilize a máscara PROC_<número do exercício>.P (PROC_1.p,
PROC_2.p).
1. Criar programa que execute procedimento externo, este deverá mostrar a data de hoje (Instrutor).
2. Criar programa que execute procedimento interno, este deverá mostrar a hora corrente (Instrutor).
3. Criar programa que utilize uma função para retornar a data de hoje mais 30 dias.
4. Crie um programa com os métodos mostrarData e mostrarHora (PROC_41.P). Execute o programa
(PROC_41.P) persistente para mostrar os procedimentos internos (internal-entries).
5. Execute o programa PROC_41.P persistente e execute os métodos mostrarData e mostrarHora.
Utilize as funções Date e Time.
6. Criar programa com procedimento interno e que neste procedimento exiba o seu nome completo.
7. Utilize o sexto exercício, agora utilize um procedimento externo para exibir o nome completo.
8. Construa um programa com dois procedimentos internos, leia a opção para executar o
procedimento 1 ou 2, utilizando IF THEN e ELSE execute o primeiro procedimento ou segundo.
9. Construa uma função que receberá o seu nome e sobrenome como parâmetros e retornará o seu
nome completo.
10. Construa uma função que receberá um valor decimal como parâmetro e retornará 13,85% do valor
passado.
11. Usando o nono exercício, mas agora construa na forma de programa persistente sendo chamado
pelo programa principal.
12. Usando o décimo exercício, mas agora construa na forma de programa persistente sendo chamado
pelo programa principal.
13. Usando o décimo primeiro exercício, mas agora construa na forma de programa persistente sendo
chamado pelo programa principal.
152
(18) 99747-8189
Blocos de instruções e Transações

Blocos de instruções são segmentos lógicos de várias instruções iniciados com:
• Repeat,
• For,
• Programas ( na linha 0 ),
• Procedures Internas,
• Funções,
• Códigos de gatilhos,
• Do.
Transações são operações que serão executadas como uma unidade ou ACID (Atomicidade, Consistência,
Isolamento e Durabilidade), o escopo de transações está diretamente associado ao escopo de bloco que
pode ser desfeito, como Repeat, For, Programas e Procedures, Códigos de gatilhos, o bloco DO também cria
um bloco, mas por não ter características de um bloco que pode ser desfeito acaba propagando a transação,
se existir, para o bloco que contém o DO.
Para saber o número de blocos que um programa Progress ABL tem basta contar o número de “:” e adicionar
mais um pelo bloco automático criado no programa.
Comumente, na linguagem ABL, uma transação se inicia no começo do bloco (Repeat, For e Procedure,
Função) e termina no END deste.
Tipo do Bloco Cria bloco Mantêm a Transação?

Repeat Sim Sim
Procedure e Programa Sim Sim
For Sim Sim
Function Sim Sim
Do Sim Não
Código de gatilhos Sim Sim
Pode-se utilizar a função Transaction para verificar se há transação ativa ou através da compilação do
programa com a opção de LISTING.
Sintaxe função Transaction
TRANSACTION
Não confundir Opção Transaction com a Função Transaction, enquanto a opção Transaction é usada no
cabeçalho de blocos como o DO, FOR e REPEAT, a função Transaction é usada para exibir se o bloco está em
transação ou não.
Desfazendo a transação
A instrução undo informa à ABL para desfazer um bloco de transação. Também não se pode confundir a
instrução de UNDO com a opção UNDO dos cabeçalhos dos blocos DO, REPEAT e FOR.
Programando com Progress/ABL
Sintaxe da instrução UNDO
UNDO
[ label ]
[ , LEAVE [ label2 ]
| , NEXT [ label2 ]
| , RETRY [ label1 ]
| , RETURN [ return-value |
ERROR [ return-value | error-object-expression ] |
NO-APPLY ]
| , THROW error-object-expression
]
Exemplo de instrução Undo
MESSAGE "01 - Em transação?" TRANSACTION VIEW-AS ALERT-BOX.

dobloco:
DO TRANSACTION:
MESSAGE "02 - Em transacao?" TRANSACTION
CREATE customer.
ASSIGN
customer.custnum = NEXT-VALUE(NextCustNum).
ASSIGN
customer.NAME = "<SEU NOME>"
customer.salesrep = "BBB".
/* desfazendo o bloco Do Transaction com a instrucao UNDO */
UNDO dobloco, LEAVE dobloco.
END.
DISPLAY "Terminou".
Anotações
Opção Undo
A opção UNDO utiliza-se no cabeçalho de uma das instruções DO, FOR e REPEAT para desfazer uma
transação em um bloco e para informar o que fazer a seguir quando ocorrer algum erro não esperado com
as opções ON ERROR, ON ENDKEY, ON STOP e ON QUIT.
Exemplo com opção Undo e Leave
DO TRANSACTION
ON ERROR UNDO, LEAVE:
CREATE customer.
ASSIGN
154
UPDATE
customer.NAME
customer.salesrep.
/* forçando um erro no bloco */

INT('A').
RELEASE customer.
END.
DISPLAY "terminou".
Exemplo de opção Undo e Retry
DO TRANSACTION
ON ERROR UNDO, RETRY:
CREATE customer.
ASSIGN
UPDATE
customer.NAME
customer.salesrep.

INT('A').
RELEASE customer.
END.
DISPLAY "terminou".
Importante: Não confunda a instrução Undo no corpo de um programa com a opção Undo usada no
cabeçalho Do, For e Repeat.
Anotações
Início e término de uma Transação

O início e término de uma transação está ligada ao início e término de um bloco.
A linguagem ABL por padrão inicia um bloco na linha 0 (zero) de todos os programas.
Uma regra simples para determinar onde se inicia um bloco é observar onde há “:”, com exceção dos rótulos
dos blocos.
Então, um bloco se inicia com a instrução Do, For, Repeat, Procedure, Function, procedure em ABL pode ser
tanto um programa ou uma procedure interna.
O término de um bloco está no END de um Do, For, Repeat, Procedure ou no final de um programa.
Vejamos o código:
155
DO TRANSACTION
ON ERROR UNDO, RETRY:
CREATE customer.
ASSIGN
UPDATE
customer.NAME
customer.salesrep.

INT('A').
RELEASE customer.
END.
DISPLAY "terminou".
Seguindo a regra do dois pontos “:” o bloco se inicia na instrução “DO TRANSACTION ON ERROR UNDO,
RETRY:” e se encerra com o END deste DO TRANSACTION. Todo o código que está entre o “:” do DO
TRANSACTION e o END deste, faz parte da transação.
Mas há uma forma mais simples de constatar.
Compile o programa com a opção Listing. Você pode realizar esta compilação com a Ferramenta de
Compilação da Progress ou, ou através da instrução Compile.
Application Compiler
156
Janela Compiler Options
Ao realizarmos a compilação do nosso código, será gerado um arquivo com este formato:
...mp\progdotrans1.p 10/28/2013 22:51:57 PROGRESS(R)

Page 1
Coluna BLK
{} Line Blk
-- ---- ---
1 dobloco:
2 1 DO TRANSACTION:
3 1
4 1 MESSAGE TRANSACTION
5 1 VIEW-AS ALERT-BOX INFO BUTTONS OK.
6 1
7 1 CREATE customer.
8 1 ASSIGN customer.custnum = NEXT-VALUE(NextCustNum).
9 1
10 1 DISPLAY customer.custnum.
11 1 ASSIGN
12 1 customer.NAME = "<SEU NOME>"
13 1 customer.salesrep = "BBB".
14 1
15 1 /* desfazendo o bloco do transaction */
16 1 UNDO dobloco, LEAVE dobloco.
17 1
18 END.
157
19
20 DISPLAY "Terminou".
Page 2
Rodapé do arquivo Listing
File Name Line Blk. Type Tran Blk. Label

-------------------- ---- ----------- ---- -------------------------------
...mp\progdotrans1.p 0 Procedure No
Buffers: sports4000.Customer
Frames: Unnamed
...mp\progdotrans1.p 2 Do Yes dobloco
Neste momento, as partes mais importantes são a coluna BLK que mostra os blocos existentes no programa
e o rodapé que mostra onde está a transação, o nome do bloco e a linha que se inicia.
Vamos para o segundo exemplo
DEFINE VARIABLE inteiro AS INTEGER.
dobloco:
DO TRANSACTION:
RUN minhaProcedure.
END.
DISPLAY "Terminou".
PROCEDURE minhaProcedure:
CREATE customer.
ASSIGN
ASSIGN
customer.NAME = "<SEU NOME>"
customer.salesrep = "BBB".
END.
A compilação deste código gerará o arquivo a seguir.

Page 1
{} Line Blk
-- ---- ---
1 DEF VAR inteiro AS INTEGER.
2
3 dobloco:
4 1 DO TRANSACTION:
5 1
158
6 1 RUN minhaProcedure.
7 1
8 END.
9
11
12
13 PROCEDURE minhaProcedure:
14 CREATE customer.
15 ASSIGN customer.custnum = NEXT-VALUE(NextCustNum).
16
17 DISPLAY customer.custnum.
18 ASSIGN
19 customer.NAME = "<SEU NOME>"
20 customer.salesrep = "BBB".
21 END.
Page 2

-------------------- ---- ----------- ---- -------------------------------
1 ...mp\progdotrans2.p 13 Procedure Yes Procedure minhaProcedure
Frames: Unnamed
2 ...mp\progdotrans2.p 0 Procedure No
Frames: Unnamed
3 ...mp\progdotrans2.p 4 Do Yes dobloco
Deve ficar claro que temos três blocos:
1. A procedure que cria um novo bloco, se inicia na linha 13, subtransação do bloco DO TRANSACTION,
e é identificada pelo Blk. Label “Procedure minhaProcedure”.
2. O código principal, que se inicia na linha 0 e identificado no Blk. Type por Procedure.
3. E o bloco do DO TRANSACTION, que inicia na linha 4, é identificado pelo Blk. Type por Do e tem Blk.
Label dobloco.
Outro ponto importante que deve ser analisado é se as subtransações farão parte da transação principal ou
se elas são tratadas independente, como foi exibido nos exemplos acima.
Se a subtransação, contida na procedure, fizer parte da transação do DO TRANSACTION e esta transação

deverá ser tratada integralmente, ao ocorrer algum erro na procedure, esta deverá retornar indicando que
um erro ocorreu e toda a transação deve ser cancelada.
159
Veja o código abaixo.

repeatbloco:
REPEAT TRANSACTION:
RUN minhaProcedure.
IF RETURN-VALUE = "Erro" THEN
UNDO, LEAVE.
END.
DISPLAY "Terminou".
/* aqui começa o bloco da procedure minhaProcedure */
dobloco:
DO ON ERROR UNDO, RETURN "Erro":
CREATE customer.
ASSIGN
UPDATE
customer.NAME
customer.salesrep.
/* gerando o erro */
INT('A').
END.
/* aqui ainda é o bloco da procedure minhaProcedure */

END.

Page 1
{} Line Blk
-- ---- ---
2
3 repeatbloco:
4 1 REPEAT TRANSACTION:
5 1
7 1 IF RETURN-VALUE = "Erro" THEN
8 1 UNDO, LEAVE.
9 1
10 END.
11
13
160
15 /* aqui come‡a o bloco da procedure minhaProcedure */

16
17 dobloco:
18 1 DO ON ERROR UNDO, RETURN "Erro":
21 1
23 1 UPDATE
24 1 customer.NAME
25 1 customer.salesrep.
26 1 /* gerando o erro */
27 1 INT('A').
28 END.
29
30 /* aqui ainda ‚ o bloco da procedure minhaProcedure */
31 END.
Page 2

-------------------- ---- ----------- ---- ------------------------------
-
...mp\progdotrans3.p 14 Procedure No Procedure minhaProcedure
Frames: Unnamed

Frames: Unnamed
...mp\progdotrans3.p 4 Repeat Yes repeatbloco
No código acima marcamos os blocos de Repeat, DO, seus respectivos END e o rodapé do Listing. Note que
a procedure está contida entre as linhas 14 e 31, mas não existe transação nesta, somente dentro do bloco
DO ON ERROR. Observe também que na linha 27 estamos forçando um erro para que o DO ON ERROR
retorne ao REPEAT a informação “ERRO”, no Repeat, na linha 7, é tratado o retorno da procedure
minhaProcedure, como sempre ocorrerá erro, a instrução UNDO desfará a transação ativa e a opção LEAVE
sairá deste bloco.
Exemplo onde há a criação de um bloco interno
repeatbloco:
REPEAT TRANSACTION:
161
RUN minhaProcedure.
IF RETURN-VALUE = "Erro" THEN
UNDO, LEAVE.
END.
DISPLAY "Terminou".
/* aqui começa o bloco da procedure minhaProcedure */
dobloco:
DO ON ERROR UNDO, RETURN "Erro":
CREATE customer.
ASSIGN
UPDATE
customer.NAME
customer.salesrep.
dobloco2:
DO ON ERROR UNDO dobloco2, LEAVE dobloco2:
CREATE order.
ASSIGN
order.custnum = customer.custnum.
UPDATE
order.ordernum
order.orderdate.
END.
/* gerando o erro */
INT('A').
END.
/* aqui ainda é o bloco da procedure minhaProcedure */

END.
A compilação deste com Listing gerará

Page 1
{} Line Blk
-- ---- ---
2
3 repeatbloco:
4 1 REPEAT TRANSACTION:
5 1
162
7 1 IF RETURN-VALUE = "Erro" THEN

8 1 UNDO, LEAVE.
9 1
10 END.
11
13
15 /* aqui come‡a o bloco da procedure minhaProcedure */
16
17 dobloco:
18 1 DO ON ERROR UNDO, RETURN "Erro":
21 1
23 1 UPDATE
24 1 customer.NAME
25 1 customer.salesrep.
26 1
27 1 dobloco2:
28 2 DO ON ERROR UNDO dobloco2, LEAVE dobloco2:
29 2
30 2 CREATE order.
31 2 ASSIGN order.custnum = customer.custnum.
32 2 UPDATE
33 2 order.ordernum
34 2 order.orderdate.
35 2
36 1 END.
37 1
38 1 /* gerando o erro */
39 1 INT('A').
40 END.
41
42 /* aqui ainda ‚ o bloco da procedure minhaProcedure */
43 END.
Page 2

-------------------- ---- ----------- ---- -------------------------------
-
163
...mp\progdotrans4.p 14 Procedure No Procedure minhaProcedure

Frames: Unnamed

...mp\progdotrans4.p 28 Do Yes dobloco2
Buffers: sports4000.Order
sports4000.Customer
Frames: Unnamed
...mp\progdotrans4.p 4 Repeat Yes repeatbloco
Criamos um novo bloco interno ao bloco dobloco e o chamamos de dobloco2. Veja que o arquivo Listing
apontou este novo bloco.
164
Exercício
Para a nomenclatura dos exercícios, utilize a máscara BTRANS_<número do exercício>.P (BTRANS_1.p,
BTRANS_2.p).
1. Nomeando os blocos, crie um laço de 1 até 20 com Do, crie um sub bloco de 5 até 10 e utilize Do.
Exibindo os valores, adicione o código integer(“A”) após o Display do sub bloco Do (gerará um erro).
O que ocorreu? Por quê?
2. Nomeando os blocos, crie um laço de 1 até 20 com Do, crie um sub bloco de 5 até 10 e utilize
Repeat. Exibindo os valores, adicione o código integer(“A”) após o Display do sub bloco Repeat
(gerará um erro). O que ocorreu? Por quê?
3. Nomeando os blocos, crie um laço de 1 até 20 com Do, crie um sub bloco de 5 até 10 e utilize Do.
Exibindo os valores, adicione o código integer(“A”) após o Display do sub bloco Do (gerará um erro).
Adicione o tratamento On Error, On Endkey, On Quit e On Stop. O que ocorreu? Por quê?
4. Nomeando os blocos, crie um laço de 1 até 20 com Do, crie um sub bloco de 5 até 10 e utilize
Repeat. Exibindo os valores, adicione o código integer(“A”) após o Display do sub bloco Repeat
(gerará um erro). Adicione o tratamento On Error, On Endkey, On Quit e On Stop. O que ocorreu?
Por quê?
5. Crie um programa que adicione 3 registros na tabela customer, utilize Do Transaction.
6. Crie um programa que adicione 3 registros na tabela customer, utilize Do Transaction. E ao final
desfaça o cadastramento destes 3 registros.
7. Crie um programa de 1 até 10, exibindo cada valor, se o valor for 5 saia do bloco (Utilize If e Leave).
8. Crie um novo programa com um laço Repeat,
a. Neste laço de Repeat faça a criação de registros da tabela Customer e leia os valores dos
campos Customer.Name, Customer.Address e Customer.Salesrep com a instrução Update,
b. A cada interação pergunte se deseja salvar ou desfazer,
c. Utilize Undo e Leave.
9. Crie um novo programa a partir do quarto exercício e substitua por Undo e Next.
10. Crie um novo programa com base no quarto exercício, substitua por Undo e Retry.
11. Crie um novo programa com base no quarto exercício, utilize Procedure, Undo, Leave e teste o
return-value. Este ficará semelhante aos exemplos acima.
165
(18) 99747-8189
Laços de repetição
São as repetições de códigos, podendo ter transação, tratamento de erro e escopo de frame.
Na linguagem ABL temos os laços de repetição para Do, Repeat e For.
Instrução Do Instrução Repeat Instrução For

Escopo de frame Sim Sim Sim
Transação implícita Não Sim Sim
Interação Não Sim Sim
Leitura de registro Não Não Sim
Escopo forte de Sim Sim Nao
registro
Tratamento implícito Não Sim Sim
de erro
Instrução Do
A instrução Do precisa ser acrescida de condições lógicas para ser laço de repetição, por este motivo foi
associada neste capítulo.
Sintaxe Do
[ label : ]
DO
{ [ FOR record [ , record ] ... ] }
[ preselect-phrase ]
[ TRANSACTION ]
[ on-error-phrase ]
[ on-quit-phrase ]
[ on-stop-phrase ]
{ [ frame-phrase ] } :
do-body
Exemplo
DEFINE VARIABLE icont AS INTEGER NO-UNDO.
DO icont = 1 TO 10 WITH FRAME f1:

DISPLAY icont.
END.
Anotações
166
(18) 99747-8189
Instrução Repeat
Permite um laço de repetição.
Sintaxe Repeat
[ label : ]
REPEAT
[ FOR record [ , record ] ... ]
[ preselect-phrase ]
[ TRANSACTION ]
[ on-error-phrase ]
[ on-quit-phrase ]
[ on-stop-phrase ]
[ frame-phrase ]
[ catch-block [ catch-block ... ] ]
[ finally-block ] :
repeat-body
Exemplo
DEFINE VARIABLE icont AS INTEGER NO-UNDO.
REPEAT icont = 1 TO 10:

DISPLAY icont.
END.
Anotações
Instrução For
Sintaxe For
[ label: ]
FOR [ EACH | FIRST | LAST ] record-phrase
[ , [ EACH | FIRST | LAST ] record-phrase ] ...
[ BREAK ]
] ...
167
(18) 99747-8189
[ TRANSACTION ]
[ on-error-phrase ]
[ on-quit-phrase ]
[ on-stop-phrase ]
[ frame-phrase ] :
for-body
Vários exemplos de For Each

/*exibindo o campo Name da tabela Customer*/

DISPLAY
Customer.Name.
END.
/*neste exemplo TODOS os campos da tabela Customer */
/*serão trazidos do banco de dados para a estação, */
/*mas somente o campo Name está sendo exibido na instrução DISPLAY*/
/*assim como no exemplo anterior, */

/*todos os campos da tabela Customer serão trazidos do banco de dados
para a estação.*/

DISPLAY
Customer.CustNum
Customer.Name.
END.
/*trazer da tabela Customer somente os clientes com Custnum maior

igual a 5,
exibindo os campos Custnum e Name*/
FOR EACH customer

NO-LOCK
WHERE customer.custnum >= 5:
DISPLAY
Customer.CustNum
Customer.Name.
END.
/*trazer os clientes com codigo maior igual a 5 e menor igual a 50,

exibindo o codigo, nome e endereco */
FOR EACH Customer

NO-LOCK
WHERE Customer.CustNum >= 5
AND Customer.CustNum <= 50:
DISPLAY
Customer.CustNum
Customer.Name
Customer.Address.
168
(18) 99747-8189
END.

exibindo o codigo, nome e endereco
importante: com uso da opcao FIELDS somente os campos Custnum Name e

Address virao do banco de dados*/
FOR EACH Customer

FIELDS( Customer.CustNum
Customer.Name
Customer.Address )
NO-LOCK
DISPLAY
Customer.CustNum
Customer.Name
Customer.Address.
END.

exibindo o codigo, nome e endereco
com uso da opcao FIELDS somente os campos Custnum Name e Address
virao do banco de dados
importante: o campo Customer.Phone nao esta na opcao FIELDS,

ao executar a opcao DISPLAY será exibido ERRO 8826
Field Phone from Customer record (recid 101) was missing from FIELDS
phrase. (8826)
Campo Phone da tabela Customer não foi informado na opção FIELDS.

(8826)
*/
FOR EACH Customer

FIELDS( Customer.CustNum
Customer.Name
Customer.Address )
NO-LOCK
DISPLAY
Customer.CustNum
Customer.Name
Customer.Address
Customer.Phone.
END.
/*Exibir o codigo do cliente e o nome, assim como todos os pedidos

deste cliente*/
/*Importante: note o uso da opcao OF */
FOR EACH Customer
169
(18) 99747-8189

DISPLAY
Customer.CustNum
Customer.Name.
FOR EACH order OF customer

NO-LOCK:
DISPLAY Order.Ordernum Order.OrderDate Order.SalesRep.
END.
END.
/*Exibir o codigo do cliente e o nome, assim como todos os pedidos

deste cliente*/
/*Importante: note o uso da opcao WHERE */
FOR EACH Customer

DISPLAY
Customer.CustNum
Customer.Name.
FOR EACH order

NO-LOCK
DISPLAY Order.Ordernum Order.OrderDate Order.SalesRep.
END.
END.
Anotações
Nomeando laços de repetição

A nomeação de blocos de instruções nos permite desfazer sub transações, sair ou ir para a próxima iteração
de blocos aninhados.
Nomeie o bloco antes do cabeçalho do Repeat, For ou Do e adicione dois pontos “:”.
Exemplo
/*Repeat com nome REPEAT-BLOCK*/
DEFINE VARIABLE continuar AS LOGICAL NO-UNDO.
repeat-block:
REPEAT:
UPDATE continuar.
IF NOT continuar THEN
UNDO repeat-block, LEAVE repeat-block.
170
(18) 99747-8189
END.
DISPLAY "terminou".
Exemplo com dois blocos nomeados de Repeat

DEFINE VARIABLE perguntar AS LOGICAL NO-UNDO
FORMAT "Bloco2(Sair)/Repeat".
repeat-block:
REPEAT:
UPDATE continuar.
bloco2:
REPEAT:
UPDATE perguntar.
IF NOT perguntar THEN
ELSE
UNDO bloco2, LEAVE bloco2.
END.
END.
DISPLAY "terminou".
Exemplo com dois blocos de instruções nomeados de Repeat e uso do Retry

DEFINE VARIABLE perguntar AS LOGICAL NO-UNDO
FORMAT "Bloco2(Retry)/Repeat(Sair)".
repeat-block:
REPEAT:
UPDATE continuar.
bloco2:
REPEAT:
IF RETRY THEN
DISPLAY "tentando novamente".
UPDATE perguntar.
IF NOT perguntar THEN
ELSE
UNDO bloco2, RETRY bloco2.
END.
END.
DISPLAY "terminou".
171
(18) 99747-8189
172
(18) 99747-8189
Exercício
Para a nomenclatura dos exercícios, utilize a máscara DO_REP_<número do exercício>.P (DO_REP_1.p,
DO_REP_2.p).
1. Crie um laço de 1 até 20 exibindo os valores, utilize Do.

2. Crie um laço de 1 até 20 exibindo os valores, utilize Repeat.
3. Crie um laço de 1 até 20 exibindo os valores, se o valor for 15, sair do Bloco, utilize Do.
4. Crie um laço de 1 até 20 com Do, dentro deste DO crie um laço de repetição com o REPEAT de 5 até
10.
5. Nomeando os blocos de instruções, crie um laço de 1 até 20 com Do, dentro deste DO crie um laço
de repetição com o REPEAT de 5 até 10, se o valor for 7 sair do bloco de Repeat. Utilize DISPLAY para
exibir os valores em cada laço (DO e REPEAT).
6. Usando o exercício 5 nomeie os blocos e as instruções UNDO e LEAVE.
173
(18) 99747-8189
Tratamentos On Error, On Endkey, On Quit e On Stop

São os processos a serem executados nos casos de Erro (Error), Tecla de término (Endkey), de Parada
(instrução Stop e Ctrl-Break) instrução de encerramento (Quit).
Opção On Error
On Error deverá ser utilizado no caso de erros no bloco.
Sintaxe On Error
ON ERROR UNDO
[ label1 ]
| , NEXT [ label2 ]
NO-APPLY ]
| , THROW
]
Anotações
Exemplo de On Error, Retry
DEFINE VARIABLE codigo AS CHARACTER NO-UNDO.
/* PROCEDURE OU PROGRAMA
ON ERROR UNDO, RETRY */
UPDATE codigo.
DO ON ERROR UNDO, RETRY:
INT(codigo).
END.
Exemplo de On Error, Leave
DEFINE VARIABLE nome AS CHARACTER NO-UNDO.

/* bloco 1 */
MESSAGE 1
DO ON ERROR UNDO, LEAVE:

/* bloco 2 */
MESSAGE 2
174
(18) 99747-8189
UPDATE nome.
MESSAGE 3
INT('gerar erro').
MESSAGE 4
END.
/* bloco 1 */
MESSAGE 5
Exemplo de On Error, Next

/* bloco 1 */
MESSAGE 1
DO ON ERROR UNDO, NEXT:

/* bloco 2 */
MESSAGE 2
UPDATE nome.
MESSAGE 3
INT('gerar erro').
MESSAGE 4
END.
/* bloco 1 */
MESSAGE 5
Exemplo de On Error, Return

/* bloco 1 */
MESSAGE 1
DO ON ERROR UNDO, RETURN:

/* bloco 2 */
MESSAGE 2 SKIP 'TENTE OUTRA VEZ 1 ?' RETRY
175
(18) 99747-8189
UPDATE nome.
MESSAGE 3 SKIP 'TENTE OUTRA VEZ 2 ?' RETRY

INT('gerar erro').
MESSAGE 4
END.
/* bloco 1 */
MESSAGE 5
Opção On EndKey
On Endkey deverá ser utilizado no caso do usuário utilizar tecla de End-Error ou Endkey (Esc ou F4).
Sintaxe On Endkey
ON ENDKEY UNDO
[ label1 ]
| , NEXT [ label2 ]
NO-APPLY ]
Anotações
Exemplo de On Endkey, Leave
DEFINE VARIABLE CODIGO AS INTEGER NO-UNDO.
MESSAGE 1
/* ON ENDKEY UNDO, LEAVE É O TRATAMENTO PADRAO DO PROGRAMA */
DO ON ENDKEY UNDO, LEAVE:

MESSAGE 2
UPDATE CODIGO.
INT('A').
MESSAGE 3
END.
176
(18) 99747-8189
MESSAGE 4
/*
WELLINGTON
1 - OK
2 - OK
3 - NOK
4 - TALVEZ NAO
WILLIAN
1 - OK
2 - OK
3 - NOK
4 - TALVEZ NAO
MIRO
1 - OK
2 - OK
3 - OK
4 - NOK
*/
Exemplo de On Endkey, Leave e com On Error, Return
DEFINE VARIABLE CODIGO AS INTEGER NO-UNDO.
MESSAGE 1
/* ON ENDKEY UNDO, LEAVE É O TRATAMENTO PADRAO DO PROGRAMA */
DO ON ERROR UNDO, RETURN

ON ENDKEY UNDO, LEAVE:
MESSAGE 2
UPDATE CODIGO.
INT('A').
MESSAGE 3
END.
MESSAGE 4
/*
WELLINGTON
1 - OK
2 - OK
3 - NOK
4 - TALVEZ NAO
WILLIAN
1 - OK
2 - OK
3 - NOK
4 - TALVEZ NAO
177
(18) 99747-8189
MIRO
1 - OK
2 - OK
3 - OK
4 - NOK
*/
Opção On Stop
On Stop deverá ser utilizado para tratar condições de Stop (Falta de procedimentos ou programas).
Sintaxe On Stop
ON STOP UNDO
[ label1 ]
| , NEXT [ label2 ]
NO-APPLY ]
]
Anotações
Exemplo de On Stop, Leave
/* BLOCO 1 */
MESSAGE 1
DO ON STOP UNDO, LEAVE:

/* BLOCO 2 */
RUN NAO-EXISTE-PROGRAMA-NO-DISCO-OU-INTERNO.
END.
MESSAGE 2
/* BLOCO 1 */
Opção On Quit
On Quit deverá ser utilizado com instruções de Quit.
Sintaxe On Quit
ON QUIT
[ UNDO [ label1 ] ]
| , NEXT [ label2 ]
178
(18) 99747-8189
NO-APPLY ]
]
Anotações
Exemplo de On Quit
DEFINE VARIABLE NOME AS CHARACTER NO-UNDO.
DO ON QUIT UNDO, LEAVE:
MESSAGE 1
/* APERTAR CTRL-BREAK */
UPDATE NOME.
QUIT.
MESSAGE 2
END.
MESSAGE 3
179
(18) 99747-8189
Captura de erros
Os blocos de instruções Do, Repeat e For permitem a inserção de captura de erros através da instrução
Catch.
Bloco catch
É o bloco de instruções que será executado se a condição de captura for condizente com o erro.
block-statements
CATCH error-variable AS [ CLASS ]error-class:
catch-logic
END [ CATCH ] .
[block-end-statement]
Bloco de Finally
É o bloco de instruções que sempre será executado, independente de sucesso ou falha das instruções
anteriores.
block-statements
FINALLY :
finally-logic
END [ FINALLY ] .
[ block-end-statement ]
Exemplo de Catch com Repeat
REPEAT:
DISPLAY int("A").
CATCH oneError AS Progress.Lang.SysError:

MESSAGE
"Ocorreu um erro inesperado, por favor, contate o
suporte." SKIP
oneError:GetMessage(1)
VIEW-AS ALERT-BOX BUTTONS OK.
END CATCH.
END.
Exemplo de Catch com DO
/*uso de CATCH em um bloco DO */

/*Importante: neste exemplo é obrigatório o uso de ON ERROR UNDO,
pois o bloco DO Nao Desfaz como o REPEAT ou FOR desfaz */
DISPLAY int("A").
CATCH oneError AS Progress.Lang.SysError:
180
(18) 99747-8189
MESSAGE
"Ocorreu um erro inesperado, por favor, contate o
suporte." SKIP
oneError:GetMessage(1)
VIEW-AS ALERT-BOX BUTTONS OK.
END CATCH.
END.
O bloco Do não possui tratamento implícito de erro, é obrigatória a inserção de tratamento On Error Undo,
evitando a mensagem CATCH block may only be associated with an undoable block. (14140).
A variável oneError é um objeto único no bloco e não precisa ser declarado.
Exemplo de Catch para AppError e SysError
INT('gerar erro').
CATCH erroprograma AS Progress.Lang.AppError:
MESSAGE 'erro do programa'

erroprograma:getmessage(1)
END.
CATCH errosistema AS Progress.Lang.SysError:
IF errosistema:getmessagenum(1) = 76 THEN
MESSAGE 'ocorreu erro de conversao!'
ELSE
MESSAGE
'num mensagens=' errosistema:nummessages SKIP

'callstack= ' errosistema:CallStack SKIP
'severidade= ' errosistema:Severity SKIP
'mensagem= ' errosistema:getmessage(1) SKIP
'num mensagem= ' errosistema:getmessagenum(1)
END.
END.
Exemplo de Catch em For Each
FOR EACH customer

WHERE customer.NAME BEGINS 'M':
DISPLAY
customer.NAME
customer.custnum
WITH 1 COL FRAME clientes TITLE 'Cliente'.
FOR EACH order
181
(18) 99747-8189
DISPLAY
order.ordernum
order.orderdate
order.custnum
WITH DOWN FRAME pedidos TITLE 'Pedidos'.
DOWN WITH FRAME pedidos.
FOR EACH orderline

WHERE orderline.ordernum = order.ordernum:
DISPLAY
orderline.linenum
orderline.itemnum
orderline.price
WITH
DOWN FRAME linhas TITLE 'linhas'
COL 40 ROW 5
WIDTH 40.
DOWN WITH FRAME linhas.
CATCH erro3 AS Progress.Lang.SysError:

MESSAGE erro3:getmessage(1)
END.
END.

END.
END.

END.
END.
Exemplo de Catch em Find
DEFINE VARIABLE codigo LIKE customer.custnum NO-UNDO

LABEL 'Codigo'.
REPEAT :
UPDATE codigo.

WHERE customer.custnum = codigo .
DO:
INT('A').
DISPLAY customer
182
(18) 99747-8189
EXCEPT customer.custnum customer.comments

WITH 1 COLUMN.
END.
ELSE
MESSAGE 'registro do cliente ' codigo ' nao existe.'
CATCH erroRepeat AS Progress.Lang.SysError:

IF erroRepeat:getmessagenum(1) = 565 THEN
DO:
MESSAGE 'Nao existe cliente com o codigo ' codigo
END.
ELSE
MESSAGE
'Ocorreu erro inesperado!' SKIP
erroRepeat:getmessage(1)
END.
END.
Exemplo de Catch em Programa
DEFINE VARIABLE valor1 AS INTEGER NO-UNDO.

IF valor1 > valor2 THEN

UNDO, THROW NEW Progress.Lang.AppError("Valor 1 nao pode ser maior que
valor 2", 300).
INT('gerar erro').
CATCH ErroPrograma AS Progress.Lang.AppError:

MESSAGE 'eu gerei este erro' SKIP
END.
CATCH ErroSistema AS Progress.Lang.SysError:

MESSAGE 'este é um erro nao capturado e nao tratado' SKIP
errosistema:getmessage(1)
END.
Exemplo de Catch e Finally

183
(18) 99747-8189

valor 2", 300).
INT('gerar erro').
/* erro gerado pelo meu programa com a instrucao de throw */

END.

/* erro gerado por falha inesperada
ou forçada kkkk int('gerar erro') */

END.
FINALLY:
/* que sempre sera executado, independente de erro ou sucesso */
MESSAGE 'final do programa'

END.
Exemplo de Catch e Geração de Exceção


valor 2", 300).
RUN programa-que-nao-existe-no-propath.pjaisonmaluco.
/* gera uma condicao de STOP */
/* erro gerado pelo meu programa com a instrucao de throw */

END.

/*
erro gerado por falha inesperada
184
(18) 99747-8189
ou forçada kkkk int('gerar erro')

*/

END.
FINALLY:
/* que sempre sera executado, independente de erro ou sucesso */
MESSAGE 'final do programa'

END.
Anotações
185
(18) 99747-8189
Importação e exportação
São as instruções de importação e exportação que permite a linguagem importar ou exportar dados para o
disco em arquivos texto.
A linguagem ABL pode importar e exportar dados com grande facilidade.
Para manipularmos a saída dos dados utilizamos a instrução Output to.
Instrução Output
Sintaxe Output to
OUTPUT [ STREAM stream | STREAM-HANDLE handle ] TO

{ PRINTER [ printer-name ]
| opsys-file
| opsys-device
| TERMINAL
| VALUE ( expression )
| "CLIPBOARD"
}
[ LOB-DIR { constant | VALUE ( expression ) } ]
[ NUM-COPIES { constant | VALUE ( expression ) } ]
[ COLLATE ]
[ LANDSCAPE | PORTRAIT ]
[ APPEND ]
[ BINARY ]
[ ECHO | NO-ECHO ]
[ KEEP-MESSAGES ]
[ NO-MAP | MAP protermcap-entry ]
[ PAGED ]
[ PAGE-SIZE { constant | VALUE ( expression ) } ]
[ UNBUFFERED ]
[ NO-CONVERT
| { CONVERT
[ TARGET target-codepage ]
[ SOURCE source-codepage ]
}
]
Exemplo de Output para arquivo
OUTPUT TO c:\temp\customer.d.
FOR EACH customer:

EXPORT customer.
END.
OUTPUT CLOSE.
Exemplo de Output para impressora
/* ABRIR A IMPRESSORA */
OUTPUT TO PRINTER.
DISP customer.custnum
customer.NAME
customer.address.
186
(18) 99747-8189
END.
OUTPUT CLOSE.
/* FECHOU A IMPRESSORA */
Exemplo de Output para o terminal
OUTPUT TO TERMINAL.
DISP 'OLA MUNDO'.
OUTPUT CLOSE.
Exemplo de Output com value
OUTPUT TO VALUE('C:\treinamento\fev.2015\basico\OUTPUT_05.TXT').
DISP 'OLA MUNDO'.
OUTPUT CLOSE.
Exemplo de Output com value e variável
DEFINE VARIABLE ARQUIVO AS CHARACTER

INITIAL 'C:\treinamento\fev.2015\basico\OUTPUT_05.TXT'
NO-UNDO.
OUTPUT TO VALUE( ARQUIVO ).
DISP 'OLA MUNDO'.
OUTPUT CLOSE.
Exemplo de Output para o clipboard*
OUTPUT TO 'CLIPBOARD'.
/* CUIDADO, POIS A AREA DE TRANSFERENCIA É LIMITADA */
FOR EACH SALESREP NO-LOCK:

DISP SALESREP.SALESREP
SALESREP.REPNAME WITH STREAM-IO.
END.
OUTPUT CLOSE.
/*
CTRL-V
Sales Rep Rep Name

--------- ------------------------------
BBB Brawn , Bubba B.
DKP Pitt , Dirk K.
DOS Donna Swindall
GPE Gilles Ehrer
HXM Harry Munvig
JAL Jan Loopsnel
KIK Kari Iso-Kauppinen
RDR Robert Roller
187
(18) 99747-8189
SLS Smith , Spike Louise
*/
*O Clipboard, ou área de transferência, é limitada e não abriga muita informação, então somente deve ser
usado para pouca transferir informação ou então a exportação ocorrerá incompleta.
Exemplo de Output com Stream*
DEF STREAM CLIENTE.

DEF STREAM REPRES.
OUTPUT
STREAM CLIENTE
TO C:\treinamento\fev.2015\basico\OUTPUT_07_CUSTOMER.TXT.
OUTPUT
STREAM REPRES
TO C:\treinamento\fev.2015\basico\OUTPUT_07A_SALESREP.TXT.
FOR EACH CUSTOMER NO-LOCK:
DISP
STREAM CLIENTE
CUSTOMER.CUSTNUM CUSTOMER.NAME
WITH STREAM-IO.
FOR EACH SALESREP OF CUSTOMER NO-LOCK:
DISP
STREAM REPRES
SALESREP.SALESREP SALESREP.REPNAME
WITH STREAM-IO.
END.
END.
OUTPUT
STREAM REPRES
CLOSE.
OUTPUT
STREAM CLIENTE
CLOSE.
*Stream é a direção do fluxo, ou destino da exportação, muito útil quando temos que exportar dados ao
mesmo tempo e para arquivos, impressoras diferentes, um exemplo comum seria ter que direcionar a
mesma informação para uma impressora e para o terminal no mesmo momento.
Exemplo de Output para três Streams
DEF STREAM A4.

DEF STREAM ARQUIVO.
DEF STREAM IMPRESSORA.
OUTPUT
STREAM A4
TO C:\treinamento\fev.2015\basico\OUTPUT_08_A4.TXT.
188
(18) 99747-8189
OUTPUT
STREAM ARQUIVO
TO C:\treinamento\fev.2015\basico\OUTPUT_08_ARQUIVO.TXT.
OUTPUT
STREAM IMPRESSORA
TO C:\treinamento\fev.2015\basico\OUTPUT_08_printer.TXT.
FOR EACH CUSTOMER NO-LOCK:
DISP
STREAM A4
CUSTOMER.CUSTNU CUSTOMER.NAME
WITH STREAM-IO
FRAME A4.
FOR EACH ORDER OF CUSTOMER NO-LOCK:
DISP
STREAM A4
ORDER.ORDERNUM
ORDER.ORDERDATE
WITH STREAM-IO
DOWN
FRAME A4-ORDERLINE.
DOWN WITH FRAME A4-ORDERLINE.
DISP
STREAM ARQUIVO
CUSTOMER.CUSTNUM
CUSTOMER.NAME
ORDER.ORDERNUM
ORDER.ORDERDATE
WITH STREAM-IO
DOWN
FRAME ARQUIVO.
FOR EACH ORDERLINE OF ORDER NO-LOCK:
DISP
STREAM IMPRESSORA
ORDER.ORDERNUM
ORDER.ORDERDATE
ORDER.CUSTNUM
CUSTOMER.NAME
ORDERLINE.LINENUM
ORDERLINE.ITEMNUM
ORDERLINE.QTY
ORDERLINE.PRICE
ORDERLINE.EXTENDEDPRICE
WITH STREAM-IO
WIDTH 333
DOWN
FRAME IMPRESSORA.
END.
END.
END.
189
(18) 99747-8189
OUTPUT
STREAM IMPRESSORA
CLOSE.
OUTPUT
STREAM ARQUIVO
CLOSE.
OUTPUT
STREAM A4
CLOSE.
Exemplo de Output para impressora
OUTPUT TO PRINTER
NUM-COPIES 2
LANDSCAPE
.
FOR EACH salesrep NO-LOCK:

DISP
salesrep.salesrep
salesrep.repname
salesrep.region
WITH STREAM-IO.
END.
OUTPUT CLOSE.
Instrução Put
Para escrever dados na saída de dados podemos utilizar as instruções Display, Export ou Put.
Sintaxe Put
PUT
[ STREAM stream | STREAM-HANDLE handle ]
[ UNFORMATTED ]
[ { expression
[ FORMAT string ]
[ { AT | TO } expression ]
}
| SKIP [ ( expression ) ]
| SPACE [ ( expression ) ]
] ...
Exemplo de Put
OUTPUT TO C:\treinamento\fev.2015\basico\OUTPUT_10A_put.txt.
PUT customer.custnum.
END.
OUTPUT CLOSE.
Exemplo de Put e opção Unformatted
190
(18) 99747-8189
OUTPUT TO C:\treinamento\fev.2015\basico\OUTPUT_10B_put.txt.
PUT
UNFORMATTED
customer.custnum SKIP
customer.NAME SKIP(2).
END.
OUTPUT CLOSE.
Exemplo de Put, com opção Unformatted e AT
OUTPUT TO C:\treinamento\fev.2015\basico\OUTPUT_10c_put.txt.
PUT
UNFORMATTED
customer.custnum AT 50 SPACE(5)
customer.NAME SKIP(2).
END.
OUTPUT CLOSE.
Exemplo de Put, com opção Unformatted e TO
OUTPUT TO C:\treinamento\fev.2015\basico\OUTPUT_10e_put.txt.
PUT
UNFORMATTED
customer.custnum AT 50 SPACE(5)
customer.NAME TO 60 SKIP(2).
END.
OUTPUT CLOSE.
Exemplo de Put e rótulo para colunas
OUTPUT TO C:\treinamento\fev.2015\basico\OUTPUT_10f_put.txt.
PUT
UNFORMATTED
'codigo=' customer.custnum AT 5
'nome=' AT 20 customer.NAME
SKIP.
END.
OUTPUT CLOSE.
Este programa exemplo produzirá arquivo semelhante a:
191
(18) 99747-8189
codigo= 000001 nome=JAISON

codigo= 000002 nome=Urpon Frisbee22222222
codigo= 000003 nome=Hoops3333333333333333
codigo= 000004 nome=Go Fishing LtdA4444444444
codigo= 000005 nome=Match Point TenniS5555555555
codigo= 000006 nome=Fanatical Athletes
codigo= 000007 nome=Aerobics valine Ky
codigo= 000008 nome=Game Set Match
codigo= 000009 nome=Pihtiputaan Pyora
codigo= 000010 nome=NAO SALVAR
codigo= 000011 nome=Keilailu ja Biljardi
codigo= 000012 nome=Surf Lautaveikkoset
codigo= 000013 nome=Biljardi ja tennis
codigo= 000014 nome=Paris St Germain
codigo= 000015 nome=Hoopla Basketball
codigo= 000016 nome=Thundering Surf Inc.
codigo= 000017 nome=High Tide Sailing
codigo= 000018 nome=Antin Metsastysase
codigo= 000019 nome=Buffalo Shuffleboard
codigo= 000021 nome=Pedal Power Cycles
codigo= 000022 nome=Kesport Katiska
codigo= 000024 nome=Jazz Futis Kauppa
Exemplo de PUT com Unformatted e delimitador
OUTPUT TO C:\treinamento\fev.2015\basico\OUTPUT_11B_export.TXT.
FOR EACH ITEM NO-LOCK:
PUT UNFORMATTED
Item.Itemnum ';'
Item.ItemName ';'
Item.Allocated ';'
Item.CatDescription ';'
Item.Category1 ';'
Item.Category2 ';'
Item.CatPage ';'
Item.Minqty ';'
Item.Onhand ';'
Item.OnOrder ';'
Item.Price ';'
Item.ReOrder ';'
Item.Special ';'
Item.Weight
SKIP
.
END.
OUTPUT CLOSE.
Este exemplo produzirá o arquivo
3;Golf Umbrella;10582;Keep your cool with this Progress gol

4;Cycle Helmet;10548;ANSI, ASCII, VHS, TCP/IP approved Cycl
5;Leotard - preto;9730;The sports unitard is one piece in c
6;Ski Poles;10107;Graphite ski poles. A great addition to y
7;Buoyancy Vest;10876;Stay afloat with your own helium buoy
192
(18) 99747-8189
8;Runner's Vest;10788;Whether it's a quick jog or a long ru

9;Swim Goggles;11500;Now where did I put those? These gogg
Exemplo de Put seguindo o CODEPAGE
OUTPUT TO C:\treinamento\fev.2015\basico\OUTPUT_12_CODEPAGE.TXT.
PUT
"Se Alex tem uma história rica no clube, Robinho ainda começa sua
trajetória com a camisa alviverde. Além de amigos que jogaram juntos no
Coritiba nos dois últimos anos que, os dois têm em comum na carreira no
clube um lindo gol marcado contra Rogério Ceni.".
OUTPUT CLOSE.
Exemplo de Put sem conversão de CODEPAGE*
OUTPUT TO C:\treinamento\fev.2015\basico\OUTPUT_12A_CODEPAGE.TXT
NO-CONVERT
.
PUT
OUTPUT CLOSE.
*Por termos CPSTREAM e CPINTERNAL distintos, todo Assign é convertido em memória, por este motivo o
uso de NO-CONVERT pode resolver alguns problemas incômodos de caracteres inválidos. Após executar
estes programas, abra os arquivos gerados no NOTEPAD e veja a diferença de usar o NO-CONVERT e
CONVERT.
Exemplo de Put com Convert Target
OUTPUT TO C:\treinamento\fev.2015\basico\OUTPUT_12B_CODEPAGE.TXT
CONVERT TARGET 'ISO8859-1'
.
PUT
OUTPUT CLOSE.
Instrução Export
Sintaxe Export
EXPORT [ STREAM stream | STREAM-HANDLE handle ] [ DELIMITER character ]

{ expression ...
| record [ EXCEPT field ... ]
}
[ NO-LOBS ]
193
(18) 99747-8189
Exemplo de Export
OUTPUT TO C:\treinamento\fev.2015\basico\OUTPUT_11_export.TXT.
EXPORT ITEM.
END.
OUTPUT CLOSE.
Este exemplo produzirá arquivo
3 "Golf Umbrella" 16,55 12906 10582 59 654 3 "Keep your c…

4 "Cycle Helmet" 75 12977 10548 41 546 4 "ANSI, ASCII…
5 "Leotard - preto" 19,95 12798 9730 30 631 5 "The sports…
6 "Ski Poles" 27,5 12730 10107 5 327 6 "Graphite…
7 "Buoyancy Vest" 125 12877 10876 15 479 7 "Stay…
8 "Runner's Vest" 19,85 13035 10788 19 427 30 "Whether…
Exemplo de Export com Delimiter “;”
OUTPUT TO C:\treinamento\fev.2015\basico\OUTPUT_11_export.TXT.
EXPORT
DELIMITER ';'
ITEM.
END.
OUTPUT CLOSE.
O exemplo produzirá arquivo semelhante à:
3;"Golf Umbrella";16,55;12906;10582;59;654;3;"Keep you

4;"Cycle Helmet";75;12977;10548;41;546;4;"ANSI, ASCII,
5;"Leotard - preto";19,95;12798;9730;30;631;5;"The spo
6;"Ski Poles";27,5;12730;10107;5;327;6;"Graphite ski p
7;"Buoyancy Vest";125;12877;10876;15;479;7;"Stay afloa
8;"Runner's Vest";19,85;13035;10788;19;427;30;"Whether
9;"Swim Goggles";18;13024;11500;4;275;9;"Now where did
10;"Duffel Bag 10";50;13001;10330;13;309;0;"'Powered
Instrução Display
Sintaxe Display
DISPLAY
[ { expression
[ format-phrase ]
[ ( aggregate-phrase ) ]
[ WHEN expression ]
[ @base-field ]
}
| [ SPACE [ ( n ) ] ]
194
(18) 99747-8189
| [ SKIP [ ( n ) ] ]
] ...
Anotações
Instrução Input
Para manipularmos a entrada de dados utilizamos a instrução Input from.
Sintaxe Input from
INPUT [ STREAM stream| STREAM-HANDLE handle ] FROM

{ opsys-file
| opsys-device
| TERMINAL
| VALUE ( expression )
| OS-DIR ( directory ) [ NO-ATTR-LIST ]
}
[ LOB-DIR { constant | VALUE ( expression ) } ]
[ BINARY ]
[ ECHO | NO-ECHO ]
[ MAP protermcap-entry | NO-MAP ]
[ UNBUFFERED ]
[ NO-CONVERT
| { CONVERT
[ TARGET target-codepage ]
[ SOURCE source-codepage ]
}
]
Para ler dados da entrada utilizamos a instrução Import.
Sintaxe
IMPORT [ STREAM stream | STREAM-HANDLE handle ]

{ [ DELIMITER character ] { field | ^ } ...
| [ DELIMITER character ] record [ EXCEPT field ... ]
| UNFORMATTED field
}
[ NO-LOBS ]
[ NO-ERROR ]
Exemplo simples
INPUT FROM c:\temp\customer.d.

REPEAT:
CREATE customer.
IMPORT customer.
END.
INPUT CLOSE.
Exemplo de Input
195
(18) 99747-8189
DEFINE VARIABLE codigoItem LIKE ITEM.itemnum NO-UNDO.

DEFINE VARIABLE nomeItem LIKE ITEM.itemname NO-UNDO.
DEFINE VARIABLE precoItem LIKE ITEM.price NO-UNDO.
INPUT FROM
'C:\treinamento\fev.2015\basico\OUTPUT_11_export.TXT'.
REPEAT:
IMPORT
codigoitem
nomeitem
precoitem.
MESSAGE
'codigoItem' codigoItem SKIP
'nomeItem ' nomeItem SKIP
'precoItem ' precoItem
END.
INPUT CLOSE.
Exemplo de Input com Criação de Registros em Tabela
/* IMPORTANDO PARA DENTRO DE UMA TABELA */
/* CRIAR UMA TEMP-TABLE COMO A ESTRUTURA DA TABELA ITEM */

DEFINE TEMP-TABLE TTITEM LIKE ITEM.
INPUT FROM
'C:\treinamento\fev.2015\basico\OUTPUT_11_export.TXT'.
REPEAT TRANSACTION:
CREATE TTITEM.
IMPORT
TTITEM.
END.
INPUT CLOSE.
*O uso do Transaction e Temp-table sem No-Undo é obrigatório para o Create para Temp-Table pois evitará
de um registro em branco ser adicionado – Uma temp-table não cria uma transação, logo o REPEAT deve ter
a opção TRANSACTION obrigatoriamente.
Exemplo de Import com Delimiter
/* IMPORTANDO PARA DENTRO DE UMA TABELA */
/* CRIAR UMA TEMP-TABLE COMO A ESTRUTURA DA TABELA ITEM */

DEFINE TEMP-TABLE TTITEM LIKE ITEM.
INPUT FROM
'C:\treinamento\fev.2015\basico\OUTPUT_11a_export.TXT'.
196
(18) 99747-8189
REPEAT TRANSACTION:
CREATE TTITEM.
IMPORT
DELIMITER ';'
TTITEM.
END.
INPUT CLOSE.
Exemplo de Input para ler arquivos de uma pasta
DEFINE VARIABLE ARQUIVO AS CHARACTER NO-UNDO.

DEFINE VARIABLE CAMINHO AS CHARACTER NO-UNDO.
DEFINE VARIABLE ATRIBUTOS AS CHARACTER NO-UNDO.
INPUT FROM OS-DIR('C:\treinamento\fev.2015\desenhos').
REPEAT:
IMPORT ARQUIVO CAMINHO ATRIBUTOS.
IF ARQUIVO BEGINS '.' THEN

NEXT.
MESSAGE ARQUIVO SKIP CAMINHO SKIP ATRIBUTOS

END.
INPUT CLOSE.
Anotações
197
(18) 99747-8189
Exercício
Para a nomenclatura dos exercícios, utilize a máscara INP_OUT_<número do exercício>.P (INP_OUT_1.p,
INP_OUT_2.p).
1. Crie um programa para exportar para o “Clipboard”.

2. Crie um programa para exportar a palavra “número exercício” para um arquivo,
a. Abra o arquivo gerado com o notepad,
b. Os caracteres “Ú” e “Í” estão sendo exibidos corretamente?
3. Crie um programa para exportar a tabela salesrep. Utilize export.
4. Crie um programa para exportar a tabela salesrep. Utilize put.
5. Crie um programa para exportar a tabela salesrep. Utilize export, use como separador “;” (ponto e
vírgula).
6. Crie um arquivo texto com os dados abaixo, importando-os para variáveis inteiro e caracter,
exibindo o valor importado.
"100" "Consulting"
"200" "Administration"
"300" "Marketing"
"400" "Sales"
"500" "Training"
"600" "Development"
"700" "Finance"
198
(18) 99747-8189
Eventos Nomeados em programas

A linguagem ABL permite realizar eventos nomeados em programas através das instruções Publish,
Subscribe.
Sintaxe Publish
PUBLISH event-name [ FROM publisher-handle ] [ ( parameter [ , parameter

] ... ) ]
Exemplo Publish
PUBLISH "novaMensagem".
Sintaxe Subscribe
SUBSCRIBE [ PROCEDURE subscriber-handle ] [ TO ] event-name { IN

publisher-handle | ANYWHERE } [ RUN-PROCEDURE local-internal-procedure ]
[ NO-ERROR ]
Exemplo Subscribe
SUBSCRIBE PROCEDURE THIS-PROCEDURE TO "receberNotificacao" IN happ1.
Eventos nomeados são um meio totalmente diferente dos eventos em mouse como mouse-select-click,
widgets como choose, value-changed, leave e nos outros objetos da linguagem ABL.
Através do handle SOURCE-PROCEDURE pode-se obter informações do programa que gerou a notificação.
Não há uma ordem de notificação quando há vários programas inscritos nos eventos nomeados.
Somente programas com a assinatura do método (nome e entrada de parâmetros) que coincidem com o
evento nomeado receberão notificação.
Os passos para utilizar eventos:
1. Executar os programas de modo persistente, tanto os que desejam ser notificados quando o que
será o gerador do evento.
2. Todos os programas que desejam receber notificação de evento deverão se inscrever em um outro
programa,
3. Um ou vários programas pulicam o evento.
4. Todos os programas inscritos serão notificados.
O Primeiro programa com eventos

Criaremos um exemplo com quatro programas:
1. App0.p é o programa responsável por executar os programas que receberão eventos e, por fim
meramente didático, também receberá notificação.
2. App1.p é o programa que publicará a notificação de evento.
199
(18) 99747-8189
3. App2.p é um programa que receberá o Handle do programa App1 para se publicar.

4. App3.p é mais um programa que receberá a notificação.
5. Durante a execução do programa APP0.p, todos os programas APP1, APP2 e APP3 serão executados
de forma persistente, e na linha “RUN notificar IN happ1 ( INPUT "minha notificacao" ).” o evento
“receberNotificacao” será disparado passo o parâmetro "minha notificacao".
Exemplo do programa APP0.p
/* variaveis para a persistencia */

DEFINE VARIABLE happ1 AS HANDLE NO-UNDO.
/* programa persistentes - em memoria */

RUN c:\temp\app1.p PERSISTENT SET happ1.
/* inscricao para a notificacao de mensagens */

SUBSCRIBE PROCEDURE THIS-PROCEDURE TO "receberNotificacao" IN happ1.
RUN inscrever IN happ2 ( INPUT happ1 ).
SUBSCRIBE PROCEDURE happ3 TO "receberNotificacao" IN happ1.
/* fazer a happ1 notificar todos os programas inscritos */

RUN notificar IN happ1 ( INPUT "minha notificacao" ).
/* remover os programas da memoria */

DELETE OBJECT happ1.
PROCEDURE receberNotificacao:
/* procedure recebernotificacao, ESTE NOME DO EVENTO QUE SERÁ
PUBLICADO*/
DEFINE INPUT PARAMETER pValor AS CHARACTER NO-UNDO.
MESSAGE 'App0 recebeu notificacao ' pValor SKIP

'Quem me notificou=' SOURCE-PROCEDURE:FILE-NAME
END.
200
(18) 99747-8189
PROCEDURE notificar:
/* notificar os programas inscritos */
DEFINE INPUT PARAMETER pMensagem AS CHARACTER NO-UNDO.
PUBLISH "receberNotificacao" ( INPUT pMensagem ).

END.
PROCEDURE inscrever:
/* recebendo o handle do programa que notifica
e se inscrevendo
*/
DEFINE INPUT PARAMETER pApp1 AS HANDLE NO-UNDO.
SUBSCRIBE PROCEDURE THIS-PROCEDURE TO "receberNotificacao" IN pApp1.

END.
PUBLICADO*/
MESSAGE 'App2 foi notificada=' pValor SKIP

END.
PUBLICADO*/
MESSAGE 'App3 tambem foi notificada com uma mensagem=' pValor SKIP
END.
Anotações
201
(18) 99747-8189
Cancelando a notificação de Eventos

Assim como um programa se inscreve, esta pode se cancelar a inscrição, para isso use a instrução
UNSUBSCRIBE.
Sintaxe
UNSUBSCRIBE [ PROCEDURE subscriber-handle ] [ TO ] { event-name | ALL } [

IN publisher-handle ]
Exemplo para se cancelar a inscrição de uma notificação.
UNSUBSCRIBE TO “minhaNotificacao”.
Exemplo para se cancelar a inscrição de todas as notificação de eventos.
UNSUBSCRIBE TO ALL.
202
(18) 99747-8189
Compilador
É a ferramenta ou instrução da linguagem que permite compilarmos programas.
Todo programa ABL fonte é compilado antes de ser executado.
A linguagem ABL permite utilizarmos o compilador _Comp.p ou instrução de compilação Compile.
Sintaxe Compile
COMPILE { procedure-name | object-type-name | VALUE ( expression ) }

[ ATTR-SPACE [ = logical-expression ] ]
[ SAVE [ = logical-expression ]
[ INTO { directory | VALUE ( expression ) } ]
]
[ LISTING { listfile | VALUE ( expression ) }
[ APPEND [ = logical-expression ]
| PAGE-SIZE integer-expression
| PAGE-WIDTH integer-expression
]
]
[ XCODE expression ]
[ XREF { xreffile | VALUE ( expression ) }
[ APPEND [ = logical-expression ] ]
]
[ XREF-XML { directory | filename | VALUE ( expression ) }
]
[ STRING-XREF { sxreffile | VALUE ( expression ) }
[ APPEND [ = logical-expression ] ]
]
[ STREAM-IO [ = logical-expression ] ]
[ LANGUAGES ( { language-list | VALUE ( expression ) } )
[ TEXT-SEG-GROW = growth-factor ] ]
[ DEBUG-LIST { debugfile | VALUE ( expression ) } ]
[ PREPROCESS { preprocessfile | VALUE ( expression ) } ]
[ NO-ERROR ]
[ V6FRAME [ = logical-expression ]
[ USE-REVVIDEO | USE-UNDERLINE ] ]
[ MIN-SIZE [ = logical-expression ] ]
[ GENERATE-MD5 [ = logical-expression ] ]
Opção Xref
Permite verificarmos o uso de índices durante pesquisas de dados com comandos For Each e Find.
Exemplo
COMPILE meuprograma.p XREF c:\temp\meuprograma_xref.txt.
Anotações
203
(18) 99747-8189
Ao compilarmos um programa com Xref, a análise do arquivo gerado deverá focar as linhas com Search, pois
identificará o índice utilizado.
Exemplo
...
adapters\xml\pgm\axrpg007.p include\i-prgvrs.i 46 SEARCH emsfnd.prog_dtsul
prgdtsl_id
...
...
...
adapters\xml\pgm\axrpg007.p include\i-prgvrs.i 59 SEARCH emsfnd.prog_dtsul
prgdtsl_02
...
...
Com a análise do índice utilizado e verificação do índice na tabela é possível sugerir a criação de novo índice
ou a mudança da pesquisa (find e for each).
Em alguns casos podemos ter a informação de Whole-index, que indica que a pesquisa está varrendo toda a
tabela sem uma faixa inicial ou final de dados ou pela falta de índice apropriado para a pesquisa.
Opção Preprocess
Permite criarmos um novo programa com todos os includes adicionados.
Exemplo
COMPILE meuprograma.p PREPROCESS c:\temp\meuprograma_pre.txt.
Anotações
Opção Listing
A opção Listing permite verificar o uso de blocos, seus tipos e seus rótulos, e onde se iniciam e terminam
transações.
Exemplo
COMPILE bf_tt_4.p listing c:\temp\meuprograma_pre.txt.
Resultado
204
(18) 99747-8189
c:\temp\bf_tt_4.p 04/04/2012 19:27:03 PROGRESS(R)

Page 1
{} Line Blk
-- ---- ---
1 def temp-table ttCustomer no-undo like customer
2 index ix_custnum is primary is unique custnum
3 index name name.
4
5 1 for each customer no-lock:
6 1 create ttCustomer.
7 1 buffer-copy customer to ttCustomer.
9
8 end.
10 for each ttCustomer
11 1 use-index name:
12 1
13 1
14 1
15 end.
16
c:\temp\bf_tt_4.p 04/04/2012 19:27:03 PROGRESS(R)
Page 2

-------------------- ---- ----------- ---- -------------------------------
-
c:\temp\bf_tt_4.p 0 Procedure No
Buffers: ttCustomer
c:\temp\bf_tt_4.p 5 For No
Buffers: sports.Customer
c:\temp\bf_tt_4.p 10 For No
Anotações
205
(18) 99747-8189
Anexos
Prova de certificação
Uma das questões da prova de certificação é esta abaixo, mas o aluno terá que desenvolver as funções
ausentes, como:
1. Tabela pai,
a. Adição,
b. Alteração,
c. Detalhar,
d. Remover,
e. Imprimir (Cliente e seus pedidos),
f. Janela pesquisar (Adicionar faixa inicial e final por código do cliente, filtrando os clientes que
estiverem dentro da faixa),
2. Tabela filho (browse de pedidos do cliente)
a. Adição,
b. Alteração,
c. Detalhar,
d. Remover,
e. Total de pedidos do cliente.
Programa da prova de certificação

Imagem do programa da prova de certificação
(18) 99747-8189
Janela pesquisar
Imagem da janela pesquisar da prova
207
(18) 99747-8189
Codigo do programa da prova de certificação

/*------------------------------------------------------------------------
File : exemplo1.p
Purpose : prova de certificação NEO STEP
Syntax :
Description :
Author(s) : Jaison Antoniazzi

Created : Thu Apr 21 13:50:06 BRT 2016
Notes :
1. O programa será utilizado para a prova de certificacao

neste programa nao ha eventos para os botoes da tabela pai - customer
a. adicionar
b. alterar
c. detalhar
d. remover
e. imprimir
2. nao ha eventos para os botoes da tabela filho - order

a. adicionar
b. alterar
c. detalhar
d. remover
3. Total de pedidos, criar funcao para retornar o total de pedidos do cliente,

exibindo na tela o resultado
----------------------------------------------------------------------*/
/* ******************** Preprocessor Definitions ******************** */

&SCOPED-DEFINE TABELA CUSTOMER
&SCOPED-DEFINE VERSAO 1.00.001
&SCOPED-DEFINE TABELA-FILHO ORDER
&SCOPED-DEFINE TITULO Manutenção De Clientes
/* *************************** Definitions ************************** */

DEFINE BUTTON BT-FIRST
LABEL '|<'
SIZE 7 BY 1
TOOLTIP 'Primeiro'
NO-FOCUS FLAT-BUTTON
.
DEFINE BUTTON BT-PREV

LIKE BT-FIRST
LABEL '<'
TOOLTIP 'Anterior'.
DEFINE BUTTON BT-NEXT

LIKE BT-FIRST
LABEL '>'
TOOLTIP 'Próximo'.
DEFINE BUTTON BT-LAST

LIKE BT-FIRST
LABEL '>|'
208
(18) 99747-8189
TOOLTIP 'Último'.
DEFINE BUTTON BT-SEARCH

LIKE BT-FIRST
LABEL '-->'
TOOLTIP 'Pesquisar...'.
DEFINE BUTTON BT-ADD

LIKE BT-FIRST
LABEL '+'
TOOLTIP 'Adicionar...'.
DEFINE BUTTON BT-EDIT

LIKE BT-FIRST
LABEL '/\'
TOOLTIP 'Alterar...'.
DEFINE BUTTON BT-DETAIL

LIKE BT-FIRST
LABEL '='
TOOLTIP 'Detalhar...'.
DEFINE BUTTON BT-DELETE

LIKE BT-FIRST
LABEL '-'
TOOLTIP 'Eliminar...'.
DEFINE BUTTON BT-PRINT

LIKE BT-FIRST
LABEL 'P'
TOOLTIP 'Imprimir.'.
DEFINE BUTTON BT-ADDSON

LIKE BT-FIRST
LABEL '+'
TOOLTIP 'Adicionar...'.
DEFINE BUTTON BT-EDITSON

LIKE BT-FIRST
LABEL '/\'
TOOLTIP 'Alterar...'.
DEFINE BUTTON BT-DETAILSON

LIKE BT-FIRST
LABEL '='
TOOLTIP 'Detalhar...'.
DEFINE BUTTON BT-DELETESON

LIKE BT-FIRST
LABEL '-'
TOOLTIP 'Eliminar...'.
DEFINE VARIABLE TOTAL-PEDIDOS

AS DECIMAL
LABEL 'Pedidos'
FORMAT 'US$ >>>,>>>,>>9.99'.
209
(18) 99747-8189
DEFINE RECTANGLE REC-PAI

NO-FILL
GRAPHIC-EDGE
EDGE-PIXELS 1
SIZE-CHARS 75 BY 6.
DEFINE QUERY QR-{&TABELA-FILHO}

FOR {&TABELA-FILHO}
SCROLLING.
DEFINE BROWSE BR-{&TABELA-FILHO}

QUERY QR-{&TABELA-FILHO}
DISPLAY
{&TABELA-FILHO}.Ordernum
{&TABELA-FILHO}.OrderDate
{&TABELA-FILHO}.SalesRep
{&TABELA-FILHO}.OrderStatus
WITH
8 DOWN
WIDTH 75
TITLE 'Pedidos do Cliente'
NO-ROW-MARKERS.
DEFINE FRAME FRAMEMAIN
BT-FIRST AT ROW 1.5 COL 3

BT-PREV AT ROW 1.5 COL 11
BT-NEXT AT ROW 1.5 COL 20
BT-LAST AT ROW 1.5 COL 29
BT-SEARCH
BT-ADD
BT-EDIT
BT-DETAIL
BT-DELETE
REC-PAI AT ROW 3.5 COL 3
Customer.CustNum AT ROW 4 COL 30 COLON-ALIGNED

Customer.Name AT ROW 5 COL 30 COLON-ALIGNED
Customer.Contact AT ROW 6 COL 30 COLON-ALIGNED
Customer.Phone AT ROW 7 COL 30 COLON-ALIGNED
Customer.CreditLimit AT ROW 8 COL 30 COLON-ALIGNED
BT-PRINT AT ROW 8 COL 70
BR-{&TABELA-FILHO} AT ROW 11 COL 3
BT-ADDSON AT ROW 20 COL 3

BT-EDITSON AT ROW 20 COL 11
BT-DETAILSON AT ROW 20 COL 20
BT-DELETESON AT ROW 20 COL 29
TOTAL-PEDIDOS AT ROW 20 COL 43
210
(18) 99747-8189
WITH
SIZE 80 BY 22
THREE-D
TITLE ''
SIDE-LABELS.
DEFINE VARIABLE RW-{&TABELA} AS ROWID NO-UNDO.
/* *************************** Main Block *************************** */
/* ********************** Internal Procedures *********************** */
PROCEDURE DATASEARCH:
/*------------------------------------------------------------------------------
Purpose:
Notes:
------------------------------------------------------------------------------*/
DEFINE OUTPUT PARAMETER PR-{&TABELA} AS ROWID NO-UNDO.
DEFINE BUFFER BF-{&TABELA} FOR {&TABELA}.
DEFINE QUERY Q-{&TABELA}

FOR BF-{&TABELA}
SCROLLING.
DEFINE BROWSE BW-{&TABELA}

QUERY Q-{&TABELA}
DISPLAY
BF-{&TABELA}.CustNum
BF-{&TABELA}.Name
BF-{&TABELA}.Contact
BF-{&TABELA}.Phone
WITH
WIDTH 75
11 DOWN
NO-ROW-MARKERS
FIT-LAST-COLUMN
SINGLE.
DEFINE BUTTON BT-OK

LABEL 'OK'
SIZE 10 BY 1
AUTO-GO.
DEFINE BUTTON BT-CANCEL

LABEL 'Cancelar'
SIZE 10 BY 1
AUTO-ENDKEY.
DEFINE FRAME FRAMESEARCH

BW-{&TABELA} AT ROW 3 COL 1
BT-OK AT ROW 14 COL 2

BT-CANCEL AT ROW 14 COL 15
211
(18) 99747-8189
WITH
DEFAULT-BUTTON BT-OK
CANCEL-BUTTON BT-CANCEL
SIZE 80 BY 16
VIEW-AS DIALOG-BOX
TITLE 'Pesquisar'
THREE-D.
ON 'VALUE-CHANGED' OF BW-{&TABELA}
DO:
IF AVAILABLE BF-{&TABELA} THEN
PR-{&TABELA} = ROWID(BF-{&TABELA}).
END.
ON 'CHOOSE' OF BT-OK
DO:
RETURN 'OK'.
END.
ON 'CHOOSE' OF BT-CANCEL
DO:
RETURN 'NOK'.
END.
ON 'MOUSE-SELECT-DBLCLICK' OF BW-{&TABELA}
DO:
APPLY 'CHOOSE' TO BT-OK.
END.
VIEW FRAME FRAMESEARCH.

OPEN QUERY Q-{&TABELA}
FOR EACH BF-{&TABELA}.
ENABLE ALL WITH FRAME FRAMESEARCH.
WAIT-FOR
CHOOSE OF BT-OK OR CHOOSE OF BT-CANCEL IN FRAME FRAMESEARCH.
END PROCEDURE.
PROCEDURE DISPLAYTABLE:
/*------------------------------------------------------------------------------
Purpose:
Notes:
------------------------------------------------------------------------------*/
IF NOT AVAILABLE {&TABELA} THEN
RETURN.
DISPLAY
Customer.CustNum
Customer.Name
Customer.Contact
Customer.Phone
Customer.CreditLimit
TOTAL-PEDIDOS
WITH FRAME FRAMEMAIN.
212
(18) 99747-8189
END PROCEDURE.
PROCEDURE GOTOFIRST:
/*------------------------------------------------------------------------------
Purpose:
Notes:
------------------------------------------------------------------------------*/
FIND FIRST {&TABELA} NO-LOCK.
RUN OPENQUERYSON1.
RUN DISPLAYTABLE.
END PROCEDURE.
PROCEDURE GOTOLAST:
/*------------------------------------------------------------------------------
Purpose:
Notes:
------------------------------------------------------------------------------*/
FIND LAST {&TABELA} NO-LOCK.
RUN OPENQUERYSON1.
RUN DISPLAYTABLE.
END PROCEDURE.
PROCEDURE GOTONEXT:
/*------------------------------------------------------------------------------
Purpose:
Notes:
------------------------------------------------------------------------------*/
FIND NEXT {&TABELA} NO-LOCK.
RUN OPENQUERYSON1.
RUN DISPLAYTABLE.
END PROCEDURE.
PROCEDURE GOTOPREV:
/*------------------------------------------------------------------------------
Purpose:
Notes:
------------------------------------------------------------------------------*/
FIND PREV {&TABELA} NO-LOCK.
RUN OPENQUERYSON1.
RUN DISPLAYTABLE.
END PROCEDURE.
PROCEDURE GOTOROWID:
/*------------------------------------------------------------------------------
Purpose:
Notes:
213
(18) 99747-8189
------------------------------------------------------------------------------*/
DEFINE INPUT PARAMETER P-REGISTRO AS ROWID NO-UNDO.
FIND FIRST {&TABELA}

NO-LOCK
WHERE ROWID({&TABELA}) = P-REGISTRO.
RUN OPENQUERYSON1.
RUN DISPLAYTABLE.
END PROCEDURE.
PROCEDURE INITIATE:
/*------------------------------------------------------------------------------
Purpose:
Notes:
------------------------------------------------------------------------------*/
ENABLE ALL
EXCEPT
Customer.CustNum
Customer.Name
Customer.Contact
Customer.Phone
Customer.CreditLimit
TOTAL-PEDIDOS
WITH FRAME FRAMEMAIN.

VIEW FRAME FRAMEMAIN.
RUN GOTOFIRST.
RUN SETTITLE.
END PROCEDURE.
PROCEDURE OPENQUERYSON1:
/*------------------------------------------------------------------------------
Purpose:
Notes:
------------------------------------------------------------------------------*/
OPEN QUERY QR-{&TABELA-FILHO}
FOR EACH {&TABELA-FILHO} OF {&TABELA}
NO-LOCK.
END PROCEDURE.
PROCEDURE SETTITLE:
/*------------------------------------------------------------------------------
Purpose:
Notes:
------------------------------------------------------------------------------*/
DO WITH FRAME FRAMEMAIN:
FRAME FRAMEMAIN:TITLE = SUBSTITUTE ('NEO STEP &1 - &2', '{&TITULO}',
'{&VERSAO}').
END.
214
(18) 99747-8189
END PROCEDURE.
ON 'CHOOSE' OF BT-FIRST
DO:
RUN GOTOFIRST.
END.
ON 'CHOOSE' OF BT-PREV
DO:
RUN GOTOPREV.
END.
ON 'CHOOSE' OF BT-NEXT
DO:
RUN GOTONEXT.
END.
ON 'CHOOSE' OF BT-LAST
DO:
RUN GOTOLAST.
END.
ON 'CHOOSE' OF BT-SEARCH
DO:
DEFINE VARIABLE REGISTRO AS ROWID NO-UNDO.

RUN DATASEARCH(OUTPUT REGISTRO).
IF RETURN-VALUE = 'OK' THEN
RUN GOTOROWID(INPUT REGISTRO).
END.
RUN INITIATE.
WAIT-FOR ENDKEY OF FRAME FRAMEMAIN.
215
(18) 99747-8189
Componentes do banco de dados Sports2000

Imagem do MER do banco SPORTS2000
Tabelas do banco Sports2000

Table St Dump Tbl Field Index Table
Name Area Name Flg Count Count Label
----------------------------- ---- ------------- --- ----- ----- -----------
Benefits 7 benefits 7 1 ?
BillTo 11 billto 10 1 ?
Bin 8 bin 5 3 ?
Customer 9 customer 18 5 ?
Department 7 departme 2 1 ?
Employee 7 employee 16 3 ?
Family 7 family 6 1 ?
Feedback 12 feedback 8 5 ?
InventoryTrans 8 inventor 10 1 ?
Invoice 12 invoice 8 4 ?
Item 8 item 14 5 ?
LocalDefault 12 localdef 9 1 ?
Order 11 order 15 5 ?
OrderLine 11 orderlin 8 3 ?
POLine 8 poline 8 1 ?
PurchaseOrder 8 purchase 5 1 ?
RefCall 12 refcall 6 4 ?
Salesrep 12 salesrep 4 1 ?
ShipTo 11 shipto 11 1 ?
State 12 state 3 1 ?
Supplier 8 supplier 14 1 ?
SupplierItemXref 8 suppitem 2 2 ?
TimeSheet 7 timeshee 9 1 ?
Vacation 7 vacation 3 1 ?
Warehouse 8 warehous 9 2 ?
216
(18) 99747-8189
Índices das tabelas do banco Sports2000
Table: Benefits
Flags Index Name St Area Cnt Field Name

----- ----------------------------- ------- --- ------------------------------
pu EmpNo 7 1 + EmpNum
Table: BillTo

----- ----------------------------- ------- --- ------------------------------
pu custnumbillto 11 2 + CustNum
+ BillToID
Table: Bin

----- ----------------------------- ------- --- ------------------------------
pu BinNum 8 1 + BinNum
ItemNum 8 1 + Itemnum
WarehouseNumItemNum 8 2 + WarehouseNum
+ Itemnum
Table: Customer

----- ----------------------------- ------- --- ------------------------------
w Comments 10 1 + Comments
CountryPost 10 2 + Country
+ PostalCode
pu CustNum 10 1 + CustNum
Name 10 1 + Name
SalesRep 10 1 + SalesRep
Table: Department

----- ----------------------------- ------- --- ------------------------------
pu DeptCode 7 1 + DeptCode
Table: Employee

----- ----------------------------- ------- --- ------------------------------
DeptCode 7 1 + DeptCode
pu EmpNo 7 1 + EmpNum
u Name 7 2 + LastName
+ FirstName
Table: Family
217
(18) 99747-8189
----- ----------------------------- ------- --- ------------------------------

pu EmpNoRelativeName 7 2 + EmpNum
+ RelativeName
Table: Feedback

----- ----------------------------- ------- --- ------------------------------
w Comments 12 1 + Comments
w Company 12 1 + Company
w Contact 12 1 + Contact
p Department 12 1 + Department
Rating 12 1 + Rating
Table: InventoryTrans

----- ----------------------------- ------- --- ------------------------------
p default 6 0 +
Table: Invoice

----- ----------------------------- ------- --- ------------------------------
CustNum 12 1 + CustNum
InvoiceDate 12 1 + InvoiceDate
pu InvoiceNum 12 1 + Invoicenum
OrderNum 12 1 + OrderNum
Table: Item

----- ----------------------------- ------- --- ------------------------------
w CatDescription 8 1 + CatDescription
Category2ItemName 8 2 + Category2
+ ItemName
CategoryItemName 8 2 + Category1
+ ItemName
w ItemName 8 1 + ItemName
pu ItemNum 8 1 + Itemnum
Table: LocalDefault

----- ----------------------------- ------- --- ------------------------------
pu localdefnum 12 1 + LocalDefNum
Table: Order
218
(18) 99747-8189
----- ----------------------------- ------- --- ------------------------------

u CustOrder 11 2 + CustNum
+ Ordernum
OrderDate 11 1 + OrderDate
pu OrderNum 11 1 + Ordernum
OrderStatus 11 1 + OrderStatus
SalesRep 11 1 + SalesRep
Table: OrderLine

----- ----------------------------- ------- --- ------------------------------
itemnum 11 1 + Itemnum
pu orderline 11 2 + Ordernum
+ Linenum
OrderLineStatus 11 1 + OrderLineStatus
Table: POLine

----- ----------------------------- ------- --- ------------------------------
pu PONumLinenum 8 2 + PONum
+ Linenum
Table: PurchaseOrder

----- ----------------------------- ------- --- ------------------------------
pu PONum 8 1 + PONum
Table: RefCall

----- ----------------------------- ------- --- ------------------------------
pu CallNum 12 1 + CallNum
u CustNum 12 2 + CustNum
+ CallNum
ua Sibling 12 2 + Parent
+ CallNum
w Txt 12 1 + Txt
Table: Salesrep

----- ----------------------------- ------- --- ------------------------------
pu SalesRep 12 1 + SalesRep
Table: ShipTo

----- ----------------------------- ------- --- ------------------------------
pu custnumshipto 11 2 + CustNum
219
(18) 99747-8189
+ ShipToID
Table: State

----- ----------------------------- ------- --- ------------------------------
pu State 12 1 + State
Table: Supplier

----- ----------------------------- ------- --- ------------------------------
pu SupplierID 8 1 + SupplierIDNum
Table: SupplierItemXref

----- ----------------------------- ------- --- ------------------------------
u ItemNumSupplierID 8 2 + Itemnum
+ SupplierIDNum
pu SupplieridItemNum 8 2 + SupplierIDNum
+ Itemnum
Table: TimeSheet

----- ----------------------------- ------- --- ------------------------------
pu EmpNoDayRecorded 7 2 + EmpNum
+ DayRecorded
Table: Vacation

----- ----------------------------- ------- --- ------------------------------
pu EmpNoStartDate 7 2 + EmpNum
+ StartDate
Table: Warehouse

----- ----------------------------- ------- --- ------------------------------
warehousename 8 1 + WarehouseName
pu warehousenum 8 1 + WarehouseNum
Relacionamento das tabelas

Benefits:
Employee OF Benefits (EmpNum)
TimeSheet OF Benefits (EmpNum)
Vacation OF Benefits (EmpNum)
Family OF Benefits (EmpNum)
Benefits OF Employee (EmpNum)
BillTo:
Order OF BillTo (CustNum,BillToID)
BillTo OF Customer (CustNum)
BillTo OF State (State)
220
(18) 99747-8189
Bin:
InventoryTrans OF Bin (BinNum)
Bin OF Item (Itemnum)
Bin OF Warehouse (WarehouseNum)
Customer:
Invoice OF Customer (CustNum)
RefCall OF Customer (CustNum)
ShipTo OF Customer (CustNum)
BillTo OF Customer (CustNum)
Order OF Customer (CustNum)
Customer OF Salesrep (SalesRep)
Customer OF State (State)
Department:
Employee OF Department (DeptCode)
Employee:
TimeSheet OF Employee (EmpNum)
Vacation OF Employee (EmpNum)
Family OF Employee (EmpNum)
Benefits OF Employee (EmpNum)
Employee OF State (State)
Employee OF Vacation (EmpNum,StartDate)
Employee OF Department (DeptCode)
Employee OF Benefits (EmpNum)
Family:
Family OF Employee (EmpNum)
Family OF Benefits (EmpNum)
Feedback:
No relations found for this file.
InventoryTrans:
InventoryTrans OF Item (Itemnum)
InventoryTrans OF Order (Ordernum)
InventoryTrans OF Warehouse (WarehouseNum)
InventoryTrans OF Bin (BinNum)
InventoryTrans OF PurchaseOrder (PONum)
Invoice:
Invoice OF Customer (CustNum)
Item:
OrderLine OF Item (Itemnum)
Bin OF Item (Itemnum)
InventoryTrans OF Item (Itemnum)
POLine OF Item (Itemnum)
SupplierItemXref OF Item (Itemnum)
LocalDefault:
No relations found for this file.
Order:
OrderLine OF Order (Ordernum)
InventoryTrans OF Order (Ordernum)
Order OF Customer (CustNum)
Order OF Salesrep (SalesRep)
Order OF ShipTo (CustNum,ShipToID)
221
(18) 99747-8189
Order OF BillTo (CustNum,BillToID)

Order OF Warehouse (WarehouseNum)
OrderLine:
OrderLine OF Item (Itemnum)
OrderLine OF Order (Ordernum)
POLine:
POLine OF Item (Itemnum)
POLine OF PurchaseOrder (PONum)
PurchaseOrder:
InventoryTrans OF PurchaseOrder (PONum)
POLine OF PurchaseOrder (PONum)
PurchaseOrder OF Supplier (SupplierIDNum)
RefCall:
RefCall OF Customer (CustNum)
RefCall OF Salesrep (SalesRep)
Salesrep:
Customer OF Salesrep (SalesRep)
RefCall OF Salesrep (SalesRep)
Order OF Salesrep (SalesRep)
ShipTo:
Order OF ShipTo (CustNum,ShipToID)
ShipTo OF Customer (CustNum)
ShipTo OF State (State)
State:
Customer OF State (State)
Employee OF State (State)
ShipTo OF State (State)
BillTo OF State (State)
Supplier OF State (State)
Warehouse OF State (State)
Supplier:
PurchaseOrder OF Supplier (SupplierIDNum)
SupplierItemXref OF Supplier (SupplierIDNum)
Supplier OF State (State)
SupplierItemXref:
SupplierItemXref OF Item (Itemnum)
SupplierItemXref OF Supplier (SupplierIDNum)
TimeSheet:
TimeSheet OF Employee (EmpNum)
TimeSheet OF Benefits (EmpNum)
Vacation:
Employee OF Vacation (EmpNum,StartDate)
Vacation OF Employee (EmpNum)
Vacation OF Benefits (EmpNum)
Warehouse:
Order OF Warehouse (WarehouseNum)
Bin OF Warehouse (WarehouseNum)
InventoryTrans OF Warehouse (WarehouseNum)
222
(18) 99747-8189
Warehouse OF State (State)
Listagem de campos das tabelas do banco Sports2000

Table: Benefits
Field Name Data Type Flg Format

--------------------------- ---------- --- --------------------------------
EmpNum inte i zzzzzzzzz9
HealthCare char x(8)
LifeInsurance inte $>>,>>>,>>>
Pension401K inte >>,>>9
StockPurchase inte >>,>>9
MedicalSpending inte >>,>>9
DependentCare inte >>,>>9
Table: BillTo

--------------------------- ---------- --- --------------------------------
CustNum inte i >>>>9
BillToID inte i zzzzzzzzz9
Name char x(30)
Address char x(35)
Address2 char x(35)
City char x(25)
State char x(20)
PostalCode char x(10)
Contact char x(30)
Phone char x(20)
Table: Bin

--------------------------- ---------- --- --------------------------------
WarehouseNum inte i zzzzzzzzz9
Itemnum inte i zzzzzzzzz9
Qty inte ->>>>9
BinNum inte i zzzzzzzzz9
BinName char x(30)
Table: Customer

--------------------------- ---------- --- --------------------------------
Country char i x(20)
Name char i x(30)
Address char x(35)
Address2 char x(35)
City char x(25)
State char x(20)
PostalCode char i x(10)
Contact char x(30)
Phone char x(20)
SalesRep char i x(4)
CreditLimit deci-2 ->,>>>,>>9
Balance deci-2 ->,>>>,>>9.99
Terms char x(20)
Discount inte >>9%
Comments char i x(80)
223
(18) 99747-8189
Fax char x(20)

EmailAddress char x(50)
Table: Department

--------------------------- ---------- --- --------------------------------
DeptCode char i x(3)
DeptName char x(15)
Table: Employee

--------------------------- ---------- --- --------------------------------
LastName char i x(25)
FirstName char i x(15)
Address char x(35)
Address2 char x(35)
City char x(25)
State char x(20)
HomePhone char x(20)
WorkPhone char x(20)
DeptCode char i x(3)
Position char x(20)
Birthdate date 99/99/9999
StartDate date 99/99/9999
VacationDaysLeft inte >>9
SickDaysLeft inte >>9
Table: Family

--------------------------- ---------- --- --------------------------------
RelativeName char i x(15)
Relation char x(15)
Birthdate date 99/99/9999
CoveredOnBenefits logi yes/no
BenefitDate date 99/99/9999
Table: Feedback

--------------------------- ---------- --- --------------------------------
Contact char i x(30)
Company char i x(20)
EmailAddress char x(50)
Phone char x(20)
Fax char x(20)
Comments char i x(80)
Department char i x(15)
Rating inte i 9
Table: InventoryTrans

--------------------------- ---------- --- --------------------------------
InvTransNum inte zzzzzzzzz9
224
(18) 99747-8189
WarehouseNum inte zzzzzzzzz9

BinNum inte zzzzzzzzz9
Qty inte ->>>>9
Itemnum inte zzzzzzzzz9
TransDate date 99/99/9999
InvType char X(12)
PONum inte zzzzzzzzz9
Ordernum inte zzzzzzzzz9
Transtime char X(5)
Table: Invoice

--------------------------- ---------- --- --------------------------------
Invoicenum inte i zzzzzzzzz9
InvoiceDate date i 99/99/9999
Amount deci-2 ->>,>>9.99
TotalPaid deci-2 ->>,>>9.99
Adjustment deci-2 ->>,>>9.99
OrderNum inte i zzzzzzzzz9
ShipCharge deci-2 ->>,>>9.99
Table: Item

--------------------------- ---------- --- --------------------------------
ItemName char i x(25)
Price deci-2 ->,>>>,>>9.99
Onhand inte ->>>>9
Allocated inte ->>>>9
ReOrder inte ->>>>9
OnOrder inte ->>>>9
CatPage inte >>9
CatDescription char i X(200)
Category1 char i x(30)
Category2 char i x(30)
Special char x(8)
Weight deci-2 ->>,>>9.99
Minqty inte ->>>>9
Table: LocalDefault

--------------------------- ---------- --- --------------------------------
Country char x(20)
Region1Label char x(15)
Region2Label char x(15)
PostalLabel char x(15)
PostalFormat char x(15)
TelFormat char x(15)
CurrencySymbol char x(6)
DateFormat char x(8)
LocalDefNum inte i zzzzzzzzz9
Table: Order

--------------------------- ---------- --- --------------------------------
225
(18) 99747-8189
Ordernum inte i zzzzzzzzz9

OrderDate date i 99/99/99
ShipDate date 99/99/9999
PromiseDate date 99/99/99
Carrier char x(25)
Instructions char x(50)
PO char x(20)
Terms char x(20)
BillToID inte zzzzzzzzz9
ShipToID inte zzzzzzzzz9
OrderStatus char i x(20)
WarehouseNum inte zzzzzzzzz9
Creditcard char x(20)
Table: OrderLine

--------------------------- ---------- --- --------------------------------
Ordernum inte i zzzzzzzzz9
Linenum inte i >>9
Price deci-2 ->,>>>,>>9.99
Qty inte ->>>>9
Discount inte >>9%
ExtendedPrice deci-2 ->>>,>>9.99
OrderLineStatus char i x(20)
Table: POLine

--------------------------- ---------- --- --------------------------------
Linenum inte i >>9
Itemnum inte zzzzzzzzz9
Price deci-2 ->,>>>,>>9.99
Qty inte ->>>>9
Discount inte >>9%
ExtendedPrice deci-2 ->>,>>9.99
PONum inte i zzzzzzzzz9
POLineStatus char x(20)
Table: PurchaseOrder

--------------------------- ---------- --- --------------------------------
PONum inte i zzzzzzzzz9
DateEntered date 99/99/9999
SupplierIDNum inte zzzzzzzzz9
ReceiveDate date 99/99/9999
POStatus char x(20)
Table: RefCall

--------------------------- ---------- --- --------------------------------
CallNum char i x(6)
CallDate date 99/99/9999
SalesRep char x(4)
226
(18) 99747-8189
Parent char i x(6)

Txt char i x(300)
Table: Salesrep

--------------------------- ---------- --- --------------------------------
RepName char x(30)
Region char x(8)
MonthQuota inte[12] ->,>>>,>>9
Table: ShipTo

--------------------------- ---------- --- --------------------------------
ShipToID inte i zzzzzzzzz9
Contact char x(30)
Address char x(35)
Address2 char x(35)
City char x(25)
State char x(20)
Phone char x(20)
Comments char x(80)
Name char x(30)
Table: State

--------------------------- ---------- --- --------------------------------
State char i x(20)
StateName char x(20)
Region char x(8)
Table: Supplier

--------------------------- ---------- --- --------------------------------
SupplierIDNum inte i zzzzzzzzz9
Name char x(30)
Address char x(35)
Address2 char x(35)
City char x(25)
State char x(20)
Country char x(20)
Phone char x(20)
Comments char x(80)
Password char cm x(8)
LoginDate date 99/99/9999
ShipAmount inte >>>>9
Discount inte >>9%
Table: SupplierItemXref

--------------------------- ---------- --- --------------------------------
SupplierIDNum inte i zzzzzzzzz9
227
(18) 99747-8189
Table: TimeSheet

--------------------------- ---------- --- --------------------------------
DayRecorded date i 99/99/9999
TypeRecorded char x(8)
AMTimeIn char xx:xx
AMTimeOut char xx:xx
PMTimeIn char xx:xx
PMTimeOut char xx:xx
RegularHours deci-2 >>9.<<
OvertimeHours deci-2 >>9.<<
Table: Vacation

--------------------------- ---------- --- --------------------------------
StartDate date i 99/99/9999
EndDate date 99/99/9999
Table: Warehouse

--------------------------- ---------- --- --------------------------------
WarehouseNum inte i zzzzzzzzz9
WarehouseName char i x(30)
Country char x(20)
Address char x(35)
Address2 char x(35)
City char x(25)
State char x(20)
Phone char x(20)
228

Apostila PROGRESS ABL v1.5

Enviado por

Dados do documento

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Apostila PROGRESS ABL v1.5

Enviado por

Direitos autorais:

Formatos disponíveis

Dalto Blanco Programando com Progress ABL v.1.

Advanced Business Language

Copyright © 2021 Neo Step Ltda.

Todos os Direitos Reservados.

Nenhuma parte deste documento pode ser copiada, reproduzida, traduzida ou

Composição da sessão ................................................................................................................. 10

Interação com registros............................................................................................................... 49

Resultado no Ambiente Caracter .............................................................................................................. 91

Anotações ................................................................................................................................................ 107

Códigos de Gatilhos ..................................................................................................................................... 129

Anotações ................................................................................................................................................ 155

Sobre esta apostila

Neo Step Todos os Direitos Reservados.

Sobre o Progress OpenEdge

• Possui linguagem interpretada conhecida como ABL - Advanced Business Language,

Alicerces dos sistemas Progress OpenEdge

1. A máquina virtual AVM que interpreta os programas compilados de um sistema,

Sobre a Linguagem ABL – Advanced Business Language

Banco de dados Progress OpenEdge

Application Data Area

Primary Recovery Area

Transaction log Area

Encryption Policy Area

Audit data and index Area

Relacionamentos entre tabelas

Além destas, as soluções Progress ainda abrangem:

• Soluções Cognitivas como DataRPM e Corticon,

Ferramentas especialistas da versão OE Studio

Procedure Editor (Client)

C:\DLC101B\bin\prowin32.exe -basekey ini -ini scripts\ems2.ini -pf

Dissecando este comando:

• Prowin32.exe é o executável OpenEdge da Máquina Virtual que interpreta comandos

Variável Descrição Exemplo

Programas em ambiente TTY e Gráfico

Um programa TTY de exemplo.

/* declarando uma variavel */

/* criando um laço de repeticao */

/* lendo um valor na variavel */

/* pesquisando no banco de dados */

/* fim do bloco, mas por ser Repeat reiniciará a leitura */

Programa TTY de exemplo

Programa exemplo executando em ambiente TTY (DOS ou UNIX)

Programa exemplo executando em ambiente gráfico (Windows)

Analisando o código do programa exemplo

/* criando um laço de repetição, use ESC para sair*/

/* lendo um valor na variavel */

/* pesquisando no banco de dados */

/* fim do bloco, mas por ser Repeat reiniciará a leitura */

Um programa para Windows de exemplo.

/* declarando uma variavel */

DEFINE FRAME principal

ON RETURN OF icodigoCliente IN FRAME principal

ASSIGN INPUT icodigoCliente.

VIEW FRAME principal.

WITH FRAME principal.

WAIT-FOR ENDKEY OF FRAME principal.

Programa desenvolvido em ABL para ambiente gráfico (Windows).

Analisando o código do programa exemplo do Windows

2 DEFINE FRAME principal

3 ON RETURN OF icodigoCliente IN FRAME principal DO:

3.1 ASSIGN INPUT icodigoCliente.

4 VIEW FRAME principal.

7 WAIT-FOR ENDKEY OF FRAME principal.

1. Definição de variável para entrada de dados,