Build an Advanced Table from Rest API Data 8.x
On this page
Overview
This page shows how to use the JSON Table macro, which is part of the Advanced Tables for Confluence app, to create a table that contains version information retrieved directly from JIRA. This example uses a number of the advanced capabilities of the JSON Table macro, including Augments to transform data into links and a particular emoticon, so the data is presented in a succinct, informative manner. The columns can be customized to meet your specific needs.
Macro Browser Input
Select this Macro
Macro Name | Advanced Tables - JSON Table |
Macro Syntax | {json-table} |
Define these Parameters/Values
JSON Table settings > Data source >Â Method of locating JSON data (URL)Â > URL of JSON data | https://bobswift.atlassian.net/rest/api/2/project/TBL/versions |
JSON Table settings > Data format > Paths to fields | $ |
JSON Table settings > Data format >Â Paths to fields to be included | name,description,releaseDate,released,archived,userReleaseDate,self |
JSON Table settings > Data format >Â Paths to be used to determine sort order | name |
JSON Table settings > Data format >Â Augments to data row values
| [%name%|https://appfire.atlassian.net/browse/TBL/fixforversion/%id%],,,!%released%.png!,!%archived%.png! |
JSON Table settings > Data format >Â Augments to heading row values | Name,Description,Release Date, Released, Archived |
JSON Table settings > Data settings >Â Output format | wiki |
JSON Table settings > Data settings >Â Column to display | name,description,releaseDate,released,archived |
Column settings > Numbering & Totaling > Insert auto number column | On |
Column settings > Sorting > Automatically sort in descending order | On |
Screenshots
Wiki Markup Input
{json-table: paths=$| fieldPaths=name,description,releaseDate,released,archived,userReleaseDate,self| sortPaths=name| url=https://bobswift.atlassian.net/rest/api/2/project/TBL/versions| output=wiki| columns=name,description,releaseDate,released,archived| augments=[%name%%!%https://appfire.atlassian.net/browse/TBL/fixforversion/%id%],,,!%released%.png!,!%archived%.png!,| headingAugments=Name,Description,Release Date, Released, Archived| sortDescending=true| autoNumber=true} {json-table}
Emoticons
For this example, we augmented the true and false values of the released and archived fields to show an emoticon instead. This is a general technique that can be used to make tables look better. For this case, it is simply having emoticon images named true and false and attached to this page (or some other page) and referenced in wiki markup notation by !true.png! and !false.png!. On your site, you will need to add those 2 images and reference them accordingly. They can be named differently, but must have true and false in the name somewhere so the released and archived values will determine which emoticon is shown. Wiki markup notation for images in the most general way is: !SPACE:my page^myimg.jpg!.
Example Result
Other Examples
Visit our full list of product examples for additional inspiration!