Jede Iteration Ihrer Befehlsgruppe erzeugt eine neue Ergebnistabelle oder CSV-Datei mit Daten, die Sie alle in einer Datei zusammenfassen möchten.
Übliche, aber riskante Ansätze
- Option 1: Setzen Sie eine dynamische Kettenvariable
- Begrenzte Skalierbarkeit: Dynamische Variablen haben eine strenge Größenbegrenzung. Selbst wenn Ihre Daten jetzt passen, können sie in der Zukunft an diese Grenze stoßen, wenn die Daten wachsen.
- Stille Fehlschläge: Wenn die Variable das Größenlimit erreicht, tritt in der Kette kein Fehler auf. Die Daten werden einfach abgeschnitten, was zu fehlenden Datensätzen führt.
- Zusätzliche Verarbeitung: Sie müssen die endgültige variable Zeichenfolge immer noch zurück in eine Datei konvertieren, um sie verwenden zu können.
- Option 2: Schreiben Sie jede Datei in eine Wdata-Tabelle
- Langsame Leistung: Dies erfordert mehrere API-Aufrufe mit Authentifizierung für jede einzelne Iteration, was die Ausführung der Kette erheblich verlangsamt.
- Komplizierter Abruf: Sie können die Daten nicht sofort verwenden; Sie müssen eine Abfrage ausführen, um alles wieder zusammenzuführen.
- Bereinigung erforderlich: Wenn Sie die Kette erneut ausführen müssen, müssen Sie zunächst eine zusätzliche Logik erstellen, um die alten Dateien in der Tabelle zu löschen oder zu ersetzen.
- Option 3: Schreiben Sie jede Datei in ein Workiva Spreadsheet
- Langsame Leistung: Wie bei der Wdata-Methode führen die wiederholten API-Aufrufe innerhalb einer Schleife zu langen Ausführungszeiten.
- Hohes Fehlerrisiko: Sie müssen bei jedem Einfügen die exakte Zeilennummer berechnen, da Sie sonst Gefahr laufen, Daten zu überschreiben oder Lücken zu hinterlassen.
Die beste Lösung: Vorherige Ausgabe von Stapeldateien
Wenn die Spalten immer die gleichen Kopfzeilen haben, ist es am besten, den Befehl Tabulatortransformationen Stapeldateien zusammen mit der darin enthaltenen Option zum Stapeln über Befehlsgruppeniterationen hinweg zu verwenden.
Hinweis: Stellen Sie sicher, dass Sie für diesen Anwendungsfall die Stapeldatei "Tabular Transformations" und nicht die gleichnamige Datei der File Utilities verwenden. Dies ist wichtig, weil die Option "File Utilities" die Spaltenüberschriften der Dateien nach der ersten nicht erkennt und entfernt, während die Option "Tabular Transformations" dies tut.
Wenn sich dieser Befehl in einer Befehlsgruppe befindet und die Iteration aktiviert ist, erscheint die variable Option "Previous Stack Files Output" in einem eigenen Abschnitt "Stack Files" im Variablenfenster.
Verwenden Sie diese Variable , gefolgt von einem Komma und dem Befehl, der die Daten enthält, die Sie iterationsübergreifend stapeln möchten.
Hinweis: Es ist wichtig, dass Ihre Kette den Befehl stack files bei jeder Iteration durchläuft und ihn nicht überspringt. Wenn die Kette dies nicht tut, gehen alle vor dieser Iteration gestapelten Daten verloren und es fehlen Daten in der endgültigen Datei.
Jeder Befehl in Ihrer Kette nach der Befehlsgruppe kann dann die Variable Stack Files - "Stack Files Output" verwenden, die dann die vollständige Datei mit allen Iterationen ist.
Andere Hinweise
- Der Befehl file utilities stack file ist nützlich, wenn Sie Datensätze zusammenfügen möchten, für die keine Spaltenüberschriften erforderlich sind, und verfügt über die gleiche Option "Previous Stack Files Output".
- Die Handlebars-Befehle "Textvorlage rendern" und "Dateivorlage rendern" verfügen über die Optionen "Vorheriger gerenderter Text" und "Vorherige gerenderte Datei", die auf die gleiche Weise funktionieren wie die hier gezeigte Option "Vorherige Ausgabe von Stapeldateien" und nützlich sein könnten, um Vorlagen und/oder JSON-Dateien über mehrere Iterationen hinweg zusammenzuhalten.
- Es ist in Ordnung, wenn die neue Datei, die mit dem Befehl stack files gestapelt werden soll, keine Ergebnisse liefert, solange die Spaltenüberschriften vorhanden sind.