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

XML_DELETE_NODE

Script-Funktion: Entfernt ein bestimmtes XML-Element.

Syntax

XML_DELETE_NODE(Element)

Syntaxteil

Beschreibung/Format

Element

Verweis auf das zu löschende Element.
Format: Script-Literal oder Script-Variable


 

Rückgabewert

"0" - Das Element wurde erfolgreich gelöscht.

Hinweise

Das Sprachmittel entfernt ein bestimmtes Element aus dem aktuell geöffneten XML-Dokument (XML_OPEN). Dabei ist der Verweis auf das zu löschende Element anzugeben.

Wird ein Element angegeben, welches Sub-Elemente enthält, so werden diese ebenfalls gelöscht.

Die Änderung des Sprachmittel betrifft nur die XML-Struktur, die sich im Speicher befindet. Die Dokumentations-Registerkarte beispielsweise bleibt unbeeinflusst.

Beispiel

In folgendem Beispiel wird eine strukturierte Dokumentations-Registerkarte als XML-Dokument geöffnet, das erste Element ermittelt und dieses anschließend gelöscht. Im Aktivierungsreport wird eine Meldung ausgegeben, ob das Löschen erfolgreich war.

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

:IF &XMLDOCU# <>
""
:SET &FIRST# = XML_GET_FIRST_CHILD(&XMLDOCU#)
:SET &DELETE# = XML_DELETE_NODE(&FIRST#)

:IF &DELETE# = 0
:P 'First XML element successfully deleted'
:ELSE 
:P ]><span class="scriptstring">'An error occurred while deleting the XML element'</span><br />:<span class="scriptstatement">ENDIF</span></span><span class="script"><br /></span><span class="script"><br />:<span class="scriptstatement">ENDIF </span></span><br /> <br /><span class="script">:<span class="scriptstatement">XML_CLOSE </span><![CDATA[ &XMLDOCU#

 

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