File

File Component Icon

A file field allows users to upload and download files to a form.

This page describes the settings that are characteristic of the File component. Please find the general settings here:

General Settings

These settings can also be used to customize the standard Submit button that is automatically added to an eForm.

File Tab

Storage
The storage in which the file is to be stored in.

Display as image(s)
Images will be rendered in the view.

File Types
Enter the label and value of the file types.

Add Another
Add another row.

File Pattern
Specify a file pattern.

File Minimum Size
Enter a minimum file size for the files the users can upload. This setting applies to each individual file.

File Maximum Size
Enter a maximum file size for the files the users can upload. This setting applies to each individual file. The default value for this field is 1GB.

Data Tab

Filename Macro
Select a macro that can be used to automatically name the file under a template. There are four macros available:

  • [F]
    Original file name with no modifications.

  • [C:%0Xd]
    Formatted file counter using 'X' as the minimum character length for the counter. Additional characters can be added before the '%'. (eg. C:INV-%02d)

  • [T:]
    Adds a date and/or timestamp, using a format provided by 'DateParser'. (eg. T:yyyy-MM-ddhh-mm)

  • [R:X-Y]
    Uses a range of characters from the original file name. X and Y correspond to the position of the characters in the original file name to start and end the range respectively. (eg. R:4-8).

Note:
  • Several macro functions can be used simultaneously to define one naming template.

  • The file is renamed according to the template upon the eForm being submitted.

  • When adding a date and/or time stamp format, it is recommended to avoid using slashes (/) and colons (:) as these would interfere with the file path and macro structure.