Notion 同步
把模板链接到你的某个 Notion 数据库,每一次提交都会在那里成为一行——表单提交时创建,之后文件变动时更新。
1 · 连接你的工作区
在 Notion 里创建一个「内部」连接(notion.so/my-integrations,Pocper 的设置页有链接),复制它的「内部 API 令牌」,粘贴到 Pocper「设置」→「集成」→ Notion。只有团队所有者可以这么做,令牌会加密保存。要换令牌,在同一页按「更换令牌」:新令牌先验证,通过后才替换旧的。
然后让这个连接可以访问你要写入的数据库,或数据库所在的页面:在 Notion 里打开它,选择 •••(更多)→「连接」→「添加连接」,选中你的连接。漏掉这一步,Pocper 的列表里就找不到这个数据库,粘贴它的链接也会报告找不到。
2 · 把模板链接到数据库
打开模板的工作区面板,选择「集成」标签页,按「关联 Notion 数据库」。从你的连接能看到的数据库里选一个(可以输入文字搜索),或粘贴数据库的链接。列表第一行「新建数据库」会在你选的页面里新建一个数据库,每个字段各有一列、已经映射好,另有一个「Pocper ID」列。
每个字段都有一个选择器,列出类型匹配的列:日期字段对日期列,复选框对复选框,文本对文本或标题。在「提交信息」下,还可以映射客户、提交时间、状态和提交者。
从模板创建的每份文件,创建时都会复制这套设置,并可在自己的「集成」标签页里只为这份文件修改。之后在模板上的更改只应用到新文件;仍沿用模板先前设置的已有文件,模板会提供「也套用到这些文档」。在模板关联数据库之前就创建的文件,会提供「套用模板的设置」。
3 · 提交时会发生什么
表单一经提交——不管是由填写的人提交,还是由你标记为已提交——几秒之内就会创建一行。之后文件「集成」标签页的「同步」里会说明最后同步的时间并附上指向那一行的链接,或说明有变更等着发送、发送失败;只有发送失败或从未发送时才会出现「立即同步」。想要文件一建立就出现在 Notion,在模板的「集成」设置里切换「同步时机」。
之后的编辑会在最后一次编辑后几秒内更新同一行;取消文件会更新它的状态列。
那一行的页面会写入一个指回文件的书签,以及以列表呈现的答案(过长的答案会截短,最多一百项)。模板的「集成」设置可以把页面正文关掉。
4 · 文件、签名与重复
上传的文件与签名可以发送到 Files & media 列:文件本身会被复制进 Notion,上限 20 MB(更大的会被跳过,并在同步记录中注明)。以链接形式发送到 URL 列是另一个开关,默认关闭,因为任何看得到那一行的人都能不登录 Pocper 就打开这样的链接。
「防止重复」让重试的提交不会出现两次:Pocper 把每份文件的 Pocper ID 写进一个同名的文本列,并用它找到那一行。已有这一列的数据库会直接使用;没有的话,关联对话框(默认勾选)会新增这一列,或在「集成」标签页的「设置」里按一下新增。
5 · 在 Notion 做的更改
在「集成」标签页开启反向同步,就有两件事会从 Notion 回来:把状态列改为 Submitted、Cancelled 或 Collected,文件就会变成那个状态;修改映射到文本、复选框、日期或时间字段的某个单元格,这个值就会写入文件,文件的历史会标明它来自 Notion。两边改了同一个单元格时以 Notion 为准——只有客户还在填写时例外(尚未提交,且最近十分钟内保存过):这时保留客户的值,Notion 那个单元格会被改回去,「集成」标签页会记下这一点。
反向同步需要一个 webhook,由团队所有者在「设置」→「集成」→ Notion 设置一次:创建 webhook 地址、在 Notion 中你那个连接的 Webhooks 标签页新增订阅、把 Notion 发来的验证令牌粘贴回去。Pocper 不会轮询 Notion,所以没有 webhook,在 Notion 做的修改就只留在 Notion。无法写回的列(签名、上传的文件、已锁定文件的任何字段)会在 Notion 改回原值,「集成」标签页会记下这一点。
6 · 出了问题的时候
发送失败的行会自动重试,间隔逐渐拉长,持续一天。重试用完,或 Notion 直接拒绝(令牌被撤销,或数据库不再与该连接共享)时,同步会停止,团队所有者和关联那个数据库的人会收到站内通知,点开会打开文件的「集成」标签页。那里的错误会说明该怎么处理,Notion 的原始信息收在「显示 Notion 的原始信息」里。
停下来的同步在原因排除后会自己恢复:在「设置」里重新连接或更换令牌、Pocper 再次读取数据库(「字段」标题旁的「重新读取 Notion 列」,或在「集成」标签页保存任何更改),或文件再次被编辑时。在模板上,「同步记录」那一行会显示失败的份数,可以只看失败的;有应在数据库里却还不在的文件时,会有一行像「3 份文档还没进 Notion」,旁边的「发送」会全部发送(缺「Pocper ID」列时会先新增),展开可以看到是哪几份、为什么。「同步」标题旁的「暂停同步」会停止发送修改,直到你按「恢复同步」。