Zum Inhalt springen

Email-Verbindung

Einführung

Eine Email-Verbindung, die mit dem Email-Connector erstellt wurde, ermöglicht den Zugriff auf einen Email-Server. Sobald eine Verbindung konfiguriert ist, können Instanzen von Email-Aktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind, um entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet zu werden.

Wichtig

Die Verwendung des Email-Connectors mit Microsoft 365 erfordert, dass zusätzliche Voraussetzungen erfüllt sind. Siehe Email-Voraussetzungen für eine Microsoft 365 OAuth 2.0-Verbindung.

Für zusätzliche Informationen zu den Email-Endpunkt-Einstellungen von Microsoft 365 siehe die Microsoft-Dokumentation zu POP-, IMAP- und SMTP-Einstellungen.

Erstellen oder Bearbeiten einer Email-Verbindung

Eine neue Email-Verbindung wird mit dem Email-Connector von einem dieser Standorte erstellt:

Eine vorhandene Email-Verbindung kann von diesen Standorten bearbeitet werden:

Email-Verbindung konfigurieren

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Email-Verbindung wird im Folgenden beschrieben.

Tipp

Felder mit einem Symbol für Variablen unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben, oder indem Sie auf das Symbol für Variablen klicken, um ein Menü mit vorhandenen Variablen anzuzeigen.

  • Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Email-Verbindung eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch verwendet, um den Email-Endpunkt zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf deren Aktivitäten bezieht.

  • Authentifizierungstyp: Wählen Sie die Authentifizierungsmethode, eine von Basic Auth oder OAuth2:

    • Basic Auth: SMTP- und IMAP-Serverauthentifizierung mit Benutzernamen und Passwortkombinationen.

    • OAuth2: Diese Option wurde bestätigt, dass sie mit Microsoft 365 funktioniert (siehe die Voraussetzungen). Andere Email-Server sollten funktionieren, wurden jedoch von Jitterbit nicht getestet. Wenn ausgewählt, sind diese zusätzlichen Felder zur Konfiguration der OAuth 2.0-Authentifizierung sichtbar:

      • Host: Geben Sie den Host für die OAuth-Authentifizierung ein.

        Tipp

        Für die OAuth-Authentifizierung mit Microsoft Entra ID geben Sie https://login.microsoftonline.com als Host ein.

      • Mandanten-ID: Geben Sie die Mandanten-ID ein.

      • Client-ID: Geben Sie die Client-ID ein.

      • Client-Geheimnis: Geben Sie das Client-Geheimnis ein.

      • Bereich: Geben Sie den Bereich ein.

      • Grant-Typ: Wählen Sie Client Credentials (Standard) oder ROPC (Resource Owned Password Credentials) als Grant-Typ für die OAuth-Authentifizierung. Wenn ROPC (Resource Owned Password Credentials) ausgewählt ist, können Sie ein zusätzliches Passwort angeben.

        Wichtig

        Um Emails über Microsoft 365 (smtp.office365.com) zu senden, müssen Sie ROPC (Resource Owned Password Credentials) für Grant Type auswählen.

      • Passwort: Geben Sie ein gültiges Passwort ein. Sichtbar nur, wenn der Grant Type auf ROPC (Resource Owned Password Credentials) eingestellt ist.

  • Aktivität: Wählen Sie den Aktivitätstyp aus, der mit dieser Verbindung verknüpft werden soll, einer von Beidem, Email senden oder Email lesen:

    • Beides: Die Verbindung wird mit den Aktivitäten Email senden und Email lesen verknüpft. Wenn ausgewählt, werden alle Felder unten angezeigt.

    • Email senden: Die Verbindung wird nur mit der Email senden-Aktivität verknüpft. Wenn ausgewählt, werden nur Felder angezeigt, die mit SMTP beginnen.

    • Email lesen: Die Verbindung wird nur mit der Email lesen-Aktivität verknüpft. Wenn ausgewählt, werden nur Felder angezeigt, die mit IMAP beginnen.

  • SMTP-Host: Geben Sie den Hostnamen des SMTP-Email-Servers ein. Dieses Feld wird nur angezeigt, wenn die ausgewählte Aktivität Beides oder Email senden ist.

  • SMTP-Port: Geben Sie die Portnummer des SMTP-Email-Servers ein, mit dem Sie sich verbinden möchten. Der Standardport ist 25. Ein Wert in diesem Feld ist nur anwendbar, wenn das Feld SMTP-Sicherheit unten auf Keine oder TLS eingestellt ist. Wenn das Feld SMTP-Sicherheit auf SSL eingestellt ist, wird immer Port 465 verwendet, unabhängig von dem Wert, der im Feld SMTP-Port eingegeben wurde. Dieses Feld wird nur angezeigt, wenn der oben ausgewählte Aktivitätstyp Beides oder Email senden ist.

  • SMTP-Sicherheit: Wenn die Aktivität auf Beides oder Email senden eingestellt ist, verwenden Sie das Menü, um eine dieser Optionen auszuwählen:

    • Keine: Der Email-Server erfordert keine Authentifizierung.

    • SSL: Der Email-Server verwendet SSL-Verschlüsselung zur Authentifizierung.

    • TLS: Der Email-Server verwendet TLS-Verschlüsselung zur Authentifizierung.

  • SMTP-Benutzername: Geben Sie den Benutzernamen ein (falls vom SMTP-Email-Server erforderlich).

  • SMTP-Passwort: Geben Sie das Passwort ein (falls vom SMTP-Email-Server erforderlich). Sichtbar nur, wenn Authentifizierungstyp auf Basic Auth eingestellt ist.

    Hinweis

    Beim Verbinden mit Gmail geben Sie anstelle des Kontopassworts ein App-Passwort ein.

  • IMAP-Host: Geben Sie den Hostnamen des IMAP-Email-Servers ein, mit dem Sie sich verbinden möchten. Dieses Feld wird nur angezeigt, wenn Aktivität auf Beides oder Email lesen eingestellt ist.

  • IMAP-Port: Geben Sie die Portnummer des IMAP-Email-Servers ein, mit dem Sie sich verbinden möchten. Der Standardport ist 993. Dieses Feld wird nur angezeigt, wenn die Aktivität auf Beides oder Email lesen eingestellt ist.

  • IMAP-Sicherheit: Wenn die Aktivität auf Beides oder Email lesen eingestellt ist, verwenden Sie das Menü, um eine dieser Optionen auszuwählen:

    • Keine: Der Email-Server erfordert keine Authentifizierung.

    • SSL: Der Email-Server verwendet SSL-Verschlüsselung zur Authentifizierung.

    • TLS: Der Email-Server verwendet TLS-Verschlüsselung zur Authentifizierung.

  • IMAP-Benutzername: Geben Sie den Benutzernamen ein (falls vom IMAP-Email-Server erforderlich).

  • IMAP-Passwort: Geben Sie das Passwort ein (falls vom IMAP-Email-Server erforderlich). Sichtbar nur, wenn Authentifizierungstyp auf Basic Auth eingestellt ist.

    Hinweis

    Beim Verbinden mit Gmail geben Sie anstelle des Kontopassworts ein App-Passwort ein.

  • Proxy-Einstellungen verwenden (nur privater Agent): Bei Verwendung eines privaten Agents kann diese Einstellung ausgewählt werden, um Proxy-Einstellungen für private Agenten zu verwenden. Diese Option ist nur funktionsfähig, wenn OAuth 2.0 als Authentifizierungstyp verwendet wird.

  • Test: Klicken Sie, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Organisation Richtlinie Automatische Connector-Aktualisierung deaktivieren. Die Benutzername- und Passwortfelder für ein bestimmtes Protokoll werden nur zur Überprüfung verwendet, wenn beide vorhanden sind und das Sicherheitsfeld auf SSL oder TLS eingestellt ist.

  • Änderungen speichern: Klicken Sie, um die Konfigurationsänderungen zu speichern und die Verbindung zu schließen.

  • Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

  • Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung wirklich löschen möchten.

Nächste Schritte

Nachdem eine Email-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfsgrafik, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Palette der Entwurfskomponenten zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

  • Email senden: Sendet Emails über das Simple Mail Transfer Protocol (SMTP) an die angegebenen Empfänger und ist als Ziel in einem Vorgang vorgesehen.

  • Email lesen: Ruft ungelesene Emails über das Internet Message Access Protocol (IMAP) ab und ist als Quelle vorgesehen, um Daten für einen Vorgang bereitzustellen.