Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

Declare OnChange form - Completing the OnChange Properties tab

Updated on January 14, 2022

Define the conditions that will cause this rule to be executed. Specify in an array the properties to be watched for change.

Properties, Conditions, and Action

FieldDescription
Properties to Watch This array identifies some of the properties that the rule tracks. Order is not significant.

See More about Declare OnChange rules for information about the properties tracked by the rule.

(1, 2, 3...) Enter the desired property references. Each property entered is monitored for changes. Identify a property on the top-level page (with a dot followed by the page name) or on a page identified by the Page Context field on the Pages & Classes tab.
  • If you list more than one property, they must be on the same page, either the top-level page or a common embedded page.
  • If you list more than one property, when two or more of the properties change value (for example, within a single step of an activity) this OnChange activity runs only once.
  • Start each property reference with a dot. You can't reference a property on a page other than the page corresponding to the Applies To key part of the rule or on a page identified by the Page Context field on the Pages & Classes tab.
Conditions
When Optional. Identify a when condition rule to be evaluated at the time a property value changes.

The system uses the Page Context value on the Pages & Classes tab (if not blank) as the Applies To key part of the when condition rule. If the Page Context value is blank, the system uses the Applies To key part of this OnChange rule.

Alternatively, you can enter a simple Boolean expression here, for example in one of these formats:

property = "constant value"
property1 > property2

You can reference linked properties in the expression. Don't use a complex Java expression or an expression that calls a function here.

When this OnChange rule used to suspend work item processing, this when condition is known as the business exception.

Choose Action...
Choose Action Select:

When True Run and When False Run

Complete these fields when you select Call Activity in the Choose Action field.

FieldDescription
When True Run
Activity Enter the Activity Name key part of an activity to execute when any of the specified properties change (and the test in the When field evaluates to true). Choose an activity with an Activity Type of OnChange (recorded on the Security tab). If the activity has input parameters, click Params to enter literal constant values for them.

The system uses the Page Class value on the Pages & Classes tab (if not blank) as the Applies To key part of the activity. If the Page Context value is blank, the system uses the Applies To key part of this OnChange rule.

See More about Declare OnChange rules for more about the activity.

When False Run
When False Run Optional. Enter the Activity Name key part of an activity to execute when any of the specified properties change and the test in the When field evaluates to false. Choose an activity with an Activity Type of OnChange (recorded on the Security tab). If the activity has input parameters, click Params to enter literal constant values for them.

See More about Declare OnChange rules for more about the activity.

Suspend Section

Complete these fields when you select Suspend Work Object in the Choose Action field. See Understanding policy overrides and suspended work items.

FieldDescription
Suspend Section
Policy Override Flow to run Enter the Flow Name key part of a flow to execute to support review of the suspended flow. Ensure that the flow meets the requirements listed in How to implement business exception processing with policy overrides.
Error message Enter the third key part of a field value rule with first key part @baseclass and second key part pyMessageLabel, or enter literal text between double quotes to identify this source of policy override reviews.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us