FileDownload

FileDownload dient dazu, Dateien vom Server auf den Client zu laden. Die Eigenschaft data bestimmt die Datenquelle im View-Context. Die Eigenschaft target bestimmt die ID des Zielfensters im Browser.

Der Zugriff auf die Daten eines FileDownload-UI-Elements findet statt, wenn der Benutzer einen Request auf eine bestimmte Datei absetzt, d.h. wenn der Benutzer auf den Link klickt. Dieses Zugriffsverfahren ermöglicht insbesondere die Verarbeitung großer Datenmengen.

Für dieses Zugriffsverfahren muss die Eigenschaft FileDownload.data an einen Context-Knoten gebunden sein, der folgende Kriterien erfüllt:

Er besitzt eine Supply-Funktion
Er besitzt lediglich ein Attribut mit den Daten vom Typ XSTRING

Dadurch wird sichergestellt, dass die Supply-Funktion erst dann aufgerufen wird, wenn der Benutzer die Daten anfordert. Um sie in einer Tabelle zu verwenden, benötigen Sie solch einen Knoten innerhalb Ihres Table.dataSource Knotens.

Achtung

Achten Sie darauf, dass es sich dabei nicht um einen Singleton handelt, denn sonst können in Ihrer Applikation Kurzdumps auftreten.

Um unnötige Daten im Context zu vermeiden, wird der FileDownload-Knoten nach dem Download invalidiert. Dies geschieht jedoch nur, wenn der Knoten nicht vor dem Download bereitgestellt wurde. Somit können keine Daten verloren gehen.

Informationen über die Möglichkeit eines Datei-Download ohne den Einsatz des UI-Elements FileDownload erhalten Sie unterDatei-Export.

Hinweis

Um die Entwicklungbarrierefreier Anwendungen zu ermöglichen, wird im Rahmen des Syntaxchecks die Eigenschaft tooltip überprüft, wenn die Eigenschaften text und label nicht gesetzt wurden.

Ein gesetzter Tooltip ist bei diesem Oberflächenelement sonst nicht zwingend erforderlich, könnte aber - wenn er detaillierte semantische Informationen enthält - durchaus Sinn machen.

Laufzeit-Klasse

CL_WD_FILE_DOWNLOAD

Eigenschaften im View Designer

Name	Typ	Anfangswert	Bindbar
id	STRING	(automatisch)	nein
activateAccessKey	WDY_BOOLEAN	false	nein
behaviour	WDUI_FILE_DOWNLOAD_BHVR	auto	ja
contextMenuBehaviour	WDUI_CONTEXT_MENU_BEHAVIOUR	inherit	nein
contextMenuId	WDY_MD_UI_ELEMENT_REFERENCE		nein
data	XSTRING		ja
design	WDUI_LINK_DESIGN	standard	ja
enabled	WDY_BOOLEAN	true	ja
fileName	STRING		ja
imageFirst	WDY_BOOLEAN	true	ja
imageHeight	STRING		ja
imageSource	STRING		ja
imageWidth	STRING		ja
mimeType	STRING		ja
styleClassName	STRING		ja
target	STRING		ja
text	Übersetzbarer Text		ja
textDirection	WDUI_TEXT_DIRECTION	inherit	ja
tooltip	Übersetzbarer Text		ja
type	WDUI_LINK_TYPE	navigation	ja
visible	WDUI_VISIBILITY	visible	ja
wrapping	WDY_BOOLEAN	false	ja

Hinweis

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

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
activateAccessKey	ACTIVATE_ACCESS_KEY	WDY_BOOLEAN
behaviour	BEHAVIOUR	WDUI_FILE_DOWNLOAD_BHVR
behaviour: allowSave	CL_WD_FILE_DOWNLOAD=>E_BEHAVIOUR-ALLOW_SAVE
behaviour: auto	CL_WD_FILE_DOWNLOAD=>E_BEHAVIOUR-AUTO
behaviour: openInplace	CL_WD_FILE_DOWNLOAD=>E_BEHAVIOUR-OPEN_INPLACE
contextMenuBehaviour	CONTEXT_MENU_BEHAVIOUR	WDUI_CONTEXT_MENU_BEHAVIOUR
contextMenuBehaviour: inherit	CL_WD_FILE_DOWNLOAD=>E_CONTEXT_MENU_BEHAVIOUR-INHERIT
contextMenuBehaviour: provide	CL_WD_FILE_DOWNLOAD=>E_CONTEXT_MENU_BEHAVIOUR-PROVIDE
contextMenuBehaviour: suppress	CL_WD_FILE_DOWNLOAD=>E_CONTEXT_MENU_BEHAVIOUR-SUPPRESS
contextMenuId	CONTEXT_MENU_ID	WDY_MD_UI_ELEMENT_REFERENCE
data	DATA	XSTRING
design	DESIGN	WDUI_LINK_DESIGN
design: emphasized	CL_WD_FILE_DOWNLOAD=>E_DESIGN-EMPHASIZED
design: standard	CL_WD_FILE_DOWNLOAD=>E_DESIGN-STANDARD
enabled	ENABLED	WDY_BOOLEAN
fileName	FILE_NAME	STRING
imageFirst	IMAGE_FIRST	WDY_BOOLEAN
imageHeight	IMAGE_HEIGHT	STRING
imageSource	IMAGE_SOURCE	STRING
imageWidth	IMAGE_WIDTH	STRING
mimeType	MIME_TYPE	STRING
styleClassName	STYLE_CLASS_NAME	STRING
target	TARGET	STRING
text	TEXT	WDY_MD_TRANSLATABLE_TEXT
textDirection	TEXT_DIRECTION	WDUI_TEXT_DIRECTION
textDirection: inherit	CL_WD_FILE_DOWNLOAD=>E_TEXT_DIRECTION-INHERIT
textDirection: ltr	CL_WD_FILE_DOWNLOAD=>E_TEXT_DIRECTION-LTR
textDirection: rtl	CL_WD_FILE_DOWNLOAD=>E_TEXT_DIRECTION-RTL
tooltip	TOOLTIP	WDY_MD_TRANSLATABLE_TEXT
type	TYPE	WDUI_LINK_TYPE
type: function	CL_WD_FILE_DOWNLOAD=>E_TYPE-FUNCTION
type: navigation	CL_WD_FILE_DOWNLOAD=>E_TYPE-NAVIGATION
type: reporting	CL_WD_FILE_DOWNLOAD=>E_TYPE-REPORTING
type: result	CL_WD_FILE_DOWNLOAD=>E_TYPE-RESULT
visible	VISIBLE	WDUI_VISIBILITY
visible: none	CL_WD_FILE_DOWNLOAD=>E_VISIBLE-NONE
visible: visible	CL_WD_FILE_DOWNLOAD=>E_VISIBLE-VISIBLE
wrapping	WRAPPING	WDY_BOOLEAN

Beispielcoding zur Ermittlung eines MIME-Types aus einer Dateinamenserweiterung

data file type string.

data dot_offset type i.

data extension type mimetypes-extension.

data mimetype type mimetypes-type.

file = 'Image.jpg'.

" Find out file name extension

find first occurrence of regex '\.[^\.]+$' in file match offset dot_offset.

add 1 to dot_offset.

extension = file+dot_offset.

" Get mime type

call function 'SDOK_MIMETYPE_GET'

exporting

extension = extension

importing

mimetype = mimetype.

Beispiel

Beispiele für dieses Oberflächenelement finden Sie im System in der Web-Dynpro-Applikation WDR_TEST_UI_ELEMENTS sowie in der Component WDR_TEST_EVENTS in der View FileDownload.