Page-Validate method

03-02 R-5958 Use the Page-Validate method to force validation (or revalidation) of the value of all properties on the step page. The system adds a message to each clipboard property that fails validation against the restrictions in its property rule.

If the page has hundreds or thousands of properties, this method can be expensive in terms of system resources. The properties on the page already set (through the Property-Set method or similar methods) may already be validated. This method validates them again, and also validates any property values not changed since the page was opened.

Unless the content of the page was altered by Java code or by unorthodox means, the Page-Validate method is not necessary.

Use the Obj-Validate method, not the Page-Validate method, to validate specific properties identified in a Rule-Obj-Validate rule.

A Page-Clear-Messages method applied later to the page removes the messages set by this method. Q-1675

Parameters

This method has one parameter.

Parameter	Description
WithErrors	In most cases, leave cleared. If this checkbox is not selected and the page identified in the Step Page of this step already contains messages, this method ends. It does not validate properties or create messages. Select this box to force this method to validate properties even if the page already contains messages.

Results

The system validates each property on the step page against the requirements imposed by that property's definition, such as:

• Confirming that a definition for the property can be found (in a RuleSet and version available to this requestor), based on the property's name and the class of the page.
• Confirming that the property value matches the Property Mode and, for Single Value properties, the Type restrictions appropriate for dates, times, numbers, and Boolean values.
• Checking values against those provided (if any) by the Table fields on the General tab of the property rule.
• If the property definition references a property qualifier, confirming that the qualifier value is present and meets its own constraints.
• Comparing the length of values against the maximum defined in the definition.

This checking happens recursively for embedded pages. If any property fails validation, the system adds a message to the property and to the page.

A property with a null value is considered valid.

When a workstation user submits an HTML form to Process Commander, previous page messages corresponding to the input are cleared. MARIK 10/26/05

Checking the results

When validation fails, a messages is added to the page. In a transition, use the when condition rule named @baseclass.HasMessages to test for the message. Validation failure does not modify the pxMethodStatus property value. OLSOK TURBT 10/18/05 and TURBT 3/31/06

Restrictions

B-11491 This method cannot be used in a step that involves an iteration.

	property validation, message, property qualifier, validation
	Obj-Validate method

Methods and instructions by function