Welcome > User interface > Forms > Toolbox > General controls > Capture controls

Capture controls

TotalAgility provides the following capture controls.

  • Text field

  • Check box

  • Combo box

  • Table

You can open a capture form in design view and configure these controls.

Properties of capture controls

The following capture controls have some specific properties in addition to the other general properties of the control.

Note The Read-only property is not available for Verification and Document review forms.

Capture Text field
Preserve line breaks

Allows preserving line breaks for a multi-line field when lassoing, so that the line breaks are preserved when data is populated in the field.

Note This property is only available if the Multiline option is selected.

Auto complete

If selected, allows the field to complete automatically.

Ignore case

If selected, allows the field to accept letters in uppercase and lowercase. By default, the text field is case-sensitive.

Field name

A meaningful name of the field to display at runtime. For example, Customer name instead of Field1.

Capture Combo box
Behavior

Specify whether the value of the combo box at runtime can be a custom value or from a predefined list.

  • Free content: Allows to enter a value into the combo box.
  • Restricted content: Allows to select a value from the available list.

Note For Capture Combo box, if the options list is populated on loading the Document or Folder type forms, you need to reapply the value so that Combobox displays the text instead of the value.
Field name

A meaningful name of the field to display at runtime.

Capture Table (Column)
Multiline

If selected, handles text that may go beyond one line, such as customer address.

Preserve line breaks

Allows preserving line breaks for a multi-line field when lassoing, so that the line breaks are preserved when data is populated in the field.

Note This option is available only when the Multiline option is selected.

Behavior

The behavior of the Table. Available options are:

  • Free content: Allows the user to enter a value into the table at runtime.
  • Restricted content: Allows the user to select a value from the available list at runtime.

Display mode

The mode in which the text is displayed in a table at runtime. Available options are:

  • Text: Displays only the text.
  • Value and text: Displays both the text and the value.

Dynamic data source

A dynamic data source for choice type of column.

Once a dynamic data source is assigned, it will take precedent over any static or lookup defined in the extraction group.

Form action types that can be used for dynamic data source are:

  • .NET method

  • Web service

  • DB query

Note
  • A capture Table control is not displayed on Folder, and Document verification forms.
  • If any fields in a capture Table control are set as hidden or read-only, the system can possibly prevent a user from completing a Validation activity. The reason is that when a user adds a row to a table, all the cells in that row are marked invalid (including any hidden or read-only cells). As a result, all the visible cells in the table do not mark the table as valid and the user is not able to complete the Validation activity.
  • If you want to hide fields from one user but make it visible to others, you either define the hidden field as ‘Always valid’ (see Configure validation for document fields) or define validation rules that run during the ‘Add table row’ event that will set the valid flag as ‘true’ for hidden and read-only cells (see Add field validation for document fields.)
  • You can add a Mini-viewer for a capture field in a Document form.