Lifecycle Management of SharePoint with K2 Integration
This topic discusses managing a K2 Five for SharePoint environment, specifically for the following administrative tasks:
- Adding new site collections and subsites
- Managing the K2 Five app on the app catalog site
- Managing the K2 Five app on a site collection
- Managing the K2 Settings page for the K2 Five app
- Permissions
Adding a new Site Collection after K2 Five Integration
After initially integrating K2 Fivewith a SharePoint environment, you can integrate new site collections with K2.
Scenario
After a SharePoint environment is integrated with K2 Five, you create a new site collection via the SharePoint Admin Center. You now need to integrate this new Site Collection with K2 Five.
Steps
- After creating the new site collection, open the app catalog site.
- Navigate to the K2 Five app via the following path on the app catalog site: Site Contents > K2 Five .
- On the App Catalog > K2 for SharePoint page, click on the Manage App Deployments (SharePoint) link.
- Add the newly created site collection URL to the Enter a site collection to deploy to: section and click the Add button.
- Next click the OK button.
- Next click on the K2 Five app in the app catalog's Site Contents section.
- On the App Catalog > K2 for SharePoint page, click the Manage App Activations link.
- On the App Catalog > K2 for SharePoint > Settings > Manage App Activations page, add the new Site Collections URL to the Specify a site collection URL: section and click the Activate button.
- Next the Activate Site Collections page opens, and Activation wizard will run. Once complete click the Close button.
- The app is activated on the new site collection. Click the Close button.
Adding a new Subsite to a Site Collection after K2 Five Integration
At activation time, existing subsites in the site collection are activated with K2 for Sharepoint. New subsites that are added at a later point, either manually or via a K2 workflow, are also activated with K2 for SharePoint through the remote event receivers. This automatic activation may take a few minutes depending on your SharePoint environment. SharePoint Online instances do NOT include the remote event receiver, and hence do not get K2 for SharePoint automatically added to new subsites. For SharePoint Online you must reactivate the site collection using the Manage App Activations page, which finds the new subsites and activates those.
Scenario
When a new subsite is created on a site collection that is already integrated with K2 Five, you want to enable K2 integration on the subsite.
Steps
Adding a new subsite to site collection after K2 Five integration can be done in two ways:
- For information on managing the K2 Five app at app catalog level see the management topic.
- For information on managing the K2 Five app on a site collection level see the management topic.
When integrating, or administering a SharePoint Online environment with K2 Five the following permissions are required:
- Adding, Deploying, Activating and Uninstalling the K2 Five app on a app catalog level requires Farm administrator permissions.
- Activating and Uninstalling the K2 Five app on a site collection level requires site collection administrator permissions.
-
You cannot change the SharePoint Site URL or SharePoint Domain name of a K2-integrated SharePoint site. Doing so will break the K2 integration with the site. If you have to change a site's web address or domain, you must treat it as a new site or tenant and rebuild your K2 solution, or treat it like a multi-environment move and use K2 Package and Deployment to move your solutions.