Jira と Confluence を一緒に利用する

このページの内容

お困りですか?

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

コミュニティに質問

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


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

tip/resting Created with Sketch.

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

(設定)

> [新しいアプリを検索] の順に選択します。


Confluence および Jira で実行できることは、Cloud インスタンスでご利用の 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 Software Cloud プロジェクトを使用している場合、プロジェクトのロードマップを Confluence ページに追加できます。詳細については、「Jira ロードマップ マクロ」を参照してください。

サービスデスク チームの場合

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

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

Jira Service Desk で、[管理] > [Confluence KB] (Jira Service Desk 2.x 以前を使用している場合は [設定] > [ナレッジベース]) に進み、Confluence スペースを接続または作成します。 

サービスデスクのカスタマーがカスタマー ポータルを検索すると、リンクされたナレッジベース スペースのページが提案され、カスタマーは問題を自分で解決することができます。 

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

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

また、ハウツーおよびトラブルシューティング ブループリントで使用されるテンプレートは、完全にカスタマイズ可能です。テンプレートに標準情報を含めてセットアップし、エージェントはそこから開始するようにすることができます。 

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

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

Jira Service Desk プロジェクトを Confluence スペースにリンクすると、すべてのアクティブ ユーザーおよびカスタマーに対し、彼らが Confluence ライセンスを持っていない場合も、リンクされているスペースのページの閲覧を許可することを選択できます。 これらのユーザーは非常に制限された Confluence アクセス権を持ちます。 

ライセンスを持たないユーザーは次の操作を行えます。

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

ライセンスを持たないユーザーは次の操作は行なえません。

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

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

すべてのアクティブ ユーザーとカスタマーにスペースの閲覧を許可すると、既存のすべてのスペース権限が上書きされます。そのため、ログイン済みのライセンスを持つすべての Confluence ユーザーも、グループ メンバーシップにかかわらず、スペースを閲覧できるようになります。これは、Confluence での権限の継承方法によるものです。

必要な Jira アプリケーション

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

次のマトリクスは、各機能に必要な特定の Jira アプリケーションの概要を示しています。お客様の Cloud サイトが Jira Server サイトに接続していない場合に必要となる従来の Jira Server の最小バージョン (およびアドオン) も示しています。

機能Jira CoreJira SoftwareJira 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)

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

(error)(error)(tick)
Confluence ライセンスを持たないサービス デスク カスタマーにナレッジベース記事の閲覧を許可する(error)(error)(tick)

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

 (tick) (tick) (tick)
ユーザー管理を Jira に委任する(tick)(tick)(tick)
Jira ガジェットを Confluence ページに追加する(tick)(tick)(tick)

説明は以上です。Confluence に移動し、これらの優れた機能をあなたのチームやプロジェクトで試してみてください。

最終更新日 2020 年 4 月 17 日

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

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