› eCopy extenders › eCopy Forms Processing Extender › Template Design › Zone Properties

Zone Properties

Zone Properties consist of the following settings:

  • Main:
  • Name: The name of the zone. It is used to define the value of the field that will be referenced and passed to eCopy connectors. Tip: keep these names on a reference list for easier identification.
  • Type: The definition of how the zone will be recognized and what properties are available.
  • Value: The recognized value of the zone (appears only after the zone is drawn on the sample page form to the left).
  • Threshold (check zone type only): This value sets the ratio of shading required to trigger the value to true.
  • Coordinates:
  • Height: The height of the zone to be recognized.
  • Width: The width of the zone to be recognized.
  • X: The horizontal coordinate of the left side of the zone.
  • Y: The vertical coordinate of the top of the zone.
  • Advanced:
  • Confidence: The threshold that the recognition engine must meet. The value can be between 0 and 100. If the confidence value for the text in the zone is below this rating, the process will automatically report a Low Confidence error; thus, it can be used as an automatic validation tool. This property of Check zones has been removed because there is no relevant meaning.
    If a template with Check zone was saved with an earlier ShareScan version with "Low Confidence" error then loading such template would show that the zone still has "Low Confidence" error. However, clicking anywhere on the template image, saving the template or changing any zone property would trigger the update of the zone and the error message would disappear. After this, if the template is saved again, the error message will not appear next time when the template is loaded into the editor.
  • Drift (Static and Static Barcode only): Provides an extended area on the page that is searched for a static text value or a static barcode value. It is used to match values and identify the template.
  • Width is the adjustable horizontal size of the drift window.
  • Height is the adjustable vertical size of the drift window.
  • Error: Displays errors or warnings associated with the zone:
  • If there are no errors with recognition or an applied filter the display is "None".
  • "RecognitionError" is displayed if an error is encountered recognizing the barcode or during the OCR of text.
  • "FilterError" is displayed if the value in the “Value” field does not match the filter settings.
  • "LowConfidence" is displayed if the difference between the user-defined “Threshold” property and the recognized value on the scanned image is below the confidence value.
  • Barcode and Static Barcode fields display an additional advanced property, “Barcode Type”.
  • Barcode Type: Select the barcode encoding used for the zone.
  • Reference Zone: A defined static zone. It is used to locate the text or barcode. If the Reference Zone moves on the page all fields that reference it are adjusted to accommodate for the movement.
  • ShowValue: The True/False field specifies if the field will be displayed on the validation screen.
  • Filter: Allows the entry of a regular expression or database lookup to validate data that was OCR-ed from a zone. A regular expression filter sample is provided in the Step by Step Invoice Example section of this guide.
  • Regular Expression: For details see pages like www.regular-expressions.info for information on building regular expressions.
  • ODBC query: these filters are used by the system to connect to a database and run simple queries. If the recognized text of the zone is included in the result list of the query, then the filter criterion is considered met; if not, a Filter failed error message is displayed. To use it, you have to enter the following data:
    • Connection String: SQL connection string, used to connect to the database. For example, an MS SQL Server 2008 connection string has the following format: Driver={SQL Server Native Client 10.0}; Server=<your IP address or DNS>; Database=<your database name>; Uid=<your user account>; Pwd=<your password>;
    • Query: enter an SQL query, which, when run, will compile the value list used to check the recognition results. The query may contain a ##value## constant, which denotes the value recognized for the zone. For example:SELECT Value FROM dbo.CustomValuesWHERE Id <> ##value##
    • Test: Displays the results of the query prior to saving the filter settings.

Zone Properties can be viewed in categorized or alphabetical order.