ABAPCREATE_OBJECT_OLE2 - CREATE OBJECT OLE2

BAL_S_LOG - Application Log: Log header data   ABAP Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.

CREATE OBJECT - OLE

Kurzreferenz

Syntax

CREATE OBJECT ole class [NO FLUSH] [QUEUE-ONLY].

Zusätze:

1. ... NO FLUSH

2. ... QUEUE-ONLY

Wirkung

Diese Anweisung erzeugt das Automation-Objekt ole der Automation-Klasse class. Das Objekt ole muss den Typ ole2_object haben, der im ABAP Dictionary in derTypgruppeOLE2 definiert ist. Für die Angabe der Automation-Klasse class wird ein zeichenartiges Datenobjekt erwartet, das den Namen der Klasse enthält.

Das System führt automatisch eine Berechtigungsprüfung durch, wenn die Spalte AUTH_CHK der DatenbanktabelleTOLE für die Klasse den Wert "X" enthält. Das Vorliegen der Berechtigung kann mit dem FunktionsbausteinAUTHORITY_CHECK_OLE geprüft werden.

Hinweis

Bei der Deklaration von ole muss genau der Typ ole2_object angegeben werden. Es genügt nicht, einen anderen Typ anzugeben, der mit Bezug auf ole2_object deklariert wurde.

Systemfelder

sy-subrc	Bedeutung
0	Automation-Objekt wurde erzeugt.
1	Fehlerhafte Kommunikation zum SAP GUI.
2	Fehlerhafter Funktionsaufruf im SAP GUI.
3	Probleme bei der Speicherbelegung auf dem Präsentationsserver.

Hinweis

Ein durch CREATE OBJECT ole erzeugtes Automation-Objekt ole muss auch stets durch FREEOBJECT ole freigegeben werden, um Speicherengpässe und Abbrüche der zu steuernden Anwendung zu vermeiden.

Zusatz 1

... NO FLUSH

Wirkung

Der Zusatz NO FLUSH bewirkt, dass die Anforderung bis zum Aufruf des dafür vorgesehenen Funktionsbausteins FLUSH, bis zur Übergabe der Anweisung FREE OBJECT, längstens aber bis zu einem Wechsel desBildschirmbildsim Automation-Puffer gesammelt und erst dann zur asynchronen Ausführung an den Automation-Serverauf dem aktuellen Präsentationsserver übergeben wird. Ohne diesen Zusatz erfolgt der Flushund damit die Übertragung bereits bei Erreichen einer Anweisung, die nicht zum Automation-Befehlssatzgehört. Im ABAP Debugger ist zu beachten, dass die Rückgabewerte der einzelnen Automation-Anweisungen erst nach der Übertragung zur Präsentationsschicht verfügbar sind.

Zusatz 2

... QUEUE-ONLY

Wirkung

Der Zusatz QUEUE-ONLY bewirkt, dass das erzeugte Objekt bei einem Flush nicht als Rückgabewertvon mit CALL METHOD OF aufgerufenen Methoden in das angegebene ABAP-Datenobjekt rc geschriebenwird. Voraussetzung ist, dass der Automation-Puffer ausschließlich Anweisungen CREATE OBJECT,CALL METHOD und GET PROPERTY mit dem Zusatz QUEUE-ONLY enthält. Bei derProgrammausführung im ABAP Debugger werden die Rückgabewerte standardmäßig immer übergeben.

Beispiel

In diesem Beispiel wird das Automation-Objekt app erzeugt, das auf alle Methoden und Eigenschaftender Klasse APPLICATION in der MS-Excel-Bibliothek Zugriff hat. Diese Klasse enthält Methoden, mit denen zum Beispiel ein Excel-Dokument geöffnet oder kopiert werden kann.

DATA app TYPE ole2_object.

CREATE OBJECT app 'Excel.Application' NO FLUSH.

TXBHW - Original Tax Base Amount in Local Currency   Vendor Master (General Section)  
Diese Dokumentation steht unter dem Copyright der SAP AG.


Length: 4941 Date: 20120526 Time: 193825     triton ( 155 ms )