表單可將資料表轉變為公開的資料收集端點。提交會將資料列附加到資料表,因此您可以在不授予提交者工作區存取權限的情況下,收集申請、註冊、意見回饋、輕量調查或結構化報告。
建立表單
開啟資料表,然後按一下資料表工具列中的表單或收集按鈕。Dokki 會從協作資料表文件讀取即時資料表欄位,並將每個欄位視為一個可能的問題。
設定問題
設定表單標題和可選的描述。
啟用或停用每個欄位作為問題。
自訂每個問題的標籤,而無需重新命名資料表欄位。
當資料列若無值即不應被接受時,將已啟用的問題標記為必填。
已刪除的資料表欄位會從表單設定中移除;當您重新開啟對話方塊時,新的資料表欄位會以停用欄位的形式附加。
開始並分享收集
儲存會儲存設定。開始收集會啟動一個唯一的匿名表單權杖,並在 /form/<token> 顯示分享連結。停止收集會保留設定,但會讓該連結拒絕新的提交。
從其他系統傳送資料列
開啟收集對話方塊中的 Webhook 面板,以複製私人端點、檢查即時欄位結構、複製 cURL 範例,或輪換權杖。
向 webhook URL 傳送
GET要求,以取得公開欄位鍵、類型、必填旗標和允許的選項。傳送帶有
Idempotency-Key標頭和主體為{ \"values\": { \"<field-key>\": \"<value>\" } }的 JSONPOST要求。端點接受最大 1 MB 的主體。當設定 KV 速率限制時,webhook 提交限制為每個 IP 每小時 300 個要求。
將 webhook URL 視為密碼。不要將其放置在客戶端程式碼或公開文件中。輪換權杖會立即讓舊的 URL 失效。
提交驗證
匿名提交受到不可猜測的權杖和表單啟用狀態的限制。提交時,Dokki 會根據其在相同文件中變更的即時資料表欄位定義來驗證值,因此會在新增資料列之前檢查選取選項和輸入的值。
速率限制與錯誤
當設定 Vercel KV 速率限制環境變數時,瀏覽器表單提交限制為每個 IP 每小時 30 次提交。無效的值會傳回欄位層級的驗證錯誤。非啟用狀態的表單會傳回錯誤,而不會新增資料列。
操作注意事項
一個表單屬於一個資料表資源。
提交計數器是盡力而為的;附加的資料表資料列才是真實來源。
使用表單進行收集,而非權限編輯。任何擁有有效連結的人都可以提交。
如果您不希望有更多匿名資料列,請在公開分享資料表之前停用收集。
