Article last updated on the 19th of November 2020.
This article aims to help guide you through the WorkPoint 365 installation process.
This guide presumes that you have already set up an Office 365 tenant, and have access to the SharePoint admin center.
October 15th, 2020:
Microsoft recently published a Major update announcement (MC222880) in the Message Centre for targeted release tenants, informing that they are changing how customized forms work inside SharePoint lists and libraries. This is currently only affecting early release tenants but is expected to roll out to all tenant by the end of November.
If you have not granted tenant permissions to the WorkPoint Tenant app you need to have your Tenant Administrator disable NoScriptSite. Visit this article for more information on how to disable NoScriptSite. This refers to the app used for for Modern UI and Multi-site collections.
For new tenants (Microsoft doesn't specify what they mean by new tenants), apps using an ACS app-only access token (like WorkPoint is using) is disabled by default.
You can change the behavior by running ‘Set-SPOTenant -DisableCustomAppAuthentication $false' (needs the latest SharePoint admin PowerShell).
1. Consents required for installing WorkPoint 365
The following permissions are required for you to consent to in order to install and use WorkPoint 365 in the noted contexts.
Note that consenting to these APIs requires Tenant administration privileges.
Simply click the first link of each point to consent to the permissions.
- https://wp365webapi.azurewebsites.net (Used for Modern UI and WorkPoint Express. You can read more about this permission and what you consent to in this article: https://support.workpoint.dk/hc/en-us/articles/360023965593-workpoint-365-web-api-permissions.
- https://emm365webapi.azurewebsites.net (Only required if you have Email Manager. You can read more about this permission and what you consent to in this article: https://support.workpoint.dk/hc/en-us/articles/360024624633-Emm365-Web-API-Permissions.
- https://wp365admin-app13.azurewebsites.net (Used for Modern UI and Multi-site collections. You can read more about this permission and what you consent to in this article: https://support.workpoint.dk/hc/en-us/articles/360023781374-workpoint-365-administration-app7-permissions.
2. Creating an App Catalog for SharePoint
As described by Microsoft:
“As a SharePoint or global admin in Office 365, you can create an App Catalog site to make internally developed custom apps available for users to install when they browse apps under the From Your Organization filter on the Site Contents page. Site owners can then add these apps to customize sites with specific functionality or to display information.”
An app catalog is required for installation of the WorkPoint app and for a WorkPoint solution to function. An app catalog can be created in the following way:
- When logged in as a SharePoint administrator, click the dotted square icon to open the settings side panel.
- Click the “Admin”-button to access the administration center.
- In the administration center, click the “Show all”-menu item in the left side panel.
- Clicking the “Show all”-menu item in pt. 3 makes various Admin centers appear in the menu. Click the “SharePoint”-menu item in the “Admin centers”-section.
- On the SharePoint admin center page, click the “More features”-menu item in the left side panel.
- In the “Classic features”-page, click the “Open”-button for the “Apps”-feature.
- On the “Apps”-page, click the “App Catalog”-header.
- In the app catalog configuration page, select “Create a new app catalog site”.
- Click the “OK”-button.
- On the “Create App Catalog Site Collection”-page, give the app catalog site collection an intuitive name.
- Provide a web site address for the app catalog site collection. Typically, this will be called “AppCatalog”.
- Set your preferred language.
- Set your time zone.
- Assign an administrator for the app catalog.
- As an alternative to writing a user in the “Administrator”-field, you can use the explorer to search through available users.
- In the Server Resource Quota box, accept the resource quota default. This setting no longer affects the resource amounts available for the site.
- Click the “OK”-button.
The App Catalog site collection will now be created.
3. Adding the WorkPoint 365 App to the App Catalog
The WorkPoint app is uploaded to the solution through the app catalog:
- In the SharePoint Administration Center, click the “Active sites”-menu item from the left menu.
- From the “Active sites”-page, click the URL of the app catalog.
- On the App Catalog site, click the “Distribute apps for SharePoint”-button.
- On the “Apps for SharePoint”-page, click the “Upload”-button.
- Browse to the provided WorkPoint app file. The latest version of the WorkPoint App can be downloaded here.
- Click the “OK”-button.
After a few seconds, the app is visible in the “Apps for SharePoint”-page:
Please note that Microsoft recently re-designed provisioning of new site collections in SharePoint. This means that site collections are created much quicker than before. It does, however, also introduce new issues. One if these issues is that the site collection is made available almost immediately, but all functionality is not necessarily ready for use right away - such as uploading and installation of apps on the site collection. This may result in an error such as the one in the following image:
This error may lead to the conclusion that there are issues with taxonomy. This, however, is not the case. This error is caused by the fact that provisioning of the site collection is still in progress. This issue is automatically resolved after the provisioning is done, which may take a couple of minutes depending on the tenant.
3.1. If utilizing Multi-site and/or One site collection per entity setups
These steps can be circumvented by installing the WorkPoint App with Tenant rights. You can read more about this app here.
IMPORTANT: If utilizing Multi-site and/or One site collection per entity setups and/or setups with Modern UI, these steps are important!
3.1.1. Installing the WorkPoint 365 app to the App Catalog Site Collection
- Open your App catalog Site Collection.
- Click on the cogwheel on the top right corner.
- Click on "Add an app".
- Click on the "WorkPoint 365" app
- A text should read "You can't add this app here". Click "Find out why".
- Click "Request Approval". Note that the user clicking to request approval of the WorkPoint App should 1) be a global tenant administrator and 2) have an E-mail address to receive the approval e-mail.
- Optionally provide a request justification for the request.
- Click the "Request" button.
Completing these steps should send and e-mail to the person requesting approval of the app. This e-mail contains a link which is used to proceed in the approval process. The e-mail looks something like the following:
- In the approval e-mail, click the "here" link. This will send you to the following page:
- Optionally provide a comment for the approval or rejection of the app.
- Click "Approve".
The WorkPoint app is now approved and ready for use. We can now add the app to the app catalog site collection:
- In the "Add an app" page for the app catalog site collection, once again try to add the WorkPoint app. This time around, the app should no longer say "You can't add this app here", but should send you to the following page:
- Click on "Trust It" to give the necessary consent to the app
Note that you are not installing WorkPoint 365 on the App Catalog Site Collection, you only add the app to deploy it to the other Site Collections. Please also note that the name of the app depends on the release setup you have chosen.
- Click on "..." and choose "Deployment" to open the Automatic site deployment settings.
Please note that those steps automatically adds the app to all sites with the /sites/ URL prefix on your tenant.
Automatic site deployment settings
- In the "Manage App Deployments" settings under "Managed Paths" choose "sites" and click on "Add"
- Click on "OK" to confirm the settings
- Click "Trust it".
4. Adding the WorkPoint 365 app to a site collection
We are now ready to add and install WorkPoint 365 on a proper site collection.
Let's start by creating a new site collection for our WorkPoint installation:
- In the "Active sites" page in the SharePoint admin center, click the "Create" button.
- In the "Create a site" side panel, click "Other options".
- In the "Choose a template" drop down menu, select "Team site".
- Select a name for the site. In this case, we name the site "ProjectMngt".
- Paste the site name into the site address field.
- Select a primary administrator for the site. Inputting a couple of characters into this field will make the system suggest users you can pick from.
- Select a language for the site. Note that this cannot be changed at a later time.
- Optionally, expand the "Advanced settings" section and select a time zone for the site.
- When ready, click the "Finish" button to start creating the site.
Now that the site collection we want to install WorkPoint 365 on is created, we can begin the install process:
- In the “Active sites” section of the SharePoint admin center, click the URL of the site collection.
- Click the “Site contents”-menu item in the left side menu to access the “Site contents”-page of the site collection.
- On the “Site contents”-page, click the “Add an app”-button.
- In the “Apps you can add”-section, click the “WorkPoint 365 App#”-button. The “#” should correspond with the version of the WorkPoint app you have uploaded to the App Catalog, and that you wish to add.
From here, if you have followed this guide and completed the steps in section 4.1 and 4.1.1., you can skip to pt. 61. Else, proceed to pt. 54.
- A text below the app should tell the user “You can’t add this app here”. Click the “Find out why”-text.
- The reason the app cannot be added at this point is that it needs to be approved by an administrator. Click the “Request Approval”-text in the yellow box.
- Optionally add a request justification, or a comment to the approval request.
- Click the “Request”-button.
An E-mail will now be sent to the person who requested the approval of the app. This e-mail looks something like the following:
- Click the link in the E-mail to proceed in the approval process for the app. Note that the user attempting to approve the app must have Global Admin rights in Office 365.
An “Approve or Reject App Request”-page shows information about the app, which permission it requests, and the justification message or comment that was sent with the request:
- Click the “Approve”-button.
Back in the “Site contents”-page of the site collection which should have the WorkPoint app added, we can now add the app:
- Click the “WorkPoint 365 App#”-button again.
- Click the “Trust it”-button.
The WorkPoint app is now being added to the site collection:
This process usually takes about 30 seconds. The user can cancel the addition of the app by clicking the “Click here to cancel”-text.
Once added, the WorkPoint app looks like this in the app catalog:
Clicking the app starts the WorkPoint installation wizard.
5. Installing WorkPoint on the site collection
As previously mentioned, clicking the WorkPoint App in the app catalog starts the WorkPoint installation wizard:
Here, the user can input information about the Company, contacts, and the country of origin. Alternatively, a license key can be provided by clicking the “Or use a License Key”-text:
- Upon entering a valid license key and clicking continue, the next step allows the user to select which type of WorkPoint solution should be applied to the site collection. In this case, an empty WorkPoint solution with the Modern UI layout is selected.
- Click the “Continue”-button to proceed.
- The last step is to read and accept the WorkPoint terms and conditions. You can read the license information by clicking the “license”-text. Once read, click the “I accept the terms and conditions”-checker.
- Click the “Continue”-button to proceed.
The WorkPoint solution is now being installed on the site collection. The following window is displayed:
This process may take several minutes. An e-mail will be sent to the installing user’s e-mail once completed. This process does not require the window to be open, so it can be closed at this point.
Once completed, a ready WorkPoint solution has been set up, ready to be configured further.
6. Granting consents
Once the WorkPoint app is installed on the site collection, you should grant consents to various APIs. This can be done from the WorkPoint Administration:
- On the WorkPoint solution, click the "Home" button in the top left.
- Click the cog-icon to access the WorkPoint Administration.
- In the left side menu of the WorkPoint Administration, click "App Management".
From here, various consents and permissions can be given:
- If your solution uses Email Manager 365, click the "WorkPoint365 web API sign up" button to sign up for the WorkPoint Web API.
- Click the "Tenant administrator app consent" button to go to Tenant administrator app consent.
- Click the "Tenant administrator web API permission management" button to go to Tenant administrator web API permission management.
- Click the "Assign the current app to this solution" button to assign the current app to this solution.