本文へスキップ

Notion 同期

テンプレートをあなたの Notion データベースのひとつに紐づければ、すべての提出がそこで行になります——フォームが提出されたときに作られ、その後ドキュメントが変わると更新されます。

1 · ワークスペースを接続する

Notion で「内部」コネクションを作成し(notion.so/my-integrations。Pocper の設定ページにリンクがあります)、その内部APIトークンをコピーして、Pocper の「設定」→「連携」→ Notion に貼り付けます。これができるのはチームのオーナーだけで、トークンは暗号化して保存されます。トークンを変えるときは同じページの「トークンを変更」を使います。新しいトークンは検証されてから古いものと置き換わります。

次に、書き込み先のデータベース、またはそれがあるページへのアクセスを、そのコネクションに与えます。Notion でそれを開き、•••(その他)→「コネクション」→「コネクションを追加」で作成したコネクションを選んでください。これを飛ばすと、Pocper の一覧にそのデータベースが出てこず、リンクを貼り付けても見つからないと報告されます。

2 · テンプレートをデータベースにリンクする

テンプレートの「ワークスペース」パネルで「連携」タブを選び、「Notion データベースを紐づける」を押します。コネクションから見えるデータベースを選ぶか(入力して検索できます)、データベースのリンクを貼り付けます。一覧の先頭の「データベースを新規作成」は、指定したページの中にデータベースを作ります。フィールドごとの列は対応付け済みで、「Pocper ID」列も付きます。

各フィールドには、型の合う列を並べた選択欄が付きます。日付フィールドは日付の列へ、チェックボックスはチェックボックスへ、テキストはテキストかタイトルへ。「提出情報」の下では、クライアント、提出日時、状態、提出者も対応付けられます。

テンプレートから作られるドキュメントは、作られた時点でこの設定をコピーし、自分の「連携」タブでそのドキュメントだけについて変えられます。その後のテンプレートの変更が届くのは新しいドキュメントだけで、以前の設定のままの既存ドキュメントには「これらのドキュメントにも適用」が表示されます。テンプレートを紐づける前に作られたドキュメントには「テンプレートの設定を適用」が表示されます。

3 · 提出時に起きること

フォームが提出されると——記入した本人が提出しても、あなたが提出済みにしても——数秒のうちに行が作られます。その後、ドキュメントの「連携」タブの「同期」には、最後に同期した時刻と行へのリンク、または変更が送信待ちか失敗したことが表示され、「今すぐ同期」は送信に失敗したときか、一度も送られていないときだけ出ます。ドキュメントが作られた時点で行を作りたいときは、テンプレートの「連携」設定の「同期のタイミング」を切り替えます。

その後の編集は、最後の編集から数秒後に同じ行を更新し、ドキュメントをキャンセルすると状態の列が更新されます。

行のページには、ドキュメントに戻るブックマークと、一覧にした回答が書き込まれます(長すぎる回答は短縮、100 件まで)。ページ本文はテンプレートの「連携」設定でオフにできます。

4 · ファイル、署名、重複

アップロードされたファイルと署名は「Files & media」列に送れます。ファイルそのものが Notion にコピーされ、上限は 20 MB です(それより大きいものはスキップされ、同期ログに記録されます)。リンクとして URL 列に送るのは別のスイッチで、既定ではオフです。行を見られる人なら誰でも Pocper にサインインせずにそのリンクを開けるからです。

「重複防止」は、再試行された提出が二重に現れるのを防ぎます。Pocper は各ドキュメントの Pocper ID を同じ名前のテキスト列に書き込み、それで行を見つけます。その列がすでにあるデータベースはそれを使い、なければ紐づけのダイアログ(既定でチェック済み)が追加するか、「連携」タブの「設定」からワンクリックで追加できます。

5 · Notion 側で行った変更

「連携」タブで逆方向同期をオンにすると、二つのものが Notion から戻ってきます。ステータスの列を Submitted・Cancelled・Collected に変えるとドキュメントもそのステータスになり、テキスト・チェックボックス・日付・時刻のフィールドに対応付けたセルを編集するとその値がドキュメントに書き込まれ、履歴には Notion からの編集として残ります。両側で同じセルが変更されたら Notion の値が優先されます——ただしクライアントがまだ記入している間(未提出で、10 分以内に保存)は、クライアントの値を残して Notion のセルを元に戻し、「連携」タブに記録します。

逆方向同期には Webhook が必要で、チームのオーナーが「設定」→「連携」→ Notion で一度だけ設定します。Webhook の URL を作成し、Notion のコネクション設定の Webhooks タブでサブスクリプションとして追加し、Notion から届く検証トークンを貼り戻します。Pocper は Notion をポーリングしないので、Webhook がなければ Notion での編集は Notion にとどまります。値を書き戻せない列——署名、ファイル、ロックされたドキュメントのすべてのフィールド——は Notion 側で元に戻され、「連携」タブに記録されます。

6 · うまくいかないとき

送れなかった行は、間隔を広げながら 1 日のあいだ再試行されます。再試行を使い切るか、Notion がはっきり拒否すると(トークンが失効した、データベースが共有されなくなった)、同期は止まり、チームのオーナーとそのデータベースを紐づけた人にアプリ内の通知が届きます。通知を開くとドキュメントの「連携」タブが開き、エラーがどうすればよいかを示します。Notion の元のメッセージは「Notion の元のメッセージを表示」で確認できます。

止まった同期は、原因を直せば自動で再開します。「設定」で接続し直すかトークンを変更したとき、Pocper がデータベースを再び読み取れたとき(「項目」の見出しにある「Notion からプロパティを再読み込み」や、「連携」タブでの保存)、またはドキュメントを編集したときです。テンプレートでは「同期ログ」の行に失敗の件数が表示され、失敗だけに絞り込めます。「3 件のドキュメントがまだ Notion にありません」のような行が出たら「送信」でまとめて送れ(「Pocper ID」列がなければ先に追加します)、行を開くとどれがなぜかが分かります。「同期」の見出しの横の「同期を一時停止」を押すと、「同期を再開」を押すまで変更は送信されません。