Ihren ersten Alteryx-Workflow migrieren
~30 Minuten · eine Bereitschaftsprüfung, ein Import, eine validierte Ausführung
Bringen Sie einen Alteryx-Workflow vollständig nach PlaidCloud: Prüfen Sie, ob er bereit ist, importieren und konvertieren Sie ihn, lesen Sie, was sauber konvertiert wurde und was einen Blick erfordert, und führen Sie ihn aus. Dies ist eine erste Migration, die Vertrauen aufbauen soll – keine erschöpfende Tour. Wählen Sie einen Workflow, den Sie gut kennen, und idealerweise einen, für den Sie eine bekannte korrekte Ausgabe haben, damit Sie beurteilen können, ob die konvertierte Ausführung stimmt.
Der Importer von PlaidCloud bewahrt den Workflow-Graphen, lädt referenzierte Dateien in Document hoch, erzeugt Makro-Workflows und ordnet jedes Alteryx-Werkzeug einem nativen Workflow-Schritt oder einem verwalteten Executor zu. Der größte Teil eines Workflows lässt sich mit wenig manuellem Aufwand konvertieren – und der ehrliche Teil dieses Tutorials ist der Rest: Einige Werkzeuge erfordern Aufmerksamkeit, und PlaidCloud sagt Ihnen genau, welche, sodass Sie direkt dorthin gehen können.
Voraussetzungen
Abschnitt betitelt „Voraussetzungen“- Ein PlaidCloud-Workspace und ein Projekt, in das importiert wird. Verwenden Sie ein eigenes Migrationsprojekt, damit sich Abhängigkeiten leicht prüfen lassen.
- Eine Alteryx-Workflow-Datei –
.yxmd(Workflow),.yxwz(Analyse-App) oder.yxmc(Makro). - Die Dateien, die dieser Workflow zur Laufzeit liest, zusammen mit ihm aufbewahrt.
- Ein Dokumentenkonto und ein Ordner, in dem PlaidCloud die importierten Dateien speichern kann.
Schritt 1: Bereitschaft prüfen
Abschnitt betitelt „Schritt 1: Bereitschaft prüfen“Ein sauberer Import beginnt mit einem vollständigen Paket. Stellen Sie alles zusammen, was der Workflow berührt, bevor Sie den Importer öffnen:
- Die Workflow-Datei selbst sowie alle Makros, die sie aufruft – einschließlich verschachtelter Makros – als
.yxmc-Dateien. - Eingabedateien: CSV, TSV, Excel, Access, YXDB, XML, JSON und Datenbankextrakte.
- Räumliche Begleitdateien im selben Ordner – Shapefile-Gruppen (
.shp,.shx,.dbf,.prj), MapInfo-Gruppen (.tab,.map,.id,.dat) und alle Projektionsdateien. Fehlende Begleitdateien sind eine häufige Ursache für räumliche Abweichungen. - Berichtsressourcen, auf die der Workflow verweist: Bilder, PDFs, Vorlagen und Kartenebenen.
- Bei einer Analyse-App die Werte, die Benutzer normalerweise eingeben – Text, Zahlen, Datumsangaben, Datei- und Ordnerauswahlen sowie Auswahlen per Dropdown oder Kontrollkästchen. Sie werden zu Workflow-Variablen, die Sie vor einer Ausführung festlegen.
Entscheiden Sie dann zwei Dinge: den Dokumentordner, der die hochgeladenen Dateien aufnimmt, und ob Sie diesen Workflow strukturell validieren (wird er konvertiert und ausgeführt?) oder anhand bekannter korrekter Ausgaben (liefert er dieselben Ergebnisse?).
Bringen Sie die bekannte korrekte Ausgabe mit. Wenn Sie ein vertrauenswürdiges Ergebnis aus der Alteryx-Ausführung haben, bewahren Sie es zusammen mit dem Paket auf. Es macht in Schritt 4 aus „es lief“ ein „es ist korrekt“.
Die Checkliste zur Alteryx-Migrationsbereitschaft ist die vollständige Version dieses Schritts für den Fall, dass Sie von einem Workflow zu einem Portfolio übergehen.
Schritt 2: Importieren und konvertieren
Abschnitt betitelt „Schritt 2: Importieren und konvertieren“- Öffnen Sie Ihr Zielprojekt in PlaidCloud.
- Öffnen Sie Werkzeuge → Alteryx-Workflow importieren.
- Wählen Sie das Zielprojekt und Ihre
.yxmd-,.yxwz- oder.yxmc-Datei aus. - Legen Sie optional Präfixe für Workflow-, Schritt- und Tabellennamen fest. Tabellennamen tragen bereits den Namen des jeweiligen Workflows als Präfix, daher braucht ein einzelner Workflow kein eigenes Präfix.
- Wählen Sie das Dokumentenkonto und den Ordner für die importierten Dateien.
- Fügen Sie alle referenzierten Dateien oder Ordner hinzu, die der Workflow zur Laufzeit benötigt.
- Starten Sie den Import.
Wenn der Import abgeschlossen ist, ersetzt das Fenster sein Formular durch einen Konvertierungsbericht: wie viele Schritte mit hoher Konfidenz zugeordnet wurden, wie viele geprüft werden müssen und – falls es welche gibt – eine Tabelle, die jeden Schritt mit niedrigerer Konfidenz, seine Operation, seine Konfidenz und Hinweise nennt. Dieser Bericht ist das Herzstück der Migration. Jeder markierte Schritt trägt denselben Hinweis außerdem in seiner Schrittnotiz auf der Arbeitsfläche, sodass Sie direkt zu ihm springen können.
PlaidCloud speichert die importierten Abhängigkeiten im gewählten Dokumentordner und lässt die konvertierten Schritte auf diese Pfade verweisen, sodass der Workflow ohne Desktop-Dateisystem wiederholbar ausgeführt wird.
Kommentare und Container werden mitgenommen. Kommentarfelder kommen als Notizen und Hervorhebungsfelder an, und Tool Containers werden zu Gruppen – sie erklären den Workflow genau wie in Alteryx und fügen keine Laufzeitarbeit hinzu. Auch das Gate eines Control Container bleibt erhalten: Seine Schritte werden so importiert, dass sie nur ausgeführt werden, wenn die gesteuerten Daten Zeilen enthalten.
Schritt 3: Prüfen, was konvertiert wurde und was Aufmerksamkeit braucht
Abschnitt betitelt „Schritt 3: Prüfen, was konvertiert wurde und was Aufmerksamkeit braucht“Öffnen Sie den erzeugten erweiterten Workflow und arbeiten Sie den Konvertierungsbericht von oben nach unten ab. Die meisten Schritte werden mit hoher Konfidenz konvertiert und erfordern nichts von Ihnen. Bei den markierten Schritten verdient sich eine erste Migration ihr Vertrauen – lesen Sie jeden Hinweis und entscheiden Sie.
So sieht eine teilweise Konvertierung aus und was die einzelnen Fälle bedeuten:
| Was Sie sehen | Was es bedeutet | Was zu tun ist |
|---|---|---|
| Schritt mit hoher Konfidenz | Sauber einem nativen Schritt oder Executor zugeordnet | Nichts – bei Bedarf stichprobenartig prüfen |
| Zur Prüfung markierter Schritt | Konvertiert, aber mit einem Vorbehalt, den Sie bestätigen sollten | Lesen Sie den Hinweis; prüfen Sie das Ergebnis anhand Ihrer Erwartungen |
| Als nicht konvertiert markierter Schritt | Der Importer hat abgelehnt, statt falsch zu raten | Beheben Sie die Ursache in Alteryx und importieren Sie erneut, oder bauen Sie den Schritt von Hand |
| Verweis auf eine noch nicht vorhandene Tabelle | Ein Calgary- oder extern erstellter Datensatz, den der Workflow nicht erzeugt hat | Laden Sie die genannte Tabelle vor der Ausführung |
Einige Markierungen, auf die Sie bei einer ersten Migration wahrscheinlich stoßen:
- Zufallsstichproben (Create Samples, Random % Sample) übernehmen Größen und Anteile exakt, aber PlaidCloud zieht eigene Datensätze – validieren Sie diese anhand von Anzahlen und Anteilen, nicht anhand der Frage, welche Zeilen wo gelandet sind.
- XGBoost-Modelle werden als gradientenbeschleunigter scikit-learn-Klassifikator konvertiert; erwarten Sie statistische Äquivalenz, keine identischen Werte, und prüfen Sie die Hinweise des Schritts.
- Ein nicht konvertierter Schritt schlägt absichtlich fehl, wenn der Workflow ihn erreicht, damit eine Konvertierung mit ungelöstem Gate oder fehlender Tabelle nicht durchlaufen werden kann, als wäre nichts falsch. Diese Offenheit ist gewollt – der Importer weigert sich, eine falsche Zahl als richtige auszugeben.
Eine grüne Ausführung ist nicht automatisch eine korrekte. Der Bericht sagt Ihnen, wo Sie hinschauen sollten; die Validierung im nächsten Schritt sagt Ihnen, ob Sie den Zahlen vertrauen können. Überspringen Sie sie nicht bei einem Workflow, auf dessen Ausgabe sich jemand verlässt.
Den vollständigen Katalog dazu, wie die einzelnen Werkzeugfamilien konvertiert werden, finden Sie in der Alteryx-Konvertierungsmatrix.
Schritt 4: Variablen festlegen, ausführen und validieren
Abschnitt betitelt „Schritt 4: Variablen festlegen, ausführen und validieren“- Prüfen Sie auf der Arbeitsfläche des konvertierten Workflows die erzeugten Schritte und Verzweigungen.
- Legen Sie alle Workflow-Variablen fest – das sind Ihre konvertierten App-Fragen und Laufzeitparameter. Lassen Sie Datei- und Ordnervariablen auf die Dokumentpfade aus Schritt 2 verweisen und verwenden Sie dieselben Werte wie bei der Alteryx-Ausführung.
- Klicken Sie beim Workflow (nicht bei einem einzelnen Schritt) auf Ausführen und beobachten Sie im Protokoll, wie die Schritte der Reihe nach ausgeführt werden.
- Prüfen Sie den Ausführungsverlauf, die Schrittausgaben und alle Bereitschaftshinweise.
Validieren Sie dann auf der Ebene, die Sie in Schritt 1 gewählt haben:
- Strukturell – Der Workflow wurde geöffnet, der Graph hat die erwarteten Verzweigungen und Makros, die Eingaben wurden hochgeladen, die Variablen sind erschienen, und die Ausführung wurde abgeschlossen. Ausreichend für Bereitschaft und Inventar.
- Ausgabeparität – Vergleichen Sie Schema, Zeilenanzahl und Zeilenwerte mit Ihrer vertrauenswürdigen Alteryx-Ausgabe. Die Zeilenreihenfolge wird ignoriert, sofern der Workflow nicht ausdrücklich sortiert. Prüfen Sie außerdem Null-Behandlung, numerische Genauigkeit, Datumswerte und Geometrie, soweit zutreffend.
Weicht ein Vergleich ab, arbeiten Sie die Ursachen der Reihe nach ab: fehlende oder andere Eingabedateien, andere Variablenwerte, andere Quell-Snapshots, dann Unterschiede bei Null, Datum, Rundung oder Sortierung (Collation), dann räumlicher Bezug oder Geometrieformat. Beheben Sie die Ursache, führen Sie erneut aus und vergleichen Sie erneut. Der Validierungsleitfaden enthält die vollständige Checkliste.
Erneutes Importieren ist unbedenklich. Wenn Sie ein Paket korrigieren und erneut importieren, erhält es eigene Tabellen, statt den ersten Import zu überschreiben – löschen Sie den früheren Workflow und seine Tabellen, sobald Sie mit dem neuen zufrieden sind.
Sie haben einen Workflow migriert
Abschnitt betitelt „Sie haben einen Workflow migriert“Sie haben einen Alteryx-Workflow von der Bereitschaftsprüfung bis zu einer validierten PlaidCloud-Ausführung gebracht und – ebenso wichtig – können nun den Konvertierungsbericht lesen, um zu erkennen, was sauber konvertiert wurde und was einen Blick braucht. Das ist der gesamte Kreislauf. Wiederholen Sie ihn pro Workflow, und migrieren Sie bei einem größeren Portfolio in Stapeln in ein eigenes Projekt.
Wie es weitergeht
Abschnitt betitelt „Wie es weitergeht“- Alteryx-Workflows migrieren – die vollständige Migrationsreferenz, einschließlich Makros, Berichte, Raumdaten und Calgary-Datenbanken.
- Checkliste zur Alteryx-Migrationsbereitschaft – die vollständige Checkliste zur Paketvorbereitung für Portfolio-Migrationen.
- Konvertierte Alteryx-Workflows validieren – strukturelle, ausgabebezogene, Makro- und Artefaktvalidierung im Detail.
- Konvertierte Alteryx-Apps verwenden – konvertierte Analyse-Apps mit kontrollierten Workflow-Variablen ausführen.
- Alteryx-Importe optimieren – Abhängigkeiten vervollständigen, Makros auflösen und Validierungsunterschiede interpretieren.
- Daten laden, transformieren und veröffentlichen – bauen Sie einen PlaidCloud-Workflow von Grund auf, um die nativen Bausteine kennenzulernen.