JIRA と Confluence を一緒に利用する

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

Confluence と JIRA は、 ベーコンと卵、コーヒーとケーキ、サイモンとガーファンクルのような関係です。別々でも優れていますが、一緒になると驚くほどの能力を発揮します。

アプリケーション リンクを使用して Confluence および JIRA サイトが接続されている場合、 Confluence 内から JIRA 課題の表示や作成などが可能です。 

Confluence および JIRA で実行できることは、ご使用の JIRA アプリケーションとバージョンにより異なります。必須のアプリケーションとバージョンについては、このページの後半で説明しています。

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

ページに課題を表示する

JIRA 課題は、JIRA 課題マクロを使用して Confluence ページに表示できます。単一の課題や課題のリストを表示したり、課題数の合計を表示します。

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

いくつかの例はこちら...
  • <yourjirasite.com>/browse/CONF-1234 will insert the JIRA Issues macro and display a single issue.
  • <yourjirasite.com>/issues/?filter=56789  will insert the JIRA Issues macro and display a list of issues matching the saved filter. 
  • <yourjirasite.com>/issues/?jql=project%20%3D%20CONF  will insert the JIRA Issues macro and display a list of issues matching the JIRA search. 

このページの内容:

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

  1. エディターで挿入 > JIRA 課題を選択します。
  2. マクロブラウザでプロンプトに従ってプロジェクトを選択し、課題を検索します。JIRA クエリ言語 (JQL)も使用できます。

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

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

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

以下のことが可能です。

  • JIRA レポートブループリントを使用して 変更ログまたはステータスレポートを作成します。
  • JIRA グラフマクロを使用して グラフとしてデータを表示します。円グラフ、作成済 vs 解決済グラフ、2次元グラフなどがあります。 
  • JIRA ガジェットを使用して、詳細な JIRA レポートおよびグラフをページに表示します。 

Confluence 内から課題を作成する

Confluence でページを表示しながら、またはエディター内から、課題を作成できます。要件の計画と収集のために Confluence を使用する場合、これは非常に便利です。 

ページの表示中に課題を作成するには:

  1. Highlight some text on your page and choose the  Create JIRA issue icon that appears above the highlighted text.
  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. Highlight text on your requirements page and choose the Create JIRA issue  link to create stories in JIRA, and automatically link them to your epic.
  5. Confluence ページまたは JIRA 内からストーリーの進捗を追跡します。

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

スプリントの管理 

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

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

  • JIRA Software で、Confluence ページを作成してスプリントを計画します。ページはミーティング議事録 ブループリントと必要な詳細を取り込むのに役立つ便利なテンプレートを使用して作成します。作成されたページは自動的にスプリントにリンクされます。
  • エピックで、要件や設計などの役立つ Confluence ページへのリンクを作成します。
  • Confluence 内のJIRA レポートブループリントを使用して関係者に進捗状況を報告します。
  • スプリントの最後に Confluence でふりかえりブループリントを使用して、成功したことと不十分だったことについて実績を評価します。

主に JIRA Software で作業する人にとって、連携とは、役立つ Confluence ページがクリックするだけで表示できることを意味します。

JIRA Service Desk チームの場合

カスタマーにセルフヘルプ リソースを提供する

JIRA Service Desk を使用する場合、JIRA Service Desk プロジェクトを Confluence 内のナレッジベースに接続することによって、カスタマーがリクエストを作成せずに自分で課題を解決できるように支援することができます。 

Service Desk で、プロジェクト設定 > ナレッジベースに進み、Confluence スペースを接続または作成します。 

Service Desk のお客様がカスタマー ポータルを検索する場合、ナレッジベース スペースにリンクされたページが提案され、問題を自分で解決することができます。 

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

ナレッジベース ブループリントと How To 記事およびトラブルシューティング記事のテンプレートを併用することで、JIRA Service Desk エージェントは新しいナレッジベースの記事を非常に簡単に作成できるようになります。 

また、How To およびトラブルシューティングのブループリントで使用されるテンプレートは、完全にカスタマイズ可能です。テンプレートはすべて標準的な情報で設定し、エージェントがそこから情報を得られるようにします。 

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

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

JIRA サービス デスク プロジェクトを Confluence スペースにリンクさせる場合は、Confluence ライセンスを持っていない場合でも、すべてのアクティブなユーザーおよび顧客に対し、リンクされているスペース内のページの閲覧を許可するよう選択できます。  これらのユーザーは非常に制限された Confluence アクセス権を持ちます。 

ライセンスを持たないユーザーが可能な操作:

  • JIRA サービスデスクのカスタマーポータル経由でページを閲覧する。
  • URL に従ってページに移動し、次に、リンクされたスペース内を移動します。

ライセンスを持たないユーザーができない操作:

  • ページにイイネやコメントを付ける、または編集する (またはこれを実行する権限を供与する)。
  • ダッシュボード、 ユーザープロファイル、ピープルディレクトリ、スペースディレクトリを参照してください。
  • サイト全体を検索する。

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

Confluence 権限に関する注釈...

すべてのアクティブなユーザーと顧客にスペースの閲覧を許可すると、すべての既存のスペース権限が上書きされます。そのため、ログインが行われると、ライセンスを持つ Confluence ユーザーもスペースを見ることができます (グループ メンバーシップに関係なく)。これは、Confluence が権限を継承する方法によるものです。 

必須の JIRA アプリケーション

これまで説明してきたとおり、Confluence には多くの連携ポイントがあり、その一部は特定の JIRA アプリケーションまたはバージョンでのみ利用可能です。 

次のマトリックスは、各機能に必要な特定の JIRA アプリケーションの概要を示しています。最新の JIRA アプリケーションを使用していない場合、必要となる最小の既存 JIRA サーバーのバージョン (およびアドオン) も示しました。

機能 JIRA Core Jira Software Jira Service Desk 最小の既存バージョン
JIRA 課題マクロを使用して課題を表示する (tick) (tick) (tick) JIRA 4.3
JIRA グラフマクロを使用して課題およびプロジェクト情報を表示する (tick) (tick) (tick) JIRA 5.0
JIRA レポートブループリントを使用して課題およびプロジェクト情報を表示する (tick) (tick) (tick) JIRA 5.0
JIRA 課題マクロから課題を作成する (tick) (tick) (tick) JIRA 4.3
Confluence ページでテキストを強調表示することにより課題を作成する (tick) (tick) (tick) Jira 6.3.1
Confluence ページでテキストを強調表示することにより課題を作成し、自動的に課題をエピックにリンクする  (error) (tick) (error) JIRA 6.3.1 および
JIRA Agile 6.3.5
エピックとスプリントから Confluence ページをリンクおよび作成する  (error)  (tick) (error) JIRA 6.3.1 および
JIRA Agile 6.3.5
Confluence 内の JIRA リンクボタンでリンク済みの課題を表示する (tick) (tick) (tick) Jira 6.3.1
ソフトウェア プロジェクト用のスペース ブループリントを使用してスペースを作成する (error) (tick) (error) JIRA Software 7.0

Confluencec スペースをカスタマーポータル内でナレッジベースとして使用する

(error) (error) (tick) JIRA 5.2 および
JIRA Service Desk 1.0
サービス デスクの顧客に対し、Confluence ライセンスがなくてもナレッジベース記事の閲覧を許可する (error) (error) (tick) JIRA Service Desk 3.1

JIRA リンクダイアログ内で既存の Confluence ページを検索する

 (tick)  (tick)  (tick) JIRA 4.3
ユーザー管理を JIRA に代行させる (tick) (tick) (tick) JIRA 4.3
JIRA ガジェットを Confluence ページに追加する (tick) (tick) (tick) JIRA 4.3

以上です。Confluence に移動し、これらの優れた機能をチームやプロジェクトで試してみてください。JIRA アプリケーションを Confluence に接続する方法の詳細を調べるには、「JIRA と Confluence の統合」を参照してください。

最終更新日: 2018 年 9 月 18 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.