Beruflich Dokumente
Kultur Dokumente
Capture
9
10300939-000
© 1994 - 2010 Kofax, Inc., 15211 Laguna Canyon Road, Irvine, California 92618, U.S.A. All rights
reserved. Use is subject to license terms.
Kofax, the Kofax logo, Kofax Capture, the Kofax Capture Logo, Ascent Capture, the Ascent Capture
logo, and Ascent are trademarks or registered trademarks of Kofax, Inc. in the U.S. and other countries.
All other trademarks are the trademarks or registered trademarks of their respective owners.
U.S. Government Rights Commercial software. Government users are subject to the Kofax, Inc. standard
license agreement and applicable provisions of the FAR and its supplements.
You agree that you do not intend to and will not, directly or indirectly, export or transmit the Software
or related documentation and technical data to any country to which such export or transmission is
restricted by any applicable U.S. regulation or statute, without the prior written consent, if required, of
the Bureau of Export Administration of the U.S. Department of Commerce, or such other governmental
entity as may have jurisdiction over such export or transmission. You represent and warrant that you
are not located in, under the control of, or a national or resident of any such country.
1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Document and Data Capture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
What is Kofax Capture? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Kofax Capture Process Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Administration Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Batch Manager Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Scan Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Quality Control Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Recognition Server Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
OCR Full Text Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Kofax PDF Generator Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Validation Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Verification Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Export Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
What is Kofax Capture Network Server? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
KCN Server Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Major Features of KCN Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Tight Integration with Kofax Capture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Batch Routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Centralized Administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Centralized License Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Data Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Offline Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Internet/Intranet Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Remote Site Profile Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Batch Class Assignment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Event Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Site Switching Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Remote Synchronization Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
What is Kofax Capture Enterprise? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
High Availability Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Multiple Instance Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Disaster Recovery Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Display Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Items That are Not Converted/Translated . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Copying a Batch Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Create Your Field Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
User Defined Dictionaries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Full Text Dictionary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Zonal Dictionary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Known Values for Field Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Create Your Folder Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
About Folder Creation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
The Basic Auto-foldering Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Index Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Creating a Folder Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Copying a Folder Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Create Your Document Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Copying a Document Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Index Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
OCR Full Text Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Recognition Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Kofax PDF Generator Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Recognition Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Image Compression Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Validation Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Database Validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Remote Database Validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Export Connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Target Database Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Multiple Export . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Create Your Form Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Copying a Form Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Permanent Image Cleanup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Image Cleanup Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Page Registration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Automatic Index Field Recognition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Page-Level Bar Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Bar Code Recognition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Where Bar Code Recognition Occurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Enhanced Versus Standard Bar Code Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Bar Code Recognition Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Document Separation with Bar Codes on Color Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Page Level Bar Code Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Sample Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
About Zones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Index Zones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Registration Zones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Separator Zones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Form Identification Zones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Index Group Zones (SmartGroups) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Working with Zones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Selecting Recognition Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Drawing Zones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Temporary Image Cleanup for Zones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
4 User Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
User and Group Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
User Versus Group Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Default Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Enabling the User Profiles Feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Disabling the User Profiles Feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Working with User Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Adding a User Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
Introduction
The Kofax Capture 9 Getting Started Guide contains the essential information needed to start using
Kofax Capture and Kofax Capture Network Server (KCN Server).
This guide is intended to be used by system administrators and developers who need a
description of the Kofax Capture application and its user interface, as well as those who are
configuring and managing the remote capabilities of KCN Server used in conjunction with Kofax
Capture installations.
For Kofax Capture, this guide assumes you have a thorough understanding of Windows
standards, applications, and interfaces. For KCN Server, this guide assumes that you have a
working knowledge of the Internet and your Web server, your network configuration, and Kofax
Capture.
Related Documentation
In addition to this Kofax Capture 9 Getting Started Guide, Kofax Capture 9.0 includes the following
documentation.
To access the API Reference Guide, select Start | Programs | Kofax Capture 9.0 | API Reference
Guide from the taskbar.
Training
Kofax offers both classroom and computer-based training that will help you make the most of
your Kofax Capture solution. Visit the Kofax Web site at www.kofax.com for complete details
about the available training options and schedules.
Technical Assistance for Your Kofax Product
Support for your Kofax product is provided by your primary application support provider, which
is specified as part of the maintenance agreement associated with your purchase. Please contact
your Kofax application support provider for technical assistance.
For more information about your product, visit the Kofax Support pages at www.kofax.com for:
Product information and release news
Access to the Kofax Knowledgebase
Access to the online Case Management System (for eligible customers)
Downloadable product documentation
Before contacting your Kofax application support provider, please gather the following
information where applicable:
Product name, version, and serial number
Log files
Product license
Exact error message(s)
Reproduction scenario
Overview
Kofax Capture combines both document and data capture with remote Internet-based capture.
Inexpensive capture stations can be easily set up at remote sites—across geographic regions or in
the same building—and synchronized with a central capture site via the Internet. Kofax Capture’s
open architecture makes it easy to extend the basic application to handle complex, high-volume
forms processing, as well as to capture information directly from remote offices. With automatic
regional format conversions and the ability to share batch classes with other localized languages
of Kofax Capture, all types of documents can be captured “anywhere, any time.”
Figure 1-1. The Standard Process for Document, Data, and Internet Capture
Batches of documents normally enter the system via the Scan module, Auto-import, or import
scripts and are then automatically routed from module to module as each processing step is
completed. The routing steps can vary for different batches, and they are defined for each batch
class in the Administration module prior to processing. The final processing step is the Export
module, from which in-process images and data are transferred to long-term storage and then
deleted from the Kofax Capture system.
Administration Module
The Administration module is used by system administrators to set up batch classes and maintain
the Kofax Capture system. From this module, the administrator can do the following:
Define the types of documents that will be processed and how they will be indexed.
Decide which modules the documents will pass through for processing, and in which
order.
Define processing profiles, such as document separation, form identification, image
cleanup, and recognition profiles.
Set up user profiles that specify which batch classes and Kofax Capture modules that each
user can access.
Enable user tracking.
Register custom modules.
Scan Module
The Scan module is used to create batches, scan and import documents, and edit the contents of
batches. After the batches are created, they are entered into temporary storage in the Kofax
Capture system, making them available for processing by subsequent modules.
Validation Module
The Validation module is used to enter or validate data associated with a document. It can
validate data that has been extracted via an automatic recognition technology, such as OMR, OCR,
ICR, or bar code recognition, or filled in via an automatic database lookup method. This module
can also be used to manually key data that cannot be recognized by one of the built-in recognition
engines. The operator can manually enter the index data or use Rubber Band OCR zonal
recognition on a selected text string or word. A scripting capability is included that allows users to
write simple Visual Basic-like scripts that perform automatic validation procedures such as field
comparisons, list verification, customized database lookup, and so forth.
Verification Module
The Verification module is used to verify data a second time after the data has already been
processed through the Validation module. It is typically used for critical data fields that must be
guaranteed as 100% accurate.
In the Verification module, the index data for the same document is entered by a different
operator. Then, the values are compared with the first set of index values. If the values match, they
are assumed to be correct. If the values do not match, a verification error occurs. The verification
operator must decide whether to use the validation value, the verification value, or to enter a
different value. The operator can manually enter the index data or use Rubber Band OCR zonal
recognition on a selected text string or word.
Export Module
The final stage in the Kofax Capture process is to export the documents in a batch to long-term
storage. The Export module exports the image files to permanent storage and the data values to a
target database or back-end document management system.
In addition to the standard connectors, Kofax Capture allows you to write your own export
connectors to customize the export process. For example, you might want to export documents to
a proprietary back-end or non-ODBC database.
Custom export connectors are available from Kofax for many popular content management,
document management, and workflow systems. Visit our Web site at www.kofax.com for a
current listing of supported systems.
This section describes the components and major features of KCN Server.
Multiple file cache folders can be created on one or more computers. You might want to create
multiple file cache folders so that if one file cache folder location fails, the remote sites can
continue to synchronize using the remaining file cache folder locations.
Web Server
The Web site is used to route requests and data between the KCN Server remote sites and the
central site.
Remote Synchronization Agent (RSA)
The RSA runs on at least one remote station at each remote site to automatically download
batch classes from the central site and upload batches to the central site.
KCN Service
Administration Station
Firewall Web Server
Scan Station
RSA
Recognition Station
File Cache Folder
Location
Kofax Capture Server
KCN Service
QC Station
Kofax Capture Database
K
Validation Station
Export Station
Batches created at a remote site are processed through all the modules set to run at the remote site.
When the remote processing is complete, the batches are uploaded to the central site. Once
uploaded, the batches are integrated into the central site’s Kofax Capture system for further
processing and export.
KCN Server allows IT and IS managers to develop and implement enterprise-wide capture
solutions. With KCN Server, documents can be scanned inexpensively at remote stations and then
automatically uploaded to the central site, securely and reliably.
Batch Routing
Using remote or central site profiles, you can specify where each module processes a batch as it
moves through the Kofax Capture workflow. You can freely move batches from one site to
another (using the central site as a hub). However, the Scan module must be run at the “Batch
Creation Site,” while the Export module must be run at the central site. Aside from these two
restrictions, the other modules can be run at any location.
You can also override the batch routing settings specified in the remote site profile on a per batch
class basis. This allows you to individually control the routing of individual batches if needed.
Centralized Administration
The Kofax Capture system administrator can centrally manage configuration information,
schedules for uploading batches, and batch class definitions for all remote sites by creating and
assigning remote site profiles to remote sites.
You can specify the default behavior for assigning remote site profiles to new remote sites. This
behavior will automatically be used when a new remote site synchronizes with the KCN Server
for the first time. For example, if there is a remote site profile with a name matching a remote site,
you can set a policy in which the remote site automatically receives the matching remote site
profile.
For more information about the options purchased for your company, contact your system
administrator or Kofax Certified Solution Provider.
For more information on central site license management and licensing, contact your system
administrator, and see the Kofax Capture online Help.
Data Security
KCN Server can be configured to meet the security needs of your company. For example, you can
configure your Web server software for optimal security.
Refer to the documentation from your Web server software manufacturer for details on
administering security for your central site’s Web server.
Offline Capability
With KCN Server, remote stations do not have to be connected to the central Kofax Capture server
while processing batches. You can set your remote stations to connect with your central site and
then synchronize with your central site at predetermined intervals or on demand.
Internet/Intranet Support
KCN Server is suitable for Internet and/or intranet configurations.
An important feature is that you can exclusively specify where in the Kofax Capture workflow the
remote site routes batches to the central site.
Event Logging
KCN Server maintains a comprehensive log of polling activity and other events. Logs are
maintained at both the central site and the remote sites. See Monitoring Activity on page 171 for
additional information.
Any installation of Kofax Capture can be upgraded to Kofax Capture Enterprise. Contact your
sales representative or your Certified Solution Provider for more information about an upgrade.
The High Availability Support feature consists of a number of independent components that,
when deployed in a highly available computer system, result in robust, fault-tolerant operation.
Although fault-tolerant systems are primarily intended for enterprise-scale organizations, even
the smallest company may benefit from some of these components.
High Availability includes support for SQL Server Enterprise, Oracle, and IBM DB2.
WebSphere Support
Kofax Capture Enterprise users have the option of installing and deploying KCN Server
components on IBM WebSphere version 6.0. WebSphere can be implemented either on Solaris or
Windows operating systems.
Introduction
Kofax Capture is made up of a variety of processing modules, which are used together to define a
Kofax Capture workflow for your batches. For example, the Scan module is used to scan or import
batches into the Kofax Capture system; the Validation module is used to validate data fields
captured from your images; and the Export module is used to export batches to a back-end system
of your choice. Other modules allow you to add automatic recognition, additional data
verification, OCR full text processing, PDF generation, and more to your workflow.
This chapter introduces each of the Kofax Capture modules, and provides a brief description of
their user interface components.
Administration Module
The Administration module is used by system administrators to set up processing options for
batches and maintain the Kofax Capture system. From this module, you can do the following:
Define batch classes, which specify processing options for all of the documents in your
batches.
Define document classes, which specify processing options to apply to a set of forms. For
example, your document classes contain index field definitions for data associated with
forms.
Define folder classes, which define the properties of folders for a batch class. Folders are
created and populated with documents as the documents are processed through the Kofax
Capture workflow.
Define form types, which define specific forms to process. Form type settings include the
number of pages expected for a form, image cleanup settings, and more.
Draw zones for your index fields, which define specific areas on your forms to process.
For example, you can draw a zone around a text field on a sample page, and allow Kofax
Capture to automatically capture data from the defined area during processing.
Enable Kofax Capture User Profiles, if desired, to define privileges and access rights for
operators.
Enable User Tracking, if desired, to record and monitor operator activity.
Create/edit validation scripts with either Visual Basic .NET (VB. NET) or the Softbridge
Basic Language (SBL). Validation scripts control how index data is validated during
processing. The Softbridge Basic editor is integrated into the Administration module.
Set up and manage export connectors, which control how documents are exported from
the Kofax Capture system.
Configure remote site profiles for Kofax Capture Network Server. Remote site profiles
contain settings for managing batch processing activity between a central Kofax Capture
site and remote Kofax Capture Network Server site.
Import email with the Kofax Capture Import Connector - Email feature. This feature
allows you to automatically import email and email attachments from most standard email
servers, such as Microsoft Exchange or Lotus Notes.
Note Refer to Chapter 3 – Understanding the Basics on page 39 for information about batch classes,
document classes, form types, and other settings that control how batches are processed with
Kofax Capture.
The main screen of the Administration module supports standard Windows-style menus and
toolbar buttons, which you can use to perform batch class setup tasks.
For more information on the user interface elements, refer to Kofax Capture User Interface on
page 33.
Scan Module
The Scan module is typically the first module used to process a batch. From Scan, batches can be
created, opened, suspended, deleted, and closed. The contents of the batches can also be edited
before they are sent to the next module. The Scan module is typically monitored and used by a
scan operator, whose basic tasks include:
Batch preparation: Before scanning, the operator manually prepares a batch of paper
documents, adds separator sheets (if required), counts the number of pages in the batch (if
required), and loads the batch into the scanner’s hopper.
Batch creation: The operator creates the batch by selecting the type of batch to create (the
batch class) and then scanning or importing documents and pages. The document images
are stored in a temporary folder for further processing by Kofax Capture.
Batch editing: Once the batch is created, the operator can visually check documents or
pages, and edit them as necessary. Editing functions include replacing, reordering, or
rejecting documents and pages. Entire documents or individual pages can be rotated and
saved in the rotated state.
Note that the scan operator can use Unattended Mode, which is the ability to scan several batches
in succession without operator intervention. To use this feature, the scan operator must insert
special-purpose batch separator sheets into a stack of paper documents. The batch separator
sheets contain a patch code that triggers the start of a new batch.
Refer to Kofax Capture User Interface on page 33 for more information about user interface
elements.
VRS QC Later
Kofax Capture also includes the VRS QC Later feature, which you can use in your workflow to
repair badly scanned images without the need to physically rescan the documents. With VRS QC
Later mode enabled, the VRS user interface will remain out of view until it is invoked from Kofax
Capture to perform image adjustments. This may save time, and the resulting improved image
quality may result in better recognition results.
Also, if desired, you can adjust your images right at the scan station without sending them to the
Quality Control module.
form identification, automatic document separation, automatic image cleanup, or automatic data
capture.
Recognition Server is an unattended module. When it is running, batches ready for Recognition
Server are automatically processed, and then sent to the next module specified for the batch.
Refer to Kofax Capture User Interface on page 33 for more information about user interface
elements.
Validation Module
From the Validation module, operators manually enter or select field data for each document in a
batch. Operators can also use Rubber Band OCR on a selected text string or word. They also
validate data captured with an automatic recognition method (such as OCR, bar code recognition,
etc.). Validation is typically monitored and used by a validation operator, whose basic tasks
include manual data entry, data validation, and possibly batch editing.
Note that validation also occurs through validation scripts associated with the batch class. The
default validation scripts provide validation limited to the length of the field and the type of data
in the field. User-written validation scripts can also be used to perform additional validation.
Refer to the Kofax Capture Developer’s Guide for more information about custom scripts.
Refer to Kofax Capture User Interface on page 33 for more information about user interface
elements.
Verification Module
The Verification module is used to verify data a second time after the data is processed through
the Validation module. Verification will occur for any field tagged with the “verify” attribute for a
document class. The operator can manually enter the index data or use Rubber Band OCR zonal
recognition on a selected text string or word.
Refer to Kofax Capture User Interface on page 33 for more information about user interface
elements.
OCR Full Text is an unattended module. When it is running, batches ready for OCR Full Text are
automatically processed, and then sent to the next module specified for the batch.
Refer to Kofax Capture User Interface on page 33 for more information about user interface
elements.
The Kofax PDF Generator is an unattended module. When the Kofax PDF Generator is running,
batches ready for it are automatically processed, and then sent to the next module specified for the
batch.
Refer to Kofax Capture User Interface on page 33 for more information about user interface
elements.
The Quality Control module is typically monitored by a scan or quality control operator, whose
basic tasks include:
Quality assurance: The operator can visually check the integrity of all document images. If
necessary, the operator can edit the batch.
Batch editing: Batch editing functions include replacing, reordering, or rejecting
documents and pages.
In the Quality Control module, documents and pages that are rejected are marked with a red “X”
in the Batch Contents panel.
VRS QC Later
Kofax Capture allows you to fix bad scans without having to rescan your documents. Known as
“VRS QC Later,” this feature can dramatically increase throughput and productivity.
A Kofax Capture operator, equipped with VRS QC Later, can correct images without a scanner.
Kofax Capture will automatically flag a “bad” image and will typically send it the Quality Control
Module for repair.
Refer to Kofax Capture User Interface on page 33 for more information about user interface
elements.
Export Module
The Export module is typically the last module used to process batches. From Export, images are
copied to permanent storage, and field data (such as index fields or batch fields) is written to a
database or back-end document management system. Export is an unattended module. When it is
running, batches ready for Export are automatically processed.
The Export module exports batches as defined by export connectors specified for your batch
documents. Refer to Chapter 3 – Export Connectors on page 52 for information about the export
connectors that are provided with Kofax Capture.
You can also write custom export connectors, for example, to modify the standard export process
to export documents to a proprietary back-end or non-ODBC database. Refer to the Kofax Capture
Developer’s Guide for more information about custom connectors. In addition, visit
www.kofax.com for information on how you can purchase Kofax-supported or Partner-supported
and Freeware export connectors.
Refer to Kofax Capture User Interface on page 33 for more information about user interface
elements.
The sheets are manually inserted into a stack of documents before they are scanned. During
processing, each separator sheet signals the beginning of a new batch or document.
Batch separator sheets contain a patch code that signifies the beginning of the next batch and a bar
code that encodes the name of the batch class. During processing, Kofax Capture will recognize
the batch separator sheet, read the bar code, and create a new batch based on the batch class.
Document separator sheets contain patch codes to separate documents, and an optional bar code
that encodes the name of the form type. During processing, Kofax Capture will recognize the
document separator sheet, read the bar code (if it exists), and separate and identify documents
accordingly.
Before starting the utility, you must use the Administration module to define patch codes as the
document separation method for your batch class. For batch separator sheets, you must use the
Administration module to reserve a patch code for batch separation.
Using the Scanner Configuration Utility, you can view a list of image devices (scanners and file
import devices) and the installed drivers that are available on your computer. From this list, you
can then select a scanner and set it as the default, or restore the default settings for a specific
scanner.
You can also create and manage your import sources, so when you want to create a batch, you can
select a source device from any Kofax Capture module that allows you to create batches (Scan,
Quality Control, and Batch Manager).
Menu Bar
All Kofax Capture modules support a standard, Windows-style menu bar, from which you can
perform various operations.
Context Menus
Standard, Windows-style context menus are available by right-clicking your mouse in different
locations on the screen. The context menus provide shortcuts for various operations.
Toolbars
Most Kofax Capture modules support toolbars, which provide shortcuts to many menu items. The
toolbar buttons can be toggled on or off, or dragged to other positions on the module’s main
window for easy access. For more information, open the online Help Contents page for any
module and select User Interface | Toolbars. (The unattended modules and the Separator Sheet
Utility do not support toolbars.)
Status Bar
All Kofax Capture modules provide a status bar, which displays status messages, validation
messages, and information about the current batch.
Image Viewer
Any Kofax Capture module that allows images to be displayed provides an image viewer. The
viewer supports zoom and pan operations.
Definitions Panel
The Definitions panel is available from the Administration module. It provides a convenient way
to view the contents of batch classes, including document classes, folder classes, form types,
sample pages, zones, and more. The items are listed in typical “tree view” format, with the natural
hierarchy of the components displayed. On the Batch tab, for example, the highest level items are
batch classes. You can expand the list under a batch class to view the document classes and other
items associated with that batch class.
Your selection from the Definitions panel affects menu options and other items on the
Administration module’s main screen. For example, if a batch class is selected, choosing
Edit | Properties from the menu bar will display the properties for that batch class. If a sample
page is selected, the sample page will display in the viewer.
You can right-click on any item in the Definitions panel to display a context menu. The menu will
include appropriate options for that item. For example, you can right-click on “Page Level Bar
Codes” to display the Page Level Bar Codes dialog box, from which you can associate page level
bar codes with data fields.
The Batch Contents panel provides a convenient way to view the contents and organization of a
batch. You can see:
Folders in the batch (loose pages cannot be placed in folders)
Documents in the batch
Pages in documents
Loose pages in the batch
The items are displayed in a typical “tree view” format, with all folders (including child
documents) and documents listed under the name of the batch, all pages associated with a
document listed under that document, and all loose pages listed alone.
You can set the Batch Contents panel to display the contents as either thumbnails (small file
images or symbols) or icons. Scan Controls
The Scan Controls are available in all modules that support scanning and importing, as listed
below:
Administration (for scanning/importing sample pages)
Quality Control
Scan
The Scan Controls provide a convenient way to select a source device and start/stop a scan
operation.
Select Source drop-down list: Select a source device before you scan or import images. All
source devices configured from the Scanner Configuration Utility will be available from the
drop-down list. Once you select a source, you can select scanner settings or device options
from Scan | Settings.
An asterisk (*) displays beside a scan source name to indicate that a local source profile differs
from the shared version. This occurs when you modify, save, or delete a local profile and there
is an existing corresponding shared profile. The asterisk does not display when when no
shared profile exists or when local and shared profiles are the same. You can cause local and
shared profiles to be identical when you revert the local profile to the shared profile’s settings
(Revert to Shared Profiles) or save the local profile as a shared profile (Save Profiles as
Shared). Refer to Sharing Scanner Profiles on page 88 for more information about sharing
scanner profiles.
Scan Batch button: Click this button to scan/import a batch of pages or documents.
Stop Scanning button: Click this button to stop scanning/importing pages or documents.
Page Counter: This counter indicates how many more pages you can scan/import this month.
For more information, contact your system administrator.
Table Controls
Some Kofax Capture dialog boxes support a table control for entering certain types of data. For
example, the Document Class Properties dialog box provides an Index Fields table for defining
data fields.
Note that not all table controls contain the same set of options.
For some dialog boxes (such as the Create Batch Class, Create Document Class, Batch Class
Properties, and Document Class Properties dialog boxes), you can use your mouse to drag-and-
drop rows to achieve the desired order.
X To delete a row in a table, click on the row that you want to remove and do one of the
following:
Click Delete Index Field.
Right-click and select Delete from the context menu.
Press the Delete key from the standard keyboard or the numeric keypad.
X To select a value for columns with a drop-down list of choices, use your mouse to select
from the list.
X To sort the table, click on the column header to sort the table by the values in that column.
(Note that some tables cannot be sorted.)
X To reorder rows in the table, click on the row and drag it to the desired position.
X To use table fields, create a new row and select (TABLE) as the field type. You can then add
or remove rows to the (TABLE) with the table row buttons at the bottom left of the dialog box.
Notes Panel
A Notes panel is available from the following modules:
Scan
Quality Control
Validation
Verification
The panel is designed to make document and page notes more readable, as notations that appear
in the status bar are sometimes partially obscured by other information. With the Notes panel, you
also have the option of updating the note text. Once you update the text, it can be viewed from the
status bar or the Properties dialog box for the document or page. Likewise, when you update the
note text from the document or page Properties dialog box, the changes are reflected in the status
bar or the Notes panel.
When a document is selected, the label for the panel is “Document note.” When a page is selected,
the label is “Page note.”
Batch Thumbnails
Some Kofax Capture modules support batch thumbnails, which allow you to see the contents of a
batch in reduced view. You can view or hide batch thumbnails by selecting
View | Toolbars | Batch Thumbnails. If desired, you can undock the Thumbnails panel and move
it to another position.
Note The Batch Contents panel provides an interactive display of the contents of a batch. See
Batch Contents Panel on page 34 for more information.
Introduction
Before you can create and process batches with Kofax Capture, you must define your batch classes.
A batch class is a definition of all the settings for processing a batch, including the types of
documents in the batch, the queues through which you process the batch, and more.
This chapter introduces the basic components that make up a batch class, including field types,
form types, document classes, zones, and more. It also describes some of the basic processing
features available with Kofax Capture.
Note All client workstations in a Kofax Capture client/server installation must use the same
language version and the same regional settings.
This section provides information on regional settings and format options, what is (and is not)
translated, and how you can use the Display Label feature to create batch field and index field
display names.
For the Kofax Capture Database and the Kofax Capture Text export connectors, all numeric, date,
and time data derived from Kofax Capture Values is converted.
The following regional examples from the Windows Control Panel compare common numeric,
date, and time formats for the United States to those of Germany.
Language Translation
When a batch class is imported, Kofax Capture Values and default profile names are translated to
the language of Kofax Capture on the destination computer. This translation will occur regardless
of the language of Kofax Capture that created/exported the batch class.
Note When a batch is exported, the results returned by the Kofax Capture Values are not
translated.
Display Labels
For each batch field or index field, you can enter a corresponding Display Label value. The value
in the Display Label (instead of the actual batch field or index field name) will display where field
names appear, such as in the Scan, Validation, and Verification modules, and in batch properties
in Batch Manager.
For example, you may have an index field named cust_name, but you could specify a display label
“Customer Name” that is more easily understood by users processing the batch. Or, if you are
creating a batch class for use in another region, you could enter the labels in the language of the
region that will be importing the batch class.
If a display label is left blank, the batch field or index field name will be used by default.
Tip You may want to limit the length of your display labels. Although the index/batch field name
cannot exceed 32 characters, the display label can contain up to 254 characters. A label that
contains more than one line of text will wrap to several lines, which may be difficult for users to
read.
Unless noted, the items below apply to both Kofax Capture at the central site and KCN Server
remote sites.
Import/export of batch classes among computers that use different code pages
Batch classes created in versions of Ascent Capture prior to version 6.1
Dictionary values that are numeric, date, or time
Recognition Profile language and character set selections
Export text constants, customizations, and string fields that contain numeric, date, or time
entries
Batch names derived from time/date, because these are classified as strings, and strings
are not converted or translated
Kofax Capture module names
Results returned by Kofax Capture Values
The String data entered in the Kofax Capture programming interfaces, which applies to:
export connectors
import scripts
Kofax Capture Module Type Library
custom modules
Validation and Recognition Scripts
When copying a batch class, you have the option to link to or copy the original document classes.
If you link to the original document classes, a copy of the batch class will be created and linked to
the original document classes. If you copy the original document classes, a copy of the document
classes and their related objects will also be created.
Refer to the Kofax Capture online Help for more details about using this feature.
X To copy a batch class and include a copy of the original document classes
1 From the Batch class tree view tab, select an existing batch class that you want to copy.
2 Then, do one of the following:
From the Administration module’s menu bar, select Edit | Copy.
Right-click the selected batch class, and then, on the context menu that displays, select
“Copy.”
3 From the Batch class tree view tab, select an existing batch class.
4 To paste the copied batch class, do one of the following:
From the Administration module’s menu bar, select Edit | Paste Special.
Right-click the selected batch class, and then, on the context menu that displays, select
“Paste Special.”
5 From the Paste Special dialog box, select “Paste with a copy of the original Document
Classes.”
Note The Select “Paste with a link to the original Document Classes” option is the same
as selecting Paste from the Administration module's Edit menu or the context menu.
6 Click OK. A copy of the batch class will be created with a unique name, such as Name1,
Name2, and Name3. Also, a copy of all document classes and their related objects will be
created with a unique name and linked to the copied batch class.
7 Edit the copied batch class. You do so from the Batch Class Properties dialog box.
For each field type, you must specify the data type (for example, CHAR, VARCHAR, NUMERIC,
etc.) and other information relevant to that data type. For example, with CHAR and VARCHAR
data types, you specify the maximum length for the field. For DECIMAL and NUMERIC, you
specify the number of digits and the number of decimal places.
Field types provide an efficient way to set up data fields (such as index fields and batch fields),
along with validation criteria for the fields. You can define a pool of field types, and then select
from this pool when you define a data field.
For example, a field type named “Address” can be defined once, and then used by all varieties of
document classes requiring an address for an index field. When the index field for the address
information is being defined, it is simply a matter of selecting “Address” from the list of defined
field types.
You create field types with the Create Field Type dialog box. To display this dialog box, do one of
the following:
From the Administration module’s menu bar, select File | New | Field Type.
From the Administration module’s toolbar, click the New Field Type button.
From the Field Types tree view tab, right-click on an existing field type. A context menu
will display. Then, select “New Field Type.”
Click the New Field Type button on the General tab of any of the following dialog boxes:
Create Batch Class, Batch Class Properties, Create Document Class, Document Class
Properties, Create Folder Class, and Folder Class Properties.
Note Only a single dictionary can be used with a document class. The dictionary can support a
single language. If you have selected multiple languages, only the first language in the list of the
selected languages will use the dictionary. User-defined dictionaries are not supported if you
select Chinese, Japanese, or Korean as the primary language. All the following rules for
dictionaries apply regardless of the language.
There are two types of user denfined dictionaries used by Kofax Capture.
This type of dictionary is used by the Kofax PDF Generator module and by OCR Full Text
recognition. You can create an ASCII text file to be used as a dictionary with any ASCII text editor,
note that each word must be on a separate line in the ASCII text file
The Full Text dictionary should contain terminology specific to the document class, although
output from the recognition engine may contain words not found in the dictionary.
The dictionary file must be in a folder accessible to the recognition engines or modules that use it.
This may be either on the local workstation, via a mapped drive, or a UNC path.
Zonal Dictionary
Zonal dictionaries are the same as Full Text dictionaries. However with a zonal dictionary, each
field type can have only one dictionary, but a dictionary can be used by one or more field types.
For example, you could have seven field types and five dictionaries, with one dictionary shared by
three field types.
Folders are created and filled with documents as the documents are processed through the Kofax
Capture workflow. You can create folders manually (with batch editing), or you can allow them to
be created automatically with rules you define. You can place documents into folders manually or
automatically.
In addition to organizing your documents within Kofax Capture, the real advantage to using
folders comes after the documents have been exported from Kofax Capture. If you ensure that the
folder hierarchy in Kofax Capture matches (as closely as possible) the hierarchy used by your
document management software, you can easily import those documents into your third-party
software.
A folder class exists within a batch class, and as with other elements of a batch class, you can
create, edit, and delete folder classes.
Pages can be added to documents, and documents can be added to folders. Folders can be nested
inside other folders up to 32,000 levels. Loose pages cannot be added to a folder (although you
may have loose pages at the root level of your batch, they must be placed into a document before
they are added to a folder).
Although you can manually create a folder hierarchy through various batch editing functions, this
may be time-consuming, and the results may not be consistently or correctly applied. To address
this, Kofax Capture can automatically create and populate folders when a batch is closed at certain
points in the workflow. You can also invoke auto-foldering at any time in the workflow by
selecting an option in the Batch menu in the interactive modules (Validation, Verification, Scan,
and Quality Control).
In the Administration module, you simply identify which folder classes can be used in a batch.
You do not actually create any folders.
Folder creation rules define the organization for folders that will be created and populated
automatically. In this sense, you can think of them as a “default” folder hierarchy, although the
hierarchy does not actually exist until the batch is processed and the rules are executed. The
folders are created in accordance with the rules as a batch is processed through the workflow. You
can create virtually any type of folder structure; however, you are limited to the folder classes that
are associated with the batch class, and you can have no more than 32,000 nested levels of folders.
Note If an unexpected error should occur during folder creation, in most cases the entire creation
operation will be rolled back. No new folders will be created and no documents will placed in
them. For certain types of errors, however, you may end up with the folder hierarchy partially
created and partially populated with documents.
Otherwise, a new folder is created, its folder index field values are copied from the document
index field values, and the folder is added to the folder hierarchy. The document is then added to
that newly created folder. This only affects documents that are not already in a folder.
Index Fields
Any document index field value (if it is not in a table) may be used to drive automatic folder
creation. Hidden index fields may also be used. This may be useful if a field is automatically
recognized and used to drive folder creation, but should not be visible to the validation operator.
Note that index fields can be filled in through a variety of techniques, including bar codes, patch
codes, OCR/ICR, scripting, and customizations. Appropriate index field values must be provided
before they can be used to create a folder.
Tip As an alternative to the New Index Field button, you can right-click your mouse
on an index field in the Index Fields table and then do one of the following: select
“Insert” from the context menu or press the Insert key on the standard keyboard or the
numeric keypad. A copy of the selected index field will be inserted above the selected
field. You can edit the values as necessary.
b If desired, change the name for your index field. You can enter up to 32 characters,
including spaces. (Leading and trailing spaces will be removed.) The name must be
unique and is not case sensitive.
By default, index field names will be added in the form Namen (where n is a value
from 0 to the maximum number of index fields). Since the name of the index field will
display (unless you specify a display label) during validation and verification, you
should choose names that will be meaningful to your validation and verification
operators.
Note The index fields will be listed in the Validation and Verification modules in the
order they appear in this table. You can use drag-and-drop to reorder the fields to the
desired order.
c Select the desired field type for your index field. All previously defined field types will
be available from the drop-down list. You can also click the New Field Type button on
the General tab and create a new field type.
d If desired, specify a default value. You can enter a value, or select from the drop-down
list of Kofax Capture Values. If specified, the default value will appear as data in the
index field during validation. The validation or verification operators will be able to
enter a different value if necessary.
Note If a list of known values was specified for the field type associated with the
index field, those values will also appear in the drop-down list. If “force match” was
specified for the known values for the field type, only the known values will appear in
the drop-down list.
e Select True or False in the Required column. If you select True, the index field will be
required to contain a value during validation. The validation and verification
operators will not be allowed to close the batch until a value is entered for this field.
f Select True or False in the Verify column. If you select True, the index field must be
verified in the Verification module after being processed in the Validation module.
g Select True or False in the Hidden column. If you select True, the index field will not be
shown to the validation or verification operators. This might be useful for certain types
of processing. For example, you might want to collect values during validation, and
compare them by using a validation script. The results can then be assigned to a non-
hidden index field. Or, you might want to set values in a script that you do not want
the validation or verification operators to change.
h Select True or False in the Sticky column. If you select True, the value of this index field
for one folder will be carried over to the next folder. The validation or verification
operator can override the value in the subsequent folder if necessary.
Note If you specify “Sticky” and a default value, the default value will be used and
the “Sticky” attribute will be ignored.
i Repeat substeps a-h for each index field you want to add.
4 Click Apply to save your settings without closing the dialog box.
5 Click OK to save your settings and close the dialog box.
When you paste a copied folder class, it is given a different name, such as Name1, Name 2, or
Name3. You can then modify the folder class as needed. Refer to the Kofax Capture online Help
for more details about using this feature.
Document classes provide a convenient mechanism for associating the same group of index fields
and processing settings with multiple form types. You can define a document class, and then add
one or more form types to it. Then, you can associate a set of index fields and processing settings
with the document class. The same set of fields and settings will be shared across all the form
types defined for the document class.
For example, consider this scenario: A sales department receives order forms from five different
sources. Each order form is formatted differently, but each contains the same types of information
(customer name, customer address, item number, etc.). The forms need to be captured, and then
archived for later retrieval.
For this case, one document class named “Catalog Orders” can be defined. A different form type
for each order form can be added to the document class. Then, a set of index fields can be
associated with all form types in the document class.
When copying a document class, certain items associated with the document class are copied, and
others are linked. Refer to the Kofax Capture online Help for more details about using this feature.
Index Fields
An index field is a keyword associated with a document or folder. Index fields are generally used
as follows:
For document capture purposes, index fields provide a way to associate keywords with
documents. The keywords can be used to retrieve documents after they are exported to
permanent storage. For example, if a customer asks to review an order form, it would be
convenient to be able to retrieve the form by entering a known keyword for the form (such
as the vendor’s name, the vendor’s ID, the PO number, etc.).
For folder creation purposes, index fields provide a way to automatically create folders.
See Index Fields on page 46.
For data capture purposes, index fields provide a way to capture data from a set of forms.
The data can be stored and used for other types of processing. For example, you might
want to “lift” certain pieces of information from an image, store the data in a database, and
run statistical reports on the data.
Refer to Chapter 2 – A Quick Tour of Kofax Capture on page 27 for information about the OCR Full
Text module.
Recognition Profiles
Kofax Advanced OCR Full Text is the built-in recognition profile for OCR Full text. This
recognition profile performs OCR on entire documents to produce editable files in a specified
format (such as Microsoft Word or ASCII text).
The Kofax PDF Generator module performs Optical Character Recognition (OCR) on an entire
document, and stores the results in a specified PDF format that will be available for export by an
export connector designed to work with PDF files.
Refer to Chapter 2 – A Quick Tour of Kofax Capture on page 27 for information about the Kofax PDF
Generator module.
Recognition Profiles
Built-in recognition profiles can be selected and used during PDF generation. Some profiles use
PDF Archive (PDF/A), a file format based on PDF that supports the long-term preservation of
digital documents.
Kofax PDF Image Only files contain bitmaps for both images and text. The resulting files
are significantly larger than image + text files, and cannot be searched. However, image
only files are simpler to create and do not require additional licensing from Kofax.
Kofax PDF Image + Text files contain bitmaps for images and text for data that has been
converted to character strings. The resulting files are significantly smaller than image-only
files, and can be searched as if they were text documents. These files require additional
licensing from Kofax.
Kofax PDF/A Image Only files have the same characteristics as Kofax PDF Image Only
files except the file format is PDF/A.
Kofax PDF/A Image + Text files have the same characteristic as Kofax PDF Image + Text
files except the file format is PDF/A.
Kofax PDF Compression is an optional setting that directs the Kofax Capture PDF Generator
module to create compressed PDF documents. This option can be used in combination with all
Kofax PDF output types. Compressed PDFs, in most cases, reduce file size which provides faster
transmission speeds over networks and occupy less space on storage devices.
Validation Scripts
Validation scripts provide a method for validating index fields and applying formatting to the
data presented to your validation and verification operators. The default validation checks that
the string returned by a recognition engine or entered by a validation operator can be converted
into the data type selected for that index field. The default formatting ensures that dates, times,
and numeric values are presented correctly.
If your processing requirements dictate that you perform additional validation of the data or
apply any special formatting, you can do it with a custom validation script.
Database Validation
The Kofax Capture database validation feature allows you to enable database lookup for index
fields, without having to write custom validation scripts. You can enable this feature for a
document class, and then specify the desired database, the index fields to validate against the
database, and other settings. Then, during processing, the specified index fields will be filled with
values from the database. The database validation feature is compatible with Microsoft
Access (version 2002, 2000, or 97) or any ODBC level 3 data source.
Using database validation can speed up the data capture process dramatically, since the amount
of time devoted to character recognition is reduced. Validation is also more efficient, since the data
is virtually guaranteed to be accurate.
Consider a form that contains some standard information about a patient at a medical clinic. The
first part of the form contains information about the patient that changes infrequently, such as her
name, address, and unique patient number. The second part of the form contains information
filled in by the medical staff for recent tests or hospital visits.
The type of information on the first part of the form is typically stored in a database, which
removes the need to capture it again. If this is the case, you can set up the document class to
capture the patient’s unique patient number. The other static content can be left as fields that are
not set up for auto-recognition.
As the form is processed through Kofax Capture, the patient number will be captured and used as
a key to look up the other information in the existing database. If a match is found, Kofax Capture
will pluck the information from the database and use it to fill in the index fields for the patient’s
name and address information.
Note The database validation feature greatly simplifies the most frequently needed lookup and
validation tasks that are typically incorporated into validation scripts. You may still need to rely
on custom validation scripts for highly specialized tasks.
In other words, this feature allows the Kofax Capture database validation mechanism to be used
from a remote KCN Server site that does not have direct access to the target database. When this
option is selected, database validations on remote sites send all database validation requests to the
KCN Server. The KCN Service that handles the request then connects to the database.
Export Connectors
Typically, the final step in the Kofax Capture workflow is to export a batch (image files and
captured data) to long-term storage. This is handled by the Export module, which relies on export
connectors to govern the process. To export batches, you must specify and set up an export
connector for a document class that is already associated with a batch class.
Note The specified export connector only applies to the instance of the document class that is
associated with a particular batch class. It does not impact instances of the document class that are
associated with other batch classes.
Kofax Capture ships with the following standard export connectors for your use:
The Kofax Capture Text export connector exports index data to an ASCII text file, and
document images to a specified export folder.
The Kofax Capture Database export connector exports index data to a target Microsoft
Access (version 2002, 2000, or 97) database or any ODBC level 3 data source, and
document images to a specified export folder.
The Kofax Capture Email export connector exports documents via email messages.
The Kofax Capture Fax export connector exports documents via faxes.
If your processing requirements dictate the need for customized export settings, you can write
your own custom export connectors.
In addition, Kofax provides a wide variety of export connectors for popular applications, such as
Documentum, FileNet, Hummingbird, IBM, and others. Visit the Kofax Web site at
www.kofax.com for details.
In addition, the table in the target database that is used to store the index data must also contain a
column to hold unique document IDs (for example, DOCUMENT_ID), and which is referenced by
foreign key to the primary key in the Document Path table. When a batch is exported, a unique
identification number is stored in this column. This identification number is also stored in the
DOCUMENT_ID column in the Document Path table.
When you are establishing your database schema, it is important to use a foreign key designation
in tables that refer to the Document Path table. Doing so will help to maintain referential integrity
in your database: if you use a foreign key designation as described, a table entry cannot be deleted
unless all references to that document ID in other tables have also been deleted.
The benefit of storing the document path in a separate table is that it allows you to change the
physical location of the documents if necessary without affecting the table referencing the
DOCUMENT_ID as shown below.
Multiple Export
In most cases, a batch is exported to a single destination, such as a data management or other long-
term storage system. There may be occasions, however, when you’ll want to export your batches
to more than one destination (back-end). The multiple export feature makes this simple.
With multiple export, you can assign up to 99 export connectors to a document class. Then, during
processing, the documents of that document class are exported per the settings of each assigned
export connector. As part of your Export options, you can specify that documents be exported in
document order or by the order of the assigned export connectors. Once all documents are
successfully exported per all assigned export connectors, the batch will be deleted from Kofax
Capture.
Note You can use the same document class in a different batch, and assign it a different set of
export connectors. The multiple export feature applies to an instance of a document class
associated with a particular batch class.
Form types allow you to define where zones are located on different forms within a document
class. You can also specify custom processing settings for a particular form type.
For example, you might have two form types defined for a document class: Order Form 1 and
Order Form 2. Both forms contain the same types of information, although the information
appears in different locations on the forms. In addition, Order Form 1 contains some shaded areas
that might make OCR processing difficult. Order Form 2 contains data encoded in a bar code.
You can define separate form types for each of these forms, and then tailor your processing
settings as desired for each form type. For example, you might want to remove the shaded areas
from Form Type 1 before you perform OCR processing to capture index data. You might want to
use bar code recognition to read data from the bar code on Order Form 2.
The settings you specify at the form type level include permanent image cleanup, page
registration, automatic index field recognition, and page-level bar codes. You also provide sample
pages at the form type level for drawing zones and page recognition. The options and settings
available for form types are described in the following sections.
When copying a form type, certain items associated with the form type are copied, and others are
linked. Refer to the Kofax Capture online Help for more details about using this feature.
Image cleanup performed at the form type level is permanent. The images will be saved in their
cleaned up state. Note that this is different from temporary image cleanup that can be performed
on individual zones. Refer to Temporary Image Cleanup for Zones on page 68 for more information.
You specify your image cleanup settings with an image cleanup profile, which consists of all your
desired cleanup settings.
Image cleanup applied at the form-type level is permanent, while image cleanup applied at the
zone level is temporary. Refer to Temporary Image Cleanup for Zones on page 68 for more
information about image cleanup applied to zones.
Note Some image cleanup, for example Black Border Cropping/Removal and Deskew, is not
appropriate at the zone level and is intended to be used at the form level only. Also, Deshade and
Destreak may be too intense for a small zone. Its best to try different options to find the optimal
image cleanup for each image.
Black border cropping: This process removes black border pixels from an image. Black
border cropping cleans up the image and reduces the height and width by the size of the
black border.
Black border removal: This process replaces black border pixels with white pixels on an
image. Black border removal cleans up the image without changing its height and width.
Deshade: This process removes unwanted shaded areas from an image. The deshade
process removes the speckles that make up the shaded area, while preserving the text
inside the shaded area.
Deskew: This process corrects documents that become misaligned during the scanning
process, usually due to the mechanical feeding action of the scanner. The deskew feature
can calculate and correct skew angles up to 12 degrees.
Despeckle: This process removes unwanted dots or speckles from an image. Speckles are
groups of black pixels surrounded by white pixels (or white pixels surrounded by black
pixels).
Horizontal / Vertical line removal: This process removes horizontal and/or vertical lines.
It can also repair text that intersects the lines that are removed.
Streak removal: This process removes streaks from an image. It processes each horizontal
scan line of the image to detect runs of black pixels. Any series of black pixels less than or
equal to the specified streak width will be removed. Even though streak removal processes
the image from left to right, its main purpose is to eliminate vertical streaks.
Edge enhancement: This process enhances line edges, smooths characters, and removes
background noise on an image. Kofax Capture supports a range of edge enhancement
filters.
Kofax Capture supports a set of predefined image cleanup profiles, which combine default
settings for the most common processing tasks. It also allows you to define and name your own
custom profiles.
Page Registration
To enhance the processing of index zones, Kofax Capture supports a page registration feature. By
default, all pages with index zones are compared against their corresponding sample pages. This
process verifies that the pages match, and automatically adjusts the zones based on horizontal or
vertical shifting introduced by the scanner. (The adjustment process is called registration.)
Note Page-level registration works extremely well in most cases. However, if your images are
different from the sample pages, you may get better results by using one or more registration
zones. Refer to Registration Zones on page 60 for more information.
When you define your form types, you can specify the threshold at which zones are marked
confident or non-confident. If the results of processing a zone are greater than or equal to the
specified threshold, the zone will be marked as a confident zone.
By default, confident zones are displayed at validation and verification time with green borders,
while non-confident zones are displayed with red borders. (If desired, your validation and
verification operators can specify a different color scheme from the Validation and Verification
modules.) While all fields should be carefully validated, your validation and verification
operators should give special attention to zones marked as non-confident.
During processing, the bar codes are read from left to right, starting at the top left corner of the
document page. The first bar code found will be used to fill the first index field, the second bar
code will be used to fill the second index field, and so on. You specify which index fields to be
filled by data read from page-level bar codes with the Page Level Bar Code Properties dialog box.
To display this dialog box, right-click “Page Level Bar Codes” under a sample page item listed on
the Definitions panel, and click Properties.
Kofax Capture can recognize individual bar codes found in predefined zones on a document. This
type of zone-level processing is well suited for bar codes that always appear in the same location
on each document.
Alternatively, Kofax Capture can recognize bar codes that may appear anywhere on a document
page. This type of page-level processing is well suited for reading bar codes that appear on a page,
but not always in the same location. Refer to Page-Level Bar Codes on page 56 for more information.
During a bar code recognition operation, the document image or zone being processed is searched
for possible bar codes. If a potential bar code is found, it is examined to determine if it satisfies the
requirements for the operation. For example, the physical characteristics of the candidate bar code
(such as bar code type) are checked against the recognition settings you specified in a recognition
profile. If the candidate bar code meets all the requirements, it is decoded and its data is returned
for use in further processing.
For example, data returned from a bar code may be used to:
Fill one or more index fields
Separate documents and/or batches
Identify forms
Key into a database record, allowing index fields to be filled with values from the record
1 When processing color images with the Standard Bar Code Engine, document separation based on bar codes is
performed in the Recognition Server module. Refer to Document Separation with Bar Codes on Color Images on
page 58 for more details.
2 Under certain conditions, page-level bar codes that are used with zone-level bar codes will be processed in Scan,
rather than Recognition Server. Refer to Page Level Bar Code Processing on page 59 for more details.
Note that if the Enhanced Bar Code Engine is enabled for a recognition profile, but the required
licensing is not in place, the Standard Bar Code Engine will automatically be used. Processing for
which a 2-D bar code type is specified will produce empty results. No warnings or messages will
display.
An exception to this is when you test zones on sample pages from the Administration module. If
the Enhanced Bar Code Engine is enabled, but the required licensing is not in place, empty results
will be returned. However, a warning will display in the Results area of the Zone Test dialog box.
However, when processing color images with the Standard Bar Code Engine, document
separation based on bar codes is performed with the Recognition Server module. For this case, a
bitonal version of the color image is generated, and the bar codes are read from the bitonal image.
Note If you attempt to use the Standard Bar Code Engine for document separation based on a 2-D
bar code, the first page will not be recognized as a separator.
Refer to Color Support on page 79 for more information about how Kofax Capture handles color
images.
Sample Pages
For some types of processing, you must provide sample pages for your form types. For example,
you need sample pages when you are:
Defining any type of zone. To define zones, you must draw them on the sample pages.
Setting up page recognition. Kofax Capture can “learn” the sample pages, and then
recognize forms of those types during processing.
Setting up page-level bar codes. You can enable this type of processing to read all bar
codes on a page.
A sample page should be a form or document of the type defined by the form type. For example, if
your batches will contain a specific order form, you should scan or import one of those order
forms for your sample page.
About Zones
This section gives you some general information about the different types of zones in Kofax
Capture.
Index Zones
Index zones contain data for index fields. You can allow Kofax Capture to automatically capture
the data using an automatic recognition technique such as OCR, bar code recognition, shape, or
others. Alternatively, you can have your validation operators read information from the image
and manually enter the data for the field. You can define up to 1024 index zones on a page.
Kofax Capture supports tabular data structures (two-dimensional data) in the form of table fields.
In simple terms, table fields are “enhanced” index fields capable of supporting multiple values.
Table fields can be used as the associated field for an index zone, index group zones, or for page-
level bar codes.
Table fields may be useful, for instance, if you want a single field to be able to store multiple
names, part numbers, or other similar items.
Use Copy to duplicate an existing index zone. When copying and pasting an index zone, a new
index field is also created. The copy feature is useful for adding an index zone that is similar to an
existing one to a sample page. You can modify the copy of the index zone as necessary to make it
unique.
Refer to the Kofax Capture online Help for more details about using this feature.
Registration Zones
Registration zones contain data to be read for registration purposes. During processing, Kofax
Capture locates the specified data, and then ensures that other zones on the page are correctly
aligned.
If you create only one registration zone on a page, it should be positioned near the index zones.
The search text or shape for a single registration zone should be clear and distinct so that the zone
will yield good registration results. If desired, you can define multiple registration zones per page.
To achieve optimal results, follow the guidelines listed in Table 3-5.
Note While results may improve with multiple registration zones on a page, be aware that an
increased number of zones may adversely affect the time it takes to process your batch.
Separator Zones
Separator zones contain data to be used to separate documents in a batch. The data must be in the
same location on the first page of every document. For example, the first page of your forms might
contain a particular bar code. Whenever that bar code is read, that page will be considered the first
page of a document. You can define only one separator zone per batch class.
You can specify more than one form identification zone for a form type. For multipage form types,
the zones must be on the first page.
An index group zone allows you to combine data from separate zones into a single field. For
example, you can combine a First Name zone and a Last Name zone into a Full Name field. You
can also control how many fields can be filled in for the index group zone, and define how
conflicts are handled when more than one field is inappropriately filled in.
Consider a specific case where a form is designed to allow users to select one method of payment
from several options, such as check, cash, or credit card. All of the options form a logical
relationship, but only one should be filled in.
For this form, you can define an OMR index zone for each payment option and combine them in a
group box to form a single, logical group as shown in Figure 3-4.
The following sections contain information about the various types of recognition profiles and
zones supported by Kofax Capture.
Table 3-6 shows the functions of the Kofax Capture zonal recognition engines, and the built-in
recognition profiles in which the engines are used.
Bar Code Recognizes a variety of industry-standard bar Kofax 128 bar code
code types and translates them into values. Kofax 3 of 9 bar code
Bar code recognition is a reliable method for
capturing data field information, separating
documents in a batch, or identifying forms.
Patch Code Recognizes patch codes. Once the patch code Kofax Patch Code
is recognized, it can be used to separate
documents.
Drawing Zones
Zones are created by first selecting a zone type and then drawing an area on the sample page to
represent the zone.
The following table lists the types of zones supported by Kofax Capture.
Index group zone Many forms contain related fields of information. For
(SmartGroups) example, you might have zones for first and last
name on the same form. Index group zones allow
you to combine data from separate zones into a
single field. You can control how many fields can be
filled in for the index group zone, and define how
conflicts are handled when more than one field is
inappropriately filled in.
You create zones on the sample pages you scan for your form types. To display a sample page, do
one of the following:
From the Document class tree view tab, double-click on the document class with which the
form is associated. Select the desired form type, and select the sample page. The sample
page will display.
From the Batch class tree view tab, double-click on the document class with which the
form type is associated. Select the desired form type, and select the sample page. The
sample page will display.
The following steps outline a general procedure for creating zones. See the online Help for
specifics on each type of zone.
X To create a zone
1 With the desired sample page displayed, click the appropriate button for the type of zone
you want. Your cursor will change to a crosshair.
2 With your cursor, draw a rectangle around the area on your sample page that you want to
use as the zone. A dialog box will display.
3 Set options as appropriate for your zone.
4 If desired, click Test to apply your settings to this zone and check the results. Refer to
Testing Zones with QuickZones on page 72 for more information about testing your zones.
Note The Test button is disabled if the sample page is displayed from the Document class
tree view tab. The sample page must be displayed from the Batch class tree view tab if you
want to test your settings.
5 Select OK. The dialog box will close, and the style of the rectangle you drew will change to
reflect the type of zone you have created.
Tip Once your zone is drawn on the sample page, you can use your mouse to resize the zone.
When drawing zones on your sample page, use the following guidelines:
If all of the index data is separated from other information on your sample page by at least
.25,” draw your index zones to include a moderate amount of white space (about .25”) all
around the index data. The white space around the data allows for horizontal or vertical
offsets that might be introduced by a scanner.
If at least some of the index data is close together (that is, not separated from other
information on your sample page by at least .25”), draw your index zones with only a
small amount of white space. This will prevent unwanted data from appearing in a zone,
which could reduce the accuracy of character recognition. However, because a small
amount of white space does not allow for horizontal or vertical offsets that might be
introduced by a scanner, an OCR registration zone may be required.
For example, if you are searching for a cross shape, center the zone only on the cross
portion of the graphic. See the online Help for information about shape return codes.
Double Zoning
You can draw multiple zones for the same field. The zones can be in different locations, or even
one on top of the other. Then, you can capture the data from each zone with a different set of
recognition settings. For example, you can use OCR with aggressive image cleanup for one zone
and OCR no image cleanup for another zone. The zone data captured with the highest confidence
level will be returned for the field. Your validation and verification operators will see the zone that
returned the highest confidence.
You specify your image cleanup settings with an image cleanup profile, which consists of all your
desired cleanup settings. Refer to Image Cleanup Profiles on page 55 for more information about
cleanup settings.
The SmartGroups feature will attempt to identify the correct Associated field based on the size
and position of the group box. In the above example, there are five index fields in the group box.
SmartGroups will automatically suggest the alphabetically first Associated field from among
these five. You can always override this suggestion by selecting a different field.
To include the five items in a group, you must use the same Associated field for all five of the
index zones.
Tip Forms are typically designed with like items physically clustered together. This provides a
natural and convenient way for users to fill out the form. However, groupings within Kofax
Capture are based on an Associated field, not the location, size, or contents of the actual group
box. The elements that comprise a group can be anywhere on the form.
Consequently, a group box does not need to be physically drawn around the group’s index zones,
but it should. The ability of SmartGroups to suggest the appropriate Associated field depends on
the size and location of the group box. Furthermore, by default, the image viewer in the Validation
and Verification modules zooms to show the entire group based on the size and location of the
group box. If there are index zones in the group but outside the group box, they may not appear in
the zoomed view. (Note that you can elect to have the viewer zoom to the zone with the highest
confidence instead of the entire group.)
After you have created the group, you can see the group structure in the Batch class tree or the
Document class tree. You will see the index group zone icon followed by the name of the group
(taken from the associated field). Indented under the group name are all the index zones in the
group. Note that, contrary to ungrouped index zones, each index zone in a group is identified by
the name of the recognition profile it uses (not the name of the associated field).
Tip You can use the same recognition profile for more than one member of the group. In that case,
those index zones will appear in the tree with the same name. This may make it difficult to
visually associate a zone in the tree view with its location on the sample page. You can easily
resolve this by selecting the zone in the tree, and looking on the sample page for the
corresponding zone.
Use Copy to duplicate an existing index group zone. The copy feature is useful for adding a index
group zone that is similar to an existing one to a sample page. All member index zones are also
copied. You can modify the copy of the index group zone as necessary to make it unique.
Note Copy and paste is not available for member index zones.
Refer to the Kofax Capture online Help for more details about using this feature.
You can also specify how many values can be legally returned from a group. A group can have
from 0 to 254 values. Normally, you would choose to have the results concatenated when more
than one selection is allowed.
Note If you are grouping OMR index zones, the “Return value for unmarked zone” option must
be blank for all the OMR index zones in the group. If this is not the case, the group will not work
as expected. You can clear the “Return value for unmarked zone” option with the Recognition
Profiles dialog box for OMR zones.
When you draw a zone around an area for OMR processing, you should include only the OMR
shape with little white space outside of the shape within the zone. This allows for a wider range of
mark size to yield correct results.
For example, if you draw a large zone box around an OMR item, the percentage of filled pixels
will be relatively small. Consequently, small check marks within the OMR shape may not
significantly change the percentage of filled pixels for the entire zone. If this small change does not
put the percentage of filled pixels over the threshold, the OMR engine will not detect the zone as
marked. Therefore, the smaller the zone box around the OMR item, the easier it is to detect a mark.
Figure 3-10 shows how the size of the zone box can affect the accuracy of OMR results.
The zone around the check box on the left contains 29,241 pixels, of which 7961 (about 27 percent)
are filled in. The larger zone around the check box on the right contains 65,040 pixels of which
10,329 (about 16 percent) are filled in. Because the zone on the right does not equal or exceed the
threshold (20 percent), it will be regarded as unmarked by the OMR engine. This is clearly not the
desired result.
You could reduce the threshold value to 10 percent, but then you run a greater risk of having the
pixels that form the check box trigger a false “marked” result. Furthermore, all scans have some
amount of noise (random filled pixels) in the image. If your threshold is set very low, there is also
a chance that this noise could contribute to a false reading.
On the other hand, don’t make the zone box too small. There are always slight differences in
registration (paper position) as documents are fed through a scanner. If your zone box is very
close in size to the OMR item, then the paper may shift so that part (or all) of the item is no longer
in the zone, leading to detection errors. Therefore, the smaller the zone box around the OMR item,
the greater the chance of registration problems. So, if registration errors turn out to be a problem,
gradually increase the size of the box until the errors are minimized.
Finally, make sure that zone boxes around similar OMR items are all about the same size. This will
ensure consistent results. When setting up your zones, you should check your settings with some
image files representative of the images you’ll be processing.
Each of the above settings is presented in the following figure. In each case, the threshold is shown
at 50%, although it can be set anywhere along the pixel percentage axis.
The QuickZones feature allows you to test your recognition and cleanup settings as you define
your zones, without having to publish batch classes and process batches. You can quickly see the
results of your settings while you are setting up or editing your batch classes. If adjustments are
needed, you can easily tweak the settings and test the zones again from within the Administration
module. This can greatly reduce the time and effort required to set up or edit your zones, and
enhance the accuracy of your scanned data and validation processing.
To test a zone, simply click the Test button available from any of the Create Zone and Zone
Properties dialog boxes. The Zone Test dialog box will display, allowing you to visually compare
the original contents of the zone with the processed results. This dialog box also allows you to test
your settings for the current zone on other document examples that you may already have
scanned.
Note QuickZones applies your recognition profile and image cleanup settings to the currently
selected zone. If you test a different zone, you may get different results even though the settings
are the same. For greatest overall accuracy, you should test your settings on all the zones that will
use them, and with a variety of example pages.
A batch class contains one or more document classes, which in turn contain one or more form
types. This allows you to have different kinds of documents and forms within one batch. Kofax
Capture can automatically separate the pages into documents and identify different types of
forms.
Kofax Capture allows you to define a pool of batch classes. Then, your operators can select from
this pool when creating batches.
Note All batches in Kofax Capture are defined by their batch class. Therefore, you must define a
batch class before you can scan or import documents.
Processing Queues
As part of your batch class definition, you must specify the processing modules (queues) through
which you want your batches to be processed, and the order that processing should occur. Each
queue that you specify will become a processing step in the Kofax Capture workflow for your
batches.
In addition to selecting the queues, you also choose settings that affect processing at some of the
modules. For example, you can enable batch editing for your validation operators, select specific
times to export batches from the Export module, and more.
Table 3-8 lists the standard Kofax Capture processing queues. Refer to Chapter 2 – A Quick Tour of
Kofax Capture on page 27 for information about these queues.
Queue Description
Quality Control Provides a way to check the integrity of your batches, and rescan pages
and documents if necessary
OCR Full Text Performs OCR on entire documents to produce editable files in a
specified format (such as Microsoft Word or ASCII text)
Kofax PDF Processes an entire document and stores the results in the specified PDF
Generator format (PDF Image Only or PDF Image + Text).
Export Exports document image files and data fields to permanent storage
Batch Fields
A batch field allows you to associate certain descriptive information with each batch. For example,
you might want to know the user ID of the operator who scanned the batch, the date and time the
batch was scanned, etc. Batch fields can be exported to your target database just like index fields.
Refer to Kofax Capture Values on page 87 for more information about the type of information you
can use with batch fields.
You can create batch name formats using a range of Kofax Capture values. You can customize
each format to include static text, a single Kofax Capture value, multiple Kofax Capture values, or
any combination of available values. The default value is {Current Date} {Current Time}. Based on
this value, the batch name would be similar to the following example: 03/20/07 5:15:12 PM. A
batch name can contain up to 128 characters.
For detailed information about automatic batch naming, refer to the online Help. For more
information about Kofax Capture Values, refer to Kofax Capture Values on page 87.
Figure 3-12. Overview of the Document Separation and Form Identification Process
Batches are made up of stacks of paper documents. The documents in a batch can be single page
documents, multipage documents, or a combination of both. In addition, the documents in a batch
can be of the same or different form type.
Kofax Capture can automatically separate documents and identify the forms in a batch. You
specify the settings for this type of processing in a document separation and form identification
profile, which you associate with a batch class. You can define your own profiles, or use the
predefined profiles provided with Kofax Capture.
Document Separation
There are six Kofax-defined document separation methods. Document separation is the process of
dividing all the images in the batch into individual documents. See Table 3-9 for a summary of
these methods and when they should be used.
Kofax manual separation lets Use this method when forms cannot be automatically
the user separate documents separated using other methods.
by hand.
Kofax fixed page separation Use this method when all documents in a batch contain a
automatically creates a new fixed number of pages.
document every set number
of pages.
Kofax patch code separation Use this method when the first page of all documents
uses a patch code separator contains a patch code, or you plan to use document separator
sheet to separate documents. sheets with patch codes printed on them.
Kofax bar code separation Use this method only when the first page of all documents
uses a bar code separator contains a bar code, or you plan to use document separator
sheet to separate documents. sheets with bar codes printed on them. If any page of the
document other than the first contains one or more bar codes,
do not use this method.
Kofax separator sheet Use this method only when the first page of each document is
separation uses a Kofax a separator sheet created and printed by the Separator Sheet
separator sheet to separate Utility.
documents.
Kofax page recognition Use this method if the physical characteristics of the first page
separation analyzes each of every form differ sufficiently enough for Kofax Capture to
image and separates when it distinguish between form types or your form type has a
finds the first page of a form separator zone or form identification zone.
type.
Separator zone separation Use this method only if you have a separator zone on the first
analyzes a specific zone on page of every document. The identifying information on each
each image and separates document type must be identical and will only be used to
when the zone matches the separate the documents.
same zone on the first page of
a form type.
Form identification zone Use this method only if you are using form identification
separation analyzes a specific zones to identify the form type. The identifying information
zone(s) on each image and on each document type must be unique and will be used to
separates when the zone(s) identify the form type.
matches the first page of a
form type.
Form Identification
Table 3-11 shows the three methods of form identification. Form identification is the process of
matching each separated document with a form type in the batch class.
Manual identification Use this method for forms that cannot be automatically
requires you to manually identified using other methods.
identify forms within your
batch. Typically, this would
be done by a scan or quality
control operator.
Kofax separator sheets can be Use this method only if the first page of each document is a
printed with a bar code that separator sheet created and printed by the Separator Sheet
identifies the next document's Utility.
form type.
Page recognition compares Use this method only if the physical characteristics of the first
each entire image with the page of every form differ sufficiently enough for Kofax
first page of each form type Capture to distinguish between form types.
looking for an overall match.
Every time a match is found,
document separation occurs
and the new document is
identified with the matching
form type.
Form identification zones This method is used when you are using form identification
compare specific zones on zones to separate documents. You can also use this method to
each scanned image with the enhance page recognition’s effectiveness.
same zones on the sample
pages of the batch class.
Every time a match is found,
document separation occurs
and the new document is
identified with the matching
form type.
Single form type This method is used when the batch class has only one form
identification only works type. Each document is automatically identified with that
when the batch class has one form type at separation.
form type. Since there is only
one form type, each
document is identified with
that form type by default.
Kofax Y Y
Manual
Kofax Fixed Y Y Y
Pages
Kofax Patch Y Y Y
Code
Kofax Page Y Y
Recognition
Separator Y Y Y
Zone
Form ID Y Y Y Y
Zone
Note Single document batch processing is only available when the Scan module automatically
performs document separation. Otherwise, an error will occur when you publish the batch class,
and you will have to either change the separation method or disable single document batch
processing.
When the batch reaches the Export module, the error-free documents and pages are exported, and
the exception documents are routed back to Quality Control for repair. Once repaired, the
documents are routed through the batch class workflow, starting with the first module after Scan.
This approach is helpful if you do not want to delay batch processing for error-free documents
that exist in the same batch with exception items.
To use this feature, you must enable it when you define your batch classes from the
Administration module.
The publishing process checks the validity of the settings for your batch class. If settings are
missing, or conflicts exist, warnings and errors are generated and displayed. The warnings and
errors typically include recommendations to help you troubleshoot the batch class. If no errors are
detected during the publishing process, your batch class is published and available for use.
If desired, you can validate a batch class before you publish it. The validation process performs
the same checks as the publishing process, without making the batch class available for
processing. Validation is useful for setting up and troubleshooting a batch class that you are not
ready to use. Once a batch class is published, its name appears with a check mark icon on the
Definitions panel.
Color Support
Color images intrinsically offer less contrast and contain more information than bitonal images.
Color file sizes can be much larger than otherwise identical black and white images, in most cases
24 to 32 times larger. Consequently, it takes proportionally more time to process color images.
Everything from a simple deskew filter to complex edge detection could require more time and
put an extra burden on your workstations and networks. This is just the nature of color; it takes
more time to process it.
Fortunately, Kofax Capture has a way to overcome many of the drawbacks of working with color
image files. It intelligently manages this extra burden by converting the color image to a bitonal
image the first time it is needed. Once created, the bitonal image is saved and reused as the batch
travels from module to module.
Note Depending on factors such as image size, workstation capabilities, etc., it may take several
seconds to convert a color image to bitonal. For this reason, the bitonal image is only created once.
To maximize performance, color processing is not automatically done at scan time.
Since Kofax Capture offers considerable flexibility in how you process your batches, each module
(that needs to) will create and save a bitonal image if one doesn’t already exist. The only exception
to this is in the Administration module when using the QuickZones feature. QuickZones creates
bitonal images of the sample pages for zone testing purposes, but does not save them (since
samples are not a part of the batch).
Note If you attempt to open this kind of TIFF file in a third party application, you may encounter
difficulties. JPEG compressed TIFF is a little used feature, and some applications may not
recognize the file structure.
schemes attempt to discard information that is not critical or very visible to the eye, but as
the rate of compression is increased, the missing information becomes visible.
Lossless compression schemes retain all information. When the file is decompressed, it
looks exactly like the original. A lossless compression scheme cannot compress a file as
much as a lossy scheme.
JPEG is a lossy method of compressing files, and so quality may become an issue.
The JPEG standard permits variable compression rates that allow you to trade file size (amount of
compression) against image quality. The more highly compressed an image, the worse the image
quality becomes.
This trade-off is made in the quality setting when you save a document with JPEG compression. A
quality setting of 100 percent (the maximum) will yield the best image, but with minimal
compression.
Automatic data capture is very sensitive to the image quality. Good OCR results require a high
quality setting, usually 100 percent. Bar codes and patch codes can usually be recognized with
quality settings as low as 75 percent (in ideal cases this could even be lower).
As you can see, there is not much visible difference between an uncompressed file and 75 percent
quality, yet the file size has shrunk from 3.9M to about 560KB. On the other hand, even though the
0 percent quality setting has achieved a file size of about 78KB, there are many visible artifacts.
Look for blotches near the roofline and the circular attic vent.
Unlike most of the other properties you can set in Kofax Capture, JPEG image compression
quality is not set directly from within the program. Instead, you must use the Scanner
Configuration Utility, which is available from the Windows Start menu at All Programs | Kofax
Capture 9.0 | Scanner Configuration Utility.
For detailed information about all the Scanner Configuration Utility options and features, refer to
the online Help by clicking Help or pressing F1 from within the utility interface.
Tip For OCR, set the quality to 100 percent. For patch codes and bar codes, use at least 75 percent.
Any changes to this setting will take effect the next time you open the Kofax Capture modules that
use it. If one of these modules is already open, you must close it and re-open it for the new setting
to take effect.
Color sample pages are displayed in color in the Administration module and in other modules
from which you display images (such as Validation). When making use of color sample pages,
keep in mind that (depending on the colors) it may be difficult to see the zones on the page. For
example, index zones are shown on the sample page with green rectangles. If the sample page has
a green background, then these rectangles may be difficult to see.
Color sample images should be added from within the batch class tree. While it is possible to add
them from within the document class tree, doing so will prevent the sample page from being
deskewed. Since proper deskewing is important to data capture accuracy, using the batch class
tree to add color sample pages helps ensure the highest possible accuracy.
Both bitonal and color sample pages are normally deskewed. However, this step is skipped if
“Deskew Sample Images” is not checked in the Administration module Scan menu.
Note Batch classes with color sample pages may take somewhat longer to publish than if all the
sample pages are bitonal.
If necessary, you can set the color image cleanup profile to “none,” which turns off all color
processing except for thresholding.
The image viewer allows you to rotate your view of the page. When you rotate a color image,
Kofax Capture internally rotates the corresponding bitonal image. Consequently, the rotation
process will take somewhat longer. Not only is there more pixel information to rotate in the color
image, but an entirely separate (and usually hidden) bitonal image must be rotated as well.
The same applies to bitonal images in the image viewer. If you rotate a bitonal image, Kofax
Capture internally rotates any corresponding color image.
eDocument Support
Kofax Capture can import, process, and export almost any type of file. You do not need to limit
your batches to image files. Image files are defined as those having the following extensions:
TIF
PDF (PDF files can also be imported and converted to TIFF file for use as sample pages.)
PCX
BMP
JPG
CAL
All other types of files are classified as eDocuments (non-image files), regardless of content. The
support of eDocuments is controlled at the batch class level, and each batch can be set
independently of other batches.
The main advantage of eDocuments is that you can create a batch based on your archiving or
processing needs. All the documents you need in a batch can now be processed together
regardless of file type.
Viewing eDocuments
Each module with an image viewer will attempt to display any eDocuments in a batch. The Scan,
Quality Control, Validation, and Verification modules all have image viewers, and you can view
eDocuments as a normal part of your batch processing. You will see the eDocument as if it was
opened in Internet Explorer.
Each module in Kofax Capture with an image viewer gives you the option of suppressing the
display of eDocuments:. When viewing is suppressed, the eDocuments will appear as blank pages
in the viewer. Suppressing the display, when possible, will speed up your processing time.
The Kofax Capture image viewers make use of some features in Internet Explorer 5.0 and higher
(IE). Consequently, Kofax Capture can display any type of file that IE can display, but with the
same capabilities and limitations as the browser. For example, IE does not support rotate or zoom.
Therefore, the rotate and zoom toolbars, keyboard shortcuts, and menu items available in Kofax
Capture are disabled when an eDocument is displayed.
Note If the eDocument can be displayed in the image viewer window, you do not need the native
application used to create the non-image file installed on your workstation. However, depending
on the type of document, you may need one or more plug-ins for Internet Explorer. These plug-ins
are available from a number of sources, most frequently the manufacturer of the application that
was used to create the eDocument.
The contents of an eDocument cannot be predicted or controlled from within Kofax Capture.
Microsoft Word documents, for example, may contain links to other files, OLE objects, or Web
sites. Some of these links may still function in the image viewer.
Some eDocuments may have macro capabilities that could potentially cause problems when
opened. For example, a macro might be looking for a file that does not exist on the current
workstation.
Except as noted below, document separation for eDocuments is the same as described in Document
Separation and Form Identification Profiles on page 75.
Kofax Capture Import Controller Separation This feature uses scripts to manage the input
of both eDocuments and image files.
Fixed Page Separation You can use the fixed page method to separate eDocuments, but
keep in mind that all eDocuments are treated as single page documents regardless of the
actual page count.
Patch Code and Bar Code Separation Patch codes and bar codes cannot be used to
separate eDocuments. In this case, eDocuments are passed through as if they were blank
pages. Image files are separated correctly.
Page Recognition Separation Page recognition cannot be used to separate eDocuments. In
this case, eDocuments are passed through as if they were blank pages. Image files are
separated correctly.
Note Form identification cannot be used on eDocuments, although any image files in the same
batch will be identified. In this case, eDocuments are passed through as if they were blank pages.
The Export Connector Manager dialog has a Properties button that displays a dialog box that
indicates support for eDocuments. If you attempt to use eDocuments with an export connector
that does not support them, you will receive a warning message when you publish the batch class.
The Custom Module Properties dialog box indicates support for eDocuments on the General tab.
If you attempt to use eDocuments with a custom module that does not support them, you will
receive a warning message when you publish the batch class.
This section provides instructions on how to choose these options, and also describes how to
import PDF files for use as sample pages for your form types.
Note Make sure the “Treat imported PDF files as TIFF images” box is not selected.
Once imported into Kofax Capture, the PDF files are treated like any other eDocument. Refer to
eDocument Support on page 83.
Effect on Licensing
A PDF file is counted as a single page—regardless of the actual number of pages. The number of
available pages of your Kofax Capture license volume is decremented by one for each PDF file
imported as an eDocument.
To have every imported PDF file for a particular batch class be converted to a TIFF image file, you
must check the “Treat imported PDF files as TIFF images” check box on the Advanced tab of the
Create Batch Class or Batch Class Properties dialog box.
Effect on Licensing
Each page in the PDF file will be converted to a page within the multipage TIFF file. The number
of available pages in your Kofax Capture license volume is decremented by one for each page in
the TIFF file.
Note All sample page images used in a single form type must be of the same dpi. The dpi is
calculated based on the scale of the imported PDF file, and you will receive an error message if the
dpi is not the same. If you need to import PDF files of different dpi values, you can create multiple
form types.
Note The text in an image-only PDF file is not searchable or selectable in Acrobat Reader.
Validation scripts and recognition scripts are written with either Visual Basic .NET (VB .NET) or
the Softbridge Basic Language (SBL). SBL is incorporated into the Administration module. Export
connectors are typically written in Visual Basic, but can also be written with any tool that supports
the development of COM servers.
You can also create applications such as custom modules and workflow agents.
Custom modules are used to perform tasks such as document separation, page
registration, form identification, automatic or manual indexing, verification, or full text
OCR in ways that are unique to your company.
Workflow agents are used to examine and modify batch data, as well as change the
routing (next module) and status for the batch.
For example, the Kofax Capture Value “{Batch Name}” produces the name of the current batch. If
your processing requirements dictate that the names of your batches be exported with your
batches, you might use {Batch Name} as the default value for a batch field that you export with
each batch.
Kofax Capture Values are “expanded” during processing and returned when the appropriate
information becomes available. For example, the name of a batch is available when the batch is
scanned because that is when the information is specified.
A partial list of Kofax Capture Values is shown below. Refer to your Kofax Capture online Help
for a complete list of the values.
{Batch Creation Date} The date the current batch was created.
{Batch Creation Time} The time the current batch was created.
{Batch Creator’s Station ID} Kofax Capture Station ID of the computer where
the batch was created.
{First Page Endorsing String} The endorsing string (prefix plus counter). Not
used by Kodak scanners, except for models
DS 1500, 2500, and 3520.
Scanner Profiles
A convenient way to preserve and reuse a set of scanner or import settings is to save them to a
scanner profile. Then, whenever you want to use the settings, you can just load the desired profile.
Scanner profiles are used with any module from which you can create batches or scan/import
documents. For example, you can save, load,and delete a scanner profile from the Scan and
Quality Control modules when you create batches or add pages to batches. You can also save,
load,and delete scanner profiles from the Administration module, and use them to scan or import
sample pages.
If you save your settings to a profile with the same name as a batch class, that profile will
automatically be loaded whenever you create batches based on that batch class.
X To share scanner profiles, select Scan | Scanner Profiles | Save Profiles as Shared.
Note If User Profiles is enabled, make sure that you have selected the “Allow admin utility
usage” setting. Only users with rights to access Administrative Utilities can save local profiles as
shared or revert to shared profiles.
When you select a scan source, a Kofax Capture module normally uses a shared profile. A scan
source only uses local profiles if any of the following are true:
Shared profiles do not exist for the selected scan source.
The local set of profiles was inherited from the set of shared profiles, but the set has been
modified locally. A set of profiles, for a given scan source, is considered modified if you
have:
Modified and saved or deleted one or more scanner profiles.
If you have modified a local scanner profile and you want to undo the modifications, you can
revert the local profile to the shared profile’s settings.
X To remove local changes, from any Scan menu, select “Revert to Shared Profiles.”
Note On a standalone installation, shared profiles are not enabled and the shared profiles folder
does not exist.
The general, the preliminary steps for using this feature include:
Reserving a patch code for batch separation purposes when you define your batch classes
from the Administration module.
Creating batch separator sheets with the Separator Sheet Utility. The separator sheets will
contain the reserved patch code, which will trigger the start of a new batch during
scanning.
Providing the batch separator sheets to your scan operators, who can insert them into
stacks of documents to be scanned.
Then, from the Scan module, your scan operator can create/open a batch, select the desired
options, load the stack of documents into the scanner’s hopper, and enable “Unattended mode.”
As the stack of documents is scanned, the batch separator sheets will trigger the start of a new
batch.
Refer to the Kofax Capture online Help for more details about using this feature. Refer to Separator
Sheet Utility on page 32 for more information about the Separator Sheet Utility and Scan Module on
page 29 for more information about the Scan module.
User Management
Introduction
This chapter explains the various user management capabilities of Kofax Capture.
User management is an umbrella term for a set of features that allows you to:
Create users or groups
Use domain users or groups (Centralized User Management)
Assign users or groups to Kofax Capture modules
Assign batch classes to users or groups
Permit specified users or groups to edit batches
Require a user ID and optional password (user profiles only)
Track user activity
An administrator can manage Kofax Capture access and activity by setting up accounts or
“profiles” for each user and for groups of users. Each profile defines a Kofax Capture login ID and
specifies the modules and batch classes to which the user is allowed access. The profile also
defines the administrative functions to which the user has rights.
Additionally, the administrator can set up profiles to assign access rights to multiple users. The
implementation of user profiles is an optional feature that is enabled from the User Profiles dialog
box.
These features help you improve productivity by assigning specific batch classes and tasks to
designated users, set the overall level of access you need for your Kofax Capture system, and track
user activity.
In addition to the above capabilities, you can also take advantage of the Centralized User
Management feature. Centralized User Management allows you to:
Link Kofax Capture to domain users or groups
Automatically log in to Kofax Capture modules once you have logged in to your operating
system (Single Sign On feature)
Automatically log in to modules from a script
Automatically log in to modules when using Kofax Capture Import Connector – XML
You may elect to use SecurityBoost, which enhances the security of Kofax Capture files and
folders. Refer to the online Help for more information about SecurityBoost.
Once you set them, user and group profile settings will be retained until you change them. If you
disable the User Profiles feature, and later enable it again, all your previous settings will be
restored and enforced.
Warning If you set a password for the Admin user and later forget the password (and the Admin
user is the only user with rights to the Administration module), you won’t be able to disable User
Profiles because you won’t be able to start the Administration module. And, because there is no
way to recover or reset the password without accessing the Administration module, you will have
to uninstall, then reinstall Kofax Capture (which will reset the Admin password back to <blank>),
and you will lose your batch classes and any batches that were in progress at the time of the
uninstall.
A user profile is a collection of permission and assignment settings that are assigned to an
individual Kofax Capture user.
A group profile is a collection of permission and assignment settings that are assigned to a Kofax
Capture group. A group may consist of any number of Kofax Capture users, and users can be
members of any number of groups.
Groups can be assigned the same types of access rights as users, and all members inherit the
group’s rights. Because these rights are inherited, you can quickly change the settings for all the
members in a group simply by editing the group profile. For large groups, this simplifies the
maintenance of user rights and ensures consistency.
Note Permissions are additive: an individual user of Kofax Capture has all the permissions
granted by the user profile plus those in all the assigned group profiles.
Default Profiles
When you enable the User Profiles feature for the first time, two default profiles are already in
place: the “Admin” user profile and the “(Everyone)” group profile. You cannot remove these
profiles, but you can modify them.
The Admin profile is intended to be used by the Kofax Capture administrator, who typically is
responsible for setting up and maintaining profiles. By default, every new user profile is
automatically assigned to the “(Everyone)” group. As a result, each new user inherits the rights
that are assigned to the “(Everyone)” group, in addition to the rights assigned in the user profile.
For example, a user whose user profile does not allow access to the Scan module might still be able
to use it. This would occur if the user is a member of a group profile, such as “(Everyone),” for
which access to the Scan module is allowed.
By default, the “(Everyone)” group is allowed rights to every batch class and every Kofax Capture
module. If desired, you can use the Group Profile Properties dialog box to restrict the batch class
and module assignments for the “(Everyone)” group.
Note When you initially install Kofax Capture, the User Profiles feature is disabled.
When the User Profiles feature is disabled, users are not required to log in when they launch a
Kofax Capture module. As a result, no restrictions are placed on their access to batch classes,
modules, or Kofax Capture administrative functions.
Select the Enable User Profiles check box. Once the box is checked, Admin becomes the
active user and Everyone the active group. All the user and group options become
available, and you can follow the instructions in the rest of this chapter to create
additional user and group profiles.
3 Click Save, and one of the following will happen:
If the Admin user has a blank password, the save will take place. Click Close to close
the User Profiles dialog box.
If the Admin user has a password set, the Enable User Profiles authentication dialog
box will display. From the list of users that have access rights to the Administration
module, select a user and enter the correct password for the selected user. Click OK,
and the save will take place.
Note As soon as your entries are saved, all profile assignments associated with the other
Kofax Capture modules go into effect. Any assignments associated with the Kofax
Capture Administration module become effective when you close the module.
Note As soon as you click Save, all assignments associated with the other Kofax Capture
modules become disabled. Assignments associated with the Kofax Capture
Administration module become disabled when you close the module.
5 Click Close.
These tasks are performed with the User Profiles dialog box.
Note Selecting this option only gives editing rights to the user. To actually enable
batch editing for the Validation and/or Verification modules, you must also enable
the “Allow batch editing” option for those modules from the Queues tab in the Batch
Class Properties dialog box.
i Select “Allow Report Viewer module access” to allow the user to use the Report View
module.
3 Select the batch classes to which you want the user to have access. You can do this at a
later time if desired.
a Click the Assigned Batch Classes tab.
b From the Available list, select each batch class to which you want the user to have
access.
c Use the following buttons as appropriate:
Add: Add the selected item to the Assigned list
Add All: Add all the items to the Assigned list
Remove: Remove the selected item from the Assigned list
Remove All: Remove all the items from the Assigned list
4 Select the Kofax Capture modules to which you want the user to have access. You can do
this at a later time if desired.
a Click the Assigned Modules tab.
b From the Available list, select each module to which you want the user to have access.
c Use the following buttons as appropriate:
Add: Add the selected item to the Assigned list
Add All: Add all the items to the Assigned list
Remove: Remove the selected item from the Assigned list
Remove All: Remove all the items from the Assigned list
5 Select the groups to which you want the user to belong. You can do this at a later time if
desired.
a Click the Group Members tab.
b From the Available list, select each group that you want to add.
Note The “(Everyone)” group is not listed in the Group Members tab. By default new
users are added to the “(Everyone)” group.
6 Click Close.
Note Whenever you edit a user profile, the password fields will display a row of asterisks
to conceal the content and length of the password. The number of asterisks does not
reflect the true length of the password, and will appear even if there is no password.
These tasks are performed with the Group Profiles dialog box.
Note Selecting this option only gives editing rights to the group. To actually enable
batch editing for the Validation and/or Verification modules, you must also enable
the “Allow batch editing” option for those modules from the Queues tab in the Batch
Class Properties dialog box.
f Select “Allow Report Viewer module access” to allow the group members to use the
Report View module.
3 Select the batch classes to which you want the group to have access. You can do this at a
later time if desired.
a Click the Assigned Batch Classes tab.
b From the Available list, select each batch class to which you want the group members
to have access.
c Use the following buttons as appropriate:
Add: Add the selected item to the Assigned list
Add All: Add all the items to the Assigned list
Remove: Remove the selected item from the Assigned list
Remove All: Remove all the items from the Assigned list
4 Select the Kofax Capture modules to which you want the group to have access. You can
do this at a later time if desired.
a Click the Assigned Modules tab.
b From the Available list, select each module to which you want the group members to
have access.
c Use the following buttons as appropriate:
Add: Add the selected item to the Assigned list
Add All: Add all the items to the Assigned list
Remove: Remove the selected item from the Assigned list
Remove All: Remove all the items from the Assigned list
5 Select the members that you want to add to the group. You can do this at a later time if
desired.
a Click the Members tab.
b From the Available list, select each user that you want to add to the group.
Note The “(Everyone)” group is not listed on the Members tab. By default, new users
are added to the “(Everyone)” group.
6 Click Close.
This is “Local User Management,” and is best suited for smaller installations, or for customers
who need to isolate their Kofax Capture users and groups in a controlled environment.
You can link Kofax Capture to your domain users and groups using the Centralized User
Management feature. Once this link has been established, Kofax Capture will automatically stay
synchronized with your domain user and group accounts. This allows you to escape the tedium of
replicating and updating dozens or hundreds of users across two working environments.
In addition, by linking already existing domain users or groups to Kofax Capture, your users can
employ a single password for both Kofax Capture and the network.
Centralized User Management is best suited to large organizations with many users or groups, or
for customers who do not want to maintain multiple passwords or multiple lists of users or
groups. We suggest you link only groups. This simplifies your maintenance tasks, and makes it
easier to give large numbers of users the same profile settings.
Note Wherever a linked domain user ID is displayed in Kofax Capture, it is preceded by the
user’s domain and a backslash (\). For example, if the user ID is “JDoe” and the domain name is
“Kofax”, the user ID is displayed as “Kofax\JDoe”. Likewise, a linked domain group is displayed
with the group’s domain and a backslash.
Icon Description
The Kofax Capture default user. The only user with this icon is “Admin.”
A domain user at a location that is not currently connected to the Kofax Capture
system (colors are faded).
Icon Description
The Kofax Capture default group. The only group with this icon is “(Everyone).”
Icon Description
A domain group.
A domain group at a location that is that is not currently connected to the Kofax
Capture system (colors are faded).
Note You can still edit the Kofax Capture permissions for “not connected” users or
groups.
User Profiles
The following assignments and settings can be applied to user profiles.
Note Selecting “Allow batch editing in Validation and Verification” only gives editing
rights to the user. To actually enable batch editing for the Validation and/or Verification
modules, you must also enable the “Allow batch editing” option for those modules from
the Queues tab in the Batch Class Properties dialog box.
Tip You can view the list of users/groups that are currently assigned to a particular batch class.
To view the list, right-click on a batch class name in the Definitions panel to open the context
menu. Then select Assigned User Profiles (also available from the Edit menu).
3 From the Available list, select each batch class to which you want the user to have access.
4 Use the following buttons as appropriate:
Add: Add the selected item to the Assigned list
Add All: Add all the items to the Assigned list
Remove: Remove the selected item from the Assigned list
Remove All: Remove all the items from the Assigned list
5 Click OK.
5 Click OK.
Group Assignments
The following assignments and settings can be applied to group profiles.
Note Selecting “Allow batch editing in Validation and Verification” only gives editing
rights to the group. To actually enable batch editing for the Validation and/or Verification
modules, you must also enable the “Allow batch editing” option for those modules from
the Queues tab in the Batch Class Properties dialog box.
Tip You can view the list of users/groups that are currently assigned to a particular batch class.
To view the list, right-click on a batch class name in the Definitions panel to open the context
menu, and select Assigned User Profiles (also available from the Edit menu).
5 Click OK.
Note As soon as you click Save, all profile assignments associated with all the Kofax
Capture modules, except the Administration module, go into effect. Any assignments
associated with the Administration module become effective when you close the
Administration module.
6 Click Close.
Note You cannot open the Assigned User Profiles dialog box unless the User Profiles feature is
enabled from the User Profiles dialog box.
Note The user/group profile settings are updated with any changes you make to the
Assigned Profiles dialog box.
When you enable the User Tracking feature, Kofax Capture tracks user activity in a number of
database tables. The tables contain statistical records that are generated as a user creates and
updates Kofax Capture batches and opens/closes processing modules. The records track
information about various items such as user actions, documents, and keystrokes.
Depending on the database option you are using, tracking statistics are stored in the standard
Kofax Capture database, SQL Server, Oracle, or IBM DB2 database. Refer to the online Help for
more information about selecting different databases.
When you install Kofax Capture for the first time, the statistics tables are initially empty.
Note When the User Profiles feature is enabled, users who have rights to the Kofax Capture
Administration module can enable or disable the User Tracking feature.
Warning Do not alter the structure of these tables or their fields. If you alter the table/field
structure you risk permanently losing data, and causing errors in Kofax Capture that may be
extremely difficult to diagnose.
Note The Stats.mdb file is deprecated and may not be supported in future versions of Kofax
Capture. It is retained in this version for legacy compatibility only. If you are currently using
Microsoft Access (or something similar) for custom reports, you may continue to do so. Kofax
strongly recommends that you use the database connection method described in custom reports
for all your reporting needs. Not only does this method provide better performance, it also
enables access to several new database views that make it easier to generate custom reports.
Standard Option
If you are using the Standard option, your user tracking data is stored in several database tables.
You may access these tables using the Stats.mdb file that Kofax Capture creates during
installation. The Stats.mdb file does not actually contain any data. Instead, it contains pre-defined
links to the statistics tables stored in the Kofax Capture system database.
You can use Microsoft Access or any number of other compatible reporting applications to view
the user tracking data.
Note that, regardless of the location of Stats.mdb, you must open it from the workstation with the
Kofax Capture installation. If you attempt to open it from another workstation you will receive an
error, or if there is another Kofax Capture installation on the other workstation, Stats.mdb will
point to the data on that workstation.
If you upgraded to Kofax Capture from an earlier version, any merged statistics data from your
prior release is carried over to the new version. However, any macros or queries that you may
have had in Stats.mdb will not be brought over.
If you wish to recover such items, you can locate them in Stats.mdb in the appropriate archive
folder corresponding to their old release. For example, this is usually a subfolder in the Kofax
Capture server files folder with a name similar to Kofaxnn, where nn corresponds to the version
number of your previous installation.
Stats.mdb, when opened with Access, has a custom menu selection, “Statistics,” with a Delete
item. The Delete menu item allows you to delete accumulated statistics from the database. You
should periodically delete the statistics data. The total size of all statistics, administration, and
batch catalog information is limited to 2GB. This is a large limit, but could be exceeded over a long
period of time on a heavily used system.
You may delete statistics from the database directly from Stats.mdb, as described above, but you
may also delete them through the Reports Viewer. The Reports Viewer lets you decide which
statistics to delete. When editing Stats.mdb directly, you cannot select which statistics to delete;
instead, all statistics records will be deleted. Additionally when editing Stats.mdb, no utilities are
provided to selectively backup or copy specific statistics. If you want to do this, you must
implement such capabilities yourself.
Note Kofax suggests that you archive these records to a safe location prior to deleting them.
If you are using the SQL Server, Oracle, or IBM DB2 database option, your user tracking data is
stored in tables in your selected database.
If you elect to use Kofax Capture with any of the above mentioned databases, you should be
familiar with that database system and how to access it from your client tools. If necessary, contact
your system administrator for details.
The user tracking statistics are stored in the server and database you specified when switching to
or setting up your database (SQL Server, Oracle, or IBM DB2) for use with Kofax Capture. The
structures for these tables are identical to those used with the standard Kofax Capture database.
To delete unwanted statistics records, create your own SQL statements or execute the predefined
stored procedure called “ClearStats.”
Note When using SQL Server, Oracle, or IBM DB2, the Kofax-provided Access interface is not
supported.
Introduction
This chapter covers the following topics, which contain information about maintaining your
Kofax Capture installation and environment.
Reviewing the system and processing module log files
Using the database and license utilities
Using SecurityBoost
Log Files
Kofax Capture generates log files when certain events occur. For example, whenever you delete a
batch, information about that batch is stored in a deleted batches log file.
Log files are stored in your installation folder. As part of standard system maintenance, you
should back up or purge these log files as appropriate. The following sections describe the log files
generated by Kofax Capture.
where yy is the last two digits of the year and mm is a two-digit number representing the month in
which the information is logged.
Note All the data from the Deleted batches and History log files is now recorded in the Stats.mdb
database, so although the files are obsolete they remain for legacy reporting and backward
compatibility only. We strongly recommend that you rely only on the database for information
retrieval. (Obsolete files may not be included in future Kofax Capture versions.)
For any given month and year, the appropriate log file is created as soon as a batch is deleted or an
error occurs. Then, information about all batches deleted or errors that occur in the same year and
month is appended to the appropriate file.
System log files are stored in your installation folder. As part of standard system maintenance,
you should back up or purge these log files as appropriate.
The information logged to the deleted batches log file is shown below.
“01”,“batch name”,
“batch description”
“02”,“batch creation station ID”,
“batch creation date”,
“batch creation time”
“03”,“expected number of documents in batch”,
“expected number of pages in batch”,
“pages per document”,
“document separation”, (Described below)
“save document separators”, (Described below)
“actual documents in batch”,
“actual pages in batch”
“04”,“batch class name”,
“batch class description”
“05”,“queue start date”,
“queue start time”,
“queue end date”,
“queue end time”,
“queue process name”,
“queue termination state”, (Described below)
“station ID”,
“queue termination error code”, (Described below)
“error text”,
“keystroke count - manual index fields”,
“keystroke count - corrections to OCR index fields”,
“keystroke count - corrections to ICR index fields”,
“keystroke count - corrections to bar code fields”,
“keystroke count - corrections to OMR index fields”,
”error state”
Error states:
0 No errors
1 Contains errors
Keystroke counts include most keystrokes, with the following exceptions: Control, Shift, Alt, and
any key combination that is a shortcut for a menu or other standard Windows operation.
The “contains errors” value is used to indicate a batch that is forwarded, even though it contains
rejected documents or pages. This occurs when the Partial Batch Export feature is enabled.
An example of information stored to a deleted batches log file is shown in Figure 5-1. Due to page
size constraints, the example log entries are shown on multiple lines. Each deleted batch entry is
actually logged as a single line in the deleted batches file.
“01”,”Batch Test”,”Deleted batches log information.”
“02”,”John Devan”,”2005-02-16”,”17:20:51”
“03”,”0”,”0”,”0”,”1”,”1”,”3”,”6”
“04”,”Tax Formalistic 2003 tax forms.”
“05”,”2005-02-16”,”17:20:51”,”2005-02-16”,”17:23:04”,”Scan”,
“64”,”John Devan”,”0”,”Devan”,”0”,””,”0”,”0”,”0”,”0”,”0”,”0”
“05”,”2005-02-16”,”17:24:13”,”2005-02-16”, “17:32:12”,”Validation”,
“64”,”Bob Jones”,”0”,”Jones”,”0”,””,”0”,”0”,”0”,”0”,”0”,”1”
“05”,”2005-02-16”,”17:32:14”,”2005-02-16”,”17:33:07”,”Export”,
“64”,”Sue Brown”,”0”,”Brown”,”0”,””,”0”,”0”,”0”,”0”,”0”,”0”
Each error logged to the error log file includes the following information:
Date & time
Error code
Internal package ID
Specific status1
Specific status2
Specific status3
Module path
Module name
Station ID
Module version
Source module
Line
Error message
Return Value
Call Stack Output (Used by Technical Support to troubleshoot problems.)
An example error entry is shown in Figure 5-2. Each error is logged as a single line in the log file.
2007-06-04 10:51:26, 0x00000018, 0, 0x00000000, 0x00000001, 0x00000000, C:\Program
Files\Kofax\Capture\Bin, Administration, Greg F, 8.00.216.0,
ReleaseScriptController.cpp, 1070, Error closing export connector “Ascent Capture
Text” for batch class “Orders” and document class “Catalog Orders.”, Return Value:
1816396200, === begin CallStack output ===77F97AC6: WINNT\System32\ntdll.dll!
ZwGetContextThread + 11 bytes=== end CallStack output ===
When logging is enabled for a module, that module’s log file is created in your Kofax Capture
Images folder (or in the image folder defined in the Batch Class Properties dialog box) as follows:
BatchNumber\Log\Module.txt
where BatchNumber is the number of a batch and Module is the identifier for the module. A
separate log file will be available for each batch.
The processing log files are temporary; that is, they are automatically deleted when the batch is
exported. You can review the log files for a batch as long as the batch is available to Kofax
Capture. You can also copy the files to a different folder to review them after the batch is exported.
06/04/07
07:00:33 PM Opened batch, name “Example”, class “Order Forms”
07:00:34 PM Opened document #1, class “Order Forms”, form “Northwest Order Forms (1)”
07:00:40 PM Enhanced document
07:00:41 PM Closed batch
Database Tab
This tab allows you to select which database configuration to use with Kofax Capture. For
managing batches in the system, Kofax Capture installs and uses a central database called the
Batch Catalog database. The Standard configuration of this database uses Microsoft SQL Server
2005 Express Edition. If desired, you can switch to an SQL Server or an Oracle or IBM DB2
database to actively administer the database, or for scalability and availability.
You can switch databases as often as you like. “Standard” is the default selection. The information
that follows describes the additional database options.
Note You can only select the “Store batches in SQL Server” option if there are no batches in the
system. If you attempt to apply this option when batches are in progress, you will get an error
message. Complete the batches in progress and try again.
SQL Server is not supplied with Kofax Capture. To use the SQL Server option you must have
already installed SQL Server. See your Kofax Capture installation instructions for system
requirements. For more information about SQL Server, see your SQL Server documentation.
Oracle option
With the Oracle option, you can specify an Oracle database. If you elect to use the this option, all
data is stored in Oracle, including the setup, batch catalog, user profile, user tracking, and batch.
Oracle is not supplied with Kofax Capture. To use the Oracle database option you must have
already installed an Oracle .NET data provider on all Kofax Capture workstations. Selecting this
option also requires that you supply the Oracle database service name. See your Kofax Capture
installation instructions for system requirements. For more information about Oracle database, see
your Oracle documentation.
IBM DB2 is not supplied with Kofax Capture. To use the IBM DB2 option you must have already
installed the IBM DB2 .NET data provider on all Kofax Capture workstations. Selecting this option
also requires that you supply the IBM DB2 database server name and the name of the database.
See your Kofax Capture installation instructions for system requirements. For more information
about IBM DB2, see your IBM DB2 documentation.
SecurityBoost Tab
This tab allows you to enable the SecurityBoost feature. SecurityBoost allows you to enhance
Kofax Capture security.
Identification Tab
This tab allows you to view or edit Kofax Capture site and workstation information. You can view
the GUID for your site, or change your Site ID and similar information.
You cannot edit batches that are currently in progress at any module.
The license information shown with the License Utility reflects the license status as of the last time
the display was refreshed. The display automatically refreshes when the License Utility is started.
In addition, you can set the display to automatically refresh at regular intervals that you specify,
or immediately refresh the display.
About SecurityBoost
SecurityBoost allows you to enhance Kofax Capture security.
To use SecurityBoost, you first set minimum system permissions for your operators so that they
cannot access critical Kofax Capture files and folders. You also create a special user with
permissions that allow access to these files and folders.
When SecurityBoost is enabled, Kofax Capture will use the permissions granted to the special user
instead of those granted to the operators. In other words, Kofax Capture can access the required
folders, but your operators cannot. For example, your operators will not be able to open or delete
files from your Kofax Capture image folder using Windows Explorer.
For more information about SecurityBoost permissions, see the Kofax Capture 9 Installation Guide.
Introduction
User interface items for configuring and using Kofax Capture Network Server (KCN Server) are
available from the Kofax Capture Administration and Batch Manager modules.
This chapter introduces these user interface items available for KCN Server.
Refer to Chapter 7 for step-by-step instructions on configuring KCN Server settings, and Chapter
8 for step-by-step instructions on performing other batch processing operations at remote sites
through KCN Server.
Administration Module
You can use the Edit menu and the Tools menu of the Administration module to perform certain
KCN Server administrative operations at the central site.
This section describes the KCN Server user interface components that are integrated into the
Kofax Capture Administration module.
Edit Menu
Two options for KCN Server configuration are available from the Edit menu:
The KCN Server Central Site Profiles dialog box is accessed by selecting Edit | KCN Server
Central Site Profile.
You must publish your batch class before any changes you make to the central site profiles will
take effect.
Module Assignments
This is a list of the Kofax Capture modules that you can assign to the central site or to the remote
sites. By default, all the modules are assigned to the central site. You can alter the assigned site of
any module except the Scan or Export modules, which must be run at the central site (the site
where the batch was created).
The Module column shows a list of available modules that are assigned to the batch class.
Note The Module column includes both the Kofax Capture standard modules, and any registered
custom modules in the batch class.
The Assigned Site column displays the site to which a module has been assigned. The module can
be assigned to the {Central Site}, or any registered remote site.
A registered remote site is a remote site that has synchronized and that appears in the Remote Site
Manager dialog box.
Module Description
The Module description box displays a description of the selected module.
Rescan Location
When a batch is closed with an error, it is routed to the Quality Control module. The rescan
location allows you to specify the site where the Quality Control module will process the problem
batch.
Retaining images at the remote site will reduce the batch transfer time, since the image files will
not need to be shuttled back and forth between locations. On the other hand, if disk space is at a
premium at the remote sites, you may choose to disable this option.
OK Button
Click this button to close the dialog box and preserve your settings.
Cancel Button
Click this button to close the dialog box and discard any changes you have made to the settings.
All settings will revert to their state when the dialog box was opened.
The Batch Class column contains a list of batch classes to which overrides can be applied. The Batch
Routing column will contain “Overridden” if the routing rules have been changed.
OK Button
Click this button to close the dialog box and preserve your settings.
Cancel Button
Click this button to close the dialog box and discard any changes you have made to the settings.
All settings will revert to their state when the dialog box was opened.
Module Assignments
This is a list of the Kofax Capture modules that you can assign to the central site or to the remote
sites. The Scan module must be run at the “Batch Creation Site,” while the Export module must be
run at the central site. Aside from these two restrictions, the other modules can be run at any
location.
The Module column shows a list of available modules that are assigned to the batch class.
Note The Module column includes both the Kofax Capture standard modules, and any registered
custom modules in the batch class.
The Assigned Site column displays the site to which a module has been assigned. The module can
be assigned to {Central Site}, or any registered remote site.
A registered remote site is the remote site that has synchronized and appears in the Remote Site
Manager dialog box.
Module Description
The Module description box displays a description of the selected module.
Rescan Location
When a batch is closed with an error, it is routed to the Quality Control module. The rescan
location allows you to specify the site where the Quality Control module will process the problem
batch.
Retaining images at the remote site will reduce the batch transfer time, since the image files will
not need to be shuttled back and forth between locations. On the other hand, if disk space is at a
premium at the remote sites, you may choose to disable this option.
OK Button
Click this button to close the dialog box and preserve your settings.
Cancel Button
Click this button to close the dialog box and discard any changes you have made to the settings.
All settings will revert to their state when the dialog box was opened.
The KCN Server Remote Site Profiles dialog box is accessed by selecting Edit | KCN Server
Remote Site Profiles.
Refer to Chapter 7 – Configuring Kofax Capture Network Server Settings on page 147 for information
about configuring remote site profile settings.
Note An optional workflow agent assigned to the batch class can override these routing rules.
Name
This lists the names of the remote site profiles available for selection.
Module Assignments
This is a list of the Kofax Capture modules that you can assign to the central site or to the remote
sites. By default, only the Scan module is processed at a remote site (the site where the batch was
created).
The Module column shows a list of available modules that are assigned to the batch class.
Note The Module column includes both the Kofax Capture standard modules, and any registered
custom modules in the batch class.
The Assigned Site column displays the site to which a module has been assigned. The module can
be assigned to {Batch Creation Site}, {Central Site}, or any registered remote site.
A registered remote site is a remote site that has synchronized and appears in the Remote Site
Manager dialog box.
Module Description
The Module description box displays a description of the selected module.
Rescan Location
When a batch is closed with an error, it is routed to the Quality Control module. The rescan
location allows you to specify the site where the Quality Control module will process the problem
batch.
Retaining images at the remote site will reduce the batch transfer time, since the image files will
not need to be shuttled back and forth between locations. On the other hand, if disk space is at a
premium at the remote sites, you may choose to disable this option.
Save Button
Click this button to save your settings to the selected remote site profile. Settings cannot be saved
to the “(None)” remote site profile.
Save As Button
Click this button to save your settings with a new name. If the specified profile name already
exists, a message will display, prompting you to confirm overwriting the existing profile. The
profile name can be up to 255 characters.
You can overwrite the “(Default)” profile or any user-defined profile by selecting the profile from
the list, and then confirming that you want to overwrite it. The “(None)” profile does not appear
in the list because you cannot overwrite it.
Delete Button
Click this button to delete the selected profile.
Note You cannot delete the “(Default)” profile, “(None)” profile, or any profile that is currently
assigned to a remote site.
Close Button
Click this button to close the dialog box. If changes have been made to the selected remote site
profile, a message will display prompting you to save the remote site profile before exiting the
dialog box.
Name
This lists the names of the remote site profiles available for selection.
If you select this option but do not assign any batch classes, the remote sites that share the profile
will be unable to download any batch classes.
Available
This lists all available batch classes sorted in ascending alphabetical order. You can select more
than one batch class at a time from this list.
To assign an available batch class to the remote site profile, select a batch class, and then click Add.
Alternatively, you can double-click the batch class name to assign it.
Assigned
This list contains two columns:
Batch Class: This column lists the batch classes assigned to the selected remote site profile
sorted in ascending alphabetical order.
Batch Routing: Usually, this column is empty. However, if you want to override the
specified routing for batches based on the selected batch class, you click Override Batch
Routing, and complete the dialog box that will display (see Override Batch Routing Dialog
Box on page 128 for more information).
If you override batch routing, this column is updated to display “Overridden,” KCN
Server will then route the batch in accordance with the rules currently in effect (the ones
that are doing the overriding).
Add
Click this button to move the selected batch class to the Assigned list. Alternatively, you can
double-click the batch class name.
Add All
Click this button to move all batch classes to the Assigned list.
Remove
Click this button to move the selected batch class back to the Available list. Alternatively, you can
double-click the batch class name.
Remove All
Click this button to move all batch classes back to the Available list. No batch classes will be
assigned to the remote sites sharing this profile.
Save Button
Click this button to save your settings to the selected remote site profile. Settings cannot be saved
to the “(None)” remote site profile.
Save As Button
Click this button to save your settings with a new name. If the specified profile name already
exists, a message will display, prompting you to confirm overwriting the existing profile. The
profile name can be up to 255 characters.
You can overwrite the “(Default)” profile or any user-defined profile by selecting the profile from
the list, and then confirming that you want to overwrite it. The “(None)” profile does not appear
in the list because you cannot overwrite it.
Delete Button
Click this button to delete the selected profile.
Note You cannot delete the “(Default)” profile, “(None)” profile, or any profile that is currently
assigned to a remote site.
Close Button
Click this button to close the dialog box. If changes have been made to the selected remote site
profile, a message will display, prompting you to save the remote site profile before exiting the
dialog box.
Module Assignments
This is a list of the Kofax Capture modules that you can assign to the central site or to the remote
sites. The Scan module must be run at the “Batch Creation Site,” while the Export module must be
run at the central site. Aside from these two restrictions, the other modules can be run at any
location.
The Module column shows a list of available modules that are assigned to the batch class.
Note The Module column includes both the Kofax Capture standard modules, and any registered
custom modules in the batch class.
The Assigned Site column displays the site to which a module has been assigned. The module can
be assigned to {Batch Creation Site}, {Central Site}, or <any registered remote site>.
A registered remote site is a remote site that has synchronized and appears in the Remote Site
Manager dialog box.
Module Description
The Module description box displays a description of the selected module.
Rescan Location
When a batch is closed with an error it is routed to the Quality Control module. The rescan
location allows you to specify the site where the Quality Control module will be launched to
process the problem batch.
Retaining images at the remote site will reduce the batch transfer time, since the image files will
not need to be shuttled back and forth between locations. On the other hand, if disk space is at a
premium at the remote sites, you may choose to disable this option.
OK Button
Click this button to close the dialog box and preserve your settings.
Cancel Button
Click this button to close the dialog box and discard any changes you have made to the settings.
All settings will revert to their state when the dialog box was opened.
Note Profile assignment occurs automatically when a site first synchronizes. Refer to Remote Site
Manager Dialog Box on page 136 for more information about assigning profiles to remote sites.
When you assign a license, the count shown in the count column is actually multiplied by the
number of remote sites that are assigned the remote site profile. This results in a value that is
subtracted from the value in the available column.
For example, if seven remote sites are assigned the same remote site profile, assigning one license
to that profile actually allocates seven licenses (one for each site).
Before allocating licenses to remote site profiles, ensure you have reviewed the license information
in the online Help.
Name
This lists the names of the remote site profiles available for selection.
Available
This list includes all station licenses. The display does not include system-wide licenses because
system-wide licenses are automatically shared across KCN Server sites. Station licenses, however,
must be specifically allocated to each remote site. See the volume licensing tab for information on
the sharing of volume licenses.
Note The columns correspond directly to the associated columns in the License Utility. The
License Utility is described in the online Help.
Assigned
This list consists of the following columns:
Type: This column lists the type of station license.
Count: This column shows the number of assigned licenses of the associated license type.
Add Button
Click this button to add the selected license type to the Assigned list. Double-clicking a license
type performs the same operation as selecting the license type in the Available column, and then
clicking Add.
Remove Button
Click this button to move the selected license type back to the Available box. Double-clicking a
license type in the Assigned box performs the same operation as first selecting the license type,
and then clicking Remove.
Refresh Button
Click this button to update the available license count.
When this dialog box is first opened, the displayed number of available licenses is derived from
the current system status (for example, the number of running modules will affect the number of
available licenses). The dialog box does not dynamically update this number in real time.
Refreshing the screen updates the number of available licenses, giving you an accurate count at
that moment.
Save Button
Click this button to save your settings to the selected remote site profile. Settings cannot be saved
to the “(None)” remote site profile.
Save As Button
Click this button to save your settings with a new name. If the specified profile name already
exists, a message will display prompting you to confirm overwriting the existing profile. The
profile name can be up to 255 characters.
You can overwrite the “(Default)” profile or any user-defined profile by selecting the profile from
the list, and then confirming that you want to overwrite it. The “(None)” profile does not appear
in the list because you cannot overwrite it.
Delete Button
Click this button to delete the selected profile.
Note You cannot delete the “(Default)” profile, “(None)” profile, or any profile that is currently
assigned to a remote site.
Close Button
Click this button to close the dialog box. If changes have been made to the selected remote site
profile, a message will display prompting you to save the remote site profile before exiting the
dialog box.
Name
This lists the names of the available remote site profiles.
Available
Each row in the list view represents a summary of each type of available volume license. Each row
has the following columns:
The Name column displays the names of the available volume licenses in the system. The
names in this column are sorted alphabetically.
The Period column displays the periodic attribute of the license (Annual or None). “None”
means the license has no periodic volume. “Annual” indicates the renewal period for the
volume.
The Remaining column shows the remaining volume for “Annual” volumes. If the license
has no periodic volume (None), this value is fixed at 0.
The Full Count column displays the maximum possible volume for the license. Each time
the periodic volume is reset, the remaining volume count will start with this value. If the
license has no such periodic volume, this value is fixed at 0.
The Remaining - One Time Use column displays the remaining one-time use volume count.
If the license has no one-time use volume, this value is fixed at 0.
The Full Count - One Time Use column displays the one-time use volume full count. If the
license has no one-time use volume, this value is fixed at 0.
Refresh Button
Click this button to update the available license count.
When this dialog box is first opened, the displayed number of available licenses is derived from
the current system status (for example, the number of pages scanned since the dialog box opened
are not reflected until refreshed). The dialog box does not dynamically update this number in real
time.
Refreshing the screen updates the number of available licenses, giving you an accurate count at
that moment.
Applied Limits
Each row in the list view contains a volume license for which the administrator can set periodic
and/or one-time use volume limits.
If this dialog box displays for the first time, all the available volume licenses are displayed with
the check box unselected. The default values for periodic and one-time use limits are set to “No
Limit.” To apply a limit to a license, select its corresponding check box and edit the limit.
Save Button
Click this button to save your settings to the selected remote site profile. Settings cannot be saved
to the “(None)” remote site profile.
Save As Button
Click this button to save your settings with a new name. If the specified profile name already
exists, a message will display, prompting you to confirm overwriting the existing profile. The
profile name can be up to 255 characters.
You can overwrite the “(Default)” profile or any user-defined profile by selecting the profile from
the list, and then confirming that you want to overwrite it. The “(None)” profile does not appear
in the list because you cannot overwrite it.
Delete Button
Click this button to delete the selected profile.
Note You cannot delete the “(Default)” profile, “(None)” profile, or any profile that is currently
assigned to a remote site.
Close Button
Click this button to close the dialog box. If changes have been made to the selected remote site
profile, a message will display, prompting you to save the remote site profile before exiting the
dialog box.
Polling Tab
The Polling tab allows you to define polling settings.
Name
This lists the names of the remote site profiles available for selection.
Polling Control
The Polling Control allows you to specify which location controls polling.
Central site: The same polling options are defined at the central site for all remote sites that
are assigned the remote site profile. The polling settings on the display are subsequently
enabled. To configure the polling settings centrally, see Setting Up Polling on page 156.
Remote site: Polling options are defined independently at each remote site. The polling
settings are disabled on the display. To set the remote site polling settings, see Configuring
Remote Site Polling Times on page 159.
If polling is controlled by the central site, then the time zone of the central site is used. For
example, if polling is set to occur at 8 PM at a central site in New York, remote sites in Los Angeles
will poll at 5 PM their time (8 PM New York time).
Never poll: This option disables automatic polling.
However, if the start date and time are in the future, polling will occur once at that time,
and then never again.
If the start date and time are in the past, polling will not occur even once.
Poll every: Select this option if you want your remote sites to automatically poll the central
site at a defined interval starting from a specific date and time. You can specify the interval
in days, hours, or minutes. The default is every 24 hours.
Start date: This is the date to start polling. Clicking the down arrow displays a calendar
from which you can select another date. Alternatively, click any part of the date, and use
the arrows to change that part of the start date. The default is the date of installation.
Start time: This is the time to start polling. Click any part of the time, and use the arrows to
change that part of the start time. The default is the time of installation.
If Connection Fails
The If Connection Fails area allows you to specify what action should be taken if the remote site
cannot connect to the central site.
Never retry: This option prevents the remote site from attempting to reconnect with the
central site, if the connection fails. However, the remote site will attempt to reconnect with
the central site at the next scheduled polling time.
Retry every: This option allows the remote site to automatically attempt to reconnect with
the central site, if the connection fails. The settings take effect only for automatic
synchronization. The following retry settings are also selected with this option:
The frequency in minutes, hours, or days from 0-99
The duration in minutes, hours, or days from 0-99
The default setting is to retry every 15 minutes for up to 8 hours.
Once a batch is uploaded, you can view the status of a batch in either of two ways:
Through the Batch Processing display in Batch Manager at the remote site
From the Remote Synchronization Agent Status display at the remote site
Within Batch Manager at the remote site, batches display KCN Server for their current module
(queue), and Ready for their current status. This means that the batch is ready to be uploaded.
After the batch is uploaded to the central site, it is then inserted into the Kofax Capture workflow.
A batch is uploaded, if the time for the next automatic synchronization arrives (if the RSA is
running at the remote site), or if you initiate a manual upload. You can manually upload in Batch
Manager by selecting File | Process Batch, or by clicking Process Batch on the toolbar.
When a batch in the KCN Server queue is processed, the status of the batch is displayed as one of
the following in sequence: In Progress (Uploading), In Progress (Uploaded), In Progress
(Inserting), or In Progress (Inserted). Batches are inserted at the central site one at a time. Once the
batch is inserted, it is removed from the Batch Manager display.
Save Button
Click this button to save your settings to the selected remote site profile. Settings cannot be saved
to the “(None)” remote site profile.
Save As Button
Click this button to save your settings with a new name. If the specified profile name already
exists, a message will display prompting you to confirm overwriting the existing profile. The
profile name can be up to 255 characters.
You can overwrite the “(Default)” profile or any user-defined profile by selecting the profile from
the list, and then confirming that you want to overwrite it. The “(None)” profile does not appear
in the list because you cannot overwrite it.
Delete Button
Click this button to delete the selected profile.
Note You cannot delete the “(Default)” profile, “(None)” profile, or any profile that is currently
assigned to a remote site.
Close Button
Click this button to close the dialog box. If changes have been made to the selected remote site
profile, a message will display prompting you to save the remote site profile before exiting the
dialog box.
using a round robin technique. Select this option if all central sites are normally used to
process batches.
Select central site by priority: This option allows you to select a priority list of central sites
for uploading batches. Select this option to specify an order of selected sites in the event
that sites become unavailable.
Add
Click this button to assign a site to the central site priority list.
Remove
Click this button to remove a central site from the priority central site list.
Save button
Click this button to save your settings to the selected remote site profile. Settings cannot be saved
to the “(None)” remote site profile.
Save As button
Click this button to save your settings with a new name. If the specified profile name already
exists, a message will display, prompting you to confirm overwriting the existing profile. The
profile name can be up to 255 characters.
You can overwrite the “(Default)” profile or any user-defined profile by selecting the profile from
the list, and then confirming that you want to overwrite it. The “(None)” profile is not displayed in
the list because you cannot overwrite it.
Delete button
Click this button to delete the selected profile.
Note You cannot delete the “(Default)” profile, “(None)” profile, or any profile that is currently
assigned to a remote site.
Close button
Click this button to close the dialog box. If changes have been made to the selected remote site
profile, a message will display, prompting you to save the remote site profile before closing the
dialog box.
Tools Menu
The Tools menu in the Administration module at the central site contains the following options for
KCN Server operations: Remote Site Manager. These options are only enabled after the KCN Web
server components are installed on that site.
Central Sites
This is a list of central sites that are included in the installation, including the primary central site.
The Name column shows each sites name. The URL column displays the URL of the
corresponding site.
New Button
Click this button to open the Central Site dialog box, which allows you to specify the URL of the
central site to be added.
Edit Button
Click this button to open the Central Site dialog box which allows you to edit the URL of a central
site.
Delete Button
Click this button to delete a central site from the list. When you delete a central site from the list, it
is no longer available for batch upload.
OK Button
Click this button to close the dialog box and preserve your settings.
Cancel Button
Click this button to close the dialog box and discard any changes you have made to the settings.
All settings will revert to their state when the dialog box was opened.
Note The KCN Service attempts to automatically assign a profile for a new site based on
this rule. However, if it is impossible to assign the profile, due to licensing limitations, then
the site is assigned the “(None)” profile.
Remove Button
Click this button to delete a remote site from the list. The next time the site synchronizes, it will be
treated as a new remote site that will be assigned a remote site profile (based on remote site
behavior settings.)
Removing a remote site is not allowed if it is assigned to a Kofax Capture module in one or more
remote site profiles. If the selected remote site is assigned to at least one module in any remote site
profile, an error message is displayed, informing you that the remote site cannot be removed, and
which site profiles use that remote site.
If the selected remote site is not assigned to any modules in any remote site profile, a warning
message box asks for confirmation before the site is removed.
Edit Button
Click this button to open the KCN Server Remote Site Profiles dialog box for the currently selected
profile. The dialog box can be used to edit remote site profiles. You can create additional profiles
by selecting any profile, editing it, and saving it with a new profile name.
Close Button
Click this button to apply the changes and close the dialog box.
This section describes the KCN Server user interface components that are available from the
Options menu of the Kofax Capture Batch Manager module.
Options Menu
You can perform the following KCN Server-related operations using the Options menu:
Convert a Kofax Capture installation to a remote site
Specify the URL of the KCN Web server at the central site
Activate the Kofax Capture Network Server Remote Synchronization Agent (RSA)
Set the RSA polling settings
Set the batch processing dialog polling settings
At the central site, all options but the Convert to Remote Site option are disabled. However, if you
select the Convert to Remote Site option at a central site, a warning message will display
indicating that central sites cannot be converted to remote sites.
Note The batch classes downloaded from the central site will depend on the remote site profile.
Note You cannot reverse the conversion to a remote site. You must reinstall Kofax Capture.
This dialog box is used at the remote site to specify the central site’s KCN Web server URL.
Note If the Web site requires SSL, you must specify the URL with https instead of http. In
addition, if the central site is using a port number other than the default of 80 for HTTP, you must
include the port number in the address. See Changing Web Server Port Numbers on page 148 for
more information.
This dialog box is also used to switch central sites. To switch central sites, ensure that there are no
batches in process before switching. Upon successfully switching the remote site to a new central
site, batch classes from the old central site will be replaced with batch classes from the new central
site based on the remote site profiles assigned to the remote sites. Licensing will also be
downloaded to your remote sites from the new central site based on the remote site profiles
assigned to the remote sites.
The remote site should synchronize prior to performing a site switch to ensure that pending user
tracking statistics are uploaded to the old central site.
Note If you want to use user tracking at the new central site, be sure to enable user tracking on the
new Kofax Capture server.
RSA Polling settings control how often and when the RSA synchronizes with your central site.
These settings can be centrally or remotely controlled as specified by the profile assigned to your
remote site. If allowed by your remote site profile, you can specify RSA polling settings at your
remote site. For more information on setting control of polling, see Polling Tab on page 132. The
RSA Polling Settings dialog box consists of the following options:
If Connection Fails
The If Connection Fails box allows you to specify what action should be taken if the remote site
cannot connect to the central site.
Never retry: This option causes the remote site to not attempt to reconnect with the central
site, if a connection fails.
Retry every: This option causes the remote site to automatically attempt to reconnect to the
central site if a connection fails. The settings take effect only for automatic synchronization.
The following retry settings are also selected with this option:
The interval in minutes, hours, or days from 0-99
The duration in minutes, hours, or days from 0-99
The default setting is to retry every 15 minutes for up to 8 hours.
OK Button
Click this button to close the dialog box and save your settings.
Cancel Button
Click this button to close the dialog box and discard any changes you have made to the settings.
All settings will revert to their state when the dialog box was opened.
Apply Button
Click this button to save any changes you have made to the settings without closing the dialog
box.
The Batch Processing Dialog Polling Settings dialog box allows you to set a special polling interval
that will be used to check the status of the previously uploaded batch. The status will display in
the Batch Processing dialog box. See Batch Processing Dialog Box on page 141 for more information.
to upload a particular ready batch immediately to the central site, you can select the batch, and
process the batch. The Batch Processing dialog box will display at the remote site.
To process a particular batch, use Batch Manager’s File | Process Batch menu, Process Batch
button on the toolbar, or Process on the shortcut menu.
Updates to the status messages and other processing information occur depending on the polling
settings defined for this dialog box. Refer to Batch Processing Dialog Polling Settings on page 141 for
details.
In addition, the Batch Processing dialog box allows you to immediately receive updated status by
clicking Check Now, rather than waiting for the next scheduled batch status update.
Status
This displays the current operation that is being performed. The operations include:
Uploading Batch: This is displayed while a batch is preparing to upload, during file
transfer, and while the batch upload is occurring.
Uploaded Batch: This is displayed after a batch has been uploaded.
Inserting Batch: This is displayed while the central site is inserting the batch.
Inserted Batch: This is displayed when the central site has inserted the batch. The batch is
removed from the remote site, the Batch Processing dialog box is closed, and focus returns
to Batch Manager.
Check batch status in: # seconds: This specifies when the batch status will be checked
again. The interval to wait is established in the Batch Processing Dialog Polling Settings
dialog box, and counts down by 1. When it reaches the end of the countdown, it checks the
status of the batch, and updates the display. It then restarts the countdown, if the batch has
not yet been inserted.
During the countdown time, you can click Check Now (described below) to immediately
check the status, or Check Later to dismiss the dialog box.
Status Box
The status box displays a log of the activities performed by the RSA. Each message includes the
date, time, message, and originating station ID. In addition, error messages are displayed in this
box.
Check Now
Click this button to immediately check the batch’s status.
You could use this button to check the status of a batch earlier than the number of seconds
indicated in the Check batch status in: # seconds status message.
Check Later
Click this button to dismiss the dialog box.
Usually, synchronization will occur on the schedule set up within the remote site profile assigned
to the remote site.
Double-click the RSA Windows system tray icon or right-click Status on the RSA shortcut menu to
display the Remote Synchronization Agent dialog box. This dialog box is described on page 144.
Note If the RSA has been installed as a service, the RSA application does not have to be activated
or running for the RSA to perform automatic polling or synchronize with the central site. In this
case, the RSA system tray icon does not appear.
RSA Menu
Right-click the RSA Windows system tray icon to display the RSA menu, shown below.
Close
Select this option to close the RSA, and clear the RSA Windows system tray icon.
Note Automatic polling only occurs when the RSA is running, unless you have installed the RSA
as a service, in which case the service performs the polling even if the RSA application is closed. If
you need to restart the RSA, select it from the Startup group, or restart Windows.
Status
Select this option to display the Remote Synchronization Agent dialog box, which is described
below.
About
Select this option to display an About box. From the About box, you can view version information
about the RSA, or open your browser to the Kofax Technical Support site.
The RSA Windows system tray icon also allows you to view the next scheduled polling time. Hold
your cursor over the RSA icon, and a tooltip will display the next scheduled polling time.
The entries that are displayed include the status of all batches uploaded from the remote site, and
whether user tracking statistics were uploaded and new batch classes were downloaded.
The dialog box also allows you to either synchronize or download batch classes on demand.
Status
This displays the current operation that is being performed. Operational messages that are
displayed include: Sending batches, Get file <file name>, Inserting, etc.
Status Box
This displays the date, time, message number, message, and originating station ID for each event.
The messages specify whether batch classes were received successfully, user statistics were sent
(uploaded), batches were sent (uploaded), and central site polling times were downloaded
successfully.
Note If the station ID has been changed, the change will not take effect until you stop and then
restart the RSA.
All KCN Server “Ready” or “Suspended” batches are first sent to the KCN Server queue. The
statuses of the batches are displayed at the remote site, as described in Checking the Status of Batches
at a Remote Site on page 168.
Then, at the remote site, the In Progress(status) batches are checked to see if their status has
changed. If the status of a batch has been changed to In Progress(Inserted), the batch is deleted
from the remote site. Otherwise the status of the batch is updated.
Credentials
This button is used to display the Connect to Central Site dialog box which allows you to enter
and save remote site authentication information (user name and password) that is used during
Basic or Windows Integrated authentication.
Hide Button
This button is used to dismiss the Status dialog box. It does not shut down the RSA.
If the Kofax Capture installation has been converted to a remote site, the specified user name and
password are saved and validated by connecting to the central site Web server. If the installation
has not yet been converted to a remote site, the specified user name and password are saved but
not validated.
If the Kofax Capture installation is already a remote site and you enter invalid credentials, the
dialog box redisplays until correct credentials are entered or you click Cancel.
User name
Enter a valid Web server account (user name).
Password
Enter a valid password.
Introduction
After completing the installation process, you can configure Kofax Capture Network Server (KCN
Server) settings to manage Kofax Capture batch processing activity between your central site and
the remote sites.
This chapter provides step-by-step for configuring your KCN Server settings.
To use a Kofax Capture installation as a KCN Server remote site, you need to convert the Kofax
Capture installation to a KCN Server remote site. Then, you should activate the RSA at the remote
site.
Each configuration (client/server or standalone) must have at least one RSA activated, although
more than one station in a client/server configuration can run the RSA.
Note For remote sites, batch class creation and management must occur at the central site.
4 When prompted, enter the URL of the Web server that will process requests between the
central site and the remote site, and click OK. The conversion will validate the URL by
attempting to contact it. If the URL cannot be validated, an error message will display. If
this occurs, check the spelling of the Web server URL.
Note If the Web site requires SSL, you must specify the URL with “https”, instead of
“http”.
5 When prompted, click Yes to activate the RSA on the remote station.
Note If you select No, you can upload batches through the Batch Manager module. You
can activate the RSA on the remote site at a later time, if desired.
Step 2: Use the Web Server URL dialog box to specify the new port number.
Warning When selecting alternative ports, you must ensure that the ports you assign are not
being used by other applications or services. If there are port conflicts, you may experience
intermittent and unpredictable problems.
4 Change the TCP Port setting to the desired number, for example 8080.
X To use the Web Server URL dialog box to specify the new port number
1 At each of the remote sites, open Batch Manager and select Options | KCN Server | Web
Server URL.
2 Enter the Web server URL and the new port number using the following syntax:
<protocol>://<host>[:port]/acis. For example, if the Web server name is techpub and the
alternate TCP port number is 8080, the URL would be http://techpub:8080/acis.
For automatic polling, you need at least one client running the RSA at a remote site.
Note If you change the site name, the change will not be reflected in the RSA Status display until
the RSA is stopped and restarted at the remote site. See the online Help for more information on
changing the site name.
Note If you perform an automatic installation of Kofax Capture, you can set the RSAURL
attribute to the full URL of the Web server in the initialization file to automatically activate the
RSA on a remote station. See the Kofax Capture 8 Installation Guide for more information.
If you plan to use a custom module at your central site, note the following before assigning any
batch classes containing custom modules to the central site profile. You must:
1 Register the custom module and install the executable at your central site. See Appendix D
on page 223 for more information on registering custom modules and workflow agents.
2 Add the custom module to the desired batch class at the central site and publish the batch
class. For more information on creating or modifying batch classes, see Chapter 3 or the
online Help.
See the Kofax Capture Developer’s Guide or the online Help for more information on custom
modules and workflow agents.
Because you can use the Quality Control module as either a regular processing module, or
for use only when an exception has occurred, consider the following:
Exception batches are automatically routed to the Quality Control module at the
rescan location specified in the central site profile.
Batches without exceptions are routed to the site where the Quality Control module
has been set up to run, if the Quality Control module has been defined as part of the
batch class definition.
3 Make a selection from the list of modules.
4 In the Assigned Site column, select the location for that module. Repeat steps 3 and 4 as
needed.
5 If desired, change the Rescan Location. This will specify where documents are rescanned
in case of a problem.
6 If desired, select “Retain images at each remote site.” Retaining images at the remote site
will reduce the batch transfer time, since the image files will not need to be shuttled back
and forth between locations. On the other hand, if disk space is at a premium at the
remote sites, you may choose to disable this option.
7 If desired, click the Batch Class Override tab. The Batch Class Override tab will display.
8 Select a batch class from the list.
9 Click “Override Batch Routing.” The Override Central Site Batch Routing dialog box will
display.
10 Select “Use the following batch routing rule.”
11 Make a selection from the list of modules.
12 In the Assigned Site column, select the location for that module. Repeat steps 11 and 12 as
needed.
13 If desired, change the Rescan Location. This will specify where documents are rescanned
in case of a problem.
14 If desired, select “Retain images at each remote site.”
15 Click OK to save your settings and close the dialog box.
Each remote site can be assigned a different remote site profile, or two or more remote sites can be
assigned the same remote site profile. If you change a profile, all remote sites that share the same
profile will receive the updated profile the next time that they synchronize.
Setting up remote site profiles involves performing the following major steps at the central site:
Because you can use the Quality Control module as either a regular processing module or for use
only when an exception has occurred, consider the following:
Exception batches are automatically routed to the Quality Control module at the rescan
location specified in the remote site profile.
Batches without exceptions are routed to the site where the Quality Control module has
been set up to run, if the Quality Control module has been defined as part of the batch class
definition.
If you plan to use a custom module at your remote sites, note the following before assigning to
remote site profiles any batch classes containing custom modules. You must:
1 Register the custom module at your central site. Then, copy the custom module’s
executable to the <Kofax Capture folder location>\Bin folder at the appropriate remote sites.
See Appendix D on page 223 for more information on registering custom modules and
workflow agents.
2 Add the custom module to the desired batch class at the central site and publish the batch
class. For more information on creating or modifying batch classes, see Chapter 3 or the
online Help.
3 In the remote site profile for the specific remote sites, add the custom module to the list of
modules set to run at remote sites.
4 Assign the batch class with the custom module to the appropriate remote site profiles.
See the Kofax Capture Developer’s Guide or the online Help for more information on custom
modules and workflow agents.
For more information on licensing, see the Kofax Capture online Help.
Note Your system administrator may need to purchase additional station licenses if you are
adding remote sites to your KCN Server installation.
When you assign batch classes to a remote site profile, consider the following:
Image Files
In the temporary image folder specified in the batch class definition, ensure that you have either
used Uniform Naming Convention (UNC) format (for example, \\Jrc\Kofax
Share\ServerDB\Images) for the path to the image files, or mapped an explicit drive letter to the
location of your image files.
For existing batch classes, if necessary, update the paths to the image folders in UNC format and
republish the batch classes.
Note If your image folder is located on an NTFS partition, the anonymous user that you specify
for your KCN Server virtual directory must have write permissions to that folder. Refer to the
Kofax Capture 8 Installation Guide for more details.
Dictionaries
Dictionaries used by your batch class are downloaded to and maintained in the AdvOCR folder in
your Kofax Capture installation folder at the remote sites.
Database Validation
If database validation is enabled for a batch class assigned to a specific remote site, the appropriate
database software and files must be available to the Validation modules at the remote site. An
error message will display if the required files and database software cannot be found.
Setting Up Polling
Polling refers to the process of checking for batches and user statistics (if user tracking has been
enabled) to be uploaded to the central site, and batches, batch classes and configuration settings to
be downloaded to the remote sites.
The Polling tab of the Remote Site Profiles dialog box is used to set up control of polling and the
polling schedule for a specific remote site profile.
When you set up polling, you select which site (central or remote) will set up and control the
polling schedule. You also set up the polling schedule, if you selected central control of polling.
You can elect to have the polling schedule controlled by the central site (the default) or the remote
sites individually.
If you select Central site control of polling, your polling settings will affect all the remote sites that
share the profile containing the polling settings. The remote sites will be prohibited from setting
their own polling times. The next time a remote site polls the central site, the settings will be
downloaded to the remote site.
If you select Remote site control of polling, you can specify the polling settings individually for
each remote site that shares the remote site profile.
Note You can overwrite or edit any profile except the “(None)” profile. Any changes to a profile
will affect all remote sites sharing that profile.
If you are no longer using a remote site profile, you might want to delete it from the list of remote
site profiles available for assignment.
Note You cannot delete any remote site profiles that have been assigned to (are in use by) remote
sites. To delete a remote site profile that has been assigned to one or more remote sites, you must
first remove the assignment through the Remote Site Manager dialog box. You cannot delete the
“(None)” or the “(Default)” remote site profiles.
5 If you need to edit a remote site profile before assigning it to a remote site, click Edit. The
KCN Server Remote Site Profiles dialog box will display. Then, edit the profile, and save
it. You will be returned to the Remote Site Manager dialog box.
Note Changing the attributes of a profile affects all remote sites to which the profile was
assigned.
6 To specify which remote site profile will be assigned to new sites by default, select the
desired option from the New remote site behavior list.
7 To save the changes, click Close.
Note You cannot remove a remote site if it is listed in any remote site profile.
9 Select one of the following options from the Polling Settings area.
Never poll. This option disables automatic polling. However, if the start date and time
are in the future, polling will occur once at that time, and then never again. If the start
date and time are in the past, polling will not occur even once.
Poll every. This option allows your remote sites to automatically poll at defined
intervals. If you select this option, also select a numeric value in the range 1-99, and a
unit of polling frequency.
10 Select a start date. Click the date to display a calendar from which you can choose a date.
On the calendar, click the left or right arrows next to the month name to change the
month.
11 Select a start time. Click any part of the time to change the hours, minutes, seconds, or
AM/PM.
12 Select one of the following options to be used if the connection fails between the remote
site and the central site.
Never retry. This option prevents the remote sites from attempting to reconnect with
the central site, if the connection fails. However, the remote site will attempt to
reconnect with the central site at the next scheduled polling time.
Retry every. This option allows the remote site to automatically attempt to reconnect to
the central site, if a connection fails. If you select this option, specify how often and for
how long the connection should be retried. Select a numeric value in the range 1-99,
and a unit of time for each.
13 Specify how often the status of uploaded batches should be checked. Select a numeric
value in the range 1-99, and a unit of time.
14 Click Apply to save the modifications and remain in the dialog box, or click OK to save
the modifications and exit the dialog box.
The interval you specify on the Batch Processing Dialog Polling Settings dialog box has no effect
on the RSA polling interval.
The selected time specifies how often the status of an uploaded batch will be checked to determine
if it has been inserted into the Kofax Capture workflow at the central site.
Introduction
After installing Kofax Capture at your remote installations and converting the remote installations
to remote sites, you can take advantage of your Internet or intranet capabilities to process Kofax
Capture batches.
This chapter provides information about using Kofax Capture Network Server (KCN Server) in a
production environment.
When a batch is transferred between sites, occurrences of numeric, date, and time values are
converted to the regional settings of the destination site.
Other information, such as polling settings or user tracking data, also undergoes regional
conversion. Following is a list of items that undergo regional conversion.
Kofax Capture known values (also called “suggested values”)
Kofax Capture Values, as used for endorsing strings, batch field values and defaults, index
field values and defaults, and export connector setup links
Batch field and index field values based on decimal/numeric field types
Batch totals, both expected and actual
Patch code and advanced bar code settings
Polling settings
Data derived from Kofax Capture Values for the Kofax Capture Database and the Kofax
Capture Text export connectors
User tracking statistics (such as start/end times)
The following regional examples from the Windows Control Panel compare common numeric,
date, and time formats for the United States to those of Germany.
Language Translation
Some items contained in a batch class are translated to the language of Kofax Capture on the
remote site computer. This translation will occur regardless of the language of Kofax Capture that
created the batch class and/or batch. The reverse occurs when the batch is uploaded to the central
site.
Note When a batch is processed, the results returned by the values are not translated.
Also listed are installation configurations or situations in which no translation or conversion can
occur. Unless noted, the items below apply to both Kofax Capture at the central site and KCN
Server remote sites.
Import/export of batch classes among computers that use different code pages
Batch classes created in versions of Ascent Capture prior to version 6.1
Dictionary values that are numeric, date, or time
Recognition Profile language and character set selections
Export text constants, customizations, and string fields that contain numeric, date, or time
entries
Batch names derived from time/date, because these are classified as strings, and strings
are not converted or translated
Kofax Capture module names
Kofax Capture Values when they are used as known values (also called “suggested
values”)
Results returned by Kofax Capture Values
X To download batch classes with automatic synchronization, set polling times for the
synchronization.
Centrally controlled polling times are set in remote site profiles. The remote site profiles
are defined using the KCN Server Remote Site Profiles dialog box available from the
Administration module at the central site. Once the remote site profiles are defined and
downloaded to the remote site, the settings take effect for the remote site.
Remotely controlled polling times are set in the RSA Polling Settings dialog box. The
dialog box is available from Batch Manager at the remote sites. Once the settings are
defined at a remote site and saved, the settings take effect for the remote site.
See the sections Setting Up Polling on page 156 and Configuring Remote Site Polling Times on
page 159 for more information.
Keep in mind that he Scan module must be run at the “Batch Creation Site,” while the Export
module must be run at the central site. Aside from these two restrictions, the other modules can be
run at any location.
For more information on the KCN Server options and setting up site profiles, refer to Chapter 6 on
page 121 and Chapter 7 on page 147.
However, if the site profile specifies that images should be retained at remote sites, the image files
will not be deleted with the rest of the batch upon transfer. The images will only be deleted if the
batch is exported or deleted from the system.
Batches ready to be transferred can be uploaded or download through any of the following
means:
Automatically at the next scheduled automatic polling time.
Manually at remote sites, with the Synchronize Now button in the RSA.
Manually at remote sites with the Download Batches button in the RSA.
Manually through the Process Batch button in Batch Manager (if the status of the batch
indicates that the batch is ready for the KCN Server queue).
Tip You might want to wait to transfer all completed batches at once, or your administrator might
want the transfer to be controlled solely by the polling schedule.
Batches in the process of being transferred are displayed in Batch Manager at the originating site
as being in progress. As each batch is transferred and inserted into the Kofax Capture work flow at
the destination site, the status of the batch is updated in Batch Manager at the originating site.
Note If a site receives a batch with the same name as a batch that already exists at that site, the
most recently received batch will be renamed. If the naming conflict occurs at the central site, the
batch is permanently renamed with a tilde (~) and a number starting at zero appended to the
name, and the new name will be recorded in the KCN Server log file (ACISYYMM.txt). If the
naming conflict occurs at a remote site, the batch is temporarily renamed. When it returns to the
central site, the original name will be restored.
Note You should not stop or restart the Web server while batches are being transferred.
See the sections Setting Up Polling on page 156 and Configuring Remote Site Polling Times on
page 159 for more information.
Recalling a Batch
From the central site, you can recall a batch that has been transferred to a remote site. If you recall
a batch, any work that has been done at the remote site will be lost. In addition, the recall will
cause the batch to be deleted at the remote site when the next synchronization takes place.
Note If the site profile is set to retain images at the remote site, the image files will not be deleted.
You might choose to recall a batch, for example, if it cannot be processed at a remote site for some
reason (such as network or staffing constraints). In this case, by recalling the batch, you have
returned it to its initial state (prior to downloading) so it can be processed again at the central site.
Once a batch has been recalled, all subsequent processing remains at the central site regardless of
the original routing rules applied to the batch class. After being recalled to the central site, the
batch will go to the module it would have gone to at the remote site, had the recall not occurred.
Note A workflow agent can still control routing after a batch is recalled. It is up to the workflow
agent designer to decide whether or not recalled batches should be routed away from the central
site. For example, the workflow agent can check to see if a batch has been recalled, and choose to
route the batch to a specific remote site as determined by rules within the agent.
If a recalled batch is locked at the remote site during the next synchronization, a warning message
is recorded in the preceding logs. The batch will not be deleted until it is unlocked, and a
subsequent synchronization occurs.
Note If a remote site is in the middle of uploading a batch, and you recall that batch, work done at
the remote site will still be lost. This will occur even though the remote site changes were in the
process of being uploaded.
Normally, if someone at a remote site deletes a batch, that batch will also be deleted at the central
site during the next synchronization. However, if that deleted batch has already been recalled to
the central site, the recall takes precedence and the batch will not be deleted at the central site.
Recalling a Batch
You recall a batch from within the central site Batch Manager.
X To recall a batch
1 At the central site, open Batch Manager.
2 Select the batch (or batches) you want to recall.
3 Select File | Recall Remote Batch. A confirmation dialog displays.
Note You can only select this menu item if the batch status is In Progress (<Site Name> -
Ready to download), or In Progress (<Site Name> - Downloading), or In Progress (<Site Name> -
Downloaded).
4 Select Yes to confirm the recall. If you selected Yes, the designated batches are recalled to
the central site.
Unrejecting Batches
You can unreject a batch or group of batches with a single command without having to view each
rejected document and unreject each image. A rejected batch is a batch that has been rejected
because of a processing error. You can only unreject a batch that has a status of Error.
Images that have been unrejected can still be processed properly with VRS QC Later.
After a successful batch class update, certain batch class changes may not have an effect on
selected batches. For example, if the latest batch class included settings that are applied during
scanning (such as the Scan Image Cleanup profile), this change will have no effect on the batch
since scanning was already completed when you updated the batch with the latest version of the
assigned batch class.
Batch class updates will not occur if the latest version of a batch class includes:
Added, removed, or renamed:
Queues (renaming does not apply)
Form types
Folder classes
Batch fields
Document or folder index fields
A changed Total index field setting in the document class properties
A deleted export connector that was used during a partial batch export.
When Check Now is clicked, the status of the batch is checked by the KCN Web server, and the
status of the batch is updated on the display at the remote site.
Once a batch has been successfully inserted into the Kofax Capture workflow at the central site,
the Batch Processing dialog box closes, and the batch is deleted from the Batch Manager display at
the remote site.
3 When the Batch Processing dialog box displays, to immediately check the status of the
uploaded batch, click Check Now. The display will be refreshed.
As long as the status of the batch is displaying in the Batch Processing dialog box, you can
click Check Now to refresh the display, or wait for the display to automatically refresh
when the check status countdown interval reaches zero. The countdown interval will
restart at the value specified for the batch processing dialog polling setting, if the batch
has not yet been inserted into the Kofax Capture workflow at the central site.
X To display the Remote Synchronization Agent dialog box, do one of the following:
Right-click the RSA system tray icon, and select Status from the context menu.
Double-click the RSA system tray icon.
Normally, a volume license is shared across all stations in a Kofax Capture installation. If KCN
Server is installed, volume license usage is shared across the central site and all remote sites. This
configuration is ideal if you want to centrally manage a license pool.
However, in some situations, there might be an advantage to treating each remote site as an
independent consumer of volume licenses. This feature allows you to assign specific limits for
volume-based licenses to remote site profiles. This setting is optional, and can be done for all,
none, or some of the volume-based licenses.
From the perspective of a remote site, these limits set the maximum volume available to it,
regardless of the total volume allowed by the license at the central site.
Assume that, at this moment, you have the following licenses and volumes at the central site:
You have already created a remote site profile called “Back 40” and now want to limit some of the
volumes available to that profile. By implication, all remote sites assigned the “Back 40” profile
will have the same limits placed on them.
You set the following volume limits on the “Back 40” remote site profile:
The preceding settings mean that each remote site with this profile has a maximum annual
allowance of 500 scan/import pages and 400 PDF Image + Text pages. No “one time use” volume
was assigned.
Note that if you have ten remote sites with the “Back 40” profile, you have essentially allocated
5000 concurrent license volume counts and 4000 PDF Image + Text license volume counts. The
combined total of the remote sites greatly exceeds the maximum allowed by these licenses at the
central site. Even so, the central site maximum volume provides an absolute limit on the volume
for your entire installation, and cannot be exceeded during production regardless of your
combined remote site allowances.
Each time your remote sites synchronize with the central site, the available volume reported at the
central site is decremented according to the usage at the remote sites. In this example, once the
maximum volume is reached at the central site, the system will no longer be able to process
batches.
Following are the basic steps to limit volumes at remote sites. This procedure assumes that a
remote site profile already exists and that at least one remote site has been assigned to that profile.
3 In the Name field, select the remote site profile you want to modify.
4 Click the Volume Licensing tab. Note the available licenses at the top and the applied
limits at the bottom. If this is the first time you have modified volume licensing limits for
this profile, all the boxes will be unselected.
5 Select one of the licenses. A check mark appears in the selected box and the two limit
fields change from “No Limit” to 0.
6 Click in the Periodic Limit field and enter a number from 0 to 2000000000. This limits the
periodic license count for the selected license type.
7 Click in the One Time Use field and enter a number from 0 to 2000000000. This limits the
“one time use” license count for the selected license type.
8 Repeat steps (5 - 7) for other license types as desired.
9 Click Save. This saves your changes to the selected remote site profile.
10 Repeat steps (3 - 8) for other remote site profiles as necessary.
11 Close the dialog box. The next time a remote site assigned to that profile synchronizes, the
new licensing limits will be transferred.
Monitoring Activity
As the KCN Server performs its tasks, information is stored in various log files.
Each entry in the ACISYYMM.txt log file includes the following information:
Date and time that the RSA locked the batch for processing
Status number
Module name
Kofax Capture server name
Kofax Capture server version
Transfer identifier
Remote site name
Remote station ID
Remote Kofax Capture version
Message
Extra information as appropriate
Errors are also logged from the KCN Server, and are sent to the <KCN Server folder
location>\logs\ACIWYYMM.txt file. The YY specifies the current year and the MM specifies the
current month; for example, ACIW0305.txt.
Note If the new Web server points to a different Kofax Capture server, ensure that there are no
batches in process, before switching central sites.
Note If the Web site requires SSL, you must specify the URL with “https”, instead of
“http.”
4 Click OK.
If the URL cannot be validated, an error message will display. If this occurs, check the
spelling of the Web server URL.
If the specified Web server URL is validated, and all pending statistics and pending
batches have been uploaded to the old central site, a warning displays prompting you to
confirm switching central sites.
A message also displays stating that new batch classes and licensing will be downloaded,
and batches classes and licensing from the old site will be discarded.
5 When prompted, click Yes to confirm changing the URL.
If you want to track user statistics, you will have to ensure that user tracking is configured at the
Kofax Capture central site server.
Batch user tracking statistics are uploaded whenever a batch is uploaded from a remote. Statistics
for deleted batches and launched modules are uploaded only when synchronization occurs.
Once uploaded, user tracking statistics are incorporated automatically into the central Kofax
Capture database. Once a batch is successfully uploaded and inserted, the remote site RSA deletes
all user tracking statistics associated with that batch at the remote site.
If that batch is subsequently downloaded to any remote site, all its associated statistics remain at
the central site (they are not downloaded with the batch). In other words, the central site serves as
a repository for the batch statistics, but does not share them with the remote sites.
For more information on tracking user statistics, refer to the Kofax Capture online Help.
Introduction
The auto-import feature allows the Scan module to create batches by reading batch information
(such as the paths to images stored on disk, index data, and more) from special-purpose auto-
import files.
Note The standard auto-import feature remains for legacy use and backward compatibility only,
and is replaced by the newer, more robust Kofax Capture Import Connector – XML feature
presented in Appendix B on page 181.
For example, you might have an application that polls a system folder for incoming faxes. When a
fax comes in, the application stores information about the images in a file. When a certain number
of faxes have come in or a certain amount of time has passed, the application launches the Scan
module to create the batch. Once the batch is created, it can be routed to other Kofax Capture
processing queues as defined by the batch class.
Note Refer to Appendix B – Using the XML Import Connector Feature on page 181 for information
about automatically importing information into Kofax Capture.
For example:
“Medical Forms”,“Plan Num”,“JM3891”,“Name”,“Lee”,“x:\reldocs\5.tif”
“Medical Forms”,“Plan Num”,“PB7930”,“Name”,“Smith”,“x:\reldocs\6.tif”
Note For the files to import, the total path and file name must be less than 127 characters.
Parsing Logic
When parsing the auto-import ASCII text file, Kofax Capture does the following:
Looks for the initial quotation mark
Looks for the first comma following the next quotation mark
Uses the value between the initial quotation mark and the last quotation mark encountered
before the comma, and ignores data outside the quotation mark pair.
In the following examples, the underlined text represents the values that Kofax Capture uses.
“index field name”, “associated index field value”,
However, you cannot embed a comma after an embedded quotation mark. For example, with the
following item in the ASCII text file:
“index field name”, “associated “index, field” value”,
An “Unable to determine index values for all specified index fields” error will be logged to the
auto-import log file. For this case, the batch will not be created.
For example:
[Options]
BatchName0=Import00-03/12/12
Description0=Patient medical forms
Priority0=4
BatchName1=Import01-03/12/12
Description1=Patient medical forms
Priority1=
Note that any parameter left blank will be set to the default value. For example, “Priority1=” from
the preceding example would set the priority of the batch to 5.
The name of the log file is Autoimpo.log, and it is stored in the same folder as the auto-import text
file. When importing image files only, you have the option of overriding the default log file name,
as shown in the sample .ini file format in Importing Image Files Only on page 179.
When an error occurs, a non-zero constant and an error message are logged to the file. When the
auto-import process is successful, a code of 0 (zero) is logged.
Where:
-i:Path\TxtFileName This is the path and file name of the text file that contains
the index data and the locations and names of the image
files to import.
-w:hWnd This is the window handle of the application to receive
an “auto-import is complete” message. Specify the
handle in decimal format, rather than hexadecimal. This
option is not required, but if specified, it requires a
message ID.
This form of notification is preserved for older
applications. Newer applications can use Windows
process synchronization facilities to achieve the same
effect.
-u:“UserID” Specifies the Kofax Capture user ID. If specified, the user
ID must be enclosed in quotes.
If the Kofax Capture User Profiles feature is enabled, the
specified user must have privileges to run the Scan
module and all of the batch classes used in the XML
Import Connector file. In addition, the password
parameter must be specified with the “-p” option
described below. If this is not the case, the error “User
not found” or “User not privileged” will be generated.
If specified, and User Profiles is not enabled, this
parameter will be ignored. The batches will be imported
and no message regarding User Profiles will be
generated.
If not specified, and User Profiles is enabled, the error
“User not found” will be generated.
-p:“Password” Specifies the password for the operator specified with the
“-u” parameter described above. If specified, the
password must be enclosed in quotes. A password must
be specified if a user ID is specified.
Passwords specified in the XML Import Connector file
are not protected. To preserve the integrity of the
password, you can protect your files with operating
system features. For example, you can store the files in
folders where only the desired users have read/write
privileges.
During the auto-import operation, the Scan module sequentially reads the entries in the text file
and imports all images into the same batch until a different batch class name is encountered. For
example, if the first 50 image files specified in the text file have the same batch class name, all 50
files will be placed in the first batch. If the next 25 image files have a different batch class name,
those files will be placed in a second batch, and so on. If a blank line is encountered in the text file,
a new batch will be started.
Note For the files to import, the total path and file name must be less than 127 characters.
10, 10 will be used for that batch. If no Priority entry is defined, Kofax Capture uses 5 as the
default.
The Priority entry also supports an entry of Low (9), Normal (5), or Urgent (2), to ensure
compatibility with Ascent Capture 2.x.
The PagesPerDoc entry overrides the default value defined for the batch class. If you do
not include a PagesPerDoc entry, your batch will contain the same number of documents
as you have files in your list (one document per file). Each document will contain the same
number of pages as its associated file. If the PagesPerDoc entry is “auto,” then auto-import
uses the separation method defined for the batch class in the Administration module.
The list of files (File0=, File1=, and so on) must be sequential. For example, if you have
five files to import, they must be listed in the .ini file as File0=, File1=, File2=, File3=, and
File4=. If your list skips a number (for example, your list goes file File0= to File2=),
processing will end after File0 is imported.
The LogFile entry allows you to specify a path and file name for the log file. If not
specified, the default name (Autoimpo.log) will be used. Refer to Auto-Import Log File on
page 177 for more information about the log file entries.
Required entries are the following:
BatchClass= or DocumentClass=
Image file names
The hWnd= entry and the MsgID= entry, if specified, must use decimal format, rather
than hexadecimal format.
Because Kofax Capture is a 32-bit application, the specified window handle must refer to
a valid 32-bit window handle. If a 16-bit application is used to specify a window handle,
the messages will not be returned successfully to the application.
Where:
-i:Path\INIFileName This is the path and file name of the .ini file that contains
the locations and names of the image files to import.
Auto-Import Issues
When using the auto-import feature, be aware of the following:
The auto-import process will stop if it detects a batch class defined as follows:
Batch class for which batch totaling is in effect
Batch class defined with batch fields
Batch class with multiple form types that use index values
Auto-import does not validate index values. The assumption is that a Validation queue
will be defined to process the values and allow for translation of invalid index values to
valid values.
Introduction
Kofax Capture Import Connector – XML is a newer alternative to the legacy standard auto-import
functionality described in Appendix A on page 175. Like standard auto-import, XML Import
Connector allows you to create batches by reading batch information from special-purpose files.
However, XML Import Connector differs from the standard auto-import in several ways, and
delivers a more robust method of importing batches.
In addition to loose pages and documents, you can import index field and batch field values. The
XML Import Connector process automatically validates batch field values according to the data
type and length settings for the fields, as specified in the batch class. Index field values are not
validated. You can also process index fields for which batch totaling is enabled.
As events or errors occur during the XML Import Connector process, they are written to an XML
Import Connector log file that allows you to monitor the batches imported into the system. Errors
are also written to the standard Kofax Capture error log and the XML Import Connector file. For
details, see Event Logging on page 207.
If you wish, you can use a customized program that gathers batch information and stores it in
special-purpose XML files to utilize XML Import Connector. If running as an unattended module,
a service, or a process, you can place the XML files in a directory that is polled at a specified time
interval. If running XML Import Connector on demand, you can process a specific XML file by
incorporating the command line into your program.
Note XML Import Connector is useful if you have a program that can generate XML files for you
and/or if you need to import your batches asynchronously. If this is not the case, it may be easier
to import data into Kofax Capture directly by writing a custom application using the Kofax
Capture Module Type Library. Refer to the Kofax Capture Developer’s Guide for more information.
The XML Import Connector unattended module can be launched using the –GUI option on the
command line or the XML Auto Import shortcut provided in the Kofax Capture program group
from the Start menu.
File Menu
Two options are available from the File menu:
Process Next XML File in Polling Directory
Use this option to immediately poll for the next XML file to process without waiting for the
next scheduled polling time. If XML files are found, they will be processed. As batches are
processed through the XML Import Connector module, information about the batches is
displayed in the Current Batch Information and Current Batch Progress areas on the main
screen. Refer to Polling Interval in Tools Menu below for more information about polling times.
If you launch the XML Import Connector module from the Start menu shortcut or you do not
specify a polling directory, the default directory (C:\Acxmlaid) is used as the polling
directory.
Between polling times, the amount of time (in minutes and seconds) that has passed since the
last poll is displayed in the status bar. Refer to Status Bar on page 184 for details.
Exit
Use this option to stop polling for XML files and exit the XML Import Connector unattended
module.
Tools Menu
The options on the Tools menu allow you to select a polling interval and the Auto-Scroll logging
option.
Polling Interval
As an unattended module, XML Import Connector requires no user intervention to process
XML files. Once started, it automatically checks (or polls) for XML files to process. The polling
interval is the amount of time (in seconds) between polling times. The default is 60 seconds.
Help Menu
The Help menu provides two options:
Kofax Capture Help Topics
Use this option to display online Help for XML Import Connector.
About Kofax Capture
Select this option to display information about XML Import Connector, such as the version
number of the software and copyright information. In addition, you can access the Kofax
Technical Support Web pages from the About box.
Event Log
As documents are processed, event messages are generated that describe the results of processing.
The messages are listed in the Event Log area at the bottom of the XML Import Connector module
main screen.
Tip Some messages may be too long to be completely visible in the Event Log area. For these
messages, you can double-click on them to display the complete message.
The event messages are also logged to the XML Import Connector log file. Note that if you launch
the XML Import Connector module from the Start menu shortcut or you do not specify a log file,
the default log file (C:\Acxmlail.txt) is used as the XML Auto-Import log file.
Status Bar
The status bar at the bottom of the XML Import Connector screen displays information about the
current action being performed by XML Import Connector. In addition, between polling times, the
time (in minutes and seconds) since the last polling time is displayed on the right side of the status
bar.
The general syntax for the XML Import Connector command line is as follows:
Acxmlai [Option]
All command options must be preceded by a hyphen. With the exception of the -Install option,
which must be used first if you plan on running XML Import Connector as a service, the options
can be specified on the command line in any order.
-ControlDir:directory Specifies the XML Import Connector control directory. The control
directory can be specified with an absolute, relative, or UNC path.
File names/paths containing spaces must be enclosed in quotes.
For example:
Acxmlai –Poll:60 –ControlDir:“C:\Control Dir” –
PollDir:“C:\Polling Dir”
If used, the XML Import Connector application will poll the
specified control directory. If a file is found, the application will
then attempt to locate a file with the same name and an “xml”
extension in the polling directory. If found, the XML file in the
polling directory is opened and processed. Note that files in
subdirectories will be ignored.
This option is useful when another process is submitting XML
files to the polling directory. It prevents the XML Import
Connector application from reading XML files in a partially
written state.
To use this feature, have your process write the XML file to the
polling directory first and then write a file to the control directory.
This will indicate that the XML file is complete and ready to be
polled. Note that the control directory file contents are ignored
and may be of zero length if desired.
After the XML file has been completely processed, the XML
Import Connector application will delete the file located in the
control directory. This will occur regardless of whether the XML
file was processed successfully or not.
If the specified control directory cannot be opened, it is created. If
not specified, the default directory (“C:\Acxmlaic”) is used. If the
directory is invalid and cannot be created, the application will
automatically shut down or stop the service, as appropriate.
This option is ignored if the –Poll option is not specified or
implied with the -Install or –GUI options.
-NoLogo Prevents the Kofax Capture splash screen from displaying when
the user interface is invoked with the –GUI option. For example:
Acxmlai –GUI –NoLogo
This option is ignored if the –GUI option is not specified.
-u:“UserID” Specifies the Kofax Capture user ID. If specified, the user ID must
be enclosed in quotes. For example:
Acxmlai –Install –u:“Joe” –p:“abcd” –Poll
If the Kofax Capture User Profiles feature is enabled, the specified
user must have privileges to run the Scan module and all of the
batch classes used in the XML Import Connector file. In addition,
the password option must be specified with the “-p” option
described below. If this is not the case, the error “User not found”
or “User not privileged” will be generated.
Note that the user ID and password are not shared with other
processes on the same computer. This is different from other
Kofax Capture modules where the user logged in can open other
modules for which he has rights.
If specified, and User Profiles is not enabled, this option will be
ignored. The batches will be imported and no message regarding
User Profiles will be generated.
If not specified, and User Profiles is enabled, the error “User not
found” will be generated.
-p:“Password” Specifies the password for the operator specified with the “-u”
option described above. If specified, the password must be
enclosed in quotes. A password must be specified if a user ID is
specified. For example:
Acxmlai –Install –u:“Joe” –p:“abcd” –Poll
Passwords specified in the XML Import Connector file are not
protected. To preserve the integrity of the password, you can
protect your files with operating system features. For example,
you can store the files in folders where only the desired users have
read/write privileges.
-modify Changes user profile settings for a service after it has been
installed. Use this command, along with -u and -p, to modify an
existing user ID and password. For example:
Acxmlai –modify –u:“NewUserID” –p:“NewPassword”
If you have multiple instances of a service installed, you can
specify the instance to change by adding a colon and the instance
ID number to the “-modify” option. For example:
Acxmlai –modify:2 –u:“NewUserID” –p:“NewPassword”
Refer to Multiple Instance Support on page 220 for more
information about installing multiple instances of a service.
-n Specifies that batches with errors are rejected and sent to the
Quality Control module. For example:
Acxmlai –Install –Poll –n
If not specified, batches with errors are deleted. For more
information about deleting batches, refer to Error Handling on
page 208.
For some fatal errors, the current batch is always deleted, even if
the “-n” command line option is used. Refer to Error Messages on
page 210 for more information about the types of errors for which
batches are always deleted.
-v Causes more details to be logged to the specified XML Import
Connector log file. For example:
Acxmlai –Install –Poll –v
If the “-v” command line option is not used, only basic event
information will be logged, which includes batch/file start and
end information and error messages. If “-v” is used, page and
document events will also be logged, which provides more
verbose log information.
Using this option could cause the log file to grow large quickly.
You should carefully monitor your log files and purge them as
necessary.
-l:logfile.txt Specifies the XML Import Connector log file name. It can be
specified with an absolute, relative, or UNC path. File names/
paths containing spaces must be enclosed in quotes. For example:
Acxmlai -i:XMLFile.xml -l:“C:\My Logs\Mylog.txt”
If not specified, or if the specified file cannot be opened, events
will be logged to the default log file (C:\Acxmlail.txt).
If the –LogMonthly option is specified, then this option is ignored.
Refer to Error Handling on page 208 for more information about
error logging.
-LogMonthly:directory Specifies the directory where the log file is to be written. All log
information is written to a file called XML_yymm.txt, where yy is
the last two digits of the year and mm is the current month. A new
log is created when an XML file is processed for a new month or
year. It can be specified with an absolute, relative, or UNC path.
File names/paths containing spaces must be enclosed in quotes.
For example:
Acxmlai –LogMonthly:“C:\XML Log”
This option overrides any log file specified with the –l option.
If a directory is not specified, the default directory
(“C:\Acxmlail”) is used. If the directory is invalid and cannot be
created, the application will automatically shut down or stop the
service, as appropriate.
-MoveSuccess:directory Specifies the directory to send XML files if batches in the XML file
were processed without errors. Note that any associated image
files are not moved. It can be specified with an absolute, relative,
or UNC path. File names/paths containing spaces must be
enclosed in quotes. For example:
Acxmlai –MoveSuccess:“C:\XML Success”
If a directory is not specified, the default directory
(“C:\Acxmlai\Success”) is used. If the directory is invalid and
cannot be created, the application will automatically shut down or
stop the service, as appropriate.
-MoveError:directory Specifies the directory to send XML files if errors occur while
processing the XML file. Note that any associated image files are
not moved. It can be specified with an absolute, relative, or UNC
path. File names/paths containing spaces must be enclosed in
quotes. For example:
Acxmlai –MoveError:“C:\XML Error”
If a directory is not specified, the default directory
(“C:\Acxmlai\Errors”) is used. If the directory is invalid and
cannot be created, the application will automatically shut down or
stop the service, as appropriate.
-DelSuccess Deletes the XML file and associated image files if all batches in the
XML file are processed without errors. For example:
Acxmlai –Poll –DelSuccess
This option will override the –MoveSuccess option, if specified.
-w:hWnd This is the window handle of the application to receive an “Auto-
Import is complete” message. Specify the handle in decimal
format, rather than hexadecimal. This option is not required, but if
specified, it requires a message ID.
Note that this form of notification is preserved for older
applications. Newer applications can use Windows process
synchronization facilities to achieve the same effect.
-m:MsgID Specifies the ID of an “auto import is complete” message, which is
sent to the window handle when the application is shut down.
Specify the message ID in decimal format, rather than
hexadecimal. Windows requires that this number be greater
than 1024. This option is required if a window handle is specified
with the “-w” option.
The XML Import Connector application uses the XML Import Connector file for input and output:
On input, it reads batch information to create batches.
On output, it writes status information for each batch in the XML file that indicates
whether the batches were processed. This prevents the XML Import Connector application
from attempting to duplicate a batch or generating errors if the XML Import Connector file
was previously processed. For details, see the <Batch> Processed attribute on page 195.
If errors occur during processing, error codes and messages are also written to the XML
Import Connector file. Refer to Error Handling on page 208 for more information about how
errors are handled.
Note In addition to writing attributes and error information, the XML Import Connector
application may change some of the non-essential characteristics of the XML Import
Connector file. For example, the resulting file may be slightly reformatted.
Refer to Elements and Attributes on page 191 for more information about the XML elements and
attributes that you can use in your XML Import Connector files.
Note A Document Type Definition (DTD) file named Acaidef.dtd is installed to your Kofax
Capture \Bin folder. The DTD file provides a formal description of the XML Import Connector
document’s structure.
In the XML Import Connector file, the top-level element is <ImportSession>, which is required.
All of the other elements in the file define one or more batches to import into the Kofax Capture
system. You use them as necessary to import your batches.
For example, if your processing requirements dictate that you import index values, you must use
the <IndexFields> container to hold one or more <IndexField> elements that define the index
values. Otherwise, you do not need to use the index field elements in your XML Import Connector
file.
Some of the elements support one or more attributes. An attribute (in the format attribute = “value”)
provides information about how its associated element is interpreted. For example, the <Batch>
element supports attributes that specify the name of a batch, the batch class for the batch, the
priority for the batch, and more.
For some of the attributes, values from the batch class or default values will be assumed. For
example, if you do not specify a name for your batch, the date and time that the batch is created
will be used. This is the default behavior in Kofax Capture, where the default name for a batch is
the date and time. As another example, if you do not specify a priority for the batch, the priority
defined in the batch class will be used.
For other attributes, errors will be generated if appropriate values are not supplied in the XML
Import Connector file. For example, the <Batch> element supports an attribute to specify the name
of the batch class to use for importing the batch. If you do not specify a valid batch class name, an
error will be generated and the batch will not be created.
Note Some of the functionality supported by the <ImportSession> attributes can be enabled with
command line options. However, the attributes set for the <ImportSession> element will override
the command line setting. Refer to Command Line Arguments on page 184 for more information
about the command line options.
UserID String Specifies a user ID for the XML Import Connector operation,
(Read) and is used if the Kofax Capture User Profiles feature is
enabled. It behaves the same as the command line option for
specifying a user ID (the “-u” option). Refer to Command
Line Arguments on page 184 for details.
Note that if the user ID is specified for the <ImportSession>
element and on the command line, the user ID specified for
<ImportSession> will be used.
LogFileName String Specifies the name of the XML Import Connector log file. If
(Read) not specified, or if the specified file cannot be opened or
accessed, events will be logged to C:\Acxmlail.txt. Refer to
Event Logging on page 207 for more information about
logging events and the XML Import Connector log file.
The XML log file name can alternatively be specified as a
command line option (the “-l” or “-LogMonthly” option). If
specified for <ImportSession>, this setting will override the
command line setting. Refer to Command Line Arguments on
page 184 for details.
In addition to the log file, XML errors are written to the
Kofax Capture log file. Most types of XML errors are also
written back to the XML Import Connector file. Refer to
Error Handling on page 208 for more information.
Name String(32) A unique identifier for the batch. You can specify up to 32
(Read) characters, and the name is not case-sensitive. If not
specified, the date and time when the batch is created will
be used.
If the batch name is a duplicate name, the error “Duplicate
batch name” will be logged and the batch will not be
created.
If the specified name is too long (more than 32 characters),
the error “Illegal batch name” will be logged and the batch
will not be created.
BatchClassName String The name of the batch class that defines how the batch is to
(Read) be processed in the Kofax Capture workflow. This must
match a valid Kofax Capture batch class.
If the batch class is not found, the error “Batch class not
found” will be logged and the batch will not be created.
Priority Integer The priority level for the batch, which impacts the order in
(Read) which the batch is processed by Kofax Capture modules.
You can specify a value from 1 to 10, with 1 being the
highest priority and 10 the lowest.
If specified, the value overrides the priority set in the batch
class definition. If the value is out of range, the error
“Illegal batch priority” will be logged and processing will
continue for the batch. The priority specified in the batch
class will be used. If not specified, the priority specified in
the batch class definition will be used.
RelativeImageFile String Specifies the relative path of each image file from the
Path (256) directory that contains the XML file.
(Read) It is important to understand that the path where the
image files are located must be based off of the relative
location of the XML file. Then, with the ImportFileName
element, you can specify a file name without giving a
complete path.
You can specify up to 256 characters, and the path is not
case sensitive. File names/paths containing spaces must be
enclosed in quotes.
If a folder is specified without a path, it is assumed that the
folder exists in the directory where the XML file is located.
For example, if the XML file is located at “C:\Polling Dir”
and the RelativeImageFilePath is identified as “Images”,
then the application will look in “C:\Polling Dir\Images”
for the image files.
Processed 0/1 The XML Import Connector application adds this attribute
(Write) to the <Batch> element to signify that processing has been
attempted for the batch. It is set to “1” regardless of
whether the batch is successfully created or processed with
errors.
If the XML Import Connector file is re-submitted, the XML
Import Connector application will skip any batches for
which Processed=1. This prevents a batch from being
duplicated or an error situation repeated.
Note that this attribute is never cleared or set to “0” by the
XML Import Connector application. If Processed is set to
“0” (manually or by another application), and the XML
Import Connector file is re-submitted, the XML Import
Connector application will attempt to process the batch. If
Processed is not specified, it will behave as if it has a value
of “0.”
<BatchField>
Each <BatchField> element contains information about a batch field, and supports the following
attributes. Note that some of the attributes are read during the XML Import Connector operation.
Other attributes are written by the operation.
Name String The name of the batch field to fill. If the name is not found
(Read) in the batch class, the error “Field name not found” will be
logged.
Value String(254) The value for the batch field. The value can be up to 254
(Read) characters in length. If the value is too long, or otherwise
invalid, the error “Invalid field value” will be logged.
<ExpectedBatchTotal>
Each <ExpectedBatchTotal> element contains a batch total field value, and supports the following
attributes. Note that some of the attributes are read during the XML Import Connector operation.
Other attributes are written by the operation.
Name String The name of the batch total field to fill. If the name is not
(Read) found in the batch class, the error “Field name not found”
will be logged.
Value Numeric The value of the batch total field. If the value is too long, or
(Read) otherwise invalid, the error “Invalid field value“ will be
logged.
The actual type of the field is specified in the batch class.
<Folder>... </Folder>
Each <Folder> element is a container for a set of Index Fields and/or Documents and/or Folders
elements, and supports the following attributes. Note that some of the attributes are read during
the XML Import Connector operation. Other attributes are written by the operation.
FolderClassName String The name of the Kofax Capture folder class that defines
(Read) how the folder is to be processed.
If the folder class is not found, then the error "Folder class
not found," is thrown.
ErrorCode Integer This attribute is cleared before processing the folder. After
(Write) processing the folder successfully, the attribute is not
present. If an error occurs while processing the folder,
then this attribute contains the error number of the error.
Error numbers and strings are defined in the section
below.
attributes are read during the XML Import Connector operation. Other attributes are written by
the operation.
FormTypeName String The name of the Kofax Capture form type associated with
(Read) the document. If this attribute is specified, but assigned an
empty string, the document is created with no form type.
If the form type is not found, the error “Illegal Form Type”
will be logged.
If this attribute is not specified, and only one form type is
possible for the batch class, that form type will be assigned
to the document. If not specified and multiple form types
are possible, the document is created with no form type.
<Page>
Each <Page> element specifies a file to import. It also acts as a placeholder for a file. If the input
file contains multiple pages, a corresponding number of pages is created in the location defined by
<Page>. Multipage non-image files (such as Microsoft Word documents) are always imported as
single pages. Note that some of the attributes are read during the XML Import Connector
operation. Other attributes are written by the operation.
ImportFileName String The name of the file to import. If no file name is provided,
(Read) or the file is not found, the error “Illegal File Name” will
be logged.
OriginalFileName String Use this optional attribute to specify the name and
(Read-write) extension of the imported file, if it is different than the
submitted image file name. This may be useful if files have
been transported over a network or over the Internet.
If the length of the string exceeds 250 characters (not
including the file extension) or contains invalid characters,
an error is generated.
<IndexField>
Each <IndexField> value specifies an index field value. An index field that is successfully
imported receives a confidence value of 100. This index field value is not overwritten if the batch is
subsequently sent to the Recognition Server. However, the parent document is still considered
“unprocessed” within the Validation and Verification modules.
IndexFields that are marked “required” in the batch class but do not receive a value from the XML
Import Connector file, do not cause an error. It is assumed that such fields will be entered in the
Validation module.
This same philosophy is applied to validating the value. Provided the value is smaller than the
maximum field size, it is accepted without any data type checking or user-defined scripting. It is
assumed that such checking is performed from the Validation module.
Note that some of the attributes are read during the XML Import Connector operation. Other
attributes are written by the operation.
Name String The name of the index field to fill. If the name is not found
(Read) in the batch class, the error “Field name not found” is
logged.
<Table>... </Table>
The <Table> element specifies a table in a document, and has <TableRows> as a child element.
Name String The name of the table definition for this table.
(Read)
Example 1
The following sample imports a single batch with two documents, including index fields. The file
name is specified for the first imported file using OriginalFileName. Separation and form
identification are explicitly specified by the list of <Document> elements, each containing a value
for the FormTypeName attribute.
<ImportSession>
<Batches>
<Batch BatchClassName="Orders" Priority="5">
<Documents>
<Document FormTypeName="NWForm">
<IndexFields>
<IndexField Name="Customer No" Value="AB123" />
<IndexField Name="Zip" Value="92606" />
</IndexFields>
<Pages>
<Page ImportFileName="c:\aXMLImages\NWest_1.tif"
OriginalFileName="c:\aXMLImages\NWest_A.tif" />
</Pages>
</Document>
<Document FormTypeName="TriForm">
<IndexFields>
<IndexField Name="Customer No" Value="EB456" />
<IndexField Name="Zip." Value="60478" />
</IndexFields>
<Pages>
<Page ImportFileName="c:\aXMLImages\TSpect_1.tif" />
</Pages>
</Document>
</Documents>
</Batch>
</Batches>
</ImportSession>
Example 2
The following sample imports a single batch with some batch totals and batch fields. All pages are
imported as loose pages. Because the <Batch> element’s EnableAutomaticSeparationAndFormID
attribute is set to “1,” automatic separation and form identification can occur during the import
process. To perform this type of processing, Scan-time document separation and form
identification settings must be enabled for the batch class. These include separating documents
based on a fixed number of pages, reading a particular bar code or patch code, or detecting a
separator sheet. Refer to Setting Up Your Batch Classes - An Overview on page 40 for more
information about batch classes.
In addition, the UserID and Password attributes are used for the <ImportSession> element. If the
Kofax Capture User Profiles feature is enabled, the specified user must have privileges to run the
Scan module and use the batch classes specified in the XML Import Connector file. Refer to
Chapter 4 on page 91 for more information about the User Profiles feature.
<ImportSession UserID=“GregF” Password=“abc*123”>
<Batches>
<Batch Name=“Sample2” BatchClassName=“Orders”
EnableAutomaticSeparationAndFormID=”1”>
<BatchFields>
<BatchField Name=“Company” Value=“Kofax” />
</BatchFields>
<ExpectedBatchTotals>
<ExpectedBatchTotal Name=“TotalPercentage” Value=“452” />
</ExpectedBatchTotals>
<Pages>
<Page ImportFileName=“c:\1.tif” />
<Page ImportFileName=“c:\2.tif” />
</Pages>
</Batch>
</Batches>
</ImportSession>
Example 3
The following sample demonstrates the use of folders in an XML file. It imports a single folder
class (Customer Information) with two index fields.
<ImportSession>
<Batches>
</Pages>
</Document>
</Documents>
</Batch>
</Batches>
</ImportSession>
Event Logging
During an XML Import Connector operation, events are written to an XML Import Connector log
file. By default, the log file is C:\Acxmlail.txt, although you can specify a different file if you wish.
Refer to the sections Command Line Arguments on page 184 and <ImportSession> ... </ImportSession>
on page 191 for more information about specifying a log file name.
The log file is opened when the XML Import Connector application starts, and closed when the
application closes. When open, the log file is not exclusively locked, which allows multiple XML
Import Connector sessions to write to the file at the same time. It also allows the log file to be
reviewed during auto-import sessions.
Events are written to the log file as they occur. Because of this, administrators who are reviewing
the XML Import Connector log file will always have up-to-date information, which could be
important in the event of a fatal error.
Note Event information is appended to the XML Import Connector log file. If multiple XML
Import Connector sessions occur at the same time, their events will be interleaved in the XML
Import Connector log file.
An example log file is shown below. This example shows the format of all the common events. The
start of the XML Import Connector application causes a blank line to be written to the log,
followed by the current date. All events are preceded by the current time.
5/5/03
06:10:45 PM Initiated polling mode on (C:\ACXMLAID)
06:10:45 PM Polled Directory (C:\ACXMLAID)
06:10:46 PM Opened XML file "C:\ACXMLAID\documentpages.xml"
06:10:50 PM Created batch, name "5/5/03 6:10:47 PM", class
"Order Forms"
06:10:53 PM Created document #1
06:10:53 PM Imported file "C:\Images\NWest_1.tif"
06:10:53 PM Closed document #1
06:10:53 PM Created document #2
06:10:53 PM Imported file "C:\Images\TSpect_1.tif"
06:10:53 PM Closed document #2
06:10:54 PM Closed batch "5/5/03 6:10:47 PM"
06:10:54 PM Closed XML file "C:\ACXMLAID\documentpages.xml"
06:10:54 PM Opened XML file "C:\ACXMLAID\loosepages.xml"
06:10:59 PM Created batch, name "5/5/03 6:10:54 PM", class
"Order Forms"
06:11:02 PM Imported file "C:\Images\NWest_1.tif"
06:11:02 PM Imported file "C:\Images\TSpect_1.tif"
06:11:03 PM Closed batch "5/5/03 6:10:54 PM"
06:11:03 PM Closed XML file "C:\ACXMLAID\loosepages.xml"
Note The example log file above includes entries for creating and closing documents. These
entries are only logged if the “-v” (verbose) option is used on the command line. Refer to Command
Line Arguments on page 184 for more information about running XML Import Connector and the
command line options.
If an XML formatting error is encountered, an event similar to the following is logged. This type of
message is generated by Microsoft’s XML engine, and typically indicates that an invalid construct
was encountered in the XML file. The message includes the line and column number where the
error was found. The message below indicates that an end tag was missing for a <Document>
element, and the error was found on or around line 20, column 9.
10:25:55 AM Error code 5, description "XML format error (c:\test.xml - End tag
'Documents' does not match the start tag 'Document'., 20, 9)"
Error Handling
If errors occur during the XML Import Connector process, error messages are logged to the Kofax
Capture error log file, the XML Import Connector log file, and (for most types of errors) the XML
Import Connector file. In addition, the default behavior is to delete batches for which errors occur
during the XML Import Connector process.
This section describes the types of errors that can occur, the format of the errors written to the
XML Import Connector file, and details about how XML Import Connector handles batches with
errors.
Types of Errors
The following types of errors can occur during an XML Import Connector process:
Note Page-level, folder-level, document-level, and batch-level errors are written to the Kofax
Capture error log file, XML Import Connector log file, and the XML Import Connector file.
Page-level errors: If an error occurs on a page (for example, the image file cannot be
found), the page will be rejected and a dummy page imported as a placeholder that you
can replace in Quality Control. The dummy page is a blank page with the following text
centered on the page:
“This page was intentionally inserted in the batch because of an XML Import Connector
error on this page.”
In addition, a rejection note that contains the error message will be created for the page.
Folder-level errors: If an error occurs for a folder (such as the folder class cannot be found),
the batch will not be created. No further processing will be done on the batch.
Document-level errors: If an error occurs for a document (such as an invalid form type),
the document will be rejected. A rejection note that contains the error message will be
created for the document. No further processing will be done on the document.
Batch-level errors: If an error occurs when setting a batch-related value (such as an invalid
batch field), the batch will be rejected or deleted. If the batch is rejected, an error message
will be associated with the batch. When the batch is opened in Quality Control, the error
message will appear in the title bar.
Application-level errors: If an error occurs for the application session (such as the XML
Import Connector file cannot be opened, the specified user ID is not valid, or some other
reason for which the application cannot run), the application will stop, and no batches will
be created. Errors will be written to the XML Import Connector log file and to the Kofax
Capture error log. However, application errors will not be written to the XML Import
Connector file.
Note Error messages are written to the XML Import Connector file for page-level, document-
level, and batch-level errors. Application-level error messages are not written to the XML Import
Connector file. Refer to Types of Errors on page 208 for more information about error types.
Refer to Examples of XML Import Connector Files on page 203 for more information about XML
Import Connector files, and the messages written to them after an XML Import Connector
operation. Refer to Error Messages on page 210 for more information about possible error
messages.
Note For some fatal errors, the current batch will always be deleted, even if the “-n” command
line option is used or the DeleteBatchOnError attribute is set to “0.” Refer to Error Messages on
page 210 for more information about the types of errors for which batches are always deleted.
If the batch with the error is not deleted, it will be rejected and routed to Quality Control, even if
partial batch export is enabled. Rejection notes are associated with the pages and/or documents in
error, with text in the following format:
XML Import Connector: [Error#] Error Message
For batch-level errors, error text is associated with the batch so that when the batch is opened in
Quality Control, the text will appear in the module’s title bar.
Error Messages
Table B-11 lists the error messages that are logged by the XML Import Connector application.
Note the following:
The “Applies To” column indicates the elements to which the error may be applied. When
the error occurs, processing of that element stops. The error is written to the Kofax Capture
log file, the XML Import Connector log, and to the ErrorCode and ErrorMessage attributes
for the element in the XML Import Connector file. Processing continues with the next
element in the XML Import Connector file.
If the “Applies To” column lists “Application,” processing of the XML Import Connector
file stops when the error occurs.
If the “DeleteBatch” column lists “Yes,” the current batch is deleted even if the “-n” option
is set on the command line or the <ImportSession> element’s DeleteBatchOnError attribute
is set to “0.”
Note For some fatal errors, the current batch will always be deleted, even if the “-n”
command line option is used or the DeleteBatchOnError attribute is set to “0.”
For more information about how errors are handled, refer to Error Handling on page 208.
5 XML format error (Error) No Application The XML file did not
contain XML, or the
XML was poorly
formed. A more
detailed error
message is provided
in parentheses.
11 Batch class not found Yes Batch The batch class name
(BatchClassName) specified is not found
in the current list of
published batch
classes.
25 Cannot move file (Source, N/A N/A The file could not be
Destination) moved to the success
or failure error.
29 Folder class not found Yes Folder The folder class name
(FolderClassName) specified is not found
in the current list of
folder classes.
Installing Services
Introduction
If desired, you can install and run XML Import Connector, Recognition Server, Kofax PDF
Generator, OCR Full Text, and Export modules as services. As services, these unattended modules
can be configured to start automatically at system boot, without any user intervention.
If you are using KCN Server, you can also install the Remote Synchronization Agent (RSA) as a
service.
The general steps for installing and running the unattended modules as services are listed below,
and described in more detail on the following pages. For more information about installing
unattended modules as services, refer to the Kofax Capture Installation Guide.
Note Be sure to read the instructions in the following sections carefully before you install and
configure a Kofax Capture service.
Step 1 Install Kofax Capture. Note that services do not support mapped network drives.
Therefore, for client/server installations, you must specify a UNC path for your
server installation directory.
Step 2 Set up your batch classes. For client/server installations, you must use UNC paths
during batch class setup to specify any folders or files to be accessed from a
network.
Step 3 Install the desired unattended modules as services.
Step 4 Configure the services for the unattended modules.
Step 5 Start/Stop the services for the unattended modules.
Note To obtain the UNC path, you can open Windows Explorer to locate your server
through Network Neighborhood or My Network Places. If you cannot find the UNC path
for your server, ask your system administrator.
3 Click Browse to select the UNC path for the desired server installation directory and then
click OK. The Select Destination Folder dialog box will be re-displayed with the UNC
path shown as the Installation Directory.
4 Click Next and complete the server installation.
In addition, to use any batch classes that already exist (for example, you import a batch class that
was previously configured), you must modify the path specifications for any folders or files to use
UNC paths.
Where:
Kofax Capture Installation Path or Kofax Capture Installation Server Software Path is the path to your
Kofax Capture installation.
Module.exe is the executable file name for the module you want to install as a service.
The following executables for the unattended modules are located in the Kofax Capture Bin
folder:
XML Import Connector acxmlai.exe
Kofax PDF Generator kfxpdf.exe
OCR Full Text ocr.exe
Recognition Server fp.exe
Export release.exe
Remote Synchronization Agent (RSA) acirsa.exe
Note that the quotation marks around the path and executable name are required, as shown in the
command line syntax. For example, if you installed Kofax Capture to the default client folder, and
you want to install Recognition Server as a service, you would execute the following command:
“C:\Program Files\Kofax\Capture\Bin\fp.exe” -install
Note You must be logged in to Windows with administrative rights to install services. In
addition, you must install the services on each workstation where they will run.
For example, with User Profiles enabled, you would use the following syntax:
“C:\Program Files\Kofax\Capture\Bin\module.exe” –install -u:“userID” -p:“password”
Note that the -install argument must precede the command line arguments associated with the
user ID and password. In addition, the quotation marks around the user ID and password are
required. For example, to install Recognition Server as a service with a user ID and password, you
would use the following syntax:
“C:\Program Files\Kofax\Capture\Bin\fp.exe” –install -u:“userID” -p:“password”
Note After you install a service with command line arguments, it can be viewed from the Services
utility. To maintain the security of your system, make sure that only privileged users are allowed
to log in to the workstation where you install the Kofax Capture service.
Once the successful installation message displays, the Kofax Capture service is installed. In
addition, the module will be listed in the list of Services displayed from the Windows Services
utility.
Note By default, the startup type selection is “Manual.” To configure a Kofax Capture service to
start automatically at system boot, you need to change the startup type to “Automatic.”
For the logon account, you must specify a Windows user account that is valid for the workstation
where you intend to run the Kofax Capture service. By default, all Kofax Capture services use the
LocalSystem account as the default user. It is recommended that you change this to be a standard
user account. If you are accessing resources in a network environment, be sure to specify a valid
network account. You cannot configure the service without a valid logon account.
Disabled: Disables the service. Select this option only if you want to temporarily
disable the service, without removing it.
When configuring a Kofax Capture service, you need to specify a logon account type.
Select the Log On tab from the Properties dialog box.
5 Provide a valid user account and password on the Log On tab.
At “Log on as,” select “This account.”
Enter the user account for the workstation where the service is installed. If the user
account is a network user, use: Domain\accountname
At “Password”, enter the password for the user account.
At “Confirm Password”, enter the user account password again.
6 Click OK to complete the configuration process.
If desired, you can use the Services utility to disable a service and run a Kofax Capture module
under the standard method. The service will not be restored until you enable automatic or manual
startup. For more information about other Services utility options, refer to the Windows online
Help or your Microsoft documentation.
Note The Pause/Resume/Continue functions in the Services utility are not available for Kofax
Capture services.
For example, to modify the user name and password of the OCR Full Text service that has been
previously installed with User Profiles, you would use the following command:
If you have multiple instances of a service installed, you can specify the instance to change by
adding a colon and the instance ID number to the -modify parameter.
For example, to modify the user name and password of the second OCR Full Text service that has
been previously installed with User Profiles, you would use the following command:
Refer to Multiple Instance Support on page 220 for more information about installing multiple
instances of a service.
To remove services, use a command-line argument to specify each service that you want to
uninstall. For instance, to remove the Recognition Server service, you would use the following
command:
“C:\Program Files\Kofax\Capture\Bin\fp.exe” –uninstall
If the service was started with command line options for user ID and password, be sure to include
the user ID and password arguments on the command line. Refer to Adding Command Line
Arguments for User Profiles on page 217.
The Multiple Instance Support feature allows you to install multiple instances of any Kofax
Capture service. This plays into the capabilities of multi CPU computers, so they can take full
advantage of their potential processing throughput. For example, a Recognition Server station
running on a dual-CPU computer can have up to eight instances of the service installed,
increasing the number of batches that station can process.
For each service, the maximum number of multiple instances allowed is four times the number of
physical processors on the computer.
For example, to install three instances of the OCR Full Text service, you would repeat the
installation command line three times:
“<Kofax Capture installation folder>\Bin\ocr.exe” -install
“<Kofax Capture installation folder>\Bin\ocr.exe” -install
“<Kofax Capture installation folder>\Bin\ocr.exe” -install
Each multiple instance of the OCR Full Text service is assigned a unique instance ID, as shown in
Figure C-1.
To install multiple services with the User Profiles feature enabled, use this same method of
repeating the installation command.
Refer to Removing Kofax Capture Services on page 220 for the removal procedure.
Licensing
When multiple services of the same kind are run on the same computer, a single Concurrent
station and Enterprise license are required. For example, a user would need both an Enterprise
license and a single Concurrent station license to run the OCR Full Text, OCR Full Text:2, and
OCR Full Text:3 services.
Introduction
Kofax Capture allows you to create custom modules and workflow agents to perform unique
functions suited to your business needs. Custom modules and workflow agents are often
registered using the Kofax Capture Extension Registration Utility. With KCN Server, since the
Administration module is disabled at all remote sites, you must use the registration utility to
register the custom modules and workflow agents.
This appendix describes how to register a custom module or workflow agent using the
registration utility designed for that purpose.
For more information on registering a custom module or workflow agent, see the Kofax Capture
online Help.
For details about creating and using custom modules with Kofax Capture, see the Kofax Capture
Developer’s Guide.
To run the custom module or workflow agent at a remote site, the appropriate custom module
executable (.exe) or workflow agent COM server (.dll or .ocx) must be installed on the local hard
disk drive at the remote site.
Note The custom module executable or workflow agent COM server must exist at a remote site
before the site can use it.
4 Register your custom module or workflow agent by executing the Kofax Capture
Extension Registration Utility, RegAscEx.exe. By default, this is located in the
<KofaxCapture installation folder>\Bin folder.
To register a custom module, enter the following:
RegAscEx.exe /f filename /m modulename
Where:
filename is the name of your registration (.aex) file
modulename is the name of your custom module
workflowagentname is the name of your workflow agent
If the modulename or workflowagentname are not provided, all custom modules or workflow
agents in the specified file will be registered.
A publishing, 79
setting up, 40
ACConfig.xml, 29 setting up for services, 216
Activate RSA, 140 using across regions, 40, 161
Administration module, 28 validating, 79
multiple system administrators, 28 Batch Contents panel, 34
overview, 19 Batch creation site, 122
Tools menu, 135 Batch fields, 74
aex files, 223 display labels for, 42
Assigned batch classes, 127 Batch Manager
Assigned batch classes tab, 126 Options menu, 139
Assigning overview, 138
batch classes to remote site profiles, 154 Batch Manager module, 19, 32
site profiles to remote sites, 158 Batch Processing dialog box, 142
Associated field in SmartGroups, 68 Batch Processing dialog polling settings, 141
Auto-foldering, 46 Batch routing, 150, 152
Auto-import, 175 overriding, 123, 128
image files and index data, 176 Batch routing tab, 125
image files only, 179 Batch separation
log file, 177 automatic, 89
parsing logic, 176 separator sheets, 32
Automatic synchronization, 163 unattended mode, 29, 35, 89
Batch upload settings, 134
B Batches
checking the status of, 168
Bar code recognition
unrejecting, 167
about, 57
uploading, 164
document separation with bar codes, 58
Black border
Enhanced bar code engine, 58
cropping, 55
modules that perform, 57
removal, 55
page-level bar codes, 56
Business continuity tab, 134
recognition profiles, 58
Standard bar code engine, 58
Batch Catalog database, 117 C
Batch class assignment, 24 Central site manager, 136
Batch class description box, 127 Central site profile, 121
Batch class override, 123 Centralized User Management, 100
Batch classes Check later button, 142
assigning default user groups, 107 Check now button, 142
assigning group profiles, 105 Citrix support, 25
assigning to a remote site profile, 127, 154 Color
assigning users, 103 color images, 79
checking user/group assignments, 108 color support, 79
conversion of regional settings, 41, 161 compression, 80
copying, 43 document separation with bar codes, 58
creating, 73 image cleanup, 83
downloading, 163 image quality, 81
naming, 74 sample pages, 82
processing queues, 73 Components
Assigned Batch Classes tab, 126 modifying with user profiles, 219
Batch Routing tab, 125 monitoring, 219
Business Continuity tab, 134 multiple instance support, 220
Licensing tab, 129 notification of success, 218
Polling tab, 132 overview, 215
Remote site profiles removing, 220
assigning batch classes to, 154 setting up batch classes for, 216
deleting, 158 starting, 219
modifying, 158 stopping, 219
Remote sites UNC paths, 216
assigning profiles to, 158 Windows Services utility, 218
removing, 159 with user profiles, 217
Remote Synchronization Agent Setting up batch classes, 40
activating on a remote site, 149 Site profiles, 158
authentication, 145 SmartGroups, 62
closing/stopping, 150 associated field, 68
credentials, 145 creating, 68
dialog box, 144 results, 69
displaying the version, 144 tree view, 69
installing as a service, 217 Softbridge Basic Language, 28, 87
opening the Technical Support Web page, 144 SQL Server database, 117
overview of menu options, 143 Standard bar code engine, 58
overview of system tray icon, 143 Statistics, user tracking, 173
restarting, 150 Status bar, 34
Removing a remote site, 159 Status option, 169
Repairing scanned images, 29, 31 Stopping RSA, 150
Rescan location, 122 Store batches in SQL Sever, 117
Restarting RSA, 150 Streak removal, 55
Retaining images, 122, 124, 126 Synchronizing
Routing batches, 122 activating RSA at remote site, 149
RSA automatic, 163
menu, 143 System log files, 114
using, 163, 164
Rubber Band OCR, 30 T
Table controls, 35
S
Table fields, 36, 59
Sample pages, 59 Technical support, 14
using image-only PDF, 86 Temporary image cleanup, 68
Scan controls, 35 Terminal services, 25
Scan module, 19, 29 Thumbnails, 37
Scanner Configuration Utility, 32, 81 Time
Scanner profiles, 88 converting across regions, 41, 161
locations, 89 Toolbars, 34
reverting, 89 Tools menu, 135
Scripts Tracking user statistics, 108, 173
custom, 87 Training, 14
import, 87 Translation, 41
recognition, 87 items not translated, 42, 162
Softbridge Basic, 87
validation, 87 U
SecurityBoost, 118, 119
Separator Sheet Utility, 32 Unattended scanning, 29, 35
Separator zones, 62 UNC format, 155
Services, running modules as Uninstalling, 185
command line, 217 Uploading batches, 164
configuring, 218 User activity
default user, 218 records, 109
error logs, 219 tracking, 108