Mit dem EmailOutput-Knoten werden E-Mail-Nachrichten an einen oder mehrere Empfänger gesendet.
Dieses Thema enthält folgende Abschnitte:
Der EmailOutput-Knoten übergibt eine E-Mail-Nachricht aus einem Nachrichtenfluss an den von Ihnen angegebenen SMTP-Server.
Sie können den EmailOutput-Knoten über die Knoteneigenschaften im Message Broker Toolkit konfigurieren oder eine dynamische Konfiguration über die Header 'LocalEnvironment' und 'EmailOutputHeader', die der Nachricht zugeordnet sind, durchführen.
Der EmailOutput-Knoten befindet sich im Ablagefach Email (E-Mail) der Nachrichtenflussknotenpalette und wird in Workbench durch folgendes Symbol dargestellt:

Anhand des Beispielprogramms Beispielprogramm 'E-Mail' wird die Verwendung dieses Knotens deutlich. Sie können Beispiele nur anzeigen, wenn Sie das Information Center verwenden, das im Message Broker Toolkit integriert ist.
Wenn Sie eine Instanz des EmailOutput-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren. Der Abschnitt Nachrichtenflussknoten konfigurieren enthält weitere Informationen hierzu. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt.
Alle verbindlichen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Sternchen gekennzeichnet.
| Standort | Beschreibung |
|---|---|
| Root.EmailOutputHeader.To | Eine durch Kommas getrennte Liste mit E-Mail-Adressen. |
| Root.EmailOutputHeader.Cc | Eine durch Kommas getrennte Liste mit E-Mail-Adressen. |
| Root.EmailOutputHeader.Bcc | Eine durch Kommas getrennte Liste mit E-Mail-Adressen. |
| Root.EmailOutputHeader.From | Eine durch Kommas getrennte Liste mit E-Mail-Adressen. |
| Root.EmailOutputHeader.Reply-To | Eine durch Kommas getrennte Liste mit E-Mail-Adressen. |
| Root.EmailOutputHeader.Subject | Der Betreff der E-Mail. |
| Lokale Umgebung | Beschreibung |
|---|---|
| Destination.Email.SMTPServer | Der Server: Port-Wert des SMTP-Servers. Der Port ist optional; ist er nicht angegeben, wird standardmäßig 25 verwendet. |
| Destination.Email.SecurityIdentity | Die Sicherheitsidentität für die Authentifizierung gegenüber dem SMTP-Server. Dies kann der Name des Paars 'Benutzer-ID/Kennwort' sein, welches unter Verwendung des Befehls mqsisetdbparms definiert ist. Es kann auch Bezug auf eine externe Ressource mit einem Attribut 'SecurityIdentity' genommen werden, das auf eine Benutzer-ID und ein Kennwort verweist, die unter Verwendung des Befehls mqsisetdbparms definiert sind. In beiden Fällen wird der Wert an die Zeichenfolge “smtp::” angehängt. Wenn Sie beispielsweise mit Hilfe des Befehls mqsisetdbparms eine Benutzer-ID und ein Kennwort smtp::myUseridPassword erstellen, lautet die an dem Knoten oder indirekt in einer externen Ressource angegebene Sicherheitsidentität (securityIdentity)myUseridPassword. |
| Destination.Email.BodyContentType | Gibt an, dass im Hauptteil der E-Mail-Nachricht HTML und kein einfacher Text verwendet wird. Sie können für diese Eigenschaft 'text/plain', 'text/html' oder 'text/xml' angeben; der Standardwert ist 'text/plain'. |
| Destination.Email.MultiPartContentType | Der mehrteilige Typ, einschließlich 'related', 'mixed' und 'alternative'. Sie können jeden beliebigen Wert angeben. |
| Destination.Email.Attachment.Content | Entweder der Anhang selbst (BLOB/Text) oder ein XPath- oder ESQL-Ausdruck, der auf ein Element verweist; z. B. ein Element in der Nachrichtenbaumstruktur oder in der lokalen Umgebung. Der Wert des Referenzelements wird als Inhalt des Anhangs verwendet.
|
| Destination.Email.Attachment.ContentType | Der Typ des Anhangs (wird auch als Internet Media Type bezeichnet). Dazu gehören 'text/plain', 'text/html' und 'text/xml'. Sie können jeden beliebigen Wert angeben. |
| Destination.Email.Attachment.ContentName | Der Name des Anhangs. |
| Destination.Email.Attachment.ContentEncoding | Die Codierung des Anhangs: '7bit', 'base64' oder 'quoted-printable'.
|
mqsicreateconfigurableservice MY_BROKER –c SMTP –o SMTP_MyAliasgefolgt von:
mqsichangeproperties MY_BROKER –c SMTP –o SMTP_MyAlias –n SMTPServer –v smtp.hursley.ibm.com:25Diese Befehle überschreiben die Werte für den SMTP-Server und den -Port, die auf Knoten angegeben sind, die auch den Alias SMTP_MyAlias angeben. Wenn die 'LocalEnvironment' Überschreibungen enthält, haben diese Vorrang vor den externen Ressourceneigenschaften des Brokers. Betrachten Sie auch das folgende Beispiel:
mqsichangeproperties MY_BROKER –c SMTP –o SMTP_MyAlias –n SMTPSecurityIdentity –v mySecurityIdentitySie müssen auch den Befehlmqsisetdbparms verwenden, um die Sicherheitsidentität zur Ausführungszeit des Brokers zu definieren.
Verbinden Sie das Eingangsterminal mit dem Knoten, von dem abgehende Nachrichten weitergeleitet werden.
Schließen Sie das Ausgabe- oder Fehlerterminal dieses Knotens an einen anderen Knoten in diesem Nachrichtenfluss an, um die Nachricht weiterzuverarbeiten, Fehler zu behandeln oder die Nachricht an eine weitere Zieladresse zu senden.
| Standort | Beschreibung |
|---|---|
| WrittenDestinationEmail.smtpServer | Der Server:Port des SMTP-Servers. |
| WrittenDestinationEmail.messageId | Die ID der als E-Mail gesendeten Nachricht. |
Diese Werte werden in der LocalEnvironment-Baumstruktur in die WrittenDestination-Unterverzeichnisstruktur geschrieben.
Wenn Sie kein Terminal anschließen, bleibt die LocalEnvironment-Verzeichnisstruktur unverändert.
In der folgenden Tabelle werden die Terminals des EmailOutput-Knotens beschrieben.
| Terminal | Beschreibung |
|---|---|
| Eingangsterminal | Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt. |
| Fehlerterminal | Das Ausgabeterminal, an das die Nachricht gesendet wird, wenn ein Fehler beim Einreihen der Nachricht in die Ausgabewarteschlange festgestellt wird |
| Ausgang | Das Ausgabeterminal, an das die Nachricht gesendet wird, wenn sie erfolgreich in die Ausgabewarteschlange gestellt wurde und falls in diesem Nachrichtenfluss eine weitere Verarbeitung erforderlich ist |
In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte M zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte C zeigt an, ob die Eigenschaft konfigurierbar ist (Wert kann geändert werden, wenn der Nachrichtenfluss zur BAR-Datei hinzugefügt wird, um ihn einzusetzen).
In der folgenden Tabelle werden die Beschreibungseigenschaften des EmailOutput-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Knotenname | Nein | Nein | Der Knotentyp, EmailOutput | Der Name des Knotens. |
| Kurzbeschreibung | Nein | Nein | Kurze Beschreibung des Knotens. | |
| Ausführliche Beschreibung | Nein | Nein | Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt. |
In der folgenden Tabelle werden die grundlegenden Eigenschaften des EmailOutput-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| server | Nein | Ja | Diese Eigenschaft definiert den SMTP-Server und den Port, an den E-Mails von diesem Knoten aus gesendet werden. Das Format lautet Server:Port; z. B. Mein_SMTP-Server:25. Die Angabe des Ports ist optional, ist er nicht angegeben, wird standardmäßig Port 25 verwendet. Sie können für diese Eigenschaft einen Aliaswert eingeben. Wenn der Alias zur Ausführungszeit vorhanden ist, werden die angegebenen Werte verwendet. Wenn der Alias während der Ausführung nicht vorhanden ist, geht der Broker davon aus, dass es sich bei dem Wert um einen gültigen SMTP-Host handelt. |
In der folgenden Tabelle werden die E-Mail-Eigenschaften des EmailOutput-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| ToAddresses | Nein | Nein | Der bzw. die Hauptempfänger der E-Mail-Nachricht. Für diese Eigenschaft kann eine einzelne E-Mail-Adresse oder eine durch Kommas getrennte Liste mit E-Mail-Adressen angegeben werden. | |
| CcAddresses | Nein | Nein | Der bzw. die Empfänger einer Kopie der E-Mail-Nachricht. Für diese Eigenschaft kann eine einzelne E-Mail-Adresse oder eine durch Kommas getrennte Liste mit E-Mail-Adressen angegeben werden. | |
| BccAddresses | Nein | Nein | Der bzw. die Empfänger einer Blindkopie der E-Mail-Nachricht. Für diese Eigenschaft kann eine einzelne E-Mail-Adresse oder eine durch Kommas getrennte Liste mit E-Mail-Adressen angegeben werden. | |
| FromAddress | Nein | Nein | Die E-Mail-Adresse des Absenders der E-Mail. | |
| Reply-ToAddress | Nein | Nein | Die E-Mail-Adresse für die Anwort der Empfänger auf die E-Mail. | |
| Subject | Nein | Nein | Der Betreff der E-Mail. | |
| MessageText | Nein | Nein | Der Haupttext der E-Mail. Wenn Sie keinen Wert für die Eigenschaft MessageText angeben, wird als Text der E-Mail der Hauptteil der Nachrichtenbaumstruktur verwendet, der an den EmailOutput-Knoten übergeben wird. | |
| BodyContentType | Nein | Nein | text/plain | Mit dieser Eigenschaft können Sie den Inhaltstyp für den Hauptteil der E-Mail-Nachricht erzwingen. Gültige Werte sind:
|
In der folgenden Tabelle werden die Sicherheitseigenschaften des EmailOutput-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| securityIdentity | Nein | Ja | Eine Sicherheits-ID zum Abrufen einer Benutzer-ID und eines Kennworts, die zur Ausführungszeit des Brokers konfiguriert werden. |
In der folgenden Tabelle werden die Anlageeigenschaften des EmailOutput-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| AttachmentContent | Nein | Nein | Ein XPath- oder ESQL-Ausdruck, der auf ein Element verweist; z. B. ein Element in der Nachrichtenbaumstruktur oder LocalEnvironment. Der Inhalt des Anhangs ist der Wert des Elements, auf das verwiesen wird. | |
| AttachmentContentName | Nein | Nein | Der Name des Anhangs, der dem Empfänger der E-Mail angezeigt wird. Die Angabe dieser Eigenschaft ist optional. Wenn Sie keinen Namen angeben, wird ein Standardname zugewiesen. | |
| AttachmentContentType | Nein | Nein | text/plain | Der Typ des Anhangs. Die Angabe dieser Eigenschaft ist optional, auch wenn Sie einen Anhang angegeben haben. Gültige Werte sind:
|
| AttachmentContentEncoding | Nein | Nein | 7bit | Die Codierung des Anhangs. Die Angabe dieser Eigenschaft ist optional.
Wenn Sie keine Codierung angeben, wird eine Standardcodierung zugewiesen. Gültige Werte sind:
|
| MultipartContentType | Nein | Nein | Mixed | Der Typ der mehrteiligen Nachricht. Gültige Werte sind:
|
In der folgenden Tabelle werden die Eigenschaften für die Validierung des EmailOutput-Knotens beschrieben.
Der Abschnitt Auswertungseigenschaften enthält eine ausführliche Beschreibung der Eigenschaften.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Auswertung | Ja | Ja | Übernehmen | Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind Keine, Inhalt und Wert, Inhalt und Übernehmen. |
| Aktion bei Fehler | Ja | Nein | Ausnahme | Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung geschieht. Sie können diese Eigenschaft nur angeben, wenn Sie Auswerten auf Inhalt oder Inhalt und Wert gesetzt haben. Gültige Werte sind Benutzertrace, Lokales Fehlerprotokoll, Ausnahmebedingung und Ausnahmeliste. |