4D v14.3
DOM Find XML element
- 4D Programmiersprache
-
- XML DOM
-
- Überblick über XML DOM Befehle
- DOM Append XML child node
- DOM Append XML element
- DOM CLOSE XML
- DOM Count XML attributes
- DOM Count XML elements
- DOM Create XML element
- DOM Create XML element arrays
- DOM Create XML Ref
- DOM EXPORT TO FILE
- DOM EXPORT TO VAR
- DOM Find XML element
- DOM Find XML element by ID
- DOM Get first child XML element
- DOM Get last child XML element
- DOM Get next sibling XML element
- DOM Get parent XML element
- DOM Get previous sibling XML element
- DOM Get Root XML element
- DOM GET XML ATTRIBUTE BY INDEX
- DOM GET XML ATTRIBUTE BY NAME
- DOM GET XML CHILD NODES
- DOM Get XML document ref
- DOM Get XML element
- DOM GET XML ELEMENT NAME
- DOM GET XML ELEMENT VALUE
- DOM Get XML information
- DOM Insert XML element
- DOM Parse XML source
- DOM Parse XML variable
- DOM REMOVE XML ATTRIBUTE
- DOM REMOVE XML ELEMENT
- DOM SET XML ATTRIBUTE
- DOM SET XML DECLARATION
- DOM SET XML ELEMENT NAME
- DOM SET XML ELEMENT VALUE
DOM Find XML element
| DOM Find XML element ( ElementRef ; xPath {; arrElementRefs} ) -> Funktionsergebnis | ||||||||
| Parameter | Typ | Beschreibung | ||||||
| ElementRef | String |
|
Referenz auf XML Element | |||||
| xPath | Text |
|
Pfad xPath auf das zu suchende Element | |||||
| arrElementRefs | Array String |
|
Liste der gefundenen Element Referenzen (falls zutreffend) | |||||
| Funktionsergebnis | String |
|
Referenz des gefundenen Elements (wenn zutreffend) | |||||
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 Überblick über XML DOM 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.
Ist das Array arrElementRefs übergeben, füllt die Funktion es mit der Liste der gefundenen XML Referenzen und gibt als Ergebnis das erste Element des Array zurück. Dieser Parameter ist hilfreich, wenn an der Stelle, definiert durch den Parameter xPath, mehrere Elemente mit demselben Namen existieren.
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")
DOM GET XML ELEMENT VALUE(vFound;value)
ALERT("Der Wert des Elements ist: \""+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")
DOM GET XML ELEMENT VALUE(vFound;value)
ALERT("Der Wert des Elements ist: \""+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.
Wir gehen von folgender XML Struktur aus:
<Root> <Elem1> <Elem2>aaa</Elem2> <Elem2>bbb</Elem2> <Elem2>ccc</Elem2> </Elem1> </Root>
Der folgende Code schreibt die Referenz auf jedes Element Elem2 in Array arrAfound:
ARRAY TEXT(arrAfound;0)
vFound:=DOM Find XML element(vElemRef;"/Root/Elem1/Elem2";arrAfound)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.
Produkt: 4D
Thema: XML DOM
Nummer:
864
Geändert: 4D v11 SQL
DOM Count XML elements
DOM Create XML element
4D Programmiersprache ( 4D v11 SQL Release 6)
4D Programmiersprache ( 4D v12.4)
4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v13.5)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)
