XML_APPEND_BEFORE

Script-Funktion: Verschiebt ein XML-Element vor ein anderes Element.

Syntax

XML_APPEND_BEFORE (Element, Reference element)

Syntaxteil	Beschreibung/Format
Element	Verweis auf das Element, das bewegt werden soll. Format: Script-Literal oder Script-Variable
Reference element	Verweis auf das Element, vor dem das Element eingefügt werden soll. Format: Script-Literal oder Script-Variable

Rückgabewert
Verweis auf das eingefügte Element

Hinweise:

Das Script-Sprachmittel fügt ein neues Element vor einem angegebenen bestehenden Element innerhalb des geöffneten XML-Dokuments ein (XML_OPEN). Dadurch wird dieses Element in die XML-Struktur verschoben. Das verschobene Element befindet sich dann auf der gleichen Ebene wie das andere Element (Bezugselement).

Bitte beachten Sie, dass die XML-Struktur nur im Speicher geändert wird. Das Script-Sprachmittel hat keinen Einfluss auf den Tab „Dokumentation“.

Das Element, vor das das Element verschoben wurde, sollte sich nicht auf der obersten Ebene befinden.

Beispiel

Das folgende Beispiel öffnet den Tab „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 im Aktivierungsprotokoll 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