Dokki Docs logo

表單

表單可將資料表轉變為公開的資料收集端點。提交會將資料列附加到資料表,因此您可以在不授予提交者工作區存取權限的情況下,收集申請、註冊、意見回饋、輕量調查或結構化報告。

建立表單

開啟資料表,然後按一下資料表工具列中的表單或收集按鈕。Dokki 會從協作資料表文件讀取即時資料表欄位,並將每個欄位視為一個可能的問題。

設定問題

  • 設定表單標題和可選的描述。

  • 啟用或停用每個欄位作為問題。

  • 自訂每個問題的標籤,而無需重新命名資料表欄位。

  • 當資料列若無值即不應被接受時,將已啟用的問題標記為必填。

  • 已刪除的資料表欄位會從表單設定中移除;當您重新開啟對話方塊時,新的資料表欄位會以停用欄位的形式附加。

開始並分享收集

儲存會儲存設定。開始收集會啟動一個唯一的匿名表單權杖,並在 /form/<token> 顯示分享連結。停止收集會保留設定,但會讓該連結拒絕新的提交。

從其他系統傳送資料列

開啟收集對話方塊中的 Webhook 面板,以複製私人端點、檢查即時欄位結構、複製 cURL 範例,或輪換權杖。

  • 向 webhook URL 傳送 GET 要求,以取得公開欄位鍵、類型、必填旗標和允許的選項。

  • 傳送帶有 Idempotency-Key 標頭和主體為 { \"values\": { \"<field-key>\": \"<value>\" } } 的 JSON POST 要求。

  • 端點接受最大 1 MB 的主體。當設定 KV 速率限制時,webhook 提交限制為每個 IP 每小時 300 個要求。

將 webhook URL 視為密碼。不要將其放置在客戶端程式碼或公開文件中。輪換權杖會立即讓舊的 URL 失效。

提交驗證

匿名提交受到不可猜測的權杖和表單啟用狀態的限制。提交時,Dokki 會根據其在相同文件中變更的即時資料表欄位定義來驗證值,因此會在新增資料列之前檢查選取選項和輸入的值。

速率限制與錯誤

當設定 Vercel KV 速率限制環境變數時,瀏覽器表單提交限制為每個 IP 每小時 30 次提交。無效的值會傳回欄位層級的驗證錯誤。非啟用狀態的表單會傳回錯誤,而不會新增資料列。

操作注意事項

  • 一個表單屬於一個資料表資源。

  • 提交計數器是盡力而為的;附加的資料表資料列才是真實來源。

  • 使用表單進行收集,而非權限編輯。任何擁有有效連結的人都可以提交。

  • 如果您不希望有更多匿名資料列,請在公開分享資料表之前停用收集。