File
The File Form Control allows the Users to upload files on the Novunex platform. Users can select one or, if configured, also multiple files from their local computer and these are uploaded when a Save
or Sign and Save
Action is triggered. Files are commonly linked to Attributes of the Data Type File. When File is configured to upload multiple files at once, the Attribute is required to be an array.
Control properties
-
Id / Name - Identifier of the Form Control. Id / Name needs to be unique for all Form Controls on the same Form. Id / Name also binds the Form Control to an Attribute with the same name of the Variable backing the From. This means that the Form Control will load and show the value from said Attribute when the Form is entered, and that the value of the Form Control is stored in the Attribute when the Form is left by a
Save
orSign and Save
action. The Form Control can also be bound to an Attribute of a Variable other than the one backing the From by using the fully qualified name as Id / Name:VariableName.AttributeName
- Binds the Form Control to an Attribute of a Entity or VariableContextVariableName.ContextVariableName
- Binds the Form Control to a Context Variable that holds only one value without any Attributes
A detailed explanation of the different linking mechanisms between a Form Control and an Attribute is given in the Variable and Variable Type configuration of the From Activity.
-
Label text - Caption rendered above the Form Control thus identifying it to the Users.
-
Help text - Explanation of the Form Control shown below the Form Control.
-
Enable conditional mandatory validation? - This property is similar to the Is field mandatory? property, but allows you to specify a condition determining when the Form Control becomes mandatory. If Enable conditional mandatory validation? is set to No this property is disabled. If set to Yes, a condition can be entered determining when the Form Control becomes mandatory. When the condition evaluates to
true
, the Form Control cannot be left empty or unspecified in case aSave
orSign and Save
Action is triggered.Dismiss
andSign
Actions do not enforce the mandatory condition. However, it does not matter if the value was entered by the User or did already existed in the Attributes backing this Form Control, but it just has to exists. When List of values? is set to Yes, this property is ignored.- Condition for is mandatory - When this Form Control Expression evaluates to
true
, the Form Control becomes mandatory. An asterisk in front of its label indicates if the Form Control is currently mandatory.
- Condition for is mandatory - When this Form Control Expression evaluates to
-
Is field mandatory? - When set to No, the Form Control can be left empty or unspecified. When set to Yes, the Form Control cannot be left empty or unspecified. The Actions
Save
orSign and Save
enforce this condition, whileDismiss
andSign
Actions do not enforce it. If set to Yes, it does not matter if the record is entered by the User or did already existed in the Attribute backing this Form Control. Mandatory Form Controls are indicated by an asterisk in front of their label. This property is only available if Enable conditional mandatory validation? is set to to No. When List of values? is set to Yes, Is field mandatory? is ignored and the Require at least one record? property of the LIST CONFIGURATION has to be used instead. -
Disable control? - Makes the Form Control editable (No) or read-only (Yes). Be aware that the content of read-only Form Controls is not stored by
Save
andSign and Save
Actions in the linked Attribute. -
Hide control? - Hides (Yes) or shows (No) the Form Control in the Form. Be aware that the content of hidden Form Controls is stored by
Save
andSign and Save
Actions in the linked Attribute. -
Condition type - Allows you to hide or disable the Form Control based on a Form Control Expression evaluating to
true
orfalse
:- Display - Hides the Form Control when the Form Control Expression evaluates to
false
and shows it when the Form Control Expression evaluates totrue
. Be aware that the content of hidden Form Controls is stored bySave
andSign and Save
Actions in the linked Attribute. - Disable - Makes the Form Control editable when the Form Control Expression evaluates to
false
and makes it read-only when the Form Control Expression evaluates totrue
. Be aware that the content of read-only Form Controls is not stored bySave
andSign and Save
Actions in the linked Attribute. - Display condition or Disable condition - The Form Control Expression behind the condition
- Display - Hides the Form Control when the Form Control Expression evaluates to
-
Allowed file extensions - Comma separated list of allowed file extensions, i.e., only files with these extensions can be uploaded. For example, the input
csv, pdf, txt
allows only files with the extensionscsv
,pdf
andtxt
to be uploaded. This property is not case sensitive. Hence, in the example also files with the extensionsTXT
,Csv
, etc. can be uploaded. If this properties is left empty, any file extension are allowed in the upload. -
Upload multiple files? - Specifies if only one (No) or multiple files (Yes) can be uploaded at once.
- How many files should be displayed per row? - When the User selected files, but did not trigger an Action, the files are listed in this Form Control. This property specifies how many files are shown in a single row.
-
Disable delete? - Sets if files can be deleted again (Yes) or only overwritten (No).