KB001585

Introduction

K2 smartforms 1.0.3 (4.12165.1585.0) updates all versions of K2 smartforms installations with the latest product hotfixes, as detailed below.

Important: For customers upgrading from pre K2 smartforms 1.0.2 versions the following must be considered: K2 smartforms 1.0.3 contains system configuration changes that will impact your existing environment. Be sure to carefully read through the release notes taking particular notice of the Important Considerations as well as any accompanying linked documentation. Adjustments have been made to various controls in this release and care has been taken to prevent breaking backwards compatibility. As a precaution K2 recommends that if you have applied custom themes to any Forms, extensive testing should be performed after upgrading to K2 smartforms 1.0.3 and before moving the Forms to Production to ensure that the Forms still function as previously designed. Support can be contacted if any issues are encountered during testing.

Update Options

There is one installer package for K2 smartforms 1.0.3 (4.12650.1585.0) 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.

Issues Resolved

The following issues have been fixed and are contained within this update:
KB001584 - K2 smartforms 1.0.3 High Priority Fixes

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 enhancements 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

Important Considerations

1. K2 smartforms 1.0.3 has a dependency on K2 blackpearl 4.6.5 due to the email attachment feature which is reliant on the email functionality, workflow enhancements and enhancements to the Identity Services released in K2 blackpearl 4.6.5. Therefore, K2 smartforms 1.0.3 requires K2 blackpearl 4.6.5 or greater.
2. K2 recommends that for optimal performance the K2 smartforms Runtime Site should be running on the same physical server as the K2 Host Server.  
3. The K2 smartforms Design and Runtime sites must run on .NET Framework 3.5 Service Pack 1. The K2 Designer will not function correctly if the sites are run on .NET Framework 4.
4. The SmartForms Integration and Client Event wizards will function as expected in Microsoft Visual Studio 2012.  
5. To enhance the performance of SmartForms a change has been made to the Design time and Runtime site. The new requirement is that the Application Pool's Managed pipeline mode must be set to Integrated where previously it was set to Classic for both Design Time and Runtime. On upgrading to K2 smartforms 1.0.2 or 1.0.3 a warning message will be displayed to inform the user that K2 will change the mode to Integrated for you. However, if other applications are dependent on the same Application Pool K2 will not change the mode but will rather inform the user that a new Application Pool needs to be created. The K2 blackpearl Application Pool account can no longer be used as it must be set to Classic mode.
6. If you have deployed custom themes and custom controls in your environment refer to KB001376 - Performance changes made in K2 smartforms 1.0.2 which details changes that will need to be considered when upgrading to K2 smartforms 1.0.2 or 1.0.3. These changes were implemented in 1.0.2 to improve performance. 
7. If you are upgrading from K2 smartforms 1.0 or 1.0.1 note that adjustments were made to various controls in K2 smartforms 1.0.2 and these changes are also included in 1.0.3, care has been taken to prevent breaking backwards compatibility. As a precaution K2 recommends that if you have applied custom themes to any Forms, extensive testing should be performed after upgrading to K2 smartforms 1.0.3 and before moving the Forms to Production to ensure that the Forms still function as previously designed. Support can be contacted if any issues are encountered during testing.

Download

The K2 smartforms Setup Manager is available as an independent installation package that can be found at the following location:
K2 smartforms 1.0.3 (4.12165.1585.0) - https://portal.k2.com/downloads/k2smartforms

Installation Information

New Prerequisite: K2 blackpearl 4.6.5 or greater - Ensure that your K2 blackpearl environment has been upgraded to K2 blackpearl 4.6.5 or greater before installing the K2 smartforms 1.0.3 update. The Application Pool account for the K2 smartforms Design time and Runtime site's Managed pipeline must be set to Integrated. Recommendation: K2 recommends that the K2 smartforms Runtime Site is installed on the same physical server as the K2 Host Server to ensure optimal performance.

For information on hardware and software prerequisites, installation steps on a standalone environment and post installation steps see:
Full Installation: KB001330 - Quick Guide to installing K2 smartforms or view the product documentation on help.k2.com.
Upgrade: KB001331 - Quick Guide to upgrading K2 smartforms. Remember to clear your browser cache after upgrading.

Known Issues

A list of some of the current known issues that you may encounter when using K2 smartforms 1.0.3 (4.12165.1585.0) is available in KB001583 - K2 smartforms 1.0.3 (4.12165.1585.0) Known Issues List.

Also see:

KB001411 - Known Issue: When disabling a View using the Properties section on a Form, all other Views on the Form are subsequently disabled at runtime.

KB001414 – Known issues when using the field context of a Picker control for mappings or using the Picker control in an Editable List.

KB001415 - Known issue: View and Form parameters overwriting field mappings.