Back Forward Declare Expressions form
Completing the Expressions tab

 About Declare Expression rules

  Show all 

C-1165 On this tab, record the computations for the target property identified in the key.

  Using the controls

Click any condition or a comparison to enable controls.

Control

Action
open icon

Click to review a property rule (for a field that contains a property reference). If the property does not yet exist, click to create a new property rule.
expression selector

Click to display a drop-down list of all boolean expressions.
row buttons
,, and

Select a condition to enable. Then click the , , or buttons to add a new condition before or after the selected entry, or to delete the selected entry (Equivalently, use the  Insert  ,  Shift+Insert  , and  Delete   keys). To re-order conditions, you can use the Windows drag-and-drop operation.

If OR is selected as a boolean operator in an expression, click ,, or buttons to add a new comparison before or after the selected entry or to delete the selected comparison (Equivalently, use the  Insert  ,  Shift+Insert  , and  Delete  keys). To re-order comparisons, you can use the Windows drag-and-drop operation.

relate PDN resources button

Click the button to view Pega Development Network articles that are related to expressions.

Display Name

Display Label

When reviewing this tab, you can see a presentation using either property names or the Short Description (pyLabel) of properties. Click to toggle the display. (Note that two or more properties may have the same Short Description text.) 5.5 GRP-387

  Modifying expressions with drag and drop operations

To move a condition or a comparison to a different location, click and drag the small circle located to the left of the entry.

To copy a condition or a comparison, drag the entry while holding down the CTRL key.

  Completing fields

Field

Description
Whenever inputs change  
If

Click the button to select a boolean expression from the drop-down list. The form changes to reflect the expression selected.

Most expressions require parameters that may themselves be expressions. Use SmartPromptSmartPrompt to select a property as a parameter.
"Boolean Operator"

Depending on the expression selected, choose THEN, OR, or AND operator. If the OR operator is selected, you may add comparisons to the expression.
Set Property To

Select a computation type. The choices available depend on the type of the Target Property.C-1165

Keyword

Effect
Value of

Assigns the value of an expression to a property.
Sum of, Minimum of, Maximum of, Average of

Performs the computation indicated based on an aggregate property in the Expression field When you select any of these four aggregate operators, the Expression field must identify a single property reference (for example, a Value Group), not a more general form of an expression. MIRAT STEWS 1/13/04 SR-6756 B-24805
Value of first matching property in parent pages

This property is set to equal that of the first property with the same name found on a parent page. Only a property on a page of a class equal to or a descendant of this expression will be used as input. NoteYou can't use a When expression or rule with this computation type.

Once this expression is defined the link is immediately established and maintained by the system.

NoteOn the Change Tracking tab, the Calculate Value field must be set to Whenever inputs change' and the Execute this Expression field must be set to 'Regardless of any pages it is embedded in'. PROJ-824

This feature is known as property reflection, because the target property automatically updates to reflect the value of the parent property.
Count of

Performs the computation indicated based on a Page Group or Page List property in the Expression field. MIRAT 01/12/05 / B-17332 SmartPrompt B-18818
True if Any Entries of

Applies an OR operation to a list or group of expressions, each of which returns true or false. Appears when the target property has type TrueFalse. MIRAT 5/19/06 B-19762 BUG-1182 SR-3197
True if All Entries of

Applies an AND operation to a list or group of expressions, each of which returns true or false. Appears when the target property has type TrueFalse. MIRAT 5/19/06
True if No Entries of

Applies a NOT operation to a list or group of expressions, each of which returns true or false. Appears when the target property has type TrueFalse. MIRAT 5/19/06
Index for Minimum of

Finds the smallest value among the values in the aggregate property in the Expression field, and returns the index (subscript) of that value. C-1739
Index for Maximum of

Finds the largest value among the values in the aggregate property in the Expression field, and returns the index (subscript) of that value. C-1739
Result of Decision Tree

Evaluates a decision tree rule and assigns the result to the target property. See More... for information about special processing that can occur at runtime in this case. B-18749 B-18814
Result of Decision Table

Evaluates a decision table rule and assigns the result to the target property. See More... for information about special processing that can occur at runtime in this case. B-18749B-18814
Result of Map Value

Evaluates a map value rule and assigns the result to the target property. See More... for information about special processing that can occur at runtime in this case. B-18749B-18814
(no label)

SmartPromptEnter an expression or identify a rule that computes a value for the Target Property. Based on the Set Property To field, complete this field:

Set Property To

     Instructions
Value of

Enter an expression, or choose and complete one of the function alias phrases from the selection list. Enter a pair of double-quotation marks ("") for a null text value. B-11069 402SP1

If the Calculate Value field on the Change Tracking tab is set to Whenever inputs change, reference at least one input property on the primary page, the page that matches the class of the Applies To key part of this rule. B-19215 BUG-1188B-20060 rejected

Your expression can reference properties on other pages — listed in the Pages & Classes tab — using a page name and property reference, but these properties are not change-tracked. MIRAT HOOPK 12/09/04 R-10469 References to aggregate properties apply to all elements of the property, so include parentheses () with no explicit subscript. SR-3512 B-20288 REVERSED? B-17137

If the Page Context field is not blank, you can use the Parent keyword followed by a period and property name to identify properties on the immediate parent of the primary page, or the Top keyword followed by a period and property name to reference a property in the top-level page. (You can use the Parent keyword more than once.) B-20312 B-19609 SR-3205 SR-3533Correct?B-20000 not step pageB-20614 rejected

Sum of,
Minimum of,Maximum of,Average of, Count of,
Index for Minimum of,Index for Maximum of

Identify a single aggregate property containing the values to be summed, averaged, and so on. MIRAT STEWS 1/13/04For Sum of and Average of, the property type must be numeric.

References to aggregate properties apply to all elements of the property, so include parentheses () with no explicit subscript. B-17137 B-20288 SR-3512 B-20799 (You can't use the Top or Parent keywords here.) B-20614 rejected

Result of Decision Tree,

Result of Decision Table

Result of Map Value

Enter the second key part of a rule of that type. If the Page Context key part is empty, the system uses the Applies To key part of this rule as the Applies To key part of the referenced rule.

Otherwise, it uses the class of the Target Property as the Applies To key part. If the decision tree, decision table, or map value rule references named pages, identify these pages on the Pages & Classes tab. B-20729 (You can't use the Top or Parent keywords here.) B-20614 rejected
using entries in which

SmartPromptOptional. This field appears only when you select Sum of, Minimum of, Maximum of, Average Of, True if Any, True if All, True if None, or Count of in the Set Property To field. SR-496 B-15930 B-20735

Enter an expression that evaluates to true only for those elements of the aggregate property that you want include in the computation. Leave blank to include all the elements. B-18278

Typically, the expression involves a comparison and a property within the aggregate property, for example:

.Color!="White"

where .Color is an embedded property within a Page List of class Embed-Houses. If the Page List property contains 100 pages and the Set Property To selection is Count of, this expression counts how many of the 100 pages have a Color value not equal to "White."
Otherwise Set Property

This expression determines the target property value when the conditions array is empty or all the condition rows evaluate to false. Complete both fields.
(no label)

Select an expression type such as Value of. This field is similar to the Set Property To field described above.
Expression

Enter an expression that computes a value for the Target Property. You can type the expression directly, or use the Expression Builder. For guided help with composing expressions, click the magnifying glass icon ().

In the expression, the page that matches the class of the Applies To key part of this rule. Your expression can reference properties on other pages using a page name and property reference, but these properties are not change-tracked. PROJ-938

Up About Declare Expression rulesR-10431 FUA