Konvertierte Alteryx-Apps verwenden

PlaidCloud konvertiert die Fragen von Alteryx-Analyse-Apps in kontrollierte Workflow-Variablen. Benutzer können diese Variablen vor einer Ausführung setzen, und PlaidCloud wendet die Werte dann auf Formeln, Filter, Dateipfade, Bedingungen, Makroparameter und nachgelagerte Schritteinstellungen an.

Das App-Runner-Frontend

Beim Konvertieren einer Alteryx-Analyse-App (.yxwz) wird ihre Oberfläche auch als veröffentlichter Panel-„App Runner“ erzeugt – ein funktionierendes Eingabeformular, das dieselben Werte erfasst wie die Alteryx-Fragen und den konvertierten Workflow damit ausführt. Sie erhalten dieses Frontend automatisch als Teil der Konvertierung; eine App ohne Eingabe- Widgets wird übersprungen.

Die Fragen der App werden zu App-Runner-Steuerelementen: Text, Zahl, Datum, Kontrollkästchen, Optionsfeld, Dropdown-Liste, Listenfeld, Baum, Dateiauswahl und Ordnerauswahl. Jedes Steuerelement schreibt in die Workflow-Variable, die der konvertierte Schritt liest, sodass eine Ausführung aus dem App Runner dieselbe Logik antreibt wie das manuelle Setzen der Variablen. Ein Steuerelement, das nicht an eine echte Workflow-Variable gebunden ist, wird mit einem sichtbaren Hinweis angezeigt, statt stillschweigend einen Wert zu erfassen, der ins Leere geht – prüfen Sie es und verweisen Sie es auf die vorgesehene Variable.

Das Formular ist in der eigenen Gruppierung des App-Autors aufgebaut – den Registerkarten und beschrifteten Feldern, mit denen der Autor die App erstellt hat –, und der erläuternde Text des Autors (Alteryx-Label-Tools) wird im Formular neben den Fragen angezeigt, die er beschreibt. Eine Frage, die die App zur Entwurfszeit festgelegt hat, etwa ein Detour ohne steuernde Oberflächenfrage, wird überhaupt nicht als Frage angezeigt.

Das Formular öffnet sich mit den in den Variablen des Workflows gespeicherten Werten – den Standardwerten des Autors, sofern niemand andere gespeichert hat –, und eine Frage ohne gespeicherten Wert ist leer. Passt ein gespeicherter Wert zu keiner der Auswahlmöglichkeiten einer Frage mehr, wird er ignoriert, statt als veraltete Auswahl angezeigt zu werden. Eine numerische Frage erzwingt das vom Autor festgelegte Minimum, Maximum und die Schrittweite, sodass eine auf einen kleinen Bereich beschränkte Frage nicht außerhalb davon beantwortet werden kann.

Wo sich der konvertierte Workflow verzweigt, zeigt der App Runner die Verzweigung als beschriftete Auswahl an, sodass der Pfad einer Ausführung zur Laufzeit so gewählt wird, wie die Alteryx-App ihn gewählt hat.

Datei- und Ordnerfragen

Jede Datei- oder Ordnerfrage hat eine Schaltfläche Durchsuchen, die einen Dokumentbrowser öffnet, sodass Sie den Pfad auswählen, statt ihn aus dem Gedächtnis einzutippen.

Durchsuchen bietet die Dokumentenkonten an, auf die Sie zugreifen können, standardmäßig das eigene Konto der App, und lässt Sie zwischen ihnen wechseln.
Es öffnet sich in dem Ordner, den die aktuelle Antwort der Frage nennt; hat die Frage noch keine Antwort, öffnet es sich auf der obersten Ebene des Kontos.
Ein Pfad am oberen Rand führt zurück nach oben. Wenn Sie in der Liste einen Ordner wählen, wird er geöffnet; wenn Sie eine Datei wählen, wird sie ausgewählt.
Auswählen zeigt den Pfad an, der eingetragen wird, bevor Sie darauf klicken. Ist nichts markiert, übernimmt Auswählen den Ordner, den Sie gerade ansehen – so wählen Sie die oberste Ebene eines Kontos.
Kann ein Ordner nicht aufgelistet werden, weist die Liste darauf hin und nennt den Grund, und Auswählen trägt keinen Pfad ein, den Sie nicht gesehen haben. Erhält eine Auflistung innerhalb von 20 Sekunden keine Antwort, heißt es, dass das Konto nicht geantwortet hat.

Die App ausführen

Füllen Sie das Formular aus und klicken Sie auf „Ausführen“.

Ihre Antworten gehen mit der Ausführung und gelten nur für diese Ausführung. Sie werden nie im Workflow gespeichert, sodass die Antworten einer Person nie in die Ausführung einer anderen Person gelangen, und zum Ausführen der App ist kein Recht zum Ändern des Workflows nötig – was bei einem Projekt wichtig ist, das Zeilen einschränkt und das nur seine Architects ändern können. Um die Werte zu ändern, mit denen sich das Formular öffnet, speichern Sie sie wie unten beschrieben im Workflow.

Antworten werden geprüft, bevor die Ausführung startet. Auswahlfragen, die nie beantwortet wurden, stoppen die Ausführung vor dem Start und werden benannt, statt mitten in einer Ausführung entdeckt zu werden, die den Großteil einer Stunde dauern kann.

Während eine Ausführung läuft, zeigt das Formular einen Fortschrittsbalken, N of M steps im Verhältnis zur Gesamtzahl der Schritte des Workflows, die verstrichene Zeit und den oder die aktuell laufenden Schritte. „Anhalten“ und „Beenden“ erscheinen neben „Ausführen“ nur, während eine Ausführung läuft; „Anhalten“ wird zu „Fortsetzen“, solange die Ausführung angehalten ist.

Ein fehlgeschlagener Schritt wird im Formular benannt, sobald er fehlschlägt, und wenn die Ausführung endet, zitiert das Formular, was jeder fehlgeschlagene Schritt gemeldet hat. Sie müssen den Workflow nicht öffnen, um herauszufinden, warum er angehalten hat. Schritte, die nicht ausgeführt werden konnten, weil ein vorheriger Schritt fehlgeschlagen ist, werden separat als nicht ausgeführt statt als Fehler angezeigt, und sie zählen weiterhin zum Fortschrittsbalken, sodass dieser das Ende erreicht.

Eine Ausführung läuft weiter, wenn Sie die Seite schließen oder die Verbindung verlieren. Öffnen Sie die App erneut, während diese Ausführung noch läuft, zeigt sie die laufende Ausführung mit „Anhalten“ und „Beenden“ statt eines untätigen Formulars.

Ein Link Workflow öffnen neben „Ausführen“ öffnet den zugrunde liegenden Workflow in PlaidCloud in einem neuen Tab – auf seiner Arbeitsfläche, wenn es ein DAG-Workflow ist. Er funktioniert auch dann, wenn die eigene Ansicht des Formulars für eine Ausführung nicht mehr aktualisiert wird.

Sie können den Workflow weiterhin direkt ausführen, indem Sie wie unten beschrieben seine Variablen setzen; der App Runner ist ein zusätzlicher Zugang im App-Stil.

Die App aktuell halten

Eine App-Runner-App ist eine Panel-Server-App, deren app.py, widget_map.py und requirements.txt PlaidCloud generiert. Wenn PlaidCloud den App Runner aktualisiert, übernehmen Ihre vorhandenen Apps die neue Version selbstständig: Jede wird auf die aktuellen Dateien aktualisiert und neu erstellt, wenn PlaidCloud das nächste Mal aktualisiert wird, und erneut, sobald Sie die App auf dem Bildschirm Meine Panel-Apps neu erstellen oder bearbeiten. Die Einstellungen der App und ihr Workflow bleiben unberührt.

Eine gesperrte App bleibt unverändert. Entsperren Sie sie und klicken Sie auf Neu erstellen, um sie auf den neuesten Stand zu bringen.
Manuelle Änderungen an den generierten Dateien werden ersetzt. Eine Aktualisierung schreibt die aktuellen Dateien app.py, widget_map.py und requirements.txt über Ihre Änderungen. Der Git-Verlauf der App behält die früheren Versionen.

Konvertierte Eingabetypen

PlaidCloud konvertiert gängige Alteryx-App-Steuerelemente in typisierte Workflow-Eingaben:

Textfelder werden zu Textvariablen.
Numerische Steuerelemente werden zu numerischen Variablen.
Datumssteuerelemente werden zu ISO-Datumsvariablen.
Kontrollkästchen, Optionsfelder, Dropdown-Listen, Listenfelder und Bäume werden zu kontrollierten Auswahlvariablen.
Dateiauswahl-Steuerelemente werden zu Document-Dateivariablen.
Ordnerauswahl-Steuerelemente werden zu Document-Ordnervariablen.

Der konvertierte Workflow verwendet diese Variablen überall dort, wo die Alteryx-App den ursprünglichen Wert der Frage verwendet hat.

Werte vor einer Ausführung setzen

Vor der Ausführung eines konvertierten App-Workflows:

Workflow öffnen.
Prüfen Sie die Workflow-Variablen.
Setzen Sie die erforderlichen Text-, numerischen, Datums-, Auswahl-, Datei- und Ordnerwerte.
Prüfen Sie, dass Document-Datei- und Ordnerpfade auf den importierten Abhängigkeitsspeicherort oder einen anderen genehmigten Document-Pfad verweisen.
Den Workflow ausführen.

Speichern Sie für geplante Ausführungen die Variablenwerte, die bei jeder Ausführung des Zeitplans verwendet werden sollen.

Bedingungen, Warnungen und Fehler

Bedingungen und Fehlerprüfungen von Alteryx-Apps werden in PlaidCloud-Schrittbedingungen konvertiert. Eine Bedingung kann:

Den Workflow fortsetzen lassen.
Eine Warnmeldung ausgeben.
Den Workflow mit einem eindeutigen Fehler anhalten, wenn die App-Regel dies verlangt.
Die Ausführung über einen anderen Zweig leiten.

Verwenden Sie dieses Verhalten, um die Validierung auf App-Ebene beizubehalten, während der Workflow in PlaidCloud ausgeführt wird.

Datei- und Ordnereingaben

Datei- und Ordnerfragen verwenden Document-Pfade:

Dateieingaben wählen eine Datei aus Document aus.
Ordnereingaben wählen einen Document-Ordner aus.
Importierte Desktop-Abhängigkeiten werden im beim Import gewählten Document-Pfad gespeichert.
Dynamic-Input-Schritte können Variablen verwenden, um den endgültigen Document-Pfad zur Laufzeit aufzulösen.

So bleiben konvertierte Apps über Benutzer und geplante Ausführungen hinweg portabel.

Makroparameter

Ruft eine konvertierte App ein Makro auf, können App-Variablen Makroparameter speisen. PlaidCloud übergibt diese Werte über die Behandlung von Makroeingaben und Steuerparametern an den generierten Makro-Workflow.

Gleichzeitige Makroausführungen sind isoliert, sodass mehrere Workflow-Ausführungen dasselbe konvertierte Makro verwenden können, ohne Zwischenzustände zu teilen.

Validierungs-Checkliste

Prüfen Sie für jede konvertierte App:

Jede erwartete Frage erscheint als Workflow-Variable.
Die Standardwerte entsprechen der ursprünglichen App, wo Standardwerte konfiguriert waren.
Kontrollierte Listen enthalten die erwarteten Auswahlmöglichkeiten.
Datei- und Ordnervariablen verweisen auf Document-Pfade.
Bedingungen erzeugen die erwarteten Meldungen, Warnungen oder das erwartete Stoppverhalten.
Die Ausgabeparität wird für die gewählten Variablenwerte erreicht.