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.
Appearance
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)).
Behavior
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.
Example
These are the configuration option settings...
This is the result before dropping a file...
After dropping a file...
Events
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.
Methods
For detailed information on the available methods for this control, access the JS Doc file.
Related Article(s)
- Author: Courtney Silva
- Date Created: June 18, 2015
- Date Modified: July 27, 2015
Comments