A file manager is used to upload and/or download files.
A file manager must be placed inside a data view connected to the entity that is either a System.FileDocument (or a specialization) or an external entity with a
Contents binary attribute.
For an external entity to be used as a file source, it must be defined as a media element in the corresponding OData service. Such an element can be recognized by setting the
HasStream attribute to
true in its metadata.
When uploading a file through the file manager, the FileDocument object will be committed immediately.
An example of file manager properties is represented in the image below:
File manager properties consist of the following sections:
2.1 Common Section
For more information on properties in this section, see the Common Section section in Properties Common in the Page Editor.
2.2 Design Properties Section
The Design Properties allow you to change spacing and alignment of the widget and hide it on phone, tablet, or desktop, if needed. Design properties may vary depending on the type of the widget. For example, for the text widget you can change its font weight, color, alignment, and letter case.
2.3 Editability Section
Editability determines whether an end-user can change the value in an input widget.
For more information on properties of this section, see the Editability Section section of Properties Common in the Page Editor.
2.4 General Section
The Type property indicates how the end-user will be able to use the file manager.
|Upload||The file manager can only be used to upload a file.|
|Download||The file manager can only be used to download a file.|
|Both (default)||The file manager can be used to both upload and download a file.|
2.4.2 Max File Size (MB)
Max file size (MB) determines the maximum size of files (in megabytes) that can be uploaded.
This value cannot be set arbitrarily high as the platform to which the app is deployed may also impose a limitation on the size of the files that can be uploaded or downloaded.
2.4.3 Allowed Extensions
You can specify file extensions that users are allowed to upload. If no extension is specified, all file extensions are allowed. Separate multiple extensions by a semi-colon, for example,
If a file with an extension that is not allowed is selected, a system text for File manager/dynamic image > Error: incorrect file extension will be shown below the file manager.
2.4.4 Show File in Browser
Show file in browser indicates whether a file will be shown in the browser instead of being downloaded.
2.5 Label Section
A label describes the purpose of a widget to the end-user.
For more information on properties of this section, see the Label Section section in Properties Common in the Page Editor.
2.6 Visibility Section
Visibility determines whether a widget is displayed to the end-user as part of the page.
For more information on properties of this section, see the Visibility Section section in Properties Common in the Page Editor.