The Folder print connector exposes a network or local directory as a browsable print source. At the device panel a signed-in user opens the connector, browses the folder, and selects a document to print -- OptimiDoc fetches that file on demand, converts it to PDF if needed, and creates a print job owned by that user. It is the simplest connector to set up and a natural fit for home directories and folders produced by line-of-business applications.
Screenshot: Folder connector configuration
Overview
Unlike a background watcher, the Folder connector is a browse-on-demand print source. OptimiDoc does not poll the folder or copy files automatically. Instead, the connector appears in the list of print sources on the device panel; the user navigates the directory tree, picks a file, and only then does OptimiDoc download and print it. The original file is left in place -- nothing is moved or deleted.
This connector is commonly used for:
-
Per-user home directories, so each person can print anything in their own folder
-
Shared folders where line-of-business, ERP, or accounting systems deposit print-ready documents
-
Reprinting archived documents without installing a driver
How Browse-and-Print Works
-
The user authenticates at any OptimiDoc-enabled device and opens the Folder connector from the list of print sources.
-
OptimiDoc connects to the folder (using the connector's credentials, if any) and lists the sub-folders and supported documents it contains.
-
The user browses to and selects one or more files.
-
Each selected file is downloaded on demand. If it is not already a PDF it is converted to PDF automatically.
-
A print job is created and owned by the signed-in user, then released to the device -- passing through the rules engine and quota checks like any other job.
-
The source file remains untouched in the folder.
Per-User Home Folder Fallback
If the connector's Path is left empty, OptimiDoc falls back to each user's personal Home Folder -- the path stored as a credential on the user account (populated manually or during Active Directory import). A single Folder connector with no path therefore lets every user browse and print from their own home directory, with no per-user configuration.
Configuration
To configure a Folder print connector:
-
Navigate to Printing > Print Connectors in the sidebar.
-
Click Add Connector (the type defaults to Folder).
-
Enter a descriptive Name (e.g. "ERP Output" or "Home Folders").
-
On the Configuration tab, complete the settings below.
Configuration Settings
|
Setting |
Description |
|---|---|
|
Path |
The UNC or local path to the folder (e.g. |
|
DFS Path |
Enable if the path is a DFS (Distributed File System) namespace. OptimiDoc resolves the DFS target before connecting. |
|
Login |
Username for accessing the folder, if authentication is required. Leave empty to use the OptimiDoc service account. |
|
Password |
Password for the login account. Stored encrypted. |
|
Domain |
The Active Directory domain for the login credentials. |
|
Login Format |
How the credentials are presented when mapping the share: |
|
Overwrite Existing Files |
Controls whether files with the same name are replaced when the folder is also used as a write target. Not relevant to browse-and-print. |
-
On the Access Rights tab, assign the connector to one or more Groups (or enable it for everyone). Only users with access see the connector on the device panel.
-
Click Save.
Authentication and DFS
When Login and Password are supplied, OptimiDoc maps the share with those credentials in the chosen Login Format. If the initial connection fails and DFS Path is enabled, OptimiDoc resolves the DFS namespace to its underlying target and retries. When no credentials are given, the folder is accessed under the identity of the OptimiDoc service.
Testing the Connection
After saving, verify the configuration from the three-dot menu on the connector row by selecting Test Connection. OptimiDoc attempts to reach the folder and reports whether the connection succeeded.
Troubleshooting
|
Issue |
Resolution |
|---|---|
|
Folder is empty or missing on the device |
Confirm the Path is reachable from the OptimiDoc server and the credentials have read access. If the path is empty, check that the user has a Home Folder credential. |
|
Authentication errors |
Verify Domain and credentials, and try switching Login Format between |
|
DFS path not resolving |
Enable DFS Path and confirm the DFS namespace is reachable from the server. |
|
A document will not print |
Only supported document formats are listed. Files that cannot be converted to PDF are skipped -- check the OptimiDoc log for conversion errors. |
Related articles