Você está na página 1de 58

APEX

Contedo
1. COMEANDO COM O ORACLE APLICATION EXPRESS ........................................................................... 4 1.1. O que Oracle Application Express? ..................................................................................................... 4 1.2. Arquitetura do APEX .............................................................................................................................. 4 2. APPLICATION BUILDER CONCEITOS ....................................................................................................... 4

2.1. O que uma pgina ............................................................................................................................... 5 3. LOGIN..................................................................................................................................................... 5

3.1. Ambiente ............................................................................................................................................... 6 4. CRIAR UMA APLICAO......................................................................................................................... 7

4.1. Atalhos ................................................................................................................................................. 11 5. 5.2. 5.3. 5.4. 5.5. 5.6. 6. 6.1. 6.2. OPES NA APLICAO....................................................................................................................... 11 Executar Aplicao......................................................................................................................... 12 Objetos de apoio ........................................................................................................................... 12 Componentes Compartilhados ...................................................................................................... 13 Utilitrios ....................................................................................................................................... 13 Export/Import ................................................................................................................................ 14 CRIANDO UMA NOVA PGINA ............................................................................................................ 15 Criar uma pgina do tipo Report ................................................................................................... 16 Criar uma pgina do tipo Formulrio ............................................................................................ 20

6.3. Adicionar Regio .................................................................................................................................. 25 6.4. Editar Regio........................................................................................................................................ 28 6.5. Boto ................................................................................................................................................... 30 6.6. Trocar Tema ......................................................................................................................................... 35 6.7. Validaes ............................................................................................................................................ 39 7. 8. 9. 10. SQL WORKSHOP................................................................................................................................... 42 TEAM DEVELOPEMENT ........................................................................................................................ 42 ADMINISTRATION ................................................................................................................................ 43 GERENCIANDO SESSO VALORES ESTADO .......................................................................................... 44

10.1. Referencia da sesso de estado .......................................................................................................... 44 10.2. Configurando estado de sesso........................................................................................................... 44 10.3. Limpando estado de sesso................................................................................................................. 44 10.3.1. 10.3.2. 10.3.3. Limpando cache por item .............................................................................................................. 44 Limpando cache de pgina ............................................................................................................ 44 Clearing cache de um aplicativo .................................................................................................... 45 2

10.3.4.

Limpando cache para o usurio atual sesso ................................................................................ 45

10.4. Utilizando variveis de ligao em regies.......................................................................................... 45 10.5. Usando vincular varivel em procedimentos PL/SQL .......................................................................... 46 10.6. Compreender uma sintaxe URL ........................................................................................................... 46 10.6.1. 10.6.2. 10.6.3. 10.6.4. 10.6.5. 10.6.6. Compreender o url para uma pgina que exibe............................................................................ 46 Usando f? p na sintaxe de pginas link ........................................................................................ 46 Chamando uma pgina de uma aplicao e alias.......................................................................... 47 Chamando uma pgina por um boto de URL ............................................................................. 48 Facilitar a favoritos usando zero como o id da sesso .................................................................. 48 Substituio de strings................................................................................................................... 48

10.7. Alto-substituio strings ...................................................................................................................... 49 10.7.1. 10.7.2. 10.7.3. 10.7.4. 10.7.5. 10.7.6. 10.7.7. 10.7.8. 10.7.9. APP_ALIAS ..................................................................................................................................... 49 APP_ID ........................................................................................................................................... 49 APP_IMAGES.................................................................................................................................. 50 APP_PAGE_ID ................................................................................................................................ 50 APP_SESSION ................................................................................................................................. 50 APP_UNIQUE_PAGE_ID ................................................................................................................. 51 APP_USER ...................................................................................................................................... 51 AUTHENTICATED_URL_PREFIX ...................................................................................................... 51 BROWSER_LANGUAGE .................................................................................................................. 52

10.7.10. CURRENT_PARENT_TAB_TEXT ...................................................................................................... 52 10.7.11. DEBUG ........................................................................................................................................... 52 10.7.12. HOME_LINK ................................................................................................................................... 52 10.7.13. LOGIN_URL .................................................................................................................................... 53 10.7.14. IMAGE_PREFIX ............................................................................................................................... 53 10.7.15. PRINTER_FRIENDLY........................................................................................................................ 53 10.7.16. LOGOUT_URL................................................................................................................................. 53 10.7.17. PROXY_SERVER .............................................................................................................................. 54 10.7.18. PUBLIC_URL_PREFIX ...................................................................................................................... 54 10.7.19. REQUEST ........................................................................................................................................ 54 10.7.20. Condies comuns a referncia Request ..................................................................................... 54 10.7.21. SQLERRM ....................................................................................................................................... 55 10.7.22. SYSDATE_YYYYMMDD ................................................................................................................... 55 11. ndice de Imagens ................................................................................................................................ 57 3

1. COMEANDO COM O ORACLE APLICATION EXPRESS


1.1. O que Oracle Application Express?
Oracle Application Express um ambiente de desenvolvimento para desenvolver e programar aplicativos Web database-centric. Graas a built-in caractersticas de interface do usurio tais como temas, navegao controles, fazem movimentao, e flexvel de relatrios, Oracle Application Express acelera o desenvolvimento de aplicaes processo. O APEX mostra as aplicaes em tempo real a partir de dados armazenados em tabelas de dados. Quando voc criar ou ampliar uma aplicao, o APEX cria ou modifica metadados armazenados em banco de dados tabelas. As sees que se seguem descrevem as caractersticas-chave do APEX. Com o Oracle Application Express, voc pode rapidamente gerar relatrios que mostram HTML os resultados das consultas SQL. Voc tambm pode fazer download e imprimir relatrios em HTML, um Adobe Portable Document Format (PDF), Microsoft Word Rich Text Format (RTF), ou Formato Microsoft Excel (XLS), ou XML.

1.2. Arquitetura do APEX


O Oracle Application Express instala-se em seu banco a partir de dados Oracle e composta por dados em tabelas e PL / SQL. No importa se voc est rodando o Oracle Application Express desenvolvimento meio ambiente ou um aplicativo que voc construdo utilizando o APEX, o processo o mesmo. O seu navegador envia uma URL solicitar que seja traduzido para o adequado Oracle Application Express PL / SQL chamada. Aps a base de dados dos processos PL / SQL, o os resultados so afinados de volta para o seu navegador em HTML. Este ciclo acontece cada vez que voc quer pedir ou enviar uma pgina.

Figura 1. Arquitetura.

2. APPLICATION BUILDER CONCEITOS


Esta seo fornece informaes sobre a base conceituais Application Builder. Pode ser usado o Application Builder para montar uma interface HTML (ou aplicao) em cima da base de dados objetos, tais como tabelas e procedures. Cada Request tem uma coleo de pginas vinculadas em conjunto, utilizando as abas, botes, ou ligaes hipertexto.

2.1. O que uma pgina


Uma pgina o elemento bsico de uma aplicao. Quando voc construir uma aplicao em APEX, voc cria pginas que contm elementos de interface do usurio, tais como guias, listas, botes, itens, e as regies. Voc pode controlar a acrescentar uma pgina a pgina Definio. H tambm o Shared Components que so componentes comuns que podem ser usadas por um ou mais pginas dentro de uma aplicao.

3. LOGIN
Para este modelo estou utulizando o espao Apex que a Oracle disponibilizou, a Workspace o email da pessoa e o usurio e senha encaminhado pela Oracle.

Figura 2. Login.

3.1. Ambiente

Use Application Builder para montar uma interface HTML (ou aplicao) em cima da base de dados e objectos, tais como Table e Procedures.

SQL Workshop utilizado para aceder a ferramentas de visualizao e gerenciamento e objetos de dados. Clique Workshop SQL para acessar o banco de dados seguintes instrumentos: Object Browser,SQL Commands, SQL Scripts , Utilities (Utilitrios)

Esta opo utilizada na gesto do processo de desenvolvimento de aplicaes. Use esta ferramenta para rastrear os recursos, para fazer as tarefas, marcos e bugs. Pode ser usado o feedback para capturar o envio do usurio e, em seguida, classificar os comentrios do usurio como caractersticas, para fazer tarefas e bugs. Administrao, permite que voc gerencie sua conta. Dependendo dos seus privilgios, voc pode monitorar e administrar esse espao de trabalho.

4. CRIAR UMA APLICAO


Etapa 1 Na Primeira etapa da criao o desenvolvedor deve escolher Application Builder, a seguir deve clicar na opo de Criar.

Figura 3. Aplicao, Etapa 1. Criao.

Etapa 2 Na etapa 2 deve ser definido a origem das pginas da aplicao.

Figura 4. Aplicao, Etapa 2. Mtodo.

Aplicaes de banco de dados: Este tipo permite que os desenvolvedores tenham o controle total sobre todos os aspectos do processo de desenvolvimento e funcionalidades da aplicao final; podem tambm alavancar diretamente o seu SQL e habilidades PL / SQL de programao. Este tipo permite tambm usar o controle de declarao sobre controle de fluxo e suporte a controles de interface de usurio atravs do uso de modelos e temas. 7

Aplicaes Websheet: Permiti aos usurios construir aplicaes centradas em dados sem nenhum conhecimento de programao SQL. So simplificadas e para: pginas de suporte, redes de dados e relatrios. Estas aplicaes so fceis de construir e de apoiar contribuies para a comunidade.

Etapa 3

Figura 5. Aplicao, Etapa 3. Definio.

From Scratch: Esta opo possibilita criar uma aplicao atravs da definio de pginas, pode ser selecionado um esquema de autenticao, e especificando uma interface de usurio. As pginas podem ser com base em tabelas, consultas ou consultas drill-down. A partir de uma planilha: Pode-se criar um aplicativo com base em dados da planilha. A aplicao ter de insero, consulta, atualizao e capacidade de anlise sobre a tabela recm-criada.

Etapa 4 Deve ser definido o nome da aplicao, nmero, se uma aplicao do zero ou baseada em alguma existente, e de que esquema ira buscar as referencia de dados.

Figura 6. Aplicao, Etapa 4. Nome para aplicao.

Etapa 5 Nesta etapa devem ser definidas as pginas da aplicao. (Eu sempre adiciono uma pgina em branco, e as outras vou criando conforme as necessidades da aplicao).

Figura 7. Aplicao, Etapa 5. Pginas da aplicao.

Depois de selecionar a pgina desejada e clicar em Adicionar pgina na regio de criar aplicativo fica listado as que o desenvolvedor for adicionando. Depois de escolher o desejado clique em criar, para ir prxima etapa.

Figura 8. Aplicao, Etapa 6. Pginas da aplicao adicionar pginas.

Etapa 6 Esta a etapa da concluso de criao da aplicao, que j vem com um tema pr-definido, mas que possvel alterar.

Figura 9. Aplicao, Etapa 6. Finalizar.

Etapa 7 Aps a criao da aplicao o desenvolvedor ir para a rea de trabalho, para que se possam criar mais pginas, incluir objetos de apoio, objetos compartilhados, importar o exportar as pginas e utilitrios da aplicao.

Figura 10. Aplicao, Etapa 7.

10

4.1. Atalhos
Quando se est na pgina da aplicao, temos as opes de mudar de ambiente, podendo ir para o SQL Workshop, Gerenciamento de desenvolvedores e administrao do APEX, e tambm podendo voltar a pgina home.Em seguida vem a barra com o caminho detalhado e atalhos para o desenvolvedor.

1. Executar a pgina 2. Editar a pgina 3. Ir aos componentes compartilhados

4. Utilitrios da Aplicao 5. Feedback 6. Localizar

Quando esst se editando uma pgina aparecem mais duas opes, na barra de atalhos. Seguindo a imagem abaixo foi destacado as novas opes que so:

Bloquear a pgina, muito til quando se est trabalhando com muitas pessoas na equipe de desenvolvimento desta aplicao, assim o outro desenvolvedor s poder efetuar alteraes (mas ainda poder consultar o contedo)quando for desbloqueado. Quando o desenvolvedor clicar nesta opo deve marcar a pgina para bloqueio e informar o motivo (quando outro desenvolvedor entrar na pgina vai ver o cadeado fechado como sinal de bloqueio), depois de ter concludo o trabalho deve vir nesta mesma opo e desbloquea-la. Exportar a pgina, essa segunda opo permite exportar a pgina que ser um arquivo sql.

5. OPES NA APLICAO
As aplicaes so constitudas de pginas. Para cada pgina voc pode definir declarativamente como a pgina convertida e processada. Os controles que no so especficos para uma pgina so chamados componentes compartilhados estes incluem autenticao, autorizao, modelos de interface do usurio e guias.Nesta fase voc pode executar a aplicao, ir aos objetos de Apoio, Componentes Compartilhados, Utilitrios ou Importar e Exportar a aplicao.

Figura 11. Opes da Aplicao.

11

5.2. Executar Aplicao Ao clicar nesta opo o APEX ira gerar uma aplicao em HTML, e dever ser validado por um utilizador e senha antes de mostrar as pginas criadas.

Figura 12. Login.

5.3. Objetos de apoio Os objetos de suporte so para definir scripts de banco de dados e de objetos de instalao que so invocadas quando importao de um aplicativo. Voc tambm pode definir scripts de desinstalao para soltar objetos ao excluir um aplicativo. Os Objetos de apoio tambm permitem que voc possa empacotar o aplicativo e objetos de banco de dados necessrios, em um nico arquivo.

Figura 13. Aplicao > Objetos de Apoio.

12

5.4. Componentes Compartilhados possvel usar os componentes compartilhados em qualquer pgina de uma aplicao. Esta pgina fornece uma lista de componentes compartilhados disponveis, ou seja, pode haver um componente para vrias aplicaes, desde que este fornea a mesma base para a soluo.

Figura 14. Aplicao > Componentes Compartilhados.

5.5. Utilitrios Estes Utilitrios resumem informaes da aplicao e permitem acesso a ferramentas teis. possvel ver o histrico de alteraes, pginas atualizadas recentemente, dicionrios de atributos, vises da aplicao entre outros.

Figura 15. Aplicao > Utilitrios.

13

5.6. Export/Import Opo para importar ou exportar a aplicao. Exportar; ao selecionar a tarefa e clicar em prximo, o APEX vai perguntar o formato do arquivo, nome da aplicao entre outros, depois de clicar em exportar aplicao vai aparecer uma janela de download com um arquivo SQL contendo os dados da aplicao exportada. Neste caso vai ser exportada toda a aplicao, para exportar somente uma pgina deve ser entrado na mesma e clicar na opo de exportar. Importar; deve ser informado o arquivo SQL e marcar o tipo de arquivo (Exportao de Aplicao, Pgina ou Componente do Banco de Dados).

Figura 16. Aplicao > Importar e Exportar.

14

6. CRIANDO UMA NOVA PGINA

Figura 17. Criao da pgina.

Vamos utilizar nessa apostila um modelo de criao de pgina para Relatrio e Formulrio, o restante dos tipos de pgina seguem o mesmo modelo, o desenvolvedor deve ler atenciosamente cada etapa e ver as necessidades que possui pra cada tipo de tela. Para criar a pgina vamos clicar em Criar Pgina. Depois de clicado em criar pgina a ferramenta do APEX direciona para uma pgina que contm tipos de pginas podendo ser: Em Branco: cria uma pgina totalmente em branco onde o desenvolvedor deve inserir todos os campos e demais necessidades. Vrias pginas em Branco: cria vrias pginas em branco onde todos os campos das pginas. Relatrio: o tipo de tela relatrio traz listado na tela os j cadastrados no banco de dados e com opes de filtros e condies. Grfico: o tipo grfico pode ser utilizado pelo desenvolvedor quando quer fazer uma anlise ou balancete, esse tipo traz diferentes opes de grficos. Form: tipo que monta na pgina um formulrio que o que utilizares de exemplo nesa apostila Assistente: Cria um grupo de pginas. (ex. passo a passo) Calendrio: Auxilia o utilizador na criao de um calendrio

15

rvore: o tipo rvore geralmente utilizado como Menu, ou tambm para outro tipo de informao dependendo da necessidade da tela. Pgina de Log-in: esse tipo de pgina para efetuar a autenticao quando entrar na aplicao. Controlo de acesso: Cria uma pgina para que o utilizador efetue o login.

6.1. Criar uma pgina do tipo Report

Figura 18. Relatrio.

Etapa 1 Depois de escolher a opo de report (relatrio), vm quatro opes de modelo, o interativo, o clssico, baseado em um servio Web ou um assistente de relatrio. Para o modelo apresentado neste manual estar sendo criando a opo de relatrio interativo.

Figura 19. Relatrio - Etapa 1. Criando a pgina.

Etapa 2 So definidos nesta etapa, os atributos da pgina ou regio, onde se define um nmero para a mesma, o nome dela, um ttulo para a regio (uma pgina pode ter mais de uma regio, as outras podem ser criadas depois de estar pronto), 16

modelo da regio; o caminho detalhado no obrigatrio informar, mas se informado o Apes mostra uma regio para dar entrada no nome para montagem do caminho. No caminho detalhado pode ser adicionada a tela que ser o pai desta, no exemplo da imagem abaixo cadastro a tela pai que ser a de consulta.

Figura 20. Relatrio - Etapa 2. Definio da Pgina.

Etapa 3 Etapa onde o desenvolvedor escolhe se esta pgina vai ter tabs ou no, conforme mostra o descritivo na imagem. Escolhido isso pode ser clicado em Prximo (Next).

Figura 21. Relatrio - Etapa 3. Definio de Tabs.

17

Etapa 4 Na etapa quatro o desenvolvedor dever informar a consulta SQL, de onde a tela de relatrio ir buscar os dados, mesmo que a coluna de cdigo no aparea deve constar no SQL, para poder servir de link para a pgina de edio do registro apresentado no relatrio.

Figura 22. Relatrio - Etapa 4. Query builder.

Etapa 5 Est a etapa de finalizao da pgina de relatrio. Clique em finalizar (finish).

Figura 23. Relatrio - Etapa 4. Finalizao.

Aps a concluso possvel execut-la ou editar. Os labels das colunas esto de acordo com as colunas selecionadas na consulta SQL, e editando a pgina ser possvel a alterao.

18

Executando a pgina Ao executa a aplicao o APEX vai pedir o usurio e a senha, coloque o mesmo usurio no qual foi logado, vai redirecionar para a pgina 1 que est em branco, ento na barra de endereo deve ser alterado o nmero para a pgina que deseja visualizar. (Ver sintaxe da URL) Exemplo:

Resultado

Actions Cada utilizador da aplicao pode aplicar as aes em cima do relatrio, a primeira opo por exemplo, permite que seja selecionados as colunas que deseja ser visualizado, caso no se deseja visualizar toda, esse resultado pode ser explorado para CSV, HTML ou Email. Na opo de formato possvel efetuar grficos, clculos com base no resultado do relatrio e outras opes. Como nosso relatrio s possui uma coluna no possvel efetuar essas opes.

19

6.2. Criar uma pgina do tipo Formulrio

Figura 24. Tipo Formulrio.

Etapa 1 Quando escolhido a opo de formulrio, em seguida deve ser definido a sua estrutura de pgina, se baseado em uma tabela ou view, com base em procedure, se vem de uma consulta SQL, de um relatrio em servio WEB, ou se um formulrio de detalhes mestres.

Figura 25. Formulrio - Etapa 1. Escolha do tipo.

Etapa 2 Nesta etapa deve ser escolhido o owner das tabelas, quem o proprietrio das mesmas. Em seguida deve ser informado o nome da tabela, onde a tela ir buscar, inserir e alterar os dados. Portanto, no Nome da Tabela / View escolhido na lista de valores do campo, lembrando que aparecero s as tabelas do owner escolhido no campo anterior. (veja na prxima imagem) Depois de escolhido clicamos em prximo e seguimos para a prxima etapa.

20

Figura 26. Formulrio - Etapa 2. Definio de Owner e Nome de Tabela.

Etapa 3 So definidos nesta etapa, os atributos da pgina ou regio, onde se define um nmero para a mesma, o nome dela, um ttulo para a regio (uma pgina pode ter mais de uma regio, as outras podem ser criadas depois de estar pronto), modelo da regio; o caminho detalhado no obrigatrio informar, mas se informado o APEX mostra uma regio para dar entrada no nome para montagem do caminho.No caminho detalhado pode ser adicionado a tela que ser o pai desta, no exemplo da imagem abaixo cadastro a tela pai que ser a de consulta.

Exemplo de caminho detalhado

Para dar entrada no caminho detalhado Pai, basta clicar sobre os j existentes.

Figura 27. Formulrio - Etapa 3. Definies da pgina.

21

Etapa 4 Etapa onde o desenvolvedor escolhe se esta pgina vai ter tabs ou no, conforme mostra o descritivo na imagem. Escolhido isso pode ser clicado em Prximo (Next).

Figura 28. Formulrio - Etapa 4. Definio de Tabs.

Etapa 5 Se a tabela tiver um campo de chave primria, existe a possibilidade de escolher o ROWID da tabela, ou a coluna contendo a PK, caso se opte pela coluna com a PK, deve ser escolhido essa opo e nos campos que aparecerem abaixo indicar qual a coluna. Como j foi indicada a tabela em etapas anteriores, o APEX busca as colunas da tabela que foi informada.

Figura 29. Formulrio - Etapa 5. Chave Primria.

22

Etapa 6 Nesta etapa refere-se origem da chave primria, se vem de uma Trigger, funo PL/SQL ou sequencia. Marque a opo de acordo com a sua estrutura de tabela.

Figura 30. Formulrio - Etapa 6. Origem do cdigo da PK.

Etapa 7 Nesta etapa a ferramenta trs todas as colunas da tabela selecionada, ento o desenvolvedor dever escolher quais deseja levar para que aparea na tela. (Obs. A coluna com a PK, tambm ir, mesmo que no aparea para seleo).

Figura 31. Formulrio - Etapa 7. Seleo de colunas da pgina.

23

Etapa 8 A etapa oito do processo de criao do formulrio para que se possa escolher os botes de ao (deletar, inserir, aplicar alteraes e cancelar) da tela, se desejar que seja mostrado os botes masque a opo Yesantes de cada opo, e nos campos de texto colocar o nome do qual deve aparecer no layout.

Figura 32. Formulrio - Etapa 8. Escolhendo os botes.

Etapa 9 Etapa que deve ser definido as ramificaes das pginas, quando der um submit pra que pgina do APEX deve ir e quando cancelar, deve redirecionar pra qual. Indique os nmeros da pgina nos campos ou escolha na lista de valores.

Figura 33. Formulrio - Etapa 9. Ramificaes da pgina.

24

Etapa 10 ltima etapa a confirmao da criao da pgina e uma breve descrio com dados/informaes.

Figura 34. Formulrio - Etapa 10. Finalizao.

6.3. Adicionar Regio


possvel que em uma pgina aja mais de uma regio e esta pode ser de relatrio, formulrio, grfico, ou outros, enfim pode ser inserida a opo mais adequada regio. Na imagem abaixo temos como exemplo a regio de cadastro de segmento, mas na regio abaixo quero colocar uma consulta de segmentos existentes quando o SEGMTO_COD for igual a 0.
Adicionar regio

Etapa 1 Ao clicar em adicionar uma regio o APEX mostra um guia de escolhas, a primeira para escolher o tipo da regio, no caso do nosso exemplo ser relatrio.

Figura 35. Regio Etapa 1. Escolher regio.

25

Etapa 2 Quando escolhido a opo de relatrio, poder ser do tipo interactivo, clssico ou de um servio da Web. Para o exemplo foi escolhido o clssico.

Figura 36. Regio Etapa 2. Escolher tipo.

Etapa 3 Na etapa 3 deve ser definido o nome da regio, modelo e se esta regio depende de outra, pode tambm ser definido o ponto de exibio desta regio.

Figura 37. Regio Etapa 3. Atributos de Exibio.

Etapa 4 Nesta etapa informado a cosulta SQL que retornar as linhas com os dados solicitados.

Figura 38. Regio - Etapa 4. Origem.

26

Etapa 5 A etapa 5 o desenvolvedor poder ser definido o modelo do relatrio, quantas linhas de registro devero ter quando o relatrio que for solicitado, e outras opes conforme mostra a imagem abaixo. O desenvolvedor dever marcar as opes conforme a necessidade e escolha.

Figura 39. Regio - Etapa 5. Atributos do Relatrio.

Etapa 6 Caso a regio tenha uma condio especial de exibio, nesta etapa pode ser informada, no caso do exemplo abaixo foi definido que esta regio s poder aparecer quando o cdigo do segmento for igual a 0, assim antes de cadastrar um segmento o utilizador poder consultar o existentes, depois de salvo o novo segmento a regio ficar oculta. Para inserir esta condio no tipo foi escolhido: O valor do Item/Coluna na expresso 1 nulo, e no campo referente a expresso 1 foi informado a coluna de comparao

Figura 40. Regio - Etapa 6. Exibio Condicional.

Ao clicar no boto criar regio o APEX redireciona para a pgina com as regies de desenvolvimento, e na regio de criao das regies aparecer a nova que foi inserida.

27

6.4. Editar Regio

Nome das Colunas

Opes de Pesquisa da pgina (Boto de Ao)

28

Link para editar registro (Nmero da Pgina de ligao) Parmetro

29

6.5. Boto
Para incluir botes na pgina, o desenvolvedor dever ir regio de Botes na renderizao da pgina. Conforme pode ser visualizado na imagem abaixo.

Adicionar boto

Figura 41. Boto> Adicionar.

Etapa 1 A primeira etapa da criao de um boto escolher a regio onde o mesmo ir constar, na imagem abaixo, por exemplo, os botes de Cancel e Next esto no topo da regio em suas posies pr-definidas de cancelar e Prximo.

Figura 42. Adicionar boto- Etapa 1. Definir Regio do boto.

30

Etapa 2 Nesta etapa o desenvolvedor ir definir se a posio do boto ser no cabealho ou no corpo da tela.

Figura 43. Adicionar boto - Etapa 2. Posio do Boto.

Etapa 3 Etapa 3 so as definies de nome do boto, rtulo e estilo. Abaixo do campo de nome do boto, o APEX apresenta algumas sugestes, veja na imagem abaixo.

Figura 44. Adicionar boto - Etapa 3. Atributos.

31

Etapa 4 Nesta etapa deve ser informada a posio em que o boto ir fica localizado, e na posio do cancelar, prximo, anterior, e assim por diante.

Figura 45. Adicionar boto - Etapa 4. Posio do boto.

Etapa 5 Na etapa cinco, o desenvolvedor dever informar ao que dever ser disparado quando for clicado, no exemplo que est sendo criado, ir redirecionar para a pgina de cadastro de um novo registro, ento na ao foi selecionado: Redirecionar para pgina desta aplicao, depois a pgina para qual deseja se redirecionar. Obs. No campo clear cache coloquei o nmero da pgina no qual desejo efetuar um novo cadastro.

Figura 46. Adicionar boto - Etapa 5. Ao quando clicado.

32

Etapa 6 Caso o boto tenha alguma condio especial de exibio dever ser informado nesta etapa, por exemplo, se for uma tela de cadastro e nem todos os utilizadores possuiem acesso de cadastro, poder ser feito uma restrio nesta rea. Depois de criado o boto ainda possvel a incluso desta regra.

Figura 47. Adicionar boto - Etapa 6. Condio deexibio.

Para finalizar a criao deve ser clicado em Criar boto, e ento o mesmo aparecer na sua regio.

Executando a Aplicao Ao executar a aplicao, depois de informar o usurio e senha, v pgina de cadastro, nesta de exemplo eu adicionei o boto Novo para redirecionar a de cadastro.

Clicando no boto novo ir redirecionar para a pgina de formulrio para cadastro.

33

Depois de clicar em Salvar, volta para a pgina de consulta, isso porque cadastrei na ramificao que ao clique de salvar/alterar e deletar deveria redirecionar a para pgina de consulta.

34

6.6. Trocar Tema


Quando criada uma aplicao o APEX coloca um tema pr-definido, para alterar o tema que est definido, o desenvolvedor deve estar na aplicao e clicar em componentes compartilhados.

Aps ser redirecionada para os componentes compartilhados, na regio de Interface do Usurio, a opo Temas.

Figura 48. Componetes Compartilhados -Temas.

Etapa 1 Na rea de temas estar disponvel o que est sendo utilizado na aplicao, o passo a seguir deve ser clicar no boto Criar.

Figura 49.Temas - Etapa1. Criar Tema.

35

Etapa 2 Este novo tema pode ser baseado do repositrio do APEX, um totalmente novo ou um tema com base em uma exportao, par o exemplo de alterao de tema ser escolhido a opo do repositrio.

Figura 50. Temas - Etapa 2. Mtodo.

Etapa 3 O passo a seguir definir o tema que ser aplicado na aplicao, o APEX ira listar 26 modelos, o escolhido deve ser marcado no radio button ao lado do modelo. Para a minha aplicao escolhi o tema 23 que contempla alteraes de HTML5. possvel efetuar mudanas de um tema existente.

Figura 51. Temas - Etapa 3. Identificar Tema.

36

Etapa 4 Depois de escolhido o tema ser mostrado a etapa de confirmao, onde deve-se clicar em Criar.

Figura 52. Temas - Etapa 4. Confirmar Tema.

Etapa 5 Com o tema criado, o passo seguinte fazer a troca. Na tela que o APEX retornou temos o boto Alterar tema, escolha esta opo.

Figura 53. Temas - Etapa 5. Alterar Tema.

Etapa 6 Na regio que aparecer ir mostrar as informaes da apliao e do tema atual, escolha no campo de alternar para tema o que foi escolhido nas estapas anteriores.

Figura 54. Temas - Etapa 6. Identificar tema a alterar.

37

Etapa 7 Aps a escolha do tema o APEX mostra todos os itens que esto sendo alterados e possuem classe. Para cada item possvel a alterao.

Figura 55. Temas - Etapa 7. Verificar Compatibilidade.

Etapa 8 Etapa de confirmao da alteraop do tema, para isso clique em Alterar Tema.

Figura 56. Temas - Etapa 8. Confirmar Alterao.

38

6.7.Validaes
As validaes so especficas de um determinado campo (uma nica validao de item de pgina ou formulrio tabular), ou de uma pgina completa (uma validao de linha de pgina ou formulrio tabular).

Etapa 1 Na edio da pgina, h a regio de validaes, clique na opo de adicionar.

Figura 57. Validao - Etapa1.

Etapa 2 Na segunda etapa da validao a definio sobre o nvel, se ser da pgina inteira ou de apenas um item, no exemplo a seguir ser feito com base em um item.

Figura 58. Validao - Etapa 2. Nvel de Avaliao.

39

Etapa 3 Depois de ter escolhido a opo de validao por item da pgina, mostrado todos os itens da pgina, selecione o campo no qual se deseja inserir a validao.

Figura 59. Validao - Etapa 3. Item/Coluna.

Etapa 4 Deve ser informado um nome para esta validao e como deve ser mostrada a mensagem de erro ou informao, se no campo e no topo da pgina, s no campo, ou s no topo da pgina.

Figura 60. Validao - Etapa 4. Sequncia e Nome.

Etapa 5 Na etapa 5 o desenvolvedor dever escolher qual o tipo de validao que se mais adequada a validao que ter que ser feita, podendo ser no nulo, comparao de string, expresso regular, SQL ou PL/SQL.

Figura 61. Validao - Etapa 5. Tipo de Validao.

40

Etapa 6 Na etapa anterior foi escolhida a opo de no nulo, e na etapa seis, deve ser informado qual a mensagem de erro ao validar o campo e estiver nulo.

Figura 62. Validao - Etapa 6. Validao.

Etapa 7 Nesta etapa pode ser definida a condio de execuo desta validao, pode ser quando um boto for pressionado (ser listado todos os botes da tela, como foi feito em um item e a validao se referia a no nulo, ser definido no campo de pressionar boto o boto Criar.) ou ainda pode ser definido um tipo diferente de condio como: PL/SQL, existe, solicitao igual a expresso 1 (este campo aparece quando esta opo escolhida)

Figura 63. Validao - Etapa 7. Condio e Confirmao.

Depois de concluir as etapas a validao foi criada e no momento de pressionar o boto Criar vai ser verificado se o campo P4_SEGMTO_COD possui algum valor e assim pode ser feito para outros itens e tipos de validaes.

41

7. SQL WORKSHOP
O SQL Workshop oferece ferramentas para exibir e gerenciar objetos do banco de dados.

Figura 64. SQL Workshop.

8. TEAM DEVELOPEMENT
Facilita o gerenciamento do processo de desenvolvimento de aplicaes. Use essa ferramenta para rastrear recursos, tarefas, marcos e bugs. Use o Feedback para capturar o feedback do usurio e depois categorizar os comentrios do usurio como recursos, tarefas e bugs.

Figura 65. Equipe de Desenvolvimento.

42

9. ADMINISTRATION
A Administrao de Espao de Trabalhos do Application Express permite que voc gerencie sua conta. Dependendo dos seus privilgios, voc poder monitorar e administrar esse espao de trabalho.

Figura 66. Administrao.

43

10.

GERENCIANDO SESSO VALORES ESTADO

Quando a construo interativa, os dados-driven aplicaes Web, a capacidade de acesso e de gerir valores sesso estado crtico. No APEX, temos a sesso de estado que gerido automaticamente a cada pgina e facilmente referenciado em HTML esttico ou lgico tais como controles de processos ou validaes.

10.1.

Referencia da sesso de estado

Referenciando o valor de um item um dos exemplos mais comuns de referencia Sesso do estado. Um item pode ser um campo, uma rea texto, uma senha, selecione uma lista, ou um cheque caixa. ******

10.2.

Configurando estado de sesso

Quando um usurio envia uma pgina, a resposta armazena rapidamente e automaticamente os valores que so digitados em campos (itens) em sesso do estado. Por exemplo, suponha que voc tem uma aplicao e contm duas pginas. A primeira pgina do formulrio de aplicao inclui um que o usurio pode digitar um nmero de telefone. definido desta forma, criando uma rubrica denominada P2_PhoneNo. Na segunda pgina, voc deseja exibir as informaes do usurio que entra no formulrio. Quando a pgina apresentada, o Oracle Application Express captura o valor inscrito no o nmero de telefone campo e armazena o valor para uso futuro. O nmero de telefone inscrito pelo usurio pode ento ser recuperado a partir de sesso por referenciar o estado do item associados com o campo na pgina.

10.3.

Limpando estado de sesso

medida que voc vai desenvolvendo as suas aplicaes, poder encontr-lo til para limpar o cache de valor para itens especficos, todos os itens em uma pgina, todas as pginas em uma aplicao, ou o usurio atual sesso. Limpado um cache repe o valor com nulo. Os temas que se seguem oferecem exemplos especficos de compensao da sesso de estado. 10.3.1. Limpando cache por item Limpar o cache para um nico item reinicia o valor do item para nulo. Por exemplo, voc poderia utilizar esta abordagem para certificar-se de um item especfico do valor nulo quando uma pgina preparada para a renderizao. O seguinte exemplo usa o padro de f? P sintaxe para limpar o cache de um item. Este exemplo na chamadada pgina 5 da aplicao 100. MY_ITEM colocao na posio ClearCache do f? p sintaxe retorna o valor de MY_ITEM para NULL. f? p = 100:5: & APP_SESSION.:: NO: MY_ITEM O exemplo a seguir redefine o valor dos itens THE_EMPNO e THE_DEPTNO. f? p = 100:5: &APP_SESSION.:: NO: THE_EMPNO, THE_DEPTNO

10.3.2. Limpando cache de pgina Caching fornece uma maneira eficaz de manter a sesso de estado. No entanto, h ocasies em que voc pode querer limpar o cache para todos os itens em uma pgina. Por exemplo, suponha que voc ache necessrio, limpar todos os campos em uma pgina quando um usurio clica um link que cria uma nova ordem. Ao limpar o cache de uma pgina inteira, voc define o valor de todos os itens na pgina para nulo.

44

Este exemplo apaga a Paginao do cache na sesso de duas pginas e redefine paginao. f? p = 6000:6003: & APP_SESSION.:: NO: RP, 6004,6014

10.3.3. Clearing cache de um aplicativo Voc pode limpar o cache de uma aplicao utilizando f? P sintaxe e criando um Clear Cache argumento usando a palavra-chave APP. Por exemplo: f? p = App: Pgina: sesso:: NO: APP 10.3.4. Limpando cache para o usurio atual sesso Outra abordagem para a limpeza do cache em uma aplicao criar um argumento de Limpar Cache usando a palavra-chave SESSION. Por exemplo: f? p = 6000:6004:12507785108488427528:: NO: SESSION Sobre vincular a sintaxe da varivel voc pode usar variveis bind em qualquer lugar onde voc est usando SQL ou PL/SQL referncia ao estado de uma sesso especificada item do APEX. Por exemplo:
SELECT * FROM empregados WHERE ultimo_nome como '%' | |: SEARCH_STRING | | '%'

Neste exemplo, a string de pesquisa um item da pgina. Se a regio tipo definida como SQL Query, voc pode usar a referncia do valor padro SQL e vincular a varivel de sintaxe. Se usar Variveis de ligao, garante que analisar representaes de consultas SQL e que so reutilizados pelo banco de dados, otimizando memria utilizada pelo servidor. Quando usar a sintaxe bind varivel, lembrem-se as seguintes regras: Variveis de ligao; nomes devem corresponder a um item nome. Variveis de ligao; nomes no caso-sensveis. Variveis de ligao; nomes no podem ser superiores a 30 caracteres (ou seja, eles devem ser um Oracle identificador vlido).

Para repor uma aplicao completa sem uma sesso ID (se no utilizado o cookie para acompanhar a sesso ID), voc deve solicit-la utilizando um URL sem uma sesso ID, ou pelo telefone APEX_ APPLICATION.CLEAR_APP_CACHE a partir de outro aplicativo. Se a sesso ID monitorada atravs de um cookie, voc ter que sair para redefinir.

10.4.

Utilizando variveis de ligao em regies

Com base em uma consulta SQL ou LOV , o seu tipo de regio definida como uma consulta SQL, SQL Query (plsql funo corporal retornando consulta SQL), ou lista de valores (LOV), voc pode usar o estado referncia sesso seguinte sintaxe: : MY_ITEM Uma maneira comum de fazer isso a incorporao de uma varivel em uma sesso estado usando a clusula WHERE. O exemplo a seguir mostra como o efeito de vincular o valor do item THE_DEPTNO em uma regio definida a partir de uma consulta SQL.
SELECT ultimo_nome, job_id, salrio FROMempregados WHEREdepartment_id= :THE_DEPTNO

45

10.5.

Usando vincular varivel em procedimentos PL/SQL

Para os tipos regio definida como um processo PL / SQL, as regies so construdas utilizando blocos de PL/SQL annimos. Em outras palavras, o incio e termo palavras-chave so usados para encerrar o bloco PL/SQL. Por exemplo:
Se:P1_JOB no nulo ento INSERTINTO empregados (employee_id, first_name, job_id) VALUES (:P1_EMP_ID,:P1_NAME,:P1_JOB) fim se;;

Neste exemplo, os valores da employee_id, first_name, e so job_id povoada pelos valores da P1_EMP_ID, P1_NAME, e P1_JOB.

10.6.

Compreender uma sintaxe URL

A URL que aparece para cada pgina identifica a localizao do Oracle Application Express, o endereo do APEX, o Request ID, a pgina nmero, bem como a sesso ID. O Request ID um nmero nico que identifica cada aplicao. Do mesmo modo, os nmeros das pginas identificam exclusivamente cada pgina. As aplicaes e pginas podem tambm ter apelidos alfanumricos. O apelido da aplicao nico dentro de uma rea de trabalho e os apelidos da pgina so nicos no mbito de cada aplicao. Quando voc executar um Request, o APEX gera uma sesso nmero que serve como uma chave para a sesso do estado do usurio. Tpicos nesta seo incluem: 10.6.1. Compreender o url para uma pgina que exibe A URL que aparece para cada pgina indica a localizao da Oracle Application Express e identifica o endereo do Oracle Application Express, o Request ID, O nmero de pgina, e sesso ID. Por exemplo: http://APEX.oracle.com/pls/APEX/f?p=4350:1:220883407765693447 Este exemplo indica: APEX.oracle.com a URL do servidor pls o indicador de usar o cartucho mod_plsql vrtice a base de dados acesso Descritor (DAD) nome. O DAD descreve como HTTP Server se conecta ao servidor de banco de dados para que possa atender uma solicitao HTTP. O valor padro pice. f? P = um prefixo utilizado pela Oracle Application Express 4350 a aplicao a ser chamados 1 a pgina dentro do aplicativo a ser exibido 220883407765693447; sesso o nmero 10.6.2. Usando f? p na sintaxe de pginas link Voc pode criar ligaes entre as pginas do seu Request usando a seguinte sintaxe: f? p = App: Pgina: Sesso: Request : Debug: ClearCache: itemNames: itemValues: PrinterFriendly Sintaxe App : Indica um Request alfanumrico de identificao ou apelido. Page : Indica um nmero de pgina ou apelido alfanumrica. Session : Identifica uma sesso ID. Pode ser referncia para criar uma sesso ID de links de hipertexto para outras pginas que se mantenham no mesmo estado em sesso passando a sesso nmero. Sintaxe:

46

Curto substituio string: & SESSION. PL / SQL: V ( 'SESSION') Bind varivel :: APP_SESSION

Request: Define o valor da solicitao. Cada requisio do boto define o valor de Request para o nome do boto. Isso permite que aceite a transformao de referncia ao nome do boto quando um usurio clicar. Sintaxe: Substituio string: & REQUEST . PL / SQL: V ( "REQUEST S") Bind varivel:: REQUESTS

Debug : Mostra o Request de transformao em detalhes. Os valores vlidos para o DEBUG so SIM ou NO. Pode-se fazer referncia ao Debug. Curto substituio string: & DEBUG. PL / SQL: V ( 'DEBUG') Bind varivel:: DEBUG

ClearCache:Limpa a memria do cache. Isso define o valor dos itens a serem nulos. itemNames :Vrgula delimitado por item da lista nomes usados para definir sesso com um estado URL. itemValues: Lista de item com valores usados para definir a sesso de estado dentro de um URL. O nmero dos valores no pode incluir dois pontos, mas pode incluir se fechados com vrgulas e barras. Para passar uma vrgula em um item valor, anexar os personagens com barras. Por exemplo: \ 123,45 \ PrinterFriendly: Determina se a pgina est sendo processada no modo amigvel da impressora. O valor da PrinterFriendly pode ser usada em renderizao condies para remover elementos, tais como as regies a partir da pgina otimizar para a sada na impressa. Sintaxe: V ( 'PRINTER_FRIENDLY') Quando referenciados, o Request no ser exibido com separadores ou barras de navegao, e todos os itens sero exibidos como texto e no como forma elementos. Embora seja importante compreender como funciona a forma de sintaxe f? P, voc raramente tm que construir essa sintaxe. Application Builder inclui muitos assistentes que criar automaticamente estas referncias para voc. As sees seguintes descrevem especficas instncias que utilizam f? p elo sintaxe para pginas.

10.6.3. Chamando uma pgina de uma aplicao e alias Aplicao e apelidos de pgina devem consistir em identificadores vlidos para o Oracle, no pode conter nenhum espao em branco, e no so casos-sensveis. O exemplo a seguir solicita uma pgina utilizando um Request e uma pgina dentro de um alias de aplicao. Corre-se o I page da myapp e utiliza a aplicao da atual sesso ID. f? p = myapp: casa & APP_SESSION.

47

Apelidos de Request deve ser exclusivo dentro de um espao de trabalho. Se um Request existir em outro espao de trabalho deve ser usado o & c como argumento para especificar o nome workspace. Por exemplo: f? p = common_alias: casa & APP_SESSION. & c = WORKSPACE_A

10.6.4. Chamando uma pgina por um boto de URL Quando voc criar um boto, voc pode especificar uma URL de redirecionamento. Este exemplo executa pgina 6001 de aplicao 6000 e usa a atual sesso ID. f? p = 6000:6001: & APP_SESSION. Note que esta apenas uma aproximao para utilizar um boto. Este mtodo ultrapassa a pgina apresentao e funciona como um hiperlink. Outro mtodo o de apresentar a primeira pgina. Nessa abordagem, clique no boto para apresentar a pgina para a transformao, permitindo formulrios a serem apresentados e sesso estado a ser salvo. 10.6.5. Facilitar a favoritos usando zero como o id da sesso Se as pginas dentro de uma aplicao so pblicas e no requerem autenticao, voc tornar mais fcil para os usurios usando como zero a sesso ID. As pginas da aplicao que no exigem autenticao podem ser acessados com a "f? P" URLs quando a sesso ID zero (ou seja, o nico dgito 0). Quando voc solicitar uma pgina com URL no navegador ou clicando em um link em 0 para a sesso ID, o Request Engine atribudo uma nova sesso que envia os dados ao cookie seu navegador. medida que voc navega atravs da aplicao, voc vai ver que todos os links para as pginas pblicas geradas sero 0 para conter a sesso ID e de todos os ramos de pginas pblicas ter novas URLs .Nos bastidores, contudo, o Request Engine realmente usa o ID da sesso no cookie como a prpria sesso ID para localizar Sesso estado. Esse recurso til quando voc quer esconder a verdadeira sesso. Como um benefcio adicional, utilizando como nula a sesso ID tambm mantm o atual sesso ID escondido de buscas. A fim de utilizar como nula a sesso ID em seu aplicativo, voc tem de gerar pelo menos uma ligao com uma sesso ID zero. Por exemplo, quando voc poderia normalmente o cdigo link para a pgina 2 como f? p = & APP_ID.: 2: & APP_SESSION, voc teria cdigo f? p = & APP_ ID.: 2:0.

10.6.6. Substituio de strings Voc pode usar strings de substituio dentro de um modelo ou pgina com uma fonte regio com caracteres com outro valor. Como est a desenvolver a sua aplicao e permitir que os usurios editem os tens, voc usa substituio string para passar essas informaes. Pode ser utilizado das seguintes formas: Substituio Incluir uma string dentro de um modelo de referncia componente valores Referncia pgina ou aplicao itens usando & item. sintaxe Utilize-construda em substituio string para atingir um determinado tipo de funcionalidade Em especial a substituio string disponvel dentro de um modelo so indicadas pelo nmero smbolo (#). Por exemplo: # ABC # Para fazer referncia pgina ou itens da aplicao usando substituio das variveis: 1. Preceder o item com um nome comercial (&). 48

2. Anexar um ponto (.) Para o item nome. Por exemplo, voc poderia remeter para uma aplicao em um item chamado F101_X na regio HTML, ter uma regio de ttulo, um item de rtulo, ou em qualquer um dos inmeros outros contextos em que esttico texto usado, por exemplo: & F101_X. Observe o prazo exigido de trailing. Quando a pgina prestada, o Application Express substitui a substituio do valor string com o valor do item F101_X. Determinando a substituio de string a usos dentro de um determinado modelo pode-se determinar qual modelo de substituio especfico para a string apoiada e em qual templates por visualizao de definio do modelo.

10.7.

Alto-substituio strings

O APEX suporta um nmero de substituio string, pode-se precisar de referncia a esses valores para a realizao de tipos especficos de funcionalidade. As sees seguintes descrevem estas substituio de string, quanto a utiliz-los, e a sintaxe est disponvel no momento. Note que ligam variveis: usurio tem um especial significado dentro do banco de dados. Alm disso, o termo direto PL/SQL remete para o que pode ser 3utilizados em banco de dados armazenados objetos, tais como procedimentos e funes. O Application Builder suporta um nmero substituio string. Voc pode utilizar referncia a esses valores para a realizao de tipos especficos de funcionalidade. As sees seguintes descrevem esta substituio de string, quando a utiliz-los, e apoiados sintaxe est disponvel no momento. 10.7.1. APP_ALIAS APP_ALIAS deve ser alfanumrico e um nome para a aplicao atual, diferente do APP_ID em que o APP_ID deve ser nico e durante todo trabalho, todas as aplicaes hospedadas em um banco de dados. Em contrapartida, deve ser nico APP_ALIAS dentro de um espao de trabalho. Por exemplo, usando a mesma APP_ALIAS voc pode criar a aplicao, ABC, em duas diferentes reas de trabalho. Pode-se usar quase APP_ALIAS, APP_ID pode ser usado em qualquer lugar. Por exemplo, f? P pode usar uma sintaxe ou um APP_ALIAS ID aplicao como demonstrado neste exemplo: f? p = ABC: 1: & APP_SESSION. Este exemplo executa aplicao ABC, pgina 1 usando a sesso atual. Referncia: Bind variable PL / SQL Substituio string :APP_ALIAS V ( 'APP_ALIAS') & APP_ALIAS.

10.7.2. APP_ID APP_ID identifica o Request de ID executado atualmente. O seguinte um exemplo de uma substituio de string de referncia: Bind variable Direct PL / SQL PL / SQL Substituio string :APP_ID APEX_APPLICATION.G_FLOW_ID (um nmero) NV ( "APP_ID ') & APP_ID. 49

f? p = &APP_ID.: 40: & APP_SESSION. 10.7.3. APP_IMAGES Use esta substituio na sequencia que carregou a referncia de imagens, ( JavaScript) que so especficos para uma determinada aplicao e no so compartilhadas ao longo de muitas aplicaes. Se voc carregar um arquivo se tornara uma aplicao especfica, ento se deve usar essa substituio de string, ou vincular uma varivel. Bind variable Direct PL / SQL PL / SQL Substituio string Modelo substituio :APP_IMAGES No disponvel. V ( 'APP_IMAGES') & APP_IMAGES. #APP_IMAGES #

10.7.4. APP_PAGE_ID APP_PAGE_ID o ID do aplicativo atual. Por exemplo, se a sua aplicao foi a Pgina 3, em seguida, o resultado seria 3. Usando esta sintaxe til quando escreve a aplicao com componentes que precisam trabalhar genericamente em vrias aplicaes. Bind variable Direct PL / SQL PL / SQL Substituio string :APP_PAGE_ID :APP_PAGE_ID PL/SQL and Direct PL NV('APP_PAGE_ID') &APP_PAGE_ID.

Seguinte um exemplo de uma substituio string referncia: f? p = &APP_ID.:& APP_PAGE_ID.: & APP_SESSION.

10.7.5. APP_SESSION APP_SESSION um dos mais comuns utilizados na construo de substituio de string. Voc pode usar essa substituio string com hipertexto para criar ligaes entre as pginas que aplicao e manter um estado para passar o nmero da sesso plenria. Tambm se pode usar o SESSION como substituio string no lugar de APP_SESSION. Bind variable PL/SQL Short PL/SQL Substituio string :APP_SESSION V('APP_SESSION') V('SESSION') &APP_SESSION.

Considere os seguintes exemplos: De dentro de uma regio HTML: <a href="f?p=100:5:&APP_SESSION."> clique em mim </ a> Usando PL / SQL: htf.anchor ( 'f? p = 100:5:' | | V ( 'APP_SESSION') ', clique em mim'); Utilizar uma consulta SQL: SELECT htf.anchor ( 'f? P = 100:5 :'||: APP_SESSION,' Confira ') FROM DUAL;

50

10.7.6. APP_UNIQUE_PAGE_ID APP_UNIQUE_PAGE_ID um inteiro gerado a partir de uma sequencia que exclusivo Oracle para cada pgina vista. Este nmero usado pelos aplicativos para evitar a duplicao de pgina de envios e podem ser usadas para outros fins. Por exemplo, se voc quiser fazer uma URL exclusiva para evitar problemas de cache do navegador, voc pode incorporar este nmero em o Request ou depurar a coluna f, em chamadas para o procedimento. Bind variable PL/SQL :APP_UNIQUE_PAGE_ID V('APP_UNIQUE_PAGE_ID').

O seguinte um exemplo HTML:


SELECT 'f? P = 100:1 :' || :APP_SESSION || ':' || :APP_UNIQUE_PAGE_ID || '::: P1_EMPNO:' || employee_id, prenome, job_id FROM empregados

Note o uso da APP_UNIQUE_PAGE_ID no Request da coluna. Isto torna esta URL exclusiva e pode evitar problemas excessivos no cache do browser.

10.7.7. APP_USER APP_USER o atual usurio a executar o Request . Dependendo do seu modelo de autenticao, o valor do usurio estar definido de maneiras diferentes. Se o Request for executando usando autenticao de dados, ento o valor do usurio o mesmo que o banco de dados. Se a aplicao utiliza um sistema de autenticao que requer para autenticar o usurio, o valor de APP_USER fixado pela autenticao do regime, normalmente para o nome do usurio utilizado durante a autenticao. Bind variable PL/SQL Substitution string :APP_USER V('APP_USER') &APP_USER.

Considere os seguintes exemplos: De dentro de uma regio HTML: Ol estiver ligado como & APP_USER. Usando PL / SQL: htp.p ( 'Ol estiver ligado como' | | V ( 'APP_USER')); Como vincular uma varivel:
SELECT * FROMsome_tableWHEREuser_id =:APP_USER

10.7.8. AUTHENTICATED_URL_PREFIX Esta aplicao de nvel de atributo identifica um prefixo vlido de autenticidade (ou seja, uma autenticao no prefixo da URL). Voc pode usar um caminho relativo ou um caminho completo que comea com http. Este item til se o seu aplicativo pode ser executado em ambas autenticadas (autenticado em) e pblicas (no autenticado em) modos. Pode-se usar a AUTHENTICATED_URL_PREFIX para construir um link para uma pgina autenticada. mais til quando se utiliza autenticaes bsicas de dados devido a mudanas de URL, que pode exigir autenticao. Substituio string & APP_UNIQUE_PAGE_ID. 51

Bind variable PL/SQL Substitution string

: AUTHENTICATED_URL_PREFIX V('AUTHENTICATED_URL_PREFIX') &AUTHENTICATED_URL_PREFIX.

10.7.9. BROWSER_LANGUAGE BROWSER_LANGUAGE remete para o navegador da Web atual da preferncia de idioma. Bind variable Direct PL/SQL PL/SQL Substitution string :BROWSER_LANGUAGE APEX_APPLICATION.G_BROWSER_LANGUAGE V('BROWSER_LANGUAGE') :BROWSER_LANGUAGE. &BROWSER_LANGUAGE.

10.7.10. CURRENT_PARENT_TAB_TEXT CURRENT_PARENT_TAB_TEXT mais til na pgina de templates, mas s relevante para aplicaes que utilizam dois guias de nvel (ou seja, pais e guias padro). Use esta ligao para fazer referncia ao rtulo da me guia. Esta substituio de string permite que voc repita a me atualmente selecionada na guia dentro do modelo da pgina. Bind variable Substitution string Not Available. &CURRENT_PARENT_TAB_TEXT

10.7.11. DEBUG Os valores vlidos para o flag de DEBUG so Sim ou No. Passando o debug mostra em detalhes acerca dos requerimentos de transformao. Se for escrever seu prprio cdigo personalizado, voc pode querer gerar um debug com suas prprias informaes, para isso a flag deve estar definido para Sim. Bind variable Direct PL/SQL PL/SQL Substitution string :DEBUG APEX_APPLICATION.G_DEBUG V('DEBUG') &DEBUG.

f?p=100:1:&APP_SESSION.::&DEBUG

10.7.12. HOME_LINK HOME_LINK a pgina de uma aplicao, o Application Express ir redirecionar a este local, caso no seja dada pgina e se no houver alternativa. A pgina ditada pela lgica do sistema de autenticao. Voc define o Home Link sobre a Aplicao em Atributos da pgina. Direct PL/SQL PL/SQL Template Reference APEX_APPLICATION.G_HOME_LINK V('HOME_LINK') #HOME_LINK# 52

Substitution string

&HOME_LINK.

10.7.13. LOGIN_URL Use LOGIN_URL para exibir um link para uma pgina de login para os usurios que no esto atualmente autenticados. Bind variable Direct PL/SQL PL/SQL Substitution string Template Substitution :LOGIN_URL APEX_APPLICATION.G_LOGIN_URL V('LOGIN_URL') &LOGIN_URL. #LOGIN_URL#

10.7.14. IMAGE_PREFIX O valor da IMAGE_PREFIX determina o caminho virtual do servidor Web que usa o ponto para as imagens no diretrio distribudo com o APEX. Se voc quiser fazer referncias de imagens enviadas, use WORKSPACE_IMAGES e APP_IMAGES. Bind variable Direct PL/SQL PL/SQL Substitution string Template Substitution : IMAGE_PREFIX APEX_APPLICATION.G_IMAGE_PREFIX V ( 'IMAGE_PREFIX') & IMAGE_PREFIX. #IMAGE_PREFIX #

Se voc estiver gerando chamadas para as aplicaes de dentro do seu PL / SQL, voc pode necessidade de referncia do esquema proprietrio do APEX. A seguir descreve a sintaxe correta para o PL / SQL de referncia: APEX_APPLICATION.G_FLOW_SCHEMA_OWNER Voc tambm pode utilizar #FLOW_OWNER# como referncia a esse valor em consultas SQL e PL / SQL (por exemplo, em uma regio ou de um processo).

10.7.15. PRINTER_FRIENDLY O valor da PRINTER_FRIENDLY determina se esta Application Express pode imprimir em modo de vista. Esta configurao pode ser referenciada em condies de eliminar elementos no desejados em um documento impresso a partir de uma pgina. Direct PL/SQL PL/SQL Substitution string APEX_APPLICATION.G_HOME_LINK (VARCHAR2 DATATYPE) V('PRINTER_FRIENDLY') &PRINTER_FRIENDLY.

10.7.16. LOGOUT_URL LOGOUT_URL um aplicativo de nvel de atributo utilizado para identificar o logout da URL. Esta uma URL que o usurio navega para uma pgina ou logout opcionalmente e cria logs diretamente a um usurio. Para criar uma barra de navegao entrada do logout, adicione um perodo de trailing & LOGOUT_URL (& LOGOUT_URL.). Se estiver com uma codificao de uma pgina modelo, use# LOGOUT_URL#. 53

Bind variable PL/SQL Substitution string Template Substitution

:LOGOUT_URL V('LOGOUT_URL') &LOGOUT_URL. #LOGOUT_URL#

10.7.17. PROXY_SERVER PROXY_SERVER uma aplicao de atributo. O atributo pode ser utilizado pelas regies cuja origem vem de uma URL. O seguinte a sintaxe correta para uma referncia PL/SQL utilizado para acesso remoto de servidores Web a partir de dentro do banco de dados (por exemplo, quando se utiliza o pacote enviado utl_http com o banco de dados). APEX_APPLICATION.G_PROXY_SERVER

10.7.18. PUBLIC_URL_PREFIX PUBLIC_URL_PREFIX um atributo que identifica uma URL para alternar a partir de um incio de sesso em modo pblico. Sintaxe: Bind variable PL/SQL Substitution string Template Substitution :PUBLIC_URL_PREFIX V('PUBLIC_URL_PREFIX') &PUBLIC_URL_PREFIX. #PUBLIC_URL_PREFIX#

10.7.19. REQUEST Cada boto define o valor do Request, o atributo se associa com o boto. Isso permite que aceite a transformao de referncia ao nome do boto quando um usurio clica-lo. Na f? P sintaxe, REQUEST pode ser fixado recorrendo ao quarto argumento. Referenciando o Valor do Request O Request tipicamente referenciados durante o Aceitar transformao (ou seja, a transformao que ocorre quando voc postar uma pgina).Este consiste de clculos, validaes, processos e sucursais. O valor do Request est disponvel durante cada fase. Depois que um de Request direcionado para uma pgina diferente, ser definido para NULL. Bind variable Direct PL/SQL PL/SQL Substitution string :REQUEST APEX_APPLICATION.G_REQUEST V('REQUEST') &REQUEST &REQUEST. (exact syntax match)

10.7.20. Condies comuns a referncia Request Utilizando condies. Por exemplo, voc pode querer redefinir a paginao quando um usurio clica para ir a um relatrio da pgina. Pode tambm redefinir a paginao atravs da criao de uma pgina de 54

apresentar processo. A pgina pode ser condicionada a um processo usando a condio Request = Expresso 1. Para apresentar um processo pgina: 1. Sob Condio, selecione o tipo de condio Request = Expresso 1. 2. Em Expresso 1, digite GO. Usando o Request de Processamento, voc pode tambm utilizar o Request Show de transformao quando se navega a uma pgina utilizando f? p sintaxe. Por exemplo: f? p = 100:1: & APP_SESSION.: GO Lembre-se que o quarto argumento, no f? P sintaxe REQUEST . Este exemplo vai aplicao 100, pgina 1 para a sesso atual, e estabelece o valor do Request para GO. Qualquer processo ou regio pode fazer referncia do valor do Request atravs Mostrar transformao. O seguinte um exemplo similar usando PL / SQL:
IF V('REQUEST S')='GO'THEN htp.p ('hello'); ENDIF;

Note que htp.p ( 'hello') uma chamada para um PL / SQL Web Toolkit para imprimir para fora o texto especificado da string.

10.7.21. SQLERRM SQLERRM um modelo de substituio disponvel apenas na Regio de Aplicaes de Mensagem de Erro. O seguinte descreve a sintaxe correta para a regio a um modelo de substituio referncia: # SQLERRM# 10.7.22. SYSDATE_YYYYMMDD SYSDATE_YYYYMMDD representa a data atual no servidor de banco de dados, com o Formato AAAAMMDD (mscara aplicada). Voc pode usar esse valor em vez dos repetidos apelos para a funo SYSDATE (). A lista a seguir descreve a sintaxe para referencia SYSDATE_YYYYMMDD. Bind variable PL/SQL Direto PL / SQL Bind variable PL/SQL Direto PL / SQL : SYSDATE_YYYYMMDD V ( 'SYSDATE_YYYYMMDD') APEX_APPLICATION.G_SYSDATE (DATA Datatype) :SYSDATE_YYYYMMDD V('SYSDATE_YYYYMMDD') APEX_APPLICATION.G_SYSDATE (DATE DATATYPE)

55

Por Daiane L. Schvepe * Alguns tpicos foram traduzidos da apostila da Oracle, sobre APEX.

56

11.

ndice de Imagens

Figura 1. Arquitetura. ........................................................................................................................................ 4 Figura 2. Login. .................................................................................................................................................. 5 Figura 3. Aplicao, Etapa 1. Criao................................................................................................................. 7 Figura 4. Aplicao, Etapa 2. Mtodo. ............................................................................................................... 7 Figura 5. Aplicao, Etapa 3. Definio. ............................................................................................................ 8 Figura 6. Aplicao, Etapa 4. Nome para aplicao........................................................................................... 8 Figura 7. Aplicao, Etapa 5. Pginas da aplicao. .......................................................................................... 9 Figura 8. Aplicao, Etapa 6. Pginas da aplicao adicionar pginas. .......................................................... 9 Figura 9. Aplicao, Etapa 6. Finalizar. ............................................................................................................ 10 Figura 10. Aplicao, Etapa 7........................................................................................................................... 10 Figura 11. Opes da Aplicao. ...................................................................................................................... 11 Figura 12. Login. .............................................................................................................................................. 12 Figura 13. Aplicao > Objetos de Apoio. ........................................................................................................ 12 Figura 14. Aplicao > Componentes Compartilhados.................................................................................... 13 Figura 15. Aplicao > Utilitrios. .................................................................................................................... 13 Figura 16. Aplicao > Importar e Exportar. .................................................................................................... 14 Figura 17. Criao da pgina. .......................................................................................................................... 15 Figura 18. Relatrio. ........................................................................................................................................ 16 Figura 19. Relatrio - Etapa 1. Criando a pgina. ............................................................................................ 16 Figura 20. Relatrio - Etapa 2. Definio da Pgina. ....................................................................................... 17 Figura 21. Relatrio - Etapa 3. Definio de Tabs............................................................................................ 17 Figura 22. Relatrio - Etapa 4. Query builder. ................................................................................................. 18 Figura 23. Relatrio - Etapa 4. Finalizao. ..................................................................................................... 18 Figura 24. Tipo Formulrio. ............................................................................................................................. 20 Figura 25. Formulrio - Etapa 1. Escolha do tipo............................................................................................. 20 Figura 26. Formulrio - Etapa 2. Definio de Owner e Nome de Tabela. ...................................................... 21 Figura 27. Formulrio - Etapa 3. Definies da pgina. ................................................................................... 21 Figura 28. Formulrio - Etapa 4. Definio de Tabs......................................................................................... 22 Figura 29. Formulrio - Etapa 5. Chave Primria. ............................................................................................ 22 Figura 30. Formulrio - Etapa 6. Origem do cdigo da PK............................................................................... 23 Figura 31. Formulrio - Etapa 7. Seleo de colunas da pgina. ..................................................................... 23 Figura 32. Formulrio - Etapa 8. Escolhendo os botes. ................................................................................. 24 Figura 33. Formulrio - Etapa 9. Ramificaes da pgina. .............................................................................. 24 Figura 34. Formulrio - Etapa 10. Finalizao. ................................................................................................ 25 Figura 35. Regio Etapa 1. Escolher regio................................................................................................... 25 Figura 36. Regio Etapa 2. Escolher tipo. ..................................................................................................... 26 Figura 37. Regio Etapa 3. Atributos de Exibio. ........................................................................................ 26 Figura 38. Regio - Etapa 4. Origem. .............................................................................................................. 26 Figura 39. Regio - Etapa 5. Atributos do Relatrio. ...................................................................................... 27 Figura 40. Regio - Etapa 6. Exibio Condicional. .......................................................................................... 27 57

Figura 41. Boto> Adicionar. ........................................................................................................................... 30 Figura 42. Adicionar boto- Etapa 1. Definir Regio do boto. ....................................................................... 30 Figura 43. Adicionar boto - Etapa 2. Posio do Boto. ................................................................................ 31 Figura 44. Adicionar boto - Etapa 3. Atributos. ............................................................................................. 31 Figura 45. Adicionar boto - Etapa 4. Posio do boto. ................................................................................ 32 Figura 46. Adicionar boto - Etapa 5. Ao quando clicado. ........................................................................... 32 Figura 47. Adicionar boto - Etapa 6. Condio deexibio. ........................................................................... 33 Figura 48. Componetes Compartilhados -Temas. ........................................................................................... 35 Figura 49.Temas - Etapa1. Criar Tema............................................................................................................. 35 Figura 50. Temas - Etapa 2. Mtodo. .............................................................................................................. 36 Figura 51. Temas - Etapa 3. Identificar Tema. ................................................................................................. 36 Figura 52. Temas - Etapa 4. Confirmar Tema. ................................................................................................. 37 Figura 53. Temas - Etapa 5. Alterar Tema. ...................................................................................................... 37 Figura 54. Temas - Etapa 6. Identificar tema a alterar. ................................................................................... 37 Figura 55. Temas - Etapa 7. Verificar Compatibilidade. .................................................................................. 38 Figura 56. Temas - Etapa 8. Confirmar Alterao. ........................................................................................... 38 Figura 57. Validao - Etapa1. ......................................................................................................................... 39 Figura 58. Validao - Etapa 2. Nvel de Avaliao. ......................................................................................... 39 Figura 59. Validao - Etapa 3. Item/Coluna. .................................................................................................. 40 Figura 60. Validao - Etapa 4. Sequncia e Nome. ........................................................................................ 40 Figura 61. Validao - Etapa 5. Tipo de Validao. .......................................................................................... 40 Figura 62. Validao - Etapa 6. Validao. ....................................................................................................... 41 Figura 63. Validao - Etapa 7. Condio e Confirmao. ............................................................................... 41 Figura 64. SQL Workshop. ............................................................................................................................... 42 Figura 65. Equipe de Desenvolvimento. .......................................................................................................... 42 Figura 66. Administrao. ................................................................................................................................ 43

58