同步到 Notion
把範本連結到你的一個 Notion 資料庫,每一次提交就會在那裡變成一列——表單提交時建立,文件之後有變更就更新。
1 · 連接你的工作區
在 Notion 建立一個「內部」連接(notion.so/my-integrations,Pocper 的設定頁有連結),複製它的「內部 API 權杖」,貼到 Pocper 的設定 → 整合 → Notion。只有團隊擁有者可以做這件事,權杖會加密儲存。要換權杖,在同一頁按「更換權杖」:新權杖先驗證,通過後才取代舊的。
接著讓這個連接有權存取你要寫入的資料庫,或資料庫所在的頁面:在 Notion 打開它,選 •••(更多)→「連接」→「新增連接」,選你的連接。漏掉這步,Pocper 的清單裡就找不到這個資料庫,貼上它的連結也會回報找不到。
2 · 把範本連結到資料庫
打開範本的工作區面板,選「整合」分頁,按「連結 Notion 資料庫」。從你的連接看得到的資料庫裡挑一個(可以輸入文字搜尋),或貼上資料庫的連結。清單第一列「新增資料庫」會在你選的頁面裡建立一個資料庫,每個欄位各有一欄、已經對應好,另有一個「Pocper ID」欄。
每個欄位都有一個下拉選單,列出型別合得上的欄:日期欄位對日期欄、核取方塊對核取方塊、文字對文字或標題。在「提交資訊」底下,還可以對應客戶、提交時間、狀態和提交者。
由範本建立的每份文件,建立時都會複製這套設定,並可在自己的「整合」分頁裡只為這份文件修改。之後在範本上的修改只套用到新文件;還沿用範本先前設定的既有文件,範本會提供「也套用到這些文件」。範本連結資料庫之前就建立的文件,會提供「套用範本的設定」。
3 · 提交時會發生什麼
表單提交後——不論是填表的人提交,或是你把它標記為已提交——幾秒內就會建立一列。之後文件「整合」分頁的「同步」裡會說明最後同步的時間並附上連到那一列的連結,或說明有變更等著送出、送出失敗;只有送出失敗或從沒送出時才會出現「立即同步」。想要文件一建立就出現在 Notion,在範本的「整合」設定裡切換「同步時機」。
之後的修改會在最後一次修改後幾秒內更新同一列;取消文件會更新它的狀態欄。
那一列的頁面會寫入一個回到文件的書籤,以及以清單呈現的答案(太長的答案會截短,最多一百項)。可以在範本的「整合」設定裡關掉頁面內文。
4 · 檔案、簽名與重複
上傳的檔案和簽名可以送到「檔案與媒體」欄:檔案本身會複製到 Notion,上限 20 MB(更大的會略過,並在同步紀錄中註明)。以連結形式送到網址欄是另一個開關,預設關閉,因為任何看得到那一列的人都能不登入 Pocper 直接打開這種連結。
「防止重複」讓重試的提交不會出現兩次:Pocper 把每份文件的 Pocper ID 寫進一個同名的文字欄,並用它找回那一列。已經有這一欄的資料庫會直接使用;沒有的話,連結對話框(預設勾選)會新增這一欄,或在「整合」分頁的「設定」裡按一下新增。
5 · 在 Notion 做的變更
在「整合」分頁開啟「反向同步」,就有兩件事會從 Notion 回來:把狀態欄改成已提交、已取消或已收集,文件就會變成那個狀態;改了對應到文字、核取方塊、日期或時間欄位的某一格,這個值就會寫進文件,文件歷史會標示它來自 Notion。兩邊改了同一格時以 Notion 為準——只有客戶還在填寫時例外(尚未提交,且最近十分鐘內存過):這時保留客戶的值,Notion 那一格會被改回去,「整合」分頁會記下這件事。
反向同步需要一個 webhook,由團隊擁有者在設定 → 整合 → Notion 設定一次:建立 webhook 網址、在 Notion 你那個連接的 Webhooks 分頁新增訂閱、把 Notion 送來的驗證 token 貼回去。Pocper 不會輪詢 Notion,所以沒有 webhook,在 Notion 做的修改就只留在 Notion。不能寫回的欄(簽名、檔案、已鎖定文件的任何欄位)會在 Notion 改回原值,「整合」分頁會記下這件事。
6 · 出了問題時
送不出去的列會自動重試,間隔逐漸拉長,持續一天。重試用完,或 Notion 直接拒絕(權杖被撤銷,或資料庫不再分享給該連接)時,同步會停止,團隊擁有者和連結那個資料庫的人會收到站內通知,點開會打開文件的「整合」分頁。那裡的錯誤會說明該怎麼處理,Notion 的原始訊息收在「顯示 Notion 的原始訊息」裡。
停下的同步在原因修正後會自己恢復:在設定裡重新連接或更換權杖、Pocper 再次讀取資料庫(「欄位」標題旁的「重新讀取 Notion 欄位」,或在「整合」分頁存下任何修改),或文件再被編輯時。在範本上,「同步紀錄」那一列會顯示失敗份數,可以只看失敗的;有該進資料庫卻還沒進的文件時,會有一行像「3 份文件還沒進 Notion」,旁邊的「送出」會全部送出(缺「Pocper ID」欄時會先新增),展開可以看到是哪幾份、為什麼。「同步」標題旁的「暫停同步」會停止送出修改,直到你按「恢復同步」。