Properties of a File upload control

Configure the File upload control under the following tabs:

General

Use this tab to configure the general properties of a File Upload control.

Name Description

Type

The type of the control.

Name

A unique name for the control.

Tooltip

Provides supplementary information.

Enabled

Enables the control at runtime. (Default: Selected)

Security token

Makes the information in the form secure. See Security tokens.

Visible

Makes the control visible at runtime. (Default: Selected)

Display

Use this tab to configure the label and button for a File upload control. At runtime, these settings are applied and you can have full control over the button.

Name Description
Label design

Show label

Displays the label for the control.

Text

A meaningful text for the label.

Width

The width of the control in pixels. (Default: 100)

Position

The position of the label (Left or Top) to display on the form. (Default: Left)

Style

The style of the control. Available options are:

  • Theme (default): Retains the default theme.
  • Inline: Set the font, font size, alignment, and other options.
  • Class: Enter the name of the CSS class. This class is applied to the control only when it is available in the style sheet that is associated with the theme. If the class does not exist in the style sheet, then the control uses the default style.

Button design
Button only

If selected, only displays the button; it does not display the text box with file name. (Default: Clear)

Note This option is only available for standard desktop forms.

Button text

The text for the button. (Default: Browse)

Note This option is only available for standard desktop forms.
Width

The width of the button in pixels. (Default: 78)

Height

The height of the button in pixels. (Default: 32)

Style

The style for the button. Available options are:

  • Theme (default): Retains the default theme.
  • Inline: Set the font, font size, alignment and other options.
  • Class: Enter the name of the CSS class. This class is applied to the control only when it is available in the style sheet that is associated with the theme. If the class does not exist in the style sheet, then the control uses the default style.

Configuration

Use this tab to configure the advanced properties of a File upload control.

Name Description

Auto save

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

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

File selection mode

Indicates whether a user can upload Single or Multiple files.

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

Store in respository

Indicates whether to store the uploaded files in the repository.

  • If clear (default), the files are stored to 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.

    Note
    • 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.
      Note 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.
      Note The document ID is hidden when "Multiple" is selected for file mode, as it does not apply on multiple file uploads.

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.
  • 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.
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. 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.