Skip to main content

Installation and Configuration Process

01/07/2025

Abstract

This article provides an overview of the installation step guide that you will need to successfully install and configure Graphwise for SharePoint.

Here is an overview of the steps that you will take during installation and configuration of Graphwise for SharePoint.

Install the Graphwise for SharePoint Administration Application on a SharePoint Site
  1. Create a SharePoint site where you will install the Graphwise for SharePoint Administration application.

  2. Use a PowerShell script from the deployment package to create system lists that the Graphwise for SharePoint Administration application needs to run properly.

  3. Create a site app catalog. It will allow you to deploy the Graphwise for SharePoint Administration application to the site.

    Note

    Alternatively, you can use a tenant app catalog to install Graphwise for SharePoint Administration. We however strongly recommend using the site app catalog to limit the deployment of the application to a single site.

  4. Upload the package with the Graphwise for SharePoint Administration application to the site app catalog that you created in the previous step.

  5. If you want to enable management of site permissions from the Graphwise for SharePoint Administration application, log in to the SharePoint admin center and approve a pending request from the application web part to access the Microsoft Graph API.

  6. In SharePoint, a site can contain one or more pages, which in turn can contain one or more web parts. To be able to use the Graphwise for SharePoint Administration application from a page on your site, you first need to add the application to the site.

  7. Add the Graphwise for SharePoint Administration application as a web part to a specific page on the SharePoint site.

Install the Graphwise for SharePoint Search Application on a SharePoint Site
  1. Create a SharePoint site where you will install the Graphwise for SharePoint Search application.

    Creating a Site for Graphwise for SharePoint Search

  2. Create a site app catalog. It will allow you to deploy the Graphwise for SharePoint Search application on the site.

    Creating a Site App Catalog for Graphwise for SharePoint Search

  3. Upload the package with the Graphwise for SharePoint Search application to the site app catalog that you created in the previous step.

    Deploying Graphwise for SharePoint Search to the Site App Catalog

  4. In SharePoint, a site can contain one or more pages, which in turn can contain one or more web parts. To be able to use the Graphwise for SharePoint Search application, you first need to create a new site page that will contain the Graphwise for SharePoint Search web part.

    Creating a Site Page

  5. Add the Graphwise for SharePoint Search application as a web part to the page you created in the previous step.

    Adding Graphwise for SharePoint Search to the Page

Deploy the Graphwise for SharePoint Command Bar and Views Application to a Tenant App Catalog
  1. If you want to use the Tagging module, deploy the Graphwise for SharePoint Command Bar and Views application to a SharePoint tenant app catalog from where you can add it to any site in that tenant.

    Deploying Graphwise for SharePoint Command Bar and Views

Set up Authentication for the Graphwise for SharePoint Administration Application
  1. The Graphwise for SharePoint Administration application delegates the identity and access management to Microsoft Entra ID (formerly Azure Active Directory). As a first step, establish a one-way trust relationship from the application towards Microsoft Entra ID by registering the application with the Microsoft identity platform.

    Note

    If you want to use both the Tagging and the Term Store Synchronization modules, you can create a separate app registration for each of them. Each of the app registrations has to be separately configured.

    Create an App RegistrationCreate an App Registration

  2. As a next step, configure the app registration to allow the Graphwise for SharePoint Administration application to authenticate and authorize against resources. The configuration process includes the following steps:

    Note

    Repeat the steps for each app registration you created in step 1.

Deploy Azure Functions to the Azure Portal
  1. Create function apps that will host the execution of the Azure functions used by Graphwise for SharePoint.

    Note

    You need a dedicated function app for each of the Graphwise for SharePoint modules (the Tagging module, the Term Store Synchronization module) you want to install. Each of the function apps has to be separately configured.

    Creating a Function App

  2. Use Azure Kudu to upload the zip files with the Azure functions into corresponding function apps.

    Upload the Azure Functions to the Function AppUpload the Azure Functions to the Function App

  3. Configure each function app by editing its settings in bulk.

    Configuring the Function App

  4. Optional: The Azure functions communicate with the PoolParty server via REST API calls, which are by default protected with OAuth 2.0. You can change the authentication method to Basic Authentication.

    Setting the Authentication Method for API Calls between the Azure Functions and PoolParty

  5. Recommended: If you want to use the Tagging module, you can lower Azure costs by exclude/include-listing certain file types for tagging. You can also set a limit on the file size.

    Note

    The tagging process works with text-based files; other file types will not return any results.

    Limit Files for Tagging

  6. Optional: You can enable the built-in App Service authentication by Microsoft to provide the Azure functions with an additional layer of security.

    Enabling Authentication with Microsoft Entra ID (Azure AD) for Azure Functions

  7. Optional: If you want to use the Term Store Synchronization module, you can enable and configure logging of synchronizations in the Graphwise for SharePoint Administration application on the concept level.

    Configuring Term Store Synchronization Logging in the Administration Application

  8. Optional: You can use the Azure functions to verify that the connection between the PoolParty server and the Azure Portal works as intended.

    Verifying the Connection between PoolParty and the Azure Portal

  9. Take note of the URLs and app keys of the function apps you have just created, as you will need them to establish communication between the Graphwise for SharePoint Administration application and the Graphwise for SharePoint Search application on the one hand and the PoolParty server on the other hand.

    Obtaining the URL and API Key of the Azure Functions

Configure the Graphwise for SharePoint Administration Application
  1. After you have installed Graphwise for SharePoint Administration on a SharePoint site, set up authentication for the application and deployed Azure functions to the Azure portal, go to SharePoint and further configure Graphwise for SharePoint Administration to enable communication between the application and the PoolParty server as well as between the application and Microsoft Entra ID (formerly Azure Active Directory).

    Configuring Graphwise for SharePoint Administration

Configure the Graphwise for SharePoint Search Application
  1. After you have installed Graphwise for SharePoint Search on a SharePoint site, further configure it to enable communication between the application and the PoolParty server as well as between the application and Microsoft Entra ID (formerly Azure Active Directory).

    Configuring Graphwise for SharePoint Search