Oracle Cloud Infrastructure - Dokumentation

Oracle APEX in Email Delivery integrieren

Verwenden Sie Oracle APEX, um E-Mails über den Email Delivery-Service zu senden.

Oracle APEX konfigurieren, um E-Mails über Email Delivery zu senden

Mit dem Package APEX_MAIL können Sie E-Mails von Oracle APEX-Anwendungen senden, die in Autonomous Transaction Processing bereitgestellt sind. Weitere Informationen finden Sie unter Autonomous Database für Transaktionsverarbeitung und gemeinsame Workloads und Autonomous Database bereitstellen.

Wichtig

Diese Anweisungen enthalten praktischen Beispielcode und sollten als Referenz verwendet werden. Um Clientsupport zu erhalten, müssen Sie sich an den Oracle APEX-Kundensupport wenden. Diese Schritte wurden auf einer Oracle Linux Server Release 7.9 Compute-Instanz getestet.

Vor der Verwendung von APEX_MAIL müssen Sie Oracle Cloud Infrastructure Email Delivery in Ihrer APEX-Instanz konfigurieren.

So aktivieren Sie die APEX_MAIL-Funktionalität in Ihrer APEX-Instanz in Autonomous Transaction Processing:

  1. Ermitteln Sie den SMTP-Verbindungsendpunkt für Email Delivery. In Schritt 4 konfigurieren Sie den Endpunkt als SMTP-Host in Ihrer APEX-Instanz. Weitere Informationen finden Sie unter SMTP-Verbindung konfigurieren.
  2. Generieren Sie SMTP-Zugangsdaten für Email Delivery. Die APEX-Instanz verwendet Zugangsdaten zur Authentifizierung bei Email Delivery-Servern, wenn Sie E-Mails senden. Weitere Informationen finden Sie unter SMTP-Zugangsdaten für einen Benutzer erstellen.
  3. Erstellen Sie einen genehmigten Absender für Email Delivery. Sie müssen diesen Schritt für alle E-Mail-Adressen ausführen, die Sie als Absender mit APEX_MAIL.SEND-Aufrufen, als E-Mail-Absenderadresse der Anwendung in Ihren Anwendungen oder im Instanzparameter SMTP_FROM verwenden. Weitere Informationen finden Sie unter Genehmigte Absender verwalten.
  4. Hinweis

    Es wird empfohlen, Zugangsdatenobjekte zum Speichern von Benutzernamen und Kennwörtern zu erstellen und die Zugangsdatenobjekte sicher zu übergeben, um die SMTP-Authentifizierung festzulegen. Weitere Informationen finden Sie unter SMTP-Authentifizierung mit Zugangsdatenobjekten festlegen.
    Sie können auch mit dem SQL-Client eine Verbindung zu Autonomous Transaction Processing als ADMIN-Benutzer herstellen, und konfigurieren Sie die folgenden SMTP-Parameter mit APEX_INSTANCE_ADMIN.SET_PARAMETER:
    • SMTP_HOST_ADDRESS: Gibt den SMTP-Verbindungsendpunkt aus Schritt 1 an.
    • SMTP_USERNAME: Gibt den SMTP-Zugangsdatenbenutzernamen aus Schritt 2 an.
    • SMTP_PASSWORD: Gibt das Kennwort der SMTP-Zugangsdaten aus Schritt 2 an.

    Beispiel:

    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. Senden Sie eine Test-E-Mail mit APEX SQL Workshop, wobei SQL-Befehle einen der genehmigten Absender aus Schritt 3 als "Von" angeben. Beispiel:

    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. So überwachen Sie den E-Mail-Versand Ihrer APEX-Instanz:
    1. Melden Sie sich bei APEX Administration Services an.
    2. Öffnen Sie die Seite "Instanz verwalten".

    3. Klicken Sie im Abschnitt "Metadaten verwalten" auf den Link "E-Mail-Queue".

      Oder fragen Sie die Ansichten APEX_MAIL_QUEUE und APEX_MAIL_LOG mit einem SQL-Client ab.