User Tools

Site Tools


Guide Section: Processing Events and Performing Actions | EASAP Tree: Event Processing Branch

ERROR CHECK defines custom error checks that go beyond the normal error checks, for example bounds checking, that are performed automatically by an EASAP. Some use cases for ERROR CHECK are as follows:

  • To compare the values of multiple objects
  • To check the value of a TEXTBOX for accuracy
  • To provide additional bounds checking on a REALBOX or INTEGERBOX by explaining the need for the bound, or by showing only a warning as opposed to an error that must be fixed.

ERROR CHECK has two methods for defining the check that it will perform:

  1. Use a logical expression in Show if: to define an error condition. If this expression evaluates to TRUE, then there is an error and the error message will be displayed.
  2. Use a Regular Expression in Regular Expression: to pattern match the value of an object specified in Object:. You can set whether a match represents an error condition, the default, or not an error condition by setting Match:.

The first method is most often used for the matter of mathematical equality, such as equal to ( == ), not equal to ( != ), less than ( < ), greater than ( > ), etc. The second method is most often used to validate text, such as the values of TEXTBOX and TEXTAREA.

Essential Parameters:
Title:Title of error message
Error Message:Text of error message displayed when check finds an error
Type:Select type of error check (Error_Message, Information_Message, Warning_Message)
Optional Parameters:
Show if:Logical expression, if TRUE then error message displayed, if FALSE then error message NOT displayed
Regular Expression:Regular Expression to be matched against value of Object:
Object:Select object to check with Regular Expression:
Match:Select whether a match or a non-match in Regular Expression: should cause error (default→TRUE, FALSE)
Delimiter:Character to act as delimiter in Title: and Error Message: (default→%)