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

XML_GET_FIRST_CHILD

Script-Funktion: Ermittelt das erste Subelement eines Elementes.

Syntax

XML_GET_FIRST_CHILD (Reference)

Syntax	Beschreibung/Format
Verweis	Verweis auf ein Element, dessen Subelement bestimmt werden soll Format: Script-Literal oder Script-Variable

Rückgabewert
Verweis auf das erste Subelement " " - Das Element besitzt kein Subelement.

Kommentare

Die Script-Funktion ermittelt das jeweils erste Subelement eines Elementes in dem XML-Dokument.

Der Script-Funktion muss ein Verweis übergeben werden, um auf das jeweils erste Subelement zugreifen zu können. Dieser Verweis wird von speziellen Script-Sprachmitteln genutzt, um sich innerhalb des XML-Dokumentes zu positionieren und diese zu bearbeiten. Allererstes Handle ist jenes, das XML_OPEN zurückgibt. Es verweist beispielsweise auf das Root-Element Content der strukturierten Dokumentation.

Während mit XML_GET_FIRST_CHILD eine Ebene nach rechts in die Struktur hinein positioniert wird, kann XML_GET_NEXTSIBLING verwendet werden, um das auf gleicher Ebene nachfolgende Element zu ermitteln.

Beispiel

Im folgenden Beispiel wird der Name des ersten Subelementes "Beschreibung" bestimmt.

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

:SET &HND# = XML_GET_FIRST_CHILD(&XMLDOCU#)

:   IF &HND# <> ""
:      SET &NAME# = XML_GET_NODE_NAME(&HND#)
:      PRINT "sub-element: &NAME#"
:   ELSE
:      PRINT "No sub-element"
:   ENDIF

:XML_CLOSE

Siehe auch:

Script-Sprachmittel	Beschreibung
XML_GET_LAST_CHILD	Ermittelt das letzte Subelement eines Elementes.
XML_GET_NEXTSIBLING	Ermittelt das nachfolgende Element.

Script-Sprachmittel - Objekte lesen oder verändern

Strukturierte Dokumentation

www.w3c.org/TR/xmlbase

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