Example: Preview or Download Multiple Files Uploaded from a Previous Task
Follow an example to either preview or download multiple files in a Screen that have been uploaded from a previous Task in that Request.
Overview
Intended audience: Process designers, Web designers, graphic designers, software developers, coding engineers
Tags: Loop control; File Upload control; File Preview control; File Download control; Screen design
If multiple files have been uploaded to a Task within a Request, those files can be previewed and then downloaded from the current Task in that Request.
In the Screen of the Task from which to preview or download those multiple files, use a File Preview control or File Download control, respectively, with a Loop control.
See the following sections regarding how to view and/or configure each control used in this example:
Locate the File Upload Control to Upload Multiple Files
Follow these steps to locate applicable setting information for the File Upload control in this example:
Locate the File Upload control from the Screen page designed to upload multiple files. This Screen is used in the previous Task of the Request that the Request participant uploads those files.
Configure Controls to Preview Files
To preview multiple files for this example requires the following controls:
Configure the Loop Control to Preview Files
Follow these steps to configure the Loop control to preview multiple files as in this example:
Add the Loop control to the Screen page from which to preview multiple files.
In the Variable Name setting of the Loop control, enter the Variable Name setting value from the File Upload control. For this example, enter
MultiFileUploadControl
.
Configure the File Preview Control
Follow these steps to configure the File Preview control for this example:
Add the File Preview control to the Screen page from which to preview multiple files.
This value is required because the Request data stores each file in within a JSON array named from the File Upload control's Variable Name setting value; within this JSON array, each file uploaded to the File Upload control is stored in a JSON object with a unique file ID referenced by the key name
file
. This value is not case sensitive.
Configure Controls to Download Files
To download multiple files for this example requires the following controls:
Configure the Loop Control to Download Files
Follow these steps to configure the Loop control to preview multiple files as in this example:
Add the Loop control to the Screen page from which to download multiple files.
In the Variable Name setting of the Loop control, enter the Variable Name setting value from the File Upload control. For this example, enter
MultiFileUploadControl
. These are the same settings as for the Loop control that contains the File Preview control.
Configure the File Download Control
Follow these steps to configure the File Download control for this example:
Add the File Download control to the Screen page from which to download multiple files.
This setting is configured for the same reason as that of the File Preview control in this example.