HomeGuidesRecipesAPI
HomeGuidesAPILog In

File Selection

The File Selection question type allows users to upload files to the form and the Content Library. This question can be used to gather existing files for people in other workflow steps to view, insert the uploaded files in the document output or other actions or add the files to the content library for future use.

442442

Document Preparation

Standard or selection placeholders can be used throughout the document to specify where the content items are to be inserted.

Usage

From the toolbox, drag and drop a File Selection question onto a page, section column or tab and set the questionโ€™s properties as below.

Property

Description / Examples

Mandatory

Whether the field is mandatory.

Multiple

Enables uploading multiple attachments at a time, by selecting the files or using drag and drop.
When uploading, the multi-file upload dialog is presented as a modal, and each file shows name, status and progress information, as well as the option to remove.

Content Type

Select the type of content that will be uploaded or selected from a drop-down list. Options are listed below:

  • Document Fragment - Only accepts Doc and Docx files
  • Image - Only accepts image files
  • Text - Accepts text, very similar to a text field
  • Attachment - Accepts all file types
  • Audio - Only accepts audio files

Display Type

Select if the display and functionality of the question. The options will depend on the display type selected:

  • Search - The content library can be searched for existing items to use
  • Upload- Files can be uploaded in produce
  • Search or Upload - Allows the option of Search or Upload

Button Text

Specifies the button name for uploading content on web forms. If left blank, the default text will be used.

Note: This text will still be used for offline apps except for image and audio file types.

Take Photo or Record Video Button Text

Specifies the button name for uploading images or audio files on the offline apps. If left blank, the default text will be used depending on the upload type.

Attachment Name

Gives the file an assigned name upon generation.

Note: The Attachment Name field accepts question references. This can be used to make your attachments name more descriptive.

Allow Add To Content Library

Allows the items which are uploaded to be inserted into the content library.

Valid Extensions

A comma-separated list of valid file type extensions. For exampleโ€™, .pdf, .png, .jpg
If no value is entered, all file extension types will be allowed.
Visible if 'Upload' is selected.

Max Files

Specifies the maximum number of files that can be attached.

Note: Default is 0, or no limit set.

File Size Limit (MB)

Maximum upload size

Note: Default is 0, or no limit set.

Content Folder

If Allow Add To Content Library is selected, a content library folder will need to be selected to insert the file into.

Restrict By Folder

Specify a folder in the content library to search.

Allow Edit

Allows users to edit existing text files inside the content library. Visible if select: Content Type 'Text', Display Type 'Search' or 'Upload and Search'.

529529

Placeholders can by dragged and dropped to a File Upload Question, where two answer types are available:

  • Data as Base64
  • File Name as text

๐Ÿ“˜

Multiple Attachments

If Multiple attachments has been enabled, the answer types changes to [File Count] and [File Name].

13531353

Receiving uploaded file contents

Actions and data sources and potentially other connectors can reference the contents of a file uploaded to a form.

To reference the file contents, add the following to the end of a reference to the file upload question:

".hex"
".base64"

For example, if your upload question is q1, the reference will be [q1.hex] or [q1.base64].

To check the name or size of the uploaded document, use the following:

".filename"
".filesize"

๐Ÿ“˜

Note

When there has been no file uploaded to the question, then the result is a blank string.

Restrict attachment uploads by Document type

  1. In Design, create or open a Project with at least one File Selection question.

  2. Select the File Selection question and the properties tab will show.

  3. In Valid Extensions, enter: .pdf, .doc, .docx.

๐Ÿ“˜

Valid Extensions

The "Valid Extensions" field accepts a comma-separated list of values that define what type of documents can be uploaded to Produce. For example, if you enter: .pdf, .doc, .docx, then only PDFs and Word documents can be uploaded as the attachment.

  1. Save the project.

  2. In produce, if you try to upload a file other than any of those defined in the "Valid Extensions" field, the following error message will be displayed:

372372

Defining Attachment Name in Design

Add a FIle Selection question to your project.

In the "Attachment Name" field, enter the relevant file name for the attachment when generated.

Save.

444444 284284

๐Ÿ“˜

Note

The Attachment Name field accepts question references. This can be used to make your attachments name more descriptive.