XFA Specification
Chapter 9, Automation Objects
Validations
303
nullTest
The
nullTest
attribute on the
validate
validation test is applied to the form:
disabled
The form object is permitted to have a value of null; that is, the field can be left without a value,
and it will not negatively impact the validity of the form. This attribute value disables this
validation test.
warning
The form object is recommended to have a non-null value. If the user does not supply any value
for the form object or explicitly sets the value to null, the processing application will present the
warning message.
The message must inform the user that the form object is recommended to
have a value, and provide two choices:
dismiss — The user understands the form's recommendation and wishes to return to the form, so
that s/he may satisfy this constraint.
override — The user understands the form's recommendation, but has chosen to contravene this
constraint.
error
The form object is required to have a non-null value. Failure to provide a non-null value shall
constitute an error. The processing will present an
error message,
and the form object considered
invalid. XFA application may skip the remaining validations for the field or exclusion group.
Datatype test
This test is implied by the existence of a datatype element (i.e.
integer
and
float
) within the field’s
value
element. The error messages generated when the datatype test fails are application-specific, and
the error handling is equivalent to a level of
error
. That is, if the datatype test fails, the form object is
considered invalid.
formatTest
The
formatTest
attribute on the
validate
validation test is applied to the form:
disabled
the form object is permitted to have a value that does not conform to the input mask; that is, the
field can be left with a non-conformant value, and it will not negatively impact the validity of the
form. This attribute value disables this validation test.
warning
The form object is recommended to have a value that conforms to the input mask. If the user does
not supply such a value, the processing application will present the warning message. The
message must inform the user that the form object is recommended to have a value that
conforms to the input mask, and provide two choices:
dismiss — The user understands the form's recommendation and wishes to return to the form, so
that s/he may satisfy this constraint.
override — The user understands the form's recommendation, but has chosen to contravene this
constraint.