Erstellungsprogramm für XPath-Ausdrücke

Das Erstellungsprogramm für XPath-Ausdrücke kann von den meisten Eigenschaftsfeldern aus gestartet werden, die XPath-Ausdrücke als Eingabewerte unterstützen bzw. erwarten.

Die Verwendung des Erstellungsprogramms für XPath-Ausdrücke ist optional. Das Programm ist als Unterstützung bei der Entwicklung von Nachrichtenflussanwendungen gedacht. Das Erstellungsprogramm für XPath-Ausdrücke ist beim Aufbau von Nachrichtenverarbeitungsausdrücken in XPath oder ESQL behilflich. Sie haben die Wahl, die Ausdrücke manuell einzugeben oder mit Unterstützung des Erstellungsprogramms für XPath-Ausdrücke zu erstellen.

Sie können die Felder unabhängig vom Status des Knotens füllen, egal ob der Knoten abgehängt oder verbunden ist oder ob er vollständig, teilweise oder gar nicht konfiguriert ist.

Das XPath-Ausdruckserstellungsprogramm kann über Schaltflächen an folgenden Stellen gestartet werden:
  • Tabellenzellen rechts neben dem Texteingabefeld innerhalb der Zelle
  • Dialoge Hinzufügen bzw. Bearbeiten, in denen Zeilen in Tabellen erstellt werden, rechts neben dem betreffenden Eigenschaftsfeld
  • Registerkarten in der Eigenschaftenanzeigefunktion für einen Knoten rechts neben einem Eigenschaftsfeld

Variablen (bzw. Korrelationsnamen in der ESQL-Terminologie) stellen eine Liste mit allen Ausgangspunkten der Nachrichtenbaumstruktur bereit, die für das jeweilige Eigenschaftsfeld anwendbar sind, von dem aus der Dialog aufgerufen wurde.

Wenn es sich bei einem Feld um ein schreibgeschütztes Pfadfeld oder ein Pfadfeld mit Lese-/Schreibzugriff handelt, müssen die Ausdrücke mit einer solchen Variablen beginnen, die angibt, mit welcher Baumstruktur in welchem Nachrichtenaufbau der Pfadausdruck abgeglichen wird.

XPath-Variablennamen werden mit vorhandenen Korrelationsnamen in ESQL-Feldreferenzausdrücken abgeglichen. Damit sie aber auch der ESQL-Grammatik entsprechen, wird ihnen das Dollarzeichen ($) als Präfix vorangestellt, um sie als Variablenreferenzen zu kennzeichnen.

Beispiel:
ESQL
Root.XMLNSC.CUST_DETAILS.NAME
XPATH
$Root/XMLNSC/CUST_DETAILS/NAME
Die Variable gibt an, in welcher Baumstruktur und an welcher Stelle der Baumstruktur der Ausdruck verankert ist.

Der Dialog des Erstellungsprogramms für XPath-Ausdrücke unterstützt die Gültigkeitsprüfung, die Sie auf der Seite mit den XPath-Benutzervorgaben inaktivieren können, indem Sie die Auswahl des Kontrollkästchens Validate when creating XPath expressions (Gültigkeitsprüfung beim Erstellen von XPath-Ausdrücken) zurücknehmen.

Wenn Sie Variablen des Typs $Root oder $Body auswählen und einen Ausdruck erstellen, der auf den Hauptteil der Nachricht verweist, enthält der XPath-Ausdruck das Nachrichtenelement. Dies ist bei Nachrichtenhauptteilen, deren Eigner die XMLNSC-, XMLNS-, XML- und DataObject-Domänen sind, korrekt.

Bei Nachrichtenhauptteilen, deren Eigner die MRM-, MIME-, SOAP- und IDOC-Domänen sind, müssen Sie das Nachrichtenelement aus dem Ausdruck entfernen.

Der XPath-Ausdruck $Body/my_message/my_field ist beispielsweise für XMLNSC korrekt, muss für MRM jedoch in $Body/my_field geändert werden.

Ansichten

Wenn die Funktionen unterstützt werden, gibt es drei Hauptansichten.

Ob eine Ansicht angezeigt wird und was in der jeweiligen Ansicht zu sehen ist, hängt davon ab, über welche Art von Eigenschafteneditor der Dialog gestartet wurde und welche Einstellungen vorgenommen wurden. So wird beispielsweise bei Feldern des Pfadtyps kein Funktionsfenster angezeigt. Die unterstützten Operatoren können ebenso wie die Liste der anwendbaren Variablen unterschiedlich sein.
Data Types Viewer (Anzeigefunktion für Datentypen)
In dieser Ansicht werden die verschiedenen Schematypen, Elemente und Attribute angezeigt, die in einem zu erstellenden XPath-Ausdruck verwendet werden können, sowie die zulässigen Variablenreferenzen.
XPath Function (XPath-Funktion)
In dieser Ansicht werden die folgenden vier Hauptkategorien der höchsten Ebene angezeigt:
String (Zeichenfolge)
Diese Kategorie entspricht der Beschreibung in der XPath 1.0-Spezifikation von section-String-Functions.
Boolescher Wert
Diese Kategorie entspricht der Beschreibung in der XPath 1.0-Spezifikation von section-Boolean-Functions.
Numerisch
Diese Kategorie entspricht der Beschreibung in der XPath 1.0-Spezifikation von section-Number-Functions.
Knotensatz
Diese Kategorie entspricht der Beschreibung in der XPath 1.0-Spezifikation von section-Node-Set-Functions.
Informationen zum Format von XPath 1.0-Ausdrücken finden Sie im Abschnitt W3C XPath 1.0 Spezifikation.
Operators (Operatoren)
In dieser Ansicht wird eine Liste aller verfügbaren Operatoren angezeigt, die innerhalb des betreffenden XPath-Ausdrucks verwendet werden können.

Namensbereichseinstellungen

Wenn Sie im Dialog des Erstellungsprogramms für XPath-Ausdrücke den Bereich Namensbereichseinstellungen erweitern, wird eine Tabelle mit Präfix- und Namensbereichspaarzeichenfolgen angezeigt. Wenn XPath-Ausdrücke erstellt werden, wird diese Tabelle automatisch aktualisiert. Entspricht das generierte Standardpräfix nicht Ihren Vorstellungen, können Sie es ändern, indem Sie auf Change Prefix (Präfix ändern) klicken.

Klicken Sie auf Hinzufügen und füllen Sie die Felder im Dialog aus, wenn Sie einen Zuordnungseintrag für das Präfix und den Namensbereich hinzufügen möchten.

Wählen Sie zum Bearbeiten oder Löschen eines Tabelleneintrags den betreffenden Eintrag aus und klicken Sie auf Bearbeiten bzw. Löschen.

Über die Schaltfläche Bearbeiten wird ein weiterer Felddialog geöffnet, in dem Sie Präfix und Namensbereich ändern können.

Informationen zu den mit dem XPath-Editor bereitgestellten Einstellungen finden Sie im Abschnitt Benutzervorgaben des XPath-Editors.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2012-07-16 12:20:46


ReferenzthemaReferenzthema | Version 8.0.0.1 | ak64910_