Email Nachrichten in Jitterbit Design Studio

Übersicht

Email Nachrichten können automatisch gesendet werden, wenn eine Operation erfolgreich war oder fehlschlug. Email Nachrichten können auch so konfiguriert werden, dass sie von einem Email Ziel verwendet werden in einer Operation oder als Argument für die SendEmail Funktion.

Erstellen einer Email Nachricht

Befolgen Sie diese Schritte, um eine Email-Nachricht zu erstellen und zu konfigurieren, die bei erfolgreichem Abschluss oder Fehlschlagen einer Operation gesendet werden soll:

1. Klicken Sie im Projektbaum mit der rechten Maustaste auf den Knoten Email-Nachrichten und wählen Sie im Menü Neue Email Nachricht.

   Die Tab Neue Email Nachricht wird im rechten Bereich angezeigt:

   

2. Vervollständigen Sie die Eigenschaften der Nachricht.

   Tipp

   Die Felder SMTP-Mailserver, An, Von, Betreff und Text erkennen globale Variablensubstitutionen. Wenn Sie beispielsweise erst zur Laufzeit wissen, wer der Empfänger sein wird, können Sie eine globale Variable namens notify_email in der Transformation (mithilfe einer DBLookup oder mit Eingabedaten) und geben Sie dann [notify_email] im Feld An.

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

   • SMTP-Mailserver: Durch Kommas getrennte Liste der SMTP-Server, die zum Senden der Email verwendet werden sollen. Die Server werden in der angegebenen Reihenfolge ausprobiert, bis einer gefunden wird, der die Nachricht akzeptiert.

     Notiz

     Um Unterstützung für OAuth 2.0 mit Microsoft 365- Email bereitzustellen, können zusätzliche Parameter in der SMTP- Host mithilfe des Felds SMTP-Mailserver übergeben werden. Anweisungen finden Sie unter OAuth 2-Unterstützung für Microsoft 365 Email unten.

   • An: (Erforderlich) Durch Komma getrennte Empfängerliste.

   • Von: Die Email Adresse, die im Feld Von angezeigt werden soll, wenn der/die Empfänger die Email lesen.

   • SSL/TLS verwenden: Wählen Sie diese Option, um die Email mit dem SSL/TLS-Protokoll zu verschlüsseln. Diese Eigenschaft beeinflusst den Standardwert für die optionale starttls Parameter wie in OAuth 2-Unterstützung für Microsoft 365 Email beschrieben unten.

   • Authentifizierung: Um die Basisauthentifizierung zu verwenden, erweitern Sie Authentifizierung und wählen Sie Authentifizierung verwenden. Sie können dann ein Konto und ein Konto-Passwort eingeben.

     Notiz

     OAuth 2.0 wird für Microsoft 365 unterstützt, wie unter OAuth 2-Unterstützung für Microsoft 365 Email beschrieben unten.

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

     • CC: Durch Komma getrennte Liste von Email-Adressen, die eine Kopie der Nachricht erhalten sollen.
     • BCC: Durch Kommas getrennte Liste von Email Adressen, die eine Blindkopie der Nachricht erhalten.
     • Antworten an: Eine Email-Adresse, an die Antworten gesendet werden sollen (wird standardmäßig verwendet, wenn der Empfänger in seiner Email-Anwendung antwortet). Dies kann verwendet werden, wenn Sie die Email von einem Konto aus senden, die Antworten jedoch an ein anderes Email-Konto gesendet werden sollen.

   • Betreff: Der Betreff der Email.

   • Text: Der Text der Email.

3. Klicken Sie in der Symbolleiste oben rechts auf das Symbol Speichern, um die Email Nachricht zu speichern.

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

   Das Operation wird im rechten Bereich angezeigt.

5. Klicken Sie im Operation auf oben in der Operation, um das Operation anzuzeigen.

   1. Wählen Sie im Menü Bei Erfolg > Email > Vorhandenes auswählen oder Bei Fehler > Email > Vorhandenes auswählen.

   2. In einem Popup-Fenster wird die Liste der vorhandenen Email Nachrichten angezeigt. Wählen Sie die in den vorherigen Schritten erstellte Email-Nachricht aus und klicken Sie auf OK.

6. Die Email-Nachricht wird der Operation hinzugefügt:

   • Für eine Email Nachricht, die so konfiguriert ist, dass sie bei erfolgreichem Abschluss des Operation gesendet wird, werden eine grüne Linie und ein grünes Symbol angezeigt.
   • Für eine Email-Nachricht, die bei einem fehlgeschlagenen Operation gesendet wird, werden eine rote Linie und ein rotes Symbol angezeigt.

OAuth 2.0-Unterstützung für Microsoft 365 Email

Um OAuth 2.0 mit Microsoft 365- Email zu verwenden, geben Sie zusätzliche Parameter in der SMTP- Host mithilfe des Felds SMTP-Mailserver an. Diese zusätzlichen Parameter werden mit Cloud-Agenten 11.3 oder höher, privaten 11.x-Agenten, die mindestens Version 11.1.1 aufweisen, und privaten 10.x-Agenten, die mindestens Version 10.63.1 aufweisen, unterstützt.

Die Eigenschaften im Feld SMTP-Mailserver sollten das folgende Format haben:

<SMTP Host>?clientId=<Client ID>&tenant=<Tenant>&clientSecret=<Client Secret>

Diese zusätzlichen optionalen Parameter können bei Bedarf auch verwendet werden, um Standardwerte zu überschreiben:

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

smtp.office365.com?clientId=1234ab5c6d78e9f&tenant=abcdefgh-ij12-3456&clientSecret=Abc1-d2E3f-GhIjKlMn4-Opqrs_567&port=25&starttls=true

[email.server]?clientId=[clientId]&tenant=[tenant]&clientSecret=[clientSecret]&[scope]&urlEncoded=true

Dynamische Parameter

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

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

$date = Now();  # Gives the current date and time
$date = CVTDate(Now(),"yyyy-mm-dd HH:MM:SS","yyyy-mm-dd");  # Gives just the date

HTML-E Emails

Sie können HTML im Nachrichtentext verwenden:

Variablen (in diesem Fall eine globale Variable email.html) kann innerhalb von HTML-Tags verwendet werden: