Validate form
Completing the Validate tab

Control

Action

Click to review a property rule (for a field that contains a property reference). If the property does not exist, click thebutton to create a new property rule.

Click the button to display a drop-down list of all boolean expressions.

Select any validation to enable. Click the , , or buttons to add a new validation before or after the selected validation, or to delete the selected validation. (Equivalently, use the Insert  ,  Shift+Insert  , and  Delete   keys).

condition buttons

,, or

Select any condition in a validation to enable. Click the , , or

buttons to add a new condition before or after the selected condition, or to delete the selected condition.

Display Name

Display Label

When reviewing this tab, you can see a presentation using either property names or the Short Description (pyLabel) of properties. Click to toggle the display. (Note that two or more properties may have the same Short Description text.) 5.5 GRP-387

Field

Description

At runtime, entries are processed in order, starting at the top, until a property is found to be invalid and the Continue? box for that entry is not selected.

Choose between Validate, Validate Each, Call, or Call for Each. If Call or Call for Each is chosen, choose the step page and the validation to be run.

• Validate — Directly validates a top level property
• Validate Each — Directly validates an embedded property YOULS 4/20/08
• Call — Calls another validate record
• Call for Each — Calls another validate record on an embedded page

Only visible if Validate or Validate Each is selected. Select a Single Value property or qualified reference to a value of an aggregate property. Typically, choose a property that appears in an HTML form as an input (not display only).

Only visible if Validate or Validate Each is selected. Select to require a user to enter a non-blank value for the property. If selected and the field is blank at runtime when the form is submitted, the system associates the message:

This field may not be blank.

with the property. B-13135 REJECTEDYou cannot override this message. SR-668 B-15883

If not selected, the blank value is allowed.

Do not select the Required? checkbox for a field that appears at runtime as a checkbox, because the cleared (unchecked) value may correspond to blank.

Only visible if Validate or Validate Each is selected. Checking conditions allows the user to add and enable validation conditions for the property.

Only visible if Validate or Validate Each is selected. Select to indicate that later validation entries in this form are processed even when the edit validate rule in the current entry fails. This is always checked if the Validation type is Call or Call for each.

Only visible if Validate or Validate Each is selected and if the Conditions? checkbox is checked. This area defines the validation.

Click the button to select a boolean expression from the drop-down list. The form changes to reflect the expression selected.

Most selections require parameters, which may themselves be expressions. Use SmartPrompt to select a property as a parameter.

Optional. Only visible if Validate or Validate Each is selected and if the Conditions? checkbox is checked. Select a Rule-Message key to associate with the property or qualified reference to a value of an aggregate property when the edit validate rule fails for the non-blank value provided by the user. You may also type your own message.

If the message rule accepts numbered parameters, follow the key of the message rule with a backslash character, the letter t, and an optional literal text value for the parameter. For example, if the message NoSuchCustomer accepts parameters {1}, {2} and {3}, you can supply three text values in the format:

NoSuchCustomer\tyou\tMaster Account system\tmonth-end

You can't reference property values or parameter page values as message parameters.

The message rule is not used when the Required? box is selected.

For more information about messages, see About Message Rules.

Step Page

Only visible if Call or Call for Each is selected. Choose a step page to call a validate rule to run against.

Only visible if Call or Call for Each is selected. Choose which validate rule to run against the step page specified.