Follow

WorkPoint 365 Version 4 Installation Guide

Article last updated on the 2nd of February, 2023.

Contents

1. Introduction

In this article, we will describe and demonstrate the process of installing WorkPoint 365 using the installer introduced with version 4 of WorkPoint 365.

The new installation process automates many of the previously manual steps which admins had to carry out, which should result in an easier and more user-friendly way of installing brand new WorkPoint solutions.

Installing WorkPoint using the WorkPoint 365 version 4 installer is split into three processes:

  • Agreeing to WorkPoint's Terms of Service agreement.
  • Installing the WorkPoint 365 App on the tenant App Catalog.
  • Creating a new solution.

All of these processes are described in this article.

2. Prerequisites

In order to successfully install a new WorkPoint solution using the Installation Wizard, the points are required:

  • A valid WorkPoint 365 license.
  • An App Catalog site collection on the customer's tenant (The customer or partner must ensure an app catalog exists).
  • To install the WorkPoint App, you must be an administrator on the Tenant app catalog site.
  • To grant the necessary consents when installing the WorkPoint App, you must be Global administrator.
  • All required agreements (terms of service, and required consents).

4. Terms of Service agreement

The first time running the WorkPoint 365 version 4 installation wizard, you will be required to accept WorkPoint's Terms of Service agreement.

Until this step is performed, you will not be able to use the subsequent processes in the wizard.

You can accept to the Terms of Service agreement in the following way:

  1. In the installation wizard, click the link to read the terms of service agreement, then click the "I Agree" button.

When you have agreed to the Terms of Service, the section is removed from the installer.

5. Installing the WorkPoint 365 App

This section covers the process of installing the WorkPoint 365 app in the tenant app catalog. Before performing the following steps, please ensure that a SharePoint App Catalog exists on the tenant.

We begin in the WorkPoint installation wizard:

  1. To begin the installation process of the WorkPoint 365 app in the app catalog, click the "Install" button.
  1. The next step is to select whether you are happy with WorkPoint creating sites for various purposes in WorkPoint for you. WorkPoint greatly recommends to answer "Yes" to this. Selecting "No" requires you to develop your own automation for creating sites. Depending on which selection you make, the required permissions WorkPoint asks for changes. You can review which permissions WorkPoint requires based on your selecting in the "WorkPoint would like to"-section of the wizard.
  2. Once you have made your selection, you can proceed to grant the permission consents by clicking the "Authorize" button.
Sign in to your account - Google Chrome
  1. Next, you need to sign in with a tenant administrator account.

If you cannot log in with your Tenant Administrator, please ensure that you are not logged in as another user in your browser.

Sign in to your account - Google Chrome
  1. Next, you get a chance to once again review the permissions you are about to grant. To accept the permissions, click the "Accept" button.

Next, you should be returned to the installation wizard:

  1. Next, you need to grant permissions for WorkPoint web jobs. To do this, click the "Continue" button.
  1. Review the permissions being granted and click the "Authorize" button.
Sign in to your account - Google Chrome
  1. Next, you need to sign in with a tenant administrator account.
Sign in to your account - Google Chrome
  1. To grant the consents, click the "Accept" button.

You should now be returned to the installation wizard:

  1. We are now ready to install the WorkPoint 365 app to the tenant app catalog. To do this, click the "Install App" button.

WorkPoint begins installing the WorkPoint 365 app to the tenant, as well as granting the various required and agreed to permissions (this might take several minutes):

  1. If the installation of the WorkPoint 365 app fails, please ensure that an App Catalog exists on the tenant. Then click the "Retry Installation" button.

After a while, the installer should stop at the first app approval request step:

  1. To proceed, please click the first link in the current step text. This will take you to the following page where you will make a request for approval of the WorkPoint 365 app:
  1. To request approval for the app, click "Request Approval".
  1. Optionally type in a reason for the request and click the "Request" button. This should redirect you to your open app requests.

We can close this browser tab and return to the WorkPoint 365 installer:

  1. To confirm having sent the app approval request, click the second link in the current step text.

This should move you to the next step in the installer:

  1. Next, you need to approve the app request. To do this, click the first link in the current step text.
  1. In the newly opened browser tab, click "Approve" for the "WorkPoint 365" request.
  1. Optionally type in a comment for the app request approval and click the "Approve" button.

This should redirect you back to the list of open app requests:

We can close this browser tab and return to the WorkPoint 365 installer:

  1. To confirm having approved the app, click the second link in the current step text.

This should move you to the next step in the installer:

  1. Next, you need to install the WorkPoint 365 app. You can do so by clicking the first link in the current step text.
  1. In the newly opened browser tab, click the "ADD IT" button.
  1. In the pop-up window, click the "Trust it" button.

This should take you to the app catalog where the WorkPoint 365 App is being installed:

Here, you need to wait until the WorkPoint 365 App is finished installing, and is no longer grayed out:

The app catalog page does not update dynamically, so update it manually once in a while to see if the app has finished installing.

Once the WorkPoint 365 App is installed, you can close the browser tab and return to the WorkPoint 365 installer:

  1. To confirm that the WorkPoint 365 App has been installed, click the second link in the current step text.

The installer now validates that all steps have been performed and the app successfully installed:

Once the validation is complete, the installer should display the following page:

  1. To return to the front page of the installer, click the "Return" button.

The "Install WorkPoint 365 App" step should now be complete, and the "Create a new Solution" step should now be unlocked:

6. Creating a new WorkPoint solution

In this section, we will use the WorkPoint 365 installer to create a new WorkPoint solution.

This section assumes that the WorkPoint 365 App has been successfully installed on the customer's tenant app catalog, as per section 5 in this article.

To create a new WorkPoint solution, follow these steps:

  1. To create a new WorkPoint solution, click the "Install" button.

This opens the process to install a WorkPoint solution:

Next, you need to select which WorkPoint subscription to use for the new WorkPoint solution:

  1. Input your license key and click the "Add" button.
  1. After inputting your license key, the installer displays your available subscriptions.
  2. For each subscription, you can expand the subscription to view the features it includes.
  3. If you cannot find the subscription you are looking for, you can add additional subscriptions with other license keys.
  4. To select a subscription for the new WorkPoint solution, click the "Select" button.
  1. The selected subscription is framed in orange.
  2. To proceed to the next step in the installer, click the "Continue" button.
  1. Next, you can select to create an empty solution, or create a solution based on a solution template (if your chosen subscription includes standard solutions). In this instance, we have selected to create an empty solution. For each solution you can expand the section to view a description of the solution type.
  2. To proceed, we click the "Continue" button.
  1. In the "What is included" step, you can view more details about what is included in the solution type you selected.
  2. To proceed, click the "Continue" button.

This takes you to the "Solution Info" step. Here you can select on which site in SharePoint to install WorkPoint.

   6.1. Selecting a site for WorkPoint

This section describes the options for which site to install WorkPoint on.

  1. The first option is whether to create a new SharePoint site for WorkPoint or to use an existing one.

The option selected changes the additional options on this step.

       6.1.1. Using an existing site

Choosing to use an existing site for WorkPoint requires you to fill the following form:

  1. Type in the e-mail address of the person who should receive an e-mail when the WorkPoint solution has finished installation.
  2. Type in site URL of the SharePoint site on which you want to install WorkPoint.
  3. To proceed, click the "Continue" button.
       6.1.2. Creating a new site

Choosing to use an existing site for WorkPoint requires you to fill the following form:

  1. Type in the e-mail address of the person who should receive an e-mail when the WorkPoint solution has finished installation.
  2. Type in a site title. This title will automatically fill in the "Solution URL" field as well, putting the site title as a suffix after /sites/ in the URL. The installer will inform you if the site in unavailable, otherwise it should display "The site address is available", as shown in the image.
  3. Next, select a user from the Azure Active Directory to be the primary administrator of the WorkPoint solution.
  4. Lastly, select  a language and timezone for the WorkPoint solution.
  5. To proceed, click the "Continue" button.

   6.2.  Selecting a Solution Owner

This section describes how to select a solution owner for the WorkPoint solution:

The option selected for using an existing contact or creating a new one changes the additional options on this step.

       6.2.1.  Choosing an existing contact

Selecting "Choose an already existing contact" allows you to select a contact from your chosen license key provided in the first step of the installation wizard (not the Azure AD):

  1. Search for and select a person to be the Solution Owner.
  2. To proceed, click the "Continue" button.

Note, both the person set in the "Solution Info" step and the solution owner will receive an e-mail once the installation of the WorkPoint solution is completed.

       6.2.2. Creating a new contact

Selecting "I'll provide the solution owner information" allows you to fill the following form to create a new contact on the license (not Azure AD), and use that person as Solution Owner:

  1. Type in the first- and last name of the Solution Owner.
  2. Type in the Job Title of the Solution Owner.
  3. Type in the e-mail address and telephone number of the Solution Owner.
  4. To proceed, click the "Continue" button.

Note, both the person set in the "Solution Info" step and the solution owner will receive an e-mail once the installation of the WorkPoint solution is completed.

Also note that using the method of inputting solution owner information will add that person to the license. The next time you create a new solution using the same license key, you will be able to select this user using the "Choose an already  existing contact" option.

   6.3. Confirm configuration

In this section you will be able to review the information you have provided before you let the installer start configuring and setting up your new WorkPoint solution.

This section looks like the following:

You can review the information and choices you have provided during the previous steps.

This step also informs you what the installer will be doing during the installation process.

  1. When you are ready to begin installing WorkPoint, click the "Start Configuration" button.

The installation wizard now starts configuring your WorkPoint solution. This may take up to 30 minutes or longer.

Once the installation of WorkPoint is complete, e-mails will be sent out, and the installer shows the following page:

  1. To go to the configured WorkPoint solution, click the "Configured site" link.
  2. To return to the front page of the WorkPoint Installer, click the "Return" button.

This concludes the installation guide for WorkPoint 365 version 4.

Have more questions? Submit a request