Decision Tree form
|
|
Record the if.. then.. logic of the decision tree in the three-column array. These unlabeled columns are known as the comparison, action, and next value columns.
This help topic describes the advanced format of the Decision tab. If you encounter a Decision tab that does not contain Evaluate Parameter or Evaluate property name see Completing the Decision tab (Basic format).
At run time, the system evaluates the if portion of the array, starting at the top row, and continues until it reaches a Return
statement. If the system processes the entire tree but does not reach a Return
statement, it returns the Otherwise
value.
The Evaluate field at the topic identifies the Property value, if any, from the Configuration tab. When this field is blank, the value is taken from a parameter of the Property-Map-DecisionTree method. The Evaluate field does not appear if this decision tree was created in basic mode or if the Allowed to Evaluate Properties? box on the Configuration tab is not selected.
If the Redirect this Rule? box on the Configuration tab is selected, this circumstance-qualified rule is redirected and tab appears blank.
Each indent level supports comparisons against a single value, determined by context:
Click in a field to display controls for that row or field.
Control |
Action |
Collapse All |
Click to hide subtree structures, or click a minus sign to hide subtree structures. |
Expand All |
Click to show all the subtree structures, or click a plus sign to display specific subtrees. |
Gear icon |
Click to start the Expression Builder. This tool provides prompting and guidance when creating complex expressions involving functions. See Using the Expression Builder. |
Open icon |
Click to review a property (for a field that contains a property reference). |
row buttons and |
Click to select a row; the background color changes to peach (). Then click the, , or buttons to insert, append, or delete a row. (Equivalently, use the Insert, Shift+Insert, and Delete keys). |
Show Conflicts |
Click to analyze the consistency of the tree. This button displays a warning icon () next to any parts of the tree that are unreachable. For example, a branch that extends below the two mutually contradictory tests (if Width > 100) and (if Width < 100) is unreachable. Click the warning icon to highlight in orange () the parts of the tree that cause that branch to be unreachable. The selected has a yellow background (). A decision tree that contains no unreachable parts is called consistent. The presence of unreachable portions of the tree does not prevent you from saving the rule. Comparisons involving two properties such as Width > Length are ignored in this analysis. Conflicts are also checked when you save the form, and when you use the Guardrails landing page for the application. Conflicts do not prevent the rule from validating or executing, but may indicate that a rule does not work as intended. |
Show Completeness |
Click to automatically add suggested portions of the decision tree that cover additional cases and reduce or eliminate the situations that fall through to the Otherwise Return expression. Suggested additions appear with a light green highlight () and may refer to values you must modify such as Result or DecisionTreeInputParam. These additions are only suggestions; you can alter or delete them. |
Display Name
Display Label |
When reviewing this tab, you can see a presentation using either property names or the Short Description ( |
To move a subtree structure, drag the small circle at its left.
To copy a subtree structure, drag while holding down the CTRL
key, and drop it on the destination node.
Field |
Description |
||||||||||||||||
if / if value is |
Enter a value for the current context, or a comparison starting with one of the six comparison operators <, >, =, !=, >= or <=. The value can be an expression, such as a literal value between quotes or a This field is not visible if the action field is set to |
||||||||||||||||
(action) |
Select an action from the selection list. The action you choose determines which branch of this decision tree the system follows at run time when the condition to its left is reached and evaluates to true. Select a keyword:
|
||||||||||||||||
|
Identify a target based on the action value. If you selected Otherwise, enter a value or expression here that allows evaluation of the decision tree to continue. You can reference a property on any page, but be sure to enter any page you reference on the Pages & Classes tab. Enter a value that depends on the one of the following action value keywords:
This input field does not appear when the action value is Click the Open icon to open a referenced decision tree, map value, or decision table. (The |
||||||||||||||||
Click to access an optional array of properties and values. Clickto hide this array. When the system evaluates the decision tree at run time and this row is the source of the results, the system also recomputes the value of the target properties identified in this array. Order is significant. This capability is not available for decision trees created in basic mode, or for decision trees when the Allowed to Set Take Action? box on the Configuration tab is not selected. |
|||||||||||||||||
Property |
Optional. Identify a property reference corresponding to a value to be set. |
||||||||||||||||
Value |
Enter a value for that property — a constant, property reference, or expression. |
Field |
Description |
||||
Otherwise | |||||
Return |
Choose
|