XML_APPEND_CHILD

Script-Funktion: Fügt einem XML-Element ein neues Sub-Element hinzu.

Syntax

XML_APPEND_CHILD (Element, Name, Value)

Syntaxteil	Beschreibung/Format
Element	Verweis auf das Element, dem ein neues Sub-Eelement hinzugefügt wird. Format: Script-Literal oder Script-Variable
Name	Name des neuen Sub-Elements Format: Script-Literal oder Script-Variable
Value	Wert des neuen Subelements Format: Script-Literal oder Script-Variable

Rückgabewert
Referenz auf das neu eingefügte Sub-Element

Hinweise:

Das Script-Sprachmittel fügt ein neues Sub-Element vor einem bestimmten Element des XML-Dokuments ein, das geöffnet ist (siehe Script-Sprachmittel XML_OPEN). Ein Verweis auf das Element, dem das Sub-Element zugeordnet ist, sowie der Name/Wert des neuen Sub-Elements muss angegeben werden. Das Sub-Element wird immer am Ende hinzugefügt.

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

Im Namen des neuen Sub-Elements dürfen keine Leerzeichen erscheinen!

Beispiel

Das folgende Beispiel öffnet den Tab „Strukturierte Dokumentation“ als XML-Dokument und das „Child3“-Element als neues Sub-Element „New_Child“. Alle Sub-Elemente, die sich innerhalb von „Child3“ befinden, werden dann im Aktivierungsprotokoll ausgegeben.

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

:IF &XMLDOCU# <> ""
:SET &CHILD# = XML_SELECT_NODE(&XMLDOCU#,"Child3")
:SET &NEWCHILD# = XML_APPEND_CHILD(&CHILD#,"New_Child","Test")

: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