Source Details

A source is the folder that you wish DFA to monitor for jobs to send to Docbox.

To view existing sources, navigate to Control Panel > Sources. This will show all existing sources. Selecting a source by clicking will show the source details panel. This allows you to modify or delete a source.

How sources relate to destinations

A source always sends its output to one destination, so a source can't be created until its destination already exists (refer to Destination Details). If you're setting up DFA for the first time, this is why the order matters: Token, then Destination, then Source.

Add New

You can add a new source by 

  1. Control Panel > Sources > New Source
  2. This opens the Source Details panel
Field Description
Source Label This the name used to identify the source
Source Type

Local Folder - select this option to monitor a folder
SFTP - select this option if you wish to monitor a folder on a remote device

Local Folder

Field Description
Path name specify the full address of the folder to be monitored
e.g. C:\Docbox Source Folder\Colour Printer
 
 

SFTP

Select this option if you wish to monitor a folder on a remote device

Field  Description
Path The full address of the path to be monitored
Hostname / IP Specify either the hostname or IP address of the remote machine.
Port Number Specify the port number for the connection
User Name Specify the username to be used for the connection
Private Key Passphrase The passphrase used to protect the private key
Private Key Filename Details of the filename containing key
 
 
Destination Select the destination that you wish to send output to.
Sent Action

Choose the action to take once DFA has sent the output to Docbox

  • Archive
    • a copy of the file will be placed in source folder\archive in year \ month \ day subfolders
    • the file will be prefix with job ID e.g. job nnn - filename.pdf
  • Delete
    • The file will be deleted after being sent to Docbox.
Failure Threshold Specify the number of failures that are allowed before the pipeline will be stalled
Poll Interval (seconds) Specify how often DFA should check the folder for new content. This should be specified in seconds. The minimum poll interval is 15 seconds.
Archive Failures If this is enabled, DFA will store any jobs which have failed in the source folder\failed in year \ month\ day subfolders. The file will be prefix with job ID e.g. job nnn - filename.pdf.
Reject Duplicates If this is enabled, DFA will reject any files that have already been processed. DFA checks the properties of the files. It does not compare file contents.
Active Select this to activate the Source

Deleting a Source

To delete a source, select it from the list and click Delete in the Source Details panel.

Known Files

DFA uses a "known files" policy to prevent duplicate file submission.

Within a defined window, DFA will not process a file if it thinks it is already known to the system. Therefore if two files are submitted with the same filename, the second will not be processed and will remain in the source folder. 

This is regardless of Reject Duplicates setting.

The default "known files window" is 7 days. This can be configured as required.

In practice: this means if the same file is dropped into the source folder more than once within that window - for example, testing the same PDF repeatedly, or a user accidentally copying a file twice - only the first copy will be processed. Later copies will sit in the source folder untouched rather than being sent again. If you need to resubmit a file for testing, rename it or wait for the known files window to pass.