Behavior of Summary and Highlight-On-Failure Indicator

The highlight-on-failure indicator on a rules item does not have any effect in this view.

If an item fails and is marked as a summary item, this item should only be displayed as a separate tree if no item along its parent path (i.e. any group that contains it) has failed and is marked as a summary item. Consider the following tree of rule groups and rules and note the result and summary attributes on each item. Note that this is purely for illustrative purposes and does not represent the data-format created by the Rules Engine.

Figure 1. Example of Rules Tree Items with Summary Flag
<decision>
  <rules-item id="B" type="rule-group"
              result="success" summary="true">
    <rules-item id="C" type="rule"
                result="success" summary="false" />
    <rules-item id="D" type="rule"
                result="fail" summary="true" />
  </rules-item>
  <rules-item id="E" type="rule-group"
              result="fail" summary="true">
    <rules-item id="F" type="rule"
                result="fail" summary="false" />
    <rules-item id="G" type="rule"
                result="success" summary="false" />
  </rules-item>
  <rules-item id="H" type="rule-group"
              result="success" summary="true">
    <rules-item id="I" type="rule"
                result="success" summary="true" />
    <rules-item id="J" type="rule"
                result="fail" summary="false" />
  </rules-item>
</decision>

A rule that fails and is marked as "not a summary item" may still display as long as it is contained within another node that fails and has summary set to "true". A rule that fails and is marked as "not a summary item" will never display as the root of a tree in the dynamic rules view. So, the data above will result in separate "trees" as follows.

- D

- E
-- F
-- G

From the first rule-group "B", only the item "D" is displayed because it has failed and is marked as a summary item. It appears as a single-node tree.

The rule-group "E" is marked as a summary item and it has failed, therefore it and all it's child nodes are displayed no matter what the success\failure status or summary flag on the child nodes is.

The entire rule-group "H" is filtered out. "H" itself, and "I" have succeeded and will not be displayed. Although "J" has failed it is not marked as a summary item and therefore is not displayed.