Oracle Application Express. Aplicativos e páginas

Continuação do tutorial.

Esta parte descreve os processos para criar um aplicativo Oracle APEX e criar páginas no aplicativo.

Parte anterior: Tutorial do Oracle Application Express. Visão geral do IDE

Sumário

Criação de aplicativo
Páginas padrão
Lançamento do aplicativo
Criação de página
Componentes da página principal
Elementos visuais
Elementos não visuais
Propriedades básicas dos elementos
Propriedades Gerais
Propriedades da página

Criação de aplicativo

Para criar um aplicativo, você precisa acessar o App Builder e clicar no botão "Criar".

Em seguida, o assistente de criação do aplicativo é iniciado. No primeiro passo, você precisa selecionar "Novo aplicativo", no segundo - basta preencher os campos "Nome" e o ID do aplicativo (número do aplicativo). O nome é necessário simplesmente porque é um campo obrigatório e Application ID - porque não será possível alterá-lo. Mais precisamente, é possível (através da exportação / importação), mas é longo e inconveniente, é melhor definir imediatamente o número desejado se o ápice gerado automaticamente não for adequado para você. O número deve ser único. Este número é usado como parte do endereço do aplicativo. Vejamos um URL típico do ápice:

 https://apex.oracle.com/pls/apex/f?p=123456:1:14675052744498::::: 

Aqui 123456 é o ID do aplicativo.

Nos demais campos do assistente, você ainda pode ignorar todas essas configurações que podem ser alteradas posteriormente.

Depois disso, você precisa clicar em "Criar aplicativo", o ápice criará o aplicativo e o moverá automaticamente para a página do aplicativo, onde você verá

Páginas padrão

Por padrão, o apex criará 3 páginas no aplicativo. Páginas, como aplicativos, têm um número e um título. O número é usado da mesma maneira no URL para identificar a página, segue imediatamente o número do aplicativo e é separado por dois pontos. Ou seja, o formato é o seguinte:

 https://apex.oracle.com/pls/apex/f?p=APPLICATION_ID:PAGE_ID:<  url> 

As páginas padrão criadas são:

• Página global (ID da página: 0)
  Esta é uma página especial que não é usada de forma independente, mas à qual você pode adicionar algum elemento se desejar que ele apareça em todas as páginas.

• Página inicial (ID da página: 1)
  Esta é a página inicial do aplicativo. Você chegará a ele por padrão depois de inserir o login e a senha no aplicativo, ou se especificar o URL do seu aplicativo sem especificar uma página e tudo o mais, isto é:

  
  

   https://apex.oracle.com/pls/apex/f?p=123456 

  
  
• Página de logon (ID da página: 9999, nas versões 4.x, 5.x e 101)
  Esta é obviamente a página de login. Ele contém campos para inserir um login e senha, por algum tempo (não sei o nome da versão, mas relativamente recentemente) - uma caixa de seleção "Lembrar nome de usuário" e um botão "Entrar".

Aplicativos e páginas também possuem a propriedade Alias útil. Para um aplicativo, essa propriedade é configurada nas propriedades do aplicativo ("Propriedades do aplicativo" → "Definição" → "Nome" → "Alias ​​do aplicativo") e, para uma página, no editor de páginas no painel de propriedades à direita. Alias pode ser usado no URL da página em vez do número. A página de login padrão é criada com o LOGIN_DESKTOP LOGIN_DESKTOP e a página inicial com o alias HOME . Se você definir o alias do aplicativo MY_APP , poderá acessar a página de login em

 https://apex.oracle.com/pls/apex/f?p=MY_APP:LOGIN_DESKTOP 

Lançamento do aplicativo

Agora que o aplicativo foi criado, ele já pode ser "iniciado" (ainda não há nada a ver). Isso não é exatamente o mesmo que iniciar um aplicativo comum (como no Windows ou Linux). O aplicativo apex é renderizado pelo mesmo mecanismo que o próprio IDE; portanto, assim que você cria o aplicativo, ele fica pronto para uso instantaneamente, e qualquer pessoa que insere seu endereço na barra de endereços pode trabalhar com ele. O lançamento do próprio aplicativo, de fato, é exatamente esse nome para abrir a página inicial (aquela com o número 1). Você pode iniciar o aplicativo de várias maneiras:

• No App Builder, na lista de aplicativos, há uma coluna "Executar" com um botão oposto a cada aplicativo;
• na página do aplicativo, há um grande botão "Executar aplicativo";
• você pode "iniciar" não apenas o aplicativo, mas também qualquer página que não seja da caixa de diálogo (as caixas de diálogo podem ser chamadas apenas de páginas regulares): na lista de páginas da aplicação, há também uma coluna com o botão "Executar";
• Você pode iniciar a página atual no editor de páginas, clicando no botão no canto superior direito;
• e, finalmente, você pode iniciar a página se houver esses botões no canto superior direito:

Esses dois botões estão em praticamente qualquer seção do IDE. A esquerda contém o número da última página que você abriu no editor de páginas. Ao clicar nela, você procederá à edição desta página e, ao clicar no botão direito, abrirá esta página.

O que acontecerá após o lançamento? Se a página iniciada tiver acesso limitado, primeiro o usuário será redirecionado para a página de login. Se o usuário já estiver logado ou a página de configurações estiver marcada como pública, essa página será aberta.
Por padrão, a página é criada com acesso limitado. Existem duas configurações possíveis nas propriedades da página ( Editor de páginas - painel direito - grupo de propriedades "Segurança" - "Autenticação"):

• Page Requires Authentication : a página estará disponível apenas para usuários conectados durante a sessão;
• Page is Public : uma página pública que é visível para usuários registrados e não registrados.

Criação de página

Você pode criar uma página na página do aplicativo . Clique em "Criar" e o assistente de criação da página será iniciado. Etapas do assistente:

1. Selecionando um tipo de página (no momento) 12 tipos, alguns dos quais também têm subtipos (se houver) aparecerão na próxima etapa). O primeiro tipo da lista é a "Página em branco", ou seja, uma página em branco sem tudo. Os tipos restantes são opções de página comuns para trabalhar com o banco de dados: relatórios, formulários de entrada, gráficos etc. Aqui, descreverei o processo de criação de uma página em branco, e os tipos restantes terão um artigo separado.
2. Digite o número da página e o título. Eu falei sobre os números acima; o número é definido nesta etapa e, portanto, não será possível alterá-lo; portanto, observe com cuidado. Às vezes, os desenvolvedores dividem as páginas em grupos (para fins funcionais, por exemplo) e reservam um intervalo de números para cada grupo; portanto, se você usar isso em seu projeto, tenha cuidado. Imediatamente você precisa escolher o tipo de página: normal, diálogo modal, diálogo sem modelo.
3. Personalize itens de navegação. Você pode pular (clique em "Avançar") e configurar mais tarde (embora se você já tiver algum tipo de sistema de navegação incorporado, é conveniente definir tudo imediatamente nesta etapa e não tomar mais banho de vapor).
4. Confirmação de criação.

Depois disso, a página é criada e pronta para uso.

Componentes da página principal

Elementos visuais

Elementos visuais são elementos que de alguma forma são exibidos na tela. Isto é:

• Menu superior. Ele contém o nome do aplicativo, logotipo, nome de usuário, o link "Logout" (se o usuário estiver logado). Lá você pode adicionar outros elementos;
• Menu de navegação à esquerda. Pode ser usado para navegar no aplicativo, criando, por exemplo, uma estrutura hierárquica das seções do aplicativo;
• Regiões (geralmente em russo, são chamadas de "regiões"): recipientes de elementos. Pode conter relatórios, gráficos, campos de entrada, botões e outras regiões;
• Itens (não há tradução bem estabelecida para o russo, eles dizem quem é o quê, geralmente usam as palavras item, campo e geralmente apenas um item): esses são vários campos para entrada do usuário;
• Botões (botões): bem, esses são botões comuns, enfim, o que mais posso dizer;)
• Relatórios: tabelas com dados baseados em consultas SQL;
• Gráficos / tabelas: exibição gráfica de informações do banco de dados, também com base em consultas SQL.

Relatórios e gráficos podem ser considerados como variedades de regiões (tecnicamente são), mas ao mesmo tempo são entidades bastante independentes, com seu próprio comportamento, propriedades e outras.

Elementos não visuais

Esses são elementos para garantir a lógica do aplicativo. Na verdade, existe uma enorme variedade de elementos, embora o usuário literalmente não os veja. Os principais tipos são:

• Processo: como regra, o código PL / SQL é executado no servidor em resposta a qualquer ação do usuário;
• Validação: Um tipo de processo para validar a entrada do usuário;
• Ação dinâmica (não há tradução estabelecida, geralmente todos a escrevem - Ação dinâmica ou apenas DA, e quando você está com preguiça de mudar o layout, o orador pode escrever uma ação ou SIM): o processo executado pelo navegador. Por fim, o DA é um manipulador para um evento javascript. Saber o javascript é opcional, mas se você souber (e seletores de CSS ao mesmo tempo), poderá fazer maravilhas;
• Ramos (sem tradução estabelecida): redireciona para outras páginas, dependendo de algumas condições.

Propriedades básicas dos elementos

Propriedades Gerais

Os principais grupos de propriedades característicos de cada (ou quase todo) tipo de elemento. Eles podem ser visualizados e editados no editor de páginas. Aqui, descreverei brevemente seu objetivo (para que você saiba o que procurar), e em mais detalhes contarei em outros artigos.

• Identification : define o nome do elemento e propriedades adicionais (dependendo do tipo);
• Appearance : propriedades responsáveis ​​pela aparência do elemento visual. Para cada tipo de elemento, há um conjunto de modelos, você pode selecionar um deles aqui (propriedade Template ). Além disso, os modelos têm configurações adicionais ( Template Options - clicando no botão, uma janela com as configurações será aberta);
• Layout : ajuste a posição do elemento visual na página. Os elementos são organizados em uma grade de 12 colunas, aqui você pode especificar como eles devem ser localizados;
• Source : para regiões e itens - uma fonte de dados para exibição, para processos - um código de processo;
• Server-side Condition : uma condição verificada no servidor (há uma enorme variedade de condições, desde as mais simples, como essa e esse elemento tem esse valor, até o código PL / SQL arbitrário). O elemento será exibido na página se essa condição for atendida e, se não for, não será. Além disso, não será oculto, mas simplesmente não será renderizado;
• Client-side Condition (para Dynamic Action ): uma condição verificada no cliente (sem acessar o servidor). O DA será satisfeito se a condição for atendida;
• Read only : funciona da mesma forma que Server-side Condition , apenas controla não a presença / ausência de um elemento, mas a capacidade de alterar o valor. Esta propriedade é para itens, regiões e páginas. Para um item, ele se aplica ao item em si, e para regiões / páginas, a todos os itens na região / página correspondente;
• Security : controle o acesso ao item. Em princípio, tudo pode ser feito usando Server-side Condition , mas é melhor distinguir entre: Server-side Condition - para lógica do aplicativo, Security - para exibição dependendo dos direitos de acesso.
• Configuration : para ativar / desativar a Build Option . Uma coisa muito óbvia, mas muito útil: permite ativar ou desativar recursos individuais do aplicativo, o que é muito conveniente quando você desenvolve recursos em paralelo para várias versões diferentes;
• Comments : comentários para outros desenvolvedores;
• Help (para elementos visuais): Ajuda para usuários finais do aplicativo.

Propriedades da página

Propriedades específicas da página:

• Navigation : existem duas propriedades neste grupo. Cursor Focus indica se o Cursor Focus deve ser transferido para o campo de entrada na página imediatamente após o carregamento (opções - não transmite ou transfere para o primeiro campo da página). Warn on Unsaved Changes usuário saia da página se houver dados não salvos;
• JavaScript : permite adicionar código JavaScript à página. Você pode especificar o caminho para o arquivo ou adicionar seu código diretamente à página;
• CSS : o mesmo para CSS. Inclua um arquivo ou adicione à página se precisar de algum tipo de configuração CSS local apenas para esta página;
• Advanced : permite ativar ou desativar a proteção contra o reenvio do formulário.