Engines-Parität-Hilfsprogramm
Das Engines-Parität-Hilfsprogramm bietet eine einfache Möglichkeit, die Original-Engine und die AMP Engine zu vergleichen. Sie können damit beide Engines parallel ausführen, die Ergebnisse auswerten und entscheiden, welchen Workflow Sie problemlos in AMP konvertieren können.
Parität-Framework ist ein Befehlszeilen-Tool. Zur Vereinfachung gibt es jedoch ein Makro, welches das Befehl-ausführen-Tool von Alteryx verwendet. Sie haben daher folgende Möglichkeiten:
Führen Sie das Parität-Framework über die Befehlszeile mit AlteryxEngineCmd.exe aus.
Verwenden Sie das Engines-Parität-Makro.
Führen Sie die Engines-Parität-Analyse-App aus.
Verwendung von AlteryxEngineCmd.exe
Sie können Workflows auf AMP und der Original-Engine über AlteryxEngineCmd.exe mit folgenden Parametern vergleichen:
-testDir <Pfad zum Workflow>
Dieser Parameter ist obligatorisch und sollte an erster Stelle stehen.
Pfad zum Ordner mit Workflows oder zu einer einzelnen YXMD-Datei, die Sie testen möchten.
-compareReport <Pfad zur CSV-Berichtsdatei>
Name der CSV-Datei, in der Sie den Bericht speichern möchten.
-tempDir <Pfad zu Zwischendateien>
Ordner, in dem Zwischendateien gespeichert werden. Standardmäßig wird der temporäre Alteryx-Ordner nach der Ausführung gelöscht.
-compatibleMode <AMP Engine mit/ohne Kompatibilitätsmodus ausführen>
Boolescher Parameter, standardmäßig „Falsch“. Bei Abruf mit „Wahr“ wird die AMP Engine im Kompatibilitätsmodus ausgeführt, um die gleiche Datensatzreihenfolge wie die Original-Engine zu gewährleisten.
-recordLimit <Datensatzlimit für alle Eingaben festlegen>
Legt das globale Datensatzlimit für Eingabe-Tools fest, um die Ausführungszeit zu reduzieren. Die Standardeinstellung ist „100000“. Setzen Sie diesen Wert zur Deaktivierung auf 0.
-e1Filter <nur mit der Original-Engine erstellte Workflows filtern>
Boolescher Parameter, standardmäßig „Falsch“. Bei Aufruf mit „Wahr“ werden Workflows (aus dem Ordner) gefiltert, die nur für die Original-Engine erstellt wurden.
Bei allen Parametern wird die Groß-/Kleinschreibung nicht beachtet und sie können sowohl mit dem Präfix „/“ als auch mit dem Präfix „-“ verwendet werden.
Beispiele
Basisausführung
AlteryxEngineCmd.exe /testdir "D:/path/to/workflows" /comparereport "D:/report.csv"
Vollständige Parameter
AlteryxEngineCmd.exe -testDir "D:/path/to/workflows" -compareReport "D:/report.csv" -tempDir "D:/temp" -compatibleMode true -recordLimit 5 -e1Filter true
Verwendung des Engines-Parität-Makros
Das Engines-Parität-Makro ist ab Designer-Version 22.3 verfügbar.
Eine andere Möglichkeit, einen Workflow-Vergleich durchzuführen, ist die Verwendung des Designer-Makros. Das Engines-Parität-Makro ist nicht im Lieferumfang von Designer enthalten. Sie können die Datei Engines Parity.yxzp aus der Gallery herunterladen.
Engines Parity.yxzp besteht aus den folgenden Dateien:
Engines Parity.yxmc – Engines-Parität-Makro.
Engines Parity.yxwz – Engines-Parität-Analyse-App.
ReadFile.yxmc – unterstützende Datei für Makro und Analyse-App und sollte im selben Verzeichnis wie diese abgelegt werden.
RunCmdUniqueFiles.yxmc – unterstützende Datei für Makro und Analyse-App und sollte im selben Verzeichnis wie diese abgelegt werden.
Um das Makro auszuführen, klicken Sie in Designer mit der rechten Maustaste auf den Canvas und wählen Sie Einfügen > Makro > Engines Parity.yxmc . Jetzt können Sie das Makro konfigurieren.
Geben Sie das Verzeichnis mit den Workflows an, die mit beiden Engines parallel ausgeführt werden sollen .
Sie können auch den Pfad festlegen, in dem der Bericht generiert werden soll. Andernfalls wird er im temporären Alteryx-Ordner gespeichert und gelöscht, wenn Sie Designer schließen.
Durch Aktivieren des Kontrollkästchens AMP Engine im Kompatibilitätsmodus ausführen stellen Sie sicher, dass die Datensatzreihenfolge bei der Original-Engine und bei der AMP Engine gleich ist. Dieses Kontrollkästchen ist standardmäßig aktiviert.
Aktivieren Sie das Kontrollkästchen Nach Workflows filtern, die mit der Original-Engine erstellt wurden , um die Berichte nur für Workflows zu generieren, die so erstellt wurden, dass sie mit der Original-Engine funktionieren.
Die globale Datensatzlimit ist die maximale Anzahl von Datensätzen, die für den Vergleich verwendet werden. Wenn Sie kein Limit angeben möchten, setzen Sie die Zahl auf 0.
Verwendung der Engines-Parität-Analyse-App
Die Engines-Parität-Analyse-App ist ab Designer-Version 22.3 verfügbar.
Die Engines-Parität-Analyse-App ist nicht im Lieferumfang von Designer enthalten. Sie ist Teil der Datei Engine Parity.yxzp , die in der Gallery heruntergeladen werden kann.
Um die Engines-Parität-Analyse-App zu verwenden, führen Sie die Datei Engines Parity.yxwz aus.
