Verwenden der Office 365 Outlook-Aktivität zum Senden einer E-Mail mit Outlook

Mit der Office 365 Outlook-Aktivität in Data Factory für Microsoft Fabric können Sie E-Mails mit Ihrem Office 365-Konto senden. Sie können die Nachricht mit dynamischen Ausdrücken anpassen.

Prerequisites

Stellen Sie sicher, dass Sie folgendes haben:

Hinzufügen der Office 365 Outlook-Aktivität zu einer Pipeline

Führen Sie die folgenden Schritte aus, um die Office 365 Outlook-Aktivität in einer Pipeline zu verwenden:

  1. Erstellen Sie eine neue Pipeline in Ihrem Arbeitsbereich.

  2. Suchen Sie im Pipelineaktivitätenbereich nach "Office 365 Outlook", und wählen Sie es aus, um es dem Pipeline-Zeichenbereich hinzuzufügen. Je nach Breite des Browserfensters müssen Sie möglicherweise die Aktivitätenliste erweitern oder nach dem Outlook-Symbol ohne Bezeichnung suchen.

    Screenshot der Fabric-Benutzeroberfläche mit dem Bereich

  3. Wählen Sie die neue Outlook-Aktivität auf der Canvas aus, wenn sie noch nicht ausgewählt ist.

    Screenshot mit der Registerkarte

Informationen zum Konfigurieren der Registerkarte "Allgemeine Einstellungen" finden Sie im Leitfaden "Allgemeine Einstellungen".

Tip

Verwenden Sie eine separate Outlook-Aktivität für jede Aktivität, die Sie auf Fehler überwachen möchten.

Wenn Sie mehr als eine Aktivität an die Outlook-Aktivität anfügen, müssen alle verbundenen Status erfüllt sein, um sie auszulösen. Wenn beispielsweise zwei Kopieraktivitäten mit einer Outlook-Aktivität verbunden sind, die so konfiguriert ist, dass sie bei einem Fehlschlag ausgelöst wird, müssen beide Aktivitäten scheitern, damit die Outlook-Aktivität aktiviert wird. Wenn nur ein Element fehlschlägt, wird die Outlook-Aktivität nicht ausgelöst.

Konfigurieren der Office 365 Outlook-Aktivität

So richten Sie die Office 365 Outlook-Aktivität ein:

  1. Fügen Sie oben in den Einstellungen eine Verbindung zu Ihrer Outlook-Aktivität hinzu. Sie können eine neue Verbindung erstellen oder eine vorhandene Verbindung verwenden.

    Hinweis

    • Wenn Sie die Benutzerauthentifizierung verwenden und die Pipeline mit der Outlook- oder Teams-Aktivität in einem anderen Arbeitsbereich bereitstellen, ist die Aktivität im Zielarbeitsbereich inaktiv, bis Sie dort eine neue Benutzerauthentifizierungsverbindung erstellen.
    • Wenn Sie keinen Zugriff auf die in der Outlook-Aktivität verwendeten Verbindungen haben, schlägt die anfängliche Bereitstellung fehl. Zur Problembehandlung können Sie die Zielpipeline bearbeiten und die Autorisierung ändern oder die Aktivität auf "inaktiv" festlegen.
    • Der Inhalt, der von der E-Mail gesendet wird, wird von Ihrem Konto gesendet.
  2. Geben Sie Details für die E-Mail an, einschließlich Empfängern, Betreff und Text. Sie können auch erweiterte Details wie eine benutzerdefinierte Absenderadresse, CC- und BCC-Empfänger, Vertraulichkeit und eine benutzerdefinierte Antwortadresse hinzufügen. Alle Felder unterstützen dynamische Ausdrücke.

    Screenshot mit den Einstellungsfenstern in der Outlook-Aktivität.

Freigeben und Wiederverwenden von E-Mail-Funktionen mit Office 365 Outlook Aktivität

Mit der Office 365-E-Mail-Aktivität können Pipelines Benachrichtigungen und automatisierte Nachrichten mithilfe einer authentifizierten Verbindung senden.

In Szenarien für die zusammenarbeitliche Entwicklung müssen Teams möglicherweise E-Mail-Logik für mehrere Pipelines und Benutzer wiederverwenden. E-Mail-Verbindungen sind derzeit auf einzelne Benutzer beschränkt und nicht für die direkte Freigabe zwischen Autoren vorgesehen.

Um die Wiederverwendung und Konsistenz zu unterstützen, können Sie ein pipelinebasiertes Kompositionsmuster einführen, das die E-Mail-Funktionalität zentralisiert. Anstatt die E-Mail-Konfiguration über Pipelines hinweg zu duplizieren, erstellen Sie eine dedizierte Pipeline, die für das Senden von E-Mails verantwortlich ist, und rufen Sie sie von anderen Pipelines auf.

  1. Erstellen einer wiederverwendbaren E-Mail-Pipeline

    Definieren Sie eine Pipeline, die das gesamte E-Mail-bezogene Verhalten kapselt:

    • Konfigurieren der Office 365 E-Mail-Aktivität
    • Herstellen der erforderlichen Verbindung
    • Unabhängige Überprüfung der Pipeline

    Diese Pipeline fungiert als wiederverwendbarer Dienst für die E-Mail-Zustellung.

    Screenshot mit der Registerkarte „Einstellungen“ und dem Einrichten einer wiederverwendbaren Office 365 Outlook-Aktivität.

  2. Aktivieren des freigegebenen Zugriffs über eine Pipelineverbindung

    Erstellen und konfigurieren Sie eine Pipelineverbindung, die von mehreren Benutzern zum Aufrufen der E-Mail-Pipeline über das Manage Connections and Gateways Portal in Fabric verwendet werden kann.

    • Gewähren des Zugriffs auf Entwickler oder Teams, die E-Mails senden müssen
    • Sicherstellen, dass Berechtigungen den Sicherheitsrichtlinien Ihrer Organisation entsprechen

    Screenshot, der zeigt, wie eine Pipelineverbindung geteilt wird.

  3. Aufrufen der E-Mail-Pipeline aus anderen Pipelines

    In nachgelagerten Pipelines:

    • Aktivität „Pipeline aufrufen“ hinzufügen
    • Freigegebene Verbindung auswählen
    • Verweisen auf die wiederverwendbare E-Mail-Pipeline

    Dadurch können Pipelines das Senden von E-Mails auslösen, ohne ihre eigenen Verbindungen zu verwalten.

    Screenshot einer Aufrufpipelineaktivität für die zuvor erstellte E-Mail-Aktivität.

  4. Parametrisieren für Flexibilität

    Um unterschiedliche Anwendungsfälle zu unterstützen, definieren Sie Parameter in der E-Mail-Pipeline, z. B.:

    • Betreff
    • Nachrichtentext
    • Empfänger
    • Dynamische Inhaltseingaben

    Das Übergeben von Parametern zur Laufzeit ermöglicht die Wiederverwendung bei gleichzeitiger Beibehaltung der Anpassung.

Authentifizierungsunterstützung

Die Office 365 Outlook-Aktivität unterstützt folgende Authentifizierungsmethoden:

  • Benutzerauthentifizierung (OAuth)
  • Arbeitsbereichsidentität (WI)
  • Service Principal (Dienstprinzipalname, SPN)

Durch die Nutzung von Workspace Identity und Service Principal kann Ihre Organisation E-Mail-Benachrichtigungen mit Nicht-Benutzeridentitäten ausführen. Dieser Ansatz hilft, die Abhängigkeit von einzelnen Benutzerkonten zu verringern und unterstützt Automatisierungsszenarien auf Produktionsniveau.

Wenn Sie Workspace Identity oder Service Principal Authentifizierung verwenden, müssen Sie die entsprechenden Microsoft Entra ID- und Microsoft Graph-Berechtigungen konfigurieren, um E-Mails im Namen des gewünschten Postfachs zu senden. Je nach organisatorischen Anforderungen müssen Sie möglicherweise auch zusätzliche Exchange Online-Postfachbeschränkungen und Governance-Richtlinien einrichten.

Hinweis

Service Principal (SPN) und Workspace Identity (WI) verwenden auf Anwendungsebene Microsoft Graph-Berechtigungen, um auf Outlook zuzugreifen. Ein Mandantenadministrator muss ausdrücklich die erforderlichen Berechtigungen erteilen und die Administratorzustimmung erteilen, bevor die Identität verwendet werden darf. Diese Berechtigungen können es der Identität erlauben, E-Mails im Namen der Nutzer im Tenant zu senden. Bevor der Zugriff gewährt wird, sollten Mandantenadministratoren den Berechtigungsumfang überprüfen und sicherstellen, dass er mit den Sicherheitsrichtlinien ihrer Organisation übereinstimmt.

Weitere Informationen zur Einrichtung von WI oder SPN finden Sie unter Workspace identity support in Data Factory oder Service principal support in Data Factory.

Bekannte Einschränkungen

  • Die Outlook-Aktivität unterstützt keine Sensitivitätslabels. Sie können keine Microsoft Purview-Sensitivitätsetiketten auf E-Mails anwenden, die über die Aktivität gesendet werden.