KB001650

DOWNLOADS K2 smartforms 4 6 9 New Features List.pdf (405 KB)

Introduction

K2 smartforms 4.6.9 (4.12165.1650.1) allows for a clean install or upgrade from a previous version of the product.

The K2 smartforms installation package can be downloaded from the download’s page available on the K2 Partner and Customer Portal site. See the Installation details below for more information.

New Features and Enhancements

There are multiple new features and enhancements available in this release. For a detailed list see the K2 smartforms 4 6 9 New Features List.pdf (405 KB).

The Knowledge Base article KB001649 – K2 smartforms 4.6.9 Resolved Issues List, lists the issues resolved in this release.

The Knowledge Base article KB001648 lists the known issues in this release.

1. K2 smartforms 4.6.9 has a dependency on K2 blackpearl 4.6.9.
2. K2 Setup Manager: .NET Framework 4.5 is required for the K2 installer to run, ensure that this version is installed on all machines on which the installer will be run.
3. K2 Setup Manager: The K2 Setup Manager requires PowerShell 2 or higher on the K2 Server to deploy installation packages.
4. Browser support: Internet Explorer 8 (including any other Internet Explorer version running in IE8 compatibility mode) has been deprecated as a supported runtime and design time browser in K2 smartforms 4.6.9 based on Microsoft’s communication to end support for IE8 on or before January 2015. However, Microsoft amended its policy, which can be found here. Despite the change in policy SmartForms will no longer support IE8 from K2 smartforms 4.6.9 onwards. Any bugs or performance issues that occur only when using IE8 will not be investigated or fixed after this release.

Behavioral Change

1. Custom Themes: In order to implement new features, resolve bugs and improve performance, changes have been made to the rendered HTML and accompanying CSS. As a result, custom themes will need to be adjusted to retain their existing appearance and behavior. In most cases, custom themes are copies of the core themes provided with SmartForms, with alterations to match the user’s requirements. It is recommended that the custom theme be compared with the theme on which it has been based using a tool such as Beyond Compare. From the comparison, structural changes will be evident and the required changes can then be made to the custom theme.
   The following changes have been made in SmartForms 4.6.9 that need to be considered in order to ‘upgrade’ a purpose built custom theme:
   • Icons are no longer globally available, instead it is required that one specify the icons within the custom theme itself. This improves performance when a theme uses custom icons. Use the Platinum theme as an example.
   • The application of borders has changed on the following controls:
     • Lookup Control
     • Picker Control
     • Date & Time Picker
     • Dropdown List
   • The following controls have new stacked rendering implementations which can affect a custom theme:
     • Radio button List
     • Checkbox List
2. Border and Conditional Styles: The default application of borders has changed on the following controls:
   • Lookup Control
   • Picker Control
   • Date & Time Picker
   • Dropdown List
3. Custom Controls: The incorrect casing of a context variable used within Execute a Control’s Method actions has been deprecated this impacts existing custom controls in the following way:
   • In K2 smartforms 4.6.9 any code using the incorrect casing CurrentControlID will still operate but a warning message will be logged if debugging has been enabled.
   • In any release after K2 smartforms 4.6.9 any code using the incorrect casing CurrentControlID will break.
   The correct casing CurrentControlId has been added in K2 smartforms 4.6.9 and any existing code must be changed to use it after upgrading.
4. List item click and double click rule events: The behavior of list item click and list item double click rule events have changed.

Updates Included

This update includes all the new features and hotfixes that were included in the previous K2 smartforms Updates, so there is no need to install the updates listed below. The following links are provided for reference to view the new features, enhancements, important considerations and resolved issues contained within the previous updates:
KB001565 – K2 smartforms 1.0.1 (4.12165.1565.0) Release Notes
KB001575 – K2 smartforms 1.0.2 (4.12165.1575.1) Release Notes
KB001585 – K2 smartforms 1.0.3 (4.12165.1585.0) Release Notes
KB001595 – K2 smartforms 1.0.4 (4.12165.1595.0) Release Notes
KB001605 – K2 smartforms 1.0.5 (4.12165.1605.0) Release Notes
KB001625 – K2 smartforms 1.0.6 (4.12165.1625.0) Release Notes
KB001635 – K2 smartforms 1.0.7 (4.12165.1635.0) Release Notes

There is one installer package for K2 smartforms 4.6.9 (4.12165.1650.1) available for download from portal.K2.com that will facilitate upgrades and clean installs.

• For customers who already have K2 smartforms installed, download the package and install this update.
• For customers who do not have K2 smartforms installed, download the package and follow the Setup Manager wizard.

Note: If you upgrading from a version older than K2 smartforms 1.0.7 it is recommended that you read the relevant links under the Updates included section above before upgrading to ensure your environment has all the necessary prerequisites installed.

Installation

Prerequisites

• K2 blackpearl 4.6.9 or higher
• .NET 4.5 required by the K2 Setup Manager
• PowerShell 2 or higher on the K2 Server

Recommended: If the K2 Server is load balanced then the smartforms runtime site must also be load-balanced with the same number of nodes, For example,

Recommended: If the K2 Server is load balanced then the smartforms runtime site must also be load-balanced with the same number of nodes, For example,

For information on hardware and software prerequisites, installation steps on a standalone environment and post installation steps see:
Full Installation: View the product documentation on help.k2.com.
Upgrade: View the Upgrade topic in the product documentation.

Note: Remember to clear your browser cache after upgrading.