JIRA Issues Macro

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,

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.
Right click on 'XML' and copy its link location. See Screenshot 2.
Paste the url into the JIRA Issues macro in your page in Confluence.

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:

Atlassian JIRA (3 issues)

T

Key

Summary

CONF-495

Problem with incoming links

CONF-496

Problem with rename

CONF-497

Search includes old versions of pages

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.

JIRA Issues Macro

Optional Parameters

RELATED TOPICS

Labels