Nintex K2 Cloud (SPFx) app overview

From Nintex K2 Cloud Update 21 onwards there are two different apps for SharePoint Online. The legacy Nintex K2 Cloud for SharePoint app: used for SharePoint upgraded tenants, and the Nintex K2 Cloud (SPFx) app: used for new tenants.

Microsoft SharePoint continues to evolve with updated authentication and better methods of performing core functions. The app is built to use these new technologies and maintain integration.

Existing customers upgrading to Nintex K2 Cloud Update 21 use the legacy app from the SharePoint App Catalog for all SharePoint environments. New tenants from Nintex K2 Cloud Update 21 onwards use the new Nintex K2 Cloud (SPFx) app.

SharePoint Framework (*.sppkg) app

The app uses the SharePoint Framework extension model that allows for full page, client side customization of SharePoint, including web parts, forms, command bars, and context menu items. The legacy Nintex K2 Cloud for SharePoint app uses the add-in model introduced with SharePoint 2013.

The new app integration is configured in Management using feature activation. With SharePoint feature activation you configure the server and then activate your site collections. You can also synchronize groups and uninstall artifacts from your site collections. For more information see SharePoint Online Feature and Add the app.

Workflow integration

The Nintex K2 Cloud (SPFx) app integrates SharePoint workflow events using Webhooks rather than the remote event receiver used by the legacy app. For more information see Nintex K2 Cloud (SPFx) app Webhooks Events.

The following Designer action is currently not supported:

SharePoint > Document Library:

  • Discard Document Check Out

Modern Forms

As the Nintex K2 Cloud (SPFx) app allows for full page customizations, SmartForms no longer use hosted *.aspx pages. Form sizing renders on the page width, providing an improved mobile experience.

Package and Deployment

SharePoint artifacts cannot be packaged from a legacy site and deployed to a site that uses the Nintex K2 Cloud (SPFx) app integration. Your package must be created and deployed in environments using the same SharePoint integration app.

SharePoint workflows using Webhook events are included in the package, and Package and Deployment is able to use existing subscriptions on the target environment, create new subscriptions as needed, and update or override existing subscriptions.

For steps on resolving issues see SharePoint Online considerations.

Considerations

  • You cannot use both the legacy Nintex K2 for SharePoint app AND the Nintex K2 Cloud (SPFx) app in one environment.

  • An item was checked in workflow event - Only the Check in Document Webhook event executes. Sometimes due to a latency or sync with Microsoft, the Update Document Webhook event will also execute.
  • An attachment was added to the item workflow event – This event may not execute in some instances. This is due to a latency or sync with Microsoft and Nintex K2 has no control over it.
  • If you activate the setting in the SharePoint library to automatically check out documents and a new document is added or uploaded to a Document Library, the Document is checked-out by default. In this instance, the Check out Document Webhook event does not execute and an "...odata.error..." error shows in the Event Viewer. This is expected due to the server processing the event using the Service Account. When the Document is checked in, the Check in Document Webhook event will execute.