User Guide and Reference

Error

Hide Navigation Pane

Error

Previous topic Next topic No directory for this topic  

Error

Previous topic Next topic Topic directory requires JavaScript JavaScript is required for the print function  

Error Business Rules will, on error, prevent the user from submitting the form.

 

The rule has more settings than the General Purpose business rule properties. The visibility rules in particular can cause confusion if not properly understood.

 

Focus Field Target

 

The rule fires when the user focus becomes the nominated field and whenever the value of the field changes. The rule can be set to "Run Only When Visible" (which is the default setting) or "Run Always". The nominated field will display the warning background colour while the rule is in error.

 

Clearing Policies

 

See Privacy on the privacy considerations that dictate data clearing policies. Note the distinction between "Clear Hidden Data on Submit" and "Clear Data When Hidden".

 

The distinction may seem trivial if we consider only the form's data at the point of user submission. However, when one of  form's Business Error Rules is dependent on a field that happens to be hidden, and that field is causing the rule to be in error, that hidden field would prevent the user from submitting the form, even though all the visible data is suitable for submission.

 

So, this is the reason for the distinction between "Visibility Data Clearing Policy" and "Editable Clearing Policy" in the rule's properties.

 

The Display of Errors

The default display of form errors is the standard footer of the typical template. The same structure is also available with the Error List Predefined Block. The errors are listed in a clickable list; double-clicking on a list item takes users to the form element needing recitification. You also can write the explanatory text displayed as well as the error messages themselves. You therefore have the tools to assist users though the process and, therefore, minimise the rate of form completion failures.

 

The Form can display both errors and warnings through the Error and Warning Predefined Block. Users can scroll through wither the errors or the warnings using next and previous links.

 

The Error Selection Block displays both of these blocks, one on top of the other.

 

The Edit Properties -> Rules tab of the Error Business Rule can also be set to displaying an error dialog: a popup with the text of the Warning Message of the Rules tab. The same also can be set for warnings.

 

The use of these various blocks gives you some flexibility in how you want problems with the form data to be explained to users and what to do to remedy these issues.