What's New in K2 Update 19

New Features

The Designer

Style Profile Designer preview form: You can now select which form you want to view your customizations on in the preview pane of the Developer tab. This helps with troubleshooting while working on a specific form.

Behavioral Changes

Workflow Designer
- Changes in autosave:
  - The Workflow Designer previously used SignalR to autosave changes at every click. SignalR has been removed in this version to enhance performance in the Workflow Designer. The autosave that triggers every two minutes still remains.
  - If a workflow closes unexpectedly, it now remains locked and reverts to the last saved version. When you edit the workflow, a pop-up allows you to unlock it and retrieve the last saved version. The owner of the workflow can also unlock it from the workflow menu in the category tree of the Designer.

Deprecated functionality and components

Microsoft has ended support for Silverlight on October 12, 2021. As a result the legacy Silverlight designer will be removed from the product with the next release. Ensure you rebuild these in the Workflow Designer (HTML).

Considerations

The Style Profile Designer is not available in Internet Explorer (IE), as it uses CSS custom properties (CSS variables) which is not compatible with Internet Explorer. We suggest you use a modern browser for the Designer, such as Google Chrome.
Download the enhanced Package and Deployment tool from https://<runtimeurl>/Management/Remote. Once downloaded, log a ticket with Nintex Customer Central to provide your public IP address ranges to Nintex K2Operations. This allows access to your Nintex K2 Cloud environment from your network. Please see the Package and Deployment Considerations topic for further considerations about working with the Package and Deployment tool.
If you are using K2 for SharePoint, you must run through the K2 for SharePoint registration wizard after upgrade. See the following steps:
1. Click the K2 for SharePoint app from the Site Contents page or Quick Launch menu of the app catalog site and run through the Registration Wizard by clicking the Registration Wizard link in the Administration section to register the app with your environment's URL. (If you do not see the Registration wizard, make sure you are on the app catalog).
2. (This step is only required if there were changes to the K2 for SharePoint app. See the K2 for SharePoint release notes for information about previous releases and the latest version.)
  Deploy the app to one or more site collections using the Manage App Deployments page in SharePoint. A link to this page is provided on the K2 for SharePoint settings page. It is recommended you do this by paths rather than individual URLs, but individual URLs give you more control regarding which site collections have Nintex K2 Cloud integration. You should deploy as a SharePoint Administrator if you are deploying to multiple site collections.
If you replace an existing Task step with a new Task step in a workflow, and the Form rules of the existing SmartForm Task remain but it shows the new Task’s name, follow the following article to successfully fix the issue: Known Issue : Old Workflow Task name in SmartForm overwritten by new Task

Known Issues

Issue: When you configure a specific custom workflow step created for a single SQL Service Instance and Service Object in a workflow, the configuration panel allows you to select a service instance that is not linked to the specific custom workflow step.

Bug Fixes

Each release includes all bug fixes from preceding releases; see the release notes for previous releases for more details on bug fixes in previous versions. Update 19 includes the following additional bug fixes:

All bug fixes in K2 Cloud Update 18 Fix Packs 1-15.
When using K2 for SharePoint such as activating a new site collection, the following error occurred: "10521 SmartObject Runtime.Management General Error: 'Parameter is invalid.\nParameter value: '00000000-0000-0000-0000-000000000000' Parameter name: resourceId".
When trying to access a form at runtime and clicking the link to generate an OAuth access token, an “HTTP Error 400. The size of the request headers is too long” error occurred.
When scrolling on a form containing an Editable List View with a “When View List Item Double Clicked” rule, the scrolling was recognized as a click event and the rule triggered.
Slow performance experienced in the Workflow Designer when using a custom rule on a Decision step that contained multiple outcomes.
When creating or editing a style profile, or accessing a form at runtime that contains a style profile, the following error occurred: ” SourceCode.Forms.Runtime.ClientServer.GetStyleProfile(string culture, Guid guid, string name, int version)","21120 Logging Framework Error …“.
When AAD users tried to access K2 for the first time, the following error occurred: “64005 Failed to resolve 'AAD:{username}': Code: InvalidAuthenticationToken Message: Access token validation failure. Invalid audience”.
When using the Management>Workflows>SmartObjects>Worklist Item SmartObject and executing the GetWorklistItems method that contained more than 95 custom filters, the following error occurred: “62282537","2022-08-18 15:04:53","Error","Communication","8130","ConnectionPacketError","SourceCode.SocketService.Legacy::HandlePacket","8130 Error processing message from 192.168.1.39:54026: Incorrect syntax near ')'.”.
When using the “Not Equals” parameter in an “an advanced condition is true” rule condition to compare an empty Calendar control value with a non-empty Calendar control value, a false value was returned.
When executing a SmartObject of the Oracle Service Type, an “Arithmetic Overflow Error” error occurred.
When creating an Oracle package and then updating the Oracle service instance and setting the “Get Packages” service key setting to True, the following error occurred: “Object reference not set to an instance of an object”.
When an Out of Office task is forwarded to a user, the user could not access the task and an “Unable to cast object of type 'SourceCode.Forms.Runtime.Execution.WorkflowBrokerMetaData' to type 'SourceCode.Forms.Runtime.Execution.SmartObjectBrokerMetaData'." error occurred.
Unable to upload a file using the File Attachment control while not connected to a VPN.
When enabling a previously scheduled workflow by checking the Management>Workflow Server>Schedules>Enabled setting, the schedule did not start.
When using a custom theme and configuring a rule to change the background color of a button with conditional format configuration, the conditional formatting did not apply.
When using an Editable List View and disabling the header of a column by unchecking the Enabled property in the column's Header tab, the header of that column was not disabled at runtime.
When configuring start and end time values in the Configured Days and Times section of Management>Workflow Server>Working Hours, an invalid time span could be configured, for example Start Time: 2:00 PM, and End Time: 10:00 AM.
Dependency issues were shown when editing a rule, making no changes, and then closing the rule.

Fix Packs

The following Fix Packs apply to this version of K2 Cloud. To determine the version and Fix Packs applied to your environment, please see the KB article KB003537: How to determine the installed K2 software version, Cumulative Updates, and Fix Packs for K2 Platform and K2 Cloud

Fix Pack	Release Date	Details
Fix Pack 14	November 2023	When trying to run a List view, a “Could not construct view: Object reference not set to an instance of an object” error occurred at runtime. An “OAuth token requires authorization.” error started occurring if you had a SharePoint service running many workflow instances.
Fix Pack 13	October 2023	When configuring multiple values for a variable in a Set Variables step in a workflow, and dragging one of the values into a function value of the variable, a text value of “configuredSmartField” was shown instead of the function. When executing the Update method on a Salesforce SmartObject, and changing the “Date” field value to NULL or an empty value, an “Invalid Date” error occurred.
Fix Pack 12	October 2023	When trying to edit a workflow in SharePoint, the edit buttons did not respond. When using the OData API v4 endpoint and executing the RedirectWorklistItem method in Postman, an “ An error has occurred” error was shown in Postman.
Fix Pack 11	September 2023	When a Workflow Task step is assigned to a user’s FQN(Fully Qualified Name), an “The parameter ‘addresses’ cannot be an empty string. Parameter name: addresses” error occurs and is shown in Management > Workflow Server > Workflows > Errors. When a workflow contains a Task step where the priority level is set to High, you edit the workflow and select another priority level, the following errors showed in the workflow designer error console: "TypeError: Cannot read properties of undefined (reading 'icon')" "ERROR TypeError: Cannot read properties of undefined (reading 'next')" "Uncaught TypeError: Cannot set properties of undefined (setting 'height')"
Fix Pack 10	September 2023	When configuring a step in a workflow, and the step contains a workflow field with text that has HTML styling, the HTML tags are removed when deselecting the step.
Fix Pack 9	September 2023	When a workflow contains a Create Reference step, you configure the step to use a SmartObject List method to return data, and you filter the data using a Boolean value, a “ERROR at Row:1:Column:13636 value of filter criterion for field '[field name]' must be of type boolean and should not be enclosed in quotes, InnerException Message:” error occurred and was shown in Management > Workflow Server > Workflows > Errors.
Fix Pack 8	August 2023	After applying Update 19 Fix Pack 5 and trying to open a form at runtime, an "Uncaught TypeError: Cannot read properties of undefined (reading 'getAttribute')" error occurred.
Fix Pack 7	August 2023	When configuring a filter on a Get List method in a rule action and typing a value, the typed value was no longer visible when editing the view and changing the filter to an advanced filter. A workflow contains a Create Reference step and two Loop steps. You use the same item reference for the list in both Loop steps. A list item reference is automatically created for the first Loop step. When selecting the same item reference for the second Loop step, the list item reference is not created automatically and clicking the Create link did not create a list item reference.
Fix Pack 6	August 2023	When configuring the Watermark property of the Rich Text control and using the control on a form, then applying a style profile to the form, the watermark did not show at runtime.
Fix Pack 5	July 2023	When using K2 Package and Deployment to deploy a package containing a workflow with a Send Email step, and you deploy the workflow on the target environment, the email recipients changed for example "Originator" changed to "Email" and roles were removed, leaving the fields blank. When you have associated SmartObjects and you use an associated field multiple times in a List view, the Quick Search at runtime showed the Field names and not the List Column's Header name.
Fix Pack 4	June 2023	The process of mapping multiple variables with long names in a mapping field in the workflow designer was difficult. When configuring a step in the workflow designer, the Title input mapping field did not show in the Configuration panel. When executing the Azure Active Directory User SmartObject > Get Users in Group method against an AAD group, the method returned members who were not part of the group. After upgrading to K2 Cloud Update 19, existing SharePoint workflows could not be started manually, and existing SharePoint workflow instances did not show in reports.
Fix Pack 3	June 2023	When dragging a REST service Service Object into the Methods section of an Advanced SmartObject, manually mapping a parameter to a property, and clicking the Finish button to save the mappings, the Finish button did not respond.
Fix Pack 2	May 2023	When starting a workflow instance of a workflow containing a Send Email step, emails were not sent successfully, and the instance remained in a “Running” state. If the issue persists after applying the fix pack, you can configure the Retries and StopWorkflow properties. This will ensure that the workflow stops after the specified retries. Follow the steps below to apply the configuration: Locate the ConnectionStringEditor.exe file found in C:\Program Files\K2\Host Server\Bin and open the application. Select SourceCode.MessageBus.Ews.ExchangeWebservicesDestination (username). Specify a value for the Retries property. This can be any number > 1. Type True for the value of the StopWorkflow property. Save the configuration When creating a custom workflow step and selecting a Service Type from the Create tab of the custom step management form, the Service Object drop-down list did not show all the related Service Objects. See Known Issues section.
Fix Pack 1	May 2023	When updating a SmartObject’s Record Limit in the Endpoint Data Limits section in Management >Integration>APIs>SmartObject OData, a message containing “false” is shown. When a package is created for a workflow containing a SmartObject, of which some properties were deleted, a “Process is referencing the ... property on the ... SmartObject that could not be found.” error occurs. When using SmartActions, a "SecurityToken has Expired" error occurred intermittently. A form contains two views. One view contains a Calendar control and a Timer control. A rule transfers the value of the Timer control at a set interval to the Calendar control. The second view also contains a Calendar control. When selecting a value for the Calendar control in the second view at runtime, the value did not save. When trying to edit a workflow in Designer, the workflow failed to load and a white screen was displayed. When configuring the Variables of a SmartObject step in a workflow, the drop-down list did not expand. When unchecking the Legacy Theme form property, the styling of drop-down lists did not show correctly at runtime. When trying to delete a workflow from K2 for SharePoint, workflows were referenced that did not contain any dependencies to the workflow being deleted.

What's New in Nintex K2 Cloud Update 19