You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 13 Next »

The Jira Issues macro allows you to display JIRA issues matching any JIRA filter within Confluence.

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

Usage:

{jiraissues:url=jira_rss_url|columns=columns}

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.

Optionally,

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.

JIRA column names include:

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

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.

Screenshot 1 : Issue Navigator views

Screenshot 2 : Copy to clipboard

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.

  • No labels