Using Scan Emulate

Scan Emulate simulates scanning. It is activated when ScanCard is set to EMULATE. Other settings (listed below) specify details of how Scan Emulate works. Those settings are located in the [Scanner] section of Eilocal.ini. All of the settings are read whenever a Scan job is started.

Scan Emulate is enhanced with sorting methods that pre-read and sort 100 file names at a time. Files can be sorted in order of name, time, or FAT. If FAT order is selected, no sorting is performed and Scan Emulate works the same as in previous versions.

You can also use the INI file settings to specify a source directory, instead of having a dialog appear after you start the Scan job.

ScanType is ignored when you use Scan Emulate.

Setting Description
ScanCard Set to EMULATE to activate Scan Emulate.
EmulateMode Only necessary if you want to view dialogs for advanced scanner settings. (More information.)
EmulateExt The file name search pattern. Usually *.tif.

Only files of the specified extension are processed by Scan. For example, if you set this EmulateExt=*.png, only PNG files are processed by Scan.

If EmulateSortMode is set to 0 (FAT), the EmulateExt setting is ignored and all files in the directory specified by ScanSource are processed. In that case, you must ensure that all files in that directory are valid image files.

EmulateSortMode The order in which files are to be retrieved by the Scan module. Valid values:

0 – no specific order

1 – by file name

2 – by file timestamp

ScanSource The source directory for image files. Scan Emulate searches this directory for files that match the search pattern specifies by EmulateExt (see above).

Do not use ReadSoft Invoices' Images folder. This will not work.

Processed files are moved to a new subdirectory, Scanned, in the directory specified by ScanSource.

If ScanSource is not set, Scan displays a dialog that allows you to manually select where to get the images.

SafeImportTimeDiff The minimum "age" in seconds that at a file must have in order for Scan Emulate to take it. Using this flag ensures that Emulate does not take a file that is in the process of being created by a scanner.
EmulateSortBuffer The maximum number of files picked up by the Scan module in Emulate mode, for the sorted list. The default is 100 files.
Note
  • When using Scan Emulate, set KeepOriginalFilenameWhenScanEmulating to 1.
  • Scan Emulate has not been thoroughly tested with all the available settings in ReadSoft Invoices and is not officially supported by ReadSoft.
Limitations
  • No multi-TIFF import
  • No rotation
  • Only one Scan Emulate per source directory
  • No import to subdirectories
  • Performance loss when there are many files in the source directory and files are sorted by name
  • INI file settings and the part of the API that sets the source directory are only active when a Scan job is started.