Archive: Nintex Automation K2 Knowledge Articles

ProblemAfter installing the July 11, 2023—KB5028169 (OS Build 14393.6085) on a Windows Server 2016 hosting the K2 application server, the 'K2' Classic Application Pool used to host the legacy K2 API endpoints may crash when accessing the [K2 URL]\/K2Services/WCF.svc endpoint. SolutionThe issue appears to be directly related to Microsoft July 11, 2023 — KB5028169. Uninstalling the update or installing the newer August 8, 2023—KB5029242 (OS Build 14393.6167) instead will resolve/avoid this issue.

 Known Issue: Random ListView SortingKB003706PRODUCTAutomation On-PremBASED ONAutomation On-Prem IssueWhen a SmartObject that contains an SQL sort parameter is associated with another SmartObject that does not contain a sort, creating a View of the associated SmartObject without a sort rule returns random sorting outcomes.    ResolutionA sorting rule must be specified on the view, see List View Settings (nintex.com) for more information. 

KB002322PRODUCT: K2 CloudK2 FiveSEE ALSO: Debug Utility This article contains debugging tips and checks to perform when you get errors trying to install Apps from the App Catalog. Please review these tips and hints to troubleshoot installation of Apps from the App Catalog before you log a support ticket with K2. Verify that your K2 version is supported The App Catalog supports the following versions of K2:   K2 Product   Version   Build Number K2 Five 5.1 5.0002.1000.x K2 Cloud Update 4 5.1004.1000.x  Check that you are able to reach the App Catalog URL Using a web browser" try to browse to https://appcatalog.onk2.com. If you are prompted for a certificate the service is reachable. (This article only describes how to check if your K2 environment is able to reach the K2 App Catalog service. The article will not explain or set up certificates in your environment or explain how to configure firewalls.) You should see one of the following two outcomes. If eith

KBS100134PRODUCT: K2 Cloud Update 4, K2 Five 5.1 This article was created in response to a support issue logged with K2. The content may include typographical errors and may be revised at any time without notice. This article is not considered official documentation for K2 software and is provided ""as is"" with no warranties.IssueK2 Five 5.1 and Cloud Update 4 introduced a bug where workflow deployment will fail with an error like ‘Missing reference at activity [ActivityName]"/ This error occurs if you created third/successive manual actions (associated with Task Results) on a user task step in the workflow designer. When you deploy the workflow" the Missing reference error appears. SymptomsYou see the error when trying to deploy your workflow (where the activity and item names are specific to your process). ResolutionAfter creating actions from the Task tab (A), switch to the Results/ Voting tab (B). Rename the second and successive Task Results (renaming first Task Result is optiona

KB003227PRODUCT: K2 Five 5.3K2 blackpearl 4.7 This article lists the differences between the K2 4.7 and K2 Five (5.3) databases in terms of Tables" Views and Stored Procedures. You can scroll through the content or use your browser's CTRL+F search function to find the item you want to check.This article only lists the names of tables views and stored procedures in both versions' K2 databases. If you need to compare schema or other differences between artifacts in the databases (for example comparing the columns in a specific table) you can use SQL management tools to generate scripts for the specific artifacts that you want to investigate from the different K2 environments and then compare the scripts.If necessary you can install K2 Five with an evaluation license to generate the K2 Five databases and then generate K2 Five scripts from that evaluation environment. Clicking on the table header row sorts the table by that column. Because of the amount of data in the table sorting can tak

 Known Issue: Visual C++ Redistributable error when applying K2 Five 5.4 March 2022 Cumulative Update Fix Pack 11KB003702PRODUCTAutomation On-PremBASED ONAutomation On-Prem IssueWhen installing the K2 Five 5.4 March 2022 Cumulative Update Fix Pack 11, the installer checks the version of Visual C++ Redistributable for compatibility with your current version of K2. If the installed version is a newer version compared to the one required by the Fix Pack, which is 2019, an error shows in the Configuration Analysis Tool on the Installation Health screen. The error is caused by the K2 Setup Manager failing on an internal check as it does not recognize the newer version of Visual C++ Redistributable. If the version of Visual C++ Redistributable is newer than the current version (2019) used by K2, all services will continue to function normally.    ErrorMultiple errors can be encountered due to this issue. The error below is an example of one: The error states “K2 PDF Convertor Service can’t u

KB002336PRODUCT: K2 Cloud, K2 Five K2 Cloud Update 4 and K2 Five 5.1 introduced the Favorite Apps workspace. This change was implemented to separate the experience of creating and administering Apps (using the Apps workspace)  from users who will use the Apps (using the Favorite Apps workspace). End Users will now use the Favorite Apps workspace to open Apps.Please read the full article in the attachment below. 

KB002322PRODUCT: K2 Cloud, K2 FiveSEE ALSO: Debug UtilityThis article contains debugging tips and checks to perform when you get errors trying to install Apps from the App Catalog. Please review these tips and hints to troubleshoot installation of Apps from the App Catalog before you log a support ticket with K2. Please read the full article in the attachment below. 

KB002453PRODUCT: K2 Five 5.0, K2 Five (5.0) Fix Pack 25 LEGACY/ARCHIVED CONTENTThis article has been archived, and/or refers to legacy products, components or features. The content in this article is offered "as is" and will no longer be updated. Archived content is provided for reference purposes only. This content does not infer that the product, component or feature is supported, or that the product, component or feature will continue to function as described herein. Issue DescriptionWhen you start a K2 Workflow in K2 Management site that contains references from SharePoint Management steps, an incorrect URL is populated which causes an error. Error MessageThe following error occurs: “Error retrieving Service Instance – [SharePoint Site URL]_Sites_[Site Name]_[List/Document Library Name]” CauseK2 Runtime URL build-up was adding URL property to reference. ResolutionEnsure you have K2 Five RTM installed. Get the K2 Five RTM FP25 from Regional Support. Install the K2 Five RTM FP25 to a

KBS100063PRODUCT: K2 Five 5.0, K2 blackpearl 4.7BASED ON: K2 Five 5.0 This article was created in response to a support issue logged with K2. The content may include typographical errors and may be revised at any time without notice. This article is not considered official documentation for K2 software and is provided "as is" with no warranties. IssueAn expression is used to copy the value from a Text Area to a Data Label. The Data Label is in the same K2 Designer Layout cell as the Text Area. When a rule is used to hide the Text Area and Show the Data Label, the Data Label is not populated with data. If the Data Label is in a different K2 Designer Layout cell, it is populated with the correct data.SymptomsThe issue only appears under the following conditions: 1. The Text Area needs to be above the Data Label in the same K2 Designer Layout Cell.2. Initially the Text Area is set to visible and the Data Label is hidden.3. The Text Area Watermark value is configured to be blank.4. An 'Exp

IssueOn a 5.3 environment, performing a sync using the Sync Service Operation SmartObject's Start Sync method against the AAD provider throws an error. Error CodeThis is the error shown in the HostServer logs:Execute 'RunSyncJob' Error : Could not load file or assembly 'SourceCode.Sync, Version=4.2.9.0, Culture=neutral, PublicKeyToken=c323d472a7df518e' or one of its dependencies. The located assembly's manifest definition does not match the assembly reference. ResolutionCheck the version of SourceCode.Sync.dll assembly in the following location on the app server: {K2 Install Folder}HostServerBinIf there is a discrepancy, please replace the SourceCode.Sync.dll assembly with the correct version 4.2.9.0 as indicated in the error message. Additional InformationIf a re-configure was ran via the K2 Setup Manager at some point prior to seeing the issue, please re-apply the same CU/FP on the environment which should then update the SourceCode.Sync.dll assembly to the correct version as well.  

 Known Issue: How to run a secondary runtime siteKB003696PRODUCTK2 FiveBASED ONK2 FiveIssuePreviously in K2 Five (5.3), IsNotEmpty and IsEmpty would not function as the expression name stated under certain circumstances and would rather perform the opposite of their expression name. This meant that a string that would be empty would return as true for IsEmpty and false for IsNotEmpty. ResolutionRun a show message for a data label control to check if a string does/does not exist within it. Verify that the IsNotEmpty/IsEmpty expression returns the correct function value based on the data label control.

 Data not showing when using a combination of the column width and margin in a list viewKB003687PRODUCTK2 CloudBASED ONK2 CloudIssueWhen using a combination of the Body column Width setting and Margins setting on the same column in a list view, the data does not show for that column at runtime.The images below show the combination configured for the Customer column in a list view.ResolutionThere is currently no resolution. We recommend you use only one of the two settings.

 Data not showing when using a combination of the column width and margin in a list viewKB003686PRODUCTK2 FiveBASED ONK2 FiveIssueWhen using a combination of the Body column Width setting and Margins setting on the same column in a list view, the data does not show for that column at runtime.The images below show the combination configured for the Customer column in a list view.ResolutionThere is currently no resolution. We recommend you use only one of the two settings.

 How To: Implement Custom Submit and Close LogicKB001723PRODUCTK2 Five Use CaseWhile required fields are great for fields that will always need to be filled out, sometimes you’ll want to require fields using logic instead. This will allow forms to be submitted without values until they are required. Custom submit logic creates a better user experience and can also control where the user ends up after they submit an entry. In this how to:Creating custom validation Configuring a message Stopping rule execution Closing the browser Navigating to another URLThis how-to uses the Item Review Accelerator as the starting point. To follow along, deploy the Accelerator and name it Incident Report. To find out more about using the Accelerators in your solution, use this link: http://help.k2.com/onlinehelp/k2appit/UserGuide/current/default.htm#App_Templates/App_Templates.htm  Creating the Incident Report ApplicationIn the first part of this how-to, we will add fields to the Incident Report list and

TopicThe SaveAsPDF control utilizes the ExpertPDF HTML to PDF Converter. By default, ExpertPdf automatically inserts page breaks when needed, paying attention not to break lines of text or images. InstructionsCustom page breaks can be added using simple page-break-before and page-break-after css styles. Please refer to an example explained in the following article:http://www.expertpdf.net/expertpdf-html-to-pdf-converter-page-breaks/ Related Linkshttps://www.expertpdf.net/expertpdf-html-to-pdf-converter-page-breaks/  

 How To: Building Forms Using ViewsKB001722PRODUCTK2 Five Use CasesViews are a way to interact with your data. Each form is comprised of 1 or more views. This how-to will focus on how to utilize views in your designs, and where to place logic in your designs. This how to has been broken down into the following areas:   Creating a customer information view Adding the customer view to a form Adding a view to display related recordsThis how-to uses the IT Support Ticket Accelerator as the starting point. To follow along, deploy the Accelerator. To find out more about using the accelerators in your solution, use this link: http://help.k2.com/onlinehelp/k2appit/UserGuide/1.3/default.htm#App_Templates/App_Templates.htm  Creating a Customer Information ViewCustomer information is useful in many processes to give the assigned person information about who submitted the support ticket. This information should not be saved, but will need a view to display in the IT request. Therefore, we will cre

TopicDoes K2 support .NET Core 3.1 on older versions prior to K2 Five (5.5)? AnswerNo, there will be no support for .NET Core 3.1 on older versions of K2. Older K2 versions was created for .NET Core 2.1 and we do not do technical upgrades on older versions. Only the most recent version will get the most features, technical or otherwise. K2 Five (5.5) will be the first version to support .NET Core 3.1.Related Linkshttps://help.nintex.com/en-US/k2five/icg/5.5/default.htm#Whats-New.htm?TocPath=_____3

 Workflow disappears from SharePoint Artifacts Pagekbt172753PRODUCTK2 FiveThis article was created in response to a support issue logged with K2. The content may include typographical errors and may be revised at any time without notice. This article is not considered official documentation for K2 software and is provided "as is" with no warranties.IssueA workflow that was on the Artifacts page in SharePoint is missing. Please note these troubleshooting steps outlined here are for the Legacy Silverlight Designer only. SymptomsThe Workflow is missing from the K2 Artifacts page. The workflow can not be found in Designer either even when searched for. Troubleshooting Steps1. Start by making sure the Workflow exists in the Designer.ProcessXML table. If it does, the issue is probably due to duplicates in a table.2. Next, check the Designer.ProcessSharing table to see if the correct user is listed in the UserName column. Take a screenshot of this. If you are seeing the incorrect user for the

IssueAfter installing K2 blackpearl 4.7, K2 service is unable to start. The following error is thrown in the HostServer logs: "Error","System","2010","TypeLoadError","SourceCode.Hosting.Server.Runtime.HostTypeLoader.LoadHostableTypes","2010 Type Load Error, Method 'GetClassAce' in type 'SourceCode.Authorization.Service.AuthorizationService' from assembly 'SourceCode.Authorization.Service, Version=4.0.0.0, Culture=neutral, PublicKeyToken=16a2c5aaaa1b130d' does not have an implementation." DiagnosisThis error indicates that there is a missing dependent assembly in the GetClassAce method in SourceCode.Authorization.Service.dll. The GetClassAce method depended on this assembly: SourceCode.Authorization.Interfaces.dll. We found this assembly present in the following locations: [Program Files]K2 blackpearlHost ServerBin [Program Files]K2 blackpearlHost ServerBinhostedServices C:WindowsMicrosoft.NetassemblyGAC_MSILSourceCode.Authorization.Interfacesv4.0_4.0.0.0__16a2c5aaaa1b130d The SourceCod

TopicWhen creating an OData Service Instance to an outside web service, the following error is seen. The row and character number may differ.  "VALIDATIONEncountered the following errors when parsing the EDMX document: UnexpectedXmlElement : The element 'edmx:Edmx' was unexpected for the root element. The root element should be Edmx. : (1, 40)".InstructionsDepending on the OData Service K2 is connecting to, there may be a need to pass a Default Request header with Logins or any number of things required by the OData Service. The error above is a generic error pointing to incorrect configuration. The following should be checked. - Default Header does not have any syntax issues.- The correct username and password are being passed. - What properties the OData Service is expecting and making sure they are in the Header.  Related Linkshttps://help.nintex.com/en-US/k2five/userguide/5.4/default.htm#ServiceBrokers/OData/K2ODataServiceBroker.htm?TocPath=Administer%257CK2%2520Management%257CInte

 KB001751 - OAuth authentication with Azure OData Web ServicesKB001751PRODUCTK2 FiveSEE ALSOKB001702 - How to configure OAuth in K2 KB001688 - Authentication and Authorization in K2TAGSIntegrationIdentity IntegrationLEGACY/ARCHIVED CONTENTThis article has been archived, and/or refers to legacy products, components or features. The content in this article is offered "as is" and will no longer be updated. Archived content is provided for reference purposes only. This content does not infer that the product, component or feature is supported, or that the product, component or feature will continue to function as described herein. This article describes how to: configure an OData web service (hosted in Microsoft Azure) to authenticate using OAuth configure an OAuth resource in K2 for the OData Service in Azure use the OAuth resource to configure a service instance of the OData EndPoint Service Broker to interact with the OData service in Azure using OAuth for authentication    The scre