EmailOutput-Knoten

Mit dem EmailOutput-Knoten werden E-Mail-Nachrichten an einen oder mehrere Empfänger gesendet.

Dieses Thema enthält folgende Abschnitte:

Zweck

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:

Symbol für EmailOutput-Knoten

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.

EmailOutput-Knoten konfigurieren

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.

Die vier Konfigurationsstufen des EmailOutput-Knotens werden im Folgenden beschrieben:
  • Option 1: Konfigurieren Sie den EmailOutput-Knoten unter Verwendung der Knoteneigenschaften im Message Broker Toolkit, um eine E-Mail mit einem statisch definierten Betreff und Text an eine statisch definierte Liste mit Empfängern zu senden. Dieselbe E-Mail wird ohne Anhänge an diese Empfänger gesendet. Diese Methode ist hilfreich, wenn Sie den EmailOutput-Knoten testen möchten, oder wenn die bloße Benachrichtigung genügt.
  • Option 2: Diese Option ist mit Option 1 identisch. Der einzige Unterschied ist, dass ein Anhang hinzugefügt wird. Bei Verwendung dieser Option wird die E-Mail-Nachricht als MIME-Nachricht erstellt. Der Betreff, der Text und die Liste der Empfänger sind statisch, der Inhalt des Anhangs wird jedoch dynamisch von der Nachricht abgerufen, die zur Ausführungszeit an den EmailOutput-Knoten übergeben wird. Die Position des Anhangs in der Nachricht ist statisch definiert.
  • Option 3: Bei Verwendung dieser Option sind die Eigenschaften in den Optionen 1 und 2 optional und können zur Ausführungszeit mit Werten, die in der lokalen Umgebung (LocalEnvironment), dem Ausgabeheader der E-Mail (EmailOutputHeader) oder im Nachrichtenhauptteil angegeben werden, überschrieben werden. Mit dieser Option kann eine dynamische E-Mail-Nachricht erstellt werden, wobei der SMTP-Server, die Liste der Empfänger, der Betreff, der Text und die Anhänge zur Ausführungszeit festgelegt werden. Für diese Option sind vorgeschaltete Knoten zur Generierung dieser Überschreibungen erforderlich. Wenn in den Knoteneigenschaften kein Textwert für den Textkörper der E-Mail angegeben ist, wird der Hauptteil der Nachricht verwendet, der an den EmailOutput-Knoten übergeben wird.
  • Option 4: Bei Verwendung dieser Option wird eine MIME-Nachricht an den EmailOutput-Knoten übergeben. Der EmailOutput-Knoten verwendet den MIME-Parser, um die MIME-Nachricht in einen Bitstrom zu schreiben. Diese Nachricht wird dann an die Liste der Empfänger im SMTP-Header weitergeleitet. Über 'LocalEnvironment' angegebene Überschreibungen werden nicht berücksichtigt, wenn eine MIME-Nachricht übergeben wird.

Ausgabeheader der E-Mail

Der Ausgabeheader der E-Mail (EmailOutputHeader) ist ein untergeordnetes Element des Stammverzeichnisses. Alle Werte, die Sie in diesem Header angeben, überschreiben die für den Knoten festgelegten Eigenschaften. Verwenden Sie den SMTP-Ausgabeheader, um E-Mail-Attribute wie beispielsweise die Empfänger anzugeben.
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

Verwenden Sie 'LocalEnvironment', um Überschreibungen für die Verbindungsinformationen und Anhänge auf dem SMTP-Server anzugeben.
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.
  • Wenn das Element ein BLOB ist, handelt es sich um einen Anhang.
  • Handelt es sich beim dem Element um Text, prüfen Sie, ob es in ein anderes Element in der Nachrichtenbaumstruktur bzw. der lokalen Umgebung aufgelöst werden kann. Wenn es aufgelöst werden kann, verwenden Sie dieses Element. Kann es nicht aufgelöst werden, fügen Sie dieses Element als Anhang hinzu.
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'.
  • '7bit' ist der Standardwert, der für ASCII-Text verwendet wird.
  • 'Base64' wird für nicht-ASCII-Text verwendet, sei es für nicht-englischsprachigen Text oder binäre Daten. Dieses Format kann schwer zu lesen sein.
  • 'Quoted-printable' ist eine Alternative zu 'Base64' und kann verwendet werden, wenn es sich bei den Daten größtenteils um ASCII-Daten mit einigen nicht-ASCII-Anteilen handelt. Das Format ist besser lesbar; es bietet eine kompaktere Codierung, da die ASCII-Anteile nicht codiert sind.

Brokereigenschaften

Außerdem können Sie den SMTP-Server, die Portnummer und die Sicherheitsidentität als Eigenschaft der externen Brokerressource definieren. Verwenden Sie hierzu einen Aliasnamen, der in der Eigenschaft SMTPServer auf dem EmailOutput-Knoten angegeben ist. Die Sicherheitsidentität verweist auf ein Benutzer-ID/Kennwort-Paar, das auf dem Broker mit dem Befehl mqsisetdbparms definiert wird. Verwenden Sie den Befehl mqsicreateconfigurableservice, um für eine externe SMTP-Brokerressource für den auf dem Knoten angegebenen Alias zu erstellen. Verwenden Sie anschließend den Befehl mqsichangeproperties, um die Eigenschaft 'SMTPServer' mit dem Wert im Format server:port zu erstellen. Die Angabe des Ports ist optional; ist er nicht angegeben, wird standardmäßig Port 25 verwendet. Sie können auch den Befehl mqsichangeproperties verwenden, um die Eigenschaft 'SMTPSecurityIdentity' mit einem Wert zu erstellen, der dem Namen der Sicherheitsidentität entspricht und zur Ausführungszeit in eine Benutzer-ID und ein Kennwort zur Authentifizierung beim SMTP-Server aufgelöst werden kann. Beispiel:
mqsicreateconfigurableservice MY_BROKER –c SMTP –o SMTP_MyAlias  
gefolgt von:
 mqsichangeproperties MY_BROKER –c SMTP –o SMTP_MyAlias –n SMTPServer –v smtp.hursley.ibm.com:25 
Diese 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 mySecurityIdentity  
Sie müssen auch den Befehlmqsisetdbparms verwenden, um die Sicherheitsidentität zur Ausführungszeit des Brokers zu definieren.

Verbindungen zu Terminals herstellen

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.

Wenn Sie eines dieser Ausgabeterminals mit einem anderen Knoten im Nachrichtenfluss verbinden, wird die mit der Nachricht verknüpfte lokale Umgebung (LocalEnvironment) mit folgenden Informationen zu jeder Zieladresse ergänzt, an die die Nachricht von diesem Knoten gesendet wurde:
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.

Terminals und Eigenschaften

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:
  • Keines
  • text/plain
  • text/html
  • text/xml

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:
  • text/plain bedeutet einfacher Text.
  • text/html bedeutet HTML.
  • text/xml bedeutet XML.
  • application/octet-stream ist der Standardtyp für nicht-Text und HTML (binäre Daten).
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:
  • 7bit ist der Standardwert für ASCII-Text.
  • base64 wird für nicht-ASCII-Daten verwendet, egal ob es sich um nicht-englischsprachige oder binäre Daten handelt.
  • quoted-printable ist eine Alternative zu base64, die besser zu lesen ist. Verwenden Sie 'quoted-printable', wenn es sich bei den Daten größtenteils um ASCII-Daten mit einigen nicht-ASCII-Anteilen handelt. Das Format bietet eine kompaktere Codierung, da die ASCII-Anteile nicht codiert sind.
MultipartContentType Nein Nein Mixed Der Typ der mehrteiligen Nachricht. Gültige Werte sind:
  • Mixed: Jeder Teil des MIME-Hauptteils ist unabhängig von den anderen.
  • Alternative: Jeder Teil des MIME-Hauptteils stellt eine Alternative der anderen dar.
  • Related: Alle Teile des MIME-Hauptteils sollten nur im Datenverbund berücksichtigt werden.

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.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac37400_