This page last changed on Sep 05, 2007 by smaddox.

You need to edit in 'Wiki Markup' mode to include macros in your page.

The JIRA Portlet Macro displays a JIRA dashboard portlet in Confluence.

To do this, you will need to include the URL of the portlet in the macro.

JIRA Portlet Macro

{jiraportlet:url=urlOfJIRAPortlet}

Here's how you locate the URL of a JIRA portlet:

  1. Add the portlet you wish to include in Confluence to your JIRA dashboard. (Once you have copied the portlet's URL into Confluence, you can remove it from your JIRA dashboard.)

  2. Click 'On' beside 'Configure' on your dashboard. (If you don't see this link, you need to click the 'Manage Portal' link, click the 'Configure' button and then return to the dashboard.)

  3. Right-click the title located at the top-left corner of the portlet and copy its link location. See Screenshot 1.

  4. Paste it into the {jiraportlet} macro.

Screenshot 1: Copy link location

Optional Parameters

No  parameter Default Description
 1 baseurl none If Confluence retrieves the JIRA portlet from some other URL than JIRA's public URL, you should supply JIRA's public URL in the baseurl parameter. Confluence 2.1.2 or later

Here is an example:

Unreleased 2.5.x 91
   3%
Unreleased 2.6.1 9
Unreleased 2.6.x 33
   1%
Unreleased 2.7 31
   1%
Unscheduled 3042
   95%
Warning

If your JIRA instance requires you to log in, you must add &os_username=username&os_password=password to the end of the URL (substituting a valid JIRA username and password) so that Confluence can log in to retrieve the portlet. This is a temporary measure until we get Confluence and JIRA cross-authentication working more effectively.

RELATED TOPICS

JIRA Issues Macro
Working with Macros

Take me back to Confluence User Guide

Document generated by Confluence on Oct 10, 2007 18:50