More about Edit Validate rules

Cannot validate empty input fields

If an input field is blank, the edit validate rule associated with the property is not called. You can't create an edit validate rule that checks whether a value is empty.

Comparing edit validate and constraints rules

Constraints rules provide a useful alternative to edit validate rules, especially for properties that may be updated both by computations and by direct user input.

Comparing edit validate rules and edit input rules

Don't confuse edit validate processing with edit input processing:

• Edit input processing reformats user input for a property, whether or not the input is a valid value for the property.
• Edit validate processing operates after edit Input processing and never alters the property value.
• Edit input processing occurs automatically, as the system accepts user input and places it on the user's clipboard.
• Edit validate processing occurs only later, when an activity uses the Property-Validate method with that property or uses client-side format validation.

The property value (stored in the variable theValue) that is input to edit validate processing may not be what the user typed, if an edit input transformation is associated with the property.

Use of regular expressions

You can create edit validate rules that use regular expression pattern matching to validate user inputs. See PDN article How to use regular expressions to validate user input.

Client-side validation

The standard text file rule named webwb.pega_validators.js includes JavaScript functions that exactly emulate a few standard edit validate rules. When enabled appropriately, these JavaScript functions are incorporated into user forms and flow actions, supporting client-side validation of user inputs, before a user submits the form.

If desired, you can build a similar capability for an edit validate rule in your application RuleSet. JavaScript skills are required.

1. Create and test the edit validate rule.
2. Associate an edit validate rule with a property.
3. Create and test a JavaScript function that performs the same validation test as the edit validate rule, and has the same name. Follow the structure used in the standard text file rule webwb.pega_validators.js
4. Save the JavaScript in a text file rule in your application RuleSet.
5. Associate with the property a control rule that includes the ClientValidation control rule.
6. Enable client-side validation, by a check box on the HTML tab of the Harness form. For best results use JSP tags and the SmartFrames format for the harness.
7. Reference the text file rule containing the JavaScript function on the Scripts and Styles tab of each harness that can present the field as an input field, that is, in read-write mode.
8. Test.

Message rule

When an input value fails validation by an edit validate rule, the system adds the message rule named PropertyInfo-EditValidate to the property. The default text is

Invalid value specified for {1}.

where {1} identifies the property.

Viewing the Java code of a rule

Click Actions > View Java to view the generated Java of a rule. You can use the Java code to debug your application or to examine how rules are implemented.

Open topic with navigation