ADF Release Notes v2.7.1

Overview

The Application Development Framework (ADF) version 2.7.1 release contains enhancements and bug fixes to core ADF 2.7.0 functionality.

Version Compatibility

This 2.7.1 version of the ADF is ONLY compatible with CommonSpot 10.5.2 or 10.6.1 or higher.


If your site is running CommonSpot 10 up to 10.5.1 or 10.6 please use ADF 2.4.x, however we strongly recommend upgrading to CommonSpot 10.7.3, 10.8.2, 10.9 or 11 and ADF 2.7.1!


ADF 1.8.x and older versions of the ADF are NOT compatible with CommonSpot 10.x. Please note if your site is running CommonSpot 9 or older you will need to use the ADF 1.8.1 release or 1.8.2 development builds.

ADF AjaxProxy CSRF Safe Mode

CommonSpot 10.5.2 and 10.6.1 introduced robust security enhancements to mitigate CSRF vulnerabilities but adding CSRF Token validation to it's form submits as well its internal /loader.cfm requests.


To complement these security enhancements, ADF 2.5 and above and the ADF companion Apps have also be updated to add CSRF validation to its custom forms, internal CommonSpot /loader.cfm requests as well as its own /ajaxProxy.cfm requests.


However, due to the flexibility and customizability of the ADF and the ADF Applications, specifically the powerful ajaxProxy feature, the CSRF attack prevention validation has been disabled by default. It can be enabled when all custom ajaxProxy requests have been updated to take advantage of this security feature.


For more information see the ADF AjaxProxy CSRF Safe Mode documentation regarding enabling the security enhancement.

Field Type CFCs

CommonSpot 10 and above, requires that all Custom Field Type Render modules be converted to be a CFC versus a CFM module. See the ADF 2.0 release notes for more information regarding CFC render modules built for the ADF 2.x releases.

Resource Loading

CommonSpot 10 introduces a new Resource Loading Framework to help efficiently load JavaScript and CSS resources. See the ADF 2.0 release notes for more information regarding using CommonSpot Resource Loading with ADF 2.x releases.


For detailed information about the Resource Loading Framework, see the CommonSpot Developer's Guide.

Installation/Upgrade

For detailed instructions for installing the ADF, see the ADF Installation Guide.


For detailed instructions for upgrading from a previous version of the ADF, see the ADF v2.7 Upgrade Guide.

If you are upgrading from an earlier release, we strongly recommend that you also read the following:

2.0.0 Release Notes

2.0.1 Release Notes

2.3.0 Release Notes

2.3.1 Release Notes

2.4.0 Release Notes

2.4.1 Release Notes

2.5.0 Release Notes

2.6.0 Release Notes

2.6.1 Release Notes

2.6.2 Release Notes

2.6.3 Release Notes

2.7.0 Release Notes

Previous ADF version Release Notes

Notable Enhancements

The ADF 2.7.1 release contains the following significant enhancements.

Extensions

  • Datasheet Modules
  • Added new datasheet modules: render-datapageid-value.cfm and edit-column-value-link.cfm.

  • Hooks
  • Added post-move-page and post-delete-page hook example files.
  • Search
  • Added a search utility example script to remove items from the CS search index by PageId.

Library Components

  • csData
  • Improved getCSExtURLString by adding a urlParams argument.

  • date
  • Added buildTimespanTimeStruct() and buildTickCountTimeStruct() functions to date_2_0.

  • Introduced the trimZeros argument to the calcExecutionTime function for improved output readability.

  • Consolidated duplicate logic in calcExecutionTimeFromDates using calcExecutionTime().

  • resourceService
  • Added buildRegisterScriptsArr() function to resourceService_1_0.

  • utils
  • Updated safeUrlRedirect to use meta refresh tags in the header instead of JavaScript.

ThirdParty

  • Added the dataTables 2.2 JavaScript library.

  • Added the date-fns 4.1 JavaScript library.

Notable Updates

The following notable updates were in this 2.7.1 release:

Extensions

  • Lightbox
  • Corrected a dialog resizing issue in lbResizeWindow when calling openLB() in the ADF Lightbox JavaScript library.

Library Components

  • ceData
  • Improved handling of additional return variables in parseCSExtURLProps function.

  • Fixed missing onClick value handling in parseCSExtURLProps function.

  • Data
  • Fixed un-var'd local variable issue in the structToQueryString function.

  • Date
  • Fixed the issue with the ColdFusion INT limitation in createTimeStruct function for timespan integer values exceeding 2,147,483,647.

  • Resolved negative timespan calculation issues in calcExecutionTime and calcExecutionTimeFromDates functions.

  • Utils
  • Fixed the incorrect TimerEvent default message in the renderTimerReport function.

Updated ADF Applications

The following ADF application was updated as part of the ADF 2.7.1 release. Please check the release notes for this app for details.

  • ptCalendar v4.9