Install App (v 1.1)

Prerequisites 

To install the app you need the following:

• The app package you got from Communardo
• A valid licence to use the app
• An Office 365 tenant
• A (site collection or tenant) app catalog in the Office 365 tenant
• An account with permission to use the app catalog
  
  

# connect to admin site of the tenant
Connect-SPOService -Url https://contoso-admin.sharepoint.com

# get a reference to the site collection where the
# site collection app catalog should be created
$site = Get-SPOSite https://contoso.sharepoint.com/sites/space-navigator

# create site collection app catalog
Add-SPOSiteCollectionAppCatalog -Site $site

Install App

Add the web part solution file .sppkg to the app catalog and deploy it, via the following 2 steps:

1. Add the file via drag & drop or via the upload dialog provided by SharePoint:

Image 1: Add the web part solution file (click to enlarge)

2. A dialog comes up. Confirm by clicking the "Deploy" button:

Image 2:  Confirm deployment (click to enlarge)

After successful upload you should see something like this (app version could be different).

Image 3: Successful upload of the wepart solution file (click to enlarge)

Add app to site collection

Navigate to the site collection you want to place the Space Navigator web part on.

Go to the home page of your site collection. Click on 'New' in the edit bar and select 'App'. 

Image 4: Add the Space Navigator app to the site collection (click to enlarge)

Select the 'Space Navigator' app by clicking on it. The app will be added.

Image 5: Add the Space Navigator app to the site collection (click to enlarge)

Image 6: Adding Space Navigator App is in process (click to enlarge)

By adding the app to a site collection the following structures are created in the site collection:

• Content type "Space"
• List "Space Masterdata" which holds space metadata and can be used to configure the spaces
• Picture library "Space Logos" which can be used to store logos for your spaces
  
  

Approve permissions of the app

The app needs permission to read groups and directories via the Microsoft Graph API. You have to approve these permissions manually in the admin area.

To do that, go to the SharePoint admin center (<tenantname>-admin.sharepoint.com). If not already activated switch to the modern view via the button in the top right area.

Image 7: Activate modern view in admin center (click to enlarge)

Navigate to API Management on the left side.

Image 8: Navigate to API management (click to enlarge)

There should be two permissions in state "Pending approval":

Image 9: Pending permissions (click to enlarge)

You have to approve them separately. For that, select one and click on "Approve or reject".

Image 10: Open approve dialog for one permission (click to enlarge)

A pane on the right side opens. Click on "Approve".

Image 11: Approve permission (click to enlarge)

Afterwards it should look like this:

Image 12: One permission is approved (click to enlarge)

Repeat the process for all permissions. In the end it should look like this:

Image 13: All permissions are approved (click to enlarge)

Now the app should work properly.

Add the web part as a full page app

Once the app has been added, a page in the Space Navigator site collection has to be created.

Go to the homepage of your site collection. Click on 'New' in the edit bar and select 'Page'.

Image 14: Create a page in the site collection for the Space Navigator (click to enlarge)

A new panel will open.

Click on the tab 'Apps', select the 'Space Navigator' app and confirm with 'Create page'.

Image 15: Create a page in the site collection for the Space Navigator (click to enlarge)

Back to Top