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 im Binärformat von Microsoft mit der Erweiterung doc.
Wenn Sie Microsoft Office 2007 installiert haben, werden auch die XML-basierten Dateinamenserweiterungen docx und docm unterstützt.
Microsoft-Excel-Dokumente im Binärformat von Microsoft mit der Erweiterung xls.
Wenn Sie Microsoft Office 2007 installiert haben, werden auch die XML-basierten Dateinamenserweiterungen xlsx und xlsm unterstützt.
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.

Achtung Achtung

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

Ende der Warnung.

Weitere Informationen: Office-Integration

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 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.

Ende des Hinweises.

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

Beispiel für die visuelle Darstellung

(IOS_TEST_EXCEL)

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

Ereignisse 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:

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`
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`
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.