E-Mail-Benachrichtigungen in Jitterbit Studio

Einführung

In Studio konfigurierte Benachrichtigungen werden durch eine Betriebsaktion ausgelöst oder aus einem Skript gestartet. E-Mail-Benachrichtigungen können verwendet werden, um automatisch eine E-Mail über den Erfolg oder das Scheitern einer Operation oder beim Aufrufen eines Skripts zu senden.

Wenn Sie stattdessen eine E-Mail-Benachrichtigung konfigurieren möchten, die ausgelöst wird, wenn ein privater Agent ausfällt oder Ihr Harmony-Passwort kurz vor dem Ablauf steht, siehe Benachrichtigungen.

Für andere Möglichkeiten zur Konfiguration von E-Mail-Benachrichtigungen in Studio siehe Möglichkeiten zum Senden von E-Mails.

Erstellen oder Bearbeiten einer E-Mail-Benachrichtigung

E-Mail-Benachrichtigungen können im Projektbereich, in den Betriebseinstellungen oder in einem Skript erstellt oder bearbeitet werden.

Neue E-Mail-Benachrichtigungen werden mit dem Standardnamen Neue E-Mail erstellt. Nachfolgende neue Benachrichtigungen mit Standardnamen werden mit einer hochgezählten Zahl in Klammern ergänzt.

Nachdem Sie eine E-Mail-Benachrichtigung erstellt oder eine vorhandene E-Mail-Benachrichtigung zum Bearbeiten geöffnet haben, siehe Konfigurieren einer E-Mail-Benachrichtigung weiter unten auf dieser Seite zur Konfiguration.

Projektbereich

Eine neue E-Mail-Benachrichtigung kann im Komponenten-Tab des Projektbereichs mit der Option Neu erstellen in der Kategorie E-Mails erstellt werden (siehe Aktionenmenü des Komponenten-Tabs im Komponenten-Tab des Projektbereichs).

Eine vorhandene Benachrichtigung kann im Komponenten-Tab des Projektbereichs mit der Option Anzeigen/Bearbeiten bei einem E-Mail-Benachrichtigungskomponenten bearbeitet werden (siehe Aktionenmenü der Komponenten im Komponenten-Tab des Projektbereichs).

Betriebseinstellungen

Sie können auch E-Mail-Benachrichtigungen im Aktionen-Tab der Einstellungen der Operation erstellen oder bearbeiten, die von diesen Orten aus zugänglich sind:

• Der Workflows-Tab im Projektbereich (siehe Komponenten-Aktionsmenü im Projektbereich Workflows-Tab).
• Der Komponenten-Tab im Projektbereich (siehe Komponenten-Aktionsmenü im Projektbereich Komponenten-Tab).
• Die Entwurfskanvas (siehe Komponenten-Aktionsmenü im Entwurfskanvas).

Sobald der Bildschirm Einstellungen der Operation geöffnet ist, wählen Sie den Aktionen-Tab. Wählen Sie die Bedingung aus, und für die Aktion wählen Sie E-Mail-Benachrichtigung senden. Um eine neue E-Mail-Benachrichtigung zu erstellen, klicken Sie auf den Link Neue E-Mail-Benachrichtigung erstellen, um den Bildschirm Konfiguration der E-Mail-Benachrichtigung zu öffnen:

Um eine vorhandene E-Mail-Benachrichtigung zu bearbeiten, stellen Sie sicher, dass E-Mail-Benachrichtigung senden als Aktion ausgewählt ist. Fahren Sie dann im Dropdown-Menü E-Mail-Benachrichtigung über die vorhandene Benachrichtigung und klicken Sie auf das Bearbeiten-Symbol, um den Bildschirm Konfiguration der E-Mail-Benachrichtigung zu öffnen.

Skript

Möglicherweise möchten Sie ein Skript verwenden, das für die Operation konfiguriert werden kann, um erweiterte Logik dafür einzuschließen, wann die E-Mail-Benachrichtigung gesendet werden soll. Zum Beispiel, um nach einem bestimmten Code oder Fehlerzustand zu suchen, könnten Sie ein Skript verwenden, um mehr Kontrolle darüber zu haben, was passiert, wenn Sie einen Fehler haben.

Innerhalb des Skripteditors öffnen Sie die Benachrichtigungen-Registerkarte der Skriptkomponentenpalette.

Um eine neue E-Mail-Benachrichtigung zu erstellen, klicken Sie auf Neu hinzufügen.

Um eine vorhandene Benachrichtigung zu bearbeiten, klicken Sie auf den Namen der Benachrichtigung.

Aktionenmenü für E-Mail-Benachrichtigungen

Nachdem eine E-Mail-Benachrichtigung erstellt wurde, sind die Menüaktionen für diese Benachrichtigung im Komponenten-Tab des Projektbereichs zugänglich (siehe Aktionenmenü für Komponenten im Projektbereich Komponenten-Tab).

Jede dieser Menüaktionen ist verfügbar:

Menüelement	Beschreibung
	Anzeigen/Bearbeiten öffnet den Bildschirm zur Konfiguration der E-Mail-Benachrichtigung, damit Sie die Benachrichtigung konfigurieren können. Für Details siehe Konfigurieren einer E-Mail-Benachrichtigung weiter unten auf dieser Seite.
	Ausschneiden platziert eine Kopie der E-Mail-Benachrichtigung in Ihrer Zwischenablage und löscht die ursprüngliche E-Mail-Benachrichtigung aus dem Projekt (siehe Komponentenwiederverwendung).
	Kopieren platziert eine Kopie der E-Mail-Benachrichtigung in Ihrer Zwischenablage (siehe Komponentenwiederverwendung).
	Duplizieren erstellt eine neue, nicht referenzierte E-Mail-Benachrichtigung mit derselben Konfiguration wie die ursprüngliche E-Mail-Benachrichtigung (siehe Komponentenwiederverwendung).
	Umbenennen positioniert den Cursor auf dem Namen der E-Mail-Benachrichtigung, damit Sie bei Bedarf Änderungen vornehmen können.
	Abhängigkeiten anzeigen ändert die Ansicht im Projektbereich, um andere Teile des Projekts anzuzeigen, von denen die E-Mail-Benachrichtigung abhängt (siehe Komponentenabhängigkeiten, Löschung und Entfernung).
	Zur Gruppe hinzufügen öffnet einen Dialog, um eine neue benutzerdefinierte Gruppe zu erstellen oder die E-Mail-Benachrichtigung einer vorhandenen Gruppe hinzuzufügen (siehe Komponentengruppen).
	Löschen löscht die E-Mail-Benachrichtigung dauerhaft (siehe Komponentenabhängigkeiten, Löschung und Entfernung).
	Entfernen entfernt Referenzen zur E-Mail-Benachrichtigung, die mit einer Operationsaktion auf der Entwurfskanvas konfiguriert sind (siehe Komponentenabhängigkeiten, Löschung und Entfernung).

Konfigurieren einer E-Mail-Benachrichtigung

In diesem Abschnitt wird die Konfiguration einer E-Mail-Benachrichtigung behandelt. Nachdem dies abgeschlossen ist, können Sie eine E-Mail konfigurieren, die im Erfolgs- oder Fehlerfall einer Operation gesendet wird (siehe Operationen Aktionen) oder die Benachrichtigung zu einem Skript hinzufügen (siehe Skripttypen und Erstellung).

Wenn Sie eine neue E-Mail-Benachrichtigung erstellen oder eine vorhandene bearbeiten, öffnet sich der Konfigurationsbildschirm für die E-Mail-Benachrichtigung:

• Name der E-Mail-Benachrichtigung: Geben Sie einen Namen für die E-Mail-Benachrichtigung ein. Der Name muss für jede E-Mail-Benachrichtigung eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

• SMTP-E-Mail-Server: Geben Sie mindestens einen SMTP-Server ein, den Sie zum Senden der E-Mail verwenden möchten. Wenn Sie mehrere SMTP-Server eingeben, verwenden Sie ein Komma, um jeden einzelnen zu trennen. Die Server werden in der Reihenfolge ausprobiert, in der sie angegeben sind, bis einer gefunden wird, der die Nachricht akzeptiert. Um einen Port anzugeben, verwenden Sie das Format smtp.server.com:PORT (zum Beispiel smtp.server.com:533).

• E-Mail-Adresse(n) an: Geben Sie mindestens eine E-Mail-Adresse ein, um die E-Mail zu empfangen. Wenn Sie mehrere Empfänger eingeben, verwenden Sie ein Komma, um jeden einzelnen zu trennen.

  Tipp

  Wenn Sie nicht wissen, wer der/die Empfänger ist/sind, bis Sie eine Operation ausgeführt haben, können Sie eine globale Variable definieren und verwenden. Zum Beispiel könnte eine globale Variable [notify_email] Werte verwenden, die von der Funktion DBLookup zurückgegeben werden, um die E-Mail-Adresse(n) nachzuschlagen.

• Von E-Mail-Adresse: Geben Sie die E-Mail-Adresse ein, von der die E-Mail erscheinen soll, wenn die Empfänger die E-Mail lesen.

• Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern:

  

  • SSL/TLS verwenden: Wählen Sie das Kontrollkästchen aus, um die E-Mail mit dem SSL/TLS-Protokoll zu verschlüsseln.

  • CC E-Mail-Adresse(n): Geben Sie eine oder mehrere E-Mail-Adressen ein, um eine Kopie der E-Mail zu erhalten. Wenn Sie mehrere kopierte Empfänger eingeben, verwenden Sie ein Komma, um jeden einzelnen zu trennen.

  • BCC E-Mail-Adresse(n): Geben Sie eine oder mehrere E-Mail-Adressen ein, um eine Blindkopie der E-Mail zu erhalten. Wenn Sie mehrere blindkopierte Empfänger eingeben, verwenden Sie ein Komma, um jeden einzelnen zu trennen.

  • Antworten an E-Mail-Adresse: Geben Sie die E-Mail-Adresse ein, an die Antworten standardmäßig gesendet werden sollen. Dies kann nützlich sein, wenn Sie die E-Mail von einem gemeinsamen Konto senden, aber möchten, dass Antworten an ein persönliches E-Mail-Konto gesendet werden.

  • Authentifizierung verwenden: Wählen Sie das Kontrollkästchen aus, wenn der SMTP-Server eine Authentifizierung erfordert. Wenn Sie diese Option auswählen, werden die Felder Konto und Passwort unten aktiviert, damit Sie Ihre Authentifizierungsdaten eingeben können.

    

• Betreff und Nachricht: Geben Sie den Betreff und den Text für die E-Mail ein. Um globale Variablen, Projektvariablen oder Jitterbit-Variablen in der Nachricht zu verwenden, geben Sie diese manuell ein oder beginnen Sie, ein offenes Quadratklammern [ in das Feld einzugeben, um eine Liste vorhandener Variablen anzuzeigen, aus der Sie auswählen können.

  Hinweis

  Dateinamen-Schlüsselwörter wie [date] funktionieren nicht in den Feldern Betreff oder Nachricht, wenn sie nicht zuerst als globale Variablen definiert sind. Um Datum- und Zeitfunktionen zu verwenden, um eine globale Variable zu befüllen, können Sie dies innerhalb eines Skripts tun. Zum Beispiel:

  // This sets the global variable equal to the current date and time
  $date = Now()
  // This sets the global variable equal to just the date
  $date = CVTDate(Now(),"yyyy-mm-dd HH:MM:SS","yyyy-mm-dd")
  

  Tipp

  Sie können HTML in der Nachricht verwenden. Variablen können innerhalb von HTML-Tags mit eckigen Klammern verwendet werden, wie im folgenden Beispiel mit der Variablen email_address gezeigt:

  <html>
  <head>
  <title>Page Title</title>
  </head>
  <body>
  <h1>This Is a Heading</h1>
  <p>This is a paragraph.</p>
  <p>[Visit our HTML tutorial.](https://www.example.com/html/message/)</p>
  <p>Send me an email at [email_address].</p>
  </body>
  </html>
  

• Test: Klicken Sie, um eine Test-E-Mail mit der Konfiguration zu senden. Das Senden einer Test-E-Mail wird empfohlen, um sicherzustellen, dass die Konfiguration ordnungsgemäß und wie erwartet funktioniert. Wenn Variablen in der Konfiguration verwendet werden, müssen Sie möglicherweise einen Standardwert angeben, der für Testzwecke verwendet wird (siehe Variablen).

• Speichern: Klicken Sie, um die Konfiguration der E-Mail-Benachrichtigung zu speichern und zu schließen.

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

Fügen Sie einer Operation oder einem Skript eine E-Mail-Benachrichtigung hinzu

Das Senden einer E-Mail-Benachrichtigung kann als Aktion hinzugefügt werden, die bei Erfolg oder Misserfolg der Operation ausgeführt wird, oder kann einem Skript hinzugefügt werden, um mithilfe fortgeschrittener Logik zu bestimmen, wann die E-Mail gesendet werden soll. Dies wird entweder in den Betriebseinstellungen oder innerhalb eines Skripts konfiguriert.

Betriebseinstellungen

Öffnen Sie die Betriebseinstellungen für eine vorhandene Operation und wählen Sie die Registerkarte Aktionen. Konfigurieren Sie dann die Betriebsaktion wie folgt:

1. Wählen Sie im ersten Dropdown die entsprechende Bedingung der Operation aus, die die Aktion auslösen soll (Bei Erfolg oder Bei Fehler).
2. Wählen Sie im zweiten Dropdown E-Mail senden.
3. Wählen Sie im dritten Dropdown die konfigurierte E-Mail-Benachrichtigung aus.
4. Klicken Sie auf Aktion hinzufügen, um die E-Mail-Benachrichtigung zur Operation hinzuzufügen.

Für eine detailliertere Erklärung der Optionen siehe Betriebsaktionen.

Verknüpfte E-Mail-Benachrichtigungen werden direkt auf der Entwurfskanvas angezeigt, die mit der Operation verbunden sind, mit der sie assoziiert sind:

Script

Innerhalb eines in Jitterbit Script geschriebenen Skripts öffnen Sie die Benachrichtigungen-Registerkarte der Skriptkomponentenpalette.

Um eine Benachrichtigung und die Funktion hinzuzufügen, die zur Ausführung benötigt wird, verwenden Sie die SendEmailMessage Funktion und den Benachrichtigungsreferenz als Funktionsargument. Für weitere Details siehe Benachrichtigungen in Jitterbit Script.