XPath-Ausdrücke

Eine Reihe von integrierten Knoten besitzen Eigenschaften, die über einen XPath 1.0-Ausdruck festgelegt werden können; diese Sprache wird meistens verwendet, wenn es darum geht, Pfadausdrücke zum Lokalisieren von Hauptteilelementen eingehender Nachrichten, die von einem Knoten empfangen werden, zu bilden.

Andere, nicht so häufig verwendete Knoteneigenschaftsfelder unterstützen die Eingabe, von allgemeinen XPath 1.0-Ausdrücken, die einen größeren Umfang der Sprache unterstützen, um komplexere Auswertungen in der XPath 1.0-Laufzeitengine des Brokers durchzuführen.

Das XPath-Ausdruckserstellungsprogramm stellt eine Baumstrukturansicht eines erwarteten Nachrichtenlayouts bereit und unterstützt die automatische Generierung eines XPath 1.0-Pfadausdrucks über die Auswahl eines Elements innerhalb der vorgegebenen Baumstruktur.

Pfadausdrücke von XPath 1.0 können in einem Nachrichtenfluss eingesetzt werden, um auf bestimmte Teile einer eingehenden Nachricht zuzugreifen, Teile einer ausgehenden Nachricht zu erstellen oder zu lokalisieren und um komplexe Auswertungen von Nachrichtenverarbeitungsausdrücken durchzuführen, die Werte in Nachrichtenbaumstrukturen, auf die ein Knoten zugreifen kann, einschließen können. Anschließend kann die Nachricht verarbeitet werden; Sie können beispielsweise Werte aus einer Nachricht umwandeln, filtern oder abrufen.

Der Route-Knoten wendet allgemeine XPath 1.0-Ausdrücke auf den Inhalt von Nachrichtenbaumstrukturen an, die der eingehenden Nachricht für diesen Knoten zugeordnet sind. Nach der Auswertung eines Ausdrucks wird das Ergebnis in einen booleschen Wert (wahr oder falsch) umgesetzt und anhand dieses Wertes entschieden, ob eine Kopie der eingehenden Nachricht abwärts an ein Ausgabeterminal, das dem verarbeiteten Ausdruck zugeordnet ist, weitergeleitet wird.

Wenn sich in Ihrem Arbeitsbereich XML-Schemadefinitionen (.mxsd-Dateien) befinden, können alle Elemente, Attribute oder Datentypen, die in den Definitionen angegeben sind, in die Anzeigefunktion für Datentypen geladen und dann ausgewählt werden, um automatisch eine Pfadausdruckszuordnung zu der betreffenden Definition zu generieren.

Entsprechend können Sie abhängig von den XPath-Ausdrücken, die von der jeweiligen Eigenschaft unterstützt werden, XPath-Funktionen und -Operatoren auswählen, um sie in einen Ausdruck aufzunehmen, oder manuell eigene Ausdrücke erstellen.

Die Anzeigefunktion für Datentypen enthält eine Liste mit Variablen, die sich auf Baumstrukturen beziehen, auf die von Ausdrücken für die betreffende Knoteneigenschaft zugegriffen werden kann.

Beispielsweise ermöglicht $InputRoot Zugriff auf die Baumstruktur der eingehenden Nachricht. Das feste Format von Standardordnern, die Sie unter dieser Baumstruktur erwarten können, z. B. Eigenschaften und MQMD, werden beschrieben, ohne dass eine .mxsd-Definition für sie importiert werden muss. In der Anzeigefunktion kann durch diese Strukturen navigiert werden. Bei Auswahl eines Elements in diesen Strukturen wird automatisch ein Pfadausdruck erstellt, der über die Sprache XPath 1.0 dem betreffenden Element zugeordnet wird.

Der Bereich für die Schemaanzeige bietet eine Baumstrukturansicht der Eingabenachricht. Gehen Sie zur visuellen Erstellung des XPath-Ausdrucks folgendermaßen vor:

  1. Fügen Sie den relevanten Knoten zum Nachrichtenfluss hinzu.
  2. Geben Sie in der Anzeigefunktion für Eigenschaften den Korrelationsnamen ein, drücken Sie Strg + Leerzeichen, um eine Inhaltshilfe aufzurufen, oder klicken Sie auf Bearbeiten, um den Editor für Ausdrücke zu verwenden. Die Inhaltshilfe wird auch aufgerufen, indem beispielsweise einfach das Zeichen $ in zellenbasierten Eigenschaftsfeldern eingegeben wird. Weitere Informationen zu Korrelationsnamen finden Sie unter Korrelationsnamen.
  3. Erweitern Sie die Baumstruktur, navigieren Sie zu dem Feld, für das Sie den Ausdruck erstellen möchten, und klicken Sie dann zu dessen Auswahl darauf. Ein Feld ist entweder ein Element oder ein Attribut. Klicken Sie doppelt auf das Feld, um es dem XPath-Ausdruck unten hinzuzufügen. Im XPath-Ausdruckserstellungsprogramm können Sie Felder, Funktionen und Operatoren auch an die gewünschten Stellen im XPath-Ausdruck ziehen und dort ablegen.
  4. Wenn Sie Bedingungen festlegen möchten, geben Sie diese wie bei einem normalen XPath-Ausdruck ein.
Der vollständige XPath-Ausdruck wird an einem der folgenden Orte angezeigt:
  • Im Fenster XPath-Ausdruck, wenn Sie das XPath-Ausdruckserstellungsprogramm verwenden.

    Der Dialog des Ausdruckserstellungsprogramms ist eine optionale Unterstützung bei der Generierung von Ausdrücken, die, wenn sie vollständig sind, den Wert im Eigenschaftsfeld eines Knotens bilden.

    Wenn Sie nicht den Dialog des Ausdruckserstellungsprogramms verwenden, wird die Gültigkeit der manuell eingegebenen Ausdrücke mit dem Eigenschafteneditor geprüft.

  • Im Feld Eigenschaft, wenn es sich im Knoten selbst befindet.

Beachten Sie die Nachrichten, die oben im Fenster des XPath-Editors angezeigt werden. Diese Nachrichten weisen Sie darauf hin, dass ein Pfad oder Ausdruck, den Sie eingegeben haben, ungültig ist, auch wenn der Editor die Eingabe des Ausdrucks zulässt und ihn sogar speichert.

Beispiel

Dies ist der XPath-Ausdruck, der im XPath-Ausdruckserstellungsprogramm erstellt wurde, um die Employee-Geschäftsobjekte für alle Mitarbeiter, die Manager sind, zu filtern: $Body/getEmployeeInfo/Emp[isManager=true()].
  • $Body: Der Hauptteil der Nachricht, d. h. das letzte untergeordnete Element des Stammelements.
  • /getEmployeeInfo: Der Name der Operation in der Schnittstelle.
  • /Emp: Der Name des Eingabenachrichtentyps.
  • [isManager=true()]: Prüft, ob das Feld isManager auf 'true' gesetzt ist.
In diesem Fall kann der Ausdruck sowohl für Anforderungs- als auch Antwortflüsse verwendet werden, da die Ein- und Ausgabenachrichten für die Operation identisch sind.

Im Abschnitt XPath finden Sie weitere Informationen zu XPath 1.0.

Zugehörige Konzepte
Nachrichtenflüsse - Übersicht
Nachrichtenzuordnungen - Übersicht
Zugehörige Tasks
ESQL schreiben
Zugehörige Verweise
Integrierte Knoten
Vordefinierte XPath-Zuordnungsfunktionen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ak64930_