Intégration d'Oracle APEX à Email Delivery

Configuration d'Oracle APEX pour l'envoi de courriels via Email Delivery

Vous pouvez utiliser le package APEX_MAIL pour envoyer des courriels à partir d'applications Oracle APEX déployées dans Autonomous Transaction Processing. Pour plus d'informations, reportez-vous à Autonomous Database pour le traitement des transactions et les charges globales mixtes et à Provisionnement d'Autonomous Database.

Avant d'utiliser APEX_MAIL, vous devez configurer Oracle Cloud Infrastructure Email Delivery dans votre instance APEX.

Pour activer la fonctionnalité APEX_MAIL dans votre instance APEX dans Autonomous Transaction Processing, procédez comme suit :

1. Identifiez l'adresse de connexion SMTP pour Email Delivery. Vous configurez cette adresse en tant qu'hôte SMTP dans votre instance APEX à l'étape 4. Pour plus d'informations, reportez-vous à Configuration de la connexion SMTP.
2. Générez des informations d'identification SMTP pour Email Delivery. Votre instance APEX utilise les informations d'identification pour l'authentification auprès des serveurs Email Delivery lorsque vous envoyez un courriel. Pour plus d'informations, reportez-vous à Création d'informations d'identification SMTP pour un utilisateur.
3. Créez un expéditeur approuvé pour Email Delivery. Vous devez effectuer cette étape pour toutes les adresses électroniques utilisées pour expédition avec des appels APEX_MAIL.SEND, comme adresses électroniques d'expéditeur dans vos applications ou dans le paramètre d'instance SMTP_FROM. Pour plus d'informations, reportez-vous à Gestion des expéditeurs approuvés.
4. Remarque
   
   Nous vous recommandons de créer des objets d'informations d'identification pour stocker les noms utilisateur et les mots de passe, et de transmettre les objets d'informations d'identification de manière sécurisée pour définir l'authentification SMTP. Pour plus d'informations, reportez-vous à Utilisation d'objets d'informations d'identification pour définir l'authentification SMTP.
   Vous pouvez également vous connecter à Autonomous Transaction Processing en tant qu'utilisateur ADMIN à l'aide du client SQL et configurer les paramètres SMTP suivants à l'aide de APEX_INSTANCE_ADMIN.SET_PARAMETER :
   • SMTP_HOST_ADDRESS : spécifie l'adresse de connexion SMTP de l'étape 1.
   • SMTP_USERNAME : indique le nom utilisateur des informations d'identification SMTP de l'étape 2.
   • SMTP_PASSWORD : indique le mot de passe des informations d'identification SMTP de l'étape 2.

   Par exemple :

   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. Envoyer un courriel de test à l'aide de SQL Workshop dans APEX, les commandes SQL indiquant l'un des expéditeurs approuvés de l'étape 3 comme adresse d'expédition. Par exemple :

   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. Pour surveiller la distribution des courriels dans votre instance APEX, procédez comme suit :
   1. Connectez-vous aux services d'administration APEX.
   2. Ouvrez la page Gérer une instance.

   3. Cliquez sur le lien File d'attente des courriels dans la section Gérer les métadonnées.

      Sinon, interrogez les vues APEX_MAIL_QUEUE et APEX_MAIL_LOG à l'aide d'un client SQL.