XML_APPEND_CLONE

Script-Funktion: Dupliziert ein XML-Element und hängt es an ein anderes Element an.

Syntax

XML_APPEND_CLONE (Reference element, Element)

Syntaxteil	Beschreibung/Format
Reference element	Verweis auf das Element, an das das duplizierte Element angehängt werden soll. Format: Script-Literal oder Script-Variable
Element	Bezieht sich auf das duplizierte Element. Format: Script-Literal oder Script-Variable

Rückgabewert
Verweis auf das duplizierte Element.

Hinweise:

Das Script-Sprachmittel XML_APPEND_CLONE kopiert ein offenes Element des XML-Dokuments (siehe Script-Sprachmittel XML_OPEN) und fügt es einem anderen Element als Sub-Element hinzu. Das Sub-Element wird immer als letztes Element hinzugefügt.

Alle untergeordneten Elemente und Werte werden bei der Duplizierung berücksichtigt.

Das Script-Sprachmittel kopiert nur die XML-Struktur, die im Speicher abgelegt ist. Der Tab „Dokumentation“ ist davon nicht betroffen.

Beispiel

Das folgende Beispiel öffnet den Tab „Strukturierte Dokumentation“ als XML-Dokument. Das Element „SubChild3“ wird dann kopiert und dem Element „Child3“ als Sub-Element hinzugefügt. Alle Sub-Elemente von „Child3“ werden im Aktivierungsreport zur Überprüfung ausgegeben.

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

:IF &XMLDOCU# <> ""
:SET &ELEMENT# = XML_SELECT_NODE(&XMLDOCU#,"Child2/SubChild3")
:SET &CHILD# = XML_SELECT_NODE(&XMLDOCU#,"Child3")

:SET &CLONECHILD# = XML_APPEND_CLONE(&CHILD#,&ELEMENT#)

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