On this page
Overview
This page demonstrates how to use the Table Plus macro, which is part of the Advanced Tables for Confluence add-on, to enhance the JIRA Issues macro. Simply insert a Table Plus macro onto your page, configure its parameters, and then insert a JIRA macro inside of the Table Plus macro.
If you are on a version of the JIRA issues macro that no longer has sorting (latest Confluence release and OnDemand - see CONF-30114), then this can be very helpful. The Table Plus macro can add sorting and other features to the JIRA Issues macro including styling the table differently. The key to doing this successfully can sometimes be dependent on the Confluence release (or more specifically, the release of the plugin containing JIRA issues macro). The following example is based on OnDemand.
Limitations
Currently, the JIRA issues macro limits the display to the first 20 issues. There does not appear to be an option to control this - see CONF-30116. Sorting is only done on the visible issues.
Macro Browser Input
Select this Macro
Macro Name | Table Plus |
Macro Syntax | {table-plus} |
Define these Parameters/Values
Heading rows | 2 |
Column types | S,S,X,M,M,M,S,S,E |
Please note that the Column types parameter is required for sorting. It should contain a comma separated list of values for handling each column. By clicking Display Options from within the JIRA Issues macro, you can review and optionally customize the columns to display, and thus determine how to set the Table Plus macro's Column types parameter.
Use | For |
---|---|
S | String columns |
X | Exclude column from sorting. Example: use for type column as that sorts by key which is confusing. |
H | Hide columns you don't want to see |
M | Date columns |
Screenshot
Wiki Markup Input
{table-plus:heading=2|columnTypes=S,S,X,M,M,M,S,S,E} {jiraissues:url=https://appfire.atlassian.net/browse/TBL-1066?jql=project%20%3D%20%22TBL%22%20AND%20fixVersion%20%3D%208.0.0%20%20ORDER%20BY%20priority%20DESC} {table-plus}
Example Result
Other Examples
Visit our full list of product examples for additional inspiration!