The Box print connector turns a Box cloud folder into a browsable print source. A signed-in user opens the connector at the device panel, browses their Box folder, 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. Access to Box is granted once via OAuth 2.0.
Screenshot: Box connector configuration
Overview
The Box connector is a browse-on-demand print source, not a background watcher. OptimiDoc does not poll Box or copy files automatically. The connector appears in the list of print sources on the device; the user browses the configured Box folder, picks a file, and only then is it downloaded and printed. The file stays in Box untouched.
Common use cases include:
-
Letting users print documents they keep in Box, from any device, without a driver
-
Departmental Box folders that hold ready-to-print documents
How It Works
-
The user authenticates at an OptimiDoc-enabled device and opens the Box connector.
-
OptimiDoc uses the connector's stored OAuth token to list the folder's contents via the Box API.
-
The user browses and selects one or more documents.
-
Each file is downloaded on demand and converted to PDF if it is not already.
-
A print job is created, owned by the signed-in user, and released through the rules engine and quota checks.
Configuration
To configure a Box print connector:
-
Navigate to Printing > Print Connectors and click Add Connector.
-
Enter a Name and select Box from the Type dropdown.
-
On the Configuration tab, set the single field below.
Configuration Settings
|
Setting |
Description |
|---|---|
|
Path |
The Box folder to browse (e.g. |
-
On the Access Rights tab, assign the connector to one or more Groups.
-
Click Save, then authorise the connection (below).
Authorising the Connection
Box access uses OAuth 2.0 through OptimiDoc's registered Box application -- you do not need to create your own Box app.
-
Reopen the saved connector by clicking its row.
-
In the OAuth Authorization card, click Authorize.
-
Sign in to Box and grant access. You are returned to OptimiDoc and the status shows Authorized.
Use Re-authorize to refresh the tokens, or Revoke authorization to clear the stored tokens locally (the connector then shows Unauthorized until re-authorised).
Troubleshooting
|
Issue |
Resolution |
|---|---|
|
Connector shows Unauthorized |
Open the connector and click Authorize. If it was working before, the token may have been revoked in Box -- use Re-authorize. |
|
Folder is empty on the device |
Check the Path matches a folder that exists in the authorised Box account. |
|
A document will not print |
Files that cannot be converted to PDF are skipped. Check the OptimiDoc log for conversion errors. |
Related articles