Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Anchor
top
top

Info
titleIntroduction

To install the Space Navigator App, go through the pages in order, if not otherwise indicated on the page.

Prerequisites 

To install the app you need the following:

  • An Office365 Tenant
  • The App app package, that you got from Communardo
  • A licence to use the app
  • A created site collection or tenant app catalog
  • An account with permission to use the app catalog

Note

If you decide to deploy the app into a site collection app - catalog you can create the app - catalog using the following PowerShell cmdlets (SharePoint Online Management Shell is required):

Code Block
languagepowershell
# 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 webpart solution file .sppkg to the tenant or site collection App app catalog and deploy it.

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

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


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

Image 2:  Confirm deployment (click to enlarge)

Info
titleUser information

The dialog informs you that the app needs a certain permission permissions to work. These permissions must be approved separately.

For more information see chapter "Approve permissions of the app".

After the successful upload , you should see the same like the following screenshot something like this (app version could be different).

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


Add the App app to the site collection. Navigate to the site collection you want to place the webpart on.

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

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


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

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


Info
This process will need take some time , because the structures to hold for storing the metadata will be prepared in the site collection!.

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


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

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

Note

Modifications to the structure of the list "Space Masterdata" are not supported. Please do Do not change the type of fields . This since this could lead to data loss or malfunction of the App!

The app needs permission to read groups and directories via the Microsoft graph apiGraph 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) and . If not already activated switch to the modern view via the button in the top right area.

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


Navigate to API management Management on the left side.

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


There should be two permission permissions in state pending"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)


After that Afterwards it should look like this:

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


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

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


Now the app can work properly.

Add the Webpart as a full page App

If Once the App app was correctly added, create a page in the site collection for the Space Navigator has to be created.

Go to the homepage of your site collection. Click on 'New' on the right of 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 be openedopen.

Click on the tab 'Apps', select the 'Space Navigator' App 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




Panel
titlePage Content

Table of Contents
maxLevel4
minLevel2


Panel

Include Page
_Version Switch
_Version Switch