Applies to: SharePoint Online

Introduction

This article describes installation of Crow Canyon NITRO Studio. This installation uses the NITRO Framework app with tenant level permissions

Pre-requisites

• • User Permissions
    • User doing the installation needs tenant admin rights on the SharePoint online tenancy where NITRO is being installed
  • Site Collection
    • To install NITRO Studio in a new site collection, tenant administrator can create a new site collection
    • Or installation can be done in an existing site collection
  • App Catalog
    • Installation requires Crow Canyon NITRO Apps (SharePoint Add-ins) to be installed in the site collection. Apps needs be added to the app catalog site of the tenancy. Since these apps require tenant level permissions, we cannot use site collection level app catalog for the installation

Package Information

 

App Name	Description	Link to download
CrowCanyon.NitroStudio.app	Main NITRO Studio App that is used to activate NITRO features in a site and manage NITRO in activated sites	Download
CrowCanyon.NITROFrameworkEx.app	Used by NITRO Studio App for working with SharePoint Online. It provides the base functionality and permissions for NITRO activation and updates etc.	Download

Summary of Steps

1. Add Crow Canyon NITRO apps to App Catalog
2. Create Site Collection to install Crow Canyon Apps
3. Install NITRO in Site Collection
   • Install the NITRO Tenant Framework app and NITRO Studio app in the Site Collection root site
   • Setup dependency apps in the Site Collection from NITRO Studio
   • Activate NITRO to required site in the Site Collection

Detailed Installation Instructions

Add Crow Canyon NITRO apps to App Catalog

Add all the apps to tenant app catalog site. Please refer detailed steps

Create Site Collection to install Crow Canyon Apps

Create a site collection using the “Team Site” template for root site. We can also use an existing site collection created with team site template. NITRO is also supported in other types of site collections e.g. Communications and new Group based Team sites. Please contact Crow Canyon support if you face any issue in activating using NITRO in any particular type of site collection

Install NITRO in Site Collection

Following Apps needs to be installed in the root site of the site collection:

• Crow Canyon Nitro Studio
• Crow Canyon NITRO Framework (tenant)

Please refer detailed steps to install these apps. Once NITRO Studio is installed, open the NITRO studio to finish the installation process and then you can activate NITRO in sites or install the prebuilt NITRO applications in the site collection.

Setup dependency apps in the Site Collection from NITRO Studio

After installing the NITRO Studio in the site collection, go to the site contents page of the root site. Click NITRO Studio app to open the main page of NITRO Studio. If NITRO framework app is not yet installed then this page will show a message for the same. Once framework app is installed you can finish the NITRO installation process.

Main page will show a message with Setup button as shown below. Click on the Setup button to install all the required components for the NITRO Studio:

This setup button will install below mentioned Apps to App Catalog site and the same will be added to the Site Collection except NITRO Modern UI WebParts. This app will be installed in the site where we activate the NITRO studio:

 

App Name	Description
CrowCanyon.EmailSync.app	This App provides the functionality to monitor emails in a Microsoft Exchange mailbox and create those mails as SharePoint list items in O365
CrowCanyon.ApprovalWorkflow.app	Configure approval workflows easily on SharePoint lists
CrowCanyon.WorkflowManager.app	Configure business workflows on SharePoint lists. Supports workflows on list item create/update/delete, based on date time values in the list items and also scheduled workflows (fixed time or recurring Calendar)
CrowCanyon.ConfigurablePortal.app	Create easy to configure and use versatile Portal sites as a front end to your SharePoint business process sites. Provides customized UI and security settings to provide a simplified and secure interface to users
CrowCanyon.ProductApp.app	This App is used in some of the Crow Canyon’s prebuilt business applications like IT Helpdesk. You can add it to the catalog at a later time as well when you actually use one of these applications
CrowCanyonNITROSPFxWebParts.sppkg CrowCanyonNITROWebPartsII.sppkg	Provides NITRO features in SharePoint modern sites. Modern UI has different types of lists and pages and all the NITRO components are fully supported

Steps to add Apps in the App Catalog

Step 1: Navigate to ‘Apps for SharePoint’ library in App Catalog

Please use the tenant level App Catalog site to add the Crow Canyon Add-ins.

Navigating to the tenant App Catalog

Go to SharePoint Admin Center of your tenancy and click on ‘apps’ and then ‘Apps Catalog’ as shown below. Please refer this Microsoft article on more information about creating the App Catalog and using it for custom business Apps

Choose ‘Apps for SharePoint’ from Quick Launch

Step 2: Upload the Apps to the App Catalog library

Extract the .app files from the downloaded zip files in the Package Information above. Upload both .app files to ‘Apps for SharePoint’.

Steps to install Apps in the site

Please ensure that the Apps are added to the App Catalog. If not, please follow above steps. Also, the site collection where you want to install NITRO should be created, and you should have Site Collection Administrator privileges on the site collection. After that, follow the below steps:

Step 1 – Go to root site of the Site Collection

It will have URL like https://<your SharePoint tenant name>.sharepoint.com/sites/<your site collection URL name>

Step 2 – Go to the “cog” (gear) in upper right and select ‘Add an app’ from the list

Step 3 – In the Quick Launch on the left side, choose ‘From Your Organization’

Step 4 – Click on the app you want to add and accept app’s permissions request

Step 5- Install Crow Canyon Tenant Framework App

To add Crow Canyon Tenant Framework app, we need approval from tenant admin. Please refer Microsoft Article for more details

For installation, Go to Site Contents of root site of site collection à Add an App à Apps from your Organization à Click Crow Canyon NITRO Framework (tenant) app

If you see message “You can’t add this app here”, click “Find out why” and request the tenant admin to approve the app:

Go to App Catalog Site –> App Requests –> Click on the Crow Canyon NITRO Framework app and approve the request

Once the tenant Admin approves the app, go to Site Collection and add the Crow Canyon NITRO Framework (tenant) App to the Site Collection.

Go to Site Contents –> add an app –> From Your Organization –> Add Crow Canyon NITRO Framework (tenant) App.

Please contact Crow Canyon support in case you face any difficulty in NITRO studio installation.

Note

If you have installed the NITRO in Site Collection, please refer this Article to activate the NITRO for a sub site and to install the prebuilt Crow Canyon NITRO applications.