Introduction

K2 components have been updated with new and improved functionality and important bug fixes. The K2 4.6.11 release consists of the following updated components:
  • K2 blackpearl 4.6.11 (4.12060.1731.2)
  • K2 smartforms 4.6.11 (4.12165.1732.2)
  • K2 smartforms Control Pack 4.6.11 (4.13180.1733.2)
  • K2 for SharePoint 4.6.11 (4.13350.1734.2)
  • K2 Language Pack 4.6.11 (Preview) (4.13500.0.2)

Updated Installers available (K2 4.6.11.2)

Updated 4.6.11 installers are available on the K2 Partner and Customer Portal. Enhancements were made to the K2 Installers to support (SHA-2) CNG (Cryptographic Next Generation) generated certificates. The K2 4.6.11.1 installers only catered for CSP (Cryptographic Service Provider), and the K2 Installer would return errors if a K2 site was configured using a CNG generated certificate.
If your certificates have expired already, and you are running with CNG certificates, these will continue to work as expected on your current release. If you plan on upgrading to K2 4.6.11, the 4.6.11.2 (4.12060.1731.2) installers must be used.

Downloads

The various K2 4.6.11 installers can be downloaded from the  K2 Partner and Customer Portal. Use the table below to determine which installer you need.

K2 4.6.11
Current Version K2 Installation Package K2 Update K2 blackpearl K2 smartforms K2 Control Pack K2 for SharePoint (2013) K2 Language Pack (Preview)
No K2

 check

Optional
K2 4.6.9 or greater (Any of the following components: blackpearl, smartforms, smartforms Control Pack, K2 for SharePoint)

 check

Optional
K2 4.6.8 or earlier (blackpearl, smartforms, smartforms Control Pack, K2 for SharePoint)

 check

K2 blackpearl 4.6.8 or earlier

 check

K2 blackpearl and SmartForms 4.6.8 or earlier

 check

 check

Optional
The checkmarks above suggests the recommended installer for each scenario; however you can use the K2 Installation Package to update a K2 4.6.9 or greater installation if you choose to do so.
Note: The K2 4.6.11 update includes the hotfixes included in previous K2 4.6 Updates, so there is no need to install the previous updates.

What’s New in this Release?

There are several new features and enhancements available in this release.

Features Descriptions Documentation
Reporting License Report - A new report is available in the Licensing node in the Management Console in K2 Workspace which allows you to report on the status and usage of your K2 licenses. You can choose to show or hide user names.
Note: When upgrading to K2 4.6.11 and opening the License Audit Report for the first time, all users will by default display with the last log in date as the date of the upgrade as this is the starting point after which it will update as users log in.
License Report
Wizards For Each - In K2 Studio or K2 for Visual Studio workflow, create dynamic references and index fields to loop through items from an item collection. The item collection source list can be one of the following:
- Item Reference created in the workflow
- Item collection dragged and dropped from the Context Browser
- Semicolon (;) delimited text
Create Reference - In K2 Studio or K2 for Visual Studio generate dynamic item references against a SmartObject and then use the reference across different line of business applications. The Create Reference wizard automatically binds the SmartObject data to the workflow making the design process easier and quicker and eliminates the need to manually configure certain rules on a Form and the need to define each Data Field.
Escalations - Allows Item Reference values to be used for Redirect Escalations.
For Each

Create Reference

Redirect Escalation
Enhancements Descriptions Documentation
API Custom SmartWizards can now be designed to include a modal dialog control. Custom SmartWizard
Software Support Descriptions Documentation
Microsoft Visual Studio 2015 The K2 Designer for Visual Studio is available in Visual Studio 2015.
.NET Framework 4.6 The installer, K2 Server and K2 Studio, K2 for Visual Studio can be run on .NET Framework 4.6. Running K2 on Microsoft .NET Framework 4.6 requires a Microsoft Update
Windows 10 Windows 10 (Pro and Enterprise) support for:
Server Components
- K2 Server, K2 for SharePoint, K2 Runtime Web Services, K2 Workspace
- K2 Server components are supported on desktop OS for developer licenses or console mode only
Client Components
- K2 Studio, K2 for Visual Studio
EDGE is not supported, it is recommended to use an alternative browser such as Internet Explorer 11 that is installed by default on Windows 10.
Oracle Database 12c Release 1 (12.1) K2 now supports integration with Oracle Database 12c Release 1 (12.1).
Features Descriptions Documentation
New Wizards For Each - In a workflow create dynamic references and index fields to loop through items from an item collection. The item collection source list can be one of the following:
- Item Reference created in the workflow
- Item collection dragged and dropped from the Context Browser
- Semi-colon delimited text
Create Reference - Generate dynamic item references against a SmartObject and then use the reference across different line of business applications. The Create Reference wizard automatically binds the SmartObject data to the workflow making the design process easier and quicker and eliminates the need to manually configure certain rules on a Form and the need to define each Data Field.
SharePoint Wizards - In an environment in which SharePoint 2010 and SharePoint 2013 is configured, it is now possible to make use of both sets of wizards in the same workflow. Each SharePoint version specific set of wizards will appear simultaneously in the Workflow Steps of the K2 Workflow Designer in SmartForms. The SharePoint 2010 wizards are visible in K2 for SharePoint when the features for SharePoint 2010 are added. The SharePoint 2013 wizards are visible in K2 for SharePoint 2013 when the registration wizard completes for a site collection.
Image
For Each

Create Reference
Authentication SSO caching of credentials - When a Form executes a SmartObject from a Service Instance which is registered with SSO Authentication, a Login Credentials screen is displayed. Cache the login credentials by selecting the corresponding checkbox. 
The default caching period is 20 minutes, If the form is actioned again within the 20 minutes then a sliding expiration applies. If the form is inactive for 20 minutes it will ask for the credentials again. The credentials can also be cleared in K2 Workspace, via User settings> Single Sign-On.
SSO caching of credentials on Form Load
Enhancements Descriptions Documentation
K2 Designer K2 Designer - The following enhancements are available in the K2 Designer to improve usability:
- Landing Page - the landing page has been changed making it easier to navigate to the SmartObject, View and Form and Workflow designer. A recent items menu allows you to quickly and easily continue working on current artifacts.
- Grid - Right-click anywhere on the grid to open the context menu actions. The Grid refers to the page for My Items, All Items and Recent Items.
Image
- Keyboard Shortcut- A shortcut has been added to select all items on the grid. Use Ctrl +A.
- Deletion - all selected items on the grid can be deleted either by using the keyboard delete button or the delete toolbar button.
- Visibility - All Items and subfolders on the Parent Category are now visible in the grid.
- Category tree - Use the Search field to search for and select multiple items in the category tree and then perform context menu actions on the selected items.
- Filtering - Applying Category filtering will ensure that the grid and the category filter together allowing you to only seethe items you want.
K2 Designer Features
Runtime License The SmartForms Runtime License only allows for Data, Views, Forms and Workflows to be deleted, moved or executed (Run). It is not possible to edit or create new aritfacts with this license.
Controls Attachment Controls - Additional properties are available on the File and Image Attachment Controls to restrict the types of uploads. This allows you to manage both the file types and sizes being uploaded at runtime. Furthermore, certain harmful file formats can also be blocked through the Global Blacklist setting; and a Global File Upload restriction can be configured to a specific limit to allow for standardized files and file management. The global settings are available in the web.config file. File Attachment Control

Image Attachment Control
Performance Performance enhancements were made in SmartForms to improve the experience in design time and Forms rending for mobile devices.
Wizard enhancements Send Email - The ability to search for users and groups in the Context Browser has been added to the Send E-mail wizard.
Escalations - Allows Item Reference values to be used for Redirect Escalations.
Search for Users and Groups
Workflow Outcome Rules - The option to select 'None' has been added to the Action Statement of Outcome Rules.  Action Statement for Outcome Rules
Software Support Descriptions Documentation
Browsers The following browser versions are supported in K2 smartforms 4.6.11:
Internet Explorer 9
Internet Explorer 10
Internet Explorer 11
Chrome 44.0.2403.157 m
Firefox 40.0.2
Safari 7.1.8 or greater(Windows support deprecated. Latest Safari version is only supported on Mac)
Enhancements Descriptions Documentation
Controls Worklist Control - The Worklist Control has been enhanced by adding the ability to set the width of the columns in design time; as well as double - clicking on the column separator to automatically resize the column at runtime. Worklist Control
Features Descriptions Documentation
Wizards For Each - In a workflow create dynamic references and index fields to loop through items from an item collection. The item collection source list can be one of the following:
- Item Reference created in the workflow
- Item collection dragged and dropped from the Context Browser
- Semi-colon delimited text
Create Reference - Generate dynamic item references against a SmartObject then use the reference across different line of business applications. The Create Reference wizard automatically binds the SmartObject data to the workflow making the design process easier and quicker and eliminates the need to manually configure certain rules on a Form and the need to define each Data Field.
SharePoint Item level Permissions – In the SharePoint Add Permissions wizards for Documents, Lists and Sites you can now specify permissions dynamically for users and groups by using an Item Reference or toggle to the provided list to make a selection.
For Each wizard
Create Reference wizard
Add Library Permissions Wizard
Add List Permissions Wizard
Add Site Permissions Wizard
Add Documents Permissions Wizard
Workflow Outcome Rules - The option to select 'None' has been added to the Action Statement of Outcome Rules. Outcomes
Package and Deployment Default Form - When creating a package in K2 for SharePoint you can select a default Form for the package. Once the package completes deployment, the default Form will automatically be open. Deploying Application elements to different SharePoint environments
Enhancements Descriptions Documentation
Wizards Send Email - The ability to Search for users and groups in the Context Browser has been added to the Send E-mail wizard.
Escalations - Allows Item Reference values to be used for Redirect Escalations.
Adding recipients
SharePoint Template Support Support for the MySite Document Library template has been added. This allows you to add the K2 Application to the following sites:
    • SharePoint Online (O365) My Site.
    • OneDrive for Business Document Library.
    • SharePoint On- Premises My Site Document Library.
Note:
      You must create at least one group on your My Site to enable K2 integration as this is not automatically created as it is on team sites. Once you have created a group, assign Solution Designers and/or Solution Participant permissions to the group in the K2 for SharePoint Settings page.
Supported Artifacts
Features Descriptions Documentation
Additional languages Five additional languages have been added to the Language Pack. The K2 Language Pack allows for the standard SmartForms controls, the controls available in the SmartForms Control Pack as well as the K2 View Flow report and elements of the K2 Designer to display correctly in the following languages:
- Italian
- Portuguese
- Spanish
- Hebrew
- Czech

What’s been fixed in this Release?

K2 4.6.11 includes a number of bug fixes. Below is a list of the resolved issues by component.

Package and Deployment:

  • Various errors occurred when trying to create a Deployment Package for a solution last edited on K2 blackpearl 4.6.7 and K2 smartforms 1.0.6.
  • In K2 Package and Deployment, the SharePoint 2013 Create Package Validation Screen messages and popups now have more information.
  • When a Form is configured as "Default", a duplicate "/Runtime" value was added to the URL.
  • When deploying a SmartObject to an environment with a SmartObject that was exactly the same except for either the name or the GUID, the "Create New Version" option should not have been available.
  • K2 Package and Deployment threads aborted with an exception on Deploymentresolve.aspx after clicking Next.
  • In K2 Package and Deployment, an NLB Session name remains in the table after the session expires, resulting in session exists and Object Reference errors.
  • When editing a workflow after it has been deployed using K2 Package and Deployment, the Item reference checkbox was disabled.
  • When deploying a package of a K2 smartforms based workflow with many states, missing item references caused the deployment to fail.

Designers and Wizards:

  • In the Default Client Event Wizard in K2 Studio, when clicking Next after customizing the notification a long delay occurred.
  • In K2 Designer for Visual Studio, subsequent deployment of a process with SharePoint 2013 integration would fail as the SharePoint15.DeploymentTask.dll was locked.
  • When creating a workflow with SmartForms integration, the Format Date Time function did not accept a datetime field from an item reference.
  • When using the K2 Studio Object Browser, there was a performance issue when expanding the User Browser on an environment with a huge Active Directory structure.
  • An error was generated when using the context browser SmartObject list method as a destination.
  • K2 Designer for Visual Studio did not integrate with Microsoft Visual Studio 2015. Support has now been added.
  • Active Directory Groups with special characters are not escaped properly.

Installer:

  • After an upgrade install using the K2 Update Manager, the reboot message was not displayed.
  • CRC and KFX Checks have been added to the Update Manager.

Authentication:

  • The Saml2Security Token is rejected because the SAML2: Assertions's NotonOrAfter condition is not satisfied.

Brokers:

  • The Salesforce Broker did not support system.string[]. Support has now been added and the amount of data returned has been increased.
  • When using the SQL Service Service Broker, an error occurred when executing Update or Create for SQL Server datetime2 data type.
  • Update made to the SmartObject Services to make use of the OrderBy feature for Tables and Views.
  • Web Service Endpoint: Added the ability to set the Timeout Value when calling the Web Service via a SmartObject.
  • SharePoint Service CSOM: Lookup List Filter did not work with semicolons.

K2 Workspace:

  • In K2 Workspace, on the License Management page, the Licensed Users Count was incorrect.
  • Management Worklist: If a worklist item was assigned to an Active Directory Group, the release button was disabled.

Performance:

  • Performance issues experienced due to deadlocks on the K2 Database on the ProcInstData and IPCAsync tables. Error messages such as ‘Transaction (Process ID XX) was deadlocked on lock resources with another process and has been chosen as the deadlock victim. Rerun the transaction.at SourceCode.Workflow.Runtime.K2Sql.Log(Int32 id, Int32 pid, ArchiveX ar)’ could be encountered.

Controls:

  • When setting the Literal property of a control to true and adding HTML to the Text property of that control, the tooltip would display the HTML at runtime.
  • When adding Expressions to controls and navigating back to the Expression Builder, if an Expression had been used in a rule, the Expression Preview would display "Expression preview unavailable".
  • When upgrading to K2 smartforms 4.6.10, the tooltip of a Radio Button control would only display in a specific position.

Views and Forms:

  • When a View or Form used parameter mappings in filters or advanced filters in K2 smartforms 4.6.8, then upgrading to K2 smartforms 4.6.9, an object reference error would occur when trying to edit the View or Form.
  • Configuring a rule or mapping a control to a parameter on a Form with many Views that contain SmartObjects with numerous fields, caused the cursor response to be very slow when trying to map the fields from the Context Browser.
  • When using a List View containing a List control, and selecting to Show items from an associated SmartObject on the Configure Data Source dialog, would automatically add the action to populate the list control and in so doing duplicate the Execute List method in the rules.

Workflow:

  • When using the SmartForms integration wizard with a Form that contains data bindings, the error An item with the same key has already been added would occur.
  • When deploying a workflow for the second time, after editing the Form rules and adding an "Action a Workflow" action manually, the following error would occur: Error 2601, Level 14, State 1, Procedure aDeploy, Line 928Cannot insert duplicate key row in object 'Form.ActionItem_Design' with unique index 'UX_Form_ActionItem_Design_ID'. The duplicate key value is (5a75c68f-360c-4b62-bc5d-fe14b8ab8bf9)
  • When a workflow action appeared before a SmartObject action on an Initialize event, the workflow action completed before the SmartObject action and the initialize spinner was removed without waiting for the SmartObject action to be completed.
  • If the Managed User setting in K2 Workspace was selected, and a manager started a workflow, the workflow task could not be opened by anyone and an error stating "Unable to cast object of type 'System.String' to type 'SourceCode.Workflow.Client.User'" would occur.

Runtime:

  • When accessing two different smartforms sites on the same machine, the following error would occur:" ID4243: Could not create a SecurityToken. A token was not found in the token cache and no cookie was found in the context." 
  • If a user's Active Directory Organizational Unit (OU) name contains a forward slash, the user could not be authenticated and users are unable to use the Form.

Data:

  • Selecting more than 10 items on a Check Box List with a composite SmartObject data source caused an error: server Ajax execution failed

API:

  • If the K2 Host Server port setting was not set to 5555, an error occurred when running the ControlUtil to register a custom control. The error stated " SourceCode.Hosting.Exceptions.APICommunicationException: Error Receiving Buffer:..."

Rich Text Control:

  • When using a Rich Text control on a List View, the control would not render the data as Rich Text at runtime.
  • When running a Form with a Rich Text control on a Tab, the Toolbar Items, Edit Modes and Content Area would not be displayed.
  • When setting the Height property of the Rich Text control to 0, the control would not auto size at runtime. As this property cannot contain a value of 0 a validation message has been added to prevent the input of 0.
  • When using the Rich Text control in Internet Explorer 11 and creating data with multiple empty lines between lines of text, the spaces would be removed.

Reporting Controls:

  • Reporting controls did not return any results if the Regional format settings were set to English (Australia).
  • When using the Activity Instances Chart and switching to chart configuration at runtime, the size of the chart would not reset.

Worklist Control:

  • When running the Worklist control against a large number of worklist items, the control would timeout.

K2 Application:

  • When using the option to regenerate Forms or Views in K2 for SharePoint 2013, and certain Form or View rules did not have input or output mappings, those rules would be removed from the Forms or Views.
  • When trying to generate Forms at list or library level with K2 for SharePoint on a Non-English SharePoint 2013 environment, the following error would be displayed: "The requested item ID could not be found in collection".
  • When the Master Page of a Site Collection is changed and a user clicks on the K2 Application tab in the SharePoint UI an error occurs.
  • When running a form via K2 for SharePoint Application, parameters would not be passed to the form, even though the form was set to display the parameters.
  • When using the option to regenerate Forms or Views in K2 for SharePoint 2013, and certain Form or View rules did not have input or output mappings, those rules would be removed from the Forms or Views.
  • When sorting with page enabled, only the first page would be sorted instead of the entire dataset.

Brokers:

  • When using the SharePoint Broker to expose Term Sets, the Term Sets would not be exposed.
  • The SharePoint Broker could not return a Text value when given a GUID and a GUID when given a Text value.
  • The SharePoint Broker could not Read and Right to Managed Metadata columns.
  • The SharePoint Broker could not get the list of existing content types for a document library.
  • When executing the Get Users in Group Method via the SharePoint Broker, the broker would not return the users.

Workflow:

  • When using the SharePoint 2013 Process Wizard in a workflow, the wizard would not start the workflow after a new version of the workflow was deployed.
  • The "Share" workflow option in K2 for SharePoint Workflow Designer has been removed.
  • When using Permission wizards, the ability for the wizards to consume a reference of a user or group was not available.
  • In K2 for SharePoint, when adding a Get List item method from the Context Browser to a User task, the plugin would fail.
  • When running the AAD Configuration Wizard page at runtime, the SPGroupProvider forwarder entry would not be added. This would result in the SharePoint Groups not being returned in the workflow designer.
  • When an Item Reference is added to a workflow and the workflow is started, the reference field does not populate.
  • When using Document Library References to copy, move or upload a Document, using a document based on a reference was not possible.
  • When managing item level permissions the ability to dynamically control inheritance and permissions for specific users was not available.
  • When filtering a List based on a reference column by ID, the filtering would not work.

App Registration and updating:

  • When attempting to register the K2 for SharePoint App, the following error would be received: 'Cannot find stub for type with id'
  • When running the K2 for SharePoint Registration wizard on a sub-site, the registration wizard would not complete and would prompt for the Runtime URL to be entered once more when a sub-site containing the same URL name as the Explicit path name is used.
  • When running the K2 for SharePoint Registration wizard on a sub-site which contains an Ampersand (&) in its name, the following error would occur: 'Asynchronous operation failed'.
  • When updating the K2 for SharePoint App 4.6.9, the installer would not validate the supplied URL and would continue even though SSL was not enabled.
  • When deploying the K2 for SharePoint App, a Root site collection was required, this is no longer the case.

Authentication:

  • When external users try to access the K2 application via Anonymous access, the application would not load and would get stuck on the SharePoint Working on it… screen.
  • When Forms are set to' Anonymous Access', the user would get prompted to enter credentials, when uploading a document to a document library via K2 for SharePoint.

K2 Package and Deployment:

  • When using K2 for SharePoint Package and Deployment to deploy a package which contains a Managed Metadata property in a list, the deployment would fail and the Managed Metadata SmartObject cannot be rebound.
  • K2 for SharePoint 2013 Deployments cause memory leaks on the K2HostServer.exe process, eventually blocking any further K2 for SharePoint deployments.

Browsers:

  • When using IE11 and K2 for SharePoint, editing and finishing a form would add additional headers.
  • When opening forms in Internet Explorer 9, users experienced issues whereby they had to continuously use Ctrl+F5 to load the forms.
  • When using Internet Explorer 9, users were having issues opening the New, Edit and Display Forms even after authorizing their account.

Data:

  • When the GetLibrary method for a Library SmartObject is executed, the URL is incorrectly displayed.

What's been deprecated in this Release?
If you currently have made use of custom OAuthExtensions with logic in the Init method on the IHostableType interface in any K2 solutions, when upgrading to K2 4.6.11 these solutions no longer function as expected as the IHostableType has been removed. To fix the solutions you will need to change the related code and then recompile.

Known Issues

The following issues are currently known for K2 4.6.11 and include workarounds where possible.

There are no known issues at this time
There are no known issues at this time.
  • Reporting Controls: Currently the On Change event in the rules will not execute when any of the reporting controls are changed, but will rather execute when the controls are populated.
    Workaround:
    At the time of this version’s release date, there was no known workaround for this issue.
  • See KB001714 - Known Issue - Error on Runtime Forms when changing Generated Hyperlink Type to Hyperlink.
  • When Internet Explorer is used and the K2 smartforms Designer site has not been added to the Trusted Site with Active X enabled, errors will occur in the browser console when adding the K2 App to a SharePoint Site, registering the K2 App in SharePoint or when creating  or editing artifacts such as Views or Forms.
    Workaround:
    1. Add the K2 smartforms Designer site to the Trusted Sites in Internet Options > Security> Trusted Sites.
    2. Enable Active X controls and plug-ins for Internet Explorer in the Internet Options> Security> Custom Level >Security Settings – Internet Zone.
  • When executing a SharePoint Library’s SmartObject GetDocumentsMetaData method and apply Filtering using the LinkFileName property, with Paging==TRUE, a (400) Bad Request error occurs. This is a limitation in the SharePoint REST API which prevents K2 from using the 'LinkFileName' as a method filter which is required to allow for paging.
    Workaround:
    To filter on the SharePoint Document's name use the 'Name' field property as part of the filter instead of the LinkFileName.
  • No results are returned when building a List View using SmartForms against an Office 365 List that has paging enabled and the filter is configured on the 'Folder' property from the View Settings. View Settings filtering is configured by clicking the 'gear' icon on the View canvas.
    Workaround:
    Filter using Input Property values by configuring a rule on the SmartObject method during the 'Initialize' event of the View. You can Execute a Get List Item method and set the 'Folder' value on the Input Mappings page to the value of the folder.
    Recommendation: Use Input Mappings during an Intialize event instead of View Settings filtering.
  • Specifying a Default Calculated Value on a SharePoint column fails to set the default value on a New Item Form.
    Workaround:
    At the time of this version’s release date, there was no known workaround for this issue.
  • When K2 is upgraded to version 4.6.11 and there is an existing K2 App integrated with a SharePoint Contact List, an ‘out of sync’ message and link appears on the K2 Application page. However, the SmartObject is not out of sync.
    Workaround:
    You can safely ignore the message or click on the link to synchronize the K2 artifacts to clear the message.
  •  In K2 you are able to create a SharePoint List using custom List Templates that have been created in the K2 Workflow using the Create List wizard for example, however this functionality does not work as expected due to a limitation in Microsoft Client-Side Object Model (CSOM) which prevents the list from being created correctly.
    Workaround:
    There is no workaround at this time
  • An error is displayed at design time when the Tab Index property of a control is reduced to a value less than 1. The Tab Index property starts reducing automatically in a loop.
    Workaround:
    Set the browser's language to English to configure the Tab Index property. Once configured set the browser back to the original language.

Important Considerations and Breaking Changes
If you are upgrading from a K2 version prior to 4.6.10 it would be advisable to read the important Considerations section of the K2 4.6.10 Release Notes.

  • Upgrade: If a you had the 4.6.9 Package and Deployment rollup coldfix installed and have not upgraded to 4.6.10, you will need to use 4.6.11.1 to upgrade your environments.
  • License Audit Report: When Upgrading to K2 4.6.11 and opening the License Audit Report for the first time, all users will by default display with the last log in date as the date of the upgrade as this is the starting point after which it will update as users log in.
  • API: If you currently have made use of custom OAuthExtensions with logic in the Init method on the IHostableType interface in any K2 solutions, when upgrading to K2 4.6.11 these solutions will no longer function as expected as the IHostableType has been removed. To fix the solutions you will need to change the related code and then recompile.
  • Unattended Installer: In order to implement new features and resolve bugs new variables have been added to the installer in the 4.6.11 release. It is therefore required that any unattended files must be regenerated in this release to ensure that the full set of features and functionality gets installed.
  • Legacy databases: K2 recommends that if you are still running on multiple databases (legacy databases) that you consider consolidating your databases in this release or in the near future. In order to upgrade to a future Update, you will be required to be on a single database. An important note has been added to the K2 Setup Manager that will remind you to consider consolidating your databases if it detects legacy databases. If you have not yet consolidated your databases, you will need to use 4.6.11.1 in order to consolidate AFTER upgrading to 4.6.11. For more information, see KB001628 (http://help.k2.com/KB001628).
  • If you have upgraded to .NET Framework 4.6 ensure that you read KB001712 (http://help.k2.com/kb001712) and downloaded the available update.
  • When deploying a package that contained a large number of artifacts it would take a long time for the analysis to finish after each change if the Automatically re-analyze after each change checkbox was selected. By default this checkbox was selected when deploying a package. In K2 4.6.11 the default behavior has been changed and the Automatically re-analyze after each change checkbox is not selected when deploying a package. A blue Analysis Required icon will appear after changes are made in the deploy package, after which the Analyze button must be clicked. This allows you to make multiple changes in the package and then run the Analysis on the package once rather than after each change.
    Image
  • Unattended Installer: In order to implement new features and resolve bugs new variables have been added to the installer in the 4.6.11 release. It is therefore required that any unattended files must be regenerated in this release to ensure that the full set of features and functionality gets installed.
  • Additional file types have been added by default to the Global Blacklist setting in the web.config file. This could result in certain files that your solutions previously allowed to be uploaded to be blocked. For more details on the Global blacklist see the File Attachment Control topic.
  • Reporting Controls: Currently the On Change event in the rules would not execute when any of the reporting controls changed, but would rather execute when the controls were populated. The On Change event has been fixed in K2 4.6.11 to only execute when a selection is made. This would change the expected behavior that users are accustomed to and might require the Form rules to be adjusted accordingly.
  • Unattended Installer: In order to implement new features and resolve bugs new variables have been added to the installer in the 4.6.11 release. It is therefore required that any unattended files must be regenerated in this release to ensure that the full set of features and functionality gets installed.
  • The Language Pack only applies to K2 smartforms and K2 View Flow.
  • Runtime exception messages originating from the K2 blackpearl Server will still be displayed in English.
  • Localization support for the Design time is limited and areas of the Design time experience will still display in English after the K2 Language Pack has been installed.
  • If a multi-language Form is required, the Form and the Form Views must be designed in one language then copied and modified for each of the other languages you wish to support. Direct the user to the Form in the user’s language choice. During installation of the K2 Language Pack, select all the required languages to ensure that the required resource files are installed for the languages you wish to support.

Installation
Refer to the Installation and Configuration guides available on help.k2.com for the prerequisites and steps needed to install the various components. Before installing any of the K2 4.6.11 components, ensure the correct prerequisite software has been installed in your environment.
When installing K2 4.6.11 using the full installation package the following install order is required.

  • K2 blackpearl 4.6.11 (4.12060.1731.2)
  • K2 smartforms 4.6.11 (4.12165.1732.2)
  • K2 smartforms Control Pack 4.6.11 (4.13180.1733.2)
  • K2 for SharePoint 4.6.11 (4.13350.1734.2)
  • K2 Language Pack 4.6.11 (Preview) (4.13500.0.2)

Prerequisites:

See the K2 installation and configuration documentation for a full list of prerequisites. In this release the following prerequisites have been added or changed:

 - Microsoft Build Tools 2013 Redistributable or Visual Studio is required on the K2 server in a distributed environment. See KB001713 for more details.

Upgrades:

The K2 Update Package makes it easier and quicker to update your environment by adding new files and only updating files that have changed. The K2 Update Package updates all the K2 components (blackpearl, smartforms, Control pack, K2 for SharePoint) so you do not need to download and run multiple install files. Refer to the table in the Download section or to the compatibility matrix to see if your current K2 version can be upgraded to K2 4.6.11. The K2 Update Package automatically identifies what components are installed in your environment and will then update the components.

Note:  If you are on a K2 version prior to K2 4.6.9 you must use the K2 Installation Package to upgrade your environment.

Update Step: Run the K2 Update Package on each machine (e.g. servers, web servers and client machines) where K2 components are installed. The K2 Server must be updated first, then update all the other servers in the environment. If K2 for SharePoint 2010 or K2 for SharePoint 2013 in 2010 mode is being used, the K2 for SharePoint Configuration wizard needs to be run. The Finish Panel will display the link to launch the K2 for SharePoint Configuration Wizard. If K2 for SharePoint 2013 is installed the AppDeployment.exe will run directly after the K2 Update Manager has completed. For more information see the K2 Update Manager topic in the product documentation.

Additional information:

  • Upgrades: If you had the 4.6.9 Package and Deployment rollup coldfix installed and have not upgraded to 4.6.10, you will need to use 4.6.11.2 to upgrade your environments.
  • Upgrades: If you are upgrading your K2 environment be sure to upgrade all the K2 components to the same version.
  • Disable custom triggers on the tables in the K2 database. If Database Triggers have been added on the K2 Tables, which prevents the deletion or editing of these tables, when upgrading to K2 4.6.11 you will run into errors and the K2 Setup/Update Manager will not be able to override the triggers. It is recommended to disable the triggers first then run the K2 upgrade after which the triggers can be enabled again.
  • Run the K2 for SharePoint Configuration Wizard for SharePoint 2010. If you are upgrading from a version prior to K2 4.6.9 and you use K2 for SharePoint 2010, you will need to run through the K2 for SharePoint Configuration Wizard.
  • Run the AppDeployment.exe for SharePoint 2013. If K2 for SharePoint 2013 is being used, the K2 App will need to be re-deployed to the SharePoint App Catalog by running the Appdeployment.exe.
  • Update the K2 App and run the Registration Wizard. The K2 for SharePoint App will need to be updated, follow the steps in KB001661 to make the update. Once updated the K2 App should reflect the following version numbers:
    • K2 for SharePoint On-Premise - 4.4120.6.100
    • K2 for SharePoint Online - 4.4120.6.1
  • If your environment is using impersonation and Kerberos manual configuration is required when upgrading or setting up your environment. For more information see KB001607 – Delegation Settings to Allow Impersonation with Kerberos.
  • .NET 4.5 is required by the K2 Setup Manager.
  • If you are currently on Windows Server 2008 R2 you will require Windows Server 2008 R2 Service Pack 1 when upgrading.
  • The K2 Server (Host Server) requires .NET Framework 4.5. Ensure that you have .NET 4.5 installed on the server before upgrading or installing.
  • PowerShell 3 or higher is required by the K2 Setup Manager.
  • Refer to the Important Considerations section above before installing or upgrading.
  • Ensure that you have the correct permissions to run the install to avoid installation issues. For the correct installation permissions refer to the installation and setup guides.