validationOrder

You can use the validationOrder property to specify the order in which validation is performed on a field. The property is important if the validation of one field depends on the previous validation of another.

The value is a literal integer.

Validation is a two-stage process:

In the first stage, EGL performs the following actions for a single field, then moves to the next field and performs all the actions for that field. The process continues until all actions have been performed for all fields:
  • Strips formatting characters such as the currency symbol and numeric separators from all fields
  • Performs any required formatting specified in properties such as align, lowercase, and uppercase
  • Formats date/time fields
  • Checks the inputRequired property for all fields
  • Verifies that the data in all fields has the correct type; for example, alphabetic characters are not permitted in a numeric field.
  • Validates the field as directed by any of the following properties, in order:
    • isDecimalDigit
    • isHexDigit
    • minimumInput
    • needsSOSI
    • validValues

    Not all properties are valid for all UI technologies.

  • Checks the field against a validatorDataTable, if one is specified for the field

If no errors are found in any of the fields, EGL proceeds to the second stage, where it performs any validation specified in the validatorFunction property for the field.

The validationOrder property has the following effect:
  • Validation occurs first for any fields for which you specified a value for the validationOrder property, and the items with the lowest-numbered values are validated first.
  • Validation then occurs for any items for which you did not specify a value for validationOrder, and the order of validation in this case is the order in which the fields are defined in the VGUI record. For text forms, the default validation order is the display order or the position on the screen from upper left to lower right.

Compatibility

Table 1. Support for validationOrder property
Data item Rich UI Handler VGUI Record Console UI Text Form Java™ Text Form COBOL Print Form Java™ Print Form COBOL
Yes No Yes No Yes Yes No No