Jira と Confluence を一緒に利用する

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

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

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

作業項目をページに表示する

Jira 作業項目を Confluence ページに表示するには、Jira 作業項目マクロを使用します。1 つの作業項目、作業項目のリスト、または作業項目の総数を表示できます。

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 が生成する情報の品質、正確性、信頼性は変動する場合があります。 理由を確認する

組織が Premium プランまたは Enterprise プランを使用しており、Atlassian Intelligence が Confluence インスタンスまたは Jira インスタンスで有効になっている場合は、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 が生成する情報の品質、正確性、信頼性は変動する場合があります。 理由を確認する

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 ページにワンクリックでアクセスできます。

ロードマップを共有する

チーム管理対象 Jira Cloud プロジェクトを使用している場合、プロジェクトのロードマップを Confluence ページに追加できます。詳細については、「Jira ロードマップ マクロ」を参照してください。

サービス チーム向け

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

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 製品のタイプに応じてアクセス可能な機能に関しては、以下をご確認ください。