See File Upload control.

Auto-Save

Set to Yes to allow files to be automatically uploaded as soon as they are selected at runtime. The files are automatically uploaded when you click OK in the confirmation message. (Default: No)

File Selection Mode

Select either option:

• Single: To upload a single document. (Default)
• Multiple: To upload multiple documents at the same time.
  Note

  • On uploading multiple files, the FileLocation and FileSize properties remain empty at runtime.
  • On uploading multiple files to a folder using an ios device, the names of all the images are automatically changed to image, such as image.png or image.jpeg. If the Overwrite option is set to Yes, it uploads the first selected image only and does not inform the user that only one image was uploaded. Otherwise, it uploads one image and for the rest of the images, it informs the user that the image already exists.
  • On upgrading TotalAgility from versions earlier to 7.3.1, the default File Selection Mode is single.

Store in repository

Select either option:

• No: To store the uploaded files in a specific location, configure the following:

  Note The Store in repository option is not available in TotalAgility Azure and on-premise multi-tenancy environments. These environments do not support storing the uploaded files in a physical location as files are automatically stored in the repository.

  Destination

  Specify the path to the location in which to store the uploaded files.

  Overwrite

  When set to Yes, this option allows a file that already exists with the same name to be overwritten by the file being uploaded.

• Yes: To store the uploaded files in the repository, configure the following:

  Folder Location

  Stores the file in the specified folder.

  Note If the folder location is blank, a new folder is created.

  Do either of the following:

  • Consume a form field or a form data variable that has a valid folder instance ID.

  • Click Static and enter a valid folder instance ID.

  Document ID

  Consume a form field or a form data variable to store the returned document ID.

  Note The document ID is hidden when "Multiple" is selected for file mode, as it does not apply on multiple file uploads.

File Types

Select either option:

• Allowed: Allows certain file types to be uploaded at runtime,(Default). In the Allowed File Types box, enter the file types to be uploaded. For example, .png;.jpg.

• Restricted: Restricts certain file types from being uploaded. In the Restricted File Types box, enter the file name extensions separated by a semi-colon. For example, .png;.txt.

Note

• The allowed and restricted file types options are only available for desktop forms.

• If there are restricted file types when uploading the files, a message is displayed to confirm, if you want to upload the allowed file types. If you click yes, it will upload the allowed file types only and if you click no, none of the files are uploaded.

• When you upgrade TotalAgility, if there are restricted file types specified in the forms imported from previous version, then the toggle will be set to restricted.