SetFldConfidence

Syntax

bool SetFldConfidence (StrParam)

Parameters

A comma-separated value that consists of:

1. The field name, or a Smart Parameter that designates the field.
2. The confidence value (1-10) to be assigned to the field's characters.

Returns

Always True. If an input parameter is invalid, no confidence levels are changed and a message is logged.

Level

Field level.

Details

This action unconditionally sets the confidence values for every character within a field to a specific level. This action can help change confidence levels when the preceding actions are all successful.

For example, a successful set of calculations that involves one or more fields might indicate that the confidence level of those fields' values ought to be high, regardless of the confidence set by the recognition engine. After the success of the calculation, you can call SetFldConfidence to unconditionally reset the confidence values of the fields.

The first parameter is the name of the field that has its confidence level set. The second parameter is the wanted confidence level, between 1 and 10. If the second parameter is not passed in, 10 is used as the default.

Example:

Example 1:
To set all characters in the field "GrossSalary" to a confidence of 9.
SetFldConfidence(@P\GrossSalary,10)

Example 2:
To set all characters in the field "AdjustedPay" to a confidence of 1.
SetFldConfidence(@P\AdjustedPay,1)

Example 3: 
In the context of a test run before setting the confidence.

Calculate("'1TotalWages' + '2TaxableInterest' + "3Unemployment' = '4AdjustedGross'")

If this calculation works, the application can assume that all of the characters are read correctly 
and SetFldConfidence can adjust the fields to high confidence.

Note, you might also want to add a check that the values are all non-zero to eliminate a bad read.
SetFldConfidence("@P\1totalWages,10")
SetFldConfidence("@P\2TaxableInterest,10")
SetFldConfidence("@P\3Unemployment,10")
SetFldConfidence("@P\4AdjustedGross,10")