Microsoft 365 Integrations: Setup Guide

Connect your Microsoft 365 SharePoint, OneDrive or TeamsDrive with Showell and sync your selected content.

Create Dedicated Integration Users (Optional)

💡 This step is particularly advisable for Professional or Enterprise Workspaces that manage a substantial number of users.

Create separate user accounts specifically for the integration. These serve as a bridge between SharePoint/OneDrive/TeamsDrive and Showell, minimizing interruptions and simplifying access management while preventing accidental file modifications.

Create a Dedicated Integration User in SharePoint/OneDrive/TeamsDrive

• Example Account Name: Companyname_Admin or showell.sync@yourdomain.com.
• Access Rights: Grant read-only access unless read + write access is specifically needed for specific sites or libraries.
• When authorizing the connection between Showell and Microsoft, Sign in with this User Account

Set Up Access to Sites, Libraries, and Folders

Ensure the integration user has access to all required SharePoint sites, document libraries, and folders.

1. Permissions Settings:

• If using a new SharePoint site, assign the integration user read + write access.
• For existing sites, ensure the integration user has read access at a minimum.

2. Set Up Access:

1. Navigate to the SharePoint site or OneDrive folder.
2. Click “Share” or adjust permissions via “Site Settings”.
3. Add the integration user’s email and set permissions to "Read" or "Read + Write" as needed.

Create a Dedicated Integration User in Showell:

Utilizing a dedicated user account will help ensure that your integration operates seamlessly without any disruptions and remains unaffected by individual user settings.

• Example Account Name: Companyname_Admin or showell.sync@yourdomain.com.
• Access Rights: Assign this user with the Admin role.
• In Showell, sign in with this user account to initiate the authorization process.

 

---

Authorize the connection between SharePoint/OneDrive and Showell

1. Go to Showell Admin

• Login with you dedicated Showell integration user

2. From the top menu, select: Admin > SharePoint/OneDrive

3. Begin authorization by selecting “Authorize by signing in to SharePoint/OneDrive”

• Login/authorize with your dedicated Microsoft integration user

 

---

Create linkages: Sync your content between SharePoint/OneDrive and Showell

Once the connection has been authorized, you can start syncing your content between SharePoint/OneDrive and Showell.

1. Connect your folder

• When connecting your first folder, you can click 'Connect first folder'
• When connecting a folder later on, click 'Connect folder' in the top right corner

2. A pop-up screen will appear to connect your SharePoint/OneDrive folder to Showell

• Use the arrows to navigate your contents
• Left panel: Choose the SharePoint/OneDrive folder you want to connect
• Right panel: Choose the target destination for this folder in your Showell directory

3. Click OK

 

---

Manage your integration

1. Check the status of your linkages by refreshing them. Running linkages can be monitored using this feature to see if they have been completed. This will not fetch new or changed files.

2. To fully remove your SharePoint/OneDrive connection: Click SharePoint/OneDrive > Disable SharePoint/OneDrive

3. By clicking the 'Drop-down menu'-button located on the right side of your connected folder, you are able to:

• Remove connection: This will remove the individual linkage
• Disable connection: The linkage is still connected but will not synchronize
• Fetch new or changed files: This will immediately synchronize the individual linkage

 

---

Enhance your integration with custom columns/field data

By utilizing custom columns on the SharePoint side, you can decide what files and information comes over to Showell.

What we support:

A Keyword column: A keyword you have provided to a file on the SharePoint side, will sync, and be provided to the file's keyword field in Showell.

A Language column: A language-tag you have provided to a file on the SharePoint side, will sync, and will be provided to the file's language field in Showell.

A column for filtering: You have the flexibility to 'tag' specific files that you want to sync with Showell. By using for example a field with options such as 'Value A', 'Value B', or 'Value C', you can choose to synchronize only the files with 'Value A'. This allows you to have greater control over the content that is transferred to Showell.

How To:

1. Create the custom column(s) within SharePoint and give them a name of choice.

• Do not make multiple fields for one subject (for example: create only 1 field for Keywords instead of multiple).
• Set the following Type: 'Managed Metadata' for keywords and/or languages, and 'Single line of text' for filtering options.
• Under "More options", check "Allow multiple values"
• If you are adding a language column, make sure to utilize the two-character language code, based on the ISO 639-1 standard

2. In order to configure and activate the column's data support on Showell's side: Please provide the precise name of these custom columns to your Showell contact person or Showell Support.