CHOOSE YOUR DATA FLOW

一個流程,三種接入方式

新接入一律由 OpenDashboard 定義流程、驗證及保存正式答案。外站可選擇自己的外觀;這不會改變誰負責答案與進度。

從流程開始

在「流程管理 → 報名流程」完成表單和步驟,發佈後進入「網站接入」建立入口。該頁提供:

接入方式用途金鑰
報名連結分享給參加者或放在網站按鈕不需要
iframe在自己網站顯示 OpenDashboard 填表頁不需要
自訂 UI API自己的網站繪製表單,透過後端提交在此流程內啟用專屬金鑰

閱讀流程接入完整教學。三者共用流程的規則和申請資料;每個公開入口開始新申請,私人憑證用於繼續同一申請。不能按姓名或電郵認領歷史資料。

填表與查看可以分開安排

情況如何接
平台填表,平台管理使用連結或 iframe;管理員在申請進度查看
外站及平台都填表,平台管理外站用流程 API;同一申請沿用私人憑證及版本
兩邊填表,兩邊看參加者自己的資料外站後端核對身份後,用流程 API 讀回該申請
外站需要全體管理名單或報表需要另外配置管理/報表權限;流程填表金鑰不提供全體名單

網站可以保存申請對應、登入身份及必要副本;正式答案和流程狀態以 OpenDashboard 為準。不需要先同步另一份答案庫才顯示成功,也沒有「選擇兩邊保存」的流程模式開關。

停止新報名與停用 API 分開管理。前者阻止新申請,後者阻止該金鑰的自訂 UI 存取;已有平台私人連結仍可使用。發佈新版本不會改寫舊申請。

既有原站回寫整合的維護

下列是既有特殊整合的相容路徑,不是新流程可選的資料模式。原站仍保存正式答案時:

text
原站填表 → 原站驗證及保存 ───────────────────┐
                                           ├→ 變更通知 → OpenDashboard 正式回覆/報表
OpenDashboard 填表 → 待處理指令 → 原站驗證保存 ┘
                         ↑          │
                         └─ 接受/拒絕確認

OpenDashboard 的 /apply/{slug} intake 目前就是這種接法。它保存私人草稿及指令,等待原站確認;原站再將正式答案同步回既有表單。適合已匯入舊資料、仍要保留原站評審的系統。完整接法見原站回寫。

兩邊各存一份時,仍只選一邊作正式寫入依據。來源版本、指令重試和資料對應由接入層維護;原站修改引起版本衝突時需核對,不會自動合併。現有 intake 不會替兩邊帳戶自動建立可互相編輯的登入關係。

這個指令通知專門服務原站回寫,不是通用的「所有回覆變更 webhook」。新流程另有 workflow.application.changed 通知,可通知外站讀取副本;接收端仍需可靠保存、重試及補漏,沒有自動雙向合併或跨資料庫交易保證。

已有整合的遷移界線

既有原站回寫仍按原合約運作。若日後切換主導方,需要另行核對欄位、申請身份、附件、版本及待同步工作;新流程或新金鑰不會自動搬遷歷史資料,也不會替歷史參加者發放私人連結。

已連接的原站報名入口亦會出現在「流程管理」的流程列表。進入後可切換查看原有表單回覆(包含已匯入及後續同步資料)、開啟同一回覆者的另一份表單,以及複製既有公開填表連結。這是管理檢視,不會建立新的流程申請、改變原站確認方式或重新發放私人連結。待原站確認的新入口申請另列於入口紀錄。

點入流程後,用表單分頁查看資料、「填表連結」取得公開網址、「設定」查看同步說明及新報名傳送紀錄。舊有管理網址繼續有效。新流程請直接進入流程內的「網站接入」,不必在兩個管理畫面之間建立設定。

獨立表單仍在表單管理使用原有連結。流程步驟可引用有管理權限且題型相容的獨立表單;只引用問題,不搬移歷史答案。發佈時保留內部版本,預設不混入獨立表單列表。已有普通 forms、應用管理、報表及原站回寫 API 保留相容合約;詳細見API 參考及既有原站回寫。

流程資料副本

外站需要接收 OpenDashboard 報名與作品資料時,使用流程資料同步:核對表單與步驟對應、沿用固定申請編號,並在「網站接入」設定資料變更通知。