XPath-Abfragen
Ein XML-Dokument besteht aus einer Hierarchie von Elementen. Mithilfe von XPath-Abfragen können Sie durch Elemente und Attribute in einem XML-Dokument navigieren.
Als Beispiel dient hier eine Suche nach den Absätzen im folgenden XML-Dokument:
<body>
<p>The quick brown fox.</p>
<p>Jumped over the lazy dogs.</p>
</body>
Für die folgende XPath-Abfrage gibt die XPath-Suche zwei Ergebnisse zurück:
body/p
Sie können einen Attributwert für eines der Elemente angeben:
<body>
<p>The quick brown fox.</p>
<p audience = "admin">Jumped over the lazy dogs.</p>
</body>
Schließen Sie in diesem Fall den Attributwert in die Suche ein:
body/p[@audience='admin']
Die XPath-Suche gibt ein Ergebnis zurück.
Die folgende Tabelle enthält Beispiele für XPath-Abfragen:
|
XPath-Abfrage |
Sucht |
|---|---|
|
/task |
Das Element <task>, wenn es sich um einen Knoten der obersten Ebene in einer XML-Datei handelt |
|
//task |
Das Element <task> an einem beliebigen Ort in einer XML-Datei |
|
//task[@id='shovellingsnow'] |
Das Element <task>, wenn das Attribut „ID“ den Wert „shovellingsnow“ hat |
|
task/title |
Alle Elemente <title>, die direkte Vorgänger von <task>-Elementen sind |
|
task//title |
Alle Elemente <titles>, die an einer beliebigen Stelle im Element <task> auftreten |
Weiter Informationen finden Sie unter http://www.w3.org/TR/xpath/
XPath-Symbolleiste
1)Öffnen Sie die XPath-Symbolleiste („Darstellung“ > „Symbolleisten“ > „XPath“).
XPath-Symbolleiste
2)Geben Sie die Abfrage in das Feld „XPath“ ein und klicken Sie auf „Ausführen“.
Die Ergebnisse der Abfrage werden im XPath Builder-Pod angezeigt.
XPath Builder-Pod
Die Abfragegenerierung stellt ebenfalls eine praktische Methode zum Erstellen von XPath-Abfragen dar. In der Abfragegenerierung können Sie eine XPath-Abfrage erstellen (wobei automatische Vorschläge verfügbar sind) und ausführen.
Außerdem können Sie den Suchbereich festlegen:
•Aktuelle Datei
•Alle geöffneten Dateien
•Gewählter Ordner
•DITA Map/Book – Diese Option ist verfügbar, wenn Sie im Ressourcenmanager eine DITA Map oder ein DITA-Buch auswählen
Automatische Vorschläge
Automatische Vorschläge sind vorgeschlagene Komponenten, die Sie während des Erstellens zu einer XPath-Abfrage hinzufügen können.
Es folgt ein XML-Beispiel:
<body>
<p>The quick brown fox.</p>
<p audience = "admin">Jumped over the lazy dogs.</p>
</body>
1)Beginnen Sie die Eingabe im Feld „Abfragegenerierung“ mit einem Schrägstrich (/).
Sobald Sie den Schrägstrich eingeben, werden die folgenden Vorschläge angezeigt:
Automatische Vorschläge
2)Wählen Sie mithilfe der Nach-Oben- und Nach-Unten-Taste die gewünschte Option und drücken Sie die Eingabetaste, um die Komponente in die Abfrage einzufügen.
3)Um ein weiteres Element zur Abfrage hinzuzufügen, geben Sie einen Schrägstrich ein.
Alternativ können Sie zum Hinzufügen eines Attributs eine öffnende eckige Klammer ([).
Die Liste der automatischen Vorschläge enthält die folgenden Komponenten einer XPath-Abfrage:
Element (orange markiert)
Elemente an der aktuellen Position im aktuellen Dokument.
Attribut (blau markiert)
Attribute an der aktuellen Position im aktuellen Dokument.
Achsen (grün markiert)
Eine Achse ist eine Knotendefinition relativ zum aktuellen Knoten, z. B. „parent“, „child“, „ancestor“.
Klicken Sie auf die Dropdownliste rechts neben der Option „Automatische Vorschläge aktivieren“ und deaktivieren Sie die Option „Achsen“, um die verfügbaren Achsen in der Liste der automatischen Vorschläge auszublenden.
hinweis: Sie haben die Möglichkeit, automatische Vorschläge in der Abfragegenerierung zu deaktivieren.
Klicken Sie auf das Symbol „Speichern“, um die aktuellen Ergebnisse der XPath-Abfrage zu speichern.