UNIVERSIDADE DO SUL DE SANTA CATARINA UNISUL

PROF. EDSON THIZON

EDUCAO ORACLE

Oracle Forms Designer

Parte 5
Forms Builder

OPERAES BSICAS
Acessando Oracle Forms Designer
Abrindo o Oracle Forms Designer
Duplo Clique no cone do Oracle Forms 6;

Escolher a opo Arquivo/Executar no menu principal do Windows: Na caixa de dilogo digite

a linha de comando: c:\<ORACLE_HOME>\bin\ifbld60.exe. Onde <ORACLE_HOME> o diretrio
raiz do Oracle.

Conectando-se ao Banco de Dados Oracle

Utilizar o comando File/Connect do menu do Oracle Forms Designer;

Na janela de conexo , Digitar um usurio e senha Oracle vlidos;

Pressionar o boto Connect.

Abandonando o Oracle Forms Designer

Utilizar o comando File/Exit do menu do Oracle Forms Designer;

Duplo-Clique no boto de controle no canto superior esquerdo da janela;

Pressione <Alt + F4>.
Exerccio 1
Entre no Oracle Forms Designer usando as diversas formas aprendidas. Depois, conecte-se ao
banco e abandone o form, usando as diversas opes vistas.

Gerenciamento de Mdulos
Formatos de Arquivos de Mdulo.
Mdulos so componentes gerenciados pelo Oracle Forms 6. Um conjunto de um ou mais
mdulos com mesmo objetivo de uma aplicao.
Veja abaixo a tabela dos diversos tipos de mdulos e seus arquivos correspondentes:
Mdulo
Form(Telas)

Menus

Libraries(Bibliotecas)

Arquivos Gerados
.FMB: Arquivo fonte binrio de uma tela:
.FMX: Arquivo executvel binrio de uma tela.
.FMT: Arquivo texto ASCII correspondente a uma tela.
.MMB: Arquivo fonte binrio de um menu;
.MMX: Arquivo executvel binrio de um menu;
.MMT: Arquivo texto ASCII correspondente a um menu.
.PLL: Arquivo fonte binrio de uma Biblioteca;
.LIB: Arquivo executvel de uma Biblioteca;
.PLD: Arquivo texto ASCII correspondente a uma Biblioteca.

Acesso Mdulos.
Os mdulos do Oracle Forms podem ser acessados tanto no diretrio de seu disco, atravs de
arquivos, como no banco de dados Oracle ao qual o Oracle Forms est conectado.
Veja abaixo o esquema de funcionamento do acesso a mdulos no Oracle Forms:

Banco de
Dados
Oracle

Diretrio
*.FMB, *.FMX
*.FMT, *.MMB
*.LIB, *.PLL,
etc.

Para se efetuar o salvamento ou leitura de mdulos o Oracle Forms precisa saber onde ler e
gravar o referido mdulo. O Oracle Forms permite a leitura e gravao dos mdulos nos

diretrios do seu disco, em formatos de arquivos, ou no banco de dados Oracle. Isto pode ser
definido pelo desenvolvedor na tela Preferences do Oracle Forms Designer.

Abrindo um Mdulo
Quando o Oracle Forms Designer carregado, ele automaticamente cria um novo mdulo,
normalmente chamado module 1.
Para abrir outro mdulo, utiliza-se o comando File/Open do menu o Oracle Forms, ou
pressionando-se <CTRL> + O;

Salvando um Mdulo.
Os mdulos podem ser salvos tanto no diretrio quanto no banco de dados.
Para alterar o nome ou o local de armazenamento de um mdulo posteriormente, use o
comando File/Save As.

Se, dentro da janela de filtro, for escolhido destino Database, aparecer uma janela especfica
para salvamento de mdulos de banco de dados.

Outras Operaes com Mdulos.

A tabela abaixo exibe outras operaes, menos utilizadas, que podem ser realizadas com os
mdulos.
Operao
Excluir Mdulos.

Renomear Mdulos

Reverter o mdulo
para a ltima verso
salva.

Comando
File/Administration/Delete

Descrio
Exclui um mdulo que foi
previamente gravado no banco de
dados. Para excluir mdulos que
foram gravados no diretrio, utilize
comandos especficos do sistema
operacional.
File/Administration/Rename Renomeia um mdulo que foi
previamente gravado no banco de
dados. Para renomear mdulos que
foram gravados no diretrio, utilize
comandos especficos do sistema
operacional.
File/Revert
Carrega a ultima verso do mdulo
salva, no banco de dados,
desconsiderando a verso atual.

Convertendo um Modulo para o Formato Texto ASCII

Os arquivos fonte do Oracle Forms, com extenso FMB, so gravados em formato binrio,
portanto, de difcil leitura. Para criar uma verso texto (FMT) de um arquivo fonte do Oracle
Forms, use o comando File/Administration/Convert.
A janela de converso de arquivos ir aparecer:

Basta digitar o nome do arquivo FMB a ser convertido e clicar no boto Convert. O Oracle
Forms ir gerar um arquivo FMT, do tipo ASCII.

O Oracle Forms Designer no consegue abrir arquivos FMT. Portanto, antes de abrir um destes
arquivos, converta-o para o formato FMB, usando o comando File/Administration/Convert e
alterando o Direction para Text-to-Binary.
Gerando um Modulo para Execuo
Antes que os mdulos possam ser executados, e, portanto, utilizados pelos usurios, eles devem
passar por um processo que se chama Gerao. Durante a gerao, o cdigo compilado e o
mdulo validado e preparado para ser executado atravs do componente RunForm, do Oracle
Forms.
Quando um mdulo gerado, ele sempre cria um arquivo FMX, com o mesmo nome do
mdulo. Este arquivo no pode ser executado sem o auxilio RunForm.
Para gerar um mdulo, pode-se utilizar o comando File/Administration/Object List Report

Executando um Modulo previamente Gerado

Para executar um mdulo que j foi gerado, utilize o comando Program/Run Form/Client
Server:

O comando File/Run na verdade, apenas realiza uma chamada ao Run/ Form, que executa o
arquivo FMX correspondente ao mdulo gerado.

10

Fechando um Modulo

Para fechar um mdulo aberto, utiliza-se o comando File/Close do menu Oracle Forms
Designer, ou pressiona-se <Ctrl> + W.
Exerccio 2
1 Entre no Oracle Forms Designer, connecte-se ao banco e abra, do seu diretrio, o form
PEDIDOS.
2 Salve o form PEDIDOS no banco de dados, usando seu usurio.
3 Converta o form para texto ASCII e verifique o arquivo gerado.
4 Renomeie o Forms PEDIDO, no banco, para o nome de seu usurio Oracle.
5 Finalmente exclua o form do banco de dados e salve o novamente no diretrio.
6 Faa a gerao e a execuo do form PEDIDOS.

11

Operando uma Aplicao no Oracle Forms

Este captulo nos dar uma idia de como o usurio final ir trabalhar em uma aplicao
desenvolvida em Oracle Forms Designer. Para estudar este captulo, por favor faa o ltimo
exerccio da lio anterior.
Barra de Status
A barra de status uma rea, no rodap da tela onde o usurio pode verificar o estado de sua
aplicao e receber mensagens de aviso ou de erro.
Local destinado as mensagens de aviso ou de erro.

Indica que uma lista de valores est disponvel para o item.

Indica que o Forms est em modo de pesquisa.

Exibe o nmero de registros recuperados e exibidos da ltima pesquisa.
Esta rea esta dividida em duas linhas:
- Linha de mensagens: Onde so exibidas todas as mensagens necessrias;
- Linha de Status: Onde aparece as informaes sobre a tela.
A janela de Ajuda de Teclas
Dentro do Oracle Forms, todas as funes so executadas atravs de teclas especficas;
Para saber quais teclas executam quais funes, usam-se a tecla [Show Keys] ou ctrl+F1, ou o
comando Help/keys no menu.

Figura: Comando Help/keys no menu do Forms gerado.

12

Figura: Janela de ajuda de teclas.

Algumas Teclas de Funes Comuns

[Cancel/Exit]
[Commit/Accept]
[Down]

[Edit]
[Enter Query]
[Execute Query]
[Help]

[Left]
[List]
[Menu]
[Next Block]

Cancela a operao corrente;

Executa no banco de dados todas as alteraes feitas na tela
desde o ltimo [Commit] ou [Rollback];
Move o cursor para o prximo registro, mantendo-o no item
corrente. Se o cursor estiver em um item multi-line, [Down]
simplismente desloca o cursor dentro do item. Se o prximo
registro for um novo registro, o cursor colocado no primeiro
item do registro.
Exibe uma janela onde o usurio pode digitar textos muito longo
para um determinado item.
Limpa o bloco corrente e permite ao operador inserir critrios de
busca para acesso ao banco de dados.
Limpa o bloco corrente e recupera do banco de dados todos os
registros referenciados pelo bloco.
Exibe uma breve mensagem (Hint) para o item na linha de
mensagens. Se alguma mensagem j estiver l, ser ativada uma
janela com informaes adicionais.
Move o cursor um caractere para a esquerda.
Ativa a lista de valores, se houver alguma disponvel no item
corrente.
Ativa o menu, se houver algum disponvel.
Move o cursor para o prximo bloco que contenha pelo menos
um item com a propriedade insert habilitada. A seqncia
campos pode ser definida pelo desenvolvedor.

13

[Next Item]
[Next Record]
[Previous Block]
[Previous Item]
[Previous Record]
[Right]
[Show Keys]
[UP]

Move o cursor para o prximo item do registro corrente

conforme seqncia estabelecida pelo desenvolvedor.
Move o cursor para o prximo registro no bloco corrente, se no
houverem mais registros, um novo registro criado.
Move o cursor para o bloco anterior que contenha pelo menos
um item com a propriedade insert habilitada.
Move o cursor para o item anterior dentro do registro corrente,
conforme seqncia estabelecida pelo desenvolvedor.
Move o cursor para o registro anterior dentro do bloco corrente.
Move o cursor um caractere para a direita.
Exibe a janela de ajuda de teclas para o seu terminal.
Move o cursor para o mesmo item do registro anterior . Se o
cursor estiver em um item multi-line, [UP], apenas ir navegar
entre os caracteres do item.

Navegao
Veja a figura abaixo, alguns elementos que compe o esquema de navegao do Oracle
Forms(RunForm):

Excluso
Incluso
Pesquisa
As quatro operaes bsicas em Oracle Forms
Incluso

Excluso
Pesquisa

Alterao

Basta digitar [Create Record] ou navegar at o ultimo registro de um

bloco. Quando o cursor entra no bloco, o primeiro registro o ultimo
registro.
Digita-se [Delete Records]
Digitando-se [Enter Query], o form entra no mdulo de pesquisa,
chamado Query Mode, onde tudo o que for digitado interpretado
como parmetros de pesquisa. O usurio pode executar pesquisas
avanadas com o form no modo Query Mode, digitando & em
algum campo da tela. Para executar uma busca, digite [Execute
Query]
Basta modificar o valor dos campos recuperados em uma Query.

14

Quaisquer das operaes acima iniciam um processo de transao Oracle (Se este ainda no
existir). As operaes somente sero confirmadas no banco de dados quando o usurio
pressionar o boto save

Para abandonar o Oracle Forms(RunForm), pressione o boto sair

A Lista de Valores
Lista de valores um objeto que permite aos usurios a visualizao de todos os valores validos
para o campo, atravs de uma query(comando SELECT) no banco ou uma lista esttica. Para
acessar a lista, usa-se [List].
Consiste de uma janela dimensional onde aparecem valores vlidos de um campo e de uma
barra de rolagem, que permite a escolha do valor adequado para o item.

Campo de Pesquisa: Permite pesquisar registro com base nos valores da primeira coluna do
Record Group.
Digitando-se os caracteres iniciais do valor a ser encontrado;
Navegando at o campo Find, digitando a mascara e clicando o boto Find.

15

Editor de Textos
Para editar campos muito longos, o Oracle Forms permite o uso de um editor de textos. Para
acessar o editor, utiliza-se [Edit]

O editor consiste de uma janela dimensionvel com uma rea onde pode visualizar e editar
melhor o texto. No rodap da janela, existem botes para confirmar ou recusar alteraes feitas
no texto.

16

Transaes Oracle Gerenciadas Pelo Oracle Forms

Dentro do Oracle Forms, podem ser geradas transaes Oracle, de acordo com as operaes
realizadas com os dados na tela.
A figura abaixo ilustra melhor a gerao de transaes

Alteraes
Comandos DML eventuais durante a transao. Os
registros alterados durante a transao so
automaticamente travados no banco.

Inicio da Transao
Query for update,
Insero, alterao ou
Excluso de registros.

Fim da Transao
Commit ou Rollback
(clear Form). Neste
ponto, os registros
travados no banco so
liberados.

Dentro do Oracle Forms, se dois usurios alterarem o mesmo registro, o que alterou primeiro
conseguir travar o registro e executar a operao. Quando o segundo usurio tentar confirmar
(commit) a operao, ele receber uma mensagem informando que o registro foi alterado por
outro usurio.

17

INICIANDO O DESENVOLVIMENTO DE UMA APLICAO

Estrutura do Oracle Forms Designer
O desenvolvimento de programas(mdulos) em Oracle Forms Designer 6.0, feito utilizandose algumas ferramentas que permitem a edio e manipulao dos objetos implementados nos
programas. As ferramentas disponveis no Oracle Forms Designer so:
Object Navigator
O object navigator mostra os objetos de todos os mdulos abertos, de forma hierrquica. Por
exemplo, todas as windows definidas no mdulo form estaro subordinadas ao ttulo windows
no Object Navigator.
Os ttulos dos nveis mais elevados no Object Navigator formado por Forms, Menus,
Libraries, Built-in packages e Database Objects.
Com o object navigator possvel executar as seguintes operaes:
- Expandir e agrupar objetos para a sua localizao;
- Selecionar objetos;
- Copiar e Mover Objetos, inclusive entre mdulos
- Localizar objetos rapidamente utilizando o campo FIND;
- Visualizar rapidamente o cdigo fonte associado aos objetos trigger, procedures e funes.

18

Properties Windows
A janela de propriedades (property Palette) do Oracle Form Designer, onde ser possvel
definir as propriedades dos objetos existentes nos mdulos. Por Default, a janela do object
navigator est sincronizada com a janela de propriedades, isto , sempre que seleciona-se um
objeto no object navigator, a janela de propriedades apresenta as propriedades do objeto
selecionado.
Para ativar a janela de propriedades utilize a opo <Properties Palette...> do menu <Tools>, ou
com um duplo clique sobre o nome do objeto desejado no Object Navigator, ou ainda
pressionando a tecla F4.
Quando as informaes da propriedade so mais complexas aparece o boto more no cabealho
da janela.

19

Layout Editor
O Layout Editor uma interface grfica, que permite a visualizao, edio e distribuio dos
objetos no canvas-view. Por default, a janela do layout editor esta sincronizada com a janela do
object navigator e properties windows, desta forma, sempre que seleciona-se um objeto no
layout editor este objeto ser selecionado no object navigator e ter suas propriedades
apresentada na janela de propriedades.

20

PL/ SQL Editor

O PL/SQL editor um editor de texto que possibilita a programao e compilao do cdigo
fonte associado ao objeto. O cdigo dos objetos incluem triggers, funes, procedures,
packages e comandos de itens de menu.

21

Definindo um Mdulo
Definindo Propriedades de um Mdulo
A janela de propriedades mostra as informaes necessrias para a identificao do mdulo.
Possibilitando a definio e alterao dessas propriedades.
Principais propriedades dos Mdulos
Name

O nome do mdulo.

Coordinate
System

Define a unidade de
trabalho
do
mdulo
Forms. Que pode ser em
caracter ou real. Para real
a unidade pode ser Pixels,
centimeters, inch e poits.

First
Navigation
Data Block
Validation Unit A unidade de validao Mouse Navigation
padro entre Default, Limit
Form, Block, Record e
Item
Titulo que ser mostrado Menu Module
Title
no topo da janela do
objeto.

O nome do primeiro bloco

navegvel do form.
O escopo onde permitido
navegar com o mouse. Pode
ser Form, Block, Record e
Item.
Indica qual o mdulo do
tipo
menu
que
est
associado ao mdulo form
corrente.

22

Blocos
Blocos so objetos do Oracle Forms que tem a mesma funcionalidade que uma tabela do banco
de dados. O Oracle Forms permite a associao direta de um bloco a uma tabela do banco de
dados. Neste caso, as operaes sobre a tabela so associadas diretamente s operaes
realizadas no bloco.
Cada bloco pode conter vrios ou nenhum registro.
Cada registro deve conter pelo menos um item.
Propriedades de um bloco
Uma vez criado o bloco o refinamento feito utilizando a janela de propriedades e o Layout
Editor, do Oracle Forms Designer.

23

Principais Propriedades do Bloco

Name

O nome do bloco

Number of Records Quantidade mnima

de
registros
buffered
buferizados
na
memria
durante
uma query do bloco.

Show scroll bar

Indica se o bloco tem

ou no uma barra de
rolagem, pode ser
TRUE ou FALSE.

de
Number of Records Quantidade
registros visveis ao
displayed
mesmo tempo na
tela.
bloco
Next
Navigation Prximo
navegvel dentro do
data block
form.
Scroll
bar Especifica se o scroll
bar do bloco deve ser
orientation
mostrado
horizontalmente ou
verticalmente.
Define a clusula
Order by clause
order by padro para
consultas executadas
no bloco.

de
Maximum Records Quantidade
registros trazidas do
Fetched
banco
em
cada
leitura.
Insert,
Update, Indicam,
delete
e
Query respectivamente, que
os registros pode ser
allowed
criados, atualizados,
deletados
/ou
pesquisados
no
bloco.
Especifica em qual
Scroll bar canvas
canvas-view dever
aparecer a barra de
rolagem. Clicando o
flag horizontal, a
barra fica horizontal.
Record Orientation Permite exibir os
registros na direo
horizontal
ou
vertical.
Previous Navigation Bloco anterior na
seqncia
de
Data block
navegao form.
Define a clusula
Where clause
where padro para
consultas executadas
no bloco.

24

Barra MDI
Barras MDI so barras de ferramentas que sero utilizadas como default em uma janela pai.
Para editar uma barra MDI selecione Canvas-views e edit o objeto toolbar.

Figura: Edio da barra de ferramentas.

Figura: Layout grfico da barra de ferramentas

25

Layout Grfico
O layout grfico da tela pode ser visualizado com layout Editor do Oracle Forms Designer.

Figura: Janela do layout editor, mostrando as barras de ferramentas disponveis para criao,
edio e formatao dos objetos existentes no canvas.

26

Ferramentas de criao de Layout

Na barra de ferramentas vertical, do layout editor, esto disponveis as ferramentas para
criao, edio e formatao dos objetos do canvas.
Descrita de cima para baixo, as princiapsi ferramentas disponveis so:
Itens da esquerda
Selecionar objetos
Zoom in ou Zoom out do layout da tela
Desenhar retngulo
Desenhar elipse
Desenhar polgono
Desenhar retngulo de cantos arredondados
Criar label do tipo texto
Criar item do tipo button
Criar item do tipo radio button
Criar item do tipo image
Criar item do tipo OLE container
Criar item do tipo list item
Criar item do tipo rvore hierarquica

Itens da direita
Rotacionar objetos
Redefinir o plano de objetos de desenho
Desenhar linha
Desenhar arco
Desenhar linha polimrfica
Desenhar figura de desenho a mo livre
Criar item do tipo check box
Criar item do tipo text item
Criar item do tipo chart item
Criar item do tipo VBX control
Criar item do tipo display item
Criar item do tipo sound item
Criar item do tipo tab canvas

Na barra de ferramentas existem trs paletas de cores, apra definio da cores de fundo,
contorno e texto. Sta definio pode ser visualizada na rea definida logo acima destas paletas.
No rodap do layout editor existe uma linha de informaes adicionais, na qual pode-se
verificar o Zoom aplicado na visualizao, a posio absoluta do ponteiro do mouse no canvas, a
posio relativa de deslocamento, ngulo de rotao e tamanho dos objetos.
Com as ferramentas descritas, mas a paleta de cores da barra de ferramentas vertical possvel
selecionar, rotacionar, formatar cores de fundo, texto e contorno dos objetos no canvas.

27

Outras opes de formatao:

Quando utiliza-se o layout editor, aparece no menu principal, as opes Format e Arrange, que
tambm permitem a formatao de objetos selecionados no canvas.

Figura: Menu Format com as opes disponveis para formatao dos objetos.
Font
Justify
Text Spacing
Line width
Bevel
Dash
Arrow

Tipo de fonte
Tipo de alinhamento do texto
Espaamento entre linhas de texto
Espessura de linhas
Efeito alto/baixo relevo
Tipo de linha
Tipo de setas

Figura: Menu arrange com as opes disponveis para formatao dos objetos.

28

As principais opes de formao do menu Arrange:

Bring to front
Send to back
Move forward
Move backward
Align objects
Repeat alignment
Size objects
Repeat sizing
Group
Ungroup

Trazer para frente

Enviar para tras
Mover para frente
Mover para tras
Alinhar objetos
Repetir ultimo alinhamento
Tamanho objeto
Repetir ultimo tamanho
Agrupar objetos
Desagrupar objetos

29

Objetos
Trabalhando com objetos
Listas de valores
Listas de valores so janelas que permitem ao usurio visualizar os valores vlidos para um
item.
As listas de valores pode ser ativadas automaticamente ou pelo usurio quando necessrio.
Toda lista de valores est vinculada a um record group, sendo possvel criar vrias listas de
valores que utilizam o mesmo record group.
O record group automaticamente criado com o mesmo nome da lista de valores, utilizando o
SQL informado no Query text.
Aps a confirmao da lista de valores deve-se adequar, entre ouras, a propriedade column
mapping com valores aplicveis ao contexto, do mdulo. Normalmente os valores default da
propriedade column mapping no atendem plenamente as necessidades do desenvolvedor.

30

Uma vez definida a LOV utilizando-se a janela de propriedades deve-se vincular a LOV ao
item text. Para isto seleciona-se o item text no object navigator ou layout editor, e na janela de
propriedades altera-se o valor da propriedade LOV, para o nome da LOV correspondente.
Principais propriedades de uma LOV
Name

O nome da LOV

A posio na vertical
em que a LOV
aparecer na tela
Altura da janela da
Height
LOV
Automatic display Indica se a LOV deve
ser, ou no, exibida
automaticamene
quando o cursor entrar
no campo
Indica se o cursor deve
Automatic skip
ou no passar para o
prximo item quando
um valor da lista for
escolhido
Column mapping um grupo de
propriedades
que
identificam o tamanho,
o ttulo e o item de
retorno das colunas da
LOV.
Y position

X position

width

A
posio
na
horizontal em que a
LOV aparecer na tela
Largura da janela da
LOV

Ttulo da janela da
LOV
Automatic refresh Indica se a query do
record group associado
LOV deve ou no ser
executada toda vez que
a lista for aberta.
Tipo da lista. Pode ser
List type
record group, query ou
V2 style.
Title

Record group

Especfica o nome do
record group do qual
derivam os valores da
LOV.

31

Editores de texto

Figura: A janela de propriedades para definio do editor de texto.

Quando o item possui comprimento muito grande para aparecer na tela, o usurio muitas vezes
pode desejar ver o texto de uma forma mais agradvel. O Oracle Forms Designer permite que
se defina um editor de textos para a edio de campos muito grandes.
Para definir um editor personalizado, utiliza-se o object navigator aplicando os mesmos
procedimentos gerais para criao de objetos no Oracle Forms Designer.
Utilizando a janela de propriedades pode-se definir o editor de texto que melhor atenda as
necessidades do desenvolvedor.

32

Principais propriedades de um editor

Name

Nome do editor

Y position
Height

Posio vertical do editor Width

na tela.
Altura da janela do editor Title

Bottom title

Ttulo do rodap do editor Wrap style

Show vertical
scroll bar

Indica se uma barra de

rolagem vertical estar ou
no ressente no editor.

X position

Posio horizontal do editor

na tela.
Largura da janela do editor.
Ttulo para a janela do
editor.
Tipo de quebra da linha.
Pode ser Word, character ou
none.

33

Records groups
O records groups so os objetos que retornam um grupo de registros para serem visualizados
em lista de valores.
Como visto anteriormente a criao de uma lista de valores implica automaticamente na criao
de um record group, corresponde a query informada.
Nem sempre os record groups so criados a partir de lista de valores, podendo serem criados
diretamente pelo desenvolvedor, utilizando o object navigator, para posterior vinculo uma
lista de valores.
O record group pode ser um grupo de registros formado dos registros recuperados em uma
query, informada na rea indicada, ou por valores estticos, constantes, informado pleo
desenvolvedor, no momento da criao deste.

Figura: A janela para definio dos valores estticos do record groups.

O record group formado com base em query normalmente so aqueles criados automaticamente
a partir da criao de uma lista de valores, mas, nada impede que o desenvolvedor crie um
record group a partir de uma query para posterior associao uma lista de valores.
Quando o record group criado com valores estticos o Oracle Forms Designer abre uma outra
janela para que o desenvolvedor informe os valores que pertencero ao record group.

34

Itens
Trabalhando com itens
Itens do tipo texto
Os itens do tipo texto so aqueles onde o operador possui livre acesso a digitar quaisquer
caracteres. So representados por uma caixa onde o operador digita o contedo.
Pode-se criar itens do tipo texto atravs da janela object navigator, setando a propriedade type
do item para text item, ou usam-se, na janela de definio de canvas, a ferramenta:
A aparncia dos campos do tipo texto em um canvas , normalmente, a seguinte:

Principais propriedades dos itens tipo texto:

Name

O nome do item

Canvas

A posio do campo no Y position

canvas na horizontal
Largura do campo
Width
Height
O tipo de dados do item
Data type
Highest
allowed value
Lowest allowed Valor mximo para o Justification
contedo do campo
value
O relevo do item. Pode ser Initial value
Bevel
lowered (baixo), raised
(alto) ou none (sem
relevo)
Mensagem qe aparece na Maximum
Hint
barra
de
mensagens length
quando
o
usurio
pressiona [help] sobre o
item
Quantidade mxima de Copy
Query lenght
value
caracteres que podem ser from item
inseridos no item em
modo Enter query
Database item Indica que o item est Displayed
associado a uma coluna da
tabela (neste caso, o nome
do item deve ser o mesmo
da coluna)
X position

Nome do canvas onde o

item mostrado.
A posio do campo no
canvas na vertical.
Altura do campo
Valor mnimo para o
contedo do campo
O alinhamento do contedo
do campo
O valor que ser associado
ao campo quando ele for
criado
Quantidade mxima de
caracteres que podem ser
inseridos no item

Outro item do form do qual

o item corrente ir copiar o
valor
Indica que o item ser
exibido na tela.

35

Update allowed Indica que o item poder Display hint O valor true indica que a
ser atualizado
automatically mensagem contida na
propriedade
hint
ir
aparecer automaticamente
na tela.
Indica que os caracteres Keep cursor Indica que o cursor, ao
Secure
inseridos no item devem position
voltar ao item, deve ser
aparecer como asteriscos
colocado
na
mesma
(*)
posio em que estava
quando saiu.
Indica que o item faz parte
Insert allowed Indica que o item pode ser Primary key
criado dentro do registro
da chave primria da
tabela.
Indica que o item pode ser Query allowed Indica que o item pode
Enabled
acessado com o mouse e
servir de parmetro para
teclado
um query
O item possui um formato
Automatic skip Indica que o cursor ir Multi-line
automaticamente para o
que permite a edio
campo seguinte quando
simples de textos grandes
atingir o final do item
corrente
Indica que o Oracle Forms
Case restriction Indica que o parmetro Lock record
passado para uma query
deve tentar travar o registro
atravs do item no ser
no banco sempre que o
comparado em relao ao
item corrente for alterado
aspecto
maisculo/minsculo
Indica que o item no Keyboard
Indica que o item pode ser
Required
pode ser deixado em Navigable
navegvel pelo teclado
branco
permite Fixed lenght
Indica que o comprimento
Update only if Somente
atualizao
do
item
total do item deve ser
null
quando este for nulo
preenchido
Show Vertical Indica que, se o item for
multi-line, haver uma
scroll bar
barra de rolagem anexa a
ele.
Propriedades adicionais dos itens tipo texto
Case restriction Indica se os caracteres Format mask
inseridos no item sero
escoados em maisculas
ou minsculas.

A mscara de formato para

os itens, de acordo com
regras
definidas
pelo
Oracle.

36

Itens do tipo boto

Os itens do tipo boto so objetos que, se clicados com o mouse produzem uma determinada
ao.
Pode-se criar itens do tipo boto atravs da janela object navigator, setando a propriedade type
do item para button, ou usam-se, na janela de definio de canvas, a ferramenta:

A aparncia dos campos do tipo boto em um canvas , normalmente, a seguinte:

Figura: A janela de definio de itens, com type setado para button.

Principais propriedades dos itens tipo boto
Label

Especifica o label que ir Mouse

escrito dentro do boto.
navigate

Iconic

Indica que aparecer um

cone dentro do boto. O
cone deve ser especificado
na propriedade icon name

Indica que o foco ser

colocado sobre o boto
quando ele for clicado.

Itens do tipo caixa de verificao

Estes itens consistem de um quadrado que, se clicado, exibe um X em seu interior, indicando
que o item est ligado e, caso contrrio, o item se torna desligado. Portanto, estes itens
somente podem assumir 2 valores.
Pode-se criar itens do tipo caixa de verificao atravs da janela object navigator, setando a
propriedade type do item para check box, ou usam-se, na janela de definio de canvas, a
ferramenta:

A aparncia dos campos do tipo caixa de verificao em um canvas , normalmente, a seguinte:

Principais propriedades dos tens tipo check box

37

when Valor que o item vai Check

box Valor que o item vai assumir
assumir se for ligado mapping
of quando outro valor que no os
dois anteriores aparecerem em
other values
uma query.
Especifica o label que ir
Value
when Valor que o item vai Label
assumir
se
for
escrito ao lado do check box.
Unchecked
desligado
Value
Checked

Radio group e seus radio buttons

Radio group um item que representa vrios elementos mutuamente exclusivos, chamados
radio buttons. O usurio somente pode escolher um radio button entre os radio groups. Quando
ele escolhe um, os outros so automaticamente desligados.
Pode-se criar itens do tipo radio button atravs da janela object navigator, setando a
propriedade type do item para radio group, ou usam-se, na janela de definio de canvas, a
ferramenta:

Para cada radio group pode-se definir mais de um radio button.

A aparncia dos campos do tipo radio button em um canvas , normalmente, a seguinte:

Principais propriedades dos itens tipo radio group

Radio
value

button Os nomes dos radio

buttons
que
compem o radio
group.
Valor
associado ao radio
group se ele for
escolhido

Itens do tipo lista

Os itens do tipo lista so apresentados como uma caixa com uma seta do lado. Quando o
usurio clica a seta, uma lista com os valores possveis para o item so apresentadas e o
usurio pode escolher uma. As listas se classificam em pop-lists, quando a lista aparece com
um click, t-lists, quando eleas, por natureza, j vm abertas, e combo box, que so listas onde
qualquer contedo que no esteja na lista pode ser informado.

38

Pode-se criar itens do tipo lista atravs da janela object navigator, setando a propriedade type
do item para list, ou usam-se, na janela de definio de canvas, a ferramenta:

A aparncia dos campos do tipo list item para o estilo combo box em um canvas ,
normalmente, a seguinte:

A definio de cada valor assumido para cada item da lista definido atravs da propriedade
elements in list, que mostra a seguinte janela:

Principais propriedades dos tens tipo lista

List style

Indica se alista ser Mapping

of Indica o valor que ser assumido
uma pop-list, uma t-list Other values
se outro valor que no os
ou um combo box
especificados for encontrado em
uma query.

39

Adicionando cdigo ao Oracle Forms

Triggers
Triggers so pequenos trechos de cdigo que so executados de acordo com a ocorrncia de
alguns eventos especiais, como o pressionar de um boto, a validao de um campo, o
pressionar de uma tecla, a abertura de uma janela, e outras que veremos a diante.
Para definir triggers, no object navigator seleciona-se o ttulo trigger do nvel desejado e no
menu utiliza-se a opo navigator + create, em seguida aparecer a janela para escolha da
trigger desejada. Para selecionar a trigger digite as iniciais do nome da mesma que
automaticamente o Oracle Forms Designer mostrar na lista apenas as triggers, cujo nome,
tenha nas iniciais o digitado.

Figura: A janela para escolha de triggers.

Figura: A janela do PL/SQL editor para digitao do texto PL/SQL.

40

Aps a escolha da trigger o Oracle Forms Designer mostra o PL/SQL editor para o
desenvolvedor digitar verificar e compilar o texto PL/SQL da trigger.
O escopo de uma trigger define em que contexto da tela a trigger ser executada. Uma trigger
definida com escopo form ser executada em qualquer item de qualquer bloco do form. Uma
trigger com escopo block ser executada somente dentro do bloco especfico, e uma trigger
com escopo item ser executada somente para o item onde estiver o cursor. O escopo de uma
trigger tambm pode ser definido utilizando o campo object do PL/SQL editor.
Principais propriedades de uma trigger
Trigger style

A imensa maioria das Fire in enter query Indica se a trigger

triggers so do tipo mode
ser ou no ativada,
built-in
(prmesmo que o form
construdas), ou seja,
esteja em
query
so executadas em
mode.
eventos
padro
definidos pelo Oracle
Forms. Porm, o
usurio pode criar
suas
prprias
triggers, user-named.

41

Alterando propriedades
O Oracle Forms permite que sejam alteradas as propriedades de diversos objetos em tempo de
execuo utilizando comandos como por exemplo:
Set_item_property(name,enable,property_false);
Set_block_property(ord,update_allowed,property_true);
Set_form_property(exe0001,validation_unit,block_scope);

42

Alertas

Figura: a janela de propriedades para definio de alertas.

Alertas so janelas que aparecem no Oracle Forms e que exibem mensagens para o usurio,
possibilitando a ele tomar decises com base no pressionamento de, no mximo, 3 botes
disponveis.
Para definir um alerta usam-se a janela de propriedades do Oracle Forms Designer. Um alerta
pode ser criado selecionando-se o ttulo alert no object navigator e em seguida acionando-se o
menu navigator + create.

43

Principais propriedades de um alerta

Name

Nome do alerta

Button1 label

Label do boto 1 que

ir aparecer na janela
do alerta
Label do boto 3 que
ir aparecer na janela
do alerta.

Button3 label

Message

A mensagem que
ser exibida na tela
do alerta.

cone
que
ir
aparecer dentro da
janela do alerta,
indicando erro, aviso
ou informao.
Label do boto 2 que
Button2 label
ir aparecer na janela
do alerta.
Default alert button Qual dos botes ser
acionado
automaticamente se o
usurio
pressionar
[enter] na janela.
Especifica o ttulo
Title
que ser mostrado
para o alerta.
Alert style

44

A estrutura de pginas do Oracle Forms

Janelas e Canvas
As janelas (windows) so como molduras que podem ser livremente movimentadas atravs da
tela. Estes objetos emolduram uma ou mais pginas da tela, que so chamadas de Canvas.
Janelas
Uma janela pode ser criada usando-se o object navigator, com a seleo do ttulo Windows e
acionando-se o menu navigator + create. Na janela de propriedades define-se as propriedades a
critrio do desenvolvedor.
Principais propriedades de uma janela
Nome da janela
Name
Title
Primary canvas Nome do canvas que ser Window style
colocado no fundo da
janela

O nome do arquivo que

contem o desenho do
cones a ser exibido
quando a janela for
minimizada.
Show Vertical Indica se a janela ter ou
no barra de rolagem
scroll bar
vertical.
Indica se o menu da janela
Inherit menu
anterior ser ou no
associado nova janela
quando a mesma for
aberta.
Icon filename

Modal

Show
Horizontal
scroll bar

Ttulo da janela
O estilo da janela. Ode ser
document ou dialog. O
Oracle
Forms
cria
automaticamente a janela
root_window, que modal.
Indica se a janela pode ou
no ser fechada seno por
um comando da prpria
janela.
Indica se a janela ter barra
de rolagem horizontal.

45

Canvas
Para criar-se um canvas-view pode-se selecionar o ttulo Canvas-View no object navigator e
em seguida aciona-se o menu Navigator + create. Na janela de propriedades define-se as
propriedades conforme necessidades.
Principais propriedades dos canvas
Name

O nome do canvas

Window

Raise on entry Indica se o canvas-view Canvas type

sempre vir ou no, para a
frente quando o cursor
mudar de canvas-view

Identifica a janela onde o

canvas-view ir aparecer.
Identifica o tipo de canvasview e como este ser
mostrado na janela.

46

Variveis de ambiente
So variveis que informam sobre o atual estado do Oracle Forms.
SYSTEM.BLOCK_STATUS

SYSTEM.CURRENT_BLOCK
SYSTEM.CURRENT_FORM
SYSTEM.CURRENT_ITEM
SYSTEM.CURRENT_VALUE
SYSTEM.CURSOR_BLOCK
SYSTEM.CURSOR_ITEM
SYSTEM.CURSOR_RECORD
SYSTEM.CURSOR_VALUE
SYSTEM.FORM_STATUS

SYSTEM.LAST_QUERY
SYSTEM.LAST_RECORD
SYSTEM.MESSAGE_LEVEL

SYSTEM.MODE

SYSTEM.RECORD_STATUS

Representa o estado do bloco onde o cursor est locado:

change: o bloco contm pelo menos um registro alterado;
new: indica que o bloco contm somente registros novos;
query: indica que o bloco contem somente registros que
contm no banco de dados;
Contm o nome do bloco que o Oracle Forms est
processando
Contm o nome do form que est sendo executado no
momento
Contm o nome do item que o Oracle Forms est no
momento.
Contm
o
valor
do
item
registrado
em
SYSTEM.CURRENT_ITEM
Guarda o nome do bloco onde est o cursor
Assume o nome do item onde est o cursor
Representa o nmero do registro onde est o cursor
Representa o valor do item onde o cursor est locado
Representa o estado corrente do form: change: o form
contm pelo menos um registro alterado; new: indica que
o form contm somente registros novos; query: indica
que o form contm somente registros que contm no
banco de dados.
Contm o comando SELECT usado para executar a
ltima query do forms.
Retorna TRUE se o cursosr estiver no ltimo registro do
bloco. Caso contrario, retorna FALSE.
Uma das variveis de sistema que pode ser alterado pelo
usurio. Ela indica o nvel das mensagens que sero
exibidas na tela.
Armazena o modo corrente em que o form est: normal:
indica que o form est em modo de processamento
normal; enter-query: indica que o form est em modo de
query; query: indica que o form est trazendo os registros
do banco, significando que uma query est sendo
processada.
Armazena o estado corrente do registro: changed: o form
contm pelo menos um registro alterado que foi trazido
do banco; new: indica que o form contm somente
registros novos; query: indica que o form contm
somente registros que contm no banco de dados; insert:
indica que o registro corrente no existe no banco.

47

SYSTEM.SUPRESS_WORKING Outra varivel do Oracle Forms que pode ser alterada:

true: indica que a mensagem working deve aparecer no
rodap da tela quando o Oracle Forms estiver
processando; false: a mensagem no ir aparecer na tela.
SYSTEM.TRIGGER_BLOCK
O nome do bloco onde o cursor estava quando a trigger
foi inicializada
SYSTEM.TRIGGER_ITEM
O nome do item onde o cursor estava quando a trigger
foi inicializada
SYSTEM.TRIGGER_RECORD O nmero do registro que a trigger corrente est
processando.