自訂表格實作指南

你已經知道要完成的工作，但不想從端點清單反推整個流程；這裡用可執行的請求把常見情境串起來。

前置條件

先確認資料表位於 chatroom、department 或 company 哪個範圍，以及目前使用者在該範圍的角色。每篇指南都會再列出更精確的讀取、寫入、moderator 或 manager 條件。

選擇流程

1. 要把部門資料表交給聊天室代理讀取，從聊天室代理的部門授權開始。
2. 要建立資料表之間的關係與唯讀計算欄位，使用連結、彙總與查找。
3. 要把 CSV、試算表或文件資料帶入資料表，使用檔案匯入。
4. 要讓整份資料集以一次原子切換的方式對讀者可見，使用原子資料集發布。
5. 要保存查詢條件或設計一次性查詢，使用檢視與搜尋。
6. 要稽核變更並建立一個可追溯的新版本，使用歷程與還原。
7. 要分段上傳檔案並把 blob 掛到資料列，使用附件。
8. 要讓外部系統以最小權限寫入，使用回呼整合。
9. 要讓外部網頁顯示即時資料、而且不需要登入，使用把檢視公開出去。
10. 要以 rules 保護資料表、用 trigger 回應寫入，並透過 callback token 完成閉環，使用建立 callback 驅動的自動化。
11. 資料表端的核准規則，見核准流程。
12. 要讓資料表長到上百萬筆之後，列表頁、選單、餘額檢查，以及 agent 或 MCP 的讀取仍然很快，使用大量資料的效能做法。

你會看到什麼

多數指南採用相同結構：前置條件（角色與範圍）、依序可送出的請求、成功後可觀察到的結果、端點錯誤表，以及可直接操作的工具入口。較新的端到端流程——核准流程、原子資料集發布、callback 驅動的自動化與公開檢視——則是編號的逐步導覽，各自帶有自己的檢查。範例 UUID 與資料均為合成值。

常見錯誤

較早的指南不重複抄寫錯誤碼與回應本文，較新的端到端流程也只寫出它們會遇到的拒絕回應；請從每篇指南連到對應端點的「錯誤」表。若仍在選端點，先看參考手冊。

試試看

用 API Playground 組合單一請求；要依序執行支援的完整流程，使用流程精靈。