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

XML_APPEND_BEFORE

Script-Funktion: Verschiebt ein XML-Element vor ein anderes Element.

Syntax

XML_APPEND_BEFORE (Element, Reference element)

Syntaxteil

Beschreibung/Format

Element

Verweis auf das Element, welches verschoben werden soll.
Format: Script-Literal oder Script-Variable

Referenz-Element

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


Rückgabewert

Verweis auf das eingefügte Element

Hinweise

Das Sprachmittel fügt ein bestimmtes Element vor einem anderen Element innerhalb des aktuell geöffneten XML-Dokuments (siehe Sprachmittel XML_OPEN) ein. Dadurch wird das Element in der XML-Struktur verschoben. Das verschobene Element befindet sich anschließend auf der gleichen Ebene wie das andere Element (Referenz-Element).

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

Das Element, vor welchem das Element verschoben wird, darf sich nicht auf der obersten Ebene befinden.

Beispiel

In folgendem Beispiel wird die strukturierte Dokumentations-Registerkarte als XML-Dokument geöffnet. Anschließend wird das Element "SubChild1", welches sich innerhalb von "Child1" befindet, vor "SubChild3" verschoben (innerhalb von "Child2").

Anschließend werden alle Elemente, die sich innerhalb von "Child2" befinden, im Aktivierungsprotokoll ausgegeben.

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

:IF &XMLDOCU# <> ""
:SET &ELEMENT1# = XML_SELECT_NODE(&XMLDOCU#,"Child/SubChild1")
:SET &ELEMENT2# = XML_SELECT_NODE(&XMLDOCU#,"Child2/SubChild3")
:SET &NEW# = XML_APPEND_BEFORE(&ELEMENT1#,&ELEMENT2#)

:SET &ELEMENT# = XML_SELECT_NODE(&XMLDOCU#,"Child2")
:SET &ELEMENT# = XML_GET_FIRST_CHILD(&ELEMENT#)

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

:ENDIF

:XML_CLOSE &XMLDOCU#

Folgende Zeilen werden in den Report geschrieben:

2013-08-14 13:32:27 – U0020408 Element: SubChild1
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