Kofax Getting Started with Ascent Xtrata Pro - Manual (Page 131)

Chapter 4
112 Ascent Xtrata Pro User's Guide
Note
When you overwrite an inherited locator locally in a subclass, you must make
sure that the local locator provides the same subfields as the locator in the base class
does. Otherwise it is possible that an inherited assignment to a field cannot be
resolved anymore. This may then lead to an extraction error.
Example: There is an advanced zone locator defined in a base class that creates two
subfields S_A and S_B. They are assigned to the fields F_A and F_B respectively. The
base class has a subclass where the locator is locally overwritten with a format
locator called “FormatLoc.“ “FormatLoc“ is assigned to Field F_B. If you extract a
document with the subclass, you will see an error because Field F_A inherits a
locator assignment (to S_B). But locally, the format locator does not provide this
subfield anymore.
Field Formatting
Field formatters are used to normalize and validate the format of information
extracted from a document based on predefined formats. Field formatters can be
used for simple fields as well as for table fields.
For a simple field, you assign one formatter to the field, whereas for table fields, you
assign a formatter to each column. For table fields, the formatter is processed for the
cells in each detected table row.
The following formatter types are available:
• Amount Formatter: To normalize and validate amount formats on the
document.
• Date Formatter: To normalize and validate date formats on the document.
• Percentage Formatter: To normalize and validate percentage formats on the
document.
• Script Formatter: To normalize and validate any other kind of formats using
the Sax Basic script engine.
A formatter reformats the extraction result for a field and assigns it to the field.
Additionally, it sets properties for specific formatters as listed below:
• DoubleValue property for the Amount and Percentage Formatters
• DateValue property for the Date Formatter