XML_OPEN

Verwenden Sie die Script-Funktion XML_OPEN, um ein XML-Dokument zu Verarbeitungszwecken zu öffnen. Sie können nur ein XML-Dokument gleichzeitig öffnen. Die Quelle des XML-Dokuments kann eine strukturierte Dokumentation, der Report eines SAP-Jobs oder ein XML-String sein.

Hinweis: Verwenden Sie XML_CLOSE, um das XML-Dokument nach der Verarbeitung zu schließen. Weitere Informationen finden Sie unter :XML_CLOSE.

Syntax und Parameter

Die grundlegende Syntax dieser Script-Funktion enthält die folgenden Elemente:

XML_OPEN (DOCU, [Objektname], @Dokumentation )
XML_OPEN (REPORT, [RunID], Report )
XML_OPEN (STRING, String )

• XML_OPEN
  Öffnet ein XML-Dokument zur Verarbeitung.

• Quelle
  Quelle des XML-Dokuments
  Format: AE-Name, Script-Literal oder Script-Variable
  Zulässige Werte:

  • DOCU
    Strukturierte Dokumentation wird als Quelle verwendet.

  • REPORT
    Der Bericht eines SAP-Jobs wird als Quelle verwendet.

  • STRING
    XML in Form eines Strings wird als Quelle verwendet.

Strukturierte Dokumentation als Quelle

• Objektname
  (Optional, wenn Sie die Dokumentationsseite Ihres eigenen Objekts verwenden) Name des Objekts.
  Format: Script-Literal oder Script-Variable

• @Documentation
  Name der Dokumentationsseite mit einem vorangestellten @-Symbol. Weitere Informationen zur Erstellung strukturierter und unstrukturierter Seiten finden Sie unter Seite "Dokumentation".
  Format: Script-Literal oder Script-Variable

Report eines SAP-Jobs als Quelle

• RunID
  (Optional, wenn Sie den Report Ihres eigenen Objekts verwenden) Run-Nummer (RunID) der Aufgabe, deren Report Sie öffnen möchten
  Format: Script-Literal oder Script-Variable

• Report
  Typ von XML-Bericht

  Mehr Informationen:

  • Verständnis von Reports
  • Spezielle Reports für SAP-Jobs
  • Reports von SAP-Jobs werden als XML-Dokumente abgelegt. Für XI_GET_CHANNEL enthalten Sie eine Liste der ausgewählten Kommunikationskanäle. Weitere Informationen finden Sie unter XI_GET_CHANNEL.

XML in Form eines Strings als Quelle

• String
  String, der den XML-Code enthält
  Format: Script-Variable oder Script-Literal
  Hinweis: Ein falscher XML-String führt entweder zu einem Laufzeitfehler oder zur Rückgabe eines Rückgabewerts, den Sie mit der Script-Funktion SYS_LAST_ERR_NR lesen können. Weitere Informationen finden Sie unter SYS_LAST_ERR_NR.
  

Rückgabewert

Diese Script-Funktion gibt ein Handle oder eine Referenz auf das XML-Dokument zurück. Diese beziehen sich auf das Root-Element.

Beispiele

Das folgende Beispiel öffnet die Seite "@Details" zur weiteren Verarbeitung, eine strukturierte Dokumentationsseite des Job-Objekts MM.DAY.

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

Das folgende Beispiel öffnet ein XML-Dokument mit einem String.

:set &ref# = xml_open('STRING','<xmlstring>')
:set &ref# = sys_last_err_nr()
:if &ret > 0
:  set &txt# = sys_last_err_ins()
!   Implementieren Sie hier die Fehlerbehandlung
:endif

Siehe auch: