Automation Engine Script-Leitfaden > Funktionelle Gliederung > Objekte lesen oder verändern > XML_APPEND_ELEMENT

XML_APPEND_ELEMENT

Script-Funktion: Hängt ein existierendes XML-Element an ein anderes Element.

Syntax

XML_APPEND_ELEMENT (Reference element, element)

Syntaxteil

Beschreibung/Format

Referenz-Element

Verweis auf das Element, welchem das Element hinzugefügt werden soll.
Format: Script-Literal oder Script-Variable

Element

Verweis auf das Element, welches dem anderen Element angehängt werden soll.
Format: Script-Literal oder Script-Variable


 

Rückgabewert

Verweis auf das angehängte Element

Hinweise

Die Script-Funktion hängt ein bestimmtes Element, innerhalb des aktuell geöffneten XML-Dokumentes (XML_OPEN), als Sub-Element an ein anderes Element. Das Element wird dadurch verschoben.

Die Änderung der XML-Struktur findet nur im Speicher statt. Die Dokumentations-Registerkarte beispielsweise wird durch das Sprachmittel nicht beeinflusst.

Beispiel

Folgendes Beispiel öffnet die strukturierte Dokumentations-Registerkarte als XML-Dokument. Weiters wird das Element "SubChild3", welches sich innerhalb von "Child2" befindet, an das erste Element der XML-Struktur (Child1) gehängt.

Anschließend werden alle Sub-Elemente von "Child1" im Aktivierungsreport protokolliert.

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

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

:SET &CLONECHILD# = XML_APPEND_ELEMENT(&FIRST#,&TOAPPEND#)

:SET &ELEMENT# = &FIRST#

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

:ENDIF
 

 
:XML_CLOSE &XMLDOCU#

Ergebnis im Aktivierungsprotokoll:

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

 

Siehe auch:

Script-Sprachmittel Beschreibung
XML_OPEN Öffnet ein XML-Dokument für die Bearbeitung.
:XML_CLOSE Schließt ein XML-Dokument.

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH