Conditional fields

Conditional fields allow an option to be switched on or off depending on specified criteria.

Conditional fields are used mostly for Activate and Pass through options. Choose one of the following states to enable or disable an option

  • Yes enables the option.
  • No disables the option.
  • Enter a custom condition. The condition should be specified in the form of the expression which is interpreted as common Boolean value: TRUE, YES, ON, 1 or FALSE, NO, OFF, 0.

    The expression has C-like syntax and is evaluated based on operators and operands. The expression is case-insensitive. If you enter invalid condition, the option becomes disabled by default.

Examples of simple expressions:

Expression Description
YES

The option is always enabled.

NO

The option is always disabled.

~CMP::SomeRrt~

The option is enabled if some component replaces the RRT ~CMP::SomeRrt~ with one of TRUE, YES, ON, or 1.

When you enter one of the Boolean constants FALSE, NO, OFF, 0, all the options in the component configuration become disabled. If you enter any other expression which is interpreted as Boolean NO (FALSE) or as an invalid condition, the component configuration allows you to manipulate the settings, but the component remains inactive at run time.

Examples of complex expressions:

Expression Description
~FRO::PagesCount~ < 50

The option is enabled if the number of pages in the input file of the OPOCR component is less than 50. Use an expression like this one to check values that are only available during processing.

"Y" + "e" + "S"

The option is always enabled, because the result of this expression is string "YeS". This string is interpreted as Boolean YES (TRUE).

("~PCF::FileName~" >="a") & ("~PCF::FileName~" < "e")

The option is enabled if input file name starts from "a", "b", "c" or "d" (case-sensitive).