Intégration d'Oracle APEX au service de transmission de messages

Configurer Oracle APEX pour l'envoi de courriels au moyen du service de transmission de messages

Vous pouvez utiliser APEX_MAIL pour envoyer des courriels à partir des applications Oracle APEX déployées dans une base de données Autonomous Transaction Processing. Pour plus d'informations, voir Autonomous Database pour le traitement des transactions et les charges de travail mixtes et Provisionner 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 d'une base de données Autonomous Transaction Processing :

1. Identifiez le point d'extrémité de connexion SMTP pour le service de transmission de messages. Vous devez configurer le point d'extrémité en tant qu'hôte SMTP dans votre instance APEX à l'étape 4. Voir Configuration d'une connexion SMTP pour plus d'informations.
2. Générez les données d'identification SMTP pour le service de transmission de messages. Votre instance APEX utilise des données d'identification pour l'authentification sur les serveurs de transmission de messages lors de l'envoi de courriels. Pour plus d'informations, voir Créer les données d'identification SMTP pour un utilisateur.
3. Créez un expéditeur approuvé pour le service de transmission de messages. Vous devez réaliser cette étape pour chaque adresse de courriel que vous utilisez dans le champ d'expéditeur des appels APEX_MAIL.SEND, en tant qu'adresse d'expéditeur de courriel d'application dans vos applications ou dans le paramètre d'instance SMTP_FROM. Pour plus d'informations, voir Gestion des expéditeurs approuvés.
4. Note
   
   Nous vous recommandons de créer des objets de données d'identification pour stocker les noms d'utilisateur et les mots de passe et de transmettre les objets de données d'identification de manière sécurisée pour définir l'authentification SMTP. Pour plus d'informations, voir Utiliser des objets de données d'identification pour définir l'authentification SMTP.
   Vous pouvez également vous connecter à la base de données Autonomous Transaction Processing en tant qu'utilisateur ADMIN au moyen du client SQL et configurer les paramètres SMTP suivants au moyen de APEX_INSTANCE_ADMIN.SET_PARAMETER :
   • SMTP_HOST_ADDRESS : Indique le point d'extrémité de connexion SMTP de l'étape 1.
   • SMTP_USERNAME : Indique le nom d'utilisateur des données d'identification SMTP de l'étape 2.
   • SMTP_PASSWORD : Indique le mot de passe associé aux données 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. Envoyez un courriel de test à l'aide d'APEX SQL Workshop, avec des commandes SQL spécifiant un des expéditeurs approuvés de l'étape 3 à titre d'expéditeur. 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 transmission des courriels dans votre instance APEX :
   1. Connectez-vous aux services d'administration APEX.
   2. Ouvrez la page Manage Instance (Gérer l'instance).

   3. Cliquez sur le lien Mail Queue (File d'attente des courriels) dans la section Manage Meta Data (Gérer les métadonnées).

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