XML_APPEND_CHILD
Script-Funktion: Fügt einem XML-Element ein neues Unterelement hinzu.
Syntax
XML_APPEND_CHILD (Element, Name, Wert)
|
Syntaxteil |
Beschreibung/Format |
|---|---|
|
Element |
Verweis auf das Element, dem ein neues Unterelement hinzugefügt wird. |
|
Name |
Name des neuen Unterelements |
| Wert | Wert des neuen Unterelements Format: Script-Literal oder Script-Variable |
|
Rückgabewert |
|---|
|
Verweis auf das neu eingefügte Unterelement |
Das Script-Element fügt ein neues Unterelement vor einem bestimmten Element des geöffneten XML-Dokuments ein. Ein Verweis auf das Element, dem das Unterelement zugeordnet ist, sowie der Name/Wert des neuen Unterelements müssen angegeben werden. Das Unterelement wird immer am Ende hinzugefügt.
Wichtig! Im Namen des neuen Unterelements dürfen keine Leerzeichen erscheinen.
Hinweise:
- Die XML-Struktur wird nur im Speicher geändert. Das Script-Element hat keinen Einfluss auf die Registerkarte "Dokumentation".
- Verwenden Sie die Script-Funktion XML_OPEN, um das XML-Dokument zu öffnen. Weitere Informationen finden Sie unter XML_OPEN.
Beispiel
Das folgende Beispiel öffnet die Registerkarte "Strukturierte Dokumentation" als XML-Dokument und das "Child3"-Element als neues Unterelement "Neues_Child". Alle Unterelemente, die sich innerhalb von "Child3" befinden, werden dann in das Aktivierungslog ausgegeben.
:SET &XMLDOCU#=XML_OPEN(DOCU,,"@Details")
:IF &XMLDOCU# <> ""
:SET &CHILD# = XML_SELECT_NODE(&XMLDOCU#,"Child3")
:SET &NEWCHILD# = XML_APPEND_CHILD(&CHILD#,"Neues_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#
Das bedeutet, dass die folgenden Zeilen in den Report geschrieben werden:
2013-08-14 13:32:27 – U0020408 Element: SubChild4
2013-08-14 13:32:27 – U0020408 Element: Neues_Child
Siehe auch: