Usare l'attività di Office 365 Outlook per inviare un messaggio di posta elettronica con Outlook

L'attività di Office 365 Outlook in Data Factory per Microsoft Fabric consente di inviare messaggi di posta elettronica usando l'account di Office 365. È possibile personalizzare il messaggio con espressioni dinamiche.

Prerequisites

Assicurarsi di disporre dei seguenti elementi:

Aggiungere l'attività di Office 365 Outlook a una pipeline

Seguire questa procedura per usare l'attività di Office 365 Outlook in una pipeline:

  1. Creare una nuova pipeline nell'area di lavoro.

  2. Cercare "Office 365 Outlook" nel riquadro Attività pipeline e selezionarlo per aggiungerlo all'area di disegno della pipeline. A seconda della larghezza della finestra del browser, potrebbe essere necessario espandere l'elenco delle attività o cercare l'icona di Outlook senza un'etichetta.

    Screenshot dell'interfaccia utente di Fabric con il riquadro Attività e l'attività Office 365 Outlook evidenziati.

  3. Selezionare la nuova attività di Outlook nell'area di disegno, se non è già selezionata.

    Schermata che mostra la scheda Impostazioni generali dell'attività di Outlook di Office 365.

Fare riferimento alla Guida alle impostazioni generali per configurare la scheda Impostazioni generali.

Tip

Utilizzare un'attività di Outlook separata per ogni attività che si desidera monitorare per individuare gli errori.

Se si associano più attività all'attività di Outlook, tutti gli stati connessi devono essere soddisfatti per attivarlo. Ad esempio, se due attività di copia sono collegate a un'attività di Outlook impostata per attivarsi "in caso di errore", entrambe le attività devono fallire per attivare l'attività di Outlook. Se si verifica un solo errore, l'attività di Outlook non verrà attivata.

Configurare l'attività di Office 365 Outlook

Per configurare l'attività di Office 365 Outlook:

  1. Aggiungere una connessione all'attività di Outlook nella parte superiore delle impostazioni. È possibile creare una nuova connessione o usarne una esistente.

    Annotazioni

    • Se si usa l'autenticazione utente e si distribuisce la pipeline con l'attività di Outlook o Teams in un'altra area di lavoro, l'attività sarà inattiva nell'area di lavoro di destinazione fino a quando non si crea una nuova connessione di autenticazione utente.
    • Se non si ha accesso alle connessioni utilizzate nell'attività di Outlook, la distribuzione iniziale avrà esito negativo. Per risolvere i problemi, è possibile modificare la pipeline di destinazione e modificare l'autorizzazione o impostare l'attività su inattiva.
    • Il contenuto inviato dal messaggio di posta elettronica verrà inviato dal tuo account.
  2. Specificare i dettagli per il messaggio di posta elettronica, inclusi destinatari, oggetto e corpo. È anche possibile aggiungere dettagli avanzati, ad esempio un indirizzo personalizzato "da", i destinatari CC e Ccn, la riservatezza e un indirizzo di risposta personalizzato. Tutti i campi supportano espressioni dinamiche.

    Screenshot che mostra le finestre delle impostazioni nell'attività di Outlook.

Condividere e riutilizzare la funzionalità e-mail con l'attività Office 365 Outlook

L'attività Office 365 Email consente alle pipeline di inviare notifiche e messaggi automatizzati usando una connessione autenticata.

Negli scenari di sviluppo collaborativo, i team potrebbero dover riutilizzare la logica di posta elettronica tra più pipeline e utenti. Tuttavia, le connessioni di posta elettronica sono attualmente destinate a singoli utenti e non sono progettate per la condivisione diretta tra autori.

Per supportare il riutilizzo e la coerenza, è possibile adottare un modello di composizione basato su pipeline che centralizza la funzionalità di posta elettronica. Invece di duplicare la configurazione della posta elettronica tra le pipeline, creare una pipeline dedicata responsabile dell'invio di messaggi di posta elettronica e richiamarla da altre pipeline.

  1. Creare una pipeline di posta elettronica riutilizzabile

    Definire una pipeline che incapsula tutto il comportamento correlato alla posta elettronica:

    • Configurare l'attività di posta elettronica Office 365
    • Stabilire la connessione necessaria
    • Convalidare la pipeline in modo indipendente

    Questa pipeline funge da servizio riutilizzabile per il recapito tramite posta elettronica.

    Screenshot che mostra la scheda Impostazioni e configura un'attività Office 365 Outlook riutilizzabile.

  2. Abilitare l'accesso condiviso tramite una connessione pipeline

    Creare e configurare una connessione pipeline che può essere usata da più utenti per richiamare la pipeline di posta elettronica tramite Gestire connessioni e gateway portale in Fabric.

    • Concedere l'accesso a sviluppatori o team che devono inviare messaggi di posta elettronica
    • Assicurarsi che le autorizzazioni siano allineate ai criteri di sicurezza dell'organizzazione

    Schermata che mostra come condividere una connessione Pipeline.

  3. Richiamare la pipeline di posta elettronica da altre pipeline

    Nelle pipeline downstream:

    • Aggiungere un'attività Invoke Pipeline
    • Selezionare la connessione condivisa
    • Fare riferimento alla pipeline di posta elettronica riutilizzabile

    Ciò consente alle pipeline di attivare l'invio di messaggi di posta elettronica senza gestire le proprie connessioni.

    Schermata che mostra un'attività Invoke Pipeline per l'attività e-mail creata in precedenza.

  4. Parametrizzare per la flessibilità

    Per supportare casi d'uso diversi, definire i parametri nella pipeline di posta elettronica, ad esempio:

    • Argomento
    • Corpo del messaggio
    • Destinatari
    • Input di contenuto dinamico

    Il passaggio di parametri in fase di esecuzione consente il riutilizzo mantenendo al tempo stesso la personalizzazione.

Limitations

In alcuni casi, le distribuzioni che si basano su autenticazione dell'entità servizio (ad esempio, flussi di lavoro CI/CD basati su Azure DevOps) potrebbero non eseguire correttamente questo modello.

Limitazioni note

  • L'attività di Outlook sarà inattiva quando si usa CI/CD.
  • L'attività di Outlook non supporta WI o SPN.