Map Value
form
|
Completing this tab is optional. To restrict the results of this map value rule 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.
If the Redirect this rule check box 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.
Field |
Description |
Allowed Values Property |
Optional. Select a property in the Applies To class (or a parent class) that offers through the Table Edit 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 |
Optional. 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...) |
Optional. Identify an allowed result value for this rule. Enter a constant, property reference or expression. |
Click 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 | Identify 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 () to start the Expression Builder. |
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 rule, other fields on this Results tab and all fields on the Matrix tab are not meaningful. The Pages & Classes tab is not visible. Don'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 rule. |
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. 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). 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. |
Field |
Description |
Allowed Values Property |
Optional. Select a property in the Applies To class (or a parent class) that offers through the Table Edit 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 |
Optional. 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...) |
Optional. Identify an allowed result value for this rule. Enter a constant, property reference or expression. |
Click 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 | Identify 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 () 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 rule, 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. 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). 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 |
You can define a list of property updates to occur before information on the Decision tab is evaluated. Order is significant. |
Property | Optional. Identify a target property to be updated with a new value. |
Value |
Enter an expression to compute a new value for the property. For guided assistance in entering functions and parameters, click the magnifying glass icon () to start the Expression Builder. |