Enabling attachments for an HTML5 form enabling-attachments-for-an-html-form

AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

You can upload, preview, and submit attachments with HTML5 forms. By default, the attachment support is disabled. To enable the attachment support:

  1. Create a custom profile with mutiselect string property mfAttachmentOptions.

  2. In the custom profile, specify properties fileSizeLimit, multiSelect, and buttonText to configure options of the file attachment widget. As required, you can also specify more custom properties.

  3. In the custom profile, use the following configurations:

    • multiSelect -> true or false (true by default)
    • fileSizeLimit -> value_in_mb (say 5) (2 MBs by default)
    • buttonText -> Button text for pop-up window (“Attach” by default)
    • accept -> file types to accept (“audio/*, video/*, image/*, text/*, .pdf” by default)
    note note
    In Microsoft Internet Explorer 9, users can attach files larger than the specified limit. It is a known issue.
  4. Use the metadata editor to select the custom profile that you have created above for HTML 5 forms.

  5. Render your form template with custom profile and the attachments icon would appear on the forms toolbar.

    note note
    Out of the box, the forms portal provides a custom profile with drafts and attachments capability enabled. For more information about the Save as Draft profile, see Saving HTML5 forms as a draft.
  6. Click the attachment icon, an attachment selection dialog box appears. Browse and select the attachment and click Attach.

    note note
    To preview an attachment, click the attachment name.
    note note
    The file preview option is not available for anonymous users.

Attachment submission format attachment-submission-format

When attachments are enabled, HTML5 form submits multipart data. The multi-part submission data has two parts dataXml and attachments.

For backward compatibility, if mfAllowAttachmentsoption is turned off, then the HTML5 forms does not send the multi-part data. It sends simple data xml in application/xml format.

If the mfAllowAttachments flag is turned on, the submit service proxy service also posts multipart data with dataXml and attachments.