使用 Workiva 連接解決方案時，有多種方式可更新 Workiva Spreadsheet 中的資料。 使用 Wdata 時，可建立輸入連線 ，從 Wdata 查詢刷新試算表中的資料。 在這篇文章中，我們將探討如何使用Write Sheet Data 和Overwrite Sheet Data 指令來使用 Chain 更新試算表中的資料。
共用指令輸入
Write Sheet Data（寫入工作表資料）和 Overwrite Sheet Data（覆寫工作表資料）命令有幾個輸入在兩個 Commands（命令）中是相同的。
| 輸入 | 目的 |
| 試算表 ID | 要寫入資料的 Workiva 試算表的ID 。 |
| 工作表 ID/名稱 |
寫入資料的工作表名稱或ID 。 名稱為CASE-SENSITIVE 。 |
| 資料檔案 |
包含應寫入工作表的分隔資料的檔案。 CSV 是最常見的檔案格式，但也支援其他分隔符。 JSON 資料必須轉換為分隔格式才能使用此指令。 |
| 分隔符號 |
檔案分隔符。 逗號 (,) 是最常見的分隔符，但也支援任何分隔符，包括分號 (;) 、管道 (|) 或 tab (\t)。 確保包含指定分隔符的資料欄位以雙引號括起。 例如，在逗號分隔檔案中： Workiva, "Ames, IA, USA",WK |
| Region (Write Sheet Data) /Start Cell (Overwrite Sheet Data) (覆寫工作表資料) |
寫入資料的起始儲存格位址。 有關有效 值的其他資訊，請參閱以下各命令的特定章節。 |
| 使用異步 |
勾選時，Command 將執行工作表的異步更新。 這表示當工作表更新作業仍在平台中執行時，Chain 將進行下一個作業。 此選項建議用於大型資料集，但前提是後續 Chain 作業不依賴工作表更新。 |
| 使用平台 API |
選取時，指令會使用 Platform API 執行更新，而非傳統的試算表 API。 平台 API 是，建議使用 ，因為這是較新的 API，並持續增強其他功能。 |
寫入工作表資料
當需要更新工作紙中的特定區域，同時保留工作紙中其他區域的資料時，最好使用 Write Sheet Data（寫入工作紙資料）指令。 下表概述指定的各 Region 格式的清除行為。
| 格式 | 範例 | 效果 |
| 單一單元格位址 | B2 |
更新工作表內的單一儲存格，不影響其他儲存格的值。 除非寫入單一單元格值，否則不建議使用此格式而非 。 如果資料檔案包含多於單一資料點，則使用此格式的 Command 將會失敗。 |
| 起始儲存格位址，無結束儲存格或列 | B2: |
更新以起始儲存格位址開始的工作表。 保留起始儲存格位址左側（列）和上方（行）的工作表值；即使資料檔案不包含該行或列中的儲存格值，也會清除所有其他值。 |
| 起始儲存格位址，結尾列無結尾行 | B2:D |
更新以起始儲存格位址開始的工作表。 保留起始儲存格位址左側（列）及上方（行）的工作表值；即使資料檔案不包含該行或列中的儲存格值，也會清除所有其他值。 |
| 起始儲存格位址、結束儲存格位址 | B2:D5 |
取代指定範圍內的所有儲存格。 注意 ：如果命令中指定的範圍小於正在載入的資料檔案（少於行或列），則命令將失敗。 |
覆寫工作表資料
需要清除工作表中的整個區塊時，最好使用覆寫工作表資料指令。 下表概述了指定的每種起始單元格格式的清除行為。
| 格式 | 範例 | 效果 |
| 單一單元格位址 | B2 |
保留起始儲存格位址左側（列）及上方（行）的工作表值；清除工作表中的所有其他值，並從指定的儲存格位址開始寫入資料檔案中的資料。 |
| 起始儲存格位址，無結束儲存格或列 | B2: |
保留起始儲存格位址左側（列）及上方（行）的工作表值；清除工作表中的所有其他值，並從指定的儲存格位址開始寫入資料檔案中的資料。 |
| 起始儲存格位址，結尾列無結尾行 | B2:D |
此格式為不支援 ，並會導致 Command 執行錯誤。 |
| 起始儲存格位址、結束儲存格位址 | B2:D5 |
保留起始儲存格位址左側（列）和上方（行）的工作表值；清除工作表中的所有其他值，並從指定的儲存格位址開始寫入資料檔案中的資料。 資料檔案的寬度 (列) 和高度 (行) 無關。 |
試用
已建立連鎖範本和測試試算表，可讓您查看上述Start Cell/Region 各種格式的結果。 進行測試：
- 從連結下載測試試算表 (25 KB) 並匯入 到您的工作區。
- 建立測試鏈，利用使用鏈更新 Workiva 試算表 在中找到的模板 4. 快速入門指南 -> 啟用與使用範例 Template 資料夾。
- 建議將Spreadsheet ID Template Variable 對應為Chain Variable 。
- 在工作區中執行 Chain 前，更新試算表 ID Chain 變數 。
- 確保 Workiva Chains連接 中的使用者擁有file:write scope ，且使用者已被指派給匯入的試算表。
- 執行 Chain 並檢查結果。 預期結果概述於匯入試算表的預期結果 頁上。