(CROSSCAP Enterprise only)
The import function will automatically import images (scanned elsewhere) into a CROSSCAP Enterprise system, for further processing (please note: you may manually import images through a CROSSCAP scan-client, at any time, see File Menu in chapter Menu bar functions).
Such images may, for example, originate from a multifunction printer (frequently found in office environments). A multifunction printer will usually not be interfaced to CROSSCAP directly (via TWAIN), but will typically store its scanned images somewhere on the network, on a shared drive.
In order to perform automated file import, you will have to decide on a common transfer directory (this directory needs to be specified on the scanning device, as well as on the CROSSCAP Enterprise server). The transfer directory will be regularly polled by the import function, continually checking for the presence of signalling files.
A signalling file needs to be created by the system providing image data (e.g. a multifunction printer) and indicates that a complete set of files is ready for import.
Two different types of signalling files are recognized by the CROSSCAP Enterprise file importer, Semaphore-files and XML-files.
Semaphore Import
Semaphore Import uses plain, empty files, for signalling.
The filename and the filename extension may be arbitrarily assigned. Please note that the filename of the signalling file and the name of the transfer directory are also processed by the file importer and are made available as variables, within CROSSCAP - see the section on Batch name template, below.
The presence of a semaphore file (not its content) indicates the following: image files in the same directory (as the semaphore file) are ready for import (i.e. no further image files will be added) and all files within this directory belong to the same batch.
Filter
Restricts the search for signalling files to specific filenames and/or filename extensions.
Batch name template
Specifies the name for the batch to be imported:
The left side of the Properties of ... window lists all configuration options available for this item, the right side shows the options chosen so far. By highlighting one of the options and operating the green left or right arrow buttons, the option can be moved back and forth between the left column (Available) and the right column (Selected).
If an option is highlighted in the right column (Selected), it may be moved up or down the list by operating the green up or down arrows. This changes the sequence in which the options are executed (processing will proceed from the top of the list).
A highlighted option in the right column (Selected) will also appear in the Properties of ... panel below, where additional settings may be made.
Two import specific variables (Actual import file name, the current name of the signalling file and Actual import directory name, the name of the current transfer directory) are available for generating the Batch name template. For more and detailed information on the other variables, please refer to the separate section on Variables, in the Appendix.
Directory
The directory you want the file importer to regularly check, for the presence of signalling files.
Delete input files
If this option is set to On, all imported files and the semaphore file will be deleted, after processing.
If this option is turned Off, then the imported files and the semaphore file will not be deleted. Instead, the signalling file will be renamed by appending ".done" to its filename, indicating that it has been successfully processed.
Include subdirectories
If this option is set to On, then the file importer will not only search the transfer directory (as specified above) for semaphore files, but also all of its subdirectories. This way, more than one batch can be simultaneously queued for import, and these may even originate from different sources.
If this option is turned Off, then the file importer will exclusively search the transfer directory specified above. If more than one batch needs to be imported, then the scanning device or the scan-operator will need to ensure that the transfer directory is cleared from image files, before proceeding.
Import (as) duplex
If this option set to On, then imported images will be alternately interpreted as the front and reverse sides of pages, and image metadata will be changed to reflect this.
If this option is turned Off, then all images will be treated alike.
XML Import
XML Import strictly uses files with an *.xml filename extension, for signalling.
The filename itself (but not the *.xml filename extension) may be arbitrarily assigned. Please note that the name of the signalling file and the name of the transfer directory are also processed by the file importer and are made available as variables, within CROSSCAP - see the section on Batch name template below.
The file's xml content provides information about the batch to be imported, e.g. where the image files are located (they do not have to be in the same directory as the signalling file) and who performed the scan.
If document separation was performed during scanning, then the xml-file will also convey information about the location of document separators and respective document names (which will replace the labelling usually derived from bar-code recognition or other document separators).
Here is a simple example for an xml signalling file:
The settings for an XML signalling file are as follows:
Batch name template
Specifies the name for the batch to be imported:
The left side of the Properties of ... window lists all configuration options available for this item, the right side shows the options chosen so far. By highlighting one of the options and operating the green left or right arrow buttons, the option can be moved back and forth between the left column (Available) and the right column (Selected).
If an option is highlighted in the right column (Selected), it may be moved up or down the list by operating the green up or down arrows. This changes the sequence in which the options are executed (processing will proceed from the top of the list).
A highlighted option in the right column (Selected) will also appear in the Properties of ... panel below, where additional settings may be made.
Two import specific variables (Actual import file name, the current name of the signalling file and Actual import directory name, the name of the current transfer directory) are available for generating the Batch name template. For more and detailed information on the other variables, please refer to the separate section on Variables, in the Appendix.
Directory
The directory you want the file importer to regularly check, for the presence of signalling files.
Delete input files
If this option is set to On, all imported files and the xml signalling file will be deleted, after processing.
If this option is turned Off, then the imported files and the xml signalling file will not be deleted. Instead, the signalling file will be renamed by appending ".done" to its filename, indicating that it has been successfully processed.
Include subdirectories
If this option is set to On, then the file importer will not only search the transfer directory (as specified above) for xml signalling files, but also all of its subdirectories. This way, more than one batch can be simultaneously queued for import, and these may even originate from different sources.
If this option is turned Off, then the file importer will exclusively search the transfer directory specified above. If more than one batch needs to be imported, then the scanning device or the scan-operator will need to ensure that the transfer directory is cleared from image files, before proceeding.
Import (as) duplex
If this option is set to On, then imported images will be alternately interpreted as the front and reverse sides of pages, and image metadata will be changed to reflect this.
If this option is turned Off, then all images will be treated alike.
Behaviour during import, behaviour in case of error
File locking during import
In order to prevent a semaphore or xml signalling file from being opened by some other process, during import, it is temporarily renamed by appending "~" (tilde). As soon as the file has been processed successfully, it is finally renamed to "*.done".
Supported image file formats
The following types of image files can be processed by the file importer:
*.jpg, *.tiff, *.tif, *.bmp, *.gif, *.j2k, *.jp2, *.png, *.pnm, *.psd, *.tga, *.wmf
Other file name extensions (or other file formats) and corrupted files will cause an error (see below).
Error file, log file
If a semaphore or xml signalling file cannot be processed successfully, file import will abort and the signalling file will be renamed by appending ".err". Also, an additional file ending with ".log" will be generated, this file contains further information on the error which caused the problem.