OptimiDoc Server Help Center

SharePoint Online

The SharePoint Online print connector turns a SharePoint document library into a browsable print source. A signed-in user opens the connector at the device panel, browses the library, and selects a document -- OptimiDoc downloads it on demand, converts it to PDF if needed, and prints it as a job owned by that user. It connects to SharePoint Online via OAuth 2.0 and the Microsoft Graph API.


https://optimidoc.atlassian.net/wiki/download/attachments/43122765/connector-sharepoint.png?api=v2

Screenshot: SharePoint Online connector configuration

Overview

The SharePoint Online connector is a browse-on-demand print source, not a background watcher. OptimiDoc does not poll the library or copy files automatically. The connector appears in the list of print sources on the device; the user browses the document library, picks a file, and only then is it downloaded and printed. The file stays in SharePoint untouched.

Unlike the OneDrive connector, which targets individual user drives, this connector targets a shared SharePoint site document library -- ideal for team sites and departmental repositories.


How It Works

  1. The user authenticates at an OptimiDoc-enabled device and opens the SharePoint Online connector.

  2. OptimiDoc uses the stored OAuth token and Microsoft Graph to list the library.

  3. The user browses and selects one or more documents, which are downloaded on demand and converted to PDF if needed.

  4. A print job is created, owned by the signed-in user, and released through the rules engine and quota checks.


Configuration

  1. Navigate to Printing > Print Connectors and click Add Connector.

  2. Enter a Name and select SharePoint Online from the Type dropdown.

  3. On the Configuration tab, complete the settings below.

Configuration Settings

Setting

Description

URL

The SharePoint tenant root (e.g. https://company.sharepoint.com/).

Web/Site

The relative site path (e.g. sites/Documents or sites/TeamSite).

Path

The library and folder to browse (e.g. /Shared Documents/PrintQueue).

Client ID

The Application (client) ID from the Microsoft Entra app registration.

Client Secret

The client secret value from the app registration. Stored encrypted.

  1. On the Access Rights tab, assign the connector to one or more Groups.

  2. Click Save, then authorise the connection (below).

Registering the Entra Application

In the Microsoft Entra admin centre, create an app registration, set the redirect URI to the OptimiDoc callback, create a Client secret, and grant the Microsoft Graph permissions to read sites and files (with admin consent). Paste the Client ID and Client Secret into the connector.

Authorising the Connection

Reopen the saved connector, open the OAuth Authorization card, click Authorize, and consent. Use Re-authorize to refresh tokens or Revoke authorization to clear them locally.


Finding the Site and Library Path

  1. Open the SharePoint site in a browser.

  2. The URL is the tenant root (e.g. https://company.sharepoint.com/).

  3. The Web/Site is the relative site path in the address (e.g. sites/Engineering).

  4. The Path is the library and folder you want to browse (e.g. /Shared Documents/PrintQueue).


Troubleshooting

Issue

Resolution

Authentication errors

Verify Client ID and Client Secret and that admin consent has been granted in Entra.

Site not found

Check URL and Web/Site; the site path must be a valid relative path such as sites/MySite.

Library or folder not found

Confirm the Path exists; navigate to it in the browser to verify.


Related articles