Erstellung von XPath-Ausdrücken

www.altova.com Dieses Kapitel drucken Vorherige Seite Eine Ebene nach oben Nächste Seite

Startseite >  XPath/XQuery: Ausdrücke, Funktionen, Variablen > XPath/XQuery-Ausdrücke und -Funktionen > Das Dialogfeld "XPath/XQuery-Ausdruck bearbeiten" >

Erstellung von XPath-Ausdrücken

Wenn Sie im Dialogfeld "XPath-Ausdruck bearbeiten" auf die Schaltflächen Erstellen klicken (siehe Abbildung unten), werden Eingabehilfen zum Erstellen eines XPath-Ausdrucks angezeigt. Wenn Sie auf einen der Einträge darin doppelklicken, wird dieser an der aktuellen Cursorposition in den XPath-Ausdruck eingefügt.

 

Es gibt drei Eingabehilfebereiche:

 

Eine Schemastruktur zur Eingabe der Element- und Attribut-Nodes in den XPath-Ausdruck. Wenn das Kontrollkästchen Absoluter XPath deaktiviert ist, so wird der Pfad zum ausgewählten Node relativ zum Kontext-Node (dem Node im Design, in dem der XPath-Ausdruck erstellt wird) eingegeben. Ein absoluter XPath-Ausdruck beginnt am Dokument-Root-Element und wird verwendet, wenn das Kontrollkästchen Absoluter XPath aktiviert ist.
Ein Eingabehilfenbereich für: (i) Achsen (ancestor::, parent::, usw.) , (ii) Operatoren (z.B. eq und div) und (iii) Ausdrücke (for # in  # return #, usw.). In diesem Bereich werden die Achsen, Operatoren und Ausdrücke entweder in alphabetischer Reihenfolge oder nach Funktionskategorie gruppiert aufgelistet. Wählen Sie die gewünschte Option, indem Sie auf das entsprechende Symbol oberhalb des Bereichs klicken.
Eine Eingabehilfe mit den Funktionen der aktiven XPath-Version, die alphabetisch oder nach Funktionskategorie aufgelistet werden. Wählen Sie die gewünschte Option, indem Sie auf das entsprechende Symbol oberhalb des Bereichs klicken. Durch Klicken auf die Schaltflächen  n  und  t  oberhalb des Bereichs werden die Argumente der Funktionen als Namen bzw. Datentypen angezeigt.

 

Click to expand/collapse

 

 

Erstellen von XPath-Ausdrücken

Über das Dialogfeld "XPath-Ausdruck bearbeiten" können Sie auf folgende Arten XPath-Ausdrücke erstellen.

 

 

Kontext-Node und Schema-Struktur

Der Kontext-Node für den XPath-Ausdruck wird im Bereich XML-Zielattribut oder -element auswählen im Textfeld Kontext angezeigt. In der Schemastruktur unterhalb des Textfelds Kontext sehen Sie, wo der Kontext-Node vorkommt und können den XPath-Ausdruck schnell durch Referenzieren der Schemastruktur erstellen.

 

Einfügen eines Node aus der Schemastruktur

Im Bereich XML-Zielattribut oder -element auswählen wird das gesamte Schema angezeigt. Durch Doppelklick auf den entsprechenden Node können Sie einen Node aus der Schemastruktur in den XPath-Ausdruck einfügen. Wenn das Kontrollkästchen Absoluter XPath nicht aktiviert ist, wird der Node mit einer Pfadangabe eingegeben, die relativ zum Kontext-Node ist. So wurde z.B. in der Abbildung oben, das Element Product, welches ein Child-Element des Elements Products (dem Kontextnode) ist, mit einem Pfad eingefügt, der (d.h. als Product) relativ zum Kontext-Node ist. Wäre das Kontrollkästchen §Absoluter XPath" aktiviert, würde der Product-Node als $XML1/Products/Product eingefügt.

 

Einfügen von XPath-Achsen, Operatoren und -Ausdrücken

Im Bereich Operator/Ausdruck auswählen werden je nach XPath-Version XPath-Achsen (ancestor::, parent::, usw.), Operatoren (z.B. eq und div) und Ausdrücke (for # in  # return #, usw.) aufgelistet. Sie können zwischen einer alphabetischen und einer hierarchischen Liste (in der die Elemente nach Funktion gruppiert werden) wechseln. Um eine Achse oder einen Operator in den XPath-Ausdruck einzufügen, doppelklicken Sie auf den gewünschten Eintrag. Wenn Sie den Mauszeiger über eine Achsen, einen Operator oder einen Ausdruck platzieren, wird eine kurze Beschreibung dazu angezeigt.

 

Einfügen von XPath-Funktionen

Im Bereich Funktion auswählen werden die XPath-Funktionen alphabetisch oder nach Funktionalität gruppiert aufgelistet (Klicken Sie auf das entsprechende Symbol oben im Bereich, um zwischen den beiden Anzeigearten zu wechseln). Jede Funktion wird mit ihrer Signatur aufgelistet. Wenn eine Funktion mehrere Signaturen hat, wird sie so oft aufgelistet, wie sie Signaturen hat. Argumente in einer Signatur sind durch Kommas getrennt und jedes Argument kann einen Instanzindikator haben (? bedeutet eine Sequenz von null oder einem Objekt des angegebenen Typs; * bedeutet eine Sequenz von null oder mehr Objekten des angegebenen Typs; + bedeutet eine Sequenz von einem oder mehreren Objekten des angegebenen Typs). Die Argumente können als Namen oder Datentypen angezeigt werden. Wählen Sie die Schaltfläche  n  oder  t  , oberhalb des Bereichs, um zwischen den beiden Abzeigeoptionen zu wechseln. Für jede  Funktion ist auch der Rückgabetyp dieser Funktion definiert. So zeigt z.B. => date ? an, dass es sich beim erwarteten Rückgabedatentyp um eine Sequenz von null oder einem date Element handelt. Wenn Sie den Mauszeiger über eine Funktion positionieren, wird eine kurze Beschreibung der Funktion angezeigt.

DlgEditXPath_Function

Um eine Funktion in den XPath-Ausdruck einzufügen, doppelklicken Sie auf die gewünschte Funktion.

 

Anmerkung:Für alle XPath/XQuery-Funktionen, einschließlich aller Erweiterungsfunktionen und benutzerdefinierten Funktionen wird der XPath-Standard-Namespace verwendet.

 

 

Intelligente Bearbeitung während der Texteingabe

Wenn Sie einen Ausdruck in das Textfeld Ausdruck eingeben, werden die verfügbaren Optionen in einem Popup-Fenster angezeigt (Abbildung unten).

XPathDialogIntelliSense

Zur Auswahl stehen die folgenden Komponenten:

 

Elemente (wie z.B. in der Abbildung oben presswatch),
untergeordnete Nodes (presswatch/selection in der Abbildung oben),
XPath-Funktionen (fn:upper-case oben) und XPath-Achsen (ancestor-or-self oben).
eine Liste der für das Projekt definierten globalen Variablen (werden angezeigt, wenn das Zeichen $ in den Ausdruck eingegeben wird)
eine Liste der im Dialogfeld "Lokalisierung" definierten benutzerdefinierten Strings (werden angezeigt, wenn die Funktion mt-load-string in den Ausdruck eingegeben wird; siehe Beschreibung von mt-load-string)

 

Mit Hilfe der Nach oben und Nach unten-Pfeiltasten können Sie durch die Liste der Optionen navigieren. Drücken Sie die Eingabetaste, um eine Option auszuwählen und in den Ausdruck einzugeben.

 


© 2019 Altova GmbH