Email Benachrichtigungen im Jitterbit Integration Studio

Einführung

Benachrichtigungen konfiguriert in Integration Studio werden durch eine Operation ausgelöst oder von einem Script angestoßen. Email Benachrichtigungen können verwendet werden, um automatisch eine Email über den Erfolg oder Misserfolg einer Operation oder den Aufruf eines Script zu versenden.

Wenn Sie stattdessen eine Email Benachrichtigung konfigurieren möchten, die ausgelöst wird, wenn ein privater Agent ausfällt oder Ihr Harmony Passwort bald abläuft, lesen Sie Benachrichtigungen (Management Console).

Weitere Möglichkeiten zum Konfigurieren von Email Benachrichtigungen in Integration Studio, siehe Möglichkeiten zum Senden von Email.

Erstellen oder Bearbeiten einer Email Benachrichtigung

Email Benachrichtigungen können über den Projektbereich, die Operation oder ein Script erstellt oder bearbeitet werden.

Neue Email Benachrichtigungen werden mit dem Standardnamen Neue Email erstellt. Nachfolgenden neuen Benachrichtigungen mit Standardnamen wird eine in Klammern angehängte Nummer angehängt.

Nachdem Sie eine Email Benachrichtigung erstellt oder eine vorhandene Email Benachrichtigung zum Bearbeiten geöffnet haben, lesen Sie Email Benachrichtigung konfigurieren weiter unten auf dieser Seite zur Konfiguration.

Projektbereich

Eine neue Email Benachrichtigung kann über die Tab Komponenten des Projektbereichs mithilfe der Option Neu erstellen in der Kategorie Emails erstellt werden (siehe Aktionsmenü der Tab Komponenten im Projektbereich Tab Komponenten).

Eine vorhandene Benachrichtigung kann über die Tab Komponenten des Projektbereichs mithilfe der Option Anzeigen/Bearbeiten einer Email Benachrichtigungskomponente bearbeitet werden (siehe Aktionsmenü „Komponentenaktionen“ im Projektbereich Tab Komponenten).

Operationseinstellungen

Sie können Email Benachrichtigungen auch auf der Tab Aktionen der Operation Einstellungen erstellen oder bearbeiten. Auf die Registerkarte können Sie von diesen Orten aus zugreifen:

• Die Tab Workflows im Projektbereich (siehe Aktionsmenü Komponentenaktionen im Projektbereich Tab Workflows).
• Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).
• Die Design-Canvas (siehe Aktionsmenü „Komponentenaktionen“ in Entwurfsfläche).

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

Um eine vorhandene Email Benachrichtigung zu bearbeiten, stellen Sie sicher, dass Sie Email Benachrichtigung senden als Aktion ausgewählt haben. Bewegen Sie dann in der Dropdown-Liste Email Benachrichtigung den Mauszeiger über die vorhandene Benachrichtigung und klicken Sie auf das Bearbeiten-Symbol, um die Email Benachrichtigungskonfiguration zu öffnen Bildschirm.

Script

Möglicherweise möchten Sie ein Script verwenden, das für den Operation konfiguriert werden kann, um eine erweiterte Logik für den Zeitpunkt des Sendens der Email Benachrichtigung einzuschließen. Um beispielsweise nach einem bestimmten Code oder Fehlerstatus zu suchen, können Sie ein Script verwenden, um mehr Kontrolle darüber zu haben, was bei einem Fehler passiert.

Innerhalb des Script Editors öffnen Sie das Tab Benachrichtigungen der Skriptkomponentenpalette.

Um eine neue Email Benachrichtigung zu erstellen, klicken Sie auf Neu hinzufügen.

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

Aktionsmenü für Email Benachrichtigungen

Nachdem eine Email Benachrichtigung erstellt wurde, sind Menüaktionen für diese Benachrichtigung über die Tab Komponenten des Projektbereichs zugänglich (siehe Aktionsmenü im Projektbereich Tab Komponenten).

Jede dieser Menüaktionen ist verfügbar:

Menüelement	Beschreibung
	Anzeigen/Bearbeiten öffnet den Konfigurationsbildschirm für Email-Benachrichtigungen, damit Sie die Benachrichtigung konfigurieren können. Weitere Informationen finden Sie unter Konfigurieren einer Email Benachrichtigung weiter unten auf dieser Seite.
	Ausschneiden legt eine Kopie der Email-Benachrichtigung in Ihre Zwischenablage und löscht die ursprüngliche Email Benachrichtigung aus dem Projekt (siehe Komponentenwiederverwendung).
	Kopieren legt eine Kopie der Email Benachrichtigung in Ihre Zwischenablage (siehe Komponentenwiederverwendung).
	Duplicate erstellt eine neue, nicht referenzierte Email Benachrichtigung mit der gleichen Konfiguration wie die ursprüngliche Email Benachrichtigung (siehe Komponentenwiederverwendung).
	Umbenennen positioniert den Cursor auf den Namen der Email Benachrichtigung, damit Sie bei Bedarf Änderungen vornehmen können.
	Abhängigkeiten anzeigen ändert die Ansicht im Projektbereich, um alle anderen Teile des Projekts anzuzeigen, von denen die Email Benachrichtigung abhängig ist (siehe Komponentenabhängigkeiten, Löschen und Entfernen).
	Zur Gruppe hinzufügen öffnet einen Dialog zum Erstellen einer neuen benutzerdefinierten Gruppe oder zum Hinzufügen der Email Benachrichtigung zu einer vorhandenen Gruppe (siehe Komponentengruppen).
	Löschen löscht die Email Benachrichtigung dauerhaft (siehe Komponentenabhängigkeiten, Löschung und Entfernung).
	Entfernen entfernt Verweise auf die Email Benachrichtigung, die mit einer Operation konfiguriert sind auf der Design-Canvas (siehe Komponentenabhängigkeiten, Löschen und Entfernen).

Konfigurieren einer Email Benachrichtigung

In diesem Abschnitt wird die Konfiguration einer Email Benachrichtigung beschrieben. Anschließend können Sie eine Email konfigurieren, die bei erfolgreichem oder fehlgeschlagenem Operation gesendet wird (siehe Vorgangsaktionen) oder fügen Sie die Benachrichtigung einem Script hinzu (siehe Script und -erstellung).

Wenn Sie eine neue Email Benachrichtigung erstellen oder eine vorhandene bearbeiten, wird der Konfigurationsbildschirm für Email Benachrichtigungen geöffnet:

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

• SMTP- Email-Server: Geben Sie mindestens einen SMTP-Server ein, den Sie zum Senden der Email verwenden möchten. Wenn Sie mehrere SMTP-Server eingeben, trennen Sie diese durch Kommas. Die Server werden in der angegebenen Reihenfolge ausprobiert, bis einer gefunden wird, der die Nachricht akzeptiert.

• An Email-Adresse(n): Geben Sie mindestens eine Email-Adresse ein, an die die Email gesendet werden soll. Wenn Sie mehrere Empfänger eingeben, trennen Sie diese durch Kommas.

  Tipp

  Wenn Sie den/die Empfänger erst nach eine Operation Durchführen kennen, können Sie eine globale Variable definieren und verwenden. Eine globale Variable [notify_email] könnte Werte verwenden, die von der Funktion zurückgegeben werden DBLookup, um die Email Adresse(n) nachzuschlagen.

• Absender-Email-Adresse: Geben Sie die Email-Adresse ein, von der die Email gesendet werden soll, wenn der/die Empfänger die Email lesen.

• Optionale Einstellungen: Klicken Sie hier, um weitere optionale Einstellungen einzublenden:

  

  • SSL/TLS verwenden: Aktivieren Sie das Kontrollkästchen, um die Email mit dem SSL/TLS-Protokoll zu verschlüsseln.

  • CC- Email Adresse(n): Geben Sie eine oder mehrere Email-Adressen ein, an die eine Kopie der Email gesendet werden soll. Wenn Sie mehrere Empfänger in Kopie eingeben, trennen Sie diese durch Kommas.

  • BCC- Email Adresse(n): Geben Sie eine oder mehrere Email-Adressen ein, die eine Blindkopie der Email erhalten sollen. Wenn Sie mehrere Empfänger für Blindkopien eingeben, trennen Sie diese durch Kommas.

  • Antwort an Email-Adresse: Geben Sie die Email-Adresse ein, an die standardmäßig Antworten gesendet werden sollen. Dies kann nützlich sein, wenn Sie die Email von einem allgemeinen Konto senden, Antworten jedoch an ein persönliches Email-Konto gesendet werden sollen.

  • Authentifizierung verwenden: Aktivieren Sie das Kontrollkästchen, 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 der Email ein. Um globale Variablen zu verwenden,, Projektvariablen oder Jitterbit-Variablen in der Nachricht, geben Sie sie manuell ein oder beginnen Sie mit der Eingabe einer öffnenden eckigen Klammer [ in das Feld, um eine Liste vorhandener Variablen anzuzeigen, aus denen 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 wurden. So verwenden Sie Datums- und Uhrzeitfunktionen um eine globale Variable zu füllen, können Sie dies innerhalb eines Script tun. 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 mit der Variable gezeigt email_address unten:

  <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 hier, um eine Test-Email mit der Konfiguration zu senden. Das Senden einer Test-Email wird empfohlen, um sicherzustellen, dass die Konfiguration ordnungsgemäß und wie erwartet funktioniert. Wenn in der Konfiguration Variablen verwendet werden, müssen Sie möglicherweise einen Standardwert angeben, der zu Testzwecken verwendet werden soll (siehe Variablen).

• Speichern: Klicken Sie hier, um die Konfiguration der Email Benachrichtigung zu speichern und zu schließen.

• Änderungen verwerfen Klicken Sie nach dem Vornehmen von Änderungen auf, um die Konfiguration zu schließen, ohne die Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Einem Operation oder Script eine Email Benachrichtigung hinzufügen

Das Senden einer Email Benachrichtigung kann einer Operation als Aktion hinzugefügt werden, die bei Erfolg oder Misserfolg der Operation ausgeführt wird, oder es kann einem Script hinzugefügt werden, das mit erweiterter Logik ausgeführt wird, um festzulegen, wann die Email gesendet werden soll. Dies wird entweder in den Operation oder innerhalb eines Script konfiguriert.

Operationseinstellungen

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

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

Eine ausführlichere Erläuterung der Optionen finden Sie unter Operationsaktionen.

Verknüpfte Email Benachrichtigungen werden direkt auf der Design-Canvas angezeigt und sind mit dem Operation verknüpft, dem sie zugeordnet sind:

Script

Öffnen Sie in einem in Jitterbit Script geschriebenen Script die Tab Benachrichtigungen der Skriptkomponentenpalette.

Um eine Benachrichtigung und die zu ihrer Ausführung erforderliche Funktion hinzuzufügen, verwenden Sie die SendEmailMessage Funktion und die Benachrichtigungsreferenz als Funktionsargument. Weitere Einzelheiten finden Sie unter Benachrichtigungen in Jitterbit Script.