Allow download

Displays a download button to the user when a file is selected.

Clicking the download button will download the file directly.

►NOTE◄ If the 'content' field of the element data is empty/null and the 'remoteFilePath' field contains a valid server file path (relative to the Lobster Data Platform / Orchestration upload directory), the user additionally needs the right to read files (Administration/System/File manager/Read).

Grow for drag & drop

Enables/disables automatic 'growing' of the file component when a file is dragged over it.

File/Pen switch allowed

Allows the user to switch to the 'pen pad' display type,
to directly capture a drawing or signature (see Darstellungstyp "Zeichenfläche").
To switch, a separate button is displayed for this purpose.

Show border

Only active if the 'File/Pen switch allowed' option is enabled.
Defines whether the pen pad should be displayed with a frame.

Default file name

Specifies the name of the file, if this cannot be determined.
For example, when capturing a signature or if no file name is given (e.g. when loading a file from the form data).

A calculation expression can also be stored here.

Type filter

An optional comma-separated list of MIME types, which are set as file type filters in the browser's file selection dialog.
The MIME types are standardized and can be easily found by a short internet search.

An example of a filter which should filter common image file formats and PDF files:
'image/jpeg, image/png, application/pdf'

Tip: The MIME type of a certain file can also be found out by uploading it via the file element (with data field!) in the test mode of the editor.
Afterwards, the file type can be viewed via the ribbon function 'Structure Export'.

Upload mode

The Upload mode defines how the selected files should be uploaded.

• BASE64
  The file is written completely locally as ByteArray in the form data and encoded for processing as text (e.g. Lobster_data node) as BASE64 string.
  Advantages:
  - The file can be processed directly
  Disadvantages:
  - Large files can exhaust the available memory of the browser or application, causing the application to crash
  - No possibility to display a progress bar. The process blocks the application until the data has been transferred

• SERVER_UPLOAD (not usable in connection with the 'pen pad').
  The file is either transferred directly to the target directory on the server (relative to the configured upload directory of Lobster Data Platform / Orchestration) or written to the temporary directory of Lobster_data with an automatically generated file name. Depending on the variant used, either the file path used as the destination (remoteFilePath) or the generated name of the temporary file (tempFileName) is available in the element's form data after uploading.
  Advantages:
  - Large files can be uploaded without consuming the client's memory
  - The user is shown the progress of the upload process. In addition, the process can even be canceled
  Disadvantages:
  - Files cannot be processed or displayed directly, but must first be read or otherwise stored on the server side
  - Without specifying a target directory, uploaded content cannot be displayed directly in the form (keyword: preview)

►NOTE◄ To process a temporarily uploaded file, Lobster_data provides the Lobster_pro: resolve temporary uploaded file path (_data function), which uses the name of the temporary file tempFileName to determine the relative path to this file.

Always replace existing files

This setting option is only available if "SERVER_UPLOAD" has been selected as the upload mode.

Disables/enables the user query in case an uploaded file already exists in the target directory.

Target directory on the server

This setting option is only available if 'SERVER_UPLOAD' has been selected as the upload mode and specifies the target directory on the server relative to the configured upload directory of Lobster Data Platform / Orchestration as calculation expression.
►NOTE◄ The upload directory can be managed in the file manager.

content

The selected file as byte array (As text base also Base64 encoded) or empty, if SERVER_UPLOAD was selected as upload mode.

name

The name of the file.

remoteFilePath

Contains the file path on the server that can be reached by the client (only for SERVER_UPLOAD with defined target directory, otherwise null).

tempFileName

Contains the name of a temporarily uploaded file (only for SERVER_UPLOAD without defined destination directory, otherwise null).

size

The size of the file in bytes.

creationDate

The creation time of the file as UNIX timestamp in milliseconds.

creator

The creator of the file (optional).

modificationDate

The time of the last file change as UNIX timestamp in milliseconds.

type

The type of the file (e.g. 'image/png', 'application/pdf', ...).

downloadUrl

If no content and no remoteFilePath is set, this url – if filled – will be used for the download.