課題のリンクについて

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

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

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

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

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

Within an issue, issue links look like this:

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

Note that resolved issues will be shown in strike-through font, e.g. DEMO-1.

On this page:

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

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

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

  1. View the issue from which you want to create a link. Alternatively, move to the this issue on the issue navigator.
  2. On the 'view issue' page, select Link from the More Actions menu or if available, click the Add Link (plus) icon at the right of the Issue Links section. Otherwise, using the issue navigator, click the Actions (cog) icon to the right of this issue. The Link dialog box will be displayed.
    (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つの方法があります。
  5. (Optional) Type a Comment — for example, to describe more information about why you are creating these links.
  6. Click the Link button.

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

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

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

  1. View the issue from which you want to create a link. Alternatively, move to the this issue on the issue navigator.
  2. On the 'view issue' page, select Link from the More Actions menu or if available, click the Add Link (plus) icon at the right of the Issue Links section. Otherwise, using the issue navigator, click the Actions (cog) icon to the right of this issue. The Link dialog box will be displayed.
    (tick) Keyboard Shortcut: '.' + start typing link
  3. Ensure that the JIRA Issue item is selected at the left of the dialog box.
    (info) Note:
  4. If your JIRA site is connected to multiple remote JIRA sites, choose the relevant JIRA site from the Server dropdown list.
  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. Refer to the procedure above for details on how to use this popup.
    (info) You can link to any issue on the remote JIRA site to which you have access on that site.
  7. Select the Create reciprocal link check box to create the complementary link on the remote issue you are linking to, back to your issue. For example, if you create a blocks link type to a remote issue, the reciprocal link generated on the remote issue will be a is blocked by link type back to your local issue.
  8. (Optional) Type a Comment, for example, to describe more information about why you are creating this link.
  9. Click the Link button.

トラブルシューティング

(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:

'A reciprocal link from issue 'XYZ-123' back to this issue was not created as the remote JIRA server returned the following error: No Link Issue Permission for issue 'XYZ-123'.' (where 'XYZ-123' is the issue key on the remote JIRA site),

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) ソリューション

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

(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. Only Confluence versions 4.0 or later support this JIRA feature.

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

  1. View the issue from which you want to create a link. Alternatively, move to the this issue on the issue navigator.
  2. On the 'view issue' page, select Link from the More Actions menu or click the Link (plus) icon at the right of the Issue Links section. Otherwise, using the issue navigator, click the Actions (cog) icon to the right of this issue. The Link dialog box will be displayed.
    (tick) Keyboard Shortcut: '.' + start typing link
  3. Click the Confluence Page option at the left of the dialog box.
    (info) This option will not be available if your JIRA system administrator has not configured an application link between your JIRA site and the Confluence site.
  4. If more than one application link has been configured between your JIRA site and other Confluence sites, then choose the appropriate Confluence site from the Server dropdown list.
  5. 現在表示されている課題にリンクされる Confluence ページを指定します。次の2つの方法があります。
  6. (Optional) Type a Comment, for example, to describe more information about why you are creating this link.
  7. Click the Link button.

トラブルシューティング

(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」機能を有効にする必要があります。

then JIRA was unable to communicate with the Confluence server to either:

(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. View the issue from which you want to create a link. Alternatively, move to the this issue on the issue navigator.
  2. On the 'view issue' page, select Link from the More Actions menu or click the Link (plus) icon at the right of the Issue Links section. Otherwise, using the issue navigator, click the Actions (cog) icon to the right of this issue. The Link dialog box will be displayed.
    (tick) Keyboard Shortcut: '.' + start typing link
  3. ダイアログボックスの左にある Web リンクオプションをクリックします。
  4. リンク先の Web ページの URL を指定します。
  5. Specify the Link Text that will appear in the Issue Links section of the 'view issue' page and will be hyperlinked to your URL.
  6. (Optional) Type a Comment, for example, to describe more information about why you are creating this link.
  7. Click the Link button.

リンクを削除する

リンクを削除するには:

  1. Go to an issue that contains links, and locate the Issue Links section (see screenshot above).
  2. Hover your mouse over the link you wish to delete, and click the Delete (trashcan) icon that appears.

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

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

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