This page last changed on Aug 25, 2011 by pwatson.

If your Confluence site is connected to a JIRA site using an application link, you can easily insert individual issues from this JIRA site directly into text on your Confluence page using the 'Insert JIRA Issue' dialog. Each issue inserted onto the page is linked to the issue in JIRA itself.

Using the 'Insert JIRA Issue' dialog, you can also:

  • Create a new issue on the JIRA site and insert the issue onto your page.
  • Insert a table of JIRA issues onto your page based on the results of a search (using JIRA Query Language (JQL) syntax).

Info If your Confluence site is not connected to any JIRA site via an application link, this feature will not be available. However, you can still list JIRA issues on a page or blog post using the JIRA issues macro.

Quick guide to inserting JIRA issues
  • Choose Insert > JIRA Issue from the editor toolbar.
    • To insert a single issue, use either:
      • Recently Viewed — Insert an issue onto your page from a list of issues you have recently viewed on the JIRA server.
      • Create New Issue — Create a new issue on the JIRA server and insert it into your page.
      • Search — Use JQL syntax to narrow down a list of issues, from which you can select one to insert onto a page.
    • To insert a table of issues:
      • Click Search on the 'Insert JIRA Issues' dialog, use JQL syntax to narrow down a list of issues and choose to insert the list onto a page.

Info If Confluence is connected to more than one JIRA server, ensure that you choose the appropriate JIRA server before using this dialog to select, create or search for issues.

Inserting a JIRA Issue from a List of Recently Viewed Issues

To insert a JIRA issue onto a page from a list of recently viewed issues on a JIRA site:

  1. Go to the Recently Viewed tab of the 'Insert JIRA Issue' dialog.
  2. If necessary, select a JIRA server from the Server list. See the notes below regarding OAuth outgoing authentication.
  3. Select an issue from your list of recently viewed JIRA issues on the JIRA site. The number of items in the list is defined in JIRA.

Creating a New JIRA Issue and Inserting it

Info This feature works best with JIRA issue types whose mandatory field requirements have not been altered. With the exception of a JIRA issue's 'Component/s' or 'Fix Version/s' fields, you cannot use this dialog to add an issue whose issue type has customised mandatory field requirements upon issue creation.

To create a new JIRA issue on a JIRA site and insert this issue onto a page:

  1. Go to the Create New Issue tab of the 'Insert JIRA Issue' dialog.
  2. Complete the dialog:

    Setting

    Description

    Server

    The available JIRA servers. See the notes below regarding OAuth outgoing authentication.

    Project

    The project on the selected JIRA server to which the new issue will be added.

    Issue Type

    The type of issue to log in this project.

    Summary

    A one-line summary for the issue.

    Component/s

    Choose one or more components which apply to this issue.

    Version/s

    Choose one or more versions in which the issue will be addressed.

    Description

    A more detailed description about the issue.

    Info Some of these fields may not be visible if they have been customised in your JIRA project.
  3. Click Insert to create the JIRA issue and insert it onto the page.

Searching for JIRA Issues and Inserting them

To search a JIRA site for a subset of issues matching a JQL query and insert one or more of these issues:

  1. Go to the Search tab of the 'Insert JIRA Issue' dialog.
  2. Enter a JQL query.
  3. If necessary, select the JIRA server whose issues you want to insert.
  4. Click Search to find the issues on the JIRA server which match your JQL query. The first 20 issues retrieved by your JQL query are displayed.
    • To insert a single issue, select the issue from your list and click Insert.
    • To insert the full list of issues, select the Insert all query results as a table check box before clicking Insert.

Notes

The issues from a JIRA site which you can access in the 'Insert JIRA Issues' dialog depends on the application link's outgoing authentication used by Confluence to communicate with that JIRA site. While you can always access publicly visible issues:

  • If 'Trusted Applications' outgoing authentication is used — you can also view issues restricted to an account on JIRA whose user name matches your user name in Confluence.
  • If 'OAuth' outgoing authentication is used, you may need to click Login & Approve at this point to gain access to the JIRA server and restricted issues. You can also view issues restricted to the user account that you 'Login & Approve' (to the JIRA site) on the 'Insert JIRA Issues' dialog.
  • If 'Basic Access' outgoing authentication is used — you can also view issues restricted to the user account configured for the JIRA site's 'outgoing authentication'.

Related Topics

JIRA Issues Macro


Document generated by Confluence on Sep 19, 2011 02:30