Jira と Confluence を一緒に利用する
Confluence and Jira are like bacon and eggs; coffee and cake. Separately, they're great, but together, they're amazing!
On this page:
はじめる前に
To display and create Jira issues and more from within Confluence, first connect your Confluence and Jira sites using Application Links.
What you can do with Confluence and Jira depends on the Jira application, version, and how it is hosted. Find out about the required applications and versions later in this page.
Confluence Cloud と Jira Software Cloud の連携方法については、こちらのガイドをご確認ください。
すべてのプロジェクトまたはチーム向け
ページに課題を表示する
Jira 課題は、Jira 課題マクロを使用して Confluence ページに表示できます。単一の課題や課題のリストを表示したり、課題数の合計を表示します。
Jira 課題を Confluence に追加する最も簡単な方法は、Confluence ページに Jira URL を貼り付けることです。
または、Jira 課題マクロをページに追加して課題を直接検索できます。
- In the editor, select Insert > Jira Issue.
- マクロブラウザでプロンプトに従ってプロジェクトを選択し、課題を検索します。JIRA クエリ言語 (JQL)も使用できます。
マクロを追加したら、ページでの課題または課題一覧の表示方法をカスタマイズできます。これには、表示する情報の量や課題数なども含まれます。
レポートやグラフを作成する
Confluence では、Jira に保管された情報のレポートを簡単に作成できます。Jira アプリケーションからの情報を視覚的に表示するには、Jira 課題マクロに加えて、Jira レポート ブループリントまたは Jira グラフ マクロを使用できます。チームやプロジェクトの進捗状況のスナップショットをステークホルダーに提供するのに最適です。
以下のことが可能です。
- JIRA レポートブループリントを使用して 変更ログまたはステータスレポートを作成します。
- Jira チャート マクロを使用して、データをグラフとして表示します。円グラフ、作成済 vs 解決済グラフ、2 次元グラフなどがあります。
- Use Jira Gadgets to display detailed Jira reports and charts on pages.
Confluence 内から課題を作成する
Confluence でページを表示しながら、またはエディター内から、課題を作成できます。要件の計画と収集のために Confluence を使用する場合、これは非常に便利です。
ページの表示中に課題を作成する方法
- Highlight some text on your page and select the
Create Jira issue icon that appears above the highlighted text. - ご使用の サーバー (Confluence に接続されている複数の Jira サイトがある場合)、プロジェクト、課題タイプおよび説明を入力します。強調表示されたテキストは、課題のサマリを自動的に取り込みます。
- [作成] を選択します。
課題が Jira で作成され、ご使用のページに追加されます。テキストが表内にある場合、同じ列のテキストを使用して複数の課題を作成できます。
テキストを選択したときにポップアップが表示されない場合、プロフィールの設定で [テキスト選択] が有効になっているかどうかを確認してください。
エディターで課題を作成する方法
- In the editor select Insert > Jira Issue > Create new issue.
- ご使用のサーバー (Confluence に接続されている複数の Jira サイトがある場合)、プロジェクト、課題タイプ、サマリおよび説明を入力します。
- [挿入] を選択します。
課題が Jira で作成され、ご使用のページに追加されます。
Confluence から Jira 課題を作成する場合、いくつかの制限事項があります。選択されたプロジェクトで課題を作成できない場合、Jira 課題マクロまたは Jira課題の作成ダイアログで通知されます。詳細は、「Jira 課題マクロ」ページを参照してください。
Jira と Confluence の間で移動する
Whenever you add a link to Jira issues in Confluence, or link to a Confluence page from your Jira application, the Jira Links button appears at the top of the Confluence page. This makes it really easy to jump from Confluence to Jira and vice versa, speeding up your workflow.
Jira リンク ボタン上の数値は、課題の表示権限にかかわらず、そのページに接続されている課題、エピック、およびスプリントの合計数を示します。ただし、ドロップダウンでは、自身が Jira での表示権限を持つ、課題、エピック、およびスプリントの詳細のみが表示されます。
このボタンでは、Jira 課題マクロで表形式で表示されている課題のリンクは検出されません。
Jira からページにリンクする
Jira で課題を表示する際に、関連する Confluence ページにリンクすることができます。
リンク方法は Jira アプリケーションによって異なりますが、Confluence ページを検索したり、URL を入力したりするためのリンク オプションがあります。
Jira Cloud アプリケーションを使用する場合、Confluence Data Center のページを検索するオプションは、Confluence Cloud を導入していないサイトでのみ利用可能です。これは、Jira の初期設定では、リンクされた他の Jira アプリケーションよりも、Confluence Cloud の検索が優先されるためです。
ソフトウェア チームの場合
Confluence と Jira Software から最大の利益を得て、アジャイル開発チームの潜在力を引き出していただくために次のことをお勧めします。
要件を定義する
Confluence は要件定義の開始に最適な場所です。製品要件ブループリントを使用すると、 要件の取り込みに加えて、Confluence の要件ページから直接 Jira エピックやその他の課題を作成できるようになります。
手順は次のとおりです。
- 製品要件ブループリントを使用して Confluence ページを作成します。
- Select the placeholder text 'Link to Jira epic or feature' and select Create new issue to create your epic in Jira.
- チームとコラボレーションしてストーリーを定義し、ページを保存します。
- Highlight text on your requirements page and select the Create Jira issue link to create stories in Jira, and automatically link them to your epic.
- Confluence ページまたは Jira 内からストーリーの進捗を追跡します。
Confluence と Jira Software の緊密な連携により、Confluence ページから課題に簡単にアクセスしたり、ステータスを確認したりすることができ、Jira Software 内からは関連する Confluence ページへのリンクを表示できます。必要なすべての情報を 1 か所で確認できます。
Jira Software Cloud を使用している場合、Confluence で作成された課題をエピックに自動的にリンクするオプションは、クラシック プロジェクトでのみ使用できます。
スプリントの管理
多くの場合、Confluence にはスプリント中にチームに役立つコンテキストを提供する多数の資料があります。これらには、要件定義書、設計、技術仕様書、カスタマーリサーチなどが挙げられます。これらのページをエピックにリンクすることで、チームはスプリント中に資料を簡単に見つけることができます。
Confluence を使用して Jira Agile 内からスプリントをサポートする方法は次のとおりです。
- Jira Software で、Confluence ページを作成してスプリントを計画します。ページはミーティング議事録 ブループリントと必要な詳細を取り込むのに役立つ便利なテンプレートを使用して作成します。作成されたページは自動的にスプリントにリンクされます。
- エピックで、要件や設計などの便利な Confluence ページへのリンクを作成します。
- Confluence 内の Jira レポート ブループリントを使用してステークホルダーに進捗状況を報告します。
- スプリントの最後に Confluence でふりかえりブループリントを使用して、成功したことと不十分だったことについて実績を評価します。
この連携により、Jira Software でほとんどの作業を行うユーザーは、便利な Confluence ページに 1 クリックでアクセスできるようになります。
Jira Software Cloud を使用している場合、スプリントからページを作成するオプションは、クラシック プロジェクトでのみ使用できます。
サービス チーム向け
Jira Service Management (旧 Jira Service Desk) Data Center および Server のみで利用できます。Jira Service Management Cloud を使用している場合、プロジェクトを Confluence Server または Data Center サイトのナレッジ ベース スペースに接続することはできません。Confluence Cloud サイトにのみ接続することができます。Confluence Server から Cloud への移行方法をお読みください。
カスタマーに自己解決リソースを提供する
Jira Service Management を使用する場合、サービス プロジェクトを Confluence 内のナレッジ ベースに接続することによって、カスタマーがリクエストを作成せずに自分で課題を解決できるように支援することができます。Confluence 5.10 以降が必要になります。
Jira Service Management で、[プロジェクト設定] > [ナレッジ ベース] に移動し、Confluence スペースを接続または作成します。
カスタマーがカスタマー ポータルを検索すると、リンクされたナレッジ ベース スペースのページが提案され、カスタマーは問題を自分で解決することができます。
ナレッジベース記事の作成
ナレッジ ベース ブループリントと、ハウツー記事およびトラブルシューティング記事のテンプレートを併用することで、エージェントは新しいナレッジ ベース記事を非常に簡単に作成できるようになります。
また、ハウツーおよびトラブルシューティング ブループリントで使用されるテンプレートは、完全にカスタマイズ可能です。テンプレートに標準情報を含めてセットアップし、エージェントはそこから開始するようにすることができます。
すべてのアクティブ ユーザーにナレッジベース スペースの閲覧を許可する
Confluence インスタンスが公開されていなくても、カスタマー ポータル経由でナレッジベース スペースを利用可能にできます。
サービス プロジェクトを Confluence スペースにリンクすると、すべてのアクティブ ユーザーおよびカスタマーに対し、彼らが Confluence ライセンスを持っていない場合も、リンクされているスペースのページの閲覧を許可することを選択できます。これらのユーザーは非常に制限された Confluence アクセス権を持ちます。
ライセンスを持たないユーザーは次の操作を行えます。
- view pages via the customer portal
- follow a URL to a page and then navigate within the linked space
ライセンスを持たないユーザーは次の操作は行なえません。
- like, comment on or edit pages (or be granted permission to do this)
- see the dashboard, user profiles, the people directory or space directory
- search the whole site
この権限は Jira Service Management を介してのみ有効化できますが、Confluence のグローバル権限またはスペース権限で、サイト全体または特定のスペースへのアクセスを取り消すことができます。
必要な Jira アプリケーション
ここまでで説明してきたように、Confluence には多くの連携ポイントがあり、その一部は特定の Jira アプリケーションまたはバージョンでのみ利用可能です。
次のマトリクスは、各機能に必要な特定の Jira アプリケーションの概要を示しています。以下の内容も含まれます。
- 最新の Jira Server アプリケーションまたは Data Center アプリケーションを使用していないユーザー向けに必要となる Jira Server の最小バージョン (およびアドオン)。
- 必要となる最小クラウド プランと、サイト内のプロジェクト タイプやアプリに制限があるかどうか (たとえば、Confluence Cloud サイトも持っている場合、一部の統合は利用できません)。
| 機能 | Jira Core | Jira Software | Jira Service Management (旧 Jira Service Desk) | 最小の既存バージョン | Jira Cloud のプラン |
|---|---|---|---|---|---|
| Jira 課題マクロを使用して課題を表示する |  | | | Jira 4.3 | すべて |
| Jira グラフ マクロを使用して課題およびプロジェクト情報を表示する | | | | Jira 5.0 | すべて |
| Jira レポート ブループリントを使用して課題およびプロジェクト情報を表示する | | | | Jira 5.0 | すべて |
| Jira 課題マクロから課題を作成する | | | | Jira 4.3 | すべて |
| Confluence ページでテキストを選択することで課題を作成する | | | | Jira 6.3.1 | すべて |
| Confluence ページでテキストを選択することで課題を作成し、課題を自動的にエピックにリンクする |  | | | Jira 6.3.1 および Jira Agile 6.3.5 |  クラシック プロジェクトのみ |
| エピックとスプリントから Confluence ページをリンクおよび作成する | | | | Jira 6.3.1 および Jira Agile 6.3.5 | Jira のみのサイト クラシック プロジェクトのみ |
| Confluence 内の Jira リンクボタンでリンク済みの課題を表示する | | | | Jira 6.3.1 | すべて |
| ソフトウェア プロジェクト スペース ブループリントを使用してスペースを作成する | | | | Jira Software 7.0 | すべて |
Confluence スペースをカスタマー ポータルでナレッジベースとして使用する | | | | Jira 5.2 および Jira Service Desk 1.0 | |
| Confluence ライセンスを持たない Service Management カスタマーにナレッジ ベース記事の閲覧を許可する | | | | Jira Service Desk 3.1 | |
Jira リンク ダイアログ内で既存の Confluence ページを検索する | | | | Jira 4.3 | Jira のみのサイト |
| ユーザー管理を Jira に委任する | | | | Jira 4.3 | |
| Jira ガジェットを Confluence ページに追加する | | | | Jira 4.3 | すべて |
ぜひ Confluence に移動し、これらの優れた機能のいくつかをあなたのチームやプロジェクトで試してみてください。
Jira アプリケーションを Confluence に接続する方法の詳細を調べるには、「Jira と Confluence の統合」を参照してください。