您的命令群組 的每次迭代都會產生新的結果表格或 CSV 資料檔案,而您希望將所有結果表格或 CSV 資料檔案合併/組合為一個檔案。
常見但有風險的方法
- 選項 1:設定動態鏈結變量
- 有限的擴充性: 動態變數有嚴格的大小限制。即使您的資料現在適合,未來也可能會因為資料的成長而碰到限制。
- 無聲失敗: 如果變數達到大小限制,鏈結不會出錯;它會直接截斷資料,導致記錄遺失。
- 額外流程: 您仍需將最終的變數字串轉換/兌換回檔案才能使用。
- 選項 2:將每個檔案寫入 Wdata 表格中
- 效能緩慢: 這需要在每次迭代時使用驗證的多重 API 呼叫,這會大幅降低鏈結的執行速度。
- 複雜的擷取: 您無法立即使用資料;您必須執行查詢將所有資料重新聯結在一起。
- 需要清理: 如果您需要重新執行 Chains(自動化工作流程),您必須先建立額外的邏輯,以刪除或取代表格中的舊檔案。
- 選項 3:將每個檔案寫入 Workiva 試算表中
- 緩慢的效能: 與 Wdata 方法一樣,在循環內重覆呼叫 API 會導致執行時間過長。
- 出錯風險高: 您必須為每次插入計算精確的行號;否則,您會冒覆寫資料或留下缺口的風險。
最佳解決方案:上一步/上一個堆疊檔案輸出
如果資料欄總是相同的資料標頭,則最佳解決方案是使用Tabular Transformations Stack Files 命令 及其內建選項,以跨命令群組迭代堆疊。
附註: 對於此使用個案,請務必使用「表格轉換/轉型」堆疊檔案,而非同名的檔案公用程式檔案。這一點很重要,因為檔案公用程式不會識別並移除第一個檔案之後的資料欄標頭,而表格轉換/轉型則會。
當此命令在命令群組中且迭代器開啟時,「上一步堆疊檔案輸出」變數選項會出現在變數面板中其本身的 「堆疊檔案」區段 (UI)/章節下。
使用這個變數,接著是逗號 ,然後是包含您要在迭代中堆疊資料的命令。
附註: 鏈結必須在每次迭代時都執行堆疊檔案命令,而不要跳過。如果鏈結沒有這樣做,則該迭代之前堆疊的任何資料都會遺失,最終的檔案中也會遺失資料。
在命令群組之後的鏈結中的任何命令都可以使用 Stack Files - "Stack Files Output" 變數,這將是包含所有迭代器的完整檔案。
其他附註
- 如果您要聯結不需要資料欄首部標頭的資料集,檔案公用程式堆疊檔案命令會很有用,它也有相同的「上一步堆疊檔案輸出」選項。
- Handlebars 的「渲染文字範本」和「渲染檔案範本」命令有兩個選項,名稱分別是「上一步渲染文字」和「上一步渲染檔案」,操作方式與這裡看到的「上一步堆疊檔案輸出」選項相同,可以用來在不同的迭代器中將範本和/或 JSON 檔案粘在一起。
- 如果要堆疊的新檔案前往堆疊檔案命令沒有結果也沒關係,只要資料欄標頭在就可以了。