XML_APPEND_CHILD

Verwenden Sie die Script-Funktion XML_APPEND_CHILD, um ein neues Unterelement vor einem bestimmten Element des geöffneten XML-Dokuments einzufügen. Ein Verweis auf das Element, dem das Unterelement zugeordnet ist, sowie der Name/Wert des neuen Unterelements müssen angegeben werden.

Wichtig!

• Die XML-Struktur wird nur im Speicher geändert. Die Änderungen von XML_APPEND_CHILD werden nicht auf der strukturierten Dokumentationsseite angezeigt.
• Verwenden Sie im Namen des neuen Unterelements keine Leerzeichen.

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

Syntax

XML_APPEND_CHILD (Element, Name, Wert)

Script-Funktion und Parameter

• XML_APPEND_CHILD

  Fügt ein neues Unterelement zu einem XML-Element hinzu.

• Element

  Verweis auf das Element, dem ein neues Unterelement hinzugefügt wird
  Format: Script-Literal oder Script-Variable

• Name

  Name des neuen Unterelements
  Format: Script-Literal oder Script-Variable

• Wert

  Wert des neuen Unterelements
  Format: Script-Literal oder Script-Variable

Rückgabewert

Diese Script-Funktion gibt den Verweis auf das neu eingefügte Unterelement zurück.

Beispiel

Das folgende Beispiel öffnet die strukturierte Dokumentationsseite "@Details" des eigenen Objekts als XML-Dokument und fügt das neue Element "Child3" zum Unterelement "New_Child" hinzu.

: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

:ENDIF
 

 
:XML_CLOSE &XMLDOCU#

Im Aktivierungsreport werden alle Unterelemente von "Child3" und das Element "New_Child" angezeigt:

Siehe auch: