XML_APPEND_BEFORE
Script-Funktion: Verschiebt ein XML-Element vor ein anderes Element.
Syntax
XML_APPEND_BEFORE (Element, Referenzelement)
|
Syntaxteil |
Beschreibung/Format |
|---|---|
|
Element |
Verweis auf das Element, das verschoben werden soll. |
|
Referenzelement |
Verweis auf das Element, vor dem das Element eingefügt werden soll. |
|
Rückgabewert |
|---|
|
Verweis auf das eingefügte Element |
Das Script-Element fügt ein neues Element vor einem angegebenen bestehenden Element innerhalb des geöffneten XML-Dokuments ein. Dadurch wird dieses Element in die XML-Struktur verschoben. Das verschobene Element befindet sich dann auf der gleichen Ebene wie das andere Element (Referenzelement).
Wichtig! Verschieben Sie das Element nicht auf die oberste Ebene. Das Referenzelement kann sich nicht auf der obersten Ebene befinden.
Hinweise:
- Die XML-Struktur wird nur im Speicher geändert. Das Script-Element hat keinen Einfluss auf die Registerkarte "Dokumentation".
- Verwenden Sie die Script-Funktion XML_OPEN, um das XML-Dokument zu öffnen. Weitere Informationen finden Sie unter XML_OPEN.
Beispiel
Das folgende Beispiel öffnet die Registerkarte "Strukturierte Dokumentation" als XML-Dokument. Das Element "SubChild1", das sich innerhalb von "Child1"“ befindet, wird vor "SubChild3" (in "Child2") verschoben.
Alle Elemente, die sich in "Child2" befinden, werden dann in das Aktivierungslog ausgegeben.
:SET &XMLDOCU#=XML_OPEN(DOCU,,"@Details")
:IF &XMLDOCU# <> ""
:SET &ELEMENT1# = XML_SELECT_NODE(&XMLDOCU#,"Child/SubChild1")
:SET &ELEMENT2# = XML_SELECT_NODE(&XMLDOCU#,"Child2/SubChild3")
:SET &NEW# = XML_APPEND_BEFORE(&ELEMENT1#,&ELEMENT2#)
:SET &ELEMENT# = XML_SELECT_NODE(&XMLDOCU#,"Child2")
:SET &ELEMENT# = XML_GET_FIRST_CHILD(&ELEMENT#)
:WHILE &ELEMENT# <> ""
: SET &NAME# = XML_GET_NODE_NAME(&ELEMENT#)
: P 'Element: &NAME#'
: SET &ELEMENT# = XML_GET_NEXTSIBLING(&ELEMENT#)
:ENDWHILE
:ENDIF
:XML_CLOSE &XMLDOCU#
Die folgenden Zeilen werden in den Report geschrieben:
2013-08-14 13:32:27 – U0020408 Element: SubChild1
2013-08-14 13:32:27 – U0020408 Element: SubChild3
Siehe auch: