UNIVERSIDADE DO SUL DE SANTA CATARINA UNISULPROF. EDSON THIZON

EDUCAO ORACLE

Oracle Forms Designer Parte 5 Forms Builder

1

OPERAES BSICASAcessando Oracle Forms DesignerAbrindo 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:\\bin\ifbld60.exe. Onde o diretrio raiz do Oracle.

2

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.

3

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 . 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.

4

Gerenciamento de MdulosFormatos 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) 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.

Menus

Libraries(Bibliotecas)

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

5

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.

6

Abrindo um MduloQuando 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 + O;

7

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.

8

Outras Operaes com Mdulos. A tabela abaixo exibe outras operaes, menos utilizadas, que podem ser realizadas com os mdulos. Operao Excluir Mdulos. 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.

Renomear Mdulos

Reverter o mdulo para a ltima verso salva.

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:

9

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 + 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 FormsEste 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 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.

Excluso Pesquisa

Alterao

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 APLICAOEstrutura do Oracle Forms DesignerO 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 do menu , 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 MduloDefinindo 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 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. 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. O nome do mdulo. 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 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.

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.

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

ObjetosTrabalhando 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 X position A posio na horizontal em que a LOV aparecer na tela Largura da janela 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

width

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 Y position Height Bottom title Nome do 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.

Posio vertical do editor Width na tela. Altura da janela do editor 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.

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

ItensTrabalhando 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 X position O nome do item Canvas 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

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)

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 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.

Iconic

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 FormsTriggers 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 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

Button1 label

Button3 label

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

Message

A mensagem que ser exibida na tela do alerta.

44

A estrutura de pginas do Oracle FormsJanelas 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 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.

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

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 Identifica a janela onde o canvas-view ir aparecer. Identifica o tipo de canvasview e como este ser mostrado na janela.

Raise on entry Indica se o canvas-view Canvas type sempre vir ou no, para a frente quando o cursor mudar de canvas-view

46

Variveis de ambienteSo variveis 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 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.

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

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.