Ausdruckserstellung
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 Relativer XPath aktiviert 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. Der Kontext-Node wird unterhalb des Schemastrukturbereichs angezeigt. Ein absoluter XPath-Ausdruck beginnt am Dokument-Root-Element und wird für den ausgewählten Node verwendet, wenn das Kontrollkästchen Relativer XPath deaktiviert ist.
•Eine Eingabehilfenbereich für Operatoren und Ausdrücke: Dazu gehören (i) Achsen (ancestor::, parent::, usw.) , (ii) Operatoren (z.B. eq und div) und (iii) Ausdrücke (for # in # return #, usw.). Die Elementen in diesem Bereich können entweder in alphabetischer Reihenfolge oder nach Funktionskategorie gruppiert aufgelistet werden. Wählen Sie die gewünschte Option, indem Sie aus dem Dropdown-Menü in der Titelleiste des Bereichs entweder Hierarchisch oder Flache Hierarchie auswählen.
•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 aus dem Dropdown-Menü in der Titelleiste des Bereichs entweder Hierarchisch oder Flache Hierarchie auswählen. Über die Option Namen/Typen können Sie auswählen, ob die Argumente von Funktionen als Namen oder Datentypen angezeigt werden sollen.
Funktionen des Bereichs "Erstellung":
•Um eine Textbeschreibung eines Eintrags in einem der Bereiche zu sehen, platzieren Sie den Mauszeiger darüber.
•Jede Funktion wird mit ihrer Signatur angezeigt (d.h. mit ihren Argumenten, den Datentypen der Argumente und dem Datentyp der Funktionsausgabe).
•Die Signaturen werden entweder nach dem Namen oder dem Datentyp der Funktionsargumente und der Funktionsausgabe aufgelistet. Wählen Sie aus dem Dropdown-Menü in der Titelleiste des Bereichs entweder Namen oder Typen aus.
•Wenn Sie in einem der Bereiche auf einen Eintrag doppelklicken (Operator, Ausdruck oder Funktion), so wird dieser an der Cursorposition in den Ausdruck eingefügt. Funktionen werden mit ihren Argumenten in Form von Platzhaltern (#-Symbol) eingefügt.
•Wenn (i) im Bearbeitungsfeld des XPath-Ausdrucks Text ausgewählt ist und (ii) Sie auf einen Ausdruck oder eine Funktion mit einem Platzhalter doppelklicken, um sie einzufügen, so wird anstelle des Platzhalters der ausgewählte Text eingefügt.
Nachdem Sie eine Funktion in den Ausdruck eingefügt haben, werden bei Platzieren der Maus über den Funktionsnamen die Signatur der Funktion und eine Textbeschreibung der Funktion angezeigt. Wenn für eine Funktion unterschiedliche Signaturen mit demselben Namen vorhanden sind, so werden diese am unteren Rand der Anzeige mit einem Überladungsfaktor angezeigt. Wenn Sie den Cursor innerhalb der Klammern der Funktion platzieren und Strg+Umschalt+Leertaste drücken, sehen Sie die Signaturen der verschiedenen Überladungen dieses Funktionsnamens.
Erstellen von XPath-Ausdrücken
Über das Dialogfeld "XPath-Ausdruck bearbeiten" können Sie auf folgende Arten XPath-Ausdrücke erstellen.
•Kontext-Node und Schemastruktur
Im Auswahl-Textfeld im Bereich "Quellen" sehen Sie sofort den Kontext-Node. Der Ausdruck wird an einer Stelle innerhalb dieses Kontext-Node eingefügt und wird im Kontext dieses Node ausgewertet.
•Einfügen eines Node aus der Schemastruktur
Im Bereich Quellen wird das gesamte Schema angezeigt. Durch Doppelklick auf den entsprechenden Node können Sie diesen in den XPath-Ausdruck einfügen. Wenn das Kontrollkästchen Relativer XPath aktiviert ist, wird der ausgewählte Node mit einem Pfadausdruck, die relativ zum Kontext-Node ist, eingefügt.
•Namespace-Informationen
Die Schemastruktur im Bereich Quellen enthält einen Namespace-Eintrag. Wenn Sie diesen Eintrag erweitern, werden alle im Stylesheet deklarierten Namespaces angezeigt. Diese Informationen sind oft hilfreich um die Präfixe eines Namespace zu überprüfen, den Sie in einem XPath-Ausdruck verwenden möchten.
•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.
•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). Die Argumente können als Namen oder Datentypen angezeigt werden; wählen Sie in der Titelleiste des Bereichs Namen oder Datentypen aus. 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 keinem oder einem date Element handelt. Wenn Sie den Mauszeiger über eine Funktion positionieren, wird eine kurze Beschreibung der Funktion angezeigt. Um eine Funktion in den XPath-Ausdruck einzufügen, doppelklicken Sie auf die gewünschte Funktion.
•In XPath-Ausdrücken können Java- und .NET-Erweiterungsfunktionen verwendet werden, wodurch Sie Zugriff auf die Funktionen dieser Programmiersprachen erhalten. Über die Schaltflächen Java und .NET am unteren Rand des Dialogfelds können Sie Info-Felder mit Erklärungen zur Verwendung von Java- und .NET-Erweiterungsfunktionen in XPath-Ausdrücken aufrufen. Nähere Informationen dazu finden Sie in dieser Dokumentation im Abschnitt Erweiterungsfunktionen.
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).
Zur Auswahl stehen Elemente, XPath-Funktionen und XPath-Achsen. Mit Hilfe der Nach oben und Nach unten-Tasten können Sie durch die Liste der Optionen navigieren. Drücken Sie die Eingabetaste, um eine Option auszuwählen und in den Ausdruck einzufügen.
Das Kontrollkästchen "Andernfalls"
Über die Ein/Aus-Schaltfläche Andernfalls (siehe roter Pfeil in der Abbildung unten) wird als letzte Verzweigung eine Andernfalls-Verzweigung zu einer Bedingungsvorlage hinzugefügt. In einer Bedingungsvorlage darf nur eine einzige Andernfalls-Verzweigung vorhanden sein. Wenn eine Bedingungsvorlage ausgewertet wird, wird die erste Verzweigung, deren Ergebnis true ergibt, ausgeführt. Wenn keine der Verzweigungen zu true ausgewertet wird, so wird die Andernfalls-Verzweigung ausgeführt, falls vorhanden. Andernfalls wird die Bedingungsvorlage geschlossen, ohne dass irgendeine ihrer Verzweigungen ausgeführt wird. Da die Andernfalls-Bedingung nur dann ausgeführt wird, wenn keine der vorhergehenden Bedingungen zu true ausgewertet wurde, muss keine Bedingung dafür definiert werden. Wenn Sie daher das Kontrollkästchen "Andernfalls" aktivieren, ist das Eingabefeld des XPath-Ausdrucks deaktiviert.
Nähere Informationen zur Verwendung der Andernfalls-Bedingung finden Sie unter Bedingungsvorlagen.