A project defines where documents enter and leave the system and how they are processed. Projects are configuration boundaries, not security tenants.
General settings #
• Name and Description identify the project
• Active controls whether background jobs include the project
• Input Mode selects the source
• Output Mode selects the destination
• Document Separation Mode determines how multipage inputs are split
• Exception Handling Mode determines how documents that cannot follow the normal path are handled
• Processed Source Action determines what happens to the original working file
Input modes #
|
Mode |
Behavior |
|---|---|
|
File System |
Imports supported files from a local folder or network share |
|
ODDC API Only |
Accepts documents through the Integrations API |
|
IMAP Email |
Imports supported attachments from unread IMAP messages |
|
Microsoft 365 Email |
mports supported attachments through Microsoft Graph |
|
Microsoft 365 SharePoint |
Imports files from a SharePoint document library |
Output modes #
|
Mode |
Behavior |
|---|---|
|
File System |
Copies completed exports to the destination folder |
|
ODDC API Only |
Retains completed exports in the object store for API download |
|
Microsoft 365 SharePoint |
Uploads completed exports to SharePoint |
Separation modes #
|
Mode |
Behavior |
|---|---|
|
Barcode Separator Page |
A dedicated page containing a barcode starts a new document. The barcode is expected only on separator pages. |
|
Barcode Value Flow Change |
A barcode is expected on every page. Consecutive pages with the same value remain together; a value change starts a new document. |
|
Blank Page |
A detected blank page acts as a virtual barcode separator. The threshold is configured as 0–100 percent and defaults to 10 percent. |
File-system folders #
For file-system workflows configure:
|
Source Folder |
Hot folder monitored for input |
|
Destination Folder |
Normal exports |
|
Exception Folder |
Exception documents |
|
Processed Folder |
Original source documents after processing |
Use UNC paths for network resources. Do not use mapped drive letters for a Windows service because drive mappings are user-session-specific. Keep source, destination, exception, processed, object-store, and temporary locations separate to prevent reimport loops.
The hot-folder job waits until a file’s last write time is older than Global.LastWriteOlderThanSeconds before importing it. The default is 15 seconds.
IMAP settings #
The project stores host, port, SSL selection, username, encrypted password, mailbox folder, optional sender and subject filters, delete-after-processing behavior, optional processed mailbox folder, look-back days, and connection timeout. The defaults are port 993, SSL enabled, mailbox INBOX, 7 look-back days, and a 30 second timeout.
If deletion is disabled and a processed mailbox folder is configured, processed messages can be moved there. Otherwise, they are marked read. Use a dedicated mailbox account with the minimum permissions required.
Microsoft 365 settings #
Shared Microsoft 365 settings include tenant ID, client ID, encrypted client secret, optional encrypted certificate thumbprint, Graph scope, SharePoint host and site names, and connection timeout. The default scope is https://graph.microsoft.com/.default.
Email-specific settings include mailbox address and folder, sender and subject filters, delete or move behavior, look-back days, and timeout. SharePoint settings include source, destination, exception, and processed folders.
Use a dedicated Entra ID application with only the Microsoft Graph application permissions required by the selected features. Re-enter encrypted secrets after a cross-machine restore if machine-level data-protection keys can no longer decrypt them.
Barcode settings #
Select only the barcode symbologies actually expected. Enabling unnecessary types can increase processing time and false positives.
Export settings #
Available export formats are:
• Multipage TIF
• Image-only PDF
• Text-on-image searchable PDF
OCR settings #
OCR language files are packaged for the languages displayed by the UI. Select the smallest practical language set for the project.
Regular expression settings #
Only barcode data that matches the specified regex value(s) will be used. This prevents situations where a single page contains multiple barcodes. Regular expressions are evaluated in their configured order and can be activated or deactivated individually.
Existing output files #
When Overwrite existing output files is disabled, the ODDc Server preserves the existing file and adds a dot-separated counter to the new filename. For example:
AR734495.tifAR734495.1.tifAR734495.2.tif
When overwrite is enabled, the new export replaces the existing file. The setting also affects movement of original files into the processed folder.
