4.4.3

Keyfax 4.4.3 introduces dozens of enhancements to the file upload question types available within Keyfax. These improvements are intended to bring the file upload capabilities within Keyfax upto date and to address a number of common customer requirements. Alongside the improvements to file uploads we've also addressed several other smaller issues with Keyfax 4.4.3.

New

New "Max Files" Setting for File Upload Questions

A new "Max Files" drop down list is available when creating or editing file upload questions within Keyfax admin tools. This option allows script authors to control how many files users can attach whilst completing the question. If the user attempts to upload more than the allowed max files a validation message will be presented informing users they cannot upload any more files.

New "Max File Size" Setting for File Upload Questions

A new "Max File Size" drop down list is available when creating or editing file upload questions within Keyfax admin tools. This option allows script authors to control the maximum file size allowed for any individual file uploaded whilst completing the question. Any individual file uploaded must be below the "Max File Size" otherwise a validation message will be displayed informing the user the file is too big. This setting does not limit the total size of all combined files. For example, if you allow the user to upload 5 files and set a max file size of 10mb then the user can upload 5 10mb files for the question which would of course total 50mb on the server. If any individual upload exceeded 10mb then the file would be rejected, and the file is too big validation message would be displayed – other valid files would still be processed if you selected multiple files.

Improved / Normalized File Types

The accepted file types within Keyfax admin tools can now be provided in several different formats and these will be normalized into a consistent format for presentation and usage within validation.

The following formats are now supported...

• 'jpg' and 'gif' and 'png' and 'docx' and 'mp4' and 'zip' and 'pdf'

• jpg, gif, png, docx, mp4, zip, pdf

• jpg,gif,png,docx,mp4,zip,pdf

• .jpg, .gif, .png, .docx, .mp4, .zip, .pdf

• .jpg,.gif,.png,.docx,.mp4,.zip,.pdf

• .jpg,.gif,.png,.docx,mp4,zip,pdf

Providing Sensible Defaults

Although the file types, max files & max file size can be customized on a per question basis it's also possible to set global defaults for these fields. These defaults will be used when creating new file upload questions or editing existing questions before these fields were introduced. For assistance with setting these defaults please contact Omfax Systems.

Staff / Tenant Experience

File upload questions presented whilst completing Keyfax scripts now appear as shown below...

You will notice here we...

• Inform the user how many files they can upload

• Inform the user the maximum allowed file size

• Inform the user of the allowed or accepted file types

Alongside browsing files you can now also drag and drop files into the upload area to begin uploading.

Chunked File Uploading

Chunked file uploading introduced with Keyfax 4.4.3 offers visual feedback as uploads complete and improves the reliability of the file uploads allowing Keyfax to automatically retry chunks if the user encounters any connectivity issues.

You can see below a video showing how uploading now provides visual feedback via a progress indicator as the file upload completes., this is particularly helpful on slower connections such as WiFi or 3g...

https://user-images.githubusercontent.com/65894527/204326067-10c5c1ad-22e9-4efa-a6ba-976a20de007c.mp4

Cancelling Uploads

Due to the introduction of chunked file uploads it's now also possible to cancel large uploads midway through if they are simply taking to long to complete.

Retry / Resiliency

If the server returns any errors whilst uploading a chunk the client side code will attempt to re-upload the chunk unto 3 times until the upload will fail. This is intended to offer some resiliency against intermittent connectivity issues however if connectivity continues to fail mid-upload an error message will be presented to the user within the upload preview.

New Filtered Browse / Choose Files Dialog

By default the browse / choose files dialog will now be automatically filtered to show only the allowed file types as defined for the file upload question. Previously this was not filtered based on the allowed file types and simply displayed all files.

Improved image previews

When upload images previews will now be presented immediately after the upload complete...

Support for any file type

With Keyfax 4.4.3 you can now allow any type of file to be uploaded with a file upload question. File uploads are no longer restricted to only image files. For example you can allow office documents or other common file types like MP3, MP4, PDF or even ZIP files. As a Keyfax administrator you can precisely control the types of files that can be uploaded on a per question basis.

You can see an example showing other file types is shown below...

Online Results Summary

For tenants file uploads are now displayed alongside each file upload question on the final results summary page...

Staff Current Call Tab

For advisors file uploads are now displayed alongside each file upload question on on the current call page...

Improved Validation

You can not upload any more files

If the user attempts to upload more than the allowed maximum files the following error will be presented to the user whilst completing the Keyfax script...

File is too big (XXmb). Max file size: XXmb.

If an individual file exceeds the maximum file size set on the file upload question the following error will be presented to the tenant or advisor whilst completing the Keyfax script...

Task Emails

With Keyfax 4.4.3 one or more files uploaded whilst completing a Keyfax script can now be attached to emails generated by Keyfax tasks. As part of the improvements introduced with Keyfax 4.4.3 the original file name is now also preserved when the file is attached to a task email within Keyfax. This is shown below...

With previous versions of Keyfax any file attached to a task email via a script would be named with a random unique identifier and the original file name would be lost. This has been resolved with the file enhancements as part of Keyfax 4.4.3.

Improved

File Upload Questions

File upload questions have received an overhaul with our Keyfax 4.4.3 release. When adding new file upload questions or editing existing file upload questions new options will be available within Keyfax 4.4.3 admin tools as shown below...

Fixed

• Added support for using self-signed SSL certificates within admin tools when loading web view content

• Fixed issue with data box filter textbox not working as expected within admin tools

• Fixed issue with empty feedback report within admin tools if the script set was empty

• Fixed issue where numeric fields would allow e, E & + characters when completing scripts

• Fixed warning - Data Security Check Failed message when an admin saves a user with a long username

• Fixed error message instead of validation message presented when adding MISAction task within Keyfax admin tools with no letter selected

• Fixed incorrect validation message when adding a task attachment if you selected a file before entering a description within admin tools

• Fixed issue when pasting content within CKEditor. This would produce the message "Your browser doesn‘t support pasting with the toolbar button or context menu option.".

• Fixed issue with potential database transaction deadlock in certain edge case scenarios

• Fixed issue with incorrect error being presented within admin tools if the script flow failed to load