Installation Guide for Microsoft 365

Overview

This article helps you installing LiveTiles Intranet Hub on your Microsoft 365 tenant.

Prerequisites

  • SharePoint App Catalog must exist
    Note: It is advised to create the app catalog at least 30 minutes before the installation, else it can easily happen, that the app deployment & installation fails because the app catalog is not yet ready (even if the app site catalog collection is already created).

Installation Wizard

You can use the LiveTiles Intranet Hub installation wizard to install LiveTiles Intranet Hub on your Microsoft 365 tenant. Open https://install.matchpoint365.com with your browser and follow the steps.

Note: The LiveTiles Intranet Hub Installer requires Full Control permission on all sites to fulfill it's purpose. For lower permissions the Low Trust scenario is available for manual installation.

Manual Installation

Prerequisites

Installation Steps

To install LiveTiles Intranet Hub manually, follow these steps:

  1. Install both apps in your SharePoint tenant's app catalog. Please make sure that you are viewing the app catalog in the classic view, as otherwise you might not be able to deploy correctly.
  2. Go to the site where the LiveTiles Intranet Hub page should be installed and set as the start page
  3. Add the apps "LiveTiles Intranet Hub" and "LiveTiles Intranet Hub Landing Page" to the site
  4. Optional: If you have a custom hub store, add a tenant property (see chapter Set custom hub settings)
  5. Go the site's homepage (it should now be Hub.aspx).
    Note: If you get an error in a popup - with an error message like this:
    [...] does not match the reply address configured [...]
    You have to access the "API Management" node in the SharePoint Admin Preview Center. You don't have to do anything there, just access the page (it's probably a bug from Microsoft).
  6. A dialog pops up; follow the instructions from that dialog:
    1. Go to the hub store site (first link in the dialog) and a new subscription will be created.
    2. Go to the SharePoint Admin Center Preview (second link in the dialog) and approve the required permissions.
      Note: It is recommended that you approve all permissions, e.g. MatchPoint Hub, Condense API and all Graph permissions right away (see the chapter Optional Setup Steps for more details)
  7. Reload the page
    Note: If it doesn't work immediately try to sign out and sign in again.

Approve Permission Requests to the Graph API

Many WebParts in LiveTiles Intranet Hub use the Microsoft Graph to access data. If you want to use these webparts you have to enable these permissions.

  1. Go to "SharePoint admin center"
  2. Choose the "Try the new SharePoint admin center link"
  3. Go to the "API management" section
  4. Under "Pending requests" you can see all Graph API Permission requests
  5. To approve a pending permission request, select the request in the list of permissions, and on the toolbar, choose "Approve or reject". In the "Approve or reject" access pane, choose "Approve".

Add Managed Properties for Refinement

For the refinement and some conditions in web parts some additional managed properties respectively settings on managed properties are required. This section explains how you can install these properties.

Import of Search Configuration (Recommended)

Use the file SearchSchemaConfiguration.xml to easily add managed properties to your tenant:

To do so, follow this procedure (see Microsoft Support for more details)

  1. Sign in to the "Microsoft 365 Admin Center" as a search administrator.
  2. Choose "Admin > SharePoint". You’re now in the SharePoint admin center.
  3. Choose "search".
  4. On the "Import Search Configuration" page, browse to the file you want to import.
  5. Click "Import".
  6. On the "Search Config List" page verify that: 1.1 The search configuration file you imported is in the list, and that its status is Imported Successfully. 1.2 If the file hasn't been imported successfully, then the Notes column provides more details about what happened.

Definition for Reference and Manual Configuration

If you've already imported the SearchSchemaConfiguration.xml, you can ignore this section.

  1. Go to the "SharePoint Admin center"
  2. Go to "Search"
  3. Click "Manage Search Schema"
  4. Click on RefinableDateXX and add a mapping to ows_q_DATE_EventDate with an alias EventDateRefinable
  5. Click on RefinableDateXX and add a mapping to ows_q_DATE_EndDate with an alias EndDateRefinable
  6. Click on RefinableDateXX and add a mapping to ows_q_DATE_DueDate with an alias DueDateRefinable
  7. Click on RefinableStringXX and add a mapping to ows_SiteName with an alias SiteTitleRefinable
  8. Click on RefinableStringXX and add a mapping to ows_q_USER_Author with an alias AuthorOWSUserRefinable
  9. Click on RefinableStringXX and add a mapping to ows_Task_x0020_Status with an alias StatusRefinable
  10. Click on RefinableStringXX and add a mapping to ows_q_USER_AssignedTo with an alias AssignedToRefinable

Please note that certain Managed Properties as well as the Crawled Properties will be created automatically by SharePoint once there is content, so you might not be able to use them before you actually have content.

Create LiveTiles Reach Subscription & Approve Permission Request (optional)

This permissions is used to display news from LiveTiles Reach with LiveTiles Intranet Hub.

  1. Go to this page and login with your account and give consent. You will be redirected to the LiveTiles Reach start page.
  2. Login and give consent again.
  3. In case you don't already have a subscription create a new one.
  4. Go to "SharePoint admin center".
  5. Choose the "Try the new SharePoint admin center link".
  6. Go to the "API management" section.
  7. Under "Pending requests" you can see the "Condense API" permission request.
  8. To approve a pending permission request, select the request in the list of permissions, and on the toolbar, choose "Approve or reject". In the "Approve or reject" access pane, choose "Approve".

Post Setup Steps

Integrate the Header and Footer on Pages in Other Site Collections

If you want to make the header appear on other site collections you have to add the "LiveTiles Intranet Hub" app to each site where the header should be visible.

Add Additional LiveTiles Intranet Hub Administrators

Only users who are in the LiveTiles Intranet Hub Admin role are allowed to edit the LiveTiles Intranet Hub configuration ([CTRL] + M) or edit the mega menu. The user who initially created the subscription is the so-called Subscription Manager and is automatically in the role LiveTiles Intranet Hub Admin (the subscription manager can be changed).

Additional users and groups can be configured directly in the Azure Active Directory by following these steps:

  1. Go to https://portal.azure.com
  2. On the left side click on "Azure Active Directory"
  3. In the second column select "Enterprise applications"
  4. Find and select the app "MatchPoint Hub"
  5. Click on "Users and groups"
  6. Click "Add user"
  7. Select the User or Group (only works in AzureAD Premium, see here for here for mor details)
  8. Select the role MatchPoint Admin
  9. Click "Assign"

After you have done this, all newly created AzureAD tokens will include the configured roles. Note that it may be possible that you have to sign out and sign in again and wait a short time for this change to work.

It's also good to know that for all "normal users" you don't need to add any assignment to any role at this point of time.

← ArchitectureSharePoint 2019 →