The Jira Issues Macro allows you to display JIRA issues matching any JIRA filter within a page in Confluence.

To do this, you need to include the url of the JIRA search filter in the macro.

JIRA Issues Macro

{jiraissues:url=*jira\_rss\_url*}

To retrieve a jira_rss_url,

  1. Perform a search in JIRA. At the top of the 'Issue Navigator' page, you will see various available views for that filter. See Screenshot 1.

  2. Right click on 'XML' and copy its link location. See Screenshot 2.

  3. Paste the url into the JIRA Issues macro in your page in Confluence.

(info) The command for copying a link to the clipboard may depend on your browser.

Screenshot 1 : Issue Navigator views

Screenshot 2 : Copy to clipboard

Optional Parameters

Customize the list of issues and the order of the columns being displayed by specifying a columns parameter

Use a semi-colon delimited list to specify which of the jira columns you want included and in what order you want them presented.

{jiraissues:url=*jira\_rss\_url*|columns=*columns*}

JIRA column names include:

  • Key
  • Summary
  • Type
  • Created
  • Updated
  • Assignee
  • Reporter
  • Priority
  • Status
  • Resolution

Here's an example:

{jiraissues:url=http://jira.atlassian.com/secure/IssueNavigator.jspa?view=rss&pid=10470&fixfor=10650&sorter/field=issuekey&sorter/order=DESC&tempMax=25&reset=true|columns=type;key;summary}

will result in:

type key summary

Unable to locate Jira server for this macro. It may be due to Application Link configuration.

Warning

Some issue feeds in JIRA can only be accessed if the user has the necessary rights in the JIRA project for which those issues belong. Hence when you paste that URL in Confluence, you will need to append your login information at the end of the URL, so that JIRA knows who is requesting the feed and is able to check permissions accordingly. That is,

{jiraissues:url=http://host.com/secure/IssueNavigator.jspa?&os_username=username&os_password=password\}

Failing to do this will result in a "Error rendering macro" error.

RELATED TOPICS

Working with Macros

Take me back to Help Home

  • No labels