XML_APPEND_ELEMENT

Script-Funktion: Fügt ein bestehendes XML-Element zu einem anderen Element hinzu.

Syntax

XML_APPEND_ELEMENT (Reference element, Element)

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

Rückgabewert
Verweis auf das angefügte Element

Hinweise:

Die Script-Funktion hängt ein bestimmtes Element des geöffneten XML-Dokuments (XML_OPEN) als Unterelement auf ein anderes Element an. Dadurch wird das Element verschoben.

Die Änderung der XML-Struktur findet nur im Speicher statt. Der Tab „Dokumentation“ ist davon nicht betroffen.

Beispiel

Das folgende Beispiel öffnet die Registerkarte Strukturierte Dokumentation als XML-Dokument. Zusätzlich wird das Element „SubChild3“, das sich innerhalb von „Child2“ befindet, dann an das erste Element der XML-Struktur (Child1) angehängt.

Alle Unterelemente, die sich innerhalb von „Child1“ befinden, werden dann im Aktivierungsreport protokolliert.

:SET &XMLDOCU#=XML_OPEN(DOCU,,"@Details")

:IF &XMLDOCU# <> ""
:SET &FIRST# = XML_GET_FIRST_CHILD(&XMLDOCU#)
:SET &TOAPPEND# = XML_SELECT_NODE(&XMLDOCU#,"Child2/SubChild3")

:SET &CLONECHILD# = XML_APPEND_ELEMENT(&FIRST#,&TOAPPEND#)

:SET &ELEMENT# = &FIRST#
:WHILE &ELEMENT# <> ""
: SET &NAME# = XML_GET_NODE_NAME(&ELEMENT#)
: P 'Element: &NAME#'
: SET &ELEMENT# = XML_GET_NEXTSIBLING(&ELEMENT#)
:ENDWHILE