Declare OnChange form
Completing the OnChange Properties tab

Field

Description

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.

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.

Notes:

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

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.

Select:

• Suspend Work Object — To cause all executing flows for a work item to be suspended. See Understanding policy overrides and suspended work items.
• Call Activity — For all other OnChange processing.

Field

Description

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.

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.

Field

Description

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.

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.