Zum Inhalt springen

E-Mail-Nachrichten in Jitterbit Design Studio

Übersicht

E-Mail-Nachrichten können bei erfolgreichem oder fehlgeschlagenem Abschluss einer Operation automatisch versendet werden. E-Mail-Nachrichten lassen sich auch so konfigurieren, dass sie von einem E-Mail-Ziel in einer Operation verwendet oder als Argument für die Funktion SendEmail genutzt werden.

Eine E-Mail-Nachricht erstellen

Gehen Sie wie folgt vor, um eine E-Mail-Nachricht zu erstellen und zu konfigurieren, die bei erfolgreicher oder fehlgeschlagener Ausführung einer Operation versendet wird:

  1. Klicken Sie im Projektbaum mit der rechten Maustaste auf den Knoten Email Messages und wählen Sie im Menü New Email Message aus.

    Die Registerkarte New Email Message wird in der rechten Konsole angezeigt:

    attachment

  2. Vervollständigen Sie die Eigenschaften der Nachricht.

    Tipp

    Die Felder SMTP Mail Servers, To, From, Subject und Text unterstützen Substitutionen von globalen Variablen. Wenn Sie beispielsweise erst zur Laufzeit wissen, wer der Empfänger ist, können Sie eine globale Variable namens notify_email in der Transformation definieren (mit DBLookup oder mit Eingabedaten) und dann [notify_email] in das Feld To eingeben.

    • Name: (Erforderlich) Der Name der Nachricht, der innerhalb des Projekts eindeutig sein muss.

    • SMTP Mail Servers: Kommagetrennte Liste der SMTP-Server zum Versand der E-Mail. Die Server werden in der angegebenen Reihenfolge ausprobiert, bis einer gefunden wird, der die Nachricht akzeptiert. Um einen Port anzugeben, verwenden Sie das Format smtp.server.com:PORT (z. B. smtp.server.com:533).

      Hinweis

      Um OAuth 2.0 mit Microsoft 365-E-Mail zu unterstützen, können zusätzliche Parameter in der SMTP-Host-Zeichenfolge über das Feld SMTP Mail Servers übergeben werden. Anweisungen finden Sie unter OAuth 2-Unterstützung für Microsoft 365-E-Mail weiter unten.

    • To: (Erforderlich) Kommagetrennte Liste der Empfänger.

    • From: Die E-Mail-Adresse, die im Feld From angezeigt wird, wenn die Empfänger die E-Mail lesen.

    • Use SSL/TLS: Wählen Sie diese Option, um die E-Mail mit SSL/TLS-Protokoll zu verschlüsseln. Dies ist für viele moderne SMTP-Dienste erforderlich, einschließlich Microsoft 365-E-Mail. Diese Eigenschaft beeinflusst den Standardwert für den optionalen Parameter starttls, wie unter OAuth 2-Unterstützung für Microsoft 365-E-Mail weiter unten beschrieben.

    • Authentication: Um Authentifizierung mit Benutzername und Passwort oder den Grant Type password mit OAuth 2.0 zu verwenden, erweitern Sie Authentication und wählen Sie Use authentication aus. Geben Sie dann ein Account und ein Konto-Password ein. Use authentication ist mit dem Grant Type client_credentials nicht erforderlich. Weitere Informationen zu beiden Grant Types finden Sie unter Grant Types weiter unten.

      Hinweis

      OAuth 2.0 wird für Microsoft 365 wie unter OAuth 2-Unterstützung für Microsoft 365-E-Mail weiter unten beschrieben unterstützt.

    • Optional: Erweitern Sie Optional, um zusätzliche optionale Felder anzuzeigen:

      • CC: Kommagetrennte Liste der E-Mail-Adressen, die eine Kopie der Nachricht erhalten.
      • BCC: Kommagetrennte Liste der E-Mail-Adressen, die eine blinde Kopie der Nachricht erhalten.
      • Reply To: Eine E-Mail-Adresse, an die Antworten gesendet werden sollen (wird standardmäßig verwendet, wenn der Empfänger in seiner E-Mail-Anwendung antwortet). Dies kann verwendet werden, wenn Sie die E-Mail von einem Konto versenden, aber Antworten zu einem anderen E-Mail-Konto gehen sollen.

    • Subject: Der Betreff der E-Mail.

    • Text: Der Text der E-Mail.

  3. Klicken Sie auf das Symbol Save in der Symbolleiste oben rechts, um die E-Mail-Nachricht zu speichern.

  4. Klicken Sie im Projektbaum auf die Operation, zu der Sie die Benachrichtigungsnachricht hinzufügen möchten.

    Das Operationsgrafik wird in der rechten Konsole angezeigt.

  5. Klicken Sie in der Operationsgrafik auf das Symbol attachment oben im Operationsgrafik, um das Operationsmenü anzuzeigen.

  6. Wählen Sie im Menü Bei Erfolg > E-Mail > Vorhandene auswählen oder Bei Fehler > E-Mail > Vorhandene auswählen.

  7. Ein Popup-Fenster zeigt die Liste der vorhandenen E-Mail-Nachrichten an. Wählen Sie die in den vorherigen Schritten erstellte E-Mail-Nachricht aus und klicken Sie auf OK.

  8. Die E-Mail-Nachricht wird zum Operationsgrafik hinzugefügt:

    • Eine grüne Linie und ein Symbol werden für eine E-Mail-Nachricht angezeigt, die bei erfolgreicher Ausführung der Operation versendet wird.
    • Eine rote Linie und ein Symbol werden für eine E-Mail-Nachricht angezeigt, die bei Fehler der Operation versendet wird.

OAuth 2.0-Unterstützung für Microsoft 365-E-Mail

Um OAuth 2.0 mit Microsoft 365-E-Mail zu nutzen, geben Sie zusätzliche Parameter in der SMTP-Host-Zeichenfolge über das Feld SMTP-Mailserver an. Diese zusätzlichen Parameter werden mit Cloud-Agenten, 11.x-Private-Agenten mindestens Version 11.1.1 und 10.x-Private-Agenten mindestens Version 10.63.1 unterstützt.

Wichtig

Agent-Version 10.83 / 11.21 oder später ist erforderlich, um den Parameter starttls zu verwenden. Das Setzen dieses Parameters auf true ist erforderlich, um sicheren Traffic über traditionell ungesicherte Ports wie 25 zu erzwingen, wenn SSL/TLS verwenden aktiviert ist.

Die Eigenschaften im Feld SMTP-Mailserver müssen im folgenden Groß-/Kleinschreibung-sensitiven Format vorliegen:

Format des Feldes SMTP-Mailserver
<SMTP Host>?clientId=<Client ID>&tenant=<Tenant>&clientSecret=<Client Secret>
Teil Beschreibung
SMTP Host Der SMTP-Server.
Client ID (clientId) Die vom OAuth-Anbieter erhaltene Client-ID.
Tenant (tenant) Die vom OAuth-Anbieter erhaltene Tenant-ID.
Client Secret (clientSecret) Das vom OAuth-Anbieter erhaltene Client Secret.

Diese zusätzlichen optionalen Parameter können auch verwendet werden, falls erforderlich, um Standardwerte außer Kraft zu setzen:

Teil Beschreibung
Port (port) Standard: 587. Der SMTP-Port.
STARTTLS (starttls) Standard: false, wenn SSL/TLS verwenden aktiviert ist, andernfalls true. Setzen Sie auf true, um sicheren Traffic über traditionell ungesicherte Ports wie 25 zu erzwingen, wenn SSL/TLS verwenden aktiviert ist. Agent-Versionen 10.83 / 11.21 oder später sind erforderlich, um diesen Parameter zu verwenden.
URL-Kodierung (urlEncoded) Standard: false. Setzen Sie auf true, wenn Werte URL-kodiert werden müssen.
Scope (scope) Standard: https://outlook.office365.com/.default.
Token (tokenEndpoint) Standard: https://login.microsoftonline.com/ + tenant + /oauth2/v2.0/token.
Grant Type (grantType) Standard: password oder client_credentials, je nach Authentifizierung verwenden. Weitere Informationen finden Sie unter Grant-Typen.

Beispieleingaben für das Feld SMTP-Mailserver unter Verwendung von OAuth 2.0:

Beispiel 1 (Hartcodiert)
smtp.office365.com?clientId=1234ab5c6d78e9f&tenant=abcdefgh-ij12-3456&clientSecret=Abc1-d2E3f-GhIjKlMn4-Opqrs_567&port=25&starttls=true
Beispiel 2 (Mit Variablen, Bereich und URL-Codierung)
[email.server]?clientId=[clientId]&tenant=[tenant]&clientSecret=[clientSecret]&[scope]&urlEncoded=true

Grant-Typen

Der Parameter grantType bestimmt, welcher OAuth 2.0-Grant-Typ zur Authentifizierung bei Microsoft 365 verwendet wird: entweder password oder client_credentials.

Der Standardwert ist password, wenn Authentifizierung verwenden unter Authentifizierung mit einem gültigen Konto und Kennwort des Kontos ausgewählt ist, oder client_credentials, wenn Authentifizierung verwenden deaktiviert ist.

Private-Agent-Version 12.13 oder später ist erforderlich, damit ein deaktiviertes Kontrollkästchen Authentifizierung verwenden standardmäßig auf den Grant-Typ client_credentials gesetzt wird. Bei früheren Private-Agent-Versionen wird die Deaktivierung von Authentifizierung verwenden weiterhin standardmäßig auf den Grant-Typ password gesetzt. Legen Sie stattdessen grantType=client_credentials explizit im Feld SMTP-Mailserver fest.

Um E-Mails mit dem Grant-Typ client_credentials zu versenden, muss die Microsoft 365-Umgebung diese Anforderungen erfüllen:

  • Die App-Registrierung verfügt über die Berechtigung SMTP.SendAsApp für die Anwendung, mit gewährter Admin-Zustimmung.
  • Ein Service Principal ist für die App-Registrierung mit dem Cmdlet New-ServicePrincipal registriert.
  • Der Service Principal hat die Postfachberechtigungen SendAs und FullAccess.
  • Die authentifizierte SMTP-Verbindung ist im Postfach aktiviert.

Dynamische Parameter

Dateiname-Schlüsselwörter wie [date] funktionieren nicht in den Feldern Betreff oder Text.

Alternativ dazu können Sie die Jitterbit-Funktion date verwenden. Um ein Datum als Variable zu übergeben, können Sie eine Variable in einem Skript erstellen, ihr einen Wert zuweisen und sie dann in der E-Mail-Nachricht verwenden. Beispiel:

$date = Now();  # Gibt das aktuelle Datum und die aktuelle Uhrzeit an
$date = CVTDate(Now(),"yyyy-mm-dd HH:MM:SS","yyyy-mm-dd");  # Gibt nur das Datum an

HTML-E-Mails

Sie können HTML im Text der Nachricht verwenden:

attachment

Variablen (in diesem Fall eine globale Variable email.html) können in HTML-Tags verwendet werden:

attachment