Configuring Issue Linking

PDF
PDF

Issue Linking allows you to create an association between issues. For instance, an issue may duplicate another, or its resolution may depend on another's.

There are two steps involved in configuring 'Issue Linking'. The first step is configuring JIRA to allow issue links. This is a global setting. The second step is to the create the issue link types required. These are also global.

Step 1: Turning on Issue Linking.

  1. Login as a user with global administrator access.
  2. Bring up the administration page by clicking either on the "Administration" link on the top bar or the title of the Administration box on the dashboard:

    Link to Administration sectionLink to Administration section

  3. On the panel on the left, under the title "Global Settings", click on the link labelled "Issue Linking".
  4. You will be shown a status page stating whether linking is enabled. If it is not, click the "Activate" button.
  5. You will be shown the status page again, this time stating that Issue Linking is enabled.

Step 2: Creating Issue Link Types.

  1. On the Issue Linking page there will now be a form titled "Add New Link Type".

    Form for adding a new link type
  2. To create a new link type, say Duplicate, proceed as follows:
    • enter "Duplicate" in the "Name" text field
    • enter "duplicates" in the "Outward Link Description" text field
    • enter "is duplicated by" in the "Inward Link Description" text field
  3. Click the add button.
  4. This returns to the link type management page, with a new section listing the "Duplicate" issue linking type. Here you can edit or delete the relationship, as required.

    List of declared link types

Step 3: Linking Issues.

  1. To link an issue to another issue, click on the link 'Link this Issue to Another Issue' on the 'View' Issue page.

    Link Issue
  2. This will bring up the 'Link Issue' form.

    Link Issue
  3. Select the link type and enter the key of the issue that you want to link to. It is also possible to link to multiple issues.

    You can optionally add a comment.

    Click on the "Link" button.

  4. You will see the issue page again, with a new section listing the issues that are linked to this issue

    List of linked issues