Jira と Confluence を一緒に利用する

このページの内容

お困りですか?

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

コミュニティに質問

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


Cloud インスタンス内で Confluence と Jira アプリケーションの両方を使用している場合、Confluence 内から Jira 課題の表示や作成などができます。

tip/resting Created with Sketch.

Confluence を Jira に、またはその逆に追加する準備ができたら、移動

設定 (または )

> 新しいアプリケーションの発見 に移動し、無料トライアルを開始します。


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

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

ページに課題を表示する

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

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 ページへのリンクを表示できます。必要なすべての情報はすぐ近くにあります。

スプリントの管理 

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

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

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

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

ロードマップを共有する

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

JIRA Service Desk チームの場合

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

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

Jira Service Desk で、管理 > Confluence KB (Jira Service Desk 2.x 以前を使用している場合は、設定 > ナレッジベース) に進み、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 アプリケーションの概要を示しています。お客様の Cloud サイトが Jira Server サイトに接続していない場合、必要となる最小の既存 Jira サーバーのバージョン (およびアドオン) も示しました。

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

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

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

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

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

これで終わりです。Confluence へ移動し、これらの優れた機能のいくつかをあなたのチームやプロジェクトに試してみてください。

最終更新日 2019 年 7 月 9 日

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

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