This page last changed on Jun 18, 2007 by rosie@atlassian.com.

This page is outdated. Please see new page.

Jira Portlet Macro

Usage: jiraportlet:url=
Description:

Display a JIRA dashboard portlet in Confluence

Input: url=
http://jira.atlassian.com/secure/RunPortlet.jspa?
portletKey=com.atlassian.jira.plugin.system.portlets:projectstats&
description=Stats:%20Confluence%20(Versions)&projectid=10470&
statistictype=fixfor&template=/portlets/dashboard/projectstats.jsp
Output: Nice looking portlet in a Confluence page
Bundled with Confluence?: yes

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%

How to find the URL for a JIRA Portlet

Confluence needs a URL in order to retrieve JIRA portlets.

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.
  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 will be able to remove from your JIRA dashboard)

  2. Configure your dashboard



  3. Locate the portlet's direct link in the top-left corner



  4. Right-click on the link to copy it to your clipboard, and paste it into the {jiraportlet} macro

    (Note, the command for copying a link to the clipboard may differ in your browser)

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