Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

For the functionality of multiple files you do not need to install any plug in.

Step-by-step guide

To handle multiple files follow these steps:

Table of Contents
minLevel3

View the flow

The flow of an application handling multiple files could be as follow:

View the runtime application

When putting a multiple file upload container on a page, in the standard styling it will be presented as follows:

Configure the connection

To be able to handle files, a connection has to be specified. This connection states where the files should be stored. The connection can be specified in the aquima.properties file in the home folder.

...

Code Block
#fileupload
fileupload.label.single=Add file...
fileupload.label.multi=Add files...
fileupload.description.filesize=Maximum file size is: {0}
fileupload.description.extension=Allowed file extensions are: {0}
fileupload.validation.extension=File type not allowed
fileupload.validation.filesize=File is too large
fileupload.status.succes=File(s) uploaded successfully
fileupload.status.failed=Upload failed because the following file(s) do not meet all conditions:

Create a multiple File Upload

Follow the steps below to model a multiple file upload:

...

It is possible to extend this list with some custom meta data fields. These can be created and updated by using the AQ_File_UpdateMetaData service.

Create a download service

To use the download file container, first create a text item with the name 'DownloadText' and enter some text, e.g. Download.

...

This container can be used in the containment of the instance selector plus and it is ready to use.

Create a delete service

To be able to delete a file you need a service for that. Create a new service of type AQ_File_Delete. Enter the following parameters:

...

This service can be used in the flow when a delete event is triggered. This service can be used directly.

Create an update meta data service

Next to the default meta data that are stored, it is possible to define some of your own. These can be specified in the CustomMetaData parameter of the AQ_File_UpdateMetaData service. This is an example with one meta data.

...

The previous steps are needed for a simple and complete application. The following services and constructs can be used in more specific situations.

Get meta data service

Is is possible to retrieve the meta data when providing an Id.

ParameterValue
Connection<connection name>
FileIdFile.Id
FileNameFile.Name
FileTypeFile.Type
FileSizeFile.Size

Move a File

By using the AQ_File_Move it is possible to move a file from one connection to another connection. This could be useful when uploading to memory by default, adding some meta data and storing it on the file system afterwards. This service can be used by entering the following parameters.

ParameterValue
ConnectionFrom<connection name from one system>
ConnectionTo<connection name to another system>
FileIdFile.Id

Trigger a flow when uploading

There could be a need for directly triggering a flow when uploading a file. This could be useful when calling some services for setting information.

...

Every time a new file is uploaded, this exit event will be taken.

Example application

See the file upload example project.

...