Breadcrumbs

File Upload

The Element File Upload

Deprecated with BPaaS 17.2: BPaaS version 17.2 introduced the form element Files Upload, which allows multiple uploads. We recommend that you only use this element.

Element Icon in Sidebar

icon_file_upload.png

Form Field

file_upload.png

Function

Form field where images and documents can be uploaded. If the user clicks on the upload button, he can select the file in the window that opens. The upload takes place when the form is saved. Uploads are stored on the server and referenced in the container. 

Default

Empty by default. If a file is selected for upload, the name of the file is displayed next to the trash icon. Clicking on the trash icon cancels the selection.

In edit mode you can prefill the field with a file. Preset files can be directly downloaded by the user during form execution via the button. After the preassignment, terminate the edit mode via the button Check.

Example

A passport photo shall be uploaded in a form:

Upload Element Without Content

file_upload_example_empty.png

Upload Element With Selected File

file_upload_example_full.png

Configuration Options

The form element may be edited via the Edit Sidebar.

file_upload_name.png

Name

Field name shown in the form.

model_id.png

ID

The read-only field contains the model ID of the element. Designers can use the ID for example in the search to link the element in other models.

form_description.png

Description

When a user hovers over a form element during execution, the content of the commentary field is shown as a quick info:

grafik-20241022-085501.png
form_hashtags.png

Hashtags

Possibility to insert your own key terms . The leading hashtag sign # (hash) will be inserted automatically. Use the spacebar to insert multiple hashtags:

hashtag_example.png?version=2&modificationDate=1550039322000&cacheVersion=1&api=v2

One hashtag may be issued for multiple elements:

grafik-20241022-085727.png
form_css_classes.png

Additional CSS Classes

Enables a field-acurate layout customization.

form_allowed_filetypes.png

Allowed File Types

If you want to allow certain file types only, specify the allowed file types in this field. Separate multiple file types by comma.

Example: Word and JPG files are allowed

grafik-20241022-091606.png
form_max_filesize.png

Maximum File Size (in MB)

In this field you can limit the size of a file. Each file is checked individually against the restriction. The unit of measurement is megabyte; decimal numbers with a period or comma may also be used as separators.

form_mandatory.png

Mandatory

The marked element must be filled or used.

form_read_only.png

Read Only

This field is write-protected.

form_field_name_in_container.png

Field Name in Container

Defines the name under which the form element will be saved in the data container. If the Field Name in Container remains empty, then the field identifier (name) will be used. If two form elements share the same Field Name in Container, then both will access the same value.

The Field Name in Container is a technical identifier. It is often used for extended coding. Therefore the Field Name in Container should not contain any spaces, special characters or umlaut. For further information please visit page The Container Principle.

form_save_value.png

Save Value in Instance

If this checkbox is marked, the value entered in this field will be saved to the database during form execution.

Related Pages: