Validate-Knoten

Mit dem Validatesknoten können Sie überprüfen, ob die Nachricht, die im Eingabeterminal des Knotens empfangen wird, erwartungsgemäß ist. Sie können überprüfen, ob die Nachricht die erwarteten Nachrichtenschabloneneigenschaften (Nachrichtendomäne, Nachrichtengruppe und Nachrichtentyp) aufweist und ob der Inhalt der Nachricht korrekt ist, indem Sie die Nachrichtenvalidierung auswählen.

Dieses Thema enthält folgende Abschnitte:

Zweck

Die Überprüfungen, die Sie ausführen können, hängen von der Domäne der Nachricht ab.
Prüfen Domäne
Nachrichtendomäne überprüfen Alle Domänen
Nachrichtengruppe überprüfen Nur MRM und IDOC
Nachrichtenart überprüfen Nur MRM
Nachrichtentext auswerten Nur XMLNSC, MRM und IDOC

Sie können die Nachricht auf eine oder mehrere der Eigenschaften Nachrichtendomäne, Nachrichtengruppe oder Nachrichtentyp überprüfen. Die Eigenschaft wird nur überprüft, wenn Sie das entsprechende Kontrollkästchen aktivieren, d. h. dass eine Eigenschaft mit einer leeren Zeichenfolge überprüft werden kann.

Sie können den Inhalt einer Nachricht überprüfen, indem Sie der Eigenschaft Auswerten einen Wert zuordnen. Die Auswertung wird ausgeführt, wenn die Eigenschaft Auswerten auf einen anderen Wert als den Standardwert Keine gesetzt wird.

Damit Auswertungsfehler vom Parser an den Validate-Knoten zurückgegeben werden, muss die Eigenschaft Aktion bei Fehler entweder auf Ausnahme oder Ausnahmeliste gesetzt werden. Andernfalls werden Auswertungsfehler einfach nur protokolliert.

Wenn alle angegebenen Überprüfungen positiv ausfallen, wird die Nachricht an das Trefferterminal des Knotens weitergegeben.

Wenn eine der Überprüfungen fehlschlägt, wird die Nachricht an das Fehlerterminal weitergegeben. Wenn das Fehlerterminal an keine Fehlerhandhabungsverarbeitungen angeschlossen ist, wird eine Ausnahmebedingung generiert.

Der Validate-Knoten ersetzt den Check-Knoten und wird ab WebSphere Message Broker Version 6.0 nicht weiter unterstützt. Der Validate-Knoten funktioniert wie der Check-Knoten, besitzt aber zusätzliche Validierungseigenschaften, die eine Auswertung des Nachrichteninhalts durch Parser ermöglichen, die diese Funktion unterstützen.

Der Validate-Knoten befindet sich im Ablagefach Auswertung der Palette und wird in der Workbench durch folgendes Symbol dargestellt:

Symbol für Validate-Knoten

Diesen Knoten in einem Nachrichtenfluss verwenden

Mithilfe des Validate-Knotens können Sie sicherstellen, dass eine Nachricht über die richtigen Nachrichtenschabloneneigenschaften und einen gültigen Inhalt verfügt, bevor die Nachricht an den weiteren Nachrichtenfluss übergeben wird. Nachfolgende Knoten können sich dann darauf verlassen, dass die Nachricht korrekt ist, und müssen keine eigenen Fehlerprüfungen durchführen.

Mit dem Validate-Knoten können Sie außerdem sicherstellen, dass die Nachricht richtig durch den Nachrichtenfluss geleitet wird. Konfigurieren Sie ihn beispielsweise so, dass eine Nachricht, mit der Warenkäufe angefordert werden, über eine andere Route geleitet wird als diejenige, die für eine Nachricht, die einen Warenverkauf anfordert, erforderlich ist.

Ein weiteres Beispiel für die Weiterleitung ist der Empfang von elektronischen Nachrichten von Mitarbeitern der Zentrale. Diese Nachrichten dienen mehreren Zwecken, z. B. der Bitte um technischen Support, der Anforderung von Büromaterial oder der Mitteilung von Informationen zu neuen potenziellen Kunden. Diese Nachrichten können automatisch verarbeitet werden, da die Mitarbeiter ein Standardformular ausfüllen. Wenn diese Nachrichten getrennt von den anderen empfangenen Nachrichten verarbeitet werden sollen, stellen Sie mithilfe des Validate-Knotens sicher, dass nur Nachrichten von Mitarbeitern mit einem bestimmten Nachrichtentyp von diesem Nachrichtenfluss verarbeitet werden.

Terminals und Eigenschaften

Wenn Sie eine Instanz des Validate-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. Klicken Sie zum Anzeigen der Knoteneigenschaften im Eigenschaftendialog entweder doppelt auf den Knoten, oder klicken Sie mit der rechten Maustaste und anschließend auf Eigenschaften. Alle verbindlichen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Sternchen gekennzeichnet.

In der folgenden Tabelle werden die Terminals des Validate-Knotens beschrieben.

Terminal Beschreibung
Eingangsterminal Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt.
Fehlerterminal Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn die eingehende Nachricht nicht den angegebenen Eigenschaften entspricht.
Treffer Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn die eingehende Nachricht den angegebenen Eigenschaften entspricht.

In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte O zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte K 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 Validate-Knotens beschrieben.

Eigenschaft O K Standardwert Beschreibung
Knotenname Nein Nein Validate 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 Validate-Knotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Domäne Nein Nein   Der Name der Domäne. Wählen Sie in der Liste der Eigenschaft Domäne einen der folgenden Werte aus:
  • MRM
  • XMLNSC
  • XMLNS
  • JMSMap
  • JMSStream
  • MIME
  • BLOB
  • XML
  • IDOC
Domäne überprüfen Ja Nein Gelöscht Wenn Sie dieses Kontrollkästchen aktivieren, wird die Eigenschaft Domäne der eingehenden Nachricht überprüft.
Nachrichtengruppe Nein Nein   Der Name oder die ID der Nachrichtengruppe, zu der die eingehende Nachricht gehört. Wenn Sie den MRM- oder IDOC-Parser verwenden und überprüfen möchten, üb die eingehende Nachricht einer bestimmten Nachrichtengruppe angehört, aktivieren Sie Nachrichtengruppe überprüfen, und wählen Sie einen der Werte aus der Liste Nachrichtengruppe aus. Diese Liste wird nur gefüllt, wenn Sie MRM oder IDOC als Nachrichtendomäne auswählen.

Lassen Sie Set (Gruppe) für die anderen Parser frei.

Nachrichtengruppe überprüfen Ja Nein Gelöscht Wenn Sie das Kontrollkästchen aktivieren, wird die Eigenschaft Nachrichtengruppe der eingehenden Nachricht überprüft. Wenn Sie den MRM- oder IDOC-Parser verwenden und überprüfen möchten, üb die eingehende Nachricht einer bestimmten Nachrichtengruppe angehört, aktivieren Sie Nachrichtengruppe überprüfen, und wählen Sie einen der Werte aus der Liste Nachrichtengruppe aus.
Typ Nein Nein   Der Nachrichtenname. Wenn Sie den MRM-Parser verwenden und überprüfen möchten, ob die eingehende Nachricht eine bestimmte Nachrichtenart aufweist, aktivieren Sie Nachrichtenart überprüfen, und geben Sie den Namen der Nachricht für die Eigenschaft Nachrichtenart ein.

Lassen Sie Type (Typ) für die anderen Parser frei.

Nachrichtenart überprüfen Ja Nein Gelöscht Wenn Sie das Kontrollkästchen aktivieren, wird die Eigenschaft Typ der eingehenden Nachricht überprüft. Wenn Sie den MRM-Parser verwenden und überprüfen möchten, ob die eingehende Nachricht eine bestimmte Nachrichtenart aufweist, aktivieren Sie Nachrichtenart überprüfen, und geben Sie den Namen der Nachricht für die Eigenschaft Nachrichtenart ein.

In der folgenden Tabelle werden die Auswertungseigenschaften des Validate-Knotens beschrieben.

Wenn Sie den MRM- oder IDOC-Parser verwenden und den Nachrichtentext anhand der Nachrichtengruppe auswerten möchten, wählen Sie die gewünschten Auswertungseigenschaften auf der Registerkarte Auswertung aus. Sie finden weitere Informationen hierzu in den Abschnitten Nachrichten überprüfen und Auswertungseigenschaften.

Eigenschaft O K Standardwert Beschreibung
Auswerten Nein Ja Keines Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind Keine, Inhalt und Wert, Inhalt und Übernehmen.
Aktion bei Fehler Nein 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.
Alle Wertvorgaben einschließen Ja Nein Ausgewählt Diese Eigenschaft kann nicht bearbeitet werden. Bei der Auswertung von Inhalt und Wert werden Basisprüfungen der Wertvorgaben durchgeführt.
Korrektur Ja Nein Keines Gültige Werte sind Keine und Vollständig.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Letzte Aktualisierung : 2009-02-17 15:28:24

ac20803_