BPM File Dropzone (deprecated)

The BPM File Dropzone control (now contained in the Content Management Toolkit) allows the user to drag and drop a file from their computer or select a file manually, and will store it in the IBM BPM document store.

The BPM File Dropzone will retrieve the file you've selected and store it on your IBM BPM document store, or IBM BPM content store. IBM Knowledge Center

Like almost all SPARK controls, you can trigger events that are fired when the user interacts with the control (see the Event and Methods sections below and the Event Handling article for more information).

This control is best used with the BPM File List control, or File Viewer control.


Show Border Show border around file upload area

Square Border Corners Make the border corners square, instead of rounded

Show Thumbnails Show thumbnails of files in dropzone

Content Management

Associate with Process Instance When checked (true) the documents to be uploaded will be associated with the current process instance, otherwise (false) the document will not be associated with the current process instance.

Upload Properties Specifies the matching properties to be uploaded with this document; you can name Upload Properties; for example: Name: Prop1 and Value: Value1, this tells the BPM File List to only show files with these properties when the same information is entered in the Filter table (for more information on the BPM File List, see below under Related Article(s)).


Auto Upload Upload selected files automatically. If not selected, use the startUpload() method in the On File Selected Event.

Auto-Remove Uploaded Files Remove uploaded files from dropzone

Max File Size (MB) Maximum allowed file size for uploads

File Types Allowed Pick a valid file type from the dropdown, or specify custom to specify your own file type.  When empty all file types are valid.


These are the configuration option settings...

This is the result before dropping a file...

After dropping a file...


With the BPM File Dropzone Control, there are 6 types of event handlers:

  • On Load When the page loads
  • On File Added When a file is added
  • On File Selected When a file is selected
  • On File Removed When a file is removed
  • On Upload Complete When file upload is complete
  • On Upload Error When there is a file upload error

You can use JavaScript logic to affect the effects of the control, depending on the event. More information on using these controls can be found in the Event Handling article.


For detailed information on the available methods for this control, access the JS Doc file.

Related Article(s)

BPM File Uploader

BPM File List

File Viewer


  • Author: Courtney Silva
  • Date Created: June 18, 2015
  • Date Modified: July 27, 2015
Was this article helpful?
0 out of 0 found this helpful