Using The Comparison Utility
  • 21 Nov 2024
  • 1 Minute to read
  • Dark
    Light

Using The Comparison Utility

  • Dark
    Light

Article summary

Overview

The Comparison utility is a feature that compares the current version of a Flow to any historical versions. This can be used to see changes over time for the Flow.

The Comparison Utility can be found by right-clicking a Flow, then under the Manage section selecting More > Compare Flow Versions.


Flow Designer Method 

The Flow Compare utility may also be accessed from the Flow Designer via the Compare icon on the top Action bar. 

The default view is the Graphical version. From this screen, users are provided the option to select each of the two desired versions for comparison via the two drop-down menus on the top Action bar. Selecting two different versions visually represents the differences and similarities between each Flow's steps and their respective connections.

These steps and paths are color-coded as follows:

BlueRepresents the original steps and paths. 
GreenRepresents added/altered steps and paths. 
Orange Represents removed and deleted steps/paths. 
Additional Notations 
As part of the visual tracking, by selecting the Start or End step on a Flow that has been moved, users may observe the comparison in X and Y locations for those steps in both Flows. 


Textual Comparison Utility

Beyond the visual comparison of Flows, there is also a Textual Comparison option. This can be toggled by pressing the TEXTUAL button. Textual Comparison is also available starting in v9.2 for Statement Rules and Truth Tables.

Select which versions of the Flow to compare by using the [Last Saved Version] selectors.

Changes will be labeled based on the type of change: Missing, Modified, Added, or Removed. In v9.4 and earlier a legend is available in the top right corner, by hovering over the 'i' icon that will show what each color corresponds to. In v9.5 and later, the legend is located a the bottom of the screen.

Legend in v9.1 to v9.4, located in the upper right. 

Legend in v9.5 and above at the bottom.

 

Expanding the dropdown arrows will show more and more detail about the changes that were made. In the below example a brand new Step added to the Flow is being reviewed.

To review changes faster there are the Show changes only toggle and Expand All toggle.


Feature Changes

DescriptionVersionRelease DateDeveloper Task
Textual Comparison utility added.9.1July 2024[DT-040452]
Textual Comparison utility works for Truth Tables.9.2August 2024
[DT-041637]
Textual Comparison utility works for Statement Rules.
9.2August 2024
[DT-041493]
Annotations now appear in the Textual Comparison utility.
9.3
October 2024
[DT-041542]
Comparison Utility icon was moved in the Flow Designer.9.4November 2024[DT-042100]
Moved the legend to the bottom of the Comparison Utility.9.5November 2024[DT-042339]

Was this article helpful?