Parity Framework
Parity Framework is an easy way to compare the Original and AMP engines. It allows you to run both in parallel, evaluate the results, and make decisions about which workflow can be confidently converted to AMP.
Parity Framework is a command like tool. However, to make it easier, there is also a macro that uses the Alteryx Run Command tool. So you can choose to:
-
Run Parity Framework via the command line with AlteryxEngineCmd.exe.
-
Run Parity Framework via Designer using the macro.
Using AlteryxEngineCmd.exe
You can make compare running workflows on AMP and the original Engine using AlteryxEngineCmd.exe with these parameters:
-
-testDir <path to workflow>: This parameter is mandatory and should be the first. Path to the folder with workflows or to a single YXMD file that you want to test.
-
-compareReport <path to CSV report file>: CSV file name where you want the report to be saved.
-
-tempDir <path to intermediate files>: Folder where intermediate files will be saved. By default it's the Alteryx temporary folder which will be deleted after the run.
-
-compatibleMode <run AMP engine with/without Compatibility mode>: Boolean parameter, "False" by default. If called with "True", AMP engine runs in compatibility mode to guarantee the same record order as the original Engine.
-
-recordLimit <set record limit for all inputs>: Sets global record limit for input tools to reduce execution type. By default it's 100,000. Set this value to 0 to disable.
-
-e1Filter <filter only workflow created with Original Engine>: Boolean parameter, "False" by default. If called with "True", it filters workflows from the folder which were created for the original Engine only.
All parameters are case insensitive and can be used with both '/' and '-' prefixes.
Examples
-
Basic Run: AlteryxEngineCmd.exe /testdir "D:/path/to/workflows" /comparereport "D:/report.csv"
-
Full Parameters: AlteryxEngineCmd.exe -testDir "D:/path/to/workflows" -compareReport "D:/report.csv" -tempDir "D:/temp" -compatibleMode true -recordLimit 5 -e1Filter true
Using the Designer Macro
Another way of making workflow comparisons is to use the Designer macro. The macro will be uploaded into the Gallery.
-
You can specify the directory with workflows to test:
-
You can also set path where you want the report to be generated. Otherwise, it's saved to the Alteryx temporary folder and deleted when you close Designer.
-
Run AMP Engine with compatibility mode will make sure records order is the same with both original Engine and AMP engine.
-
If Filter only workflows built with the Original Engine option is selected, the report is generated only for workflows that were created to work with the Original Engine.
-
Global record limit is the max number of records that will be used for comparison. Can be set to 0 If you don't want to limit at all.