Mostrar TudoControle do Código de OrigemAplicações EmpacotadasDepuração

Controle do Código de Origem

Exportando Aplicações

O Oracle Application Express exporta arquivos de criação de script SQL que podem ser importados para qualquer instância do Oracle APEX, desde que as versões do Oracle Application Express sejam compatíveis. As aplicações podem ser exportadas diretamente do Oracle APEX Application Builder, do SQL Developer (se a conexão for para o proprietário do esquema do Oracle Application Express) ou da linha de comando.

Quando os desenvolvedores concluírem o desenvolvimento de uma aplicação, a Oracle recomenda que eles exportem sua aplicação e a salvem em um sistema de controle de código-fonte. Esse arquivo de exportação deve, em seguida, ser usado para criar todos os outros ambientes (Teste, Produção, etc.)

Automatizando Exportações da Aplicação

A instalação do Oracle Application Express inclui uma pasta de utilitário que contém programas de Exportação do APEX que podem ser usados para exportar aplicações da linha de comando,s sem exigir uma exportação manual da Interface Web do Application Express. Há dois programas disponíveis – um para exportação da aplicação completa, e outro que divide os componentes da aplicação em scripts SQL separados.

Recomendamos que você faça backup automaticamente de suas aplicações Oracle Application Express usando estes programas da linha de comandos como parte a sua estratégia de recuperação de desastres. Implementar diariamente um job do banco de dados, exporta automaticamente todas as aplicações do Application Express que fornece facilidades para implementar processos de recuperação.

Divisão da Aplicação

As aplicações do Application Express podem incluir scripts de instalação opcionais que fornecem implantação do arquivo único. O divisor gera muitos arquivos, por exemplo, cada página é seu próprio script SQL. O divisor também gera um arquivo de controle que chama os arquivos de divisão. Quando combinados com um sistema de controle de código de origem, como SVN, ele fornece a capacidade de gerenciar o controle de alteração da Oracle Application Express em um nível detalhado

Aplicações Empacotadas

As aplicações desenvolvidas no Oracle Application Express são salvas como metadados no repositório do Oracle Application Express dentro do Oracle Database. No entanto, as aplicações são baseadas em vários objetos do banco de dados, como tabelas e views e podem chamar outros objetos do banco de dados como packages, funções e procedures. Além disso, antes de executar uma aplicação, pode ser necessário, inserir, atualizar ou deletar vários registros do banco de dados. Todas essas alterações de DDL e DML devem ser gravadas nos scripts SQL e executadas em um ambiente de destino antes de importar a aplicação do Oracle Application Express. Utilizando os Objetos de Suporte do Oracle Application Express, estes arquivos de script SQL podem ser submetidos a upload e incluídos na exportação da aplicação, criando uma Aplicação Empacotada. Isso garantirá que os scripts de pré-requisitos são executados corretamente.

Os arquivos estáticos também podem ser incorporados em uma Aplicação Empacotada para simplificar a instalação, pois somente um arquivo precisa ser implantado.

Empacotando Aplicações

O empacotamento de uma aplicação combina a instalação de todos os componentes necessários para instalar uma aplicação. Isso inclui objetos do banco de dados, como tabelas, dados do banco de dados, a própria aplicação Oracle Application Express e todos os arquivos de suporte, como imagens, CSS e Javascript.

Instalação da Aplicação

Depois que uma aplicação for empacotada em um arquivo único, a instalação é executada através do upload da aplicação ao Oracle Application Express usando o recurso de importação. Isso iniciará um assistente que fará parse do arquivo, executará verificações de pré-instalação definidas e, em seguida, instalará a aplicação. Depois que a definição da aplicação Application Express for instalada, os objetos de suporte também podem ser instalados.

Depuração

Instrumentação do Código

Você pode instrumentar seu código PL/SQL do Oracle Application Express dentro dos procedures e functions de PL/SQL usando o package APEX_DEBUG_MESSAGE. A depuração pode ser ativada de forma seletiva em até 7 níveis diferentes. Por exemplo:

begin
   apex_debug_message.log_message('I AM HERE');
end;

A depuração pode ser ativada clicando-se no link Depurar na barra de ferramentas do desenvolvedor ou pode ser ativado de forma seletiva, usando o package APEX_DEBUG_MESSAGE. Por exemplo, se você quiser ativar a depuração de um usuário denominado MIKE no nível 3, você pode emitir a chamada de API do Oracle Application Express em um processo do cabeçalho anterior em nível de aplicação ou página.

begin
   if :APP_USER = 'MIKE' then
      apex_debug_message.enable_debug_messages(3);
   end if;
end;
Depuração Incorporada

Ativar a depuração na barra de ferramentas do desenvolvedor, através do URL ou de forma programada através do package APEX_DEBUG_MESSAGE, pode ativar as mensagens de depuração do Oracle Application Express. Estas mensagens indicam vários eventos de processamento de página e exibem temporizações altamente granulares, de forma que você possa controlar o desempenho e os erros de lógica.

Exibindo a Saída de Depuração

Os desenvolvedores podem exibir a saída da depuração, clicando no link Exibir Depuração na Barra de Ferramentas do Desenvolvedor. A saída da depuração mostra os dados de temporização para 1/10000 de um segundo e exibe o usuário da aplicação, sessão e outras informações úteis para depurar o desempenho e os problemas de lógica.

Depuração Remota

Você pode usar o Oracle SQL Developer para depurar o PL/SQL remotamente. Este recurso é muito útil quando uma aplicação não está falhando, mas também não está produzindo os resultados esperados. Quando implementado, o SQL Developer será chamado quando o package, procedure ou function do banco de dados for chamado de um Application Express e permitirá que você percorra o processamento complexo de PL/SQL que não está executando a função desejada. A revisão dos valores de dados, conforme você percorre o programa, geralmente ajuda a identificar a lógica incorreta.