Decision Tree
form
Completing the Decision tab (Advanced format)
|
|
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 runtime, 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 Input 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 rule was created in basic mode or if the Allowed to Evaluate Properties? box on the Results tab is not selected.
If the Redirect this
Rule? box on the Results
tab is selected, this circumstance-qualified rule is redirected and
this tab appears blank.
Understanding the branch structure
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. |
magnifying glass icon  |
Click to start the Expression Builder. This tool provides prompting and guidance when creating complex expressions involving functions. See Using the Expression Builder. |
pencil icon |
Click to review a property rule (for a field that contains a property reference). |
row buttons and  |
Click to select a row; the background color changes
to peach ( |
| Show Conflicts |
Click to analyze the consistency of the tree. This
button displays a warning icon ( Click the warning icon to orange highlight
( 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 run the Application Preflight check 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 rule 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
( |
|
Display Name
Display Label |
When reviewing this tab, you can see a presentation using either property names or the Short Description ( |
Modifying branches with drag and drop
operations
Field |
Description |
||||||||||||||||
|
if / if value is |
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 runtime when the condition to its left is reached and evaluates to true. Select a keyword:
|
||||||||||||||||
|
|
Identify a target based on the action value.
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 pencil icon ( |
||||||||||||||||
|
When the system evaluates the decision tree rule at runtime 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 tree rules created in basic mode, or for decision tree rules when the Allowed to Set Take Action? box on the Results tab is not selected. |
||||||||||||||||
| Property |
|
||||||||||||||||
| Value |
Enter a value for that property — a constant, property reference, or expression. |
Completing the Otherwise branch
Field |
Description |
||||
| Otherwise | |||||
| Return |
Choose
|
). Then click the
, 
) 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.
)
).
)
and may refer to values you must modify such as Result
or DecisionTreeInputParam. These additions are only
suggestions; you can alter or delete them.
Enter a value for the current context, or a
comparison starting with one of the six
comparison operators <, >, =, !=, >= or
<=.
button to select a pattern
that helps you enter Boolean expressions. The form
changes to reflect your pattern decision. 
arrow to 
, so that it points down to
the indented row. The context for the
)
to hide this array. 
During backward chaining computations
for Declare Expression rules, if the
Otherwise Return value can be
computed, but properties needed for other parts
of the form are not defined, the
Otherwise Return value is
returned as the value of the decision table rule.
(In Process Commander releases before 5.3, this
condition produced an exception that ended
processing.)