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 でページを表示しながら、またはエディタ内から、課題を作成できます。Confluence を要件の計画や収集のために使用することができます。 

ページの表示中に課題を作成する方法

1. ページ上でテキストをハイライトして、そのテキストの上部に表示される [Jira 課題を作成] アイコンを選択します。

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

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

課題が 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 Software を最大限に活用し、アジャイル開発チームの潜在能力を解き放つため、次のことをおすすめします。 

要件を定義する

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

手順は次のとおりです。

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

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

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

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

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

Confluence と Jira Software の緊密な連携により、Confluence ページから課題に簡単にアクセスしたり、ステータスを確認したりすることができ、Jira Software 内からは関連する Confluence ページへのリンクを表示できます。必要なすべての情報を 1 か所で確認できます。

スプリントの管理 

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

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

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

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

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

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

この連携により、Jira Software でほとんどの作業を行うユーザーは、便利な Confluence ページに 1 クリックでアクセスできるようになります。

ロードマップを共有する

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