Install Semaphore for SharePoint Online

Select a subscription

The first step is to select a subscription. Complete these steps:

1. Log into the Progress Data Cloud tenancy.

2. Click the Configure menu.

3. Click SharePoint Online.

4. From the Subscriptions list, select a subscription.

   Note:

   A message appears if a site has not been deployed in the subscription. Click the Add your first subscription button and follow the steps in Deploy for the first time.

5. Click Deploy. The Subscription section of the Deploy sidebar opens.

6. In the Subscription section, click your subscription. The Grant Site Access section appears. Next, make a GET request to retrieve the siteID.

Deploy for the first time

If this is the first time a site is deployed to this subscription, a connection needs to be established between Progress Data Cloud and the SharePoint Online environment. If you have already deployed a site with this subscription see make a GET request to retrieve the siteID.

1. When the SharePoint Online page appears, click Add your first subscription.

   

   Click Add your first subscription.

2. From the Deploy sidebar, under the Subscription icon, click Add a new subscription.

   

   Add a new subscription from the Deploy sidebar.

3. The system prompts you to authenticate.

4. Follow the on-screen instructions. After a few moments, a screen appears requesting permissions.

5. Click Accept to grant the necessary permissions.

6. The PDC Deploy sidebar appears with the Grant Site Access tab selected. Continue with Make a GET request to retrieve the siteID.

Make a GET request to retrieve the siteID

This GET request retrieves the SharePoint siteID. The siteID can then be used in the POST request to grant site access.

1. Read the instructions on the Grant Site Access section.

2. Scroll down the page and copy both the GET and POST requests into a text editor.

   

   Copy the GET and POST requests on the Deploy sidebar.

3. In the text editor, replace </path/to/your/site> with the path to the SharePoint site.

4. Copy the text into the header of the GET request and make the request.

5. If you want to use Microsoft Graph Explorer to make the API call, see Make a GET request with Microsoft Graph Explorer. Otherwise, skip ahead and copy the response.

Make a GET request with Microsoft Graph Explorer to retrieve the siteID

1. Scroll to the top of the Deploy side bar.

2. Click Microsoft Graph Explorer. The Microsoft Graph Explorer interface appears.

   

   Click the link to access Microsoft Graph Explorer.

3. Verify that you have logged into the same account as the SharePoint site.

   

4. Copy the request you created earlier and replace </path/to/your/site> with the path to your SharePoint site.

5. Paste the copied text into the header of the request.

6. Verify that GET is selected.

7. Click Run query to make the request.

   

   The GET request executed from Microsoft Graph Explorer. Copy the id to use in the next step.

8. Next, Copy the response.

Copy the response and make a POST request to retrieve the siteID

1. Copy the id from the response (exclude the quotation marks). You will use this in the POST request.
2. Make the POST request.
   1. Replace <site-id> with the id from the response.
   2. Copy the body of the request from the Grant Site Access section.
   3. If you want to use Microsoft Graph Explorer to make the POST request, follow the steps in Make a POST request with Microsoft Graph Explorer. Otherwise, you can skip ahead to Install the Progress Data Cloud App into your App Catalog.

Make a POST request to grant site access with Microsoft Graph Explorer

Complete these steps:

1. Scroll to the top of the Deploy sidebar.

2. Click Microsoft Graph Explorer. The Microsoft Graph Explorer interface appears.

   

3. Verify that you have logged into the same account for the SharePoint site.

4. Copy and paste the POST request you created earlier. Replace <site ID> with the id from your SharePoint site.

5. Copy and paste the body of the request from the Grant Site Access section.

   

6. Verify that you have selected POST.

7. Click Run query to make the request.

8. A 201 message indicates a successful request. Continue with Install the Progress Data Cloud App into your App Catalog.

Install the Progress Data Cloud App into your App Catalog

You must install the Progress Data Cloud App in your site collection before you can configure it. To simplify the app deployment, install the app into your SharePoint Online subscription App Catalog. You can generally access the App Catalog at a URL like https://<your SharePoint Online subscription>.sharepoint.com/sites/apps/. For example, https://semaphoretest.sharepoint.com/sites/apps/. This allows you to easily install the app on any site collection in your subscription using the Distribute apps for SharePoint option on the App Catalog landing page (use the Upload option on the Apps for SharePoint screen).

During this process, the system will prompt you to trust the Progress Data Cloud app. After reading the message, click the Deploy button.

Once the app is installed into your App Catalog, go to your site collection and install the app.

Install the App into a site collection

For each of the site collections that will use Semaphore, add the app from the app catalog and configure it.

To add the app to a site collection:

1. Connect and login to the appropriate SharePoint Online site collection as an administrator.
2. Click Site contents.
3. Click on + New
4. Select App.
5. Click Add button below the Progress Data Cloud icon. Typically, the button is under the Apps you can add section of the screen. This process may take several minutes to complete. Refresh the page to confirm the application has been successfully installed.

Semaphore for SharePoint Online can now be configured for use with your site collection.

Automate deployment with PowerShell