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.
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:
- 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.
- 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.
- 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ânciaSMTP_FROM
. Consulte Gerenciando Remetentes Aprovados para obter mais informações. - ObservaçãoOu conecte-se ao seu Autonomous Transaction Processing como usuário ADMIN usando o cliente SQL e configure os seguintes parâmetros SMTP usando
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.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; /
-
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; /
- Para monitorar a entrega de e-mails na sua instância do APEX:
- Acesse o APEX Administration Services.
- Abra a página Gerenciar Instância.
-
Clique no link Fila de E-mail na seção Gerenciar Metadados.
Ou consulte as views
APEX_MAIL_QUEUE
eAPEX_MAIL_LOG
usando um cliente SQL.
Mais Informações
- Criando Aplicativos com o Oracle APEX no Autonomous Database
- APEX_MAIL na Referência de API do Oracle APEX
- APEX_INSTANCE_ADMIN na Referência de API do Oracle APEX