Open topic with navigation
Add more information to decision report
Decision reports may sometimes be too succinct to provide a user with a useful explanation of reasons for a decision. There are several ways you can add more information to decision reports.
What do you want to do?
Add intermediate rules
Remove existing silent and invisible operators
Substitute the value of an attribute for its text
Show the names of entity instances
Add intermediate rules
You can add 'intermediate-level' rules to provide an additional layer of explanation between rules, which will help users see how the rule logic is operating. You can do this by using variable comparisons to infer boolean attributes, or by replacing grouping attributes with new attributes.
Remove existing silent and invisible operators
Sometimes when silent and/or invisible parameters have been used in the rules to hide attributes and decision trees, the resulting decision reports can be difficult to read and understand. In this case you may need to find where these parameters have been used and remove them. To do this:
- In Oracle Policy Modeling, select Build | Build and Debug.
- In the Debug Options dialog box, select the Without screens option, then click OK.
- In the Data view, select the attribute you are interested in, right-click and select Investigate. TIP: It may be most effective to identify an intermediate goal proving the section of your rules that you wish to examine, and check this attribute for silent and invisible operators applied to its influencing attributes.
- In the Decision view, select the option to Show silent and invisible. If this changes the decision view, then silent and/or invisible operators are being applied to the attributes in the decision view.
- If this is the case, identify the attribute(s) that are affected, then open the properties file for the project and double-click the attribute to open the Attribute Editor.
- Select the Decision Reports tab and see if there any silent and/or invisible parameters set. If so, remove them.

- If the attribute does not have any silent and/or invisible parameters set on it in the properties file, then these operators must be operating at the rule level rather than globally. Open the rules document containing the rule, locate the rule and delete the silent and/or invisible operator.
- Repeat steps 5 to 7 for all relevant attributes in your decision report, until you are satisfied that all appropriate attributes are being displayed correctly.
Substitute the value of an attribute for its text
You can substitute the text of a variable with its actual value when it is used in another attribute in the rulebase. This substitution can make decision reports much more meaningful, for example:
the claimant’s sibling lives in the claimant’s sibling’s country with the claimant
can become:
Charlene lives in Morocco with Anne
where "the claimant’s sibling", "the claimant’s sibling’s country" and "the claimant" are all substituting variables.
For more information on how variable substitution operates, see Substitute the actual value of a variable for its text.
Show the names of entity instances
By default, decision reports refer to entity instances in a generic way, for example instances of an entity "the child" could be shown as "child 1", "child 2" etc in a decision report, or simply as "the child" in entity-level attributes. You can show the names of entity instances in decision reports instead, to improve the readability of your decision report and make it clear which entity instance is being referred to. There are two places to do this:
- Set up attribute substitution, as noted above, for the name of the entity instance. This will substitute the name of the entity instance into entity-level attributes, eg "Reid satisfies all the eligibility criteria" instead of "The child satisfies all the eligibility criteria", in the example below. See Substitute the actual value of a variable for its text for details of how to set this up.
- Define an identifying attribute for the entity. Where the entity instances are listed in the decision report, this will substitute the appropriate name of each entity instance, instead of generic labels. Eg the names of the three child entity instances (Benny, George and Pippa) are listed in the example below, rather than labels like "child 1", "child 2" and "child 3".

See also: