XML_OPEN

Objekte lesen oder verändern

XML_REMOVE_CHILDREN

---

XML_PRINTINTOFILE

Script-Funktion: Gibt die Struktur von Elementen in eine XML-Datei aus.

Syntax

XML_PRINTINTOFILE (File, Reference)

Anmerkungen

Die Script-Funktion schreibt die Struktur eines Elementes und aller Subelemente in eine angegebene XML-Datei.

Der Script-Funktion muss ein Verweis übergeben werden, um auf ein Element zugreifen zu können. Dieser wird von Script-Sprachmitteln bereitgestellt, die innerhalb des XML-Dokumentes positionieren können, beispielsweise XML_GET_FIRST_CHILD, XML_GET_NEXTSIBLING oder XML_SELECT_NODE. Die Script-Funktion gibt dieses Element samt dessen Subelementen und der zugehörigen Attribute in eine Datei aus.

Es kann auch der Verweis verwendet werden, der XML_OPEN zurückgibt, um die gesamte Struktur auszugeben.

Alle Informationen zur Struktur des Elementes werden hintereinander (ohne Zeilenumbruch) in die angegebene Datei geschrieben. Wird diese Datei mit einem Texteditor, beispielsweise Notepad, geöffnet, ist die Darstellung in Folge dessen unübersichtlich. XML_BEAUTIFY kann vor der Script-Funktion verwendet werden, um den Inhalt der Datei zu formatieren und somit besser lesbar darzustellen. Die Datei kann aber auch beispielsweise mit dem Microsoft Internet Explorer angezeigt werden. Dabei wird die Struktur des Elementes anschaulich dargestellt.

Beachten Sie, dass eine bereits existierende Datei ohne Nachfrage überschrieben wird.

Beispiel

Die komplette Struktur der Dokumentation wird zunächst in besser lesbarer Form aufbereitet und anschließend in die Datei "Doku.xml" ausgegeben.

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

:SET &RET1# = XML_BEAUTIFY(&XMLDOCU#)
:SET &RET2# = XML_PRINTINTOFILE("C:\AUTOMIC\XML_Documentation\Docu.xml",&XMLDOCU#)

:XML_CLOSE

Das zweite Beispiel gibt die Elemente "Beschreibung" und "Objekte" mit ihren Attributen in eine Datei aus.

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

:SET &HND# = XML_GET_FIRST_CHILD(&XMLDOCU#)
:SET &RET1# = XML_BEAUTIFY(&HND#)
:SET &RET2# = XML_PRINTINTOFILE("C:\AUTOMIC\XML_Documentation\Docu.xml",&HND#)

:XML_CLOSE

Siehe auch:

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