Email Verbindung

Einführung

Eine Email Verbindung, die mit dem Email Connector erstellt wurde, stellt den Zugriff auf einen Email-Server her. Sobald eine Verbindung konfiguriert ist, können Sie Instanzen von Email Aktivitäten erstellen, die mit dieser Verbindung verknüpft sind und entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden können.

Erstellen oder Bearbeiten einer Email Verbindung

Eine neue Email-Verbindung wird mithilfe des Email Connectors von einem dieser Standorte aus erstellt:

• Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).
• Die Seite Globale Verbindungen (siehe Einen globalen Endpoint erstellen in Globale Verbindungen).

Eine bestehende Email Verbindung kann von diesen Orten aus bearbeitet werden:

• Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).
• Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).
• Die Seite Globale Verbindungen (siehe Einen globalen Endpoint bearbeiten in Globale Verbindungen).

Konfigurieren einer Email Verbindung

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

• Verbindungsname: Geben Sie einen Namen ein, der zur Identifizierung der Verbindung verwendet werden soll. Der Name muss für jede Email-Verbindung eindeutig sein und darf keine Schrägstriche enthalten / oder Doppelpunkte :. Dieser Name wird auch zur Identifizierung des Email Endpoint verwendet, der sich sowohl auf eine bestimmte Verbindung als auch auf ihre Aktivitäten bezieht.

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

  • Einfache Authentifizierung: SMTP- und IMAP-Serverauthentifizierung mit Benutzernamen- und Passwortkombinationen.

  • OAuth2: Es wurde bestätigt, dass diese Option mit Microsoft 365 funktioniert (siehe Voraussetzungen). Andere Email Server funktionieren vermutlich auch, wurden aber von Jitterbit nicht getestet. Wenn diese Option ausgewählt ist, 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

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

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

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

    • Client Secret: Geben Sie das Client Secret ein.

    • Geltungsbereich: Geben Sie den Geltungsbereich ein.

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

      Wichtig

      So senden Sie Emails über Microsoft 365 (smtp.office365.com), muss für Grant Type ROPC (Resource Owned Password Credentials) ausgewählt werden.

    • Passwort: Geben Sie ein gültiges Passwort ein. Nur sichtbar, 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, einen der folgenden: Beides, Email senden oder Email lesen:

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

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

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

• SMTP-Host: Geben Sie den Host 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 Port des SMTP- Email-Servers ein, mit dem eine Verbindung hergestellt werden soll. Der Port 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 vom im Feld SMTP-Port eingegebenen Wert. Dieses Feld wird nur angezeigt, wenn der oben ausgewählte Aktivitätstyp Beides oder Email senden ist.

• SMTP-Sicherheit: Wenn der ausgewählte Aktivitäts-Typ Beides oder Email senden ist, wählen Sie im Menü entweder Keine, SSL oder TLS aus.

  • Keine: Der Email Server erfordert keine Authentifizierung.

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

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

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

• SMTP-Passwort: Geben Sie das Passwort ein (falls vom SMTP- Email-Server verlangt). Nur sichtbar, wenn Authentifizierungstyp auf Einfache Authentifizierung eingestellt ist.

  Hinweis

  Geben Sie beim Verbinden mit Gmail ein App-Passwort ein anstelle des Kontokennworts.

• IMAP-Host: Geben Sie den Host des IMAP- Email-Servers ein, mit dem eine Verbindung hergestellt werden soll. Dieses Feld wird nur angezeigt, wenn der oben ausgewählte Aktivitätstyp Beides oder Email lesen ist.

• IMAP-Port: Geben Sie die Port des IMAP- Email-Servers ein, mit dem eine Verbindung hergestellt werden soll. Der Port ist 993. Dieses Feld wird nur angezeigt, wenn der oben ausgewählte Aktivitätstyp Beides oder Email lesen ist.

• IMAP-Sicherheit: Wenn der ausgewählte Aktivitäts-Typ Beides oder Email lesen ist, wählen Sie im Menü entweder Keine, SSL oder TLS aus.

  • Keine: Der Email Server erfordert keine Authentifizierung.

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

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

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

• IMAP-Passwort: Geben Sie das Passwort ein (falls vom IMAP- Email-Server verlangt). Nur sichtbar, wenn Authentifizierungstyp auf Basisauthentifizierung eingestellt ist.

  Hinweis

  Geben Sie beim Verbinden mit Gmail ein App-Passwort ein anstelle des Kontokennworts.

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

• Test: Klicken Sie hier, 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 der aktuellen Umfeld zugeordnet ist. Dieser Connector unterstützt das Anhalten des Downloads der neuesten Connector-Version mithilfe der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren. Die Felder Benutzername und Passwort für ein bestimmtes Protokoll werden nur dann zur Überprüfung verwendet, wenn beide vorhanden sind und das Sicherheitsfeld entweder auf SSL oder TLS eingestellt ist.

• Änderungen speichern: Klicken Sie hier, um die Verbindungskonfiguration zu speichern und zu schließen.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen an einer neuen oder vorhandenen Konfiguration hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

• Löschen: Klicken Sie nach dem Öffnen einer vorhandenen Verbindungskonfiguration hier, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschen und Entfernen). Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Verbindung löschen möchten.

Nächste Schritte

Nachdem eine Email Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Design-Canvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden können.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Design-Komponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.

Folgende Aktivitätstypen stehen zur Verfügung:

• Email senden: Sendet Email mithilfe des Simple Mail Transfer Protocol (SMTP) an angegebene Empfänger und soll als Ziel in einer Operation verwendet werden.

• Email lesen: Ruft ungelesene Email mithilfe des Internet Message Access Protocol (IMAP) ab und soll als Quelle für die Bereitstellung von Daten für einen Operation verwendet werden.