UNIVERSIDADE DO SUL DE SANTA CATARINA – UNISULPROF. EDSON THIZON

EDUCAÇÃO ORACLE

Oracle Forms DesignerPar te 5

Forms Builder

1

OPERAÇÕES BÁSICAS

Acessando Oracle Forms Designer

Abr indo o Oracle Forms Designer

Duplo – Clique no ícone do Oracle Forms 6;

Escolher a opção Arquivo/Executar no menu principal do Windows: Na caixa de diálogo digitea linha de comando: c:\<ORACLE_HOME>\bin\ifbld60.exe. Onde <ORACLE_HOME> é o diretórioraiz do Oracle.

2

Conectando-se ao Banco de Dados Oracle

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

Na janela de conexão , Digitar um usuário e senha Oracle válidos;

Pressionar o botão Connect.

3

Abandonando o Oracle Forms Designer

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

Duplo-Clique no botão de controle no canto superior esquerdo da janela;Pressione <Alt + F4>.

Exercício 1

Entre no Oracle Forms Designer usando as diversas formas aprendidas. Depois, conecte-se aobanco e abandone o form, usando as diversas opções vistas.

4

Gerenciamento de Módulos

Formatos de Arquivos de Módulo.

Módulos são componentes gerenciados pelo Oracle Forms 6. Um conjunto de um ou maismódulos com mesmo objetivo de uma aplicação.Veja abaixo a tabela dos diversos tipos de módulos e seus arquivos correspondentes:

Módulo Arquivos GeradosForm(Telas) .FMB: Arquivo fonte binário de uma tela:

.FMX: Arquivo executável binário de uma tela.

.FMT: Arquivo texto ASCII correspondente a uma tela.Menus .MMB: Arquivo fonte binário de um menu;

.MMX: Arquivo executável binário de um menu;

.MMT: Arquivo texto ASCII correspondente a um menu.Libraries(Bibliotecas) .PLL: Arquivo fonte binário de uma Biblioteca;

.LIB: Arquivo executável de uma Biblioteca;

.PLD: Arquivo texto ASCII correspondente a uma Biblioteca.

Acesso à Módulos.

Os módulos do Oracle Forms podem ser acessados tanto no diretório de seu disco, através dearquivos, como no banco de dados Oracle ao qual o Oracle Forms está conectado.Veja abaixo o esquema de funcionamento do acesso a módulos no Oracle Forms:

Para se efetuar o salvamento ou leitura de módulos o Oracle Forms precisa saber onde ler egravar o referido módulo. O Oracle Forms permite a leitura e gravação dos módulos nos

Banco deDadosOracle

Diretório

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

5

diretórios do seu disco, em formatos de arquivos, ou no banco de dados Oracle. Isto pode serdefinido pelo desenvolvedor na tela Preferences do Oracle Forms Designer.

6

Abr indo um Módulo

Quando o Oracle Forms Designer é carregado, ele automaticamente cria um novo módulo,normalmente chamado module 1.Para abrir outro módulo, utiliza-se o comando File/Open do menu o Oracle Forms, oupressionando-se <CTRL> + O;

7

Salvando um Módulo.

Os módulos podem ser salvos tanto no diretório quanto no banco de dados.Para alterar o nome ou o local de armazenamento de um módulo posteriormente, use ocomando File/Save As.

Se, dentro da janela de filtro, for escolhido destino Database, aparecerá uma janela específicapara salvamento de módulos de banco de dados.

8

Outras Operações com Módulos.

A tabela abaixo exibe outras operações, menos utilizadas, que podem ser realizadas com osmódulos.

Operação Comando DescriçãoExcluir Módulos. File/Administration/Delete Exclui um módulo que foi

previamente gravado no banco dedados. Para excluir módulos queforam gravados no diretório, utilizecomandos específicos do sistemaoperacional.

Renomear Módulos File/Administration/Rename Renomeia um módulo que foipreviamente gravado no banco dedados. Para renomear módulos queforam gravados no diretório, utilizecomandos específicos do sistemaoperacional.

Reverter o módulopara a última versãosalva.

File/Revert Carrega a ultima versão do módulosalva, no banco de dados,desconsiderando a versão atual.

Convertendo um Modulo para o Formato Texto ASCI I

Os arquivos fonte do Oracle Forms, com extensão FMB, são gravados em formato binário,portanto, de difícil leitura. Para criar uma versão texto (FMT) de um arquivo fonte do OracleForms, use o comando File/Administration/Convert.

A janela de conversão de arquivos irá aparecer:

9

Basta digitar o nome do arquivo FMB a ser convertido e clicar no botão Convert. O OracleForms irá gerar um arquivo FMT, do tipo ASCII.

O Oracle Forms Designer não consegue abrir arquivos FMT. Portanto, antes de abrir um destesarquivos, converta-o para o formato FMB, usando o comando File/Administration/Convert ealterando o Direction para Text-to-Binary.

Gerando um Modulo para Execução

Antes que os módulos possam ser executados, e, portanto, utilizados pelos usuários, eles devempassar por um processo que se chama Geração. Durante a geração, o código é compilado e omódulo é validado e preparado para ser executado através do componente RunForm, do OracleForms.Quando um módulo é gerado, ele sempre cria um arquivo FMX, com o mesmo nome domódulo. Este arquivo não pode ser executado sem o auxilio RunForm.

Para gerar um módulo, pode-se utilizar o comando File/Administration/Object List Report

Executando um Modulo previamente Gerado

Para executar um módulo que já foi gerado, utilize o comando Program/Run Form/ClientServer:

O comando File/Run na verdade, apenas realiza uma chamada ao Run/ Form, que executa oarquivo FMX correspondente ao módulo gerado.

10

Fechando um Modulo

Para fechar um módulo aberto, utiliza-se o comando File/Close do menu Oracle FormsDesigner, ou pressiona-se <Ctrl> + W.

Exercício 2

1 – Entre no Oracle Forms Designer, connecte-se ao banco e abra, do seu diretório, o formPEDIDOS.2 – Salve o form PEDIDOS no banco de dados, usando seu usuário.3 – Converta o form para texto ASCII e verifique o arquivo gerado.4 – Renomeie o Forms PEDIDO, no banco, para o nome de seu usuário Oracle.5 – Finalmente exclua o form do banco de dados e salve – o novamente no diretório.6 – Faça a geração e a execução do form PEDIDOS.

11

Operando uma Aplicação no Oracle Forms

Este capítulo nos dará uma idéia de como o usuário final irá trabalhar em uma aplicaçãodesenvolvida em Oracle Forms Designer. Para estudar este capítulo, por favor faça o últimoexercício da lição anterior.

Barra de Status

A barra de status é uma área, no rodapé da tela onde o usuário pode verificar o estado de suaaplicação e receber mensagens de aviso ou de erro.

Local destinado as mensagens de aviso ou de erro.

Indica que uma lista de valores está disponível para o item. Indica que o Forms está em modo de pesquisa.

Exibe o número de registros recuperados e exibidos da última pesquisa.

Esta área esta dividida em duas linhas:- Linha de mensagens: Onde são exibidas todas as mensagens necessárias;- Linha de Status: Onde aparece as informações sobre a tela.

A janela de Ajuda de Teclas

Dentro do Oracle Forms, todas as funções são executadas através de teclas específicas;Para saber quais teclas executam quais funções, usam-se a tecla [Show Keys] ou ctrl+F1, ou ocomando Help/keys no menu.

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

12

Figura: Janela de ajuda de teclas.

Algumas Teclas de Funções Comuns

[Cancel/Exit] Cancela a operação corrente;[Commit/Accept] Executa no banco de dados todas as alterações feitas na tela

desde o último [Commit] ou [Rollback];[Down] Move o cursor para o próximo 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 próximoregistro for um novo registro, o cursor é colocado no primeiroitem do registro.

[Edit] Exibe uma janela onde o usuário pode digitar textos muito longopara um determinado item.

[Enter Query] Limpa o bloco corrente e permite ao operador inserir critérios debusca para acesso ao banco de dados.

[Execute Query] Limpa o bloco corrente e recupera do banco de dados todos osregistros referenciados pelo bloco.

[Help] Exibe uma breve mensagem (Hint) para o item na linha demensagens. Se alguma mensagem já estiver lá, será ativada umajanela com informações adicionais.

[Left] Move o cursor um caractere para a esquerda.[List] Ativa a lista de valores, se houver alguma disponível no item

corrente.[Menu] Ativa o menu, se houver algum disponível.[Next Block] Move o cursor para o próximo bloco que contenha pelo menos

um item com a propriedade insert habilitada. A seqüênciacampos pode ser definida pelo desenvolvedor.

13

[Next Item] Move o cursor para o próximo item do registro correnteconforme seqüência estabelecida pelo desenvolvedor.

[Next Record] Move o cursor para o próximo registro no bloco corrente, se nãohouverem mais registros, um novo registro é criado.

[Previous Block] Move o cursor para o bloco anterior que contenha pelo menosum item com a propriedade insert habilitada.

[Previous Item] Move o cursor para o item anterior dentro do registro corrente,conforme seqüência estabelecida pelo desenvolvedor.

[Previous Record] Move o cursor para o registro anterior dentro do bloco corrente.[Right] Move o cursor um caractere para a direita.[Show Keys] Exibe a janela de ajuda de teclas para o seu terminal.[UP] Move o cursor para o mesmo item do registro anterior . Se o

cursor estiver em um item multi-line, [UP], apenas irá navegarentre os caracteres do item.

Navegação

Veja a figura abaixo, alguns elementos que compõe o esquema de navegação do OracleForms(RunForm):

ExclusãoInclusãoPesquisa

As quatro operações básicas em Oracle Forms

Inclusão Basta digitar [Create Record] ou navegar até o ultimo registro de umbloco. Quando o cursor entra no bloco, o primeiro registro é o ultimoregistro.

Exclusão Digita-se [Delete Records]Pesquisa Digitando-se [Enter Query], o form entra no módulo de pesquisa,

chamado Query Mode, onde tudo o que for digitado é interpretadocomo parâmetros de pesquisa. O usuário pode executar pesquisasavançadas com o form no modo Query Mode, digitando ‘& ’ emalgum campo da tela. Para executar uma busca, digite [ExecuteQuery]

Alteração Basta modificar o valor dos campos recuperados em uma Query.

14

Quaisquer das operações acima iniciam um processo de transação Oracle (Se este ainda nãoexistir). As operações somente serão confirmadas no banco de dados quando o usuário

pressionar o botão save .

Para abandonar o Oracle Forms(RunForm), pressione o botão sair .

A L ista de Valores

Lista de valores é um objeto que permite aos usuários a visualização de todos os valores validospara o campo, através de uma query(comando SELECT) no banco ou uma lista estática. Paraacessar a lista, usa-se [List].Consiste de uma janela dimensional onde aparecem valores válidos de um campo e de umabarra 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 doRecord Group.Digitando-se os caracteres iniciais do valor a ser encontrado;Navegando até o campo Find, digitando a mascara e clicando o botão 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 dimensionável com uma área onde pode visualizar e editarmelhor o texto. No rodapé da janela, existem botões para confirmar ou recusar alterações feitasno texto.

16

Transações Oracle Gerenciadas Pelo Oracle Forms

Dentro do Oracle Forms, podem ser geradas transações Oracle, de acordo com as operaçõesrealizadas com os dados na tela.

A figura abaixo ilustra melhor a geração de transações

Dentro do Oracle Forms, se dois usuários alterarem o mesmo registro, o que alterou primeiroconseguirá travar o registro e executar a operação. Quando o segundo usuário tentar confirmar(commit) a operação, ele receberá uma mensagem informando que o registro foi alterado poroutro usuário.

AlteraçõesComandos DML eventuais durante a transação. Osregistros alterados durante a transação sãoautomaticamente travados no banco.

Inicio da TransaçãoQuery for update,Inserção, alteração ouExclusão de registros.

Fim da TransaçãoCommit ou Rollback(clear Form). Nesteponto, os registrostravados no banco sãoliberados.

17

INICIANDO O DESENVOLVIMENTO DE UMA APLICAÇÃO

Estrutura do Oracle Forms Designer

O desenvolvimento de programas(módulos) em Oracle Forms Designer 6.0, é feito utilizando-se algumas ferramentas que permitem a edição e manipulação dos objetos implementados nosprogramas. As ferramentas disponíveis no Oracle Forms Designer são:

Object Navigator

O object navigator mostra os objetos de todos os módulos abertos, de forma hierárquica. Porexemplo, todas as windows definidas no módulo form estarão subordinadas ao título windowsno Object Navigator.Os títulos dos níveis mais elevados no Object Navigator é formado por Forms, Menus,Libraries, Built-in packages e Database Objects.Com o object navigator é possível executar as seguintes operações:- Expandir e agrupar objetos para a sua localização;- Selecionar objetos;- Copiar e Mover Objetos, inclusive entre módulos- Localizar objetos rapidamente utilizando o campo FIND;- Visualizar rapidamente o código fonte associado aos objetos trigger, procedures e funções.

18

Properties Windows

A janela de propriedades (property Palette) do Oracle Form Designer, é onde será possíveldefinir as propriedades dos objetos existentes nos módulos. Por Default, a janela do objectnavigator está sincronizada com a janela de propriedades, isto é, sempre que seleciona-se umobjeto no object navigator, a janela de propriedades apresenta as propriedades do objetoselecionado.Para ativar a janela de propriedades utilize a opção <Properties Palette...> do menu <Tools>, oucom um duplo clique sobre o nome do objeto desejado no Object Navigator, ou aindapressionando a tecla F4.Quando as informações da propriedade são mais complexas aparece o botão more no cabeçalhoda janela.

19

Layout Editor

O Layout Editor é uma interface gráfica, que permite a visualização, edição e distribuição dosobjetos no canvas-view. Por default, a janela do layout editor esta sincronizada com a janela doobject navigator e properties windows, desta forma, sempre que seleciona-se um objeto nolayout editor este objeto será selecionado no object navigator e terá suas propriedadesapresentada na janela de propriedades.

20

PL/ SQL Editor

O PL/SQL editor é um editor de texto que possibilita a programação e compilação do códigofonte associado ao objeto. O código dos objetos incluem triggers, funções, procedures,packages e comandos de itens de menu.

21

Definindo um Módulo

Definindo Propriedades de um Módulo

A janela de propriedades mostra as informações necessárias para a identificação do módulo.Possibilitando a definição e alteração dessas propriedades.

Principais propriedades dos Módulos

Name O nome do módulo. First NavigationData Block

O nome do primeiro bloconavegável do form.

Validation Unit A unidade de validaçãopadrão entre Default,Form, Block, Record eItem

Mouse NavigationL imit

O escopo onde é permitidonavegar com o mouse. Podeser Form, Block, Record eItem.

Title Titulo que será mostradono topo da janela doobjeto.

Menu Module Indica qual o módulo dotipo menu que estáassociado ao módulo formcorrente.

CoordinateSystem

Define a unidade detrabalho do móduloForms. Que pode ser emcaracter ou real. Para reala unidade pode ser Pixels,centimeters, inch e poits.

22

Blocos

Blocos são objetos do Oracle Forms que tem a mesma funcionalidade que uma tabela do bancode dados. O Oracle Forms permite a associação direta de um bloco a uma tabela do banco dedados. Neste caso, as operações sobre a tabela são associadas diretamente às operaçõesrealizadas no bloco.

Cada bloco pode conter vários ou nenhum registro.

Cada registro deve conter pelo menos um item.

Propr iedades de um bloco

Uma vez criado o bloco o refinamento é feito utilizando a janela de propriedades e o LayoutEditor, do Oracle Forms Designer.

23

Principais Propr iedades do Bloco

Name O nome do bloco Maximum RecordsFetched

Quantidade deregistros trazidas dobanco em cadaleitura.

Number of Recordsbuffered

Quantidade mínimade registrosbuferizados namemória duranteuma query do bloco.

Inser t, Update,delete e Queryallowed

Indicam,respectivamente, queos registros pode sercriados, atualizados,deletados /oupesquisados nobloco.

Show scroll bar Indica se o bloco temou não uma barra derolagem, pode serTRUE ou FALSE.

Scroll bar canvas Especifica em qualcanvas-view deveráaparecer a barra derolagem. Clicando oflag horizontal, abarra fica horizontal.

Number of Recordsdisplayed

Quantidade deregistros visíveis aomesmo tempo natela.

Record Or ientation Permite exibir osregistros na direçãohorizontal ouvertical.

Next Navigationdata block

Próximo bloconavegável dentro doform.

Previous NavigationData block

Bloco anterior naseqüência denavegação form.

Scroll baror ientation

Especifica se o scrollbar do bloco deve sermostradohorizontalmente ouverticalmente.

Where clause Define a cláusulawhere padrão paraconsultas executadasno bloco.

Order by clause Define a cláusulaorder by padrão paraconsultas executadasno bloco.

24

Barra MDI

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

Figura: Edição da barra de ferramentas.

Figura: Layout gráfico da barra de ferramentas

25

Layout Gráfico

O layout gráfico da tela pode ser visualizado com layout Editor do Oracle Forms Designer.

Figura: Janela do layout editor, mostrando as barras de ferramentas disponíveis para criação,edição e formatação dos objetos existentes no canvas.

26

Ferramentas de criação de Layout

Na barra de ferramentas vertical, do layout editor, estão disponíveis as ferramentas paracriação, edição e formatação dos objetos do canvas.

Descrita de cima para baixo, as princiapsi ferramentas disponíveis são:

Itens da esquerda Itens da direitaSelecionar objetos Rotacionar objetosZoom in ou Zoom out do layout da tela Redefinir o plano de objetos de desenhoDesenhar retângulo Desenhar linhaDesenhar elipse Desenhar arcoDesenhar polígono Desenhar linha polimórficaDesenhar retângulo de cantos arredondados Desenhar figura de desenho a mão livreCriar label do tipo texto Criar item do tipo check boxCriar item do tipo button Criar item do tipo text itemCriar item do tipo radio button Criar item do tipo chart itemCriar item do tipo image Criar item do tipo VBX controlCriar item do tipo OLE container Criar item do tipo display itemCriar item do tipo list item Criar item do tipo sound itemCriar item do tipo árvore hierarquica Criar item do tipo tab canvas

Na barra de ferramentas existem três paletas de cores, apra definição da cores de fundo,contorno e texto. Sta definição pode ser visualizada na área definida logo acima destas paletas.

No rodapé do layout editor existe uma linha de informações adicionais, na qual pode-severificar o Zoom aplicado na visualização, a posião absoluta do ponteiro do mouse no canvas, aposição relativa de deslocamento, ângulo de rotação e tamanho dos objetos.

Com as ferramentas descritas, mas a paleta de cores da barra de ferramentas vertical é possívelselecionar, rotacionar, formatar cores de fundo, texto e contorno dos objetos no canvas.

27

Outras opções de formatação:

Quando utiliza-se o layout editor, aparece no menu principal, as opções Format e Arrange, quetambém permitem a formatação de objetos selecionados no canvas.

Figura: Menu Format com as opções disponíveis para formatação dos objetos.

Font Tipo de fonteJustify Tipo de alinhamento do textoText Spacing Espaçamento entre linhas de textoLine width Espessura de linhasBevel Efeito alto/baixo relevoDash Tipo de linhaArrow Tipo de setas

Figura: Menu arrange com as opções disponíveis para formatação dos objetos.

28

As principais opções de formação do menu Arrange:

Bring to front Trazer para frenteSend to back Enviar para trasMove forward Mover para frenteMove backward Mover para trasAlign objects Alinhar objetosRepeat alignment Repetir ultimo alinhamentoSize objects Tamanho objetoRepeat sizing Repetir ultimo tamanhoGroup Agrupar objetosUngroup Desagrupar objetos

29

Objetos

Trabalhando com objetos

Listas de valores

Listas de valores são janelas que permitem ao usuário visualizar os valores válidos para umitem.

As listas de valores pode ser ativadas automaticamente ou pelo usuário quando necessário.

Toda lista de valores está vinculada a um record group, sendo possível criar várias listas devalores que utilizam o mesmo record group.

O record group é automaticamente criado com o mesmo nome da lista de valores, utilizando oSQL informado no Query text.

Após a confirmação da lista de valores deve-se adequar, entre ouras, a propriedade columnmapping com valores aplicáveis ao contexto, do módulo. Normalmente os valores default dapropriedade column mapping não atendem plenamente as necessidades do desenvolvedor.

30

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

Principais propriedades de uma LOV

Name O nome da LOV X position A posição nahorizontal em que aLOV aparecerá na tela

Y position A posição na verticalem que a LOVaparecerá na tela

width Largura da janela daLOV

Height Altura da janela daLOV

Title Título da janela daLOV

Automatic display Indica se a LOV deveser, ou não, exibidaautomaticamenequando o cursor entrarno campo

Automatic refresh Indica se a query dorecord group associadoá LOV deve ou não serexecutada toda vez quea lista for aberta.

Automatic skip Indica se o cursor deveou não passar para opróximo item quandoum valor da lista forescolhido

List type Tipo da lista. Pode serrecord group, query ouV2 style.

Column mapping É um grupo depropriedades queidentificam o tamanho,o título e o item deretorno das colunas daLOV.

Record group Específica o nome dorecord group do qualderivam os valores daLOV.

31

Editores de texto

Figura: A janela de propriedades para definição do editor de texto.

Quando o item possui comprimento muito grande para aparecer na tela, o usuário muitas vezespode desejar ver o texto de uma forma mais agradável. O Oracle Forms Designer permite quese defina um editor de textos para a edição de campos muito grandes.

Para definir um editor personalizado, utiliza-se o object navigator aplicando os mesmosprocedimentos gerais para criação de objetos no Oracle Forms Designer.

Utilizando a janela de propriedades pode-se definir o editor de texto que melhor atenda asnecessidades do desenvolvedor.

32

Principais propr iedades de um editor

Name Nome do editor X position Posição horizontal do editorna tela.

Y position Posição vertical do editorna tela.

Width Largura da janela do editor.

Height Altura da janela do editor Title Título para a janela doeditor.

Bottom title Título do rodapé do editor Wrap style Tipo de quebra da linha.Pode ser Word, character ounone.

Show ver ticalscroll bar

Indica se uma barra derolagem vertical estará ounão ressente no editor.

33

Records groups

O records groups são os objetos que retornam um grupo de registros para serem visualizadosem lista de valores.

Como visto anteriormente a criação de uma lista de valores implica automaticamente na criaçãode um record group, corresponde a query informada.

Nem sempre os record groups são criados a partir de lista de valores, podendo serem criadosdiretamente pelo desenvolvedor, utilizando o object navigator, para posterior vinculo á umalista de valores.

O record group pode ser um grupo de registros formado dos registros recuperados em umaquery, informada na área indicada, ou por valores estáticos, constantes, informado pleodesenvolvedor, no momento da criação deste.

Figura: A janela para definição dos valores estáticos do record groups.

O record group formado com base em query normalmente são aqueles criados automaticamentea partir da criação de uma lista de valores, mas, nada impede que o desenvolvedor crie umrecord group a partir de uma query para posterior associação á uma lista de valores.

Quando o record group é criado com valores estáticos o Oracle Forms Designer abre uma outrajanela para que o desenvolvedor informe os valores que pertencerão ao record group.

34

I tens

Trabalhando com itens

I tens do tipo texto

Os itens do tipo texto são aqueles onde o operador possui livre acesso a digitar quaisquercaracteres. São representados por uma caixa onde o operador digita o conteúdo.Pode-se criar itens do tipo texto através da janela object navigator, setando a propriedade type

do item para text item, ou usam-se, na janela de definição de canvas, a ferramenta:

A aparência dos campos do tipo texto em um canvas é, normalmente, a seguinte:

Principais propriedades dos itens tipo texto:

Name O nome do item Canvas Nome do canvas onde oitem é mostrado.

X position A posição do campo nocanvas na horizontal

Y position A posição do campo nocanvas na vertical.

Width Largura do campo Height Altura do campoData type O tipo de dados do item Highest

allowed valueValor mínimo para oconteúdo do campo

Lowest allowedvalue

Valor máximo para oconteúdo do campo

Justification O alinhamento do conteúdodo campo

Bevel O relevo do item. Pode serlowered (baixo), raised(alto) ou none (semrelevo)

Initial value O valor que será associadoao campo quando ele forcriado

Hint Mensagem qe aparece nabarra de mensagensquando o usuáriopressiona [help] sobre oitem

Maximumlength

Quantidade máxima decaracteres que podem serinseridos no item

Query lenght Quantidade máxima decaracteres que podem serinseridos no item emmodo Enter query

Copy valuefrom item

Outro item do form do qualo item corrente irá copiar ovalor

Database item Indica que o item estáassociado a uma coluna databela (neste caso, o nomedo item deve ser o mesmoda coluna)

Displayed Indica que o item seráexibido na tela.

35

Update allowed Indica que o item poderáser atualizado

Display hintautomatically

O valor true indica que amensagem contida napropriedade hint iráaparecer automaticamentena tela.

Secure Indica que os caracteresinseridos no item devemaparecer como asteriscos(* )

Keep cursorposition

Indica que o cursor, aovoltar ao item, deve sercolocado na mesmaposição em que estavaquando saiu.

Inser t allowed Indica que o item pode sercriado dentro do registro

Primary key Indica que o item faz parteda chave primária databela.

Enabled Indica que o item pode seracessado com o mouse eteclado

Query allowed Indica que o item podeservir de parâmetro paraum query

Automatic skip Indica que o cursor iráautomaticamente para ocampo seguinte quandoatingir o final do itemcorrente

Multi-line O item possui um formatoque permite a ediçãosimples de textos grandes

Case restr iction Indica que o parâmetropassado para uma queryatravés do item não serácomparado em relação aoaspectomaiúsculo/minúsculo

Lock record Indica que o Oracle Formsdeve tentar travar o registrono banco sempre que oitem corrente for alterado

Required Indica que o item nãopode ser deixado embranco

KeyboardNavigable

Indica que o item pode sernavegável pelo teclado

Update only ifnull

Somente permiteatualização do itemquando este for nulo

Fixed lenght Indica que o comprimentototal do item deve serpreenchido

Show Verticalscroll bar

Indica que, se o item formulti-line, haverá umabarra de rolagem anexa aele.

Propriedades adicionais dos itens tipo texto

Case restr iction Indica se os caracteresinseridos no item serãoescoados em maiúsculasou minúsculas.

Format mask A máscara de formato paraos itens, de acordo comregras definidas peloOracle.

36

I tens do tipo botão

Os itens do tipo botão são objetos que, se clicados com o mouse produzem uma determinadaação.

Pode-se criar itens do tipo botão através da janela object navigator, setando a propriedade typedo item para button, ou usam-se, na janela de definição de canvas, a ferramenta:

A aparência dos campos do tipo botão em um canvas é, normalmente, a seguinte:

Figura: A janela de definição de itens, com type setado para button.

Principais propriedades dos itens tipo botão

Label Especifica o label que iráescrito dentro do botão.

Mousenavigate

Indica que o foco serácolocado sobre o botãoquando ele for clicado.

Iconic Indica que aparecerá umícone dentro do botão. Oícone deve ser especificadona propriedade icon name

I tens do tipo caixa de verificação

Estes itens consistem de um quadrado que, se clicado, exibe um ‘X’ em seu interior, indicandoque o item está ‘ ligado’ e, caso contrário, o item se torna ‘desligado’ . Portanto, estes itenssomente podem assumir 2 valores.

Pode-se criar itens do tipo caixa de verificação através da janela object navigator, setando apropriedade type do item para check box, ou usam-se, na janela de definição de canvas, aferramenta:

A aparência dos campos do tipo caixa de verificação em um canvas é, normalmente, a seguinte:

Principais propriedades dos ítens tipo check box

37

Value whenChecked

Valor que o item vaiassumir se for ligado

Check boxmapping ofother values

Valor que o item vai assumirquando outro valor que não osdois anteriores aparecerem emuma query.

Value whenUnchecked

Valor que o item vaiassumir se fordesligado

Label Especifica o label que iráescrito ao lado do check box.

Radio group e seus radio buttons

Radio group é um item que representa vários elementos mutuamente exclusivos, chamadosradio buttons. O usuário somente pode escolher um radio button entre os radio groups. Quandoele escolhe um, os outros são automaticamente desligados.

Pode-se criar itens do tipo radio button através da janela object navigator, setando apropriedade type do item para radio group, ou usam-se, na janela de definição de canvas, aferramenta:

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

A aparência dos campos do tipo radio button em um canvas é, normalmente, a seguinte:

Principais propriedades dos itens tipo radio group

Radio buttonvalue

Os nomes dos radiobuttons quecompõem o radiogroup. Valorassociado ao radiogroup se ele forescolhido

.

I tens do tipo lista

Os itens do tipo lista são apresentados como uma caixa com uma seta do lado. Quando ousuário clica a seta, uma lista com os valores possíveis para o item são apresentadas e ousuário pode escolher uma. As listas se classificam em pop-lists, quando a lista aparece comum click, t-lists, quando eleas, por natureza, já vêm abertas, e combo box, que são listas ondequalquer conteúdo que não esteja na lista pode ser informado.

38

Pode-se criar itens do tipo lista através da janela object navigator, setando a propriedade typedo item para list, ou usam-se, na janela de definição de canvas, a ferramenta:

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

A definição de cada valor assumido para cada item da lista é definido através da propriedadeelements in list, que mostra a seguinte janela:

Principais propriedades dos ítens tipo lista

List style Indica se alista seráuma pop-list, uma t-listou um combo box

Mapping ofOther values

Indica o valor que será assumidose outro valor que não osespecificados for encontrado emuma query.

39

Adicionando código ao Oracle Forms

Triggers

Triggers são pequenos trechos de código que são executados de acordo com a ocorrência dealguns eventos especiais, como o pressionar de um botão, a validação de um campo, opressionar de uma tecla, a abertura de uma janela, e outras que veremos a diante.

Para definir triggers, no object navigator seleciona-se o título trigger do nível desejado e nomenu utiliza-se a opção navigator + create, em seguida aparecerá a janela para escolha datrigger desejada. Para selecionar a trigger digite as iniciais do nome da mesma queautomaticamente 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 digitação do texto PL/SQL.

40

Após a escolha da trigger o Oracle Forms Designer mostra o PL/SQL editor para odesenvolvedor 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 triggerdefinida com escopo form será executada em qualquer item de qualquer bloco do form. Umatrigger com escopo block será executada somente dentro do bloco específico, e uma triggercom escopo item será executada somente para o item onde estiver o cursor. O escopo de umatrigger também pode ser definido utilizando o campo object do PL/SQL editor.

Principais propriedades de uma trigger

Tr igger style A imensa maioria dastriggers são do tipobuilt-in (pré-construídas), ou seja,são executadas emeventos padrãodefinidos pelo OracleForms. Porém, ousuário pode criarsuas própriastriggers, user-named.

Fire in enter querymode

Indica se a triggerserá ou não ativada,mesmo que o formesteja em querymode.

41

Alterando propriedades

O Oracle Forms permite que sejam alteradas as propriedades de diversos objetos em tempo deexecução 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 definição de alertas.

Alertas são janelas que aparecem no Oracle Forms e que exibem mensagens para o usuário,possibilitando a ele tomar decisões com base no pressionamento de, no máximo, 3 botõesdisponíveis.

Para definir um alerta usam-se a janela de propriedades do Oracle Forms Designer. Um alertapode ser criado selecionando-se o título alert no object navigator e em seguida acionando-se omenu navigator + create.

43

Principais propriedades de um alerta

Name Nome do alerta Aler t style Ícone que iráaparecer dentro dajanela do alerta,indicando erro, avisoou informação.

Button1 label Label do botão 1 queirá aparecer na janelado alerta

Button2 label Label do botão 2 queirá aparecer na janelado alerta.

Button3 label Label do botão 3 queirá aparecer na janelado alerta.

Default aler t button Qual dos botões seráacionadoautomaticamente se ousuário pressionar[enter] na janela.

Message A mensagem queserá exibida na telado alerta.

Title Especifica o títuloque será mostradopara o alerta.

44

A estrutura de páginas do Oracle Forms

Janelas e Canvas

As janelas (windows) são como molduras que podem ser livremente movimentadas através datela. Estes objetos emolduram uma ou mais páginas da tela, que são chamadas de Canvas.

Janelas

Uma janela pode ser criada usando-se o object navigator, com a seleção do título Windows eacionando-se o menu navigator + create. Na janela de propriedades define-se as propriedades acritério do desenvolvedor.

Principais propr iedades de uma janela

Name Nome da janela Title Título da janelaPrimary canvas Nome do canvas que será

colocado no fundo dajanela

Window style O estilo da janela. Ode serdocument ou dialog. OOracle Forms criaautomaticamente a janelaroot_window, que é modal.

Icon filename O nome do arquivo quecontem o desenho doícones a ser exibidoquando a janela forminimizada.

Modal Indica se a janela pode ounão ser fechada senão porum comando da própriajanela.

Show Verticalscroll bar

Indica se a janela terá ounão barra de rolagemvertical.

ShowHor izontalscroll bar

Indica se a janela terá barrade rolagem horizontal.

Inher it menu Indica se o menu da janelaanterior será ou nãoassociado á nova janelaquando a mesma foraberta.

45

Canvas

Para criar-se um canvas-view pode-se selecionar o título Canvas-View no object navigator eem seguida aciona-se o menu Navigator + create. Na janela de propriedades define-se aspropriedades conforme necessidades.

Principais propr iedades dos canvas

Name O nome do canvas Window Identifica a janela onde ocanvas-view irá aparecer.

Raise on entry Indica se o canvas-viewsempre virá ou não, para afrente quando o cursormudar de canvas-view

Canvas type Identifica o tipo de canvas-view e como este serámostrado na janela.

46

Variáveis de ambiente

São variáveis que informam sobre o atual estado do Oracle Forms.

SYSTEM.BLOCK_STATUS Representa o estado do bloco onde o cursor está locado:change: o bloco contém pelo menos um registro alterado;new: indica que o bloco contém somente registros novos;query: indica que o bloco contem somente registros quecontém no banco de dados;

SYSTEM.CURRENT_BLOCK Contém o nome do bloco que o Oracle Forms estáprocessando

SYSTEM.CURRENT_FORM Contém o nome do form que está sendo executado nomomento

SYSTEM.CURRENT_ITEM Contém o nome do item que o Oracle Forms está nomomento.

SYSTEM.CURRENT_VALUE Contém o valor do item registrado emSYSTEM.CURRENT_ITEM

SYSTEM.CURSOR_BLOCK Guarda o nome do bloco onde está o cursorSYSTEM.CURSOR_ITEM Assume o nome do item onde está o cursorSYSTEM.CURSOR_RECORD Representa o número do registro onde está o cursorSYSTEM.CURSOR_VALUE Representa o valor do item onde o cursor está locadoSYSTEM.FORM_STATUS Representa o estado corrente do form: change: o form

contém pelo menos um registro alterado; new: indica queo form contém somente registros novos; query: indicaque o form contém somente registros que contém nobanco de dados.

SYSTEM.LAST_QUERY Contém o comando SELECT usado para executar aúltima query do forms.

SYSTEM.LAST_RECORD Retorna TRUE se o cursosr estiver no último registro dobloco. Caso contrario, retorna FALSE.

SYSTEM.MESSAGE_LEVEL Uma das variáveis de sistema que pode ser alterado pelousuário. Ela indica o nível das mensagens que serãoexibidas na tela.

SYSTEM.MODE Armazena o modo corrente em que o form está: normal:indica que o form está em modo de processamentonormal; enter-query: indica que o form está em modo dequery; query: indica que o form está trazendo os registrosdo banco, significando que uma query está sendoprocessada.

SYSTEM.RECORD_STATUS Armazena o estado corrente do registro: changed: o formcontém pelo menos um registro alterado que foi trazidodo banco; new: indica que o form contém somenteregistros novos; query: indica que o form contémsomente registros que contém no banco de dados; insert:indica que o registro corrente não existe no banco.

47

SYSTEM.SUPRESS_WORKING Outra variável do Oracle Forms que pode ser alterada:true: indica que a mensagem ‘working’ deve aparecer norodapé da tela quando o Oracle Forms estiverprocessando; false: a mensagem não irá aparecer na tela.

SYSTEM.TRIGGER_BLOCK O nome do bloco onde o cursor estava quando a triggerfoi inicializada

SYSTEM.TRIGGER_ITEM O nome do item onde o cursor estava quando a triggerfoi inicializada

SYSTEM.TRIGGER_RECORD O número do registro que a trigger corrente estáprocessando.