...
The Upload form element allows a website visitor to upload a file from their local computer or network to your website. The Upload form element contains the following properties:
| Property | Description |
|---|
| Title | The text that appears next to the password input field in the step pane and in the form on the frontend. |
| Required field | Specifies whether the field is required. |
| Show title | Specifies whether to show the title of the form element in the step pane and in the form on the frontend. |
Design template| Presentation | Specifies the design template to use to render the form element on the frontend. This property will only be available if there are two or more design template for the form element. |
| Identifier | The unique identifier to use for this form element. The unique identifier is used in expressions for (pre)filling and (pre)conditions. Click here for information about renaming an identifier.
| Note |
|---|
GX Software strongly recommends that all form element identifiers be unique. |
|
| Precondition | The precondition decides in what situations the form element will be visible to the website visitor. |
| Help |
text| Text | In this field you can enter text that displays next to the form element in the form in order to provide useful information on what input is requested/expected. How/whether this text appears in the form is controlled by your presentation. |
| Extra |
text| Text | This is extra text that you can show by a form element to provide extra guidance regarding what the expected input is. How/whether this text appears in the form is controlled by your design template. |
| Prefilling | Prefilling determines the initial value of this form element for the website visitor. Prefilling is further described in the section and Prefilling a Form Element. |
| Validations | Select one or more validator(s) to evaluate the input received by a form element in order to ensure that it conforms to the constraints you indicate. See the section Form Element Validations for complete information on using the validators. |
| CSS classname | Specifies the CSS class to use for rendering the form element. This option allows you to alter the how selected form elements appear in the form without globally altering the presentation. |
| Fragment Tag | A unique tag to identify the form element. This tag is rendered in the form element presentation as a custom data attribute of the form element itself. The attribute name is data-fragment-tag. When filling out this property for a form element, the attribute is added to the presentation and can be used by external applications like GX Software's BlueConic. |
| Accepted extensions | Specifies the file extensions that are accepted. This allows you to enforce and/or restrict which file types can be uploaded in an interactive form. |
| Accepted MIME types | Specifies the MIME types that are accepted. This allows you to enforce and/or restrict which MIME types can be uploaded in an interactive form. |
| Minimum number of uploads |
| Panel |
|---|
| borderColor | #0081C0 |
|---|
| titleColor | #0081C0 |
|---|
| This setting was introduced in XperienCentral version R33. |
Specifies the minimum number of uploads the form element may contain. The default is 1. |
| Maximum number of uploads |
| Panel |
|---|
| borderColor | #0081C0 |
|---|
| titleColor | #0081C0 |
|---|
| This setting was introduced in XperienCentral version R33. |
Specifies the maximum number of files this form element may upload simultaneously. The default is 1. When the value is higher than one, a website visitor can upload between 1 and the maximum number of allowed files simultaneously in an Upload form element. |
| Note |
|---|
Application Managers - The directories where uploads may be stored must first be configured in the Setup Tool. By default, no valid file upload directories are configured. See file_upload_valid_directories for more information.
- By default, the Upload File element has the Check File Type and Check File Extension validations assigned to it. These cannot be removed and for security reasons, GX strongly recommends that you fill in the valid fields for these validations.
|
...