課題をリンクする と、 同じまたは別の Jira サーバー上にある２つの 課題の関連付けを作成することができます。例えば以下のようなものがあります。

  • 課題は別の課題と関係付けることができます。
  • 課題は別の課題に複製できます。
  • 課題は別の課題をブロックできます。

課題をリンクする ことで、以下のことも可能になります。

  • サービスデスクまたはビジネスプロジェクトの既存の課題から新しいリンクされた課題を作成します。
  • 課題と Confluence ページ間の関連付けを作成します。
  • 課題を他の Web ページにリンクします。

Your Jira administrator can customize the types of links that you can create, see configuring issue linking.

On this page:

課題内の課題リンクの外観：

スクリーンショット：課題内の「課題リンク」セクション


注意:  解決された 課題 (例えば  解決状況がセットされた課題）は取り消し線付きのフォントで表示されます。例:DEMO-1

課題にリンクを作成するには、課題が属するプロジェクトで課題をリンクする権限を持っている必要があります。

同じ Jira サイトの別の課題へのリンクを作成する

  1. 同じ Jira サイト内の別の課題へのリンクを作成する課題を開きます。
  2. Select More > Link to display the Link dialog box.
  3. 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.
    (info) 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.
  4. 課題 のフィールドで、現在、表示または選択されている課題に リンクする課題を指定します。次の２つの方法があります :
    • 課題キーを全て入力します（例 ABC-123— また複数の課題をリンクするために、それぞれの課題キーをタイプする度にエンターキーを押します。(info) 以前に参照したことがある課題の場合、課題キーの最初の数文字 (またはサマリの一部) を入力することで、課題を簡単に見つけることができます。課題は、表示される「オートコンプリート」ドロップダウン リストから選択できます。
      または、
    • 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.
  5. オプション：コメントを追加して、これらの課題をリンクする理由を説明します。
  6. ダイアログの下部にあるリンクボタンをクリックします。

別の Jira サイトの課題へのリンクを作成する

(warning) To create this type of link, your Jira system administrator should have configured fully reciprocal application links between your Jira site and the other Jira site containing the issue(s) you want to link to.

  1. 別の課題へのリンクを作成する課題を開きます。
  2.  その他 > リンク を選択して リンクダイアログボックスを開きます。
  3. Ensure that the Jira Issue item is selected at the left of the dialog box.
    (info) Note:
    • このオプションは、Jira システム管理者が Jira サイトとリモート Jira サイト間の アプリケーション リンク を設定していなかった場合は利用できません。
    • If, after selecting this option, you are prompted for authorization, you may be required to log in to the remote Jira site, which will allow your Jira site to access the remote Jira site on behalf of your account on the remote Jira site.
      (info) This behavior means the application links configured between your Jira site and the remote Jira site use OAuth authentication.
  4. ご使用の Jira サイトが複数のリモート Jira サイトに 接続されている場合、 サーバー  ドロップダウンリスト から関連する Jira サイトを選択します。
  5. 作成するリンクのタイプを課題のドロップダウンリストから選択します。
  6. Type the Issue key of the issue on the remote Jira site that you want to link to. Alternatively, you can search for issues on the remote Jira site by clicking the search for an issue link, which opens the Find Jira issues popup.
    (info) You can link to any issue on the remote Jira site to which you have access on that site.
  7. 相互リンクの作成 チェックボックスを選択し、 リンク先のリモート課題でリンク元の課題に戻る補完リンクを作成します。たとえば、リモート課題 に対して 例えば、ブロック リンク タイプ を作成すると、リモート課題で生成される相互リンクは、 ユーザーのローカル側の課題に戻る ブロックされる リンク タイプ になります。
  8. オプション：コメントを追加して、これらの課題をリンクする理由を説明します。
  9. ダイアログの下部にあるリンクボタンをクリックします。

トラブルシューティング

(error) 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.

(tick) Solution: Ask your Jira system administrator to configure fully reciprocal application links between your Jira site and the remote Jira site.

(error)問題:完全相互リンクを作成しようとして次のようなメッセージが表示された場合:

「この課題に戻る課題「XYZ-123」からの相互リンクは作成されませんでした。これは、リモート Jira サーバーにより次のエラーが返されたためです：課題「XYZ-123」に対する課題のリンク権限がありません。」 (ここで、「XYZ-123」は、リモート Jira サイトの課題キーです)。

この場合、 リモート Jira サイトで相互リンクは作成されません。その理由は、リモート Jira サイトで認証されたユーザー アカウント (上記の手順 3) に、 課題のリンクプロジェクト権限 がないからです。

(tick) ソリューション

  • リモート Jira サイトで、Jira プロジェクト管理者に連絡し、課題リンクを作成する必要がある関連プロジェクトについて、課題のリンクプロジェクト権限をユーザー アカウントに付与するよう依頼してください。
  • Alternatively, if the application link between your Jira site and the remote Jira site use OAuth authentication and you suspect you may have authenticated on the remote site with another user account that does not have the Link Issues project permission, repeat the procedure above but during the authorization step (at step 3), authenticate on the remote site with a user account which has this permission.
    (info) If you are not prompted for authentication during authorization, try clearing your browser's cookies first and repeat the procedure again.

サービスデスクまたはビジネスプロジェクトの既存の課題から新しいリンクされた課題を作成する

リンクされた課題を作成するには、対象プロジェクトで課題の作成と課題のリンクの権限が必要です。

リンクされた課題を作成するには:

  1.  リンクされた Jira 課題の作成元とする課題を開きます。
  2.  In the Issue screen, select More > Create linked issue to display the Create Linked Issue dialog box
    The newly created linked issue contains the same Project, Issue Type, and Summary information stored in the original issue. It is also linked to the service desk issue, in this case CTF-2. 
  3. 新しいリンクされた課題を作成する対象プロジェクトを選択します。 
  4. 新しいリンクされた課題に対して適切な課題タイプを選択します。 
  5. リンクされた課題フィールドで、新しいリンクされた課題にリンクする課題を指定します。
  6. リンクされた課題のサマリを編集します。
  7. 説明を編集し、それらの課題をリンクする理由を記述します。
  8. 元の課題からの URL を含めるには、添付ファイルをコピーチェックボックスをオンにします。
  9. 元の課題からの URL を含めるには、リンクをコピーチェックボックスをオンにします。
  10. ダイアログ下部の作成ボタンをクリックします。

リンクされた課題が作成されます。

Confluence ページへのリンクを作成する

この機能は、Confluence バージョン 4.0 以降でのみサポートされています。

(warning) To create this type of link, your Jira system administrator needs to have configured an application link between your Jira site and the Confluence site containing the pages you want to link to. 

  1. 別の課題へのリンクを作成する課題を開きます。
  2.  その他 > リンク を選択して リンクダイアログボックスを開きます。
  3. Click the Confluence Page option at the left of the dialog box.
    (info) This option is not available if your Jira system administrator has not configured an application link between your Jira site and Confluence site.
  4. 複数のアプリケーション リンクがご使用の Jira サイトと他の複数の Confluence サイト間で設定されている場合は、 サーバー ドロップダウンリストから選択します。
  5. 現在表示されている課題にリンクされる Confluence ページを指定します。次の２つの方法があります。

    • ページ URL フィールドで、リンク先の Confluence サイトのページの URL を入力します。例えば以下のようなものがあります。

      http://<confluence-server>/display/ds/Welcome+to+the+Confluence+Demonstration+Space
    • Click the search for a page link. The Link dialog box is replaced by the Find a Confluence page dialog box.
      (info) If you are prompted for authorization, you may be required to log in to the Confluence site, which will allow your Jira site to access the Confluence site on behalf of your account on the Confluence site.
      This behavior means the application links configured between your Jira site and the remote Confluence site use OAuth authentication.
      1. 最初の検索フィールドで、リンク先のページに表示される検索語を１つ以上指定します。このフィールドの入力は必須です。
      2. オプション：2 番目の検索フィールドで、Confluence スペースを選択して検索をさらに絞り込みます。
      3. 検索ボタン をクリックして、リンク先のページのタイトルをクリックします。
  6. オプション：コメントを追加して、これらの課題をリンクする理由を説明します。
  7. ダイアログの下部にあるリンクボタンをクリックします。

トラブルシューティング

(error) 問題：作成したConfluence ページのリンクに JIRA 課題の 読み込みに失敗しました と表示されるか、または Confluence ページを検索しようとしても、次のメッセージが表示される場合：

「Confluence サーバー の「リモート API」機能が無効になっているため、Confluence サイトのコンテンツにアクセスできませんでした。正常にこのコンテンツにアクセスするには、Confluence システム管理者は Jira の「リモート API」機能を有効にする必要があります。」

その後、Jira は 以下のいずれかを行うために Confluence サーバーと通信できませんでした。

  • リンクに関する情報の 取得または
  • Confluence ページの検索 ダイアログボックスでの Confluence ページ検索の 実行

(tick) ソリューション

Confluence システム管理者に、Confluence のリモート API (XML-RPC & SOAP)機能を有効にするよう依頼します。この Confluence 機能は既定で無効になっています。詳細は、Confluence ドキュメントのリモート API を有効にするを参照してください。

Web ページ URL へのリンクを作成する

  1. 別の課題へのリンクを作成する課題を開きます。
  2.  その他 > リンク を選択して リンクダイアログボックスを開きます。
  3. ダイアログボックスの左にある Web リンクオプションをクリックします。
  4. リンク先の Web ページの URL を指定します。
  5. 「課題の表示」ページの 課題リンク セクションに表示する、リンクテキストを指定します。URLでハイパーリンク化されます。
  6. オプション：コメントを追加して、これらの課題をリンクする理由を説明します。
  7. ダイアログの下部にあるリンクボタンをクリックします。
  1. リンクを含む課題に移動し、課題リンクセクションを見つけます。
  2. 削除するリンク上にマウスのポインターを置き、表示される削除 (ごみ箱) アイコンをクリックします。

リンクされた課題を検索する

特定の課題にリンクされた課題を検索できます。詳細については、詳細検索を参照してください。


(info) 注意：この機能は、リモート Jira サーバー上の課題には拡張されません。

  • ラベルなし