> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom recognition script

> Define a custom recognition algorithm for fields with regions in ABBYY FlexiCapture, returning IValue results and marking suspicious characters.

## What it does

With this script you can define a custom recognition (or initialization) algorithm for fields which have regions.

The custom recognition script is configured on the Recognition tab of the field properties dialog box.

The script is launched when a field value is initialized from the results of the recognizer. The image area being recognized is passed to the script as an input parameter. The document layout is not initialized at the moment, so access to the document fields is denied (however access to registration and other parameters is allowed).

With this script you can specify which symbols are suspicious and must be verified (**IsSuspicious** and **NeedVerification** properties).

## Parameters

<table width="100%"><thead><tr><th style={{textAlign: 'left'}}><p><strong>Name</strong></p></th><th style={{textAlign: 'left'}}><p><strong>Type</strong></p></th><th style={{textAlign: 'left'}}><p><strong>Access</strong></p></th><th style={{textAlign: 'left'}}><p><strong>Description</strong></p></th></tr></thead><tbody><tr><td><p>FieldRegion</p></td><td><p><a href="/flexi-capture/appendix/scripts/ifieldregion">IFieldRegion</a></p></td><td><p>Read-only. Internal<a href="/flexi-capture/appendix/scripts/script-recognition#asterisk">\*</a> fields of batch documents and pages are unavailable. (Applies to all parents as well.)</p></td><td><p>The region to be recognized</p></td></tr><tr><td><p>Result</p></td><td><p><a href="/flexi-capture/appendix/scripts/ivalue">IValue</a> /<a href="/flexi-capture/appendix/scripts/icheckmarkvalue">ICheckmarkValue</a> /<a href="/flexi-capture/appendix/scripts/icheckmarkgroupvalue">ICheckmarkGroupValue</a></p></td><td><p>Read/write.</p><p>Access to the CharacterParams.NeedVerification flag is denied.</p><p>CharacterParams.IsSuspicious flag is available with read/write permissions.</p></td><td><p>The resultant recognized value. Depending on the field type the received parameters can be of the following types:</p><ul><li><a href="/flexi-capture/appendix/scripts/ivalue">IValue</a> - for text fields</li><li><a href="/flexi-capture/appendix/scripts/icheckmarkvalue">ICheckmarkValue</a> - for checkmarks</li><li><a href="/flexi-capture/appendix/scripts/icheckmarkgroupvalue">ICheckmarkGroupValue</a> - for checkmark groups</li></ul></td></tr></tbody></table>

<a id="asterisk" />\* - The internal field requires loading the object into memory.

If classes and methods of an [external assembly](/flexi-capture/appendix/scripts/user-assembly) are used in the script, the assembly file must be attached on the .NET References  tab of the  *(Developer)* Document Definition properties. *(Administrator)* [Document Definition properties](/flexi-capture/templates/template-properties).

## (Administrator) See also:

*(Administrator)*  [Text field recognition options](/flexi-capture/templates/properties-recognition-text)
