XML_APPEND_CLONE

Verwenden Sie die Script-Funktion XML_APPEND_CLONE, um ein Element des geöffneten XML-Dokuments zu kopieren und es als Unterelement zu einem anderen Element hinzuzufügen. Das Unterelement wird immer als letztes Element hinzugefügt. Alle untergeordneten Elemente und Werte werden während des Duplizierungsprozesses berücksichtigt.

Wichtig! Die XML-Struktur wird nur im Speicher geändert. Die Änderungen von XML_APPEND_CLONE werden nicht auf der strukturierten Dokumentationsseite angezeigt.

Tipp: Verwenden Sie die Script-Funktion XML_OPEN, um das XML-Dokument zu öffnen. Weitere Informationen finden Sie unter XML_OPEN.

Syntax

XML_APPEND_CLONE (Referenzelement, Element)

Script-Funktion und Parameter

• XML_APPEND_CLONE

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

• Referenzelement

  Verweis auf das Element, an das das duplizierte Element angehängt werden soll
  Format: Script-Literal oder Script-Variable

• Element

  Verweist auf das duplizierte Element.
  Format: Script-Literal oder Script-Variable

Rückgabewert

Diese Script-Funktion gibt den Verweis auf das duplizierte Element zurück.

Beispiel

Das folgende Beispiel öffnet die strukturierte Dokumentationsseite "@Details" des eigenen Objekts als XML-Dokument. Das Element "Sub-Child-C" wird kopiert und als Unterelement zum Element "Child3" hinzugefügt.

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

:IF &XMLDOCU# <> ""
:SET &ELEMENT# = XML_SELECT_NODE(&XMLDOCU#,"Child2/Sub-Child-C")
: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

:ENDIF



:XML_CLOSE &XMLDOCU#

Im Aktivierungsreport werden alle Unterelemente von "Child3" angezeigt:

Siehe auch: