Kontakt

Ansicht
Dokumentation

ABAPCREATE_OBJECT_OLE2 - CREATE OBJECT OLE2

ABAPCREATE_OBJECT_OLE2 - CREATE OBJECT OLE2

General Material Data   rdisp/max_wprun_time - Maximum work process run time  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

CREATE OBJECT, OLE

Kurzreferenz



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 der Typgruppe OLE2 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 DDIC-Datenbanktabelle TOLE für die Klasse den Wert "X" enthält. Das Vorliegen der Berechtigung kann mit dem Funktionsbaustein AUTHORITY_CHECK_OLE geprüft werden.

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 in der Präsentationsschicht.

Hinweise

  • 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.
  • Ein durch CREATE OBJECT ole erzeugtes Automation-Objekt ole muss auch stets durch FREE OBJECT ole freigegeben werden, um Speicherengpässe und Abbrüche der zu steuernden Anwendung zu vermeiden.
  • CREATE OBJECT für OLE darf nicht mit der gleich lautenden Anweisung in ABAP Objects verwechselt werden.

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 des Bildschirmbilds gesammelt und erst dann zur asynchronen Ausführung an den Automation-Server in der Präsentationsschicht übergeben wird. Ohne diesen Zusatz erfolgt der Flush und damit die Übertragung bereits bei Erreichen einer Anweisung, die nicht zum Automation-Befehlssatz gehört. Im ABAP Debugger ist zu beachten, dass die Rückgabewerte der einzelnen Automation-Anweisungen erst nach der Übertragung zum Präsentationsserver verfügbar sind.

Zusatz 2

... QUEUE-ONLY

Wirkung

Der Zusatz QUEUE-ONLY bewirkt, dass das erzeugte Objekt bei einem Flush nicht als Rückgabewert von mit CALL METHOD OF aufgerufenen Methoden in das angegebene ABAP-Datenobjekt rc geschrieben wird. Voraussetzung ist, dass der Automation-Puffer ausschließlich Anweisungen CREATE OBJECT, CALL METHOD und GET PROPERTY mit dem Zusatz QUEUE-ONLY enthält. Bei der Programmausfü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 Eigenschaften der 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.






PERFORM Short Reference   General Data in Customer Master  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 5217 Date: 20240425 Time: 120007     sap01-206 ( 74 ms )