Integrando o Oracle APEX ao Email Delivery

Use o Oracle APEX para enviar e-mails por meio do serviço Email Delivery.

Configurar o Oracle APEX para enviar e-mails por meio do serviço Email Delivery

Você pode usar o pacote APEX_MAIL para enviar e-mails dos aplicativos Oracle APEX implantados no Autonomous Transaction Processing. Consulte Autonomous Database for Transaction Processing and Mixed Workloads e Provisionar o Autonomous Database para obter mais informações.

Importante

Essas instruções contêm um código de amostra para sua conveniência e devem ser usadas como referência. Para o suporte ao cliente, você deve entrar em contato com o suporte ao cliente do Oracle APEX. Essas etapas foram testadas em uma instância de computação do Oracle Linux Server release 7.9.

Antes de usar APEX_MAIL, configure o Oracle Cloud Infrastructure Email Delivery em sua instância do APEX.

Para ativar a funcionalidade APEX_MAIL em sua instância do APEX no Autonomous Transaction Processing:

  1. Identifique o ponto final de conexão SMTP para o serviço Email Delivery. Você configura o ponto final como o Host SMTP em sua instância do APEX na Etapa 4. Consulte Configurando a Conexão SMTP para obter mais informações.
  2. Gere credenciais SMTP para o serviço Email Delivery. Sua instância do APEX usa as credenciais para a autenticação nos servidores Email Delivery quando você envia e-mail. Consulte Criar Credenciais SMTP para um Usuário para obter mais informações.
  3. Crie um remetente aprovado para o serviço Email Delivery. Você precisa concluir esta etapa para todos os endereços de e-mail usados como origem ("De") com chamadas APEX_MAIL.SEND, como o Endereço "De" do E-mail do Aplicativo em seus aplicativos ou no parâmetro de instância SMTP_FROM. Consulte Gerenciando Remetentes Aprovados para obter mais informações.
  4. Observação

    Recomendamos que você crie objetos de credencial para armazenar nomes de usuário e senhas e passe com segurança os objetos de credencial para definir a Autenticação SMTP. Para obter mais informações, consulte Usar Objetos de Credencial para definir a Autenticação SMTP.
    Ou conecte-se ao seu Autonomous Transaction Processing como usuário ADMIN usando o cliente SQL e configure os seguintes parâmetros SMTP usando APEX_INSTANCE_ADMIN.SET_PARAMETER:
    • SMTP_HOST_ADDRESS: Especifica o ponto final da conexão SMTP da Etapa 1.
    • SMTP_USERNAME Especifica o nome do usuário da credencial SMTP da Etapa 2.
    • SMTP_PASSWORD Especifica a senha da credencial SMTP da Etapa 2.

    Por exemplo:

    BEGIN
    	APEX_INSTANCE_ADMIN.SET_PARAMETER('SMTP_HOST_ADDRESS', 'smtp.us-phoenix-1.oraclecloud.com');
    	APEX_INSTANCE_ADMIN.SET_PARAMETER('SMTP_USERNAME', 'ocid1.user.oc1.username');
    	APEX_INSTANCE_ADMIN.SET_PARAMETER('SMTP_PASSWORD', 'password');
    	COMMIT;
    END;
    /			
  5. Envie um e-mail de teste usando o APEX SQL Workshop, Comandos SQL que especificam um dos remetentes aprovados da Etapa 3 como "De". Por exemplo:

    BEGIN
    	APEX_MAIL.SEND(p_from => 'alice@example.com',
    		       p_to   => 'bob@example.com',
    		       p_subj => 'Email from Oracle Autonomous Database',
    	               p_body => 'Sent using APEX_MAIL');
    END;
    /			
  6. Para monitorar a entrega de e-mails na sua instância do APEX:
    1. Acesse o APEX Administration Services.
    2. Abra a página Gerenciar Instância.
    3. Clique no link Fila de E-mail na seção Gerenciar Metadados.

      Ou consulte as views APEX_MAIL_QUEUE e APEX_MAIL_LOG usando um cliente SQL.