Nachrichten überprüfen

Vorbereitungen:

Lesen Sie die Abschnitte über Nachrichtenflussknoten und Parser, insbesondere MRM-Parser und -Domäne und XMLNSC-Parser.

Der Broker stellt eine Überprüfung zur Verfügung, die auf einer Nachrichtengruppe für vordefinierte Nachrichten basiert. Die Überprüfung wird deshalb nur für Nachrichten ausgeführt, die Sie für den Broker modelliert und implementiert haben. Die Nachrichtendomänen, welche die Überprüfung unterstützen, sind MRM, XMLNSC, SOAP und IDOC.

Der Broker bietet keine Gültigkeitsprüfung für selbstdefinierende Nachrichten. Die MRM- und IDOC-Parser überprüfen vordefinierte Nachrichten in Bezug auf das Nachrichtenverzeichnis, das von einer Nachrichtengruppe generiert wurde. Die XMLNSC- und SOAP-Domäne überprüfen vordefinierte Nachrichten in Bezug auf XML-Schemata, die von einer Nachrichtengruppe generiert wurden.

Nachrichtenflüsse sind so gestaltet, dass sie Nachrichten, die bestimmte Regeln entsprechen, umwandeln und weiterleiten. Standardmäßig führen Parser für eine Nachricht Gültigkeitsprüfungen durch, aber nur, um die Integrität der Parsing-Operation sicherzustellen. Sie können eine Nachricht jedoch sorgfältiger durch das in der Nachrichtengruppe enthaltene Nachrichtenmodell prüfen, wenn Sie die Überprüfungsoptionen auf bestimmten Knoten in Ihrem Nachrichtenfluss ändern.

Sie können Überprüfungsoptionen zur Überprüfung der folgenden Nachrichten verwenden:

Diese Überprüfungsoptionen stellen sicher, dass die Daten, die im Nachrichtenfluss eingehen und ihn wieder verlassen, geprüft werden. Die Optionen bieten Ihnen einen gewissen Grad an Kontrolle über die Gültigkeitsprüfung und werden mit folgenden Zielen ausgeführt:

Sie können außerdem angeben, welche Aktion ausgeführt werden soll, wenn eine Überprüfung fehlschlägt.

Zur Überprüfung von Nachrichten müssen Sie durch eine Nachrichtenbaumstruktur navigieren und ihre Gültigkeit kontrollieren. Wenn die Eingabenachricht analysiert wird, ist dies eine Erweiterung der erstellten Baumstruktur, und wenn die Ausgabenachricht geschrieben wird, handelt es sich um eine Erweiterung des Bitstrom-Erstellung.

Überprüfungsoptionen sind auf den folgenden Knoten möglich:

Knotentyp Knoten mit Überprüfungsoptionen
Empfangsknoten MQInput, SCADAInput, HTTPInput, JMSInput, TimeoutNotification, SOAPInput, FileInput
Sendeknoten MQOutput, MQReply, SCADAOutput, HTTPReply, JMSOutput, JMSReply, FileOutput, SOAPReply
Weitere Knoten Compute, Zuordnung, JavaCompute, Validate, ResetContentDescriptor, MQGet, HTTPRequest, XSLTransform, DatabaseRetrieve, SOAPRequest, SOAPAsyncResponse

Überprüfungsoptionen können auch in der Anweisung ESQL CREATE und in der Funktion ASBITSTREAM angegeben werden.

Zur Überprüfung von Eingabenachrichten, die in einem Empfangsknoten empfangen wurden, können Sie im dort Überprüfungseigenschaften angeben. Die Eingabenachricht wird überprüft, wenn der Nachrichtenbitstrom für die Erstellung einer Nachrichtenbaumstruktur analysiert wird.

Mit der Eigenschaft 'Zeitpunkt für Syntaxanalyse' des Empfangsknoten können Sie steuern, ob die gesamte Nachricht zu diesem Zeitpunkt analysiert und geprüft wird, oder ob einzelne Felder in der Nachricht nur geprüft werden sollen, wenn auf sie verwiesen wird.

Zur Überprüfung von Ausgabenachrichten, die von einem Transformation-Knoten erstellt wurden, müssen Sie Überprüfungseigenschaften entweder im Knoten selbst oder im Sendeknoten angeben, durch den die Nachricht gesendet wird. Die Überprüfung wird ausgeführt, wenn der Nachrichtenbitstrom von der Nachrichtenbaumstruktur durch den Sendeknoten erstellt wird.

Alternativ dazu können Sie mit einem Validatesknoten eine Nachrichtenbaumstruktur an einer bestimmten Position in Ihrem Nachrichtenfluss überprüfen, oder Sie können dazu in einem Compute-, Filter- oder Datenbankknoten die Funktion ESQL ASBITSTREAM verwenden.

Einige wenige Überprüfungen werden standardmäßig ausgeführt, wenn Sie die Überprüfungsoptionen nicht ändern. Bei den Standardeinstellungen wird eine Ausnahmebedingung ausgelöst, wenn eine der folgenden Situationen eintritt:
  • Die Daten weichen ab, z. B. wenn der Parser die für den vorgegebenen Feldtyp gelieferten Daten nicht interpretieren kann.
  • Die Reihenfolge der Elemente in der Ausgabenachricht entspricht nicht der Reihenfolge in der logischen Nachrichtenbaumstruktur (nur bei MRM-, CWF- und TDS-Modellen mit fester Länge).
Zusätzlich führt der MRM-Parser in folgenden Fällen standardmäßig beschränkte Korrekturaktionen durch:
  1. Nicht dem Format entsprechende Felder werden bei der Ausgabe für feste Formate verworfen (nur CWF- und TDS-Modelle mit fester Länge).
  2. Wenn verbindlicher Inhalt fehlt, werden Standardwerte (falls verfügbar) bei der Ausgabe für feste Formate geliefert (nur CWF- und TDS-Modelle mit fester Länge).
  3. Wenn der Datentyp eines Elements in der Baumstruktur nicht mit dem im Dictionary angegebenen Datentyp übereinstimmt, wird er, wenn möglich, bei der Ausgabe so konvertiert, dass er der Definition im Dictionary für alle Formate entspricht.

Sie können jedoch bei der Verwendung von Überprüfungsoptionen eine sorgfältigere Überprüfung der Nachrichten anfordern. Wenn Sie beispielsweise eine oder mehrere der folgenden Bedingungen prüfen, eine Ausnahmebedingung auslösen oder Fehler protokollieren möchten:

Die Beispiele veranschaulichen einige dieser Überprüfungsoptionen.

Beim Verwenden von Überprüfungsoptionen muss das folgende Verhalten nachvollzogen werden können:
  • Die Eigenschaft 'Zeitpunkt für Syntaxanalyse', durch die gesteuert wird, ob die Analyse 'Bei Bedarf' (auch als teilweises Parsing bezeichnet) ausgeführt wird, wirkt sich auf den zeitlichen Ablauf bei der Überprüfung von Eingabenachrichten (einschließlich Nachrichtenheadern) aus.

    Weitere Informationen zum Zeitpunkt der Syntaxanalyse finden Sie unter Bedarfsgerechte Syntaxanalyse.

  • Wenn eine Nachrichtenbaumstruktur an einen Sendeknoten übermittelt wird, übernimmt der Sendeknoten standardmäßig die für die Nachrichtenbaumstruktur aktivierten Überprüfungsoptionen. Sie können diese Optionen überschreiben, indem Sie im Sendeknoten eine neue Gruppe von Überprüfungsoptionen angeben.
  • Wenn eine Nachrichtenbaumstruktur als Eingabe an einen Compute-, Zuordnung-, XSLTransform-, DatabaseRetrieve- oder JavaCompute-Knoten übermittelt wird, verfügen alle neue Ausgabenachrichtenbaumstrukturen, die vom Knoten selbst erstellt wurden, über die durch den Knoten angegebenen Überprüfungsoptionen, selbst wenn die gesamte Nachricht kopiert wurde. Sie können dieses Verhalten überschreiben und angeben, dass die vom Knoten erstellten Nachrichten die Überprüfungsoptionen der Baumstruktur der Eingabenachricht übernehmen.
  • (Nur MRM-Domäne) Wenn der Bitstrom geschrieben wird und die Überprüfungsoptionen angewandt werden, wird die gesamte Nachricht geprüft. Unter Umständen enthält die Nachrichtenbaumstruktur einen nicht aufgelösten Typ (z. B. wenn ein Compute-Knoten einen nicht aufgelösten Typ von einer Eingabenachricht in eine Ausgabenachricht kopiert, ohne ihn aufzulösen). Wird ein solcher Typ entdeckt, tritt ein Gültigkeitsfehler auf, da es nicht möglich ist, den Typ zu prüfen. Vergewissern Sie sich, dass alle nicht aufgelösten Typen aufgelöst werden, bevor sie in Ausgabenachrichten kopiert werden, um dieses Problem zu verhindern.
  • (Nur MRM-Domäne) Das Kontrollkästchen Zeichenfolgen mit fester Länge abschneiden darf nicht aktiviert werden. Der Grund hierfür ist, dass die Auswertung vor dem Abschneiden ausgeführt wird und die Auswertung für ein Feld mit fester Länge fehlschlägt, wenn die Länge den in der Nachrichtengruppe angegebenen Längenwert überschreitet. Weitere Informationen zur Eigenschaft Zeichenfolgen mit fester Länge abschneiden finden Sie in den Abschnitten CWF-Eigenschaften von Nachrichtengruppen und TDS-Formateigenschaften von Nachrichtengruppen.

Weitere Informationen, wie Sie die Überprüfung mit verschiedenen Eigenschaften steuern können, finden Sie unter Auswertungseigenschaften.

Zugehörige Konzepte
Parser
MRM-Parser und -Domäne
SOAP-Parser und -Domäne
XML-Parser und -Domänen
XMLNSC-Parser
Nachrichten modellieren
Vordefinierte und selbstdefinierende Nachrichten
Nachrichtenflüsse - Übersicht
Zugehörige Tasks
Nachrichtenfluss entwerfen
Nachrichtenflüsse erstellen
Nachrichtenflussinhalte definieren
Zugehörige Verweise
Integrierte Knoten
Bedarfsgerechte Syntaxanalyse
Auswertungseigenschaften
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac00400_