Decision Table Comparison

Table comparison view can be a bit intimidating at first. In this article, we will do our best to clearly explain how to read it and use it most effectively.

Introduction

Imagine you have a production Decision Table and you want to make major changes to the logic behind it. Usually you would create a new version of said table and start changing it to fit your current needs. Once the table is done you test it and start using it in production.

Now if the changes you made were really minor, you could probably remember what you changed. But for cases when you'd been working on version 2 for weeks you might forget what exactly has changed inside of each row or column. Enter Table Comparison.

Decision Table Comparison is most useful when used between two roughly similar rules.

When used on two completely different rules the result won't usually be very helpful.

Common Use-Cases

  • You want to review your changes before implementing a new rule version into production.

  • You wish to simply and quickly add a column from a different rule to the one in question.

  • Visualization of progress between versions of production rules.

The Comparison view

Upon opening the comparison view, you should see a table very similar to the table you've originally opened the comparison on (i.e. the green table). The Reference table has been superimposed onto the Original table and discrepancies between the tables are shown by use of The Color System.

Be aware that you still essentially only have the Original (Green) rule opened. Any changes you make to cells, rows or columns will affect only the Original rule.

The Color System

In comparison view, each table is given a color. Green for the Original table (the currently open table) and Blue for the Reference table (the table we are comparing to).

  • Rows and/or columns shown in White appear in both Tables.

  • If a row or column is colored in Green as well as displaying a circular Green badge, this means the row/column in question appears ONLY in the Green (Original) table.

  • If a row or column is colored in Blue as well as displaying a circular Blue badge, this means the row/column in question appears ONLY in the Blue (Reference) table

  • Changes are shown differently between rows and columns

    • If a row displays a circular Yellow badge at least one of it's cell will be highlighted in Yellow. This means the row appears in BOTH tables but the highlighted cell's value has changed.

    • If a column displays a circular Yellow the column appears in BOTH tables but some of the column's features have changed. The column might now bare a different name, might have a different Input/Output Variable and/or might have a different Valid Values selection.

Interactivity

Table comparison doesn't only offer great informative value, it also makes manipulation with rows and columns easier.

Adding removed cols or rows

Any Blue row or column can easily be added into the Original table by clicking the Blue circular badge next to the row's number or inside the column's header.

Merging rows

Real-time editing

Since the comparison view is just a different rendering of the currently open rule you can still edit the table as you would outside of the comparison view. Changing cells' values, adding and removing rows and columns etc. is still all available and the comparison should change accordingly.

This might sometimes lead to unintuitive behavior as with most changes the comparison will be re-evaluated and the result might suddenly seem different after making a seemingly insignificant change.

To make navigation over compared rules easier, you can click the arrows on the comparison bar at the top to navigate to the next and previous found row differences.

Comparison Statistics

To quickly see how and how much the compared rules differ, you can click the chart icon in the top left to display a dropdown summarizing the amount of differences between the tables, categorized over rows and columns.

Last updated

#843: Audit API chages

Change request updated