Configuration of a File upload control

Configure the File upload control to suit your requirement.

Name Description

Auto save

If selected, allows files to be automatically uploaded as soon as they are selected at runtime. (Default: Clear)

The files are automatically uploaded when you click OK in the confirmation message without invoking a File upload action.

Drag and drop

  • If selected, you can upload files using drag and drop in TotalAgility Workspace. You can also set the height (default: 150 px) and percentage height of a control. See "Use viewport height" and "Height" properties in Design properties of a control.

  • If clear (default), then you can use the standard browse to files and upload.

File selection mode

Indicates whether you can upload Single or Multiple files.

On upgrading TotalAgility from versions earlier to 7.3.1, the default "File selection mode" is "Single".

Store in repository

Indicates whether to store the uploaded files in the repository.

  • If clear (default), the files are stored in the specified location. Specify the path to the location in the Destination box.

    Select Overwrite to allow a file that exists with the same name to be overwritten by the file being uploaded.

    • If you upload multiple files to a folder using an ios device, the system automatically changes the names of all the images to image, such as image.png or image.jpeg
    • If you clear the "Overwrite" option, the system uploads the first image but for the rest of the images, it displays a message that the image already exists.
    • If you select the "Overwrite" option, the system only uploads the last selected image and does not display any message that only one image was uploaded.

  • If selected, stores the uploaded files in the repository. To store the uploaded files, configure the following:
    • Folder ID: Sets the ID of the folder that the document will be stored in. Select a form control or a form data variable that has a valid folder instance ID, or enter a static valid folder instance ID.
      If the folder location is blank, a new folder is created.
    • Document ID: Sets the variable that will hold the ID of the new document that is created for the file upload. Select a form control or a form data variable to store the returned document ID.
      The document ID is hidden when "Multiple" is selected for file mode, as it does not apply to multiple file uploads.

  • 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.
  • The "Overwrite" option is not available if you choose to upload the files to the repository.

File types

Specify the file types to be allowed or restricted.

  • Allowed (default): Allows the specified file types to be uploaded at runtime. To specify the allowed file types, click , enter the allowed extension, such as .png, and click Add. Similarly, add more extensions as needed.
  • Restricted: Restricts the specified file types from being uploaded. To specify the restricted file types, click , enter the restricted extension, such as .jpeg, and click Add. Similarly, add more extensions as needed.

  • 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. On confirmation, only the allowed file types are uploaded. If you click no, no file is uploaded.
  • The toggle for file types of any forms imported from a previous version is set to restricted.