OfficeControl 

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

●      Microsoft-Word-Dokumente mit der Erweiterung doc

●      Microsoft-Excel-Dokument mit der Erweiterung xls

●      Microsoft-Project-Dokumente mit der Erweiterung mpp

Bei dem Importieren bzw. Exportieren von MS-Project-Dokumenten (IF_IOS_PROJECT~EXPORT_XML und IF_IOS_PROJECT~IMPORT_XML) wird aus Sicherheitsgründen eine Whitelist ausgewertet. Dazu wird im Interface IF_IOS_PROJECT~SET_WHITELIST auf den Namen der Whitelist referenziert. Es handelt sich dabei um dieselbe Whitelist wie für AcfUpDownload. Beachten Sie, dass bei der MS Project Integration aus Sicherheitsgründen Kürzel wie $HOME nicht unterstützt werden.

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.

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

Voraussetzungen

●      Installation von Microsoft Office.
Weitere Informationen über die von SAP unterstützten Office-Versionen finden Sie in Hinweis 892638.

●      ActiveX sollte im Browser eingeschaltet sein

Details

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

●      Öffnen

●      Schließen

●      Sichern

●      Anlegen neuer Dokumente

Beachten Sie, dass Öffnen und Schließen eines Dokuments ausschließlich über ein Setzen der Eigenschaft visible des OfficeControl-Oberflächenelements auf visible beziehungsweise none möglich ist.

Beachten Sie zusätzlich, 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.

Beispiele für die visuelle Darstellung:

 

Laufzeit-Klasse

CL_WD_OFFICE_CONTROL

 

Eigenschaften im View Designer

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
showDecoration	WDY_BOOLEAN	true	ja
tooltip	Übersetzbarer Text		ja
type	STRING		nein
visible	WDUI_VISIBILITY	visible	ja
width	STRING	300px	ja

 

Events im View Designer

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:

●        AbstractActiveComponent

●        UIElement

●        ContextMenuProvider

●        ViewElement

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.

Dynamische Programmierung der Eigenschaften

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
showDecoration	SHOW_DECORATION	WDY_BOOLEAN
tooltip	TOOLTIP	WDY_MD_TRANSLATABLE_TEXT
type	TYPE	STRING
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

 

Dynamische Programmierung der Ereignisse

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.