Development tools : XUI editor : XUI widgets and containers : Widget descriptions : FileUpload
  
FileUpload
The FileUpload widget provides the ability to select and upload files to the server-side. It is a composite widget, which means that it consists of a collection of widgets.
Implementation base
The FileUpload widget is a Dojo-based widget. The following widgets are combined to form the FileUpload widget:
com.ibm.btt.dojox.form.FileUploader
com.ibm.btt.dijit.form.TextBox
com.ibm.btt.dijit.form.Button
Properties for the FileUpload widget
 
Property
Description
id
The identifier for the widget.
dataName
The dataName property is the name of the data element to which the widget is bound. This property is mandatory.
fileExtension
The fileExtension property specifies the file name extensions that can be submitted by the FileUpload widget to the server-side.
isMandatory
The isMandatory property specifies whether a user is required to select and upload files to the server-side by using the FileUpload widget.
visibility
The visibility property defines how a widget is displayed on a GUI. The following values can be specified for this property:
visible
The widget is displayed on a GUI and users are able to interact with the widget.
hidden
The widget is not displayed on a GUI, but it occupies space on the GUI.
gone
The widget is not displayed on a GUI, and it does not occupy space on the GUI.
disabled
Disabled elements cannot have focus; do not receive or fire mouse events; and cannot receive user input. If you set this property to true, the widget is displayed on a GUI, but a user cannot interact with it. Data contained in a disabled widget is not processed when the form is submitted. The default value is false.
hint
A description of the widget that is displayed as a tooltip for a user. This property has multilingual support.
styleClass
The styleClass property specifies the name of the CSS style ( also known as CSS style class) associated with the widget. This property is set by selecting a style from the CSS styles table in the Style tab of the Properties view. If you do not configure the styleClass property, the default style is used instead. For more detailed information, refer to Setting CSS style to widgets.
width
The width property specifies the width of the widget. This property is set in the Appearance tab of the Properties view.
Data binding
In a UDTT context on the server-side, the mapped data of the FileUpload widget is defined in a special format. The following code block is a sample definition of mapped data for the FileUpload widget:
<KColl id="file">
  <field id="name" />
  <field id="size" />
  <field id="fileId"/>
</KColl>

<KColl id="fileupload" />
  <refData refId="file" />
  <IColl id="receivedFiels">
    <refData refId="file" />
  </IColl>
  <field id="handler" />
</KColl>
For more information about data mapping, see Binding data to a fileUpload widget.
See
ECA editor support
Go up to
Widget descriptions