Decision Tree form
Completing the Results tab

Field

Description

Optional. Select a property in the Applies To class (or a parent class) that offers through the Table Edit tab, a list of values that are allowed results for this decision tree. Other aspects of this property may or may not be relevant to the rule.

Optional. You can list allowed results and associate each with a set of property value changes that occur when this result is computed at runtime. If the Allowed Values Property field is not blank, values you list here supplement values provided by that property.

Identify an allowed result value for this rule. Enter a constant of the appropriate type. See Constants in expressions. Do not use quotes around the value.

If the Allowed Values Property field on the Input tab is not blank, select from the drop-down list. The system derives this list from information in the Table Values area of the General tab of that property.

You cannot reference properties, functions, or expressions here.

Click to access an optional array of properties and values. Clickto hide this array.

When the decision tree rule evaluates and the value in this row is selected as the results, the system also recomputes the value of the target properties identified in this array. Order is significant.

A check button () indicates that this row includes properties and values. These may be hidden on the form.

A clear button () indicates that no properties and values are defined for this row.

Optional. Identify a target property to be updated with a new value. Click the pencil icon () to review a property rule.

Optional. Enter a value for the property. You can use a property reference, constant, or other forms of an expression here. For guided assistance in entering functions and parameters, click the magnifying glass button () to start the Expression Builder.

Field

Description

Click to check all five restrictions. This defines the least restrictive form of the Decision Tree form.

• Allowed to Change Functions?
• Allowed to Add Nodes?
• Allowed to Evaluate Properties?
• Allowed to Call Decision?
• Allowed to Take Actions?

Click to clear four check box restrictions:

• Allowed to Change Functions
• Allowed to Evaluate Properties
• Allowed to Call Decision
• Allowed to Take Actions?

This defines the most restricted form of the Decision Tree form.

This field appears only if this rule is circumstance-qualified. Select to indicate that another circumstance-qualified rule is to execute rather than this rule.

Redirection lets you share the function and processing of circumstance-qualified rules, reducing the need to maintain separate rules that produce the same results. Create the target circumstance-qualified rule before creating any other rules that redirect to the target.

For a redirected decision tree rule, other fields on this Results tab and all fields on the Decision tab are not meaningful. The Pages & Classes tab is not visible.

Don't use rule redirection if the circumstance property is referenced as an input ion the Decision tab of the other circumstance-qualified decision tree rule.

This field appears only after you select the Redirect this rule box. Select a value from the list to identify the target of redirection.

You can't redirect a rule to itself. However, use care to avoid creating a circular set of redirections (A to B and B to A). This causes a runtime exception.

Select or clear to indicate whether a developer (or delegatee) can change functions on the Decision tab.

If this box is not selected, they may change only constant values.

Select or clear to indicate whether a developer (or delegatee) can add nodes to the tree presented on the Decision tab.

If this box is not selected, they may change only the values within the current tree structure.

Select or clear to indicate whether a developer (or delegatee) can select the evaluate option on the Decision tab.

If this box is not selected, they may select only the return, otherwise, and continue options.

Select or clear to indicate whether a developer (or delegatee) can update the rule to include calls to other decision tree rules on the Decision tab.

Select or clear to indicate whether a developer (or delegatee) can view and choose the Take Action option on the Decision tab, for example to set the value of a property.

Optional. If you selected the Allowed to Change Functions? field, enter one or more function alias values to allow functions of that type to be selected by the manager.

Leave this blank to make available all function aliases. These three are often useful:

• CompareTwoValues — Select to allow only comparisons of dates, numbers, and text strings. If this is the only function you enter, the corresponds to the format produced by the  Basic    button.
• allEntriesSatisfyCondition — Allows matching a scalar value against all elements of a Value List or Value Group property, or values of a scalar property on all the embedded pages of a Page List or Page Group property.
• anyEntrySatisfiesCondition — Allows matching a scalar value against elements of a Value List or Value Group property, or values of a scalar property on the embedded pages of a Page List or Page Group property.

The list shows function alias rules with a Return Type other than void.

Click the pencil icon () to review a function alias rule.

If you entered more than one function in the Functions Allowed array, select one to affect the order in which function aliases appear on the Decision tab.

Optional. If you selected the Allowed to Take Actions? field, enter one or more of the function alias values to allow appropriate functions to be chosen when the Take Actions option is selected.

Select setPropertyValue as the only entry in this list to support the setting of properties with the Take Actions option.

List only functions alias rules with a Return Type of void here.

Click the pencil icon () to review a function alias rule.

Field

Description

Enter an expression to compute a new value for the property. For guided assistance in entering functions and parameters, click the magnifying glass button () to start the Expression Builder.