1. Potens.io
  2. Magnus
  3. Advanced & How To

Articles > Diff Tool - Compare Workflow Versions

Workflow’s Versions Diff Tool allows users to compare any two versions of the same Workflow and quickly identify / locate changes

  • Changes within the Task
    • Yellow badge with number in it – indicates that respective task has that many changes in it

 mceclip0.png

  • Expanding the task reveals those changes (all highlighted in yellow)
    Note: tool identifies changes here on workflow/task attribute level – for example in below screenshot - Query was changed and this is indicated by respective textbox being highlighted in yellow. This Tool – does not provide what exactly changes are done within the text of query – you can do using any available text diff tool – online or local app

 mceclip1.png

  • If changes are located behind expandable areas or on flip (back) side of task – respective link / icon is highlighted in yellow and will reveal actual changes upon action

 mceclip2.png

 

  • Added, removed or moved Tasks

 mceclip3.png

Removed Task highlighted with red and moved task highlighted with blue 

 mceclip4.png

  • Workflow level changes

  mceclip5.png

  • Changes in Parameters (value, mode, type/schema)

If there are any changes related to [custom] Parameters – it is indicated as in below screenshot

 mceclip6.png

Simply check respective option  - changes in parameters will be shown 

mceclip14.png 

  • Added, removed or moved Parameters

mceclip9.png 

Similarly, Removed Parameters highlighted with red and moved ones highlighted with blue

mceclip10.png 

  • How to invoke Diff Tool
    • From Workflow Editor

 mceclip11.png

  • From Workflow Browser

 mceclip12.png

  • How to select versions
    • There two panels representing two versions – left panel for earlier version and right panel for any following version of the same workflow
      When Diff Tool is opened – the latest (current) version is on the right and previous version is on the left panel

      Using respective drop-down boxes user can select versions to compare


 mceclip13.png

  • How to see changes

When Diff Tool is loaded with two versions – all presented tasks are collapsed – so you can see high level picture 
You can click on Title Bar of Workflow Header to expand / collapse all Tasks (same as in Workflow Editor)
Also, you can click on Task’s Title Bar to expand / collapse respective Task and see respective changes (if any)

  •  Workflow Versions Diff Tool extended for Text-Based entries for below Tasks
  1. BigQuery Task – Query Text
  2. API Task – Request Body & Request Headers
  3. E-Mail Task – Email Body
  4. Script Task – Script Text
  5. And few more text-based elements

Some Examples

As you already know – whenever there is a difference found for any Workflow or Task attribute – respective UI element gets highlighted in yellow.
With today’s release - some of such elements will get extra [Diff] button that you can use to explore what exactly differences are in two versions – as in few examples below    

  • Changes within the BigQuery Query

mceclip0.png

When you click on Diff – you see below interactive form 

mceclip6.png

 Note: take attention to “Toggle lock scrolling” button in center at the bottom of pop-up

  • Changes within the API’s Request Body  

mceclip7.png

After click on Diff button: 

mceclip8.png

  • Changes within the E-Mail Body  

mceclip9.png

After click on Diff button: 

mceclip10.png

  • We hope you’ve got an idea, so we are not showing all possible cases here o)