Installation Guide for SharePoint 2019

Prerequisites

Make sure you have the following files:

Installation Steps

Install LiveTiles Intranet API Service Application

Fist of all, install the LiveTiles Intranet API Service Application as described here.
After you have successfully installed the LiveTiles Intranet API Service Application you can continue with the steps below.

Setup Scheduling/Publishing

Setup Job

LiveTiles Intranet Governance Publishing uses the SharePoint List Web Hooks functionality. They are registered upon enabling the functionality for a specific SharePoint list.

First you need to install the "MatchPoint Governance Publishing Job"-Feature:

Install-SPFeature -Path CYCL.MatchPoint.SharePoint.Governance.PublishingJob

Then you need to activate the "MatchPoint Governance Publishing Job"-feature on your web application(s).

Setup Revisions

Setup Job

MatchPoint Governance Revisions uses the SharePoint List Web Hooks functionality. They are registered upon enabling the functionality for a specific SharePoint list.

First you need to install the "MatchPoint Governance Revisions Job"-Feature:

Install-SPFeature -Path CYCL.MatchPoint.SharePoint.Governance.RevisionsJob

Then you need to activate the "MatchPoint Governance Revisions Job"-feature on your web application(s).

Setup Maintenance Job

The MatchPoint Governance Revisions and Publishing feature uses the SharePoint List Web Hooks functionality. They are registered upon assigning a site collection to a config. As they are only valid for a certain period, the need to be renewed. This is done by the MatchPoint Governance Maintenance Job.

First you need to install the "MatchPoint Governance Maintenance Job"-Feature:

Install-SPFeature -Path CYCL.MatchPoint.SharePoint.Governance.MaintenanceJob

Then you need to activate the "MatchPoint Governance Maintenance Job"-feature on your web application(s).

Add Managed Properties

The global view as well as the site view aggregates data using SharePoint Search. In order for this to work correctly, following managed properties need to be configured:

  • LastRevisionDate: Date and Time (Query, Search, Retrieve, Refine, Sort) - mapped to ows_MP_LastRevisionDate
  • NextRevisionDate: Date and Time (Query, Search, Retrieve, Refine, Sort) - mapped to ows_MP_RevisionDate
  • PublishDate: Date and Time (Query, Search, Retrieve, Refine, Sort) - mapped to ows_MP_PublishDate
  • UnpublishDate: Date and Time (Query, Search, Retrieve, Refine, Sort) - mapped to ows_MP_UnpublishDate
  • RevisionInterval: Integer (Query, Search, Retrieve, Refine, Sort) - mapped to ows_MP_RevisionInterval
  • IsPublished: Integer (Query, Search, Retrieve, Refine, Sort) - mapped to ows_MP_IsPublished
  • Editor: Text (Query, Search, Retrieve, Refine, Sort) - mapped to ows_q_USER_Editor

Hub Integration

To show a notification in the hub if the current site collection has red or orange items, please see the chapter "Hub Integration" below.

Anonymous Access

The governance service uses SharePoint web hooks to be notified when something has changed in SharePoint. In order for this to work, anonymous access needs to be enabled on the web app. This can be done by selecting your web app in the web app overview in the SharePoint Central Administration and then in the "Authentication Providers"-settings.

Please note:

  • In future we might provide a different approach than enabling anonymous access for the web app. But for the time being, this is how it needs to be done.
  • Maybe the calls from SharePoint to the web hooks will work even after enabling anonymous access once on the web app and then disabling it again.

Governance App Installation

  1. Add LiveTiles.Intranet.Governance.sppkg to the 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. Head over to any site collection and install the LiveTiles Governance app.

Hub Integration

Once the app is installed, you should be able to see new action buttons on the bottom right part of the screen. If you also have LiveTiles Intranet Hub installed, the governance launcher will be integrated into the Hub actions.

Hub.aspx

Please note that the hub integration is not supported on the hub.aspx page by default. In order to achieve this you need to adjust the Hub.aspx installed by LiveTiles Intranet Hub and add the governance web part:

  1. Navigate to Hub.aspx
  2. In the SharePoint top navigation menu: Edit Page
  3. Click "Add WebPart"
  4. From the LiveTiles Intranet-category add the LiveTiles Intranet Governance Dashboard Web Part and set the Web Part Appearance to Chrome Type: None
  5. Save the page
  6. Publish the page

Revisions Notifications

If you are using the revisions functionality and would like to show if there are any yellow or red items on the current site you can configure a notifications group in the hub. To do this, add following config to the notificationGroups in the hub config:

{
  "key": "rev",
  "title": {
    "en": "Revisions Notifications",
    "de": "Revisions Benachrichtigungen"
  },
  "iconName": "breaking-news",
  "notificationsCount": {
    "expression": "window._mp.revisionsNotifications.onReady('lazyValue.notificationsCount')"
  },
  "onClick": {
    "expression": "window._mp.revisionsNotifications.onReady('lazyValue.onClick')"
  },
  "hasUnread": {
    "expression": "window._mp.revisionsNotifications.onReady('lazyValue.hasUnread')"
  }
}
← Microsoft 365Manage Selected Sites →