XML_BEAUTIFY

Objekte lesen oder verändern

XML_DELETE_NODE

---

XML_CLONE_AND_RENAME

Script-Funktion: Dupliziert ein XML-Element und benennt dieses um.

Syntax

XML_CLONE_AND_RENAME(Element, Name)

Hinweise

Das Sprachmittel dupliziert ein Element innerhalb des aktuell geöffneten XML-Dokuments (siehe Sprachmittel XML_OPEN) und benennt dieses um. Das neue Element ist danach explizit mit dem Sprachmittel XML_APPEND_ELEMENT an ein Element anzuhängen! 

XML_CLONE_AND_RENAME klont das Element, aber fügt es noch keinem anderen Element hinzu. Verwenden Sie dazu XML_APPEND_ELEMENT.

Beim Duplizieren werden auch alle untergeordneten Elemente und Werte berücksichtigt.

Das Sprachmittel verändert nur die XML-Struktur, die sich im Speicher befindet. Die Dokumentations-Registerkarte beispielsweise wird dadurch nicht beeinflusst.

Beachten Sie, dass Leerzeichen im Namen von Elementen nicht erlaubt sind und zu einem Laufzeitfehler führen.

Beispiel

In folgendem Beispiel wird die strukturierte Dokumentations-Registerkarte geöffnet und das Element "SubChild3", welches sich im Parent-Element "Child2" befindet, mit dem Namen "New_Element" dupliziert. Zuletzt werden die Sub-Elemente von 'Child2' in den Aktivierungsreport geschrieben.

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

:IF &XMLDOCU# <> ""
:SET &TOCLONE# = XML_SELECT_NODE(&XMLDOCU#,"Child2/SubChild3")

:SET &CLONECHILD# = XML_CLONE_AND_RENAME(&TOCLONE#,"New_Element")

:SET &PARENT# = XML_SELECT_NODE(&XMLDocu#, "Child3")
:SET &RET# = XML_APPEND_ELEMENT(&PARENT#, &CLONECHILD#)

:SET &ELEMENT# = XML_GET_FIRST_CHILD(&PARENT#)
:WHILE &ELEMENT# <> ""
: SET &NAME# = XML_GET_NODE_NAME(&ELEMENT#)
: P 'Element: &NAME#'
: SET &ELEMENT# = XML_GET_NEXTSIBLING(&ELEMENT#)
:ENDWHILE

:ENDIF

:XML_CLOSE &XMLDOCU#

Im Aktivierungsprotokoll sind anschließend folgende Zeilen verfügbar:

2013-08-14 13:32:27 – U0020408 Element: SubChild3
2013-08-14 13:32:27 – U0020408 Element: New_Element

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