Back Forward Map Value form
Completing the Results tab

  1. About 
  2. New 
  3. Matrix 
  4. Input 
  5. Results 
  6. Parameters 
  7. Pages & Classes 
  1. History 
  2. More... 

Completing this tab is optional. To restrict the results of this map value to one of a short list of known non-null values, enter them here in any order. Complete this tab before the Matrix tab.

If you enter expressions or property references as return values, the system evaluates them each time the rule is evaluated.

NoteIf the Redirect this rule checkbox is selected, the system at runtime ignores all the fields on this Map Value form other than the rule name, rule resolution details, and the value in the Circumstance Value field.

Allowed Results

Field

Description

Allowed Values Property

SmartPromptOptional. Select a property in the Applies To class (or a parent of the Applies To class) that offers a list of values. The list is controlled by the Table fields on the General tab of the Property form, providing a set of values that are allowed results for this decision. (Other aspects of this property may or may not be relevant to the rule.)

Allowed Results

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

(1...)

SmartPromptOptional. Identify an allowed result value for this rule. Enter a constant, property reference or expression.

Append RowClick to access an optional array of target properties and values. Click to hide this array.

The system evaluates the value and makes the assignment to the target property (in the order listed) only when the map value result corresponds to the value in the numbered field.

Sets Properties?

The button indicates that this row includes (possibly hidden) properties and values. Abutton indicates that no properties and values are defined for this row.

Property Append Row SmartPromptIdentify a target property for a value.
Value

Enter an expression that computes a value for the target 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 icon (Magnifying glass) to start the Expression Builder.

Options

Field

Description

Options  
Redirect this Rule

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 allows you to 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, other fields on this Results tab and all fields on the Matrix tab are not meaningful. The Pages & Classes tab is not visible.

CautionDon't use rule redirection if the circumstance property is referenced in a row input or column input of the Matrix tab of the other circumstance-qualified map value.

Circumstance Value

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

TipYou 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). At runtime, this causes an exception.

Allowed to Update Matrix Layout?

Select to allow users who are delegated responsibility for this rule to modify the rows and columns of the Matrix tab.

If not selected, such users can only change values within the Matrix tab cells.

Allowed to Build Expressions?

Select to allow users who have access to the Matrix tab to use the Expression Builder and enter expressions. When not selected, users can enter only constants or property references rather than more complete expressions.

Preset Property Values

Field

Description

Allowed Values Property

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

Allowed Results

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

(1...)

SmartPromptOptional. Identify an allowed result value for this rule. Enter a constant, property reference or expression.

Append RowClick to access an optional array of target properties and values. Click to hide this array.

The system evaluates the value and makes the assignment to the target property (in the order listed) only when the map value result corresponds to the value in the numbered field.

Sets Properties?

The button indicates that this row includes (possibly hidden) properties and values. Abutton indicates that no properties and values are defined for this row.

Property Append Row SmartPromptIdentify a target property for a value.
Value

Enter an expression that computes a value for the target 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 icon (Magnifying glass) to start the Expression Builder.

Options  
Redirect this Rule

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 allows you to share the function and processing of circumstance-qualified rules, reducing the need to maintain separate rules that product the same results. Create the target circumstance-qualified rule before creating any other rules that redirect to the target.

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

Circumstance Value

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

TipYou 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). At runtime, this causes an exception.

Allowed to Update Matrix Layout?

Select to allow users who are delegated responsibility for this rule to modify the rows and columns of the Matrix tab.

If not selected, such users can only change values within the Matrix tab cells.

Allowed to Build Expressions?

Select to allow users who have access to the Matrix tab to use the Expression Builder and enter expressions. When not selected, users can enter only constants or property references rather than more complete expressions.

Preset Property Values

Append RowYou can define a list of property updates to occur before information on the Decision tab is evaluated. Order is significant.

Property SmartPromptOptional. Identify a target property to be updated with a new value.
Value

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

Up About Map Values