Konvertierte Alteryx-Apps verwenden
PlaidCloud wandelt die Fragen einer Alteryx-Analyse-App in kontrollierte Workflow-Variablen um. Benutzer können diese Variablen vor einer Ausführung festlegen, und PlaidCloud wendet die Werte anschließend auf Formeln, Filter, Dateipfade, Bedingungen, Makroparameter und nachgelagerte Schritteinstellungen an.
Das App-Runner-Frontend
Abschnitt betitelt „Das App-Runner-Frontend“Die Konvertierung einer Alteryx-Analyse-App (.yxwz) erzeugt auch ihre Oberfläche als
veröffentlichten Panel-„App Runner“ – 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 Festlegen der Variablen. Ein Steuerelement, das an keine echte Workflow-Variable gebunden ist, wird mit einem sichtbaren Hinweis angezeigt, statt stillschweigend einen Wert zu erfassen, der ins Leere läuft – prüfen Sie es und verweisen Sie es auf die vorgesehene Variable.
Das Formular ist in der 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 Werten, die in den Variablen des Workflows gespeichert sind – den Standardwerten des Autors, sofern niemand andere gespeichert hat – und eine Frage ohne gespeicherten Wert bleibt leer. Wenn ein gespeicherter Wert zu keiner der Auswahlmöglichkeiten einer Frage mehr passt, 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 gewählt wird, so wie die Alteryx-App ihn gewählt hat.
Datei- und Ordnerfragen
Abschnitt betitelt „Datei- und Ordnerfragen“Jede Datei- oder Ordnerfrage hat eine Schaltfläche Durchsuchen, die einen Dokumenten-Browser öffnet, sodass Sie den Pfad auswählen, statt ihn aus dem Gedächtnis einzutippen.
- Durchsuchen bietet die Dokumentenkonten an, die Sie erreichen 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.
- Eine Pfadleiste am oberen Rand führt zurück nach oben. Ein Ordner in der Liste wird mit einer Auswahl geöffnet; eine Datei wird mit einer Auswahl markiert.
- Auswählen zeigt den Pfad an, den es einträgt, bevor Sie darauf klicken. Wenn nichts markiert ist, übernimmt Auswählen den Ordner, den Sie gerade ansehen – so wählen Sie die oberste Ebene eines Kontos.
- Wenn ein Ordner nicht aufgelistet werden kann, meldet die Liste dies und nennt den Grund, und Auswählen trägt keinen Pfad ein, den Sie nicht gesehen haben. Eine Auflistung, die innerhalb von 20 Sekunden keine Antwort erhält, meldet, dass das Konto nicht geantwortet hat.
Die App ausführen
Abschnitt betitelt „Die App ausführen“Füllen Sie das Formular aus und klicken Sie auf Ausführen.
Ihre Antworten gehen mit der Ausführung mit 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 – das ist wichtig bei einem Projekt, das Zeilen einschränkt, wo nur seine Architects es ändern können. Um die Werte zu ändern, mit denen sich das Formular öffnet, speichern Sie sie wie unten beschrieben im Workflow.
Die Antworten werden vor dem Start der Ausführung geprüft. 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 gut und gern eine Stunde dauern kann.
Während eine Ausführung läuft, zeigt das Formular einen Fortschrittsbalken, N of M steps bezogen
auf die Gesamtzahl der Schritte des Workflows, die verstrichene Zeit sowie den oder die Schritte,
die gerade laufen. Pause und Beenden erscheinen neben Ausführen nur, solange eine Ausführung läuft;
Pause wird zu Fortsetzen, während die Ausführung pausiert 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 vorangehender Schritt fehlgeschlagen ist, werden getrennt als nicht ausgeführt statt als Fehler angezeigt, und sie zählen weiterhin zum Fortschrittsbalken, sodass dieser sein Ende erreicht.
Eine Ausführung läuft weiter, wenn Sie die Seite schließen oder die Verbindung verlieren. Wenn Sie die App erneut öffnen, während diese Ausführung noch läuft, sehen Sie die laufende Ausführung mit Pause 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 Ansicht des Formulars auf eine Ausführung nicht mehr aktualisiert wird.
Sie können den Workflow weiterhin direkt ausführen, indem Sie seine Variablen wie unten beschrieben festlegen; der App Runner ist ein zusätzlicher, App-artiger Zugang.
Die App aktuell halten
Abschnitt betitelt „Die App aktuell halten“Eine App-Runner-App ist eine Panel-Server-App, deren app.py, widget_map.py und
requirements.txt PlaidCloud erzeugt. Wenn PlaidCloud den App Runner aktualisiert,
übernehmen Ihre vorhandenen Apps die neue Version von selbst: Jede wird beim nächsten Update von PlaidCloud
auf die aktuellen Dateien aktualisiert und neu erstellt, und ebenso immer dann, wenn Sie die App im Bildschirm
Apps Neu erstellen oder bearbeiten.
Die Einstellungen der App und ihr Workflow bleiben unberührt.
- Wo die Dateien liegen. Bei der verwalteten PlaidCloud-Git-Verbindung ist eine App-Runner-
App ein nach der App benannter Ordner im Repository
appsIhres Workspace, neben Ihren anderen Panel-Apps. Eine App, die ein eigenes Repository hatte, wird automatisch in ihren Ordner verschoben, und das alte Repository wird archiviert (schreibgeschützt aufbewahrt, nie gelöscht). Ein Push inappsbaut eine App nur dann neu auf, wenn ihr eigener Ordner oder dierequirements.txtim Stammverzeichnis des Repositorys geändert wurde. - 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 erzeugten Dateien werden ersetzt. Eine Aktualisierung schreibt die
aktuellen Dateien
app.py,widget_map.pyundrequirements.txtüber Ihre Änderungen. Der Git-Verlauf der App bewahrt die früheren Versionen auf.
Konvertierte Eingabetypen
Abschnitt betitelt „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 Dokument-Dateivariablen.
- Ordnerauswahl-Steuerelemente werden zu Dokument-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 festlegen
Abschnitt betitelt „Werte vor einer Ausführung festlegen“Bevor Sie einen konvertierten App-Workflow ausführen:
- Öffnen Sie den konvertierten Workflow.
- Prüfen Sie die Workflow-Variablen.
- Legen Sie die erforderlichen Text-, Zahlen-, Datums-, Auswahl-, Datei- und Ordnerwerte fest.
- Vergewissern Sie sich, dass die Dokument-Datei- und -Ordnerpfade auf den Speicherort der importierten Abhängigkeiten oder einen anderen genehmigten Dokumentpfad verweisen.
- Führen Sie den Workflow aus.
Speichern Sie für geplante Ausführungen die Variablenwerte, die bei jeder Ausführung des Zeitplans verwendet werden sollen.
Bedingungen, Warnungen und Fehler
Abschnitt betitelt „Bedingungen, Warnungen und Fehler“Alteryx-App-Bedingungen und -Fehlerprüfungen werden in PlaidCloud-Schrittbedingungen konvertiert. Eine Bedingung kann:
- den Workflow fortsetzen lassen.
- eine Warnmeldung ausgeben.
- den Workflow mit einem klaren Fehler anhalten, wenn die App-Regel dies verlangt.
- die Ausführung über einen anderen Zweig leiten.
Nutzen Sie dieses Verhalten, um die Validierung auf App-Ebene zu erhalten, während der Workflow in PlaidCloud läuft.
Datei- und Ordnereingaben
Abschnitt betitelt „Datei- und Ordnereingaben“Datei- und Ordnerfragen verwenden Dokumentpfade:
- Dateieingaben wählen eine Datei aus Dokument aus.
- Ordnereingaben wählen einen Dokumentordner aus.
- Importierte Desktop-Abhängigkeiten werden unter dem beim Import gewählten Dokumentpfad gespeichert.
- Dynamische Eingabeschritte können Variablen verwenden, um den endgültigen Dokumentpfad zur Laufzeit aufzulösen.
So bleiben konvertierte Apps über Benutzer und geplante Ausführungen hinweg portabel.
Makroparameter
Abschnitt betitelt „Makroparameter“Wenn eine konvertierte App ein Makro aufruft, können App-Variablen Makroparameter speisen. PlaidCloud übergibt diese Werte über die Verarbeitung von Makroeingabe- und Steuerparametern an den erzeugten Makro-Workflow.
Gleichzeitige Makroausführungen sind voneinander isoliert, sodass mehrere Workflow-Ausführungen dasselbe konvertierte Makro verwenden können, ohne Zwischenzustände zu teilen.
Validierungs-Checkliste
Abschnitt betitelt „Validierungs-Checkliste“Vergewissern Sie sich für jede konvertierte App, dass:
- jede erwartete Frage als Workflow-Variable erscheint.
- die Standardwerte der ursprünglichen App entsprechen, wo Standardwerte konfiguriert waren.
- kontrollierte Listen die erwarteten Auswahlmöglichkeiten enthalten.
- Datei- und Ordnervariablen auf Dokumentpfade verweisen.
- Bedingungen die erwarteten Meldungen, Warnungen oder das erwartete Stoppverhalten erzeugen.
- die Ausgabeparität für die gewählten Variablenwerte besteht.