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

XML_REMOVE_CHILDREN

Script-Funktion: Entfernt alle Sub-Elemente eines XML-Elements.

Syntax

XML_REMOVE_CHILDREN(element)

Syntaxteil	Beschreibung/Format
Element	Verweis auf das Element, dessen Sub-Elemente gelöscht werden sollen. Format: Script-Literal oder Script-Variable

Rückgabewert
"0" - Alle Sub-Elemente des angegebenen Elementes wurden erfolgreich gelöscht.

Hinweise

Das Sprachmittel entfernt alle untergeordneten Elemente eines bestimmten Elementes innerhalb des aktuell geöffneten XML-Dokuments (XML_OPEN). Anzugeben ist dabei nur der Verweis auf das Element. Das Sprachmittel liefert den Rückgabewert "0" wenn die Sub-Elemente erfolgreich gelöscht werden konnten.

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

Beispiel

In folgendem Beispiel wird die strukturierte Dokumentations-Registerkarte als XML-Dokument geöffnet. Anschließend werden das erste Element bestimmt und all dessen Sub-Elemente gelöscht. Wenn das Entfernen erfolgreich ist, wird eine entsprechende Meldung in das Aktivierungsprotokoll geschrieben.

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

:IF &XMLDOCU# <> ""
:SET &FIRST# = XML_GET_FIRST_CHILD(&XMLDOCU#)
:SET &RET# = XML_REMOVE_CHILDREN(&FIRST#)

:IF &RET# = 0
:P 'Sub-element successfully deleted.'
:ENDIF

:ENDIF

:XML_CLOSE &XMLDOCU#

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