Jiraに接続

NotionのJiraとのコネクトにより、いくつかの操作が可能になります。JiraのリンクをNotionページに挿入して、Jiraにすばやくアクセスしたり、プレビューしたりできます。また、Jiraのプロジェクトや作業アイテムをNotionのデータベースに同期すれば、すべての作業を一か所で管理できます。ここでは、さまざまなコネクトの形式やその設定方法について解説します。

Notionでは、JiraとJira同期の2種類のJiraコネクトを提供しています。シンプル版とフル機能搭載版として考えていただければ結構です。

JiraプロジェクトをNotionデータベースと1回だけ同期する必要があり、それ以上の同期をセットアップする予定がない場合は、Jiraリンクのプレビュー、リンクのメンション、およびJiraコネクトを介した従来の同期データベースで十分かもしれません。ただし、Jira同期で使用される管理者トークンよりも信頼性が劣るユーザートークンが使用されます。

複数のプロジェクトやデータベースで継続的かつ柔軟に同期する場合は、Jira同期の方がより新しく、強力な選択肢と言えます。注：セットアップはJiraの管理者が行う必要があります。

レガシー同期データベースは以下のような見た目をしています。レガシー同期データベースを所有している場合、上記のステップに沿って、新しく改善されたJira同期によってプロジェクトと課題のデータベースをNotionで再作成できます。

Jiraからのリンクをプレビューする手順は次のとおりです。

1. 設定 → コネクトの順に開きます。

2. Jira Cloudを使用している場合は、Jiraタイルを見つけます。Jira Data CenterまたはJira Serverを使用している場合は、Jiraプレビュー（Data center）タイルを見つけます。データセンタータイルを見つけるには、少し下にスクロールすることが必要な場合があります。タイルの下にある接続をクリックします。

3. ウィンドウが表示されたら、ご利用のJiraバージョンを選択します。次に、サイトのURL、ユーザー名、パスワードを入力し、認証を選択します。

認証が正常に完了すると、接続リストの上部にJiraまたはJiraプレビュー（Data center）が表示されます。Notionに貼り付けられたJiraリンクは、自動的にリンクプレビューとして表示されます。

または、Notionページから直接リンクプレビューを設定することもできます。手順は次のとおりです：

1. NotionページにJiraのURLを貼り付けます。

2. ウィンドウが表示されたら、指示どおりにご利用のJiraバージョンを選択します。サイトのURL、ユーザー名、パスワードを入力し、認証を選択します。

1. JiraのリンクをNotionに貼り付けます。

2. 表示されるメニューで「メンション」を選択すると、ドキュメント内で簡単にプロジェクトや課題を参照できます。

   • JiraをNotionにまだ接続していない場合は、JiraのリンクをNotionに貼り付けるときに、接続するように求められます。リンクメンションについての詳細はこちら →

Jiraの同期のコネクトでは、ユーザートークンの代わりに管理者APIトークンを使用してJiraのプロジェクトをNotionに連携させるため、より一貫性のある一元的な同期体験が得られます。

信頼性の高い同期を行うために、スコープなしのトークンを作成することをお勧めします。そのためには、スコープ付きAPIトークンを作成ではなく、APIトークンを作成を選択してください。

これによりオートメーション、ロールアップ、Notion AIなどのNotionの機能を最大限に活用できるようになります。Notion AIを使えば、Jiraのプロジェクトに関する情報をすばやく得られます。

Jiraの同期は、Jiraのプロジェクトや作業アイテムをNotionプロジェクトや作業アイテムのデータベースとして表示します。そのため、便利で多様なビュー、フィルター、並べ替えを使用して、複数のプロジェクトの確認や管理ができます。

IDマッピングを使用してJiraのIDをNotionプロフィーイルに接続し、誰が何を担当しているのかをNotion上にある同期データベースで確認することもできます。

Notionのエンタープライズプランでは、Jiraの同期は双方向同期をサポートし、NotionとJiraの両方の権限を尊重して、安全なアクセスと編集を実現します。Jiraの同期を使用すると、リレーションとロールアップ、Notion固有のデータベースプロパティ、Notion AIなど、Notionの機能を最大限に活用できます。Notion AIを使えば、Jiraのプロジェクトに関する情報をすばやく得られます。

同期の作成はすべてのメンバーが行えますが、Jira同期の初期設定はワークスペースオーナーのみが行えます。

1. サイドバーの 設定 → インポート → Jira同期 に移動します。

   • Jiraデータベースのリンクを貼り付けるか、スラッシュコマンド /jira sync を使うこともできます。

   • Notionで以前にJiraの同期データベースを作成したことがある場合は、そのデータベースを開き、上部にある Jira同期を改善する をクリックします。

2. 表示されるウィンドウで、始める をクリックします。

3. Jiraの管理者メールアドレス、JiraのサイトURL、APIトークンを入力し、次へ をクリックします。

1. サイドバーの 設定 → インポート → Jira同期 に移動します。

   • Jiraデータベースのリンクを貼り付けるか、スラッシュコマンド /jira sync を使うこともできます。

2. 表示されるウィンドウで、始める をクリックします。

3. 同期するJiraのサイトを選択します。

4. 新しい同期を作成 をクリックするか、既存の同期があればドロップダウンメニューでそれをクリックします。既存の同期を選択すると、プロジェクトは既存の同期済みプロジェクトと作業アイテムのデータベースに追加されます。

5. データベースが開いたら、そこでJiraアカウントを接続する必要があります（コネクトを設定したワークスペースオーナーが自分である場合を除きます）。ここで、Notionに同期したいデータを選択します。まず 同期するプロジェクトを選択 し、次に 同期するプロパティを選択 します。

別のサイト、チームスペース、ワークスペースに別のJiraの同期を設定したい場合は、上のステップを繰り返します。コメントや添付（課題ごとに5ファイルまで、1MBを超えないサイズ）も同期されます。

データベースページにアクセス許可を適用し、コラボレーション相手が同期データベースにアクセスできるようにします。

同期データベースでユーザープロパティが使えるようになります！IDマッピングを使用して、サードパーティのJIRAのIDをチームのNotionプロフィーイルに接続できるようになりました。手順は次のとおりです：

1. Jira Cloudが実装されていることをご確認ください。

2. Notionの名前とメールアドレスがJiraと同じであることを確認します。

3. こちらの手順に従って、公開設定を全員に設定してください。

Notionデータベースに同期されたJiraのプロジェクトと課題のプロパティを編集するには、同期データベースの上部にある ••• をクリックして、ソース を選択します。

Jiraの同期データベースを削除するには、同期データベースの上部にある ••• → テーブルを削除 をクリックします。

最初のインポート後、Jiraと同期したプロジェクトは次の2つの方法で最新の状態に保たれます。

• Webhook：Jiraで行われた更新は、Webhookを介してリアルタイムでNotionに送信されます。

  • これらの変更は通常数分以内に反映されますが、ネットワークやシステムの問題により、更新が遅れたり、更新されなかったりすることがあります。

  • Webhookの設定は、同期が最初に確立されたときに自動的に行われます。

• 再同期：Webhookによる更新がされなかった場合、再同期メカニズムがコレクションをJiraと再度同期し、最新の状態にします。

  • 再同期が実行されるのは、コレクションが アクティブに表示されている場合のみで、時間がかかる（特に大規模なコレクションの場合）ことがあります。

  • 最大1日に1回実行され、「同期中」ラベルで示されます。

    • このプロセス中は、ユーザーは同期設定を変更できません（プロジェクトやプロパティの追加や削除など）。

双方向同期は、NotionとJiraの両方の権限を尊重して、安全なアクセスと編集を実現します。

• 双方向同期を有効にして使用できるのは、同期されたJiraデータベースへの編集権限を持つユーザーのみです。

• Notionからの編集を有効にするには、各ユーザーが個人のJiraアカウントを認証する必要があります。以前に閲覧専用でJiraに接続していた場合、編集を有効にするには再認証が必要になります。

• ゲストや、公開リンクを介して同期されたJiraデータベースにアクセスするユーザーは、双方向同期を使用できません。

JiraのプロジェクトはNotionのプロジェクトデータベースに同期され、リレーションで接続された作業アイテムの同期データベース内で、対応するJiraの作業アイテムに高度にマッピングされます。このデータベースでは、デフォルトのデータベースビューが事前に用意されているので、同期後はすぐに使い始められます。

• アクティブ（テーブルビュー）： 同期したプロジェクトのうち、ステータスが「進行中」のものが表示されます。つまりこのビューには、すでに完了したプロジェクトは表示されません。事前に設定されたフィルターによってオーナーと日付で絞り込みができるため、検索が簡単です。

• タイムラインビュー： プロジェクト名、ステータス、オーナー、進捗率が表示されます。事前に設定されたフィルターによって、ステータス、オーナー、日付で絞り込みできるため、検索が簡単です。

• ボードビュー： ステータス別にグループ化されたプロジェクトが表示されます（計画中、進行中）。••• メニューで、ビューにどのステータスを表示するかをカスタマイズできます。プロジェクトは優先度の高いものから表示されるよう、並べ替えが設定されています。

• すべて（テーブルビュー）： 同期されたプロジェクトがすべて表示されます。事前に設定されたフィルターによって、ステータス、オーナー、日付で絞り込みできるため、検索が簡単です。

Jiraの作業アイテム（エピック、バグ、タスク、サブタスク、ストーリー）は、Notionのタスクデータベースと同等の機能であるNotionの作業アイテムデータベースに同期されます。プロジェクトの同期データベースの場合と同様、デフォルトのデータベースビューが用意されているので、同期後はすぐに使い始められます。

• プロジェクト別（テーブルビュー）： すべてのタスクがプロジェクトごとにグループ化されて表示されます。事前に設定されたフィルターによって、ステータス、担当者、日付、プロジェクトの絞り込みができるため、アイテムの検索が簡単です。

• エピック別（テーブルビュー）： Jiraのストーリー、タスク、バグがエピックごとにグループ化されて表示されます。

• ボードビュー： ステータスごとにグループ化され、優先度の高いものから順に表示されるよう、並べ替え条件が設定されています。事前に設定された表示プロパティは、担当者、プロジェクト、優先度、サブタスクです。

• すべてのタスク（テーブルビュー）： 同期されたタスクがすべて表示されます。事前に設定された表示プロパティは、タスク名、ステータス、担当者、日付、優先度、タグ、プロジェクトです。

• 自分の担当（テーブルビュー）： タスクを絞り込み、あなたに割り当てられたタスクのみ表示します。事前に設定されたフィルターによってステータス、日付、プロジェクトの絞り込みができます。

Jira同期は大部分のJiraプロパティをサポートしていますが、一部のJiraプロパティはサポート対象外です。サポートされていないJiraプロパティの一覧は以下の通りです。

• 現時点では、Jiraの同期はJira Cloudでのみ機能します。JiraデータセンターとJiraサーバーはサポートされていません。

• 通常、初回の同期は数分程度で完了しますが、Jiraのプロジェクトと作業アイテムのサイズによっては、最大で数時間かかる場合もあります。

• プロパティのリッチテキストやネストされたマルチセレクトなど、課題のフィールドやプロパティの一部は同期されない場合があります。

• ステータス、担当者、優先度、添付ファイル、コメントは編集できますが、一部の作業項目フィールドやプロパティは編集できません。これには、説明、タイトル、日付、カスタムフィールド、その他のセレクトまたはマルチセレクトフィールド（優先度とステータスを除く）が含まれます。

• Notionで投稿されたコメントはJiraに追加されますが、その後はコメントを編集したり削除したりすることはできません。

• 添付ファイルのサイズは最大1MBです。各Jira作業項目には、最大5つの添付ファイルを追加できます。サイズ制限を超える添付ファイルをアップロードしようとすると、アップロードに失敗します。

  • 添付ファイルを作業項目にドラッグ＆ドロップすることはできません。添付ファイルを追加するには、添付アイコンを使用してください。

• Notionには、同期されたJiraの作業アイテムで既に使用されている優先度の値のみが表示されます。Jiraに存在するものの、まだ使用されていないオプションは選択できません。これらの値を選択可能にするには、すでにNotionに同期されているJiraの作業項目に、これらの値を少なくとも1つ割り当ててください。

• 最適なパフォーマンスを維持するために、1,000を超える値を持つJiraプロパティはインポートされません。

• 初回の同期が設定されると、プロパティの更新はリアルタイムでNotionに反映されます。新しいプロパティを作成すると、それらが同期されるには最大で12時間かかります。

• JiraとNotionを手動で同期することはできません。Jiraで更新が行われると、自動でNotionに同期されます。

• データベースの一番上にある青いバッジにカーソルを合わせると、Notionが最後にJiraと同期した日時を確認できます。黄色の 同期に失敗しました または 同期が停止しました が表示されている場合は、以下のステップに沿ってJiraを再接続しなければならない場合があります。

• ウォッチャー プロパティが正常に同期されるまでに、最大で12時間かかる場合があります。

• 双方向同期はモバイルデバイスでは利用できません（一方向同期は利用可能です）。

Webhookの登録ができなかった場合や、プロジェクトの同期に失敗した場合、データベースの上部に 同期に失敗しました と表示されます。この問題を解決するには、別のプロジェクトでもう一度同期をお試しください。Jiraのプロジェクトに問題がないことも併せて確認します。

Jiraのトークンの有効期限が切れている場合や、ほかのユーザーがNotionからJiraを接続解除した場合、データベースの上部に 同期が停止しました と表示されます。この問題を解決するには、同期が停止しました の横にある 再認証 をクリックします。ワークスペースオーナーのみがこのプロセスを完了できます。

JiraインスタンスがNotionに再接続されると、プロジェクトと作業アイテムのデータベースは再作成されません。代わりに、以前に存在していたプロジェクトと作業アイテムのデータベースを引き続き使用できます。

JiraをNotionから完全に接続解除する手順は以下のとおりです。

1. サイドバーの 設定 を開き、 インポート をクリックします。

2. Jiraの横にある ••• から 削除 をクリックします。