Oracle APEX é uma poderosa plataforma de desenvolvimento de aplicações baseada na web que permite criar aplicativos empresariais de forma rápida e eficiente. Este guia oferece instruções detalhadas para instalação e configuração do Oracle APEX em seu ambiente.

1. Entendendo a Arquitetura do Oracle APEX

O Oracle APEX utiliza uma arquitetura simples na qual as páginas são geradas dinamicamente usando metadados armazenados no banco de dados Oracle. Esta arquitetura consiste em:

Navegador web: Interface para desenvolvedores e usuários finais
Oracle REST Data Services (ORDS): Servidor web que atua como intermediário de comunicação
Banco de dados Oracle: Armazena os objetos APEX e metadados

A principal vantagem desta arquitetura é a separação entre a camada intermediária e a camada de banco de dados. O ORDS funciona como um agente de comunicação entre o navegador web e os objetos APEX no banco de dados Oracle, mapeando solicitações do navegador em chamadas de procedimentos armazenados.

2. Planejando sua Instalação

Antes de instalar o Oracle APEX, é importante planejar cuidadosamente sua implementação:

Decida entre ambiente completo ou runtime: Um ambiente completo fornece acesso ao ambiente de desenvolvimento App Builder. Um ambiente runtime é adequado para implementações de produção onde os aplicativos não serão modificados.
Verifique os requisitos de instalação: Certifique-se de que seu sistema atende aos requisitos mínimos.
Planeje seus tablespaces: Determine quais tablespaces serão utilizados para os usuários APEX.

3. Preparação para Pré-instalação

Antes de instalar o APEX, complete os seguintes passos:

Faça backup do banco de dados Oracle: Recomenda-se criar um backup da instalação atual do banco de dados Oracle antes de instalar o APEX.
Desligue instâncias ativas: Se você estiver atualizando de uma instalação anterior, desligue as instâncias Oracle Database onde planeja instalar o APEX.
Desabilite o acesso ao APEX durante atualizações: Em ambientes de alta disponibilidade, onde desligamentos planejados não são viáveis, você pode impedir o acesso dos usuários ao APEX durante a atualização.

4. Download do Oracle APEX

Para instalar o Oracle APEX:

Para instalações onde o desenvolvimento será apenas em inglês, baixe o arquivo apex_24.2_en.zip da página de download do APEX.
Para desenvolvimento em vários idiomas, baixe o arquivo apex_24.2.zip.
Descompacte o arquivo preservando os nomes dos diretórios:
- UNIX/Linux: $ unzip apex_24.2.zip
- Windows: Clique duas vezes no arquivo apex_24.2.zip no Windows Explorer

Dica: Mantenha a árvore de diretórios onde você descompacta os arquivos curta e sem espaços. Por exemplo, no Windows, descompacte para C:\TEMP.

5. Instalação do Oracle APEX

5.1 Instalação do Ambiente de Desenvolvimento Completo

Mude seu diretório de trabalho para apex
Inicie o SQLcl e conecte-se ao banco de dados como SYS com privilégio SYSDBA:

-- No Windows
SYSTEM_DRIVE:\ sql /nolog
SQL> CONNECT SYS as SYSDBA
Enter password: SYS_password

-- No UNIX/Linux
$ sql /nolog
SQL> CONNECT SYS as SYSDBA
Enter password: SYS_password

Desabilite regras de complexidade de senha existentes para o perfil padrão
Execute o script apexins.sql passando os seguintes argumentos:

@apexins.sql tablespace_apex tablespace_files tablespace_temp images

Onde:

tablespace_apex é o nome do tablespace para o usuário da aplicação APEX
tablespace_files é o nome do tablespace para o usuário de arquivos APEX
tablespace_temp é o nome do tablespace temporário ou grupo de tablespace
images é o diretório virtual para imagens APEX (recomenda-se usar /i/)

Exemplo:

@apexins.sql SYSAUX SYSAUX TEMP /i/

5.2 Instalação do Ambiente de Runtime

Para instalar apenas o ambiente de runtime, execute apxrtins.sql com os mesmos argumentos:

@apxrtins.sql SYSAUX SYSAUX TEMP /i/

Quando o APEX é instalado, ele cria as seguintes contas de banco de dados:

APEX_240200: Esta conta é proprietária do esquema APEX e metadados
FLOWS_FILES: Esta conta é proprietária dos arquivos carregados no APEX
APEX_PUBLIC_USER: Conta com privilégios mínimos usada pelo ORDS
APEX_PUBLIC_ROUTER: Conta com privilégios mínimos usada para um módulo REST do ORDS

6. Configuração da Conta de Administrador

6.1 Sobre o Administrador da Instância

Os administradores de instância são superusuários responsáveis por gerenciar toda a instância Oracle APEX, incluindo provisionamento de workspaces, configuração de recursos e gerenciamento de segurança.

6.2 Executando o script apxchpwd.sql

Nota: Ignore esta seção se estiver atualizando de uma versão anterior do Oracle APEX. Em um cenário de atualização, a senha da conta do Administrador da Instância é preservada.

Para criar ou atualizar sua conta de Administrador da Instância:

Mude seu diretório de trabalho para apex
Inicie o SQLcl e conecte-se como SYS com privilégio SYSDBA
Execute o script apxchpwd.sql:

@apxchpwd.sql

Siga as instruções na tela. Você será solicitado a fornecer um nome de usuário, senha e endereço de e-mail.

7. Configuração das Contas do Sistema

7.1 Configurando a Conta APEX_PUBLIC_USER

A conta APEX_PUBLIC_USER é criada com uma senha aleatória em uma nova instalação do Oracle APEX. Você deve alterar a senha desta conta antes de configurar o descriptor de acesso ao banco de dados (DAD).

7.2 Desbloqueando a Conta APEX_PUBLIC_USER

ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK

7.3 Alterando a Senha da Conta APEX_PUBLIC_USER

ALTER USER APEX_PUBLIC_USER IDENTIFIED BY nova_senha

7.4 Sobre a Expiração de Senha no Oracle Database

No perfil padrão do Oracle Database, o parâmetro PASSWORD_LIFE_TIME é definido como 180 dias. Para evitar a expiração da senha para APEX_PUBLIC_USER, crie outro perfil com PASSWORD_LIFE_TIME definido como "unlimited" e atribua a conta APEX_PUBLIC_USER a este novo perfil.

7.5 Configurando a Conta APEX_PUBLIC_ROUTER

A conta APEX_PUBLIC_ROUTER é uma conta com privilégios mínimos usada para um módulo REST do ORDS resolver URLs amigáveis. Em sistemas muito ativos, APEX_PUBLIC_ROUTER pode atingir o número máximo de sessões permitidas no banco de dados, resultando em um erro "Service Unavailable HTTP 503".

Para resolver isso, crie outro perfil com o parâmetro SESSIONS_PER_USER definido como "unlimited" e atribua a conta APEX_PUBLIC_ROUTER a este novo perfil.

Após cada atualização do ORDS ou se o ORDS for instalado após a instalação do APEX, execute o seguinte comando como SYS:

-- Execute como SYS
set serveroutput on
begin
    sys.validate_apex;
end;
/

8. Reiniciando os Processos do Sistema

Após instalar o Oracle APEX, reinicie os processos que você parou antes de iniciar a instalação.

9. Instalação e Configuração do Oracle REST Data Services (ORDS)

O Oracle REST Data Services (ORDS) é uma aplicação J2EE que comunica com o banco de dados Oracle mapeando solicitações do navegador para o mecanismo APEX. O ORDS é totalmente suportado quando implantado em modo standalone ou quando implantado em servidores de aplicativos Oracle WebLogic Server ou Apache Tomcat.

10. Acessando o Oracle APEX

10.1 Sobre o Acesso ao APEX

Você acessa o ambiente de desenvolvimento Oracle APEX assinando em uma área de trabalho compartilhada chamada workspace. Como você assina e acessa o APEX depende da sua função de usuário:

Administradores de instância: Gerenciam toda a instância usando o APEX Administration Services
Administradores de workspace: Realizam tarefas administrativas específicas de um workspace
Desenvolvedores: Criam e editam aplicativos
Usuários finais: Apenas executam aplicativos existentes

10.2 Solicitando um Workspace

Para solicitar um workspace:

Navegue até a caixa de diálogo Oracle APEX Sign In
Em Sign In, clique em Request a Workspace
Preencha o formulário de identificação com seu nome, sobrenome, e-mail e nome do workspace
Aceite o contrato de serviço, se definido
Verifique sua solicitação e clique em Submit Request

Após completar o formulário, você receberá um e-mail contendo um link de verificação. Quando clicar no link de verificação, o workspace será criado e você receberá outro e-mail contendo as credenciais de acesso.

10.3 Redefinindo sua Senha

Para redefinir sua senha:

Navegue até a página Oracle APEX Sign In
Em Sign In, clique em Reset Password
No formulário Reset Password, insira seu endereço de e-mail e nome do workspace
Clique em Reset Password
Você receberá um e-mail contendo um link para redefinição de senha
Clique no link e defina sua nova senha

10.4 Recuperando o Nome do seu Workspace

Se não conseguir lembrar o nome do seu workspace:

Navegue até a página Oracle APEX Sign In
Clique em Reset Password
Clique em Find My Workspace
Insira seu endereço de e-mail e clique em Find Workspace
Você receberá um e-mail listando todos os workspaces associados ao endereço de e-mail fornecido

Com este guia, você deve ser capaz de instalar e configurar com sucesso o Oracle APEX em seu ambiente. Lembre-se de seguir as boas práticas de segurança e manutenção para garantir o funcionamento adequado da sua instância APEX.

Guia Completo de Instalação e Configuração do Oracle APEX