How to Deploy a K2 Solution to Multiple Lists or Libraries

  • 24 February 2022
  • 0 replies
  • 67 views

Userlevel 5
Badge +20
 

How to Deploy a K2 Solution to Multiple Lists or Libraries

KB001763

PRODUCT
K2 blackpearl 4.7
K2 smartforms 4.7
BASED ON
K2 blackpearl 4.7
LEGACY/ARCHIVED CONTENT
This 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.

You'll learn how to take a K2 solution from one list or library in SharePoint and deploy it to a different list or library that has the same structure. This article uses a library as the example but the same principle applies to a SharePoint list.

 

Scenarios

Below are two scenarios that detail how deploying a solution across multiple lists or libraries can be achieved.

 
Scenario 1: Use a K2 solution from a SharePoint document library across multiple document libraries

You develop a K2 solution with Forms, SmartObjects, Views and Workflows for one SharePoint document library that can reused across multiple libraries. You use K2 Package and Deployment to package the solution from the first library and deploy it to the rest of the libraries. Each library has the exact same structure.

Follow the steps below:

  1. Create the K2 solution using the first (source) document library.
    Image
  2. Create a package of the solution via K2 Package and Deployment or K2 for SharePoint Package and Deployment (including all dependent K2 artifacts).
    Image
    Image
  3. Deploy the package to the target library via PowerShell or K2 Package and Deployment . This can be automated by provisioning the document library via a K2 workflow and then deploying the package to provisioned library.
    Note: 
    • Ensure that the target library is the exact structure as the packaged library.
    • Each new library that you deploy the original package to contains a new instance of the artifacts from the source library - they are not shared. For example, you have a different workflow for every target library.

    For detailed steps on creating and deploying a K2 package, see the Create and Deploy a K2 Package section.

 
Scenario 2: Use a K2 solution based on a SharePoint site template across multiple SharePoint environments

You need a SharePoint site with particular lists and libraries as well as K2 integration such as Forms, SmartObjects, Views and Workflows that can be reused across other SharePoint sites . You use the Save As Template feature in SharePoint along with K2 Package and Deployment.

Note: It is important to note that saving a site via the Save As Template feature requires manual configuration with K2 4.6.11 and earlier. See KB001619 for more information.

For K2 4.7, follow these steps:

Save the site as a site template.
Note: Make sure that 3rd party apps are removed prior to creating the site template as this may prevent you from creating the site template.
  1. Open the site and navigate to Site Settings > Site Actions, select the Save Site as Template option.
    Image
  2. On the Save as Template page, enter a File name, Template Name, Template description, check the Include Content check box (if applicable) and click OK.
    Image
  3. On the [Site Name] > Operation Completed Successfully page, click the solution gallery link, to view and download the site template.
    Image
  4. On the solutions gallery page, click the site template link to download the template. Click the Save button on the download dialog.
    Image
  5. Upload the site template to a site collection where you need a new site based on the template. For more information on how to do this see Upload the site template file to solutions gallery (MSDN).
  6. Once the site template is uploaded and activated, navigate to the top level site a site collection.
  7. On the site collection top level site, navigate to the Site Contents page and click the new subsite option to create a new subsite.
    Image
  8. On the Site Contents > New SharePoint Site page, provide a Title, Description and Web Site Address. In the Template Selection section, click the Custom tab and select the site template. Specify the settings for Permissions, Navigation and Navigation Inheritance sections and click the Create button.
    Image
  9. The new subsite based on the site template is created.
    Image
    Note: 
    • If K2 is deployed to the site collection on which the new site is created, K2 activation takes place automatically on the new site for SharePoint 2013 (on-premises) sites. It may take some time for this to occur based on the load of the SharePoint farm. You can manually activate K2 from the app catalog if necessary.
    • The K2 artifacts (views, forms, workflows and reports) must be deployed via K2 Package and Deployment as described in scenario 1.

    For detailed steps to create and deploy a K2 package, see the Create and Deploy a K2 Package section.

 
Create and Deploy a K2 Package
  1. Create a package of the K2 solution using the source document library.
    Image
  2. Copy the K2 package to the target SharePoint server.
  3. Go to the Document Library on the newly created subsite, click the Library tab, and then click the Application option.
    Image
  4. On the [Subsite Name] > [ Document Library Name] > Create Application page, click Deploy Solution.
    Image
  5. On the Deploy solution page, click the Click here to browse to package option.
  6. Select the required package and click Open on the Deploy Solution page.
    Image
  7. On the Processing Package page, checks are done to ensure all dependencies and references are present on the target site.
    Image
  8. Configure the destination for each packaged item. Select an item and click the Configure button.
    Image
  9. On Configure [Packaged Item] Reference page, specify the correct item and click OK.
  10. On the [Document Library] - Deploy Package page, the K2 artifacts can be configured. Click Next.
    Image
  11. Specify the values for each package variable then click Next.
  12. Click Deploy on the [Document Library] - Deploy Package page.

 


0 replies

Be the first to reply!

Reply