Follow

Step 3: Adding the WorkPoint App to App Catalog

Article published on the 29th of July, 2021.

Click here to go back to the installation guide overview article.

Before performing going through the procedures in this article, make sure you have already undergone the procedures in step 1 and Step 2 of the installation guide found in this article.

To complete the steps in this article, you will need a WorkPoint App. You can download the latest WorkPoint App here.

1. Adding the WorkPoint App to the App Catalog site

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.

After the WorkPoint App has been uploaded to the App Catalog, we can now add it to the App Catalog site collection:

  1. Open your App catalog Site Collection.
  2. Click on the cogwheel on the top right corner.
  3. Click on "Add an app".
  1. Click on the "WorkPoint 365" app. From  here, we need approval to be able to add the app. There are two ways of doing this; through an administrator E-mail or through the REST API:

Note that approving the WorkPoint app requires a user with Site Collection Administrator privileges.

2a. Approval of the app through Administrator E-mail

Your Apps - Google Chrome
  1. A text should read "You can't add this app here". Click "Find out why".
  1. 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.
SharePoint Store - Google Chrome
  1. Optionally provide a request justification for the request.
  2. 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:

  1. In the approval e-mail, click the "here" link. This will send you to the following page:
  1. Optionally provide a comment for the approval or rejection of the app.
  2. Click "Approve".

The app should now be approved and can be added to the App Catalog site collection:

Your Apps - Google Chrome
  1. 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:
Your Apps - Google Chrome
  1. 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.

2b. Approval of the app through REST API

Your Apps - Google Chrome
  1. A text should read "You can't add this app here". Click "Find out why".
  1. 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.
SharePoint Store - Google Chrome
  1. Optionally provide a request justification for the request.
  2. Click the "Request" button.

We can now use the API to approve the request.

First we need to find the Unique ID of the app that was requested. Tailor the following URL to use your solution information and go to the URL in a web browser. Specifically you need to replace the {tenantappcatalog} part with the path to the app catalog site of the tenant you are working on.

https://{tenantappcatalog}/_api/lists/getbytitle('App%20Requests')/items?$select=UniqueId

As an example using the tenant "CalperIT.sharepoint.com" with an App Catalog site called "AppCatalog", the URL would look like the following:

https://calperit.sharepoint.com/sites/AppCatalog/_api/lists/getbytitle('App%20Requests')/items?$select=Title,UniqueId

IMPORTANT: Note that "'App%20Requests'" in the examples above may need to be substituted by a translation depending on the language first set when creating your app catalog. If my app catalog e.g. was made in Danish, I would substitute 'App%20Requests' with 'app-anmodninger'.

You can find out if you need to substitute 'App%20Requests' by going to your App Catalog site:

Whatever your page says in the red field in the image above, substitute for 'App%20Requests'.

Going to the URL, you should see the following information:

  1. Within all the data, find the name of the app which was requested. In this example, we are requesting approval of the app "WorkPoint 365 App13".
  2. Look for the unique ID of the app. It follow the format: XXXXXXXX-XXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX and is located within a <d:UniqueId> tag. Copy this ID to a notepad document or similar, as we need it for the next step.

Next, we need to access the approval page for the specific app requested.

Tailor the following URL to fit the solution you are working on. Specifically, as in the previous step you need to replace {tenantappcatalog} with the path to the app catalog site of the tenant you are working on, but you also need to replace {UniqueID} with the unique ID we found before and which you copied.

https://{tenantappcatalog}/_layouts/15/appapprovereject.aspx?requestid=%7B{UniqueID}%7D

Going to the tailored URL should show the following approval page for the app:

  1. Optionally type in a justification for the approval (or rejection) if necessary.
  2. Click Approve to approve the request.

The WorkPoint app is now approved and ready for use. We can now add the app to the app catalog site collection

Your Apps - Google Chrome
  1. 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:
Your Apps - Google Chrome
  1. Click on "Trust It" to give the necessary consent to the app

The app has now been added to the App Catalog site collection.

3. App deployment

The following steps can be circumvented by installing the WorkPoint App with Tenant rights. You can read more about this app here.

When adding the WorkPoint app to the App Catalog site collection you are not actually installing WorkPoint 365 on the App Catalog Site Collection - you only add the app to deploy it to the other Site Collections. For this, we need to set deployment settings on the app:

  1. In the Site Contents of the App Catalog site collection, click the options icon for the WorkPoint app.
  2. In the pop-up box, click "Deployment".
  1. In the "Manage App Deployments" settings under "Managed Paths" choose "sites" and click on "Add"
  2. Click on "OK" to confirm the settings

4. Checklist

Before proceeding to step 4 of the installation of WorkPoint 365, please ensure that you have:

□  Uploaded the WorkPoint App to your app catalog in SharePoint

□  Approved the WorkPoint App (either through e-mail or through the REST API)

□  Added the WorkPoint App to your app catalog site collection

□  Set Deployment settings for the WorkPoint App

Have more questions? Submit a request