Jira と Confluence を一緒に利用する

Confluence と Jira の各製品は、ベーコンと卵、コーヒーとケーキ、サイモンとガーファンクルのような関係です。別々でも最高ですが、一緒になると驚愕することでしょう。Confluence と Jira の両製品が Cloud サイトにある場合は、両ツール全体でプロジェクト更新をシームレスに追跡して、作業中の Confluence ページに留まったまま Jira 課題を作成できます。

Confluence と Jira で実行できることは、Cloud サイトでご利用の Jira 製品の種類によって異なります。各 Jira 製品で使用できる機能の種類については、この記事の下部をご参照ください。

すべてのプロジェクトまたはチーム向け

ページに課題を表示する

Jira 課題はを Confluence ページに表示するには、Jira 課題マクロを使用します。単一の課題や課題の一覧を表示したり、課題数の合計を表示したりすることができます。

Jira 課題を Confluence に追加する最も簡単な方法は、Confluence ページに Jira URL を貼り付けることです。

いくつかの例はこちら...

• <yourjirasite.com>/browse/CONF-1234 は、Jira 課題マクロを挿入し、単一の課題を表示します。

• <yourjirasite.com>/issues/?filter=56789 は、Jira 課題マクロを挿入し、保存済みフィルターと一致する課題の一覧を表示します。 

• <yourjirasite.com>/issues/?jql=project%20%3D%20CONF は、Jira 課題マクロを挿入し、Jira 検索に一致する課題の一覧を表示します。 

または、Jira 課題マクロをページに追加して課題を直接検索できます。

1. エディターで [挿入] > [Jira 課題] を選択します。

2. マクロ ブラウザーのプロンプトに従ってプロジェクトを選択し、課題を検索します。Jira クエリ言語 (JQL) さえも使用できます。

マクロを追加したら、ページで課題または課題リストいの表示方法をカスタマイズできます。これには、表示する情報の量や課題数なども含まれます。

レポートやグラフを作成する

Confluence では、Jira に保管された情報のレポートを簡単に作成できます。Jira 製品からの情報を視覚的に表示するには、Jira 課題マクロに加えて、Jira レポート ブループリントまたは Jira チャート マクロを使用できます。チームやプロジェクトの進捗状況のスナップショットを関係者に提供する一番良い方法です。 

以下のことが可能です。

• Jira レポート ブループリントによって、変更履歴またはステータス レポートを作成します。

• Jira グラフ マクロによって、データをグラフとして表示します。円グラフ、作成済み vs 解決済みグラフ、2 次元グラフなどがあります。

• Jira ガジェットによって、詳細な Jira レポートとグラフをページに表示します。

Confluence 内から課題を作成する

ページを閲覧しながらの課題作成、またはエディターでの課題作成を実行できます。これによって、Confluence でプランニングや要件の収集をしやすくなります。ハイライトされたテキストからの単一の課題の作成や、表からの複数の課題の作成を実行できます。さらには、Atlassian Intelligence (AI) を使用することで、課題を 1 つずつ生成したり、ページをスキャンして複数の課題の下書きを一度に作成したりできます。

ページの閲覧時に課題を作成する

Free プランまたは Standard プランの顧客が Confluence ページから単一の課題を作成するには、次の手順に従います。

1. ページ上でテキストをハイライトします。フローティング ツールバーが表示されます。

2. [+ Jira 課題] ドロップダウンを選択します。

3. [単一の課題を作成] を選択します。

4. [Jira 課題を作成] サイド パネルが右側に開きます。

5. Jira フィールドに入力したあと、[作成] を選択します。

課題が Jira で作成され、ご使用のページに追加されます。 

Atlassian Intelligence で単一の課題を作成するには、次の手順に従います。

Atlassian Intelligence が生成する情報の品質、正確性、信頼性は変動する場合があります。 Learn why

ご利用の組織が Premium プランまたは Enterprise プランを使用しており、Atlassian Intelligence が Confluence で有効になっている場合は、Atlassian Intelligence でハイライトされたテキストから Jira 課題を生成できます。この際、ページの他の部分のコンテキストも使用されます。

1. ページ上でテキストをハイライトします。フローティング ツールバーが表示されます。

2. [+ Jira 課題] ボタンを選択します。

3. [Jira 課題を作成] サイド パネルが右側に開いて、生成された Jira 課題が表示されます。

   1. Atlassian Intelligence を使用しない場合は、[AI を使用して要約と説明を生成] をオフにします。これによって課題がリロードされ、ハイライトされたテキストのみを使用して "Jira 課題の要約" フィールドに入力されます。ハイライトされたテキストから作成されたその他の課題は、Atlassian Intelligence を使用しません。

4. Jira フィールドに入力したあと、[作成] を選択します。

課題が Jira で作成され、ご使用のページに追加されます。 

表から複数の課題を作成するには、次の手順に従います。

1. ページの表でテキストを強調表示します。フローティング ツールバーが表示されます。

2. [+ Jira 課題] ドロップダウンを選択します。

3. [複数の課題] を選択します。

4. 「複数の課題を作成」モーダルが開きます。

5. [作成] を選択します。

課題が Jira で作成され、ご使用のページのテーブルに追加されます。 

Atlassian Intelligence を使用してページから複数の課題を生成するには、次の手順に従います。

Atlassian Intelligence が生成する情報の品質、正確性、信頼性は変動する場合があります。 Learn why

1. ページの右下の AI ボタンを選択して [+ Jira 課題を作成] を選択します。Confluence により、右側のパネルに課題の一覧が生成されます。

2. 課題にカーソルを合わせ、鉛筆アイコンを選択して要約や説明の精度を確認し、必要な変更を行い、必要に応じて情報を追加します。

3. [作成] を選択して変更を保存して Jira に課題を作成するか、[キャンセル] して変更を破棄します。

4. 一覧から課題を取り除くには、課題にカーソルを合わせて X を選択します。

課題が Jira で作成され、ご使用のページに追加されます。 

エディターで課題を作成する

単一の課題を作成するには、次の手順に従います。

1. エディタで [挿入] > [Jira 課題 ] > [新しい課題を作成] を選択します。

2. ご使用のサーバー (Confluence に複数の Jira インスタンスが接続されている場合)、プロジェクト、課題タイプ、要約、説明を入力します。

3. [挿入] を選択します。

課題が Jira で作成され、ご使用のページに追加されます。

Confluence から Jira 課題を作成する場合、いくつかの制限事項があります。Jira 課題マクロまたは Jira課題の作成ダイアログは選択されたプロジェクトで課題を作成できない場合、通知します。詳細は、「Jira 課題マクロ」ページを参照してください。

Jira と Confluence の間で移動する

Confluence に Jira 課題へのリンクを追加した場合や、Jira 製品から Confluence ページへのリンクを追加した場合は、常に Jira リンク ボタンが Confluence ページ上部に表示されます。このため、Confluence と Jira との間の移動が非常に簡単になり、ワークフローをスピード アップできます。

Jira リンク ボタン上の数値は、課題の表示権限にかかわらず、そのページに接続されている課題、エピック、およびスプリントの合計数を示します。ただし、ドロップダウンでは、自身が Jira での表示権限を持つ、課題、エピック、およびスプリントの詳細のみが表示されます。

このボタンでは、Jira 課題マクロで表形式で表示されている課題のリンクは検出されません。

ソフトウェア チームの場合

Confluence と Jira を最大限に活用して、アジャイル開発チームの潜在能力を解き放つためにも、次のことをおすすめします。 

要件を定義する

Confluence は要件の定義を開始するのに最適です。製品要件テンプレートによって要件を定義後、Confluence の要件ページで Jira エピックやその他の課題を直接作成できます。

手順は次のとおりです。

1. 製品要件テンプレートによって Confluence ページを作成します。

2. プレースホルダー テキスト「Jira エピックまたは機能へのリンク」を選択し、[新しい課題を作成] を選択して Jira でエピックを作成します。

3. チームとコラボレーションしてストーリーを定義し、ページを保存します。

4. 要件ページでテキストをハイライトして [Jira 課題を作成] リンクを選択し、Jira でストーリーを作成すると、エピックに自動でリンクされます。

5. Confluence ページまたは Jira 内からストーリーの進捗を追跡します。

Confluence と Jira は緊密に統合されています。Confluence ページから課題に簡単にアクセスしてステータスをすばやくチェックできるほか、関連する Confluence ページへのリンクを Jira 内で確認できます。このように、必要なすべての情報が 1 か所にまとまっています。

スプリントの管理 

多くの場合、Confluence にはスプリント中にチームに役立つコンテキストを提供する多数の資料があります。これらには、要件定義書、設計、技術仕様書、カスタマーリサーチなどが挙げられます。これらのページをエピックにリンクすることで、チームはスプリント中に資料を簡単に見つけることができます。 

Confluence を使用して Jira Agile 内からスプリントをサポートする方法は次のとおりです。

• Jira で、スプリントを計画する Confluence ページを作成します。このページはミーティング議事録テンプレートによって作成され、スプリントに自動でリンクされます。

• エピックで、要件や設計などの便利な Confluence ページへのリンクを作成します。

• Confluence にある Jira レポート ブループリントによって、関係者に進捗状況を報告します。

• スプリントの最後に、Confluence でふりかえりテンプレートによって、うまくいったことやうまくいかなかったことに関する実績を評価します。

主に Jira を使用するユーザーの場合は、この統合によって便利な Confluence ページにワンクリックでアクセスできます。

ロードマップを共有する

If you're using a team-managed Jira Cloud project, you can project's roadmap to a Confluence page. See Jira Roadmap Macro to learn more.

サービス チーム向け

カスタマーに自己解決リソースを提供する

Jira Service Management を使用する場合は、Jira Service Management プロジェクトを Confluence のナレッジ ベースに接続することで、顧客がリクエストを作成せずに自分で課題を解決できるようにサポートできます。 

Jira Service Management で、[管理] > [Confluence KB] (Jira Service Management Server 2.x 以前をご利用の場合は [設定] > [ナレッジ ベース]) の順に移動して、Confluence スペースを接続または作成します。 

Jira Service Management の顧客がカスタマー ポータルを検索すると、リンクされたナレッジ ベース スペースのページが提案されて、顧客が自分で問題を解決できます。 

ナレッジベース記事の作成

ナレッジ ベース スペース ブループリントをハウツーとトラブルシューティングの各記事のテンプレートを併用することで、Jira Service Management エージェントは新しいナレッジ ベース記事を遥かに簡単に作成できます。 

また、ハウツーやトラブルシューティングのブループリントで使用されるテンプレートは、完全にカスタマイズ可能です。テンプレートに標準情報を含めてセットアップすれば、エージェントはそこから開始できます。 

すべてのアクティブ ユーザーにナレッジベース スペースの閲覧を許可する

Confluence インスタンスが公開されていなくても、カスタマー ポータル経由でナレッジベース スペースを利用可能にできます。 

Jira Service Management プロジェクトを Confluence スペースにリンクすると、すべてのアクティブ ユーザーと顧客に対して、両者が Confluence ライセンスを持っていない場合すらも、リンクされているスペースのページの閲覧を許可することを選択できます。これらのユーザーは非常に制限された Confluence アクセス権を持ちます。 

ライセンスを持たないユーザーは次の操作を行えます。

• Jira Service Management のカスタマー ポータル経由でページを閲覧する。

• URL に従ってページに移動し、リンクされたスペース内を移動する。

ライセンスを持たないユーザーは次の操作は行なえません。

• ページにいいね! やコメントを追加する。またはページを編集する (または、これを実行する権限を付与される)。

• ダッシュボード、 ユーザー プロファイル、ピープル ディレクトリ、またはスペース ディレクトリを参照する。

• Confluence インスタンス全体を検索します。

この権限は Jira Service Management を介してのみ有効化できますが、Confluence のグローバル権限またはスペース権限で、インスタンス全体または特定のスペースへのアクセスを取り消すことができます。 

すべてのアクティブ ユーザーとカスタマーにスペースの閲覧を許可すると、既存のすべてのスペース権限が上書きされます。そのため、ログイン済みのライセンスを持つすべての Confluence ユーザーも、グループ メンバーシップにかかわらず、スペースを閲覧できるようになります。これは、Confluence での権限の継承方法によるものです。

Jira 製品の機能

ここまでで説明してきたように、Confluence には多くの統合ポイントがあり、その一部は特定の Jira 製品でのみ利用可能です。Confluence Cloud に接続する Jira 製品のタイプに応じてアクセス可能な機能に関しては、以下をご確認ください。