他のツールからNotionにデータを同期する

このヘルプドキュメント内

GitHub、Jira、SalesforceなどのツールからNotionにデータを取り込み、自動的に更新される同期データベースを作成します。


Notionのデータベース同期機能を使用すると、チームの計画、ドキュメント、プロジェクトと並行して、他のツールの情報を活用し、充実させることができます。アカウントを接続して同期する対象を選択すると、Notionがデータベースを作成し、常に最新の状態に保ちます。

Notionがこれらの同期を管理するため、ユーザー自身でインテグレーションを構築・保守することなく、アカウントを接続して同期データベースを使用できます。

コネクション

同期可能なデータ

作成されたデータベース

GitHub

選択したリポジトリからのプルリクエスト

プルリクエスト

Jira

選択したJira Cloudスペースからのスペースおよび作業項目

JiraスペースおよびJira作業項目

Salesforce

アカウント、連絡先、商談

選択に応じて、アカウント、連絡先、および/または商談

他のツールの各レコードは、Notionデータベースの1つのページになります。ソースのフィールドはデータベースのプロパティになります。

管理された同期は、接続されたツールからNotionへという一方向でデータを更新します。同期されたプロパティはNotionでは読み取り専用です。同期された値を変更するには、GitHub、Jira、またはSalesforceで更新してください。Notionに変更が反映されます。

同期はバックグラウンドで自動的に実行されます。更新のタイミングは、接続、データ量、およびソースツールのリクエスト制限によって異なります。

備考: 別のツールを接続する必要がありますか?接続したいツールがサポートされていない場合は、Notion Workersを使用してカスタム同期を構築するか、AsanaおよびGitLab向けの構築済みWorkersガイドに従ってください。

Notionワークスペースのメンバーであり、同期したいデータにアクセスできるアカウントを持っている必要があります。組織によっては、接続の承認やソースツールでのアクセスの付与に管理者の許可が必要な場合があります。

同期の作成に使用するアカウントによって、Notionが読み取れるデータが決まります。そのアカウントの権限が変更されたり、接続が期限切れになったりした場合は、再認証が必要になることがあります。

GitHub同期とJira同期にはビジネスプラン(またはモバイルビジネスアドオン)が必要です。Salesforce同期にはエンタープライズプランが必要です。

  1. Notionワークスペースで 設定 → 接続 を開きます。

  2. Browse または Installed から同期したい接続(GitHub、Jira、または Salesforce)を開き、その接続のオプションから Database sync を選択します。

  3. アカウントを接続し、そのツールの認証手順を完了します。

  4. 同期するリポジトリ、スペース、またはオブジェクトタイプを選択します。

  5. 含める履歴の範囲を選択します。Jira や Salesforce など、カスタムプロパティを提供するソースについては、同期に含めるカスタムプロパティを選択することもできます。

  6. Create sync を選択します。

Notion は プライベート サイドバーセクションにデータベースを作成します。最初のインポートはバックグラウンドで開始されます。レコードのインポート中であっても、データベースを開くことができます。

最初のインポート

Notion はデータベース構造を作成し、設定に一致するレコードをインポートします。Notion はデータをバッチで読み取り、ソースツールのリクエスト制限に従うため、大規模なインポートには時間がかかる場合があります。

最初のインポートの実行中は、データの一部のみが表示される場合があります。インポートを継続するために Notion を開いたままにしておく必要はありません。

継続的な更新

最初のインポート後、Notion は接続ツールを定期的にチェックして、新規または変更されたレコードを確認し、同期されたプロパティを更新します。同期は、誰もデータベースを表示していないときでもバックグラウンドで継続されます。

通常、変更は数分以内に Notion に同期されます。

タイミングは、接続、データ量、およびソースツールの可用性によって異なります。変更のチェックが行われても、すべての変更がすぐに Notion に反映されるとは限りません。Salesforce はデフォルトで毎分変更をチェックします。詳細については、各接続のガイドを参照してください。

ソースが一時的にリクエストを制限したり、利用できなくなったりした場合、Notion は再試行します。同期に新しい認証や異なる権限が必要な場合は、ステータスにその対処方法が表示されます。

履歴ウィンドウ

すべての利用可能な履歴を含めるか、過去 30 日、90 日、または 365 日以内に更新されたレコードに同期を制限することができます。履歴ウィンドウは、レコードの作成日ではなく、ソースレコードの最終更新時刻を使用します。Salesforce はシステム変更時刻を使用します。

ウィンドウは時間の経過とともに前方に移動します。レコードがそのウィンドウ内で更新されていない場合、ソースツールでまだ開いているかアクティブであっても、データベースから削除される可能性があります。

備考: 履歴ウィンドウによってページが削除される可能性があります。レコードがウィンドウの範囲外になると、その同期済みページはNotionから削除されます。これには、そのページにユーザー自身がプロパティとして追加した値も含まれます。古いレコードや変更されていないレコードを保持する必要がある場合は、利用可能なすべての履歴を選択してください。

ウィンドウを拡大すると、一致する追加のレコードがインポートされます。短縮すると、条件を満たさなくなったレコードが削除されます。これは、ビューの表示内容のみを変更する Notion データベースのフィルターとは異なります。

ビューの作成、レコードのフィルタリングや並べ替え、独自のNotionプロパティの追加が可能です。例えば、プルリクエストにチームの優先度を追加したり、Salesforceアカウントにアカウントプランニングのステータスを追加したりできます。これらのプロパティの値はNotion内に保持されます。

同期によって管理されるプロパティと競合しないよう、独自のプロパティには固有の名前を付けてください。

データベースは最初はプライベートなページとして作成されます。準備ができたら、Notionのページ権限を使用して共有してください。

備考: Notionの共有設定によって、同期されたデータを誰が閲覧できるかが制御されます。Notionデータベースへのアクセスを持つユーザーは、ソースツールではアクセスできないレコードを閲覧できる場合があります。ソースの権限は、Notionの各ビューアーにコピーされるわけではありません。共有する前にアクセスをレビューしてください。

ソースツールでの権限の変更により、Notionにすでにあるデータは削除されませんが、今後の更新が停止する可能性があります。ソースへのアクセス権が変更された場合は、Notionデータベースの共有設定を確認してください。

接続のDatabase sync設定に戻り、同期ステータス、最近の実行情報、およびエラーの詳細を確認してください。

ステータス

対処方法

初期化中またはバックフィル中

同期が設定中、または既存のレコードをインポート中です。インポートを続行できるようにしてください。

正常

同期は正常に実行されています。最近のソースの変更はまだ処理中の場合があります。

低下または失敗

同期のエラー詳細を開いて、更新が遅延している原因を確認してください。

要アクション

アカウントの再接続やソースアクセスの復元など、表示された指示に従ってください。

無効

同期は一時停止されています。同期の設定で一時停止を解除できます。

利用不可

ステータス情報は現在利用できません。後でもう一度確認してください。

最近の実行時間はアクティビティを示しています。すべてのソースの変更がすでにNotionに反映されていることを保証するものではありません。

サポートされている接続のいずれかに必要なデータと設定が含まれている場合は、管理された同期を使用してください。Notionが初期インポート、定期的なチェック、および接続固有の同期ロジックを処理します。

別のサービスからのインポートや、Notionにデータが到達する前の変換など、カスタム同期を構築する必要がある場合は、Notion Workerを使用してください。

必要なもの

管理されたデータベース同期

ワーカー

コードなしでサポートされている接続を設定します。

Notionでアカウント、データ、設定を選択します。

コードとデプロイが必要です。

データ構造を選択します

接続でサポートされているレコードとプロパティを使用します。

カスタムスキーマと変換を定義します。

データの取得方法をカスタマイズします

組み込みの同期動作を使用します。

ワークフローに必要なソースリクエストと同期動作を実装します。

同期の維持

Notionが組み込みの接続ロジックを維持します。

チームがWorkerコードを維持し、NotionがそのWorkerを実行します。

例えば、管理されたGitHub同期を使用して、Notionでプルリクエストを追跡します。カスタムソース、追加のレコードタイプ、またはインポート前にデータを結合する計算が必要な場合は、Workerの使用を検討してください。

レコードが見つからない

選択したリポジトリ、スペース、オブジェクトタイプ、履歴ウィンドウ、および接続されたアカウントのソース権限を確認してください。また、最初のインポートがまだ実行中であるか、Notionのビューフィルターによってレコードが非表示になっていないかも確認してください。

リレーションが見つからない

同期されたページが別の同期されたページに関連付けられるはずなのにそうなっていない場合は、履歴ウィンドウが原因であるか、関連ページがまだインポート中である可能性があります。リレーションは、両方のページがNotionデータベースに同期された場合にのみ作成されます。

更新が停止した

同期のステータス詳細を開きます。認証の有効期限が切れている場合は再接続するか、ソースの管理者にアクセス権の復元を依頼してください。ソースの一時的な停止やリクエスト制限により、Notionが再試行している間、更新が遅れることがあります。

同期が行制限に達しました

選択したデータを減らすか、より短い履歴ウィンドウを選択してください。保存する前に影響を確認してください。ソースを削除したり履歴を短くしたりすると、同期されたページが削除される可能性があります。接続固有のガイドで、選択内容を変更した場合の動作について説明しています。

既存のAsanaまたはGitLabの同期については、Workerの置き換えガイドを使用してください:


フィードバックを送信

このコンテンツは役に立ちましたか?


Powered by Fruition