Integrazione di Oracle APEX con il servizio di consegna tramite e-mail

Utilizzare Oracle APEX per inviare e-mail tramite il servizio di consegna tramite e-mail.

Configurare Oracle APEX per l'invio di e-mail tramite consegna tramite e-mail

È possibile utilizzare il package APEX_MAIL per inviare messaggi di posta elettronica dalle applicazioni Oracle APEX distribuite in Autonomous Transaction Processing. Per ulteriori informazioni, vedere Autonomous Database for Transaction Processing and Mixed Workloads e Provisioning di Autonomous Database.

Importante

Queste istruzioni contengono un codice di esempio che può essere utilizzato come riferimento. Per il supporto clienti, è necessario contattare l'assistenza clienti Oracle APEX. Questi passi sono stati testati su un'istanza di computazione Oracle Linux Server release 7.9.

Prima di utilizzare APEX_MAIL, devi configurare Oracle Cloud Infrastructure Email Delivery nella tua istanza APEX.

Per abilitare la funzionalità APEX_MAIL nell'istanza APEX in Autonomous Transaction Processing, effettuare le operazioni riportate di seguito.

  1. Identificare l'endpoint di connessione SMTP per il servizio di consegna tramite e-mail. L'endpoint viene configurato come host SMTP nell'istanza APEX nel passo 4. Per ulteriori informazioni, vedere Configurazione della connessione SMTP.
  2. Generare le credenziali SMTP per il servizio di consegna tramite e-mail. L'istanza APEX utilizza le credenziali per l'autenticazione con i server di consegna tramite posta elettronica quando si inviano messaggi di posta elettronica. Per ulteriori informazioni, vedere Crea credenziali SMTP per un utente.
  3. Crea un mittente approvato per il servizio di consegna tramite e-mail. È necessario completare questo passo per tutti gli indirizzi e-mail utilizzati come "Da" con le chiamate APEX_MAIL.SEND, come indirizzo mittente e-mail applicazione nelle applicazioni o nel parametro di istanza SMTP_FROM. Per ulteriori informazioni, vedere Gestione dei mittenti approvati.
  4. Nota

    È consigliabile creare oggetti credenziali per memorizzare nomi utente e password e passare in modo sicuro gli oggetti credenziali per impostare l'autenticazione SMTP. Per ulteriori informazioni, vedere Utilizzare gli oggetti delle credenziali per impostare l'autenticazione SMTP.
    In alternativa, connettersi ad Autonomous Transaction Processing come utente ADMIN utilizzando il client SQL e configurare i seguenti parametri SMTP utilizzando APEX_INSTANCE_ADMIN.SET_PARAMETER:
    • SMTP_HOST_ADDRESS: specifica l'endpoint di connessione SMTP dal passo 1.
    • SMTP_USERNAME Specifica il nome utente della credenziale SMTP dal passo 2.
    • SMTP_PASSWORD Specifica la password della credenziale SMTP dal Passo 2.

    Ad esempio:

    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. Invia un'e-mail di test utilizzando APEX SQL Workshop, comandi SQL che specificano uno dei mittenti approvati dal Passo 3 come "Da". Ad esempio:

    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. Per monitorare la consegna delle e-mail nell'istanza APEX:
    1. Connettersi ai servizi di amministrazione APEX.
    2. Aprire la pagina Gestisci istanza.
    3. Fare clic sul collegamento Coda posta nella sezione Gestisci metadati.

      In alternativa, eseguire una query sulle viste APEX_MAIL_QUEUE e APEX_MAIL_LOG utilizzando un client SQL.