XML_APPEND_BEFORE

Objekte lesen oder verändern

XML_APPEND_CLONE

---

XML_APPEND_CHILD

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

Syntax

XML_APPEND_CHILD(Element, Name, Value)

Hinweise

Das Sprachmittel fügt einem Element des aktuell geöffneteten XML-Dokuments (siehe Sprachmittel XML_OPEN) ein neues Sub-Element hinzu. Dazu ist der Verweis des Elements anzugeben, dem das Sub-Element zugeordnet werden soll und der Name / Wert des neuen Sub-Elements. Das Sub-Element wird dabei immer am Ende angefügt.

Beachten Sie, dass die XML-Struktur nur im Speicher geändert wird. Auf die Dokumentations-Registerkarte hat das Sprachmittel beispielsweise keinen Einfluss.

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

Beispiel

Folgendes Beispiel öffnet die strukturierte Dokumentations-Registerkarte als XML-Dokument und fügt dem Element "Child3" das neue Sub-Element "New_Child" hinzu. Anschließend werden alle Sub-Elemente von "Child3" 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

:ENDIF
 

 
:XML_CLOSE &XMLDOCU#

Dadurch werden folgende Zeilen in den Report geschrieben:

2013-08-14 13:32:27 – U0020408 Element: SubChild4
2013-08-14 13:32:27 – U0020408 Element: New_Child

Siehe auch:

Script-Sprachmittel - Objekte lesen oder verändern

Strukturierte Dokumentation

www.w3c.org/TR/xmlbase

Beispiele
Ermittlung der Fehlermeldung und -nummer

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel -Funktionelle Gliederung