XML_APPEND_ELEMENT

Verwenden Sie die Script-Funktion XML_APPEND_ELEMENT, um ein bestimmtes Element des geöffneten XML-Dokuments als Unterelement an ein anderes Element anzuhängen. Dadurch wird das Element verschoben.

Wichtig! Die XML-Struktur wird nur im Speicher geändert. Die Änderungen von XML_APPEND_ELEMENT 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_ELEMENT (Referenzelement, Element)

Script-Funktion und Parameter

• XML_APPEND_ELEMENT
  Fügt ein vorhandenes XML-Element an ein anderes Element an.

• Referenzelement
  Verweis auf das Element, an welches das Element angefügt wird
  Format: Script-Literal oder Script-Variable

• Element
  Verweis auf das Element, vor dem das andere Element eingefügt wird
  Format: Script-Literal oder Script-Variable

Rückgabewert

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

Beispiel

Das folgende Beispiel öffnet die strukturierte Dokumentationsseite "@Details" des eigenen Objekts als XML-Dokument. Zusätzlich wird das Element "Sub-Child-C", das sich innerhalb von "Child2" befindet, an das erste Element der XML-Struktur ("Child1") angehängt.

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

: IF &XMLDOCU# <> ""
:SET &FIRST# = XML_GET_FIRST_CHILD(&XMLDOCU#)
:SET &TOAPPEND# = XML_SELECT_NODE(&XMLDOCU#,"Child2/Sub-Child-C")

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

: SET &ELEMENT# = XML_GET_FIRST_CHILD(&FIRST#)
: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 angezeigt, die sich jetzt innerhalb des Elements "Child1" befinden:

Siehe auch: