Jiraのインテグレーション

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

1. サイドバーの 設定 を開きます。

2. インポート をクリックして Jira を見つけます（リンクプレビューまたはリンクメンションの場合）。

   • リンクプレビューとリンクメンションには Jira インテグレーションを使用します。

   • もう1つのインテグレーションとして Jira同期 があります。これを選択するとJiraのプロジェクトと課題をNotionに同期できます。Jira同期について詳しくはこちらをクリックしてください。

3. 接続 をクリックし、認証フローを完了します。

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に接続するため、より統一された体験が得られます。

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

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

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

同期の作成はすべてのメンバーが行えますが、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回実行され、「同期中」ラベルで示されます。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• 現時点では、Jiraで行われた更新のみがNotionデータベースにリアルタイムで同期され、逆方向に同期されることはありません。Notionデータベースに加えた変更は、Jiraには同期されません。

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

  

• プロジェクトやプロパティの追加、削除を行う場合は、同期データベースの編集権限またはフルアクセス権限が必要となります。権限設定を事前にご確認ください。

• Notionに更新が反映されない場合は、ページの再読み込みをお試しください。

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

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

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

JiraインスタンスがNotionと再接続されても、プロジェクトと課題のデータベースは再作成されません。以前のプロジェクトと課題のデータベースを引き続き使用することになります。

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

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

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

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