Jira と Confluence を一緒に利用する
Confluence と Jira 製品は、ベーコンと卵、コーヒーとケーキ、サイモンとガーファンクルのような関係です。別々でも優れていますが、一緒になると驚くほどの能力を発揮します。Confluence および Jira 製品が Cloud サイトにある場合、両方のツールの間でシームレスにプロジェクト更新を追跡し、作業中の Confluence ページを終了せずに Jira 課題を作成することができます。
Confluence を Jira に、またはその逆に追加する準備ができたら、[
] (設定) > [新しいアプリの検索] に移動します。
Confluence および Jira で実行できることは、Cloud サイトでご利用の Jira 製品の種類により異なります。このページの後半でそれぞれの Jira 製品で使用できる機能の種類を確認してください。
すべてのプロジェクトまたはチーム向け
ページに課題を表示する
Jira 課題はを Confluence ページに表示するには、Jira 課題マクロを使用します。単一の課題や課題の一覧を表示したり、課題数の合計を表示したりすることができます。
Jira 課題を Confluence に追加する最も簡単な方法は、Confluence ページに Jira URL を貼り付けることです。
または、Jira 課題マクロをページに追加して課題を直接検索できます。
- エディターで [挿入] > [Jira 課題] を選択します。
- マクロ ブラウザでプロンプトに従ってプロジェクトを選択し、課題を検索します。Jira クエリ言語 (JQL) も使用できます。
マクロを追加したら、ページでの課題または課題一覧の表示方法をカスタマイズできます。これには、表示する情報の量や課題数なども含まれます。
レポートやグラフを作成する
Confluence では、Jira に保管された情報のレポートを簡単に作成できます。Jira 製品からの情報を視覚的に表示するには、Jira 課題マクロに加えて、Jira レポート ブループリントまたは Jira グラフ マクロを使用できます。チームやプロジェクトの進捗状況のスナップショットを関係者に提供する一番良い方法です。
以下のことが可能です。
- Jira レポート ブループリントを使用して 変更履歴またはステータス レポートを作成します。
- Jira グラフ マクロを使用して、データをグラフとして表示します。円グラフ、作成済 vs 解決済グラフ、2 次元グラフなどがあります。
- Jira ガジェットを使用して、詳細な Jira レポートおよびグラフをページに表示します。
Confluence 内から課題を作成する
Confluence でページを表示しながら、またはエディタ内から、課題を作成できます。Confluence を要件の計画や収集のために使用することができます。
ページの表示中に課題を作成する方法
- ページでテキストを選択し、上に表示される
Jira 課題の作成アイコンを選択します。 - ご使用のサーバー (Confluence に複数の Jira サイトが接続されている場合) プロジェクト、課題タイプおよび説明を入力します。選択したテキストは、課題の要約として自動的に取り込まれます。
- [作成] を押します。
課題が Jira で作成され、ご使用のページに追加されます。テキストが表内にある場合、同じ列のテキストを使用して複数の課題を作成できます。
テキストを選択したときにポップアップが表示されない場合、プロフィールの設定で [テキスト選択] が有効になっているかどうかを確認してください。
エディターで課題を作成する方法
- エディタで [挿入] > [Jira 課題 ] > [新しい課題を作成] を選択します。
- ご使用のサーバー (Confluence に複数の Jira サイトが接続されている場合) プロジェクト、課題タイプ、要約、および説明を入力します。
- 挿入を押す
課題が 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 エピックやその他の課題を直接作成できます。
手順は次のとおりです。
- 製品要件テンプレートを使用して Confluence ページを作成します。
- プレースホルダー テキスト「Jira エピックまたは機能へのリンク」を選択し、[新しい課題を作成] を選択して Jira でエピックを作成します。
- チームとコラボレーションしてストーリーを定義し、ページを保存します。
- 要件ページでテキストを選択し、Jira 課題の作成 リンクを選択して Jira でストーリーを作成します。自動的にエピックにリンクされます。
- 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 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 に従ってページに移動し、リンクされたスペース内を移動する。
ライセンスを持たないユーザーは次の操作は行なえません。
- ページにいいね! やコメントを追加する。またはページを編集する (または、これを実行する権限を付与される)。
- ダッシュボード、 ユーザー プロファイル、ピープル ディレクトリ、またはスペース ディレクトリを参照する。
- サイト全体を検索する。
この権限は Jira Service Management を介してのみ有効化できますが、Confluence のグローバル権限またはスペース権限で、サイト全体または特定のスペースへのアクセスを取り消すことができます。
すべてのアクティブ ユーザーとカスタマーにスペースの閲覧を許可すると、既存のすべてのスペース権限が上書きされます。そのため、ログイン済みのライセンスを持つすべての Confluence ユーザーも、グループ メンバーシップにかかわらず、スペースを閲覧できるようになります。これは、Confluence での権限の継承方法によるものです。
Jira 製品の機能
ここまでで説明してきたように、Confluence には多くの連携ポイントがあり、その一部は特定の Jira 製品でのみ利用可能です。Confluence Cloud サイトに接続する Jira 製品のタイプに応じてアクセスできる機能を確認してください。
| 機能 | Jira Work Management | Jira Software | Jira Service Management |
|---|---|---|---|
| Jira 課題マクロを使用して課題を表示する |  | | |
| Jira グラフ マクロを使用して課題およびプロジェクト情報を表示する | | | |
| Jira レポート ブループリントを使用して課題およびプロジェクト情報を表示する | | | |
| Jira 課題マクロから課題を作成する | | | |
| Confluence ページでテキストを選択することで課題を作成する | | | |
| Confluence ページでテキストを選択することで課題を作成し、課題を自動的にエピックにリンクする |  | | |
| エピックとスプリントから Confluence ページをリンクおよび作成する | | | |
| Confluence 内の Jira リンクボタンでリンク済みの課題を表示する | | | |
| ソフトウェア プロジェクト スペース ブループリントを使用してスペースを作成する | | | |
Confluence スペースをカスタマー ポータルでナレッジベースとして使用する | | | |
| Confluence ライセンスを持たない Jira Service Management カスタマーにナレッジ ベース記事の閲覧を許可する | | | |
Jira リンク ダイアログ内で既存の Confluence ページを検索する | | | |
| ユーザー管理を Jira に委任する | | | |
| Jira ガジェットを Confluence ページに追加する | | | |