This page describe step by step on how to setup your Sharepoint environment to enable the Document Library module in Spencer
An Office 365 license is required.
Setup
#1 - First, choose which Sharepoint Site’s content you’d like Spencer to synchronize. For this tutorial, We’ve created 1105nv.sharepoint.com/sites/spencer .
- Sharepoint site = “Spencer”
- Sharepoint tenant = “1105nv”
- Sharepoint tenant URL = “1105nv.sharepoint.com”
Share your Sharepoint tenant, Sharepoint tenant URL and Sharepoint site with Spencer
#2- Next, setup an App-only Add-in by navigating to
https://{yourtenanthere}.sharepoint.com/sites/{yoursitenamehere}/_layouts/15/appregnew.aspx
#3 - Generate a Client Id and Client Secret and share this with Spencer.
Important - once generated you can't view it again. copy-paste it to a text editor.
#4 - Fill out
- Title : Feel free to add here any title as this is for setup reasons only
- App domain : add www.localhost.com
- Redirect URI : add https://localhost.com
Click Create. Share the Redirect URI with Spencer in case this is different than localhost.com
#5 - Now that the identifier is created, we need to grant the necessary permission for it to perform any action. In this example, I’ll demonstrate how to grant full control access to a Site Collection.
Navigate to https://{yourtenanthere}.sharepoint.com/sites/{yoursitenamehere}/_layouts/15/AppInv.aspx
-
Fill in App Id with the Client Id you just created above, and click Lookup
-
Fill in the following Permission Request XML and click Create
Verify if you copy/paste the XML, it is valid.
#6 - Select the Sharepoint list on your Sharepoint site that you want Spencer to sync documents from. Usually, this list will be called Documents. Click Trust.
#7 - Share the Sharepoint list name with Spencer (usually this is called Documents) -
#8 - Note, after granting the permissions you can't visualize them. You can however update the permissions by executing the two previous steps. Finally, you can check registered Add-ins per site at https://{tenant}.sharepoint.com/sites/{site}/_layouts/15/appprincipals.aspx
#9 - Provide the information below to customersuccess@spencer.co
Configuration Field | Example values |
---|---|
Sharepoint tenant | 1105 |
Sharepoint tenant URL | yourtenanthere |
Sharepoint site | Spencer |
Sharepoint list | Documents |
Sharepoint add-in Client id | 8a1a3a57-f3fc-4f8b-0f3d-2bd2f81c3a92 |
Sharepoint add-in Client Secret | WdzbnWbFiFNZNdzjndzzkndWDBD |
Sharepoint add-in Redirect URI | https://localhost.com/ |