Jira と Confluence を一緒に利用する

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

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

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

ページまたはリアルタイム文書に作業項目を表示する

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

Confluence に Jira 作業項目を追加する最も簡単な方法は、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 で単一の作業項目を作成するには、次の手順に従います。

Rovo が生成する情報の品質、正確性、信頼性は異なる場合があります。

組織が 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 を使用して公開済みのページから複数の作業項目を生成するには、次の手順に従います。

Rovo が生成する情報の品質、正確性、信頼性は異なる場合があります。

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 ページまたはドキュメントの上部に Jira リンク ボタンが表示されます。このため、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 から作業項目に簡単にアクセスしてステータスを一目で確認できるほか、 Jira 内からは、関連する Confluence ページやドキュメントへのリンクを確認できます。必要なすべての情報が 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 アプリのタイプに応じてアクセス可能な機能に関しては、以下をご確認ください。