12.1.2.1.1.7. File Attachment

The file attachment control allows users to upload and download different types of files, providing a convenient way to share information.

*For more information on how to access and manage file data using scripts, click here.

When a file attachment control is selected in the design environment, its associated properties are displayed in the Control Properties panel.

*To access the Control Behavior category, users must first create the form behavior.

1. Binding: In this category, users can link a control to its corresponding attribute and define its binding properties.
   • For more information on the fields in this category, click here.

*For more information on the required attribute for file attachment controls, click here. .

2. Name: In this category, users can access basic properties required for the control’s identification and proper referencing in the code.
   • For more information on these properties and how to configure them, click here.
3. Control Behavior: In this category, users can configure the behavior of the control and define how it interacts with the form or application.

   • Control Governance

     • In the Control Governance field, users can configure various properties that govern the functionality of controls.
       • To access the control governance properties, click on the ellipses () inside the field. It will display the Form / Behavior / Control window.
         • This window consists of two tabs:
           • File Attachment
           • Validation

       !!Please note that users are limited to configuring only the required field validation properties for file attachment controls and cannot set up required range validations.

   • For more information on these properties and how to configure them, click here.

     !!Please note that the linked section contains information on setting an initial value, which is not applicable to file attachment controls and can be ignored.

4. Appearance: In this category, users can customize the visual appearance of the control.
   • File Extensions: This field allows users to specify the types of files that can be uploaded to the control.
     • Users can input specific file extensions in this field to restrict uploading access to only those files types.
       • To include multiple file types, users need to separate each file type with a comma.
         

         !!If no file type is specified, all file types can be added to the attachment control.

   • Max File Count: This is a numeric updown field that allows users to set the maximum number of files that can be attached to the control.
     • By default, the maximum file count is set to 1. To adjust this value, users can enter numbers into the field either manually or by clicking the increment/decrement arrows.
   • Max File Size: This is a numeric updown field that allows users to set the maximum combined size limit, in megabytes, per file attached to the control.
     • By default, the maximum file size is set to 2 MB. To adjust this value, users can enter numbers into the field either manually or by clicking the increment/decrement arrows.
       

       !!Please note that the maximum file size inputted in this field cannot exceed 2 GB (or 2048 MB), which is the limit per file attached to the control.

   • Tooltip: This field allows users to input a tooltip for the control.
     • In the web application, the tooltip is represented by the tooltip icon ( ) next to the control.

     • File Attachment Tooltip Preview: Web View

       **A tooltip is a brief message or description that appears when the user hovers their cursor over the tooltip icon next to the control. This feature can help to provide additional context and guidance to the user as they interact with the form or application.

5. Caption Appearance: In this category, users can customize the visual appearance of the control’s caption.
   • For more information on the fields in this category, click here.

File Attachment Control Preview: Web View

• If the max file count is set to 1, the file attachment field will take on the following appearance in the web application:
  
  
  
  • : This button allows users to upload a single file.
    
    • If selected, a file dialog will appear, enabling users to browse and choose a file from their local system.
      
    
    
• If the max file count is greater than 1, the file attachment field will take on the following appearance in the web application:
  

  *For more information on how to use this field in the web application, click here.

Quick Forms Application

To apply the Quick Forms feature to file attachment controls, take the following steps:

• Drag a file attachment control from the toolbox and drop it onto the design environment.
• Provide a caption for the control.
• Save the form and select Yes in response to the following prompt:
  
  
  

*For more information on the Quick Forms feature, click here.