Arbeiten mit Dokumenten

Prozess

Voraussetzungen

Bevor Sie die folgenden Schritte ausführen, müssen Sie die zentrale Instanz control für die Verwaltung der Desktop-Office-Anbindung anlegen. Lesen Sie dazu Instanz zur Verwaltung der Desktop Office-Integration.

Ein Überblick über den Ablauf der Dokumentbearbeitung finden sie in folgender Grafik.

Die Abbildung wird im Begleittext erläutert.

Prozessfluss

Deklaration
Deklarieren Sie eine Instanz mit Referenz auf das Interface i_oi_document_proxy:

DATA: document TYPE REF TO I_OI_DOCUMENT_PROXY.
Initialisierung
Erzeugen Sie die Instanz für das Dokument mit der Methode get_document_proxy auf der zentralen Instanz für die Verwaltung der Desktop Office-Anbindung control.
Ordnen Sie den Ereignissen, die beim Dokument ausgelöst werden können , eine Behandlungsmethode in Ihrem Anwendungsprogramm zu.
Öffnen Sie ein Dokument. Bestehende Dokumente werden mit den Methoden open_document (Änderungsmodus), view_document (Anzeigemodus für Metadaten) bzw. play_document (abspielen eines Dokuments) geöffnet. Neue Dokumente erstellen Sie mit der Methode create_document.

Bearbeitung

Verändern Sie das Dokument und speichern Sie gegebenenfalls die Änderungen. Hierfür stehen Ihnen folgende Methoden zur Verfügung:

Methoden für die Verarbeitung eines Dokuments
`Method`	Funktion
`print_document`	Drucken des Dokuments
`clear_selection`	Löschen eines markierten Bereichs
`paste_clipboard`	Einfügen des Inhalts des Clipboards
`cut_selection`	Ausschneiden eines markierten Bereichs
`paste_special`	Einfügen eines Links
`select_all`	alles markieren
`copy_selection`	Kopieren eines markierten Bereichs
`execute_macro`	Ausführen eines Makros
`save_as`	lokales Speichern (auf Präsentationsrechner)
`save_copy_as`	Speichern des Dokuments unter einem anderen Namen
`page_setup`	Seitenlayout festlegen

Ermitteln Sie Attribute der Instanz dokument mit folgenden Methoden:

Methoden zur Ermittlung der Attribute eines Dokuments
Methode	Funktion
`is_open`	Dokument ist in Office-Anwendung geöffnet
`is_destroyed`	Dokument nicht geöffnet (leerer Container)
`get_document_type`	Typ des Dokuments
`has_changed`	Dokument wurde geändert
`get_document_handle`	Handle des Dokuments bestimmen
`has_standard_interface`	Legt fest, ob das Dokument ein Standardinterface besitzt

Abbau
Schließen Sie das Dokument nach der Bearbeitung mit der Methode close_document bzw. reagieren Sie auf das Ereignis on_close_event, das beim Schließen des Dokuments durch den Benutzer der Office-Anwendung ausgelöst wird.
Speichern Sie die Änderungen an dem Dokument <document> mit der Methode save_document_to_url. Danach geben Sie den belegten Speicher mit der Methode release_document frei.

Achtung Achtung

Beim Entwickeln Ihrer Anwendung müssen Sie immer damit rechnen, dass der Benutzer die Office-Anwendung schließen kann, während das SAP-System mit anderen Vorgängen beschäftigt ist. In diesem Fall geht das Ereignis on_close_event verloren. Daher sollten Sie beim Verlassen der Transaktion immer überprüfen, ob irgendwelche Dokumente noch offen sind und ob diese sich geändert haben.

Achten Sie darauf, dass Sie die Änderungen am Dokument speichern, bevor Sie das Dokument mit der Methode release_document freigeben. Dazu müssen Sie die entsprechenden Methoden auf die Instanz document anwenden.

Ende der Warnung.

Hinweis Hinweis

Sofern Sie spezielle Methoden der Desktop Applikation nutzen wollen, werden Sie über folgende Interfaces unterstützt: Das Wordprozessor-Interface

Das Form-Interface

Die Serienbrief-Schnittstelle

Die Script-Collection

Die Tabellenschnittstelle

Ende des Hinweises

Hinweis Hinweis

Denken Sie daran, dass Sie nach jedem Methodenaufruf eine Fehlerbehandlung implementieren sollten.

Ende des Hinweises

Hinweis Hinweis

Die Bedeutung der nicht aufgeführten Parameter finden Sie in Generische Parameter.

Ende des Hinweises