Validieren -Knoten

Überprüfen Sie mithilfe des Validieren -Knotens, ob die Nachricht, die an seinem Eingabeterminal ankommt, wie erwartet ist. Sie können überprüfen, ob die Nachricht die erwarteten Nachrichtenvorlageneigenschaften aufweist und ob der Inhalt der Nachricht korrekt ist, indem Sie die Nachrichtenvalidierung auswählen.

Der Validieren -Knoten ist in den folgenden Betriebsmodi verfügbar:
  • Developer
  • Application Integration Suite
  • Standard
  • Advanced
  • Express
  • Scale
Weitere Informationen finden Sie unter Operationsmodi.

Diese Thema enthält folgende Abschnitte:

Zweck

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

Sie können die Nachricht auf eine oder mehrere der Eigenschaften Nachrichtendomäne, Nachrichtenmodell oder Nachricht ü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 Validieren einen Wert zuordnen. Die Validierung wird ausgeführt, wenn die Eigenschaft Validieren auf einen anderen Wert als den Standardwert Keine gesetzt wird.

Wenn Validierungsfehler vom Parser an den Validieren -Knoten zurückgegeben werden sollen, setzen Sie die Eigenschaft Fehleraktion auf Ausnahme oder Ausnahmeliste. Andernfalls werden Validierungsfehler einfach nur protokolliert.

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

Wenn eine der Überprüfungen fehlschlägt, wird die Nachricht an das Failure-Terminal weitergegeben. Wenn dem Failure-Terminal keine Fehlerbehandlungsverarbeitungen zugeordnet ist, wird eine Ausnahme generiert.

Der Knoten Validieren ersetzt den Knoten Prüfen , der veraltet ist. Der Validieren -Knoten funktioniert auf dieselbe Weise wie der Prüfen -Knoten, verfügt jedoch über zusätzliche Validierungseigenschaften, um die Validierung von Nachrichteninhalten durch Parser zu ermöglichen, die diese Funktion unterstützen.

Der Knoten Validieren ist im Ablagefach Validierung der Palette enthalten und wird in IBM® Integration-Toolkit durch das folgende Symbol dargestellt:

Symbol für Validierungsknoten

Verwendung dieses Knotens in einem Nachrichtenfluss

Verwenden Sie den Validieren -Knoten, um sicherzustellen, dass eine Nachricht die richtigen Nachrichtenvorlageneigenschaften und gültigen Inhalt hat, bevor Sie die Nachricht an den Rest des Nachrichtenflusses weitergeben. Nachfolgende Knoten können sich dann darauf verlassen, dass die Nachricht korrekt ist, und müssen keine eigenen Fehlerprüfungen durchführen.

Mit dem Validieren -Knoten können Sie außerdem sicherstellen, dass die Nachricht ordnungsgemäß 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 anderen empfangenen Nachrichten verarbeitet werden sollen, verwenden Sie den Validieren -Knoten, um sicherzustellen, dass nur Mitarbeiternachrichten mit einem bestimmten Nachrichtentyp von diesem Nachrichtenfluss verarbeitet werden.

Terminals und Eigenschaften

Nachdem Sie eine Instanz des Validieren -Knotens in einen Nachrichtenfluss eingereiht haben, kann dieser konfiguriert werden. Weitere Informationen finden Sie unter Nachrichtenflussknoten konfigurieren. Die Eigenschaften des Knotens werden in der Ansicht 'Eigenschaften' angezeigt. Alle obligatorischen 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 Validieren -Knotens beschrieben.

Terminal Beschreibung
In Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt.
Fehler Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn die eingehende Nachricht nicht den angegebenen Eigenschaften entspricht.
Match 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 zu implementieren).

In der folgenden Tabelle werden die Beschreibungseigenschaften des Validieren -Knotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Knotenname Nein Nein Validieren Der Name des Knotens.
Kurzbeschreibung Nein Nein   Eine Kurzbeschreibung des Knotens.
Ausführliche Beschreibung Nein Nein   Der Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt.

In der folgenden Tabelle werden die Basiseigenschaften des Validieren -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:
  • XMLNSC
  • DFDL
  • SOAP
  • DataObject
  • XMLNS
  • JMSMap
  • JMSStream
  • MIME
  • MRM
  • BLOB

Sie können bei Bedarf auch einen benutzerdefinierten Parser angeben.
Domäne überprüfen Ja Nein Abgewählt Wenn Sie dieses Kontrollkästchen aktivieren, wird die Eigenschaft Domäne der eingehenden Nachricht überprüft.
Nachrichtenmodell Nein Nein   Der Name oder die ID der Nachrichtenmodellschemadatei, zu der die eingehende Nachricht gehört. Wenn Sie den XMLNSC-, DFDL, DataObject-, SOAP-, MRM- oder IDOC-Parser verwenden und überprüfen möchten, ob die eingehende Nachricht einem bestimmten Nachrichtenmodell angehört, aktivieren Sie Nachrichtenmodell überprüfen und wählen Sie einen der Werte aus der Liste Nachrichtenmodell aus. Diese Liste wird gefüllt, wenn Sie XMLNSC, DFDL, DataObject, SOAP, MRM oder IDOC als Nachrichtendomäne auswählen.

Lassen Sie Nachrichtenmodell für die anderen Parser frei.

Wenn Sie diese Eigenschaft festlegen und anschließend die Projektabhängigkeiten aktualisieren, um diesen Nachrichtenmodellverweis zu entfernen, wird eine Warnmeldung ausgegeben. Aktualisieren Sie entweder die Eigenschaft Nachrichtenmodell oder stellen Sie den Verweis auf diese Nachrichtenmodellschemadatei wieder her.
Nachrichtenmodell überprüfen Ja Nein Abgewählt Wenn Sie das Kontrollkästchen aktivieren, wird die Eigenschaft Nachrichtenmodell der eingehenden Nachricht überprüft. Wenn Sie den XMLNSC-, DFDL-, DataObject-, SOAP-, MRM- oder IDOC-Parser verwenden und überprüfen möchten, ob die eingehende Nachricht zu einem bestimmten Nachrichtenmodell gehört, aktivieren Sie Nachrichtenmodell überprüfen und wählen Sie einen der Werte aus der Liste Nachrichtenmodell aus.
Nachricht Nein Nein   Der Nachrichtenname. Wenn Sie den DFDL- oder MRM-Parser verwenden und überprüfen möchten, ob die eingehende Nachricht einen bestimmten Nachrichtentyp hat, aktivieren Sie Nachricht überprüfen und geben Sie den Namen der Nachricht in der Eigenschaft Nachricht ein.

Lassen Sie Nachricht für die anderen Parser leer.
Nachricht überprüfen Ja Nein Abgewählt Wenn Sie das Kontrollkästchen aktivieren, wird die Eigenschaft Nachricht der eingehenden Nachricht überprüft. Wenn Sie den MRM-Parser verwenden und überprüfen möchten, ob die eingehende Nachricht einen bestimmten Nachrichtentyp hat, aktivieren Sie Nachricht überprüfen und geben Sie den Namen der Nachricht in der Eigenschaft Nachricht ein.

In der folgenden Tabelle werden die Validierungseigenschaften für den Validieren -Knoten beschrieben.

Wenn Sie den XMLNSC-, DFDL-, DataObject-, SOAP-, MRM- oder IDOC-Parser verwenden und den Text von Nachrichten anhand des Nachrichtenmodells überprüfen möchten, wählen Sie auf der Registerkarte Validierung die erforderlichen Validierungseigenschaften aus. Weitere Details finden Sie unter Nachrichten validieren und Validierungseigenschaften.

Eigenschaft M C Standardwert Beschreibung Befehlseigenschaft Befehl 'mqsiapplybaroverride'
Validieren Nein Ja Ohne Durch diese Eigenschaft wird gesteuert, ob eine Validierung stattfindet. Gültige Werte sind Ohne, Inhalt und Wert, Inhalt und Übernehmen. validateMaster
Aktion bei Fehler Nein Nein Ausnahme Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Validierung geschieht. Diese Eigenschaft kann nur angegeben werden, wenn Validieren auf Inhalt oder Inhalt und Wert gesetzt ist. Gültige Werte sind Benutzertrace, Lokales Fehlerprotokoll, Ausnahme und Ausnahmeliste.  
Die Überwachungseigenschaften des Knotens werden in der folgenden Tabelle beschrieben.
Eigenschaft M C Standardwert Beschreibung
Ereignisse Nein Nein -- Auf dieser Registerkarte werden Ereignisse angezeigt, die Sie für den Knoten definiert haben. Standardmäßig sind für keinen Knoten in einem Nachrichtenfluss Überwachungsereignisse definiert. Verwenden Sie Hinzufügen, Bearbeitenund Löschen , um Überwachungsereignisse für den Knoten zu erstellen, zu ändern oder zu löschen. Weitere Informationen finden Sie unter Überwachungsereignisquellen mithilfe von Überwachungseigenschaften konfigurieren .

Sie können hier angezeigte Ereignisse aktivieren oder inaktivieren, indem Sie das Kontrollkästchen Aktiviert aktivieren oder inaktivieren.