DOM Find XML element

Version 2004

DOM Find XML element (ElementRef; xPath) ElemRef

Die Funktion DOM Find XML element sucht in einer XML Struktur nach einem spezifischen XML Element. Die Suche startet bei dem Element, definiert durch ElementRef.

In xPath setzen Sie den zu suchenden XML Knoten (node), ausgedrückt als "XPath Notation". (siehe Einführung in XML Befehle). Auch indizierte Elemente lassen sich verwenden.

Hinweis: Suchläufe berücksichtigen in Übereinstimmung mit XML Standards Klein- und Großschreibung.

Die Funktion gibt die XML Referenz auf das gesuchte Element zurück.

Mit dieser Anweisung können Sie rasch nach einem XML Element suchen und seinen Wert anzeigen:

   vFound:=DOM Find XML element(vElemRef;"Items/Book[15]/Title")
   GET XML ELEMENT VALUE(vFound;value)
   ALERT("The value of the element is: \""+value+"\"")

Dieselbe Suche lässt sich auch folgendermaßen ausführen:

   vFound:=DOM Find XML element(vElemRef;""Items/Book[15]")
   vFound:=DOM Find XML element(vFound;"Book/Title")
   GET XML ELEMENT VALUE(vFound;value)
   ALERT("The value of the element is: \""+value+"\"")

Hinweis: Wie Sie in obigem Beispiel sehen können, muss der Pfad XPath immer mit dem Namen des aktuellen Elements beginnen. Dieses Detail ist wichtig zur Verwaltung relativer XPath Pfade.

DOM Count XML elements, DOM Create XML element.

Bei korrekt ausgeführtem Befehl wird die Systemvariable OK auf 1 gesetzt, sonst auf 0 (Null) und ein Fehler wird zurückgegeben.

Ein Fehler wird zurückgegeben, wenn:

• Die Referenz auf das Element ungültig ist

• Der angegebene Pfad x Path ungültig ist.

Anwendung des Befehls

Backup Preferences, Terra Server

---