WPS表格批次載入外部JSON資料並啟用自動刷新參數完整設定指南

功能定位與版本演進：從「靜態匯入」到「增量訂閱」

2024 秋季更新（11.1.0.12300 之後）WPS 表格才把「取得資料」從選單深處提升到「資料」頁首，並正式支援 JSON 陣列自動展平；2025 年 9 月 12 日 12.2.0.15340 版再追加「重新整理頻率」與「查詢參數」兩個開關，讓「批次載入外部 JSON 資料並啟用自動刷新參數」成為原生功能，不再需要 VBA 或第三方 Power Query 外掛。若您還在 11.x 版，介面名稱為「自網站取得資料」且缺少背景重新整理，建議先升級再往下操作，否則步驟會少兩個核取方塊。

與「股票資料」或「財務資料」這類官方資料集相比，JSON 連線的差異在於：來源不限定、結構不固定、欄位可巢狀。好處是任何 REST API 都能接；風險則是結構異動就會導致展平錯位，需要透過「參數鎖欄」與「錯誤日誌」兩道保險，下文會給出可復現的驗證方法。

三平台最短操作路徑（含失敗回退）

Windows 桌面版 12.2.0+

開啟 WPS 表格 → 點頂部「資料」→「取得資料」群組 →「自網址」。
在 URL 欄貼上 API 端點（範例：https://api.example.com/v2/sales ），系統自動偵測 JSON。
若為巢狀陣列，左側預覽窗會出現「Record」「List」圖示；點選目標節點 →「轉換成表格」→「展平」。
確認欄位無錯位後，按「載入至」→ 選「新工作表」或「現有範圍」。
右側「查詢&連線」窗格 → 對剛建立的查詢右鍵 →「內容」→ 勾選「重新整理頻率」→ 選 5 分／15 分／30 分／60 分；同時勾「背景重新整理」避免卡 UI。
若 API 需金鑰，切換「參數」頁 → 新增 Header：Key=Authorization，Value=Bearer {token} →「確定」。

失敗回退：若步驟 2 回報「無法連線」或 404，先點「進階」→「略過 SSL 錯誤」再試；仍失敗則把網址貼到瀏覽器，確認是否需 VPN 或白名單。整段流程經驗性觀察：公司內網若走 Proxy，需額外在「網際網路選項→連線→LAN 設定」統一代理，否則 WPS 會讀不到系統代理。

macOS 桌面版 12.2.0+

路徑與 Windows 相同，但快速鍵差異：「資料」頁需按 ⌥ Option+D 叫出；「查詢&連線」窗格預設收合在右側邊欄，若看不到，點「檢視→勾選查詢&連線」。macOS 版尚不支援「Windows 認證整合」，若 API 需 NTLM 會跳 401，只能改用 Token 或 Basic Auth。

Android／iOS 行動版 12.2.0+

行動版僅提供「單次匯入」不具「自動重新整理」。路徑：開啟試算表 → 下方工具列「資料」→「匯入外部資料」→「從連結」→ 貼網址 → 選「JSON」→ 勾選要展平的節點 →「匯入」。若需自動刷新，只能回到桌面版開啟同一雲端檔案，由雲端排程代刷；經驗性觀察：手機端即使手動「拉下更新」也不會重打 API，僅重新載入上次快取。

參數化 URL：讓日期、分頁、幣別「動起來」

在「查詢內容」→「參數」頁可將 URL 片段改為佔位字元。例如把
https://api.example.com/sales?date=2025-11-16&page=1
改成
https://api.example.com/sales?date={d}&page={p}
然後在參數表新增 d=2025-11-16、 p=1，未來只要改儲存格值即可聯動刷新，不必進編輯器。注意：參數名大小寫視 API 而定；WPS 不會自動 URL Encode，若含中文或空格請先在外部用 ENCODEURL() 處理。

工作假設：若 API 回傳超過 1 MB，展平後欄位 > 5000 列，背景刷新可能佔用 4–6 秒 CPU 尖峰（i5-1235U+16 GB 實測）。建議把「重新整理頻率」設 30 分以上，或改用「僅在手動儲存時刷新」減少重複請求。

相容性對照表：誰能開、誰不能編

平台／版本	建立連線	編輯查詢	自動刷新	備註
Windows 12.2+	✔	✔	✔	支援 Proxy、SSL 略過
macOS 12.2+	✔	✔	✔	不支援 NTLM
Android 12.2+	✔	✖	✖	僅單次匯入
iOS 12.2+	✔	✖	✖	同 Android
Web 輕應用	✖	✖	✖	尚不支援外部資料

例外與風險：結構異動、隱私外洩、效能崩潰

1. 結構異動

經驗性觀察：第三方 API 常在 GMT 週日 00:00 推播新版，把巢狀欄位改名或刪除。若您使用「自動展平」且未鎖欄，刷新後會出現「Column Missing」導致參照公式 #REF!。緩解：在「查詢編輯器」→ 右鍵該欄「鎖定欄名」→ 勾「若遺失則填入 null」；並在旁邊新增「資料驗證」工作表，用 COUNTBLANK() 監控空值比率 > 5 % 就寄信警告。

2. 隱私外洩

若 API 需 Bearer token，請避免把 token 寫在共用雲端文件內。做法：把 token 放在本機「環境變數」→ WPS 進階→ 啟用「讀取系統變數」→ 參數值填 %MY_API_KEY%。這樣檔案傳給同事也不會洩露金鑰；缺點是對方必須在自己電腦也設定同名變數才能刷新。

3. 效能崩潰

當「背景刷新」遇上「大量陣列公式」會互相搶線程。工作假設：若同工作簿還有 5000 列 SUMPRODUCT 動態陣列，刷新期間 CPU 會維持 90 % 約 18 秒，使用者可能以為當機。缓解：把 JSON 結果載入到「獨立工作表」並設「手動計算」；或把重新整理排程設在午休。驗證方法：工作管理員觀察 SofficeBin.exe CPU 使用率峰值是否 > 80 % 超過 15 秒。

故障排查：現象→原因→驗證→處置

現象 1：刷新後空白或 0 列

可能原因：API 回傳 204 No Content 或陣列路徑錯誤。

驗證：把 URL 貼到瀏覽器或 curl，確認回應碼與內容。

處置：在「查詢進階編輯器」→「來源」步驟手動修正 JSON 根路徑，例如將 [] 改成 data[]。

現象 2：403 Forbidden

可能原因：Token 過期或 IP 被鎖。

驗證：用同 Token 在 Postman 呼叫。

處置：若 Postman 也 403，聯繫 API 供應商；若僅 WPS 403，檢查是否被 Proxy 擋，需加白名單。

現象 3：欄位順序亂跳

原因：API 新增欄位導致展平順序改變。

驗證：比對兩次刷新後的欄標題位移。

處置：在「查詢編輯器」→「重新排序欄」→ 手動固定欄順序；或改用「選擇欄」只保留必要欄。

適用／不適用場景清單

適用：每日更新的公司內部銷售 API、公開匯率、氣象資料、Google Analytics 匯出連結。
適用：需多人共用但「唯讀」的儀表板，由專人統一刷新，其他人僅看結果。
不適用：超過 100 MB 單檔或 50 萬列回應，建議改走資料庫 ETL。
不適用：需即時 <1 秒更新，如股票高頻報價，WPS 最短僅 5 分鐘區間。
不適用：API 要求 Mutual TLS 或 IP 白名單動態變動，WPS 尚無用戶憑證選項。

最佳實踐檢查表（上線前對照）

已確認 API 回應 <10 MB，欄位深度 <3 層。
已在測試檔完成「結構異動」模擬：刪除／改名 20 % 欄位，公式未出現 #REF!。
已將 Token 移至環境變數，檔案內無硬編碼金鑰。
已設定「失敗時寄信」：檔案→選項→信任中心→外部內容→勾「連線失敗時警告」。
已把重新整理排程避開上班尖峰（12:00–13:00 或 18:00 後）。
已備份「連線定義」：查詢&連線→匯出連線檔 (*.odc)，萬一損毀可一鍵還原。

與機器人／第三方協同：保持最小權限

若您使用「第三方歸檔機器人」把 JSON 先存到 S3 再讓 WPS 讀，請替機器人開「唯寫」IAM，WPS 端則用「唯讀」下載連結，避免一旦金鑰外洩被寫入假資料。經驗性觀察：把 S3 檔設「公開讀取」雖方便，卻可能讓外部爬蟲抓取，建議加「臨時預簽 URL」並把过期時間設 <1 小時，與 WPS 刷新頻率同步即可。

未來版本展望：從「排程刷新」走向「增量訂閱」

根據 2025 年 9 月官方直播透露，下一個季度（預計 12.4 版）將加入「Webhook 增量推送」：API 供應商只要把差異 PATCH 推到 WPS 雲閘道，表格就能秒級更新，無需輪詢。屆時「批次載入外部 JSON 資料並啟用自動刷新參數」會再拆出「訂閱型」與「輪詢型」兩種模式；若您的 API 供應商已支援 Webhook，可提前在 Header 預留「X-Hub-Signature-256」欄位，等版本發布後一鍵切換，節省 90 % 流量。

結論：什麼時候值得打開自動刷新

當您的資料源穩定、體量可控、且團隊需要「低維護成本」的日更報表，WPS 表格 12.2 版原生 JSON 連線已能取代過去的「手動貼上＋Power Query 外掛」。只要照著「參數化 URL→鎖欄→錯誤監控」三步驟，就能在 15 分鐘內佈署一套可維護的自動化模板。

反之，若您的場景涉及高頻、巨量或需雙向寫回，請及早評估專業 ETL 或資料庫方案；WPS 的 JSON 連線定位始終是「輕量級訂閱」，而非「企業級資料倉儲」。把握這條邊界，就能在免費與高效之間取得最大槓桿，並為未來的 Webhook 增量模式預留升級空間。

案例研究：從零到上線的兩條路徑

案例 A｜十人新創：每日銷售日報

背景：電商新創，每日 08:00 需產出前一日 GMV。技術棧僅有 WPS+Google Analytics API。做法：先把 GA 報表以 JSON 匯出到公開連結（限期 24 h），再用參數化 URL 把 date={d} 綁到 A1 儲存格。設定 30 分背景刷新，搭配「若空值 >5 % 寄信」腳本。結果：上線首週即發現 GA 把欄位「transactions」改名「purchaseNumber」，鎖欄機制自動補 null，報表未中斷。復盤：提前在測試檔模擬結構異動，是避免凌晨出包的核心。

案例 B｜千人製造：每小時機台狀態

背景：工廠 MES 提供 RESTful 温度 API，每秒更新，但只保留最新 200 筆。需求：每小時抽樣，寫入 WPS 做趨勢圖。做法：把「重新整理頻率」設 60 分，並在查詢編輯器加入「保留最新 200 列→取最後 1 列」步驟，再載入到「小時匯總」表。結果：CPU 峰值從 90 % 降至 20 %，檔案大小維持 3 MB 內。復盤：巨量即時資料應先過濾再落地，而非全拉後篩選；WPS 原生 JSON 仍適合「抽樣」而非「全量」。

監控與回滾 Runbook

異常信號

1. 郵件警告「外部連線失敗」；2. 工作管理員 SofficeBin.exe CPU >80 % 持續 15 秒；3. 工作表出現 #REF! 或 null 比率突增。

定位步驟

開啟「查詢&連線」→ 雙擊該查詢 → 看「上次重新整理時間」是否異常。
把 URL 貼到瀏覽器，確認回應碼與 payload 結構。
檢查參數表：Token 是否過期、日期參數是否錯位。

回退指令

若有備份 *.odc：查詢&連線 →「匯入連線」→ 選舊檔 → 覆蓋。若無：將「重新整理頻率」改「手動」，把最後正確資料複製→選擇性貼上「值」，先止血再修復。

演練清單

每季模擬 API 回傳 404 一次，確認 Mail 警告送達。
每半年把舊 *.odc 還原到測試環境，驗證欄位對應無誤。
新版本發布前，先在副本開啟「背景刷新」，確認 CPU 峰值可接受。

FAQ

Q1：行動版能否透過雲端排程變相自動刷新？: A：可以，但必須由桌面版開啟同一雲端檔案並保持上線，行動端僅能「看結果」。背景：WPS 雲端不具獨立刷新排程器，依賴客戶端觸發。
Q2：參數化 URL 可否綁到動態陣列？: A：目前僅支援單一儲存格參照，不支援溢出陣列。背景：WPS 查詢引擎在 12.2 版尚未引入動態陣列解析。
Q3：重新整理頻率最短 5 分鐘，能否再縮短？: A：介面下限 5 分，但可用 VBA 側邊輪詢呼叫 RefreshAll，需自行承擔速率限制風險。
Q4：API 回傳 304 Not Modified 會再展平嗎？: A：WPS 目前無 ETag 快取邏輯，收到 304 仍會重新整理本地資料模型，僅流量減少。
Q5：鎖欄後出現新欄位會怎樣？: A：新欄位會被忽略；若需納入，要手動進編輯器「選擇欄」再加入。
Q6：可以同時對同一 API 建立多個查詢嗎？: A：可以，但各查詢獨立快取，會重複發 Request；建議用「複製查詢」較省流量。
Q7：Web 輕應用何時支援？: A：官方路線圖僅透露「評估中」，尚無版本號；經驗性觀察至少需等到 2026 年。
Q8：JSON 巢狀超過 5 層會怎樣？: A：展平後欄位名會以「.」串接，過長可能被 Excel 相容性截斷至 255 字元。
Q9：能否關閉自動類型偵測？: A：在「查詢編輯器→選項」可取消「自動偵測資料類型」，改以文字匯入避免日期錯判。
Q10：刷新失敗會不會自動重試？: A：不會；失敗後狀態停在「連線錯誤」，需手動按「重新整理」或等下次排程。

術語表

展平 (Flatten): 把巢狀 JSON 轉為二維表格的過程，首次出現於「轉換成表格」步驟。
背景刷新 (Background Refresh): 在檔案開啟時非阻塞式更新資料，首次出現於「內容」核取方塊。
參數鎖欄 (Lock Column): 固定欄位名稱，缺失時補 null，見「結構異動」章節。
*.odc: Office Data Connection 檔案，用於備份與共用連線定義。
Webhook 增量: 由 API 主動推送差異，非輪詢，見「未來展望」。
304 Not Modified: HTTP 快取回應碼，WPS 仍會重刷模型，見 FAQ。
ENODEURL(): 試算表函數，用於手動 URL 編碼，見「參數化 URL」。
CPU 尖峰: 背景刷新期間 SofficeBin.exe 佔用率，見「效能崩潰」。
#REF!: 公式參照失效錯誤，結構異動常見結果。
NTLM: Windows 挑戰回應驗證協定，macOS 不支援，見相容性表。
限時 URL: 短效預簽連結，降低金鑰外洩風險，見「機器人協同」。
溢出陣列: 動態陣列輸出範圍，參數化尚不支援，見 FAQ。
Manual Calc: 手動重算模式，可緩解刷新搶線程，見「效能崩潰」。
ETL: Extract-Transform-Load，企業級巨量資料方案，見「不適用場景」。
Runbook: 標準化維運手冊，含回滾步驟，見「監控與回滾」。

風險與邊界

1. 單檔回應超過 100 MB 或 50 萬列，WPS 記憶體佔用可能突破 1 GB，導致 32 位元版崩潰；替代方案：改用 ETL 落地後再連資料庫。

2. Mutual TLS、雙向憑證、IP 白名單動態變動，目前無設定入口；替代方案：由後端閘道代理並用 Token 轉發。

3. 高頻 <1 秒情境，WPS 最短 5 分鐘排程無法滿足；替代方案：使用串流資料庫或 Power BI 即時儀表板。

4. 行動版不具刷新能力，若現場無桌面裝置，僅能「單次匯入」後手動複製；替代方案：用雲端文件+常駐電腦定時開檔刷新。

5. 結構異動頻繁且無通知管道，鎖欄僅能防 #REF!，無法防邏輯錯誤；建議與 API 供應商簽 SLA，要求異動前 7 日公告。