Workflows über Befehlszeile ausführen
Mithilfe von AlteryxEngineCmd.exe aus dem Stammverzeichnis der Alteryx-Programmdateien können Workflows über die Befehlszeile ausgeführt werden. Sie benötigen eine Engine-API-Lizenz, um AlteryxEngineCmd.exe verwenden zu können.
Beispiel
Führen Sie die Analyse-App aus, die sich im Tag „Workflow > Pfad“ von AppValues.xml befindet.
AlteryxEngineCmd.exe MyWorkflow.yxmd
AlteryxEngineCmd.exe MyAnalyticApp.yxwz AppValues.xml
AlteryxEngineCmd.exe AppValues.xml
Beispiele für zurückgegebene Werte:
0: Erfolg
1: Warnungen vorhanden
2: Fehler vorhanden
Fügen Sie zum Ausführen von Workflows über die Befehlszeile den Alteryx-Stammpfad zu Ihren PATH-Systemvariablen hinzu.
Der Zugang zu Ihren Systemvariablen ist je nach Betriebssystem unterschiedlich. Dies ist der allgemeine Prozess:
Rufen Sie auf dem Desktop die Systemsicherheitsoptionen Ihres Computers auf.
Rufen Sie die „Erweiterten Optionen“ auf.
Navigieren Sie unter „Variablenwert“ zum Ende der Liste.
Die einzelnen Variablen sind durch Semikolon voneinander getrennt.
Um die Variable zu bearbeiten, geben oder fügen Sie den Alteryx-Pfad ein. Der Standardpfad lautet
C:\Programme\Alteryx\bin.
Wenden Sie diese Methode an, es sei denn, Sie führen AlteryxEngineCmd.exe über den Alteryx-Stammordner aus oder Sie verwenden den gesamten Pfad zu der ausführbaren Datei:
"C:\Program Files\Alteryx\bin\AlteryxEngineCmd.exe" MyWorkflow.yxmd
Engine-Optionen
AlteryxEngineCmd.exe ist eine veröffentlichte Befehlszeilenschnittstelle. Sie können sie aufrufen, um einen Workflow oder eine Analyse-App auszuführen.
Wenn ein Workflow ohne Aktivierung der AMP Engine gespeichert wurde, gibt es eine /amp Option, mit der Sie einen Workflow oder eine Analyse-App mit der AMP Engine auf der Windows-Plattform ausführen können. Die /amp Option hat denselben Effekt wie das Kontrollkästchen Use AMP Engine auf der Registerkarte Laufzeit in der Workflow-Konfiguration in der Benutzeroberfläche von Designer.
Wenn Sie die Engine nicht angeben, wird die Version der Engine verwendet, die beim Speichern des Workflows festgelegt wurde.
Funktionen
Workflows
AlteryxEngineCmd.exe MyWorkflow.yxmd
Mit dieser Funktion wird ein Standard-Alteryx-Workflow (YXMD) über die Befehlszeile ausgeführt. Sie ist nützlich, um eine Reihe von Workflows, die nacheinander ausgeführt werden sollen, als Batch auszuführen.
Beispiel
AlteryxEngineCmd.exe MyWorkflow1.yxmd
AlteryxEngineCmd.exe MyWorkflow2.yxmd
AlteryxEngineCmd.exe MyWorkflow3.yxmd
Analyse-Apps
AlteryxEngineCmd.exe MyAnalyticApp.yxwz AppValues.xml
Mit dieser Funktion wird eine Analyse-App (YXWZ) unter Verwendung der in AppValues.xml festgelegten Parameter ausgeführt, um die Analyse-App dynamisch zu konfigurieren.
Die einfachste Methode zum Erstellen der Datei AppValues.xml ist das Erstellen einer Analyse-App auf der Alteryx-Oberfläche. Öffnen Sie nach dem Erstellen der App den Schnittstellendesigner > Testansicht > Anzeigen. Fügen Sie die XML-Datei in einen Texteditor ein und speichern Sie die Datei als XML-Datei.
Beispiel
"<WizardValues ShowDebugMessages='False'> <Value name='FILEINPUT'>TEST.CSV</Value> </WizardValues>"
AlteryxEngineCmd.exe AppValues.xml
Diese Funktion ist mit der obigen Option identisch. Anstelle von YXWZ- und XML-Parametern werden jedoch XML-Parameter verwendet und der YXWZ-Verweis in die XML-Datei eingebettet.
Beispiel
"<WizardValues ShowDebugMessages='False'> <Module>MyAnalyticApp.yxwz</Module> <Value name='FILEINPUT'>TEST.CSV</Value> </WizardValues>"
AlteryxEngineCmd.exe "<<raw xml data stream with no quotation marks or line feeds>>"
Diese Funktion fügt die Antworten auf Fragen in eine Analyse-App ein. Die XML-Datei in einer Analyse-App enthält Antworten auf App-Fragen.
Beispiel
AlteryxEngineCmd.exe "<WizardValues ShowDebugMessages='False'><Module>MyAnalyticApp.yxwz</Module><Value name='FILEINPUT'>TEST.CSV</Value></WizardValues>"