“將數據載入到 Wdata”範本通過替換現有資料集或添加新資料集將數據引入 Wdata 表。此範本最常用作現有鏈的一部分，但可以將其添加到需要將數據集上傳到表的任何工作流中。
要求
- 在執行此鏈之前，必須創建目標 Wdata 表。
- 此範本由三個鏈組成。每個鏈必須單獨 發佈 到工作區。
- 檔名必須包含 .csv 或 .tsv 擴展名。例如：「File_Name_Example.csv」。
- 數據集的最大建議檔大小為 300mb。詳細瞭解檔大小建議。
查找範本
將數據載入到 WData 範本位於範本螢幕的「工作鏈」 部分。
以下是找到它的方法：
- 在鏈生成器中，轉到 範本 選項卡。
- 從頂部 功能表中選擇 Workiva 連鎖店 。
- 搜索將數據 載入到 Wdata |主鏈在右上角，然後打開範本。
-
找到範本後，按兩下新建鏈將其部署到工作區。
注意： 配置后，此範本中的每個鏈都必須發佈到工作區。
配置範本
此範本由三個鏈組成：主鏈、替換數據集鏈和添加新數據集鏈。在工作區中部署主鏈時，兩個子鏈（添加/替換）將自動隨之部署。
以下是每個鏈的詳細介紹：
- 主鏈：此鏈確定表中是否存在與鏈載入的數據集同名的數據集。如果找到匹配的數據集，該鏈將捕獲有關匹配數據集的資訊，並根據您為父鏈配置的“Load Method”運行時輸入，將該數據重定向到兩個子鏈之一。
-
替換數據集鏈：此鏈從表中刪除匹配的數據集，並將其替換為新數據集。如果在執行過程中發生錯誤並選擇了回滾選項，則鏈將自動刪除新數據集並恢復到要替換的數據集。
-
添加新數據集鏈：此鏈創建一個新數據集並將其導入表中。新數據集必須具有表中任何其他數據集當前未使用的唯一檔名。
將這組鏈添加到現有鏈時，必須在「運行鏈」節點中配置主鏈的運行時輸入。子鏈不需要任何更改或配置。
您的設定應如下所示：
變數
| 類型 | 名稱 | 目的 |
| 工作區變數 | wsv-wdataLoadWarningThreshold |
此變數充當數據集檔案大小的軟限制。任何超過所選閾值的數據集都將觸發警告。由於處理時間隨著檔大小的增加而增加，因此可以更快地處理較小的數據集。 建議的檔大小提供了充足的警告，表明數據集可能正在接近 Wdata 檔大小限制。觸發警告時，可以考慮重構檔或探索其他選項以處理較大的檔。 建議檔大小：150MB-200MB |
| 動態鏈變數 | 直流汽車鏈結果 | 捕獲鏈在不同階段的狀態。這是必需的，不應更改。 |
運行時輸入
| 運行時輸入 | 目的 | 欄位類型 | 必填 |
| 表格 ID |
輸入數據集將上傳到的 Wdata 表 ID。此 ID 還將用於確定表中是否存在任何重複的數據集。 建議使用工作區變數來存儲表ID;這允許跨多個進程使用範本。 |
文字 | 是 |
| 檔案名稱 |
將導入到 Wdata 表中的數據集的名稱。檔名告訴鏈應替換哪些數據。 檔名要求因所選鏈而異：
注意：檔名必須包含.csv或 .tsv 擴展名。例如：“File_Name_Example.csv” |
文字 | 是 |
| 數據檔 |
將導入到表中的數據檔。擴展名必須為 .csv 或 .tsv。 注： 資料檔可以使用任何受支援的 Wdata 表分隔符。 |
檔案 | 是 |
| 載入方式 |
確定檔是應替換現有數據集還是添加為新數據集。 選項:
|
下拉功能表 |
是 |
| 反轉 |
如果出現錯誤，這將回滾所有更改並重新導入原始數據集。 默認情況下設置為 True 。 僅適用於替換數據集載入方法。 |
布林值（真/假） |
沒有 |
疑難排解
要查看鏈運行歷史記錄（包括錯誤），請執行以下操作：
- 轉到鏈生成器中的「 監視器 」選項卡。
-
將滑鼠懸停在問號上可查看鏈運行的狀態。
如果您的鏈觸發了錯誤或無法更新正確的資料，請執行以下檢查：
- 驗證所有三個鏈是否已發佈到工作區。每個鏈必須單獨發佈。
- 確保數據集使用受支援的分隔符，並且檔名包含.csv或 .tsv 擴展名（“File_Name_Example.csv”）。
- 使用替換數據集載入方法時，請檢查檔名是否與 Wdata 表中的現有檔名匹配。如果不匹配，鏈將簡單地將一個新檔添加到您的表中，而不替換舊檔。
- 相反，使用「添加新數據集載入」方法時，請檢查檔名是否未在 Wdata 表中的其他任何位置使用。如果使用重疊的檔名，鏈將失敗。
- 確保與 Workiva 連接關聯的 OAuth2 授權具有適當的訪問許可權。
- 輸入表ID時，請確保已輸入整個ID，並且沒有前導或尾隨空格。
- 檢查運行時時間戳變數。這些不應在檔名中使用，因為它為每個數據集創建一個唯一的檔名 - 這意味著鏈將無法識別表中任何匹配的數據集。
列映射和其他鏈修改
如果您在導入資料時遇到列標題問題， 可以使用數據準備 或其他命令。
可選：標記導入的數據集
導入數據集時支援標記 ，但我們建議在對原始數據集進行任何更改之前從範本部署一組額外的鏈。修改後，該鏈可能難以重用於其他表，除非這些表中的數據集使用相同的標記。
要向鏈添加標記：
- 將以下執行時輸入 加入到從此樣本部署的三個鏈 中的每一個：
- 標籤鍵（文字欄位）
- 標記值（文字欄位）
- 編輯主鏈以 將執行時輸入傳遞給每個「運行鏈 」事件：
- 在「替換數據集鏈」和「添加新數據集鏈」中，編輯「導入新數據集」命令節點以接受標記運行時輸入。
完成後，導入的數據集將使用提供的標籤鍵和標籤值進行標記。