課題をリンクする
課題内の課題リンクの外観:
スクリーンショット:課題内の「課題リンク」セクション
注意: 解決された 課題 (例えば 解決状況がセットされた課題)は取り消し線付きのフォントで表示されます。例:DEMO-1
課題にリンクを作成するには、課題が属するプロジェクトで課題をリンクする権限を持っている必要があります。
同じ JIRA サイトの別の課題へのリンクを作成する
- 同じ JIRA サイト内の別の課題へのリンクを作成する課題を開きます。
- [その他] > [リンク] を選択すると、[リンク] ダイアログ ボックスが表示されます。
- Ensure that the JIRA Issue item is selected at the left of the dialog box and then choose the type of link to be created from the This issue drop-down list.
If your JIRA system administrator has configured fully reciprocal application links between your JIRA site and another one, a Server drop-down list may appear above the This issue list. If this is the case, ensure your JIRA site appears or has been selected from the Server list. - 課題 のフィールドで、現在、表示または選択されている課題に リンクする課題を指定します。次の2つの方法があります :
- 課題キーを全て入力します(例 ABC-123— また複数の課題をリンクするために、それぞれの課題キーをタイプする度にエンターキーを押します。 以前に参照したことがある課題の場合、課題キーの最初の数文字 (またはサマリの一部) を入力することで、課題を簡単に見つけることができます。課題は、表示される「オートコンプリート」ドロップダウン リストから選択できます。
または: - Click the search for an issue link to use the Find JIRA issues popup, which allows you to perform either a simple text search or an advanced search for issues.
- 課題キーを全て入力します(例 ABC-123— また複数の課題をリンクするために、それぞれの課題キーをタイプする度にエンターキーを押します。 以前に参照したことがある課題の場合、課題キーの最初の数文字 (またはサマリの一部) を入力することで、課題を簡単に見つけることができます。課題は、表示される「オートコンプリート」ドロップダウン リストから選択できます。
- オプション:コメントを追加して、これらの課題をリンクする理由を説明します。
- ダイアログの下部にあるリンクボタンをクリックします。
別の JIRA サイトの課題へのリンクを作成する
このリンク タイプを作成するには、JIRA システム管理者が ご使用の JIRA サイトと、リンク先の課題を含む相手の JIRA サイトの間に 完全相互 アプリケーション リンク完全相互 アプリケーション リンク を設定している必要があります。
- 別の課題へのリンクを作成する課題を開きます。
- その他 > リンク を選択して リンクダイアログボックスを開きます。
- JIRA 課題項目が選択され左側のダイアログにあることを確認します。
注意:- このオプションは、JIRA システム管理者が JIRA サイトとリモート JIRA サイト間の アプリケーション リンク を設定していなかった場合は利用できません。
- このオプションの選択後に承認を求めるプロンプトが出る場合、リモート Jira サイトにログインする必要がある可能性があります。これにより、ご使用の Jira サイトは、リモート Jira サイトのユーザーのアカウントの代わりにリモート Jira サイトにアクセスできます。
この動作は、ご使用の Jira サイトとリモート Jira サイト間に設定されているアプリケーション リンクが OAuth 認証を使用することを意味しています。
- ご使用の JIRA サイトが複数のリモート JIRA サイトに 接続されている場合、 サーバー ドロップダウンリスト から関連する JIRA サイトを選択します。
- 作成するリンクのタイプを課題のドロップダウンリストから選択します。
- リンク先のリモート JIRA サイトにある対象の課題の 課題 キーを入力します。または、 課題の検索 リンクをクリックして、 JIRA 課題を検索します。
JIRA 課題を検索 のポップアップ画面を開き、 リモート JIRA サイトの課題を検索することもできます。
リモート JIRA サイトにおいてアクセス権限のある課題であれば、その課題へのリンクを作成できます。 - 相互リンクの作成 チェックボックスを選択し、 リンク先のリモート課題でリンク元の課題に戻る補完リンクを作成します。たとえば、リモート課題 に対して 例えば、ブロック リンク タイプ を作成すると、リモート課題で生成される相互リンクは、 ユーザーのローカル側の課題に戻る ブロックされる リンク タイプ になります。
- オプション:コメントを追加して、これらの課題をリンクする理由を説明します。
- ダイアログの下部にあるリンクボタンをクリックします。
トラブルシューティング
Problem: If you selected the Create reciprocal link checkbox, but after clicking the Link button, you discover that a reciprocal link from the remote issue back to your issue has not been created, then your JIRA system administrator has most likely created only a one-way link from your JIRA site to the remote JIRA site.
解決策: JIRA システム管理者に連絡し、 ご使用の JIRA サイトとリモート JIRA サイト間の完全相互アプリケーションリンクを設定してもらって下さい。
問題:完全相互リンクを作成しようとして次のようなメッセージが表示された場合:
「この課題に戻る課題「XYZ-123」からの相互リンクは作成されませんでした。これは、リモート JIRA サーバーにより次のエラーが返されたためです:課題「XYZ-123」に対する課題のリンク権限がありません。」 (ここで、「XYZ-123」は、リモート JIRA サイトの課題キーです)。
この場合、 リモート JIRA サイトで相互リンクは作成されません。その理由は、リモート JIRA サイトで認証されたユーザー アカウント (上記の手順 3) に、 課題のリンクプロジェクト権限 がないからです。
ソリューション
- リモート JIRA サイトで、JIRA プロジェクト管理者に連絡し、課題リンクを作成する必要がある関連プロジェクトについて、課題のリンクプロジェクト権限をユーザー アカウントに付与するよう依頼してください。
- または、ご使用の Jira サイトとリモート Jira サイト間のアプリケーション リンクが OAuth 認証を使用しており、かつリモートサイトにおいて、課題のリンクプロジェクト権限のない別のユーザー アカウントで認証された可能性が疑われる場合、上記の手順を繰り返し、認証手順 (手順 3) で、この権限を持つユーザー アカウントを使用してリモートサイトでの認証を行います。
認証中に認証のプロンプトが出されない場合、まず、ブラウザーのクッキーをクリアしてから、もう一度手順を繰り返します。
サービスデスクまたはビジネスプロジェクトの既存の課題から新しいリンクされた課題を作成する
リンクされた課題を作成するには、対象プロジェクトで課題の作成と課題のリンクの権限が必要です。
リンクされた課題を作成するには:
- リンクされた JIRA 課題の作成元とする課題を開きます。
- 課題画面で、[その他] > [リンクされた課題の作成] を選択して リンクされた課題の作成 ダイアログ ボックスを表示します。
新しく作成されたリンク済み課題には、元の課題のプロジェクト、課題タイプ、要約と同じ情報が含まれます。また、サービス デスク課題 (この例では CCF-3 ) にもリンクされます。 - 新しいリンクされた課題を作成する対象プロジェクトを選択します。
- 新しいリンクされた課題に対して適切な課題タイプを選択します。
- リンクされた課題フィールドで、新しいリンクされた課題にリンクする課題を指定します。
- リンクされた課題のサマリを編集します。
- 説明を編集し、それらの課題をリンクする理由を記述します。
- 元の課題からの URL を含めるには、添付ファイルをコピーチェックボックスをオンにします。
- 元の課題からの URL を含めるには、リンクをコピーチェックボックスをオンにします。
- ダイアログ下部の作成ボタンをクリックします。
リンクされた課題が作成されます。
Confluence ページへのリンクを作成する
この機能は、Confluence バージョン 4.0 以降でのみサポートされています。
このタイプのリンクを作成するには、JIRA システム管理者が アプリケーションリンク をJIRA サイトとリンク先のページを含む Confluence サイト間に設定している必要があります。
- 別の課題へのリンクを作成する課題を開きます。
- その他 > リンク を選択して リンクダイアログボックスを開きます。
- ダイアログボックスの左にあるConfluence ページオプションをクリックします。
このオプションは、JIRA システム管理者がご使用の JIRA サイトと Confluence サイト間の アプリケーション リンク を設定していない場合には利用できません。 - 複数のアプリケーション リンクがご使用の JIRA サイトと他の複数の Confluence サイト間で設定されている場合は、 サーバー ドロップダウンリストから選択します。
- 現在表示されている課題にリンクされる Confluence ページを指定します。次の2つの方法があります。
ページ URL フィールドで、リンク先の Confluence サイトのページの URL を入力します。例えば以下のようなものがあります。
http://<confluence-server>/display/ds/Welcome+to+the+Confluence+Demonstration+Space
- ページを探すリンクをクリックします。リンクダイアログボックスがConfluence ページの検索ダイアログボックスに置き換えられます。
このオプションの選択後に 認証 を求めるプロンプトが出る場合、Confluence サイトにログインする必要がある可能性があります。これにより、ご使用の Jira サイトは、Confluence サイトののアカウントを利用して Confluence のサイトにアクセスできるようになります。
この動作は、ご使用の Jira サイトとリモート Confluence サイト間に設定されているアプリケーション リンクが OAuth 認証を使用することを意味しています。- 最初の検索フィールドで、リンク先のページに表示される検索語を1つ以上指定します。このフィールドの入力は必須です。
- オプション:2 番目の検索フィールドで、Confluence スペースを選択して検索をさらに絞り込みます。
- 検索ボタン をクリックして、リンク先のページのタイトルをクリックします。
- オプション:コメントを追加して、これらの課題をリンクする理由を説明します。
- ダイアログの下部にあるリンクボタンをクリックします。
トラブルシューティング
問題:作成したConfluence ページのリンクに JIRA 課題の 読み込みに失敗しました と表示されるか、または Confluence ページを検索しようとしても、次のメッセージが表示される場合:
「Confluence サーバー の「リモート API」機能が無効になっているため、Confluence サイトのコンテンツにアクセスできませんでした。正常にこのコンテンツにアクセスするには、Confluence システム管理者は JIRA の「リモート API」機能を有効にする必要があります。」
その後、JIRA は 以下のいずれかを行うために Confluence サーバーと通信できませんでした。
- リンクに関する情報の 取得または
- Confluence ページの検索 ダイアログボックスでの Confluence ページ検索の 実行
ソリューション
Confluence システム管理者に、Confluence のリモート API (XML-RPC & SOAP)機能を有効にするよう依頼します。この Confluence 機能は既定で無効になっています。詳細は、Confluence ドキュメントのリモート API を有効にするを参照してください。
Web ページ URL へのリンクを作成する
- 別の課題へのリンクを作成する課題を開きます。
- その他 > リンク を選択して リンクダイアログボックスを開きます。
- ダイアログボックスの左にある Web リンクオプションをクリックします。
- リンク先の Web ページの URL を指定します。
- 「課題の表示」ページの 課題リンク セクションに表示する、リンクテキストを指定します。URLでハイパーリンク化されます。
- オプション:コメントを追加して、これらの課題をリンクする理由を説明します。
- ダイアログの下部にあるリンクボタンをクリックします。
リンクを削除する
- リンクを含む課題に移動し、課題リンクセクションを見つけます。
- 削除するリンク上にマウスのポインターを置き、表示される削除 (ごみ箱) アイコンをクリックします。
リンクされた課題を検索する
特定の課題にリンクされた課題を検索できます。詳細については、詳細検索を参照してください。
注意:この機能は、リモート JIRA サーバー上の課題には拡張されません。