Alteryx-Abhängigkeiten paketieren

PlaidCloud importiert Alteryx-Workflow-Dateien aus Document und verwendet Document-Pfade für Abhängigkeiten und Artefakte. Sie können Dateien in Document hochladen, einen über MCP verbundenen Agenten bitten, Dateien für Sie zu organisieren, oder Document direkt mit gemeinsamem Speicher wie OneDrive, Google Drive, SharePoint, S3, Azure Blob oder SFTP verbinden.

Hochladen oder gemeinsamen Speicher verbinden

Wählen Sie den Quellspeicherort, der am besten zu Ihrer Migration passt:

Das Paket in ein Dokumentenkonto hochladen.
Einen vorhandenen gemeinsamen Speicherort als Dokumentenkonto verbinden.
Einen über MCP verbundenen Agenten bitten, Dateien zu kopieren, zu verschieben, umzubenennen und zu organisieren, die bereits in Document verfügbar sind.

Verbindungen zu gemeinsamem Speicher können den Aufwand für die Migrationsvorbereitung senken, weil das Team die Dateien dort lassen kann, wo es ohnehin zusammenarbeitet:

Empfohlene Ordnerstruktur

Verwenden Sie für jeden Migrationsbatch vor dem Import eine Ordnerstruktur wie diese:

workflow-package/
  workflows/
  macros/
  inputs/
  expected-outputs/
  reports/
  spatial/

Diese Struktur ist optional, erleichtert aber Prüfung und Validierung.

Workflows und Makros

Legen Sie Workflow-Dateien und Makros in vorhersehbaren Ordnern ab:

Legen Sie Dateien .yxmd und .yxwz in workflows/ ab.
Legen Sie Dateien .yxmc in macros/ ab.
Behalten Sie verschachtelte Makros zusammen mit der übrigen Makrobibliothek.
Halten Sie doppelte Makronamen aus demselben Paket heraus, sofern sie nicht absichtlich versioniert sind.

PlaidCloud verwendet Makro-Quelldateien, um PlaidCloud-Makro-Workflows zu erstellen und Makroaufrufe aus konvertierten Workflows zu verbinden.

Eingabedateien

Legen Sie Eingabedaten unter inputs/ ab:

CSV-, TSV-, Festbreiten-, JSON-, XML-, Excel-, Access-, YXDB-, SAS-, SPSS-, Stata-, Avro-, Parquet- und HDF-Dateien.
Lookup-Dateien, die von Formeln, dynamischem Ersetzen, Fuzzy-Matching oder Joins verwendet werden.
Ordner, auf die die Tools Directory und Dynamic Input verweisen.
Flache ASCII-Dateien von Alteryx: Legen Sie die Layoutdatei .flat neben die Daten, die sie beschreibt. Die Spaltenbreiten stehen nur in dieser Datei, und die Konvertierung liest sie, um den Schritt zu erstellen. Eine fehlende Layoutdatei wird also dennoch konvertiert, aber der Konvertierungsbericht nennt die hochzuladende Datei – stellen Sie sie bereit und importieren Sie den Workflow erneut, statt ihn nur erneut auszuführen.

Wenn PlaidCloud das Paket importiert, verweisen die konvertierten Schritte auf die ausgewählten Document-Speicherorte.

Räumliche Dateien

Legen Sie räumliche Dateien unter spatial/ ab und halten Sie Begleitdateien zusammen:

Shapefiles: Fügen Sie .shp, .shx, .dbf und .prj hinzu.
MapInfo-Dateien: Fügen Sie .tab, .map, .id und .dat hinzu.
Fügen Sie Projektionsdateien und Lookup-Layer hinzu, sofern vorhanden.
Halten Sie KML, GeoJSON und andere räumliche Eingaben im selben Abhängigkeitspaket.

Verteilen Sie räumliche Begleitdateien nicht auf mehrere Ordner. PlaidCloud benötigt die vollständige Gruppe, um die Geometrie korrekt zu materialisieren.

Berichts- und Artefaktressourcen

Legen Sie Berichtsressourcen unter reports/ ab:

Bilder, die von den Report-Composer-Tools verwendet werden.
PDF-Eingaben.
HTML-Fragmente oder -Vorlagen.
Kartenebenen, die von Berichtskarten verwendet werden.
Beispiele erzeugter Berichte, wenn eine Artefaktvalidierung erforderlich ist.

Konvertierte Berichtsschritte erzeugen PlaidCloud-Artefakte, die Sie in Document und im Ausführungsverlauf des Workflows prüfen können.

Excel-Vorlagen

Wenn ein Workflow formatierte Ausgaben in eine gestaltete Excel-Vorlage schreibt – die formaterhaltenden Schritte Export to Excel und Export to Excel Sheets –, stellen Sie diese Vorlagenarbeitsmappen zusammen mit den Eingaben im Dokumentenkonto bereit. Legen Sie sie in einem Ordner 04_Templates neben dem Ordner 03_Inputs ab, in dem Sie die Quelldaten bereitgestellt haben, damit der konvertierte Schritt die Vorlage lesen kann, die er füllt.

Erwartete Ausgaben

Legen Sie erwartete Ausgaben unter expected-outputs/ ab:

Vertrauenswürdige Alteryx-Ausgabetabellen.
Erwartete Berichte, PDFs, Karten, Bilder oder Diagramme.
Hinweise zu akzeptierter Zeilenreihenfolge, numerischer Genauigkeit und Datumsbehandlung.

Erwartete Ausgaben sind für die strukturelle Validierung optional und der beste Nachweis für die Validierung der Ausgabeparität.

Externe Verbindungen

Erfassen Sie bei Workflows mit Datenbanken, APIs und Cloud-Quellen:

Name des Quellsystems.
Verbindungstyp.
Namen von Datenbank, Schema, Tabelle, Endpunkt oder Bucket.
Inhaber der Zugangsdaten oder Name des Secrets.
Snapshot-Datum, wenn die Ausgabeparität von einer Momentaufnahme der Quelle abhängt.

Verwenden Sie PlaidCloud-Verbindungen oder -Zugangsdaten für wiederholbare Produktionsausführungen.