Add the K2 Five Web Parts

After the app is activated to your site collection and subsites, the web parts (the K2 Worklist and the K2 SmartForms Viewer) can be added to the sites. The K2 web parts are located in the Web Parts section in the SharePoint ribbon.

Permissions

In order to add the K2 Web Parts to your sites, the following permission is required:

This permission is required for users who are not the SharePoint Administrator or reside in the Owners Group and who need to add the K2 web parts to pages in the site. For example, if the user resides in the Portal Members group which has Edit rights and needs to add the K2 web parts, the above mentioned permission is required. If the permission is not set for that user the following message appears after adding the K2 Web Parts:

To view and use a K2 Web Parts on subsites with broken inheritance, Read rights are required on the root site.

Add Permission

Follow the below steps to add the Add and Customize Pages permission:

  1. Navigate to Site Settings > Site Permissions > Permission Levels and  click the Permission Levels link. For the purpose of this example, the user that adds the web parts to the page resides in the Portal Members group which only has Edit rights. Click the Edit link.
  2. On the Permission Levels > Edit Permission Level page, scroll to the Site Permissions section and select the Add and Customize Pages permission.
  3. Click Submit at the bottom of the page.
  4. If you are using SharePoint Online, additional configuration is needed. Follow the steps below to configure K2 Web Parts for SharePoint Online:
    Steps 1 through 3 above are necessary before doing steps 5 through 11.
  5. Go to the SharePoint Administration Center.
  6. Click Settings.
  7. In the Custom Script section select the Allow users to run custom script on personal sites and Allow users to run custom script on self-service created sites.

    Any change to the scripting settings made through the SharePoint Online Administration center may take up to 24 hours to complete.
  8. Download the SharePoint Online Management Shell from Microsoft. Open SharePoint Online Management Shell and run the following PowerShell script:
    Connect-SPOService
  9. Enter the URL of your Administrator site:
    https://[yourdomain]-admin.sharepoint.com
  10. Enter your username and password.
  11. Enter the following PowerShell line ensuring that the DenyAddAndCustomizePages is set to False.
    Set-SPOSite -Identity https://[yourdomain].sharepoint.com -DenyAddAndCustomizePages $false
    Make sure the scripting setting in the admin portal matches what you have set using PowerShell. If you don't do this the site collection setting may be overridden again in the next 24 hours.

Troubleshooting

The following section discusses various troubleshooting steps regarding K2 Web Parts.

Duplicate Web Parts

If any user adds the K2 Web Parts without the Add and Customize Pages permission, the web part remains in a broken state and must be removed. If this is not done, and a user with the Add and Customize Pages permission adds the K2 web parts, the web parts are duplicated, so be sure to remove the broken web part.

Add the K2 Web Parts

Follow these steps to add K2 Web parts to your sites in SharePoint:

When upgrading the K2 Five app, all current app parts are removed and require manual configuration of the page to add the web parts.

  1. Open the site where you want to add the K2 web parts.
  2. Click on the Page tab, and then the Edit button in the SharePoint ribbon.

  3. Click the Insert tab, and then the Web Part button.

  4. In the Categories section, select the K2 folder, and then in the Parts section, select the web part and click Add.

  5. The web part is added to the page.