Jira と Confluence を一緒に利用する

Confluence と Jira の各製品は、ベーコンと卵、コーヒーとケーキ、サイモンとガーファンクルのような関係です。別々でも最高ですが、一緒になると驚愕することでしょう。Confluence と Jira の両製品が Cloud サイトにある場合は、両ツール全体でプロジェクト更新をシームレスに追跡して、作業中の Confluence ページに留まったまま Jira 課題を作成できます。

Confluence と Jira で実行できることは、Cloud サイトでご利用の Jira 製品の種類によって異なります。各 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 内から課題を作成する

You can create issues while viewing a page or from the editor, letting you use Confluence for planning and gathering requirements. You can create a single issue from highlighted text, create multiple issues from a table, or use Atlassian Intelligence (AI) to generate issues for you, either one at a time or by scanning your page and drafting multiple issues at once.

Create issues when viewing a page

To create a single issue from a Confluence page, as a customer with the Free or Standard plan:

1. Highlight text on your page. The floating toolbar appears.

2. Select the + Jira issue dropdown.

3. Select Create single issue.

4. The Create Jira issue side panel opens on the right.

5. Complete your Jira fields and select Create.

課題が Jira で作成され、ご使用のページに追加されます。 

To create a single issue using Atlassian Intelligence:

If your organization is on a Premium or Enterprise plan and if Atlassian Intelligence is activated for Confluence, you can use Atlassian Intelligence to generate a Jira issue from highlighted text that will also use context from the rest of the page.

1. Highlight text on your page. The floating toolbar appears.

2. Select the + Jira issue button.

3. The Create Jira issue side panel opens on the right with the generated Jira issue.

   1. If you don’t want to use Atlassian Intelligence, toggle off Use AI to generate summary and description. This will reload the issue and only use the highlighted text to populate the Jira issue summary field. Any additional issues created from the highlighted text will not use Atlassian Intelligence.

4. Complete your Jira fields and select Create.

課題が Jira で作成され、ご使用のページに追加されます。 

To create multiple issues from a table:

1. Highlight text in a table on your page. The floating toolbar appears.

2. Select the + Jira issue dropdown.

3. Select Multiple issues.

4. The Create multiple issues modal opens.

5. [作成] を選択します。

The issues will be created in Jira and added to the table on your page. 

To generate multiple issues from a page using Atlassian Intelligence:

1. ページの右下の AI ボタンを選択して [+ Jira 課題を作成] を選択します。Confluence により、右側のパネルに課題の一覧が生成されます。

2. 課題にカーソルを合わせ、鉛筆アイコンを選択して要約や説明の精度を確認し、必要な変更を行い、必要に応じて情報を追加します。

3. [作成] を選択して変更を保存して Jira に課題を作成するか、[キャンセル] して変更を破棄します。

4. 一覧から課題を取り除くには、課題にカーソルを合わせて X を選択します。

The issues will be created in Jira and added to your page. 

Create issues in the editor

To create a single issue:

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 を最大限に活用して、アジャイル開発チームの潜在能力を解き放つためにも、次のことをおすすめします。 

要件を定義する

Confluence は要件の定義を開始するのに最適です。製品要件テンプレートによって要件を定義後、Confluence の要件ページで Jira エピックやその他の課題を直接作成できます。

手順は次のとおりです。

1. 製品要件テンプレートによって Confluence ページを作成します。

2. プレースホルダー テキスト「Jira エピックまたは機能へのリンク」を選択し、[新しい課題を作成] を選択して Jira でエピックを作成します。

3. チームとコラボレーションしてストーリーを定義し、ページを保存します。

4. 要件ページでテキストをハイライトして [Jira 課題を作成] リンクを選択し、Jira でストーリーを作成すると、エピックに自動でリンクされます。

5. Confluence ページまたは Jira 内からストーリーの進捗を追跡します。

Confluence と Jira は緊密に統合されています。Confluence ページから課題に簡単にアクセスしてステータスをすばやくチェックできるほか、関連する Confluence ページへのリンクを Jira 内で確認できます。このように、必要なすべての情報が 1 か所にまとまっています。

スプリントの管理 

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

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

• Jira で、スプリントを計画する Confluence ページを作成します。このページはミーティング議事録テンプレートによって作成され、スプリントに自動でリンクされます。

• エピックで、要件や設計などの便利な Confluence ページへのリンクを作成します。

• Confluence にある Jira レポート ブループリントによって、関係者に進捗状況を報告します。

• スプリントの最後に、Confluence でふりかえりテンプレートによって、うまくいったことやうまくいかなかったことに関する実績を評価します。

主に Jira を使用するユーザーの場合は、この統合によって便利な Confluence ページにワンクリックでアクセスできます。

ロードマップを共有する

チーム管理対象の Jira 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 に従ってページに移動し、リンクされたスペース内を移動する。

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

• ページにいいね! やコメントを追加する。またはページを編集する (または、これを実行する権限を付与される)。

• ダッシュボード、 ユーザー プロファイル、ピープル ディレクトリ、またはスペース ディレクトリを参照する。

• Confluence インスタンス全体を検索します。

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

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

Jira 製品の機能

ここまでで説明してきたように、Confluence には多くの統合ポイントがあり、その一部は特定の Jira 製品でのみ利用可能です。Confluence Cloud に接続する Jira 製品のタイプに応じてアクセス可能な機能に関しては、以下をご確認ください。 

Atlassian Intelligence が生成する情報の品質、正確性、信頼性は変動する場合があります。その理由をさらに読む