XML_PRINTINTOFILE

Verwenden Sie die Script-Funktion XML_PRINTINTOFILE, um die Struktur eines Elements mit allen Unterelementen und zugehörigen Attributen in eine angegebene XML-Datei zu schreiben.

Wichtig! Vorhandene Dateien werden ohne Nachfrage überschrieben.

Tipps:

• Die Informationen werden in eine Zeile ohne Zeilenumbrüche in die angegebene Datei geschrieben. Wird diese Datei mit einem Text-Editor, 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.
• Sie können den von XML_OPEN zurückgegebenen Verweis verwenden, um die Darstellung des gesamten XML-Dokuments vorzubereiten und zu formatieren. Weitere Informationen finden Sie unter XML_OPEN.

Syntax

XML_PRINTINTOFILE (Datei, Referenz)

Script-Funktion und Parameter

• XML_PRINTINTOFILE
  Schreibt die Struktur von Elementen in eine XML-Datei.

• 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
  Hinweis: Sie müssen der Script-Funktion einen Verweis oder ein Handle bereitstellen, damit sie auf das Element zugreifen kann. 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

Rückgabewert

• 0
  Die Struktur wurde erfolgreich in die Datei geschrieben.

Beispiel

Das folgende Beispiel bearbeitet die vollständige Struktur der Dokumentation, um einfacheres Lesen zu ermöglichen. Dann werden die Informationen in die Datei Docu.xml geschrieben.

: 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 zeigt, wie Sie die Elemente "Description" und "Objects" zusammen mit ihren Attributen in einer Datei ausgeben können.

: SET  &XMLDOCU# = XML_OPEN (DOCU, "ON_CALL_SERVICES" , "@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: