課題をリンクする

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

Issue linking allows you to create an association between two existing issues on either the same or different JIRA servers. For example:

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

(Your JIRA administrator can customize the types of links that you can create.)

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

  • JIRA 課題と Confluence ページ間の関連付けを作成します。
  • JIRA 課題を他の Web ページにリンクします。

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

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

Note: Resolved issues (i.e. issues with a Resolution set) are displayed in strike-through font, e.g. DEMO-1.

To create links on JIRA issues, you need to have the Link Issues permission in the project(s) to which the issues belong.

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

同じ JIRA サイトの別の課題へのリンクを作成するには:

  1. 同じ JIRA サイト内の別の課題へのリンクを作成する課題を開きます。
  2. Select More > Link to display the Link dialog box.
    (tick) Keyboard Shortcut: '.' + start typing link
  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 dropdown list.
    (info) If your JIRA system administrator has configured fully reciprocal application links between your JIRA site and another one, a Server dropdown 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. 課題フィールドで、現在、表示または選択されている課題にリンクする課題を指定します。次の2つの方法があります。
    • Type the full issue key (e.g. ABC-123) — or to link to multiple issues, press the 'Enter' key between each typed issue key.
      (info) If you have previously browsed an issue, you can quickly find the issue by typing the first few letters of the issue key (or part of the Summary), which will appear in an 'autocomplete' drop-down list for selection:
      OR:
    • 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.

(info) This feature is not available in Atlassian Cloud.

別の JIRA サイトにある課題へのリンクを作成するには:

  1. 別の課題へのリンクを作成する課題を開きます。
  2. Select More > Link to display the Link dialog box.
    (tick)
    Keyboard Shortcut: '.' + start typing link
  3. Ensure that the JIRA Issue item is selected at the left of the dialog box.
    (info) Note:
    • This option will not be available if your JIRA system administrator has not configured an application link between your JIRA site and the remote JIRA site.
    • If, after selecting this option, you are prompted for authorisation, 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 check box but after clicking the Link button, discover that a reciprocal link from the remote JIRA issue back to your JIRA 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) Problem: If you attempted to create a reciprocal link but received the following message:

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

then a reciprocal link on the remote JIRA site will not have been created, because the user account through which you authenticated on the remote JIRA site (at step 3 above) does not have the Link Issues project permission.

(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 authorisation 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 authorisation, try clearing your browser's cookies first and repeat the procedure again.

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. 

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

  1. 別の課題へのリンクを作成する課題を開きます。
  2. Select More > Link to display the Link dialog box.
    (tick) Keyboard Shortcut: '.' + start typing link
  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 the Confluence site.
  4. 複数のアプリケーション リンクがご使用の JIRA サイトと他の複数の Confluence サイト間で設定されている場合は、サーバードロップダウン リストから、適切な Confluence サイトを選択します。
  5. 現在表示されている課題にリンクされる Confluence ページを指定します。次の2つの方法があります。
    • ページ 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 authorisation, 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. 最初の検索フィールドで、リンク先のページに表示される検索語を1つ以上指定します。このフィールドの入力は必須です。
      2. オプション:2 番目の検索フィールドで、Confluence スペースを選択して検索をさらに絞り込みます。
      3. 検索ボタンをクリックしてから、リンク先のページのタイトルをクリックします。
  6. オプション:コメントを追加して、これらの課題をリンクする理由を説明します。
  7. ダイアログの下部にあるリンクボタンをクリックします。

トラブルシューティング

(error) Problem: If Confluence page links you create show Failed to load on the JIRA issue or if you attempted to search for a Confluence page but received the following message:

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

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

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

(tick) ソリューション

Ask the Confluence system administrator to enable the Remote API (XML-RPC & SOAP) feature, since this Confluence feature is disabled by default. See Enabling the Remote API in the Confluence documentation for details.

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

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

  1. 別の課題へのリンクを作成する課題を開きます。
  2. Select More > Link to display the Link dialog box.
    (tick) Keyboard Shortcut: '.' + start typing link
  3. ダイアログボックスの左にある Web リンクオプションをクリックします。
  4. リンク先の Web ページの URL を指定します。
  5. 「課題の表示」ページの課題リンクセクションに表示され、ご使用の URL へのハイパーリンクが付けられるリンク テキストを指定します。
  6. オプション:コメントを追加して、これらの課題をリンクする理由を説明します。
  7. ダイアログの下部にあるリンクボタンをクリックします。

リンクを削除するには:

  1. Go to an issue that contains links, and locate the Issue Links section (see screenshot above).
  2. 削除するリンク上にマウスのポインターを置き、表示される削除 (ごみ箱) アイコンをクリックします。

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

You can search for issues that are linked to a particular issue. For details, please see the documentation on Advanced Searching.

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

最終更新日 2015 年 8 月 27 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.