XML_BEAUTIFY

Verwenden Sie die Script-Funktion XML_BEAUTIFY, um ein XML-Dokument besser lesbar zu machen, indem Sie Struktur und Formatierung hinzufügen. Ohne diese Script-Funktion werden alle Informationen über das XML-Dokument unformatiert und in einer einzigen Zeile ohne Zeilenumbruch in eine Datei geschrieben. Wenn Sie eine solche Datei mit einem Text-Editor wie Notepad öffnen, werden unlesbare Informationen angezeigt. Diese Script-Funktion erfordert einen Verweis, um auf ein Element der zugehörigen XML-Dokumentation zuzugreifen. Wenn Sie XML_BEAUTIFY mit anderen XML-Script-Funktionen verwenden, strukturiert sie das Element, einschließlich der zugehörigen Unterelemente und Attribute.

Tipp: XML_BEAUTIFY verschönert das XML-Dokument, bevor es mit XML_PRINTINTOFILE in eine XML-Datei geschrieben wird. Weitere Informationen finden Sie unter XML_PRINTINTOFILE.

Syntax

XML_BEAUTIFY (Referenz)

Script-Funktion und Parameter

• XML_BEAUTIFY
  Strukturiert und formatiert ein XML-Dokument.

• Referenz
  Verweis auf das XML-Dokument, dessen Struktur Sie formatieren möchten
  Format: Script-Literal oder Script-Variable
  Tipps:

  • 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.
  • Sie können XML_BEAUTIFY auch zusammen mit einer Script-Funktion verwenden, die innerhalb des XML-Dokuments platziert ist, um eine Referenz (Handle) abzurufen. 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ückgabewerte

• 0
  Der Inhalt des XML-Dokuments wurde erfolgreich verschönert.

Beispiele

Das folgende Beispiel bearbeitet die vollständige Struktur der XML-Dokumentation, um problemloses Lesen zu ermöglichen, und schreibt dann das Ergebnis in die Datei Docu.xml.

Hinweis: Damit das Beispiel funktioniert, benötigt das Objekt, das Sie mit XML_OPEN verwenden, eine strukturierte Dokumentationsseite namens "@Details". Fügen Sie sie dem zugehörigen Objekt in der Variablen UC_OBJECT_DOCU hinzu. Weitere Informationen finden Sie unter UC_OBJECT_DOCU - Objektdokumentation.

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

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

: XML_CLOSE

Das folgende Beispiel schreibt die Elemente Description und Objects samt ihren Attributen in eine Datei.

: 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: