OfficeControl

Verwendung

Mit dem OfficeControl-Oberflächenelement können Sie ein Office-Dokument in eine View einfügen (siehe auch Office-Integration). Sie haben damit die Möglichkeit, die folgenden Office-Dokumente innerhalb einer Web-Dynpro-Anwendung anzuzeigen:

Microsoft Word
Microsoft Excel
Microsoft Project
Microsoft Powerpoint (*.ppt und *.pptx)

Das OfficeControl wird als aktives UI-Element (ActiveX-Steuerelement) zur Verfügung gestellt, so dass das Oberflächenelement von Browsern dargestellt werden kann, die ActiveX-Controls unterstützen.

Beim Einsatz von Microsoft Office und Browsern, die ActiveX-Controls nicht unterstützen, erhält der Benutzer die Laufzeit-Exception Office Integration through Applet is not supported.

Achtung

Die Integration von aktiven Controls wie OfficeControl in Web-Dynpro-ABAP-Dialogfenster (Popups) ist nicht unterstützt.

Implementierungsdetails

Die Implementierung des OfficeControl-Oberflächenelements unterstützt für die genannten Office-Dokumente die folgenden Funktionen:

Öffnen
Schließen
Sichern
Anlegen neuer Dokumente

Hinweis

Das Öffnen und Schließen eines Dokuments ist ausschließlich über ein Setzen der Eigenschaft OfficeControl.visible auf visible beziehungsweise none sowie OfficeControl.expertMode=false möglich. Hierbei handelt es sich um ein reines Anzeige-Szenario ( OfficeControl.expertMode=false), das sich insbesondere für Prototyping anbietet. Beachten Sie, dass es bei derartigen Szenarios eventuell zu Performance-Engpässen kommen kann.

Ein Bearbeiten von Dokumenten ist nur bei OfficeControl.expertMode=true möglich

Beachten Sie, dass das OfficeControl nur beim Setzen der Eigenschaft visible auf visible aktiv ist. Eine Hintergrundverarbeitung erfolgt bei visible, und width, height = 0.

Im expertMode stehen zusätzlich Methoden-Aufrufe für komplexe Operationen zur Verfügung.

Beispiel für die visuelle Darstellung

(Siehe Web-Dynpro-Anwendung IOS_TEST_EXCEL im System)

Laufzeit-Klasse

CL_WD_OFFICE_CONTROL

Name	Typ	Anfangswert	Bindbar
id	STRING	(automatisch)	nein
activateInPlace	WDY_BOOLEAN	true	ja
additionalArchives	STRING		nein
archive	STRING		nein
classId	STRING		nein
codeBase	STRING		nein
contextMenuBehaviour	WDUI_CONTEXT_MENU_BEHAVIOUR	inherit	nein
contextMenuId	WDY_MD_UI_ELEMENT_REFERENCE		nein
controlId	STRING		nein
dataSource	XSTRING		ja
documentName	STRING		ja
documentType	WDUI_OFFICE_DOC_TYPE	ms_word	ja
enabled	WDY_BOOLEAN	true	ja
enableReadWrite	WDY_BOOLEAN	true	ja
expertMode	WDY_BOOLEAN	false	ja
height	STRING	300px	ja
lifeTime	WDUI_LIFE_TIME	whenVisible	ja
showDecoration	WDY_BOOLEAN	true	ja
styleClassName	STRING		ja
tooltip	Übersetzbarer Text		ja
type	STRING		nein
virusScanProfile	VSCAN_PROFILE		ja
visible	WDUI_VISIBILITY	visible	ja
width	STRING	300px	ja

Name
onClose
onError
onSave

Weitere Eigenschaften, die über Vererbung zur Verfügung stehen, sind in den dazugehörigen übergeordneten Klassen definiert. Die dazugehörigen Oberflächenelemente sind:

Dynamische Programmierung

Für die dynamische Programmierung stehen dieselben Eigenschaften, Ereignisse und Aggregationen zur Verfügung wie im View Designer. Beachten Sie dabei die unterschiedlichen Schreibweisen.

View Designer Name	Laufzeitname	Typ
activateInPlace	ACTIVATE_IN_PLACE	WDY_BOOLEAN
additionalArchives	ADDITIONAL_ARCHIVES	STRING
archive	ARCHIVE	STRING
classId	CLASS_ID	STRING
codeBase	CODE_BASE	STRING
contextMenuBehaviour	CONTEXT_MENU_BEHAVIOUR	WDUI_CONTEXT_MENU_BEHAVIOUR
contextMenuBehaviour: inherit	CL_WD_OFFICE_CONTROL=>E_CONTEXT_MENU_BEHAVIOUR-INHERIT
contextMenuBehaviour: provide	CL_WD_OFFICE_CONTROL=>E_CONTEXT_MENU_BEHAVIOUR-PROVIDE
contextMenuBehaviour: suppress	CL_WD_OFFICE_CONTROL=>E_CONTEXT_MENU_BEHAVIOUR-SUPPRESS
contextMenuId	CONTEXT_MENU_ID	WDY_MD_UI_ELEMENT_REFERENCE
controlId	CONTROL_ID	STRING
dataSource	DATA_SOURCE	XSTRING
documentName	DOCUMENT_NAME	STRING
documentType	DOCUMENT_TYPE	WDUI_OFFICE_DOC_TYPE
documentType: ms_excel	CL_WD_OFFICE_CONTROL=>E_DOCUMENT_TYPE-MS_EXCEL
documentType: ms_word	CL_WD_OFFICE_CONTROL=>E_DOCUMENT_TYPE-MS_WORD
documentType: ms_project	CL_WD_OFFICE_CONTROL=>E_DOCUMENT_TYPE-MS_PROJECT
enabled	ENABLED	WDY_BOOLEAN
enableReadWrite	ENABLE_READ_WRITE	WDY_BOOLEAN
expertMode	EXPERT_MODE	WDY_BOOLEAN
height	HEIGHT	STRING
lifeTime	LIFE_TIME	WDUI_LIFE_TIME
lifeTime: whenAlive	CL_WD_OFFICE_CONTROL=>E_LIFE_TIME-WHEN_ALIVE
lifeTime: whenVisible	CL_WD_OFFICE_CONTROL=>E_LIFE_TIME-WHEN_VISIBLE
showDecoration	SHOW_DECORATION	WDY_BOOLEAN
styleClassName	STYLE_CLASS_NAME	STRING
tooltip	TOOLTIP	WDY_MD_TRANSLATABLE_TEXT
type	TYPE	STRING
virusScanProfile	VIRUS_SCAN_PROFILE	VSCAN_PROFILE
visible	VISIBLE	WDUI_VISIBILITY
visible: none	CL_WD_OFFICE_CONTROL=>E_VISIBLE-NONE
visible: visible	CL_WD_OFFICE_CONTROL=>E_VISIBLE-VISIBLE
width	WIDTH	STRING

View Designer Name	Laufzeitname
onClose	ON_CLOSE
onError	ON_ERROR
onSave	ON_SAVE

Beispiel

Beispiele für dieses Oberflächenelement finden Sie im System im Paket SIOS.