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.

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 unter Datei-Export.

Um die Entwicklung barrierefreier 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
behaviour	WDUI_FILE_DOWNLOAD_BHVR	auto	ja
data	XSTRING		muss
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
target	STRING	_blank	ja
text	Text		ja
textDirection	WDUI_TEXT_DIRECTION	inherit	ja
tooltip	Text		ja
type	WDUI_LINK_TYPE	navigation	ja
visible	WDUI_VISIBILITY	visible	ja
wrapping	WDY_BOOLEAN	false	ja

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

●      Link

●      AbstractCaption

●      UIElement

●      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
data	DATA	XSTRING
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
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
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.