Parameter name | Required | Default | Parameter description and accepted values |
|---|
anonymous
| No | false
| If this parameter is set to 'true', JIRA will return only the issues which allow unrestricted viewing i.e. the issues which are visible to anonymous viewers, as determined by JIRA's viewing restrictions. If this parameter is omitted or set to 'false', then the results depend on how your administrator has configured the communication between JIRA and Confluence. By default, Confluence will show only the JIRA issues which the user is authorised to view. See more details below. |
baseurl
| No | The value of the 'url' parameter | If you specify a 'baseurl', then the link in the header, pointing to your JIRA site, will use this base URL instead of the value of the 'url' parameter. This is useful when Confluence connects to JIRA with a different URL from the one used by other users. |
columns
| No | By default, the following columns are shown: - type
- key
- summary
- assignee
- reporter
- priority
- status
- resolution
- created
- updated
- due
| A list of JIRA column names, separated by semi-colons (;). Example columns are: key, summary, type, created, fixversion, updated, due, assignee, reporter, priority, status and resolution. You can include any columns recognised by your JIRA site, including custom columns. See the JIRA documentation for a list of names. |
count
| No | false
| If this parameter is set to 'true', the issue list will show the number of issues in JIRA. The count will be linked to your JIRA site. |
cache
| No | on
| The macro maintains a cache of the issues which result from the JIRA query. If the 'cache' parameter is set to 'off', the relevant part of the cache is cleared each time the macro is reloaded. (The value 'false' also works and has the same effect as 'off'.) |
height
| No | 480
| The height in pixels of the table displaying the JIRA issues. Note that this height specification is ignored in the following situations: - If you set the 'renderMode' parameter (see below) to 'static'.
- When the JIRA issues are displayed in a PDF or Word document, in an email message or in an RSS feed.
|
renderMode
| No | In formats not mentioned below, the default is 'dynamic'. The default is 'static' when the JIRA issues are displayed in a PDF or Word document, in an email message or in an RSS feed. | By default, the JIRA Issues macro offers a dynamic display with the following features: - Click the column headers to sort the output.
- Drag and drop the columns into a different order.
- Temporarily remove a column from the display.
- View a page of issues at a time, for faster response times.
Set the 'renderMode' parameter to 'static' if you want to disable the dynamic display features.
|
title
| No | JIRA Issues | You can customise the title text at the top of the JIRA issues table with this parameter. For instance, setting the title to 'Bugs-to-fix' will replace the default 'JIRA Issues' text. This can help provide more context to the list of issues displayed. |
url
| Yes | none | The URL of the XML view of your selected issues in JIRA Issue Navigator. Note: If the URL in the 'url' parameter does not contain a tempMax argument, then the value of tempMax will default to 500. If your JIRA server is version 3.12 or earlier, this means that the JIRA Issues macro will return a maximum of 500 issues. If your JIRA server is version 3.13 or later, a value of 500 means that the JIRA Issues macro will return a maximum of 500 issues per page. |
width
| No | 100% | The width of the table displaying the JIRA issues. Can be indicated either as a percentage (%) or in pixels (px). |