Back Forward Page-Validate method

Methods and instructions by function

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.

NoteIf 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.

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

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:

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

NoteA property with a null value is considered valid.

NoteWhen a workstation user submits an HTML form to PRPC, previous page messages corresponding to the input are cleared.

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.

Restrictions

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

Definitions property validation, message, property qualifier, validation
Related topics Obj-Validate method

UpMethods and instructions by function