Versions Compared

Key

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

...

Tip

Watch our What's New in v10.3 Webinar for a tour of our favorite new features! (Coming soon)

Expanded Business Rule Functions for Upload Controls

Customers have requested the ability to access additional file attributes for upload controls from rules such as the file name and file size, and frevvo v10.3 delivers this functionality and more.

 The Upload control itself has several new properties available in the Rule Editor.

  • filesCount - This can be used in lieu of value.length so designers no longer have to deal with the nuance of one attachment vs many in their rules.
  • status - In order to communicate validation errors, the Upload control now has a status that displays when the control is set to invalid.
  • totalFileSize - A convenient way to get the sum of the file sizes (in bytes) of all attachments.

Additionally, each uploaded file will have three new properties.

  • Url (read-only) (full URL) - returns the location of the file
  • Name (read/write) - returns the name of the file
  • Size (read-only) - returns the size of the file in bytes

All of these properties are visible in the Form Outline in Rules editing mode.

Image Added

Here is an example rule that logs that accesses these file properties and displays them in the frevvo.log output.

Code Block
for (var i=0; i<UploadControl.filesCount; i++) {
   frevvo.log(UploadControl.files[i].url);
   frevvo.log(UploadControl.files[i].name);
   frevvo.log(UploadControl.files[i].size);
}

We've also added the ability to remove all attachments from an upload control with UploadControl.value or UploadControl.files is set to null, or to remove a specific file from upload control with UploadControl.files[index]= null. Here's an example of a rule that removes extra attachments if more than 3 are uploaded:

Code Block
//Remove more than 3 attachments
 for (var i=UploadControl.filesCount-1; i>=3; i--) {
   UploadControl.files[i] = null;
}


DocuShare Flex Integration

...