The SharePoint integration lets people search SharePoint and share or link to SharePoint files without leaving Oak. An Oak System Manager and SharePoint admin sets it up first, then each person connects their own Microsoft account.
This guide will walk you through switching on the integration, connecting accounts, and searching and sharing SharePoint content.
This guide covers:
- Switching on the integration
- Connecting your account
- Searching and sharing SharePoint content
- Considerations, tips & guidance
Before you start:
- To set up the integration, you need to be assigned the System Manager permission
- Each person needs their Microsoft organisation account to connect
Switching on the integration
- Go to the Actions button > Configure > Site Settings.
- Select Connections > Browse Library > Add SharePoint Online.
-
Enter your SharePoint site URL and choose your settings:
- Allowed site paths: leave empty to include every site people can see, or add paths to limit Oak to those sites and their subsites.
- Search OneDrive for Business: lets people find their own files too.
- Synchronise Changes in Linked Content: keeps copies in Oak up to date when the SharePoint file changes. This needs a service account with access to the content.
- Force Links to Content: choose who must link to SharePoint files instead of copying them. We recommend All Users.
- Select OK.
Connecting your account
- Select your photo in the Oak sidebar to open your profile.
- Go to Profile Settings > Connections and select SharePoint Online.
- Sign in with your Microsoft organisation account and accept the permissions.
The icon turns to colour when you're connected. Oak never sees or stores your password.
Searching and sharing SharePoint content
- Search: select the magnifying glass in the sidebar. Results show from everywhere by default, and you can filter to just Oak or just SharePoint.
- Share files: go to the Actions button > Upload and choose SharePoint as the source. Browse or search for files, choose whether to link back to SharePoint or take a copy, then select Next.
Note: SharePoint documents can now be surfaced in Aria Search. It's ready to test out in BETA - check out our guide on How to set up and use SharePoint in Aria Search.
Considerations, tips & guidance
- Ask a Microsoft 365 administrator to connect their account first. They can then consent for the whole organisation, so others skip that step.
- If someone sees an error instead of a sign-in page, clear their browser cookies and restart the browser, or try in a private window. This usually happens when someone has several Microsoft accounts or no access to the SharePoint site.