XML_PRINTINTOFILE

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

Syntax

XML_PRINTINTOFILE (Datei, Referenz)

Syntax	Beschreibung/Format
Datei	Name und Pfad der XML-Datei Format: Script-Literal oder Script-Variable
Referenz	Verweis auf das Element, dessen Struktur ausgegeben werden soll Format: Script-Literal oder Script-Variable

Rückgabewert
"0" - Die Struktur wurde erfolgreich in die Datei geschrieben.

Die Script-Funktion schreibt die Struktur eines Elements und aller Unterelemente sowie die entsprechenden Attribute in eine angegebene XML-Datei.

Wichtig! Vorhandene Dateien werden ohne Nachfrage überschrieben.

Hinweis: Sie müssen ein Handle für die Script-Funktion angeben, um auf das Element zugreifen zu können. Verwenden Sie eine Script-Funktion, die die Position innerhalb des XML-Dokuments übernimmt, um das Handle bereitzustellen. Im Folgenden finden Sie Beispiele für Script-Elemente, die Sie für diesen Zweck verwenden können:

• XML_GET_FIRST_CHILD
• XML_GET_NEXTSIBLING
• XML_SELECT_NODE

Tipps:

• Die Informationen werden in eine Zeile ohne Zeilenumbrüche in die angegebene Datei geschrieben. Wird diese Datei mit einem Texteditor, beispielsweise Notepad, geöffnet, ist die Darstellung unübersichtlich. XML_BEAUTIFY kann vor der Script-Funktion verwendet werden, um den Inhalt der Datei zu formatieren und somit besser lesbar darzustellen. Weitere Informationen finden Sie unter XML_BEAUTIFY. Sie können auch den Microsoft Internet Explorer verwenden, um die Datei anzuzeigen, wo die Struktur des Elements klarer dargestellt wird.
• Verwenden Sie die von XML_OPEN zurückgegebene Referenz, um die gesamte Struktur zu schreiben. Weitere Informationen finden Sie unter XML_OPEN.

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: