Field Properties

Select a field on the form or insert a new field to display the Field properties for the properties pane. By default a field is displayed as a text box. You can change the Display style to either Combobox or Checkbox. Depending on the selected style the properties pane changes.

Auto Complete

This group has the following options:

Auto complete

Automatically completes the text the user has typed in a text field. For the purposes of completion, the text is compared to the recognition results of the current document page. To activate this functionality for a Textbox field, select TRUE. The value for this option is set to FALSE by default.

Note Case sensitivity is used by default. To ignore case sensitivity, set the Ignore case property to TRUE.

If the Display style property is either set to Combobox or Checkbox, the property is not visible.

Ignore case

This property is used in conjunction with Auto complete. By default, case sensitivity is taken into account for auto completion, when user input text is searched within the recognition results of the current page, so this property is usually set to FALSE. To ignore case sensitivity, set this property to TRUE. The value for this option is set to FALSE

Note This property is only visible when the property Display style is set to Textbox. When the Display Style is set to either a Check box of a Combo box, this property is not visible.
Default Area

This group has the following options:

Height

The height of the default area (in pixels). You can change it by adjusting the zone on the validation form. If no area is defined or activated the value is set to -1 by default.

Left

The left corner of the default area (in pixels). You can change it by moving the zone on the validation form. If no area is defined or activated the value is set to -1 by default.

Page

Select First page, Second page or Last page to activate the default zone for the selected field. In Validation, this area is shown in the viewer when no extraction result is found on the document for the field. If <none> is selected, either no default area is defined or the area is not activated.

Top

The top of the default area (in pixels). You can change it by adjusting the zone on the validation form. If no area is defined or activated the value is set to -1 by default.

Width

The width of the default area (in pixels). You can change it by adjusting the zone with the mouse on the validation form. If no area is defined or activated the value is set to -1 by default.

General Field

This group has the following options:

Field name

Read-only property that displays the name of the selected field.

Font

Select the font options that are used to display field content.

Read-only

The default value is FALSE. Select TRUE from the list to prohibit editing of the field in the Validation module. When you save the project and the fields properties do not have the option Always valid selected, a warning is displayed, "Potential problem in validation caused by a read-only field." as read only fields need to be set to Always valid in the field properties. The value for this option is set to FALSE by default.

Note Read-only fields are grayed on a validation form.
Layout

This group has the following options:

Location

Displays the x and y values for the location of a field on the validation form (in pixels).

Size

Displays the field width and height in pixels.

Miscellaneous

This group has the following options:

Anchor

To change the anchor settings click the arrow next to the list and click the positions where you want to place the anchor. The property is visible only for elements that are located on the validation form and not for the folder pane on the validation form. The value for this option is set to Top, Left by default.

Right-to-Left

Toggle the direction that text is displayed. Set this property to TRUE if you are using a language that is written from right to the left. The value for this option is set to FALSE by default.

Style

This group has the following options:

Display style

A field can either be shown as normal text box, check box, or a selectable list. Select a style from the list. Depending on the selection additional options are displayed.

Textbox

By default, auto completion is not activated for text fields and the value is set to FALSE. To activate auto completion for a field, change it to TRUE.

You have to activate auto completion for each field separately. For a large number of fields this may be very time consuming, but you can however, access this property via script by changing the property value when a document is loaded. See the Scripting - Object Reference Help for further details.

Checkbox

Select this display style to show a field as a check box on the validation form. Make sure that if you use OCR results to fill this field the values match. For example, by using the result of an OMR zone. If necessary, use scripting to provide the correct values and to implement any special processing when the check box is selected or cleared.

Combobox

The Combobox settings properties are only visible when you select the Combobox value for the Display style option. The following options can be set.

Style

Select the style to apply to your combobox.

  • Selecting the Fixed List option enables the Values option and disables the Item delimiter and Dictionary options.

  • Selecting the Fill in Script option enables the Item delimiter option and disables the Values and Dictionary options.

  • Selecting the Dictionary option enables the Dictionary option and disable the Values and Item delimiter options.

The value for this option is set to Fixed List by default.

Important Thin Client Validation supports lists with up to 10,000 entries. Thin Client Validation separates lists with more than 1000 into pages. This page breakdown ensures that form loading is not delayed due to large dictionaries or lists. When users expand the list, they can page through the entries using the navigation buttons at the bottom of the list.
Behavior

Select Free content if any content is allowed, or Restricted content when a user can only select an item from the list. The value for this option is set to Free content by default.

Item delimiter

If the Style option is set to "Fill in Script", this option is available. Specify a character that separates the combobox entries. The value for this option is set to a semicolon (;) by default.

Dictionary

If the Style option is set to "Dictionary", this option becomes available. Select a dictionary in the list to display the dictionary in a combobox. To load a dictionary, change dictionary settings, or add dictionary settings, open the Project Settings and select the Dictionary tab.

Use descriptions

If the Behavior option is set to "Restricted content", this option is enabled. Set this option to TRUE to provide a description alongside the values in the list.

For example, by showing the name of the city for an area code that must be selected (Belden|530, Beleverde|415, California City|760) a description helps a user select the correct value.

When set to TRUE, this option displays descriptions and their values in the list. If this option is set to FALSE, only values are displayed. The value for this option is set to FALSE by default.

Note If a dictionary is used and has "The import file contains auto replacement values" and the Field delimiter options specified in the Dictionary Options window, the "Word" entries are the combobox description and the "Replacement Text" column are the values saved in the XDocument.

This is true even if the Use descriptions option is cleared.

Description/Value delimiter

If Use descriptions is set to TRUE, this option is enabled. Specify the delimiter that separates descriptions and values. You cannot use the same character as the character defined for Item delimiter. You can use only one character. The value for this option is set to Pipe (|) by default.

This option is disabled when the Style is set to "Dictionary", even if the Behavior is "Restricted content" and the Use descriptions option is "TRUE".

Display delimiter

If Use descriptions is set to TRUE, this option is enabled. Specify the delimiter that separates descriptions and values when displayed in the list on the validation form. The value for this option is set to [space]Pipe[space] ( | ) by default.

Show description and value

If Use descriptions is set to TRUE, this option is enabled. If this option is set to TRUE the description and its value are displayed in the list. If this option is set to FALSE, only the description is displayed. The value for this option is set to TRUE by default.

Sort by description

If the Use descriptions is set to TRUE, this option is enabled and the content of the list is sorted alphabetically by the description. If this option is set to FALSE then the list is displayed as defined via script or within the String Collection Editor window. The value for this option is set to TRUE by default. The default value can be changed only if Use descriptions is set to TRUE.

Values

This option is enabled when the Style option is set to "Fixed List". A small window is displayed if you click the button to the right of the field. The window enables you to enter a list of values (and descriptions, separated by the Description/Value delimiter) displayed in the list.

You can use scripting to implement any special processing when combo boxes are used on the validation form. Sample projects are provided for more information. You can also see the Scripting Help.