Getting Started with WorkPoint 365

Article last updated on the 29th of April 2020.


1. Creating a Site Collection

Creating a site collection can be done through the SharePoint Administration Center:

  1. In the SharePoint Administration Center, click the “More features”-menu item from the left side menu.
  1. In the More features page, click the "Open" button for “Classic site collections page”.
  1. On the “Site Collections”-page, click the “New”-button.
  2. Click “Private Site Collection”.
  1. Provide a name for the new Site Collection.
  2. Provide an ending to the site Collection URL. Typically, this is the same as the title.
  3. Set the language for the Site Collection.
  4. Set the Template to “Team site (classic experience)”.
  5. Set your time zone.
  6. Set an administrator for the Site Collection. You can use the right-most button to search through a catalogue of available users.
  7. Leave the “Server Resource Quota”-setting at its default value of 300.
  8. Click the “OK”-button.

The Site Collection will now be created. This process may take up to 15 minutes. A spinning wheel on the “Site Collections”-page shows that the system is still in the process of creating the site collection as seen in the red box:

After completion, the new site collection can be accessed in the following way:

  1. Click the site collection name in the “Site Collections”-page.
  1. In the “site collection properties”-window, click the site collection web address.

Alternatively, the site collection can be accessed from the “Active sites” in the SharePoint admin center:

  1. In the “Active sites” section of the SharePoint admin center, click the URL of the site collection.

2. 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.

3. 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:

  1. When logged in as a SharePoint administrator, click the dotted square icon to open the settings side panel.
  2. Click the “Admin”-button to access the administration center.
  1. In the administration center, click the “Show all”-menu item in the left side panel.
  1. 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.
  1. On the SharePoint admin center page, click the “More features”-menu item in the left side panel.
  1. In the “Classic features”-page, click the “Open”-button for the “Apps”-feature.
  1. On the “Apps”-page, click the “App Catalog”-header.
  1. In the app catalog configuration page, select “Create a new app catalog site”.
  2. Click the “OK”-button.
  1. On the “Create App Catalog Site Collection”-page, give the app catalog site collection an intuitive name.
  2. Provide a web site address for the app catalog site collection. Typically, this will be called “AppCatalog”.
  3. Set your preferred language.
  4. Set your time zone.
  5. Assign an administrator for the app catalog.
  6. As an alternative to writing a user in the “Administrator”-field, you can use the explorer to search through available users.
  7. In the Server Resource Quota box, accept the resource quota default. This setting no longer affects the resource amounts available for the site.
  8. Click the “OK”-button.

The App Catalog site collection will now be created.

4. Adding the WorkPoint 365 App to the App Catalog

The WorkPoint app is uploaded to the solution through the app catalog:

  1. In the SharePoint Administration Center, click the “Active sites”-menu item from the left menu.
  1. From the “Active sites”-page, click the URL of the app catalog.
  1. On the App Catalog site, click the “Distribute apps for SharePoint”-button.
  1. On the “Apps for SharePoint”-page, click the “Upload”-button.
  1. Browse to the provided WorkPoint app file. The latest version of the WorkPoint App can be downloaded here.
  2. 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:

Frank Christensen | Microsoft Teams

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.

5. Adding the WorkPoint 365 app to a site collection

First, we need to access the site collection which should have the WorkPoint 365 app added to it:

  1. In the “Active sites” section of the SharePoint admin center, click the URL of the site collection.
  1. Click the “Site contents”-menu item in the left side menu to access the “Site contents”-page of the site collection.
  1. On the “Site contents”-page, click the “Add an app”-button.
  1. 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.
  1. A text below the app should tell the user “You can’t add this app here”. Click the “Find out why”-text.
  1. 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.
  1. Optionally add a request justification, or a comment to the approval request.
  2. Click the “Request”-button.

An administrator can approve the request from the App Catalog:

  1. On the App Catalog page in the “App Requests”-section, click the title of the WorkPoint app that has been requested.

28th of April 2020: Microsoft recently introduced an error in the approval process of apps i SharePoint. Instead of sending you to the "Approve or Reject App Request" page in pt. 10, you will be sent to the following page:

This page, however, does nothing for the approval process. I.e. no matter what you select in the "Status" drop down menu, and click "Save", the app will not be approved by this selection.

Instead, an email is sent to the Office 365 tenant administrator with a link, which once clicked, approves the app. That email looks something like this:

Approving the app using the link in the email is a required step for approving the uploaded app for the time being. Thus, pt. 10 in the following image can be skipped.

The “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:

  1. 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:

  1. Click the “WorkPoint 365 App#”-button again.
  1. 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.

6. 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:

  1. 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.
  2. Click the “Continue”-button to proceed.
  1. 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.
  2. 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.

7. Creating business modules

An essential building block of WorkPoint solutions is the Business module. A business module is a list which contain underlying entities which can store documents, e-mails, and a range of other elements. An example of a Business module in a Project Management solution could be a Companies module, which contains a range of entities. These entities are the individual companies.

Business modules can be added from the WorkPoint Administration:

  1. Click the “Home”-button of the new WorkPoint solution.
  1. Click the cog-icon to access the WorkPoint Administration.
  1. In the WorkPoint administration dashboard in the “Business Modules”-section, click “Add new”.
  1. In the “Add Business Module”-page, provide a name for the Business Module.
  2. Optionally select a language to translate the title into.
  3. Provide a translation to the title. Multiple translations can be added by clicking the “+”-button.
  4. Provide an Entity name. This is typically the same as the Title, but in singular form. So, a Projects-title matches with a Project-entity name, for example.
  5. Optionally select a language to translate the entity name into.
  6. Provide a translation for the entity name. Multiple translations can be added by clicking the “+”-button.
  7. Optionally select a template to use for the business module. In this case, we are creating a business module to store a list of companies, so we can select the “Companies”-template.
  8. Optionally set a parent business module for this one. In this case, this is the first module we create, so no parent can be selected.
  9. Optionally type in a Group name. Group names are used e.g. the “move entity” feature of WorkPoint.
  10. Select an icon for the business module. WorkPoint provides a list of icons to choose from, and there happens to be one for Companies.
  1. Check the “Sites enabled”. Sites allow the user to, for example, journalize documents, emails, tasks and more on each entity in the module. Most often you will want to enable sites.
  2. In this case we select “Multiple entities per site collection”. In practice, this is the setup most used for business modules on WorkPoint solutions. Alternatives are “Single site collection”, which are advised against in production solutions due to scaling issues, and “One site collection per entity” which are generally only used when integration with Microsoft Teams are required.
  • Microsoft recommends using “One site collection per entity” in all cases. WorkPoint, however, finds that in certain instances, this is not strictly advisable.
  1. Enable “Automatic site creation”. This allows WorkPoint to automatically create a new site for newly created entities in the business module.
  2. Set the maximum number of sites for each site collection on this business module. Microsoft advises a number below 2000, but WorkPoint recommends a setting of between 50 and 100 in this setting.
  3. Set the “Maximum storage consumption”. When approaching this number for the latest site collection, a new one is automatically created. In this way, the system is always ready for more data to be added.
  4. When the configuration is complete, click the “Save”-button.

The business module is now being added, and the following page is displayed:

Once complete, the business module is available from the WorkPoint Administration dashboard. There is, however, a warning message:

  1. WorkPoint needs an additional consent for the use of Multi-site collections. Click the “Please give WorkPoint consent to use extended permissions”-text.
  1. Read through the App info and click the “Accept”-button.

Next, the WorkPoint 365 Browser Cache must be cleared for the business module to show up in the solution:

  1. On the solution, click the “Home”-button.
  1. Click the “Need help?”-text in the bottom of the side panel.
  2. Click the “Clear WorkPoint 365 browser cache”-button.

The “Companies”-business module is now available from the “Home”-panel:

Have more questions? Submit a request