XML_OPEN

Script-Funktion: Öffnet ein XML-Dokument für die Bearbeitung.

Syntax

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

Syntax	Beschreibung/Format
Quelle	Herkunft des XML-Dokumentes Format: AE-Name, Script-Literal oder Script-Variable Zulässige Werte: DOCU Strukturierte Dokumentation. REPORT Report eines SAP-Jobs STRING XML in Form eines Strings
Für strukturierte Dokumentationen:
Objektname	Name des Objekts. Format: Script-Literal oder Script-Variable Handelt es sich um die Registerkarte des eigenen Objekts, so ist dieser Parameter optional.
Dokumentation	Name der Dokumentations-Registerkarte mit vorangestelltem "@". Format: Script-Literal oder Script-Variable
Für Reports:
RunID	Laufende Nummer (RunID) der Aufgabe, deren Report geöffnet werden soll. Format: Script-Literal oder Script-Variable Dieser Parameter ist optional, wenn es sich um den Report des eigenen Objekts handelt.
Report	Typ des XML-Reports Weitere Informationen finden Sie unter Reports
Für Strings:
String	String, der das XML enthält. Format: Script-Variable oder Script-Literal

Rückgabewert
Verweis auf das XML-Dokument.

Die Script-Funktion öffnet ein XML-Dokument für die Bearbeitung. Sie können nur ein XML-Dokument gleichzeitig öffnen. Bei dem XML-Dokument kann es sich um eine strukturierte Dokumentation oder um den Report eines SAP-Jobs handeln.

Der Rückgabewert der Script-Funktion ist ein Handle, ein Verweis auf das XML-Dokument. Dieser Handle wird von einigen Script-Elementen, mit denen Sie das XML-Dokument bearbeiten, als Parameter verwendet.

Mehr Informationen:

• Seite "Dokumentation"
• Spezielle Reports für SAP-Jobs

Hinweise:

• 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.
• Verwenden Sie XML_CLOSE, um das XML-Dokument nach der Verarbeitung zu schließen. Weitere Informationen finden Sie unter :XML_CLOSE.

Beispiele

In diesem Beispiel wird die Registerkarte Details des Objekts "MM.DAY" zur weiteren Bearbeitung geöffnet.

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

Dieses 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

Ein fehlerhafter XML-String führt entweder zu einem Laufzeitfehler oder gibt einen Rückgabewert aus, der mit sys_last_err_err_nr() gelesen werden kann.

Siehe auch: