Validation
Configure validation rules on document fields to determine whether a field is valid or invalid. You can associate multiple validation rules with a document field, and also associate global or local field validators to a document field.
If any field in a table is set as hidden or read-only, you may not be able to complete a validation activity. This is because, when you add a row to a table, all the cells including any hidden or read-only cells in that new row are marked as invalid. As a result, the table is not marked as valid and you cannot complete the Validation activity.
If you want to hide fields from one user but display to others, you must do either of the following:
-
Define the hidden field as
Always valid
. -
Define validation rules for the
Add table row
event that will set the valid flag as true for the hidden and read-only cells. See Configure field validation rules for a document type.
Configure validation for document fields
- On the document type field group, select the field for which to configure a validation rule.
- In the properties panel, click the Validation tab.
-
A child document type inherits a field group with all its
fields including the properties from the parent document types. Select
Override parent rules
to override the parent document type rules. (Default: Clear)
Note This option is only available for inherited document fields.
-
To manually validate a field, select
Require manual field
confirmation. (Default: Clear. The default value is based on the
parent value, but can be overridden.)
Note Validating a field manually is useful if the contents of the field must be accurate with no margin for error.
- To allow a field to be always valid, select Always valid. (Default: Clear. The default value is based on the parent value, but can be overridden.)
-
To add field validators, do the following:
-
Click
for
Validators.
The Add field validators dialog box is displayed.
-
Add the local and global field validators as needed.
Click Add all on the Local field validator tab or Global field validator tab, to add all the validators from the respective tabs.
The selected validators appear in the Selected items box.
To remove a validator, in the Selected items box, click for the validator to delete. To delete all validators, click Remove all.
-
Click
Done.
The field validators appear in the table. You can delete a field validator from the table.
-
Click
for
Validators.
-
To change the order in which
TotalAgility
executes validation rules, use the
icons.
At runtime, the validation rules are executed based on the order specified.
- Save or release the extraction group.