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

XML_INSERT_BEFORE

Scriptfunktion: Erstellt ein neues XML-Element und fügt dieses vor einem anderen Element ein.

Syntax

XML_INSERT_BEFORE(parent element, reference element, name, value)

Syntaxteil	Beschreibung/Format
Parent-Element	Verweis auf das Element, in welchem sich das Referenz-Element befindet. Format: Script-Literal oder Script-Variable
Referenz-Element	Verweis auf das Element, vor welchem das neue Element eingefügt werden soll. Muss sich innerhalb des Parent-Elements befinden. Format: Script-Literal oder Script-Variable
Name	Name des neuen Elements Format: Script-Literal oder Script-Variable
Wert	Wert des neuen Elements Format: Script-Literal oder Script-Variable

Rückgabewert
Verweis auf das neu angelegte Element.

Hinweise

Das Sprachmittel fügt ein neues Element vor einem bestimmten, existierenden Element innerhalb des geöffneten XML-Dokuments (XML_OPEN) ein. Anzugeben ist dabei das Parent-Element, das Referenz-Element darin und Name inklusive Wert des neu anzulegenden Elementes.

Beim angegebenen Referenz-Element muss es sich um ein direktes Sub-Element des Parent-Elementes handeln. Ansonsten kommt es zu einem Laufzeitfehler bei der Durchführung des Sprachmittels.

Das Sprachmittel verändert nur die XML-Struktur im Speicher. Der Inhalt der Dokumentations-Registerkarte beispielsweise wird 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 als XML-Dokument geöffnet. Innerhalb des Parent-Elements "Child" wird vor dessen Sub-Element "SubChild2" das neue Element "New_Element" eingefügt.

Anschließend werden alle Sub-Elemente des Parent-Elementes ausgegeben und so überprüft, ob das Element erfolgreich hinzugefügt wurde.

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

:IF &XMLDOCU# <> ""
:SET &PARENT# = XML_SELECT_NODE(&XMLDOCU#,"Child")
:SET &REF# = XML_SELECT_NODE(&XMLDOCU#,"Child/SubChild2")

:SET &NEW# = XML_INSERT_BEFORE(&PARENT#,&REF#,"New_Element","Test")

: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#

Ergebnis im Aktivierungsprotokoll:

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

Siehe auch:

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

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

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