Overview
This page demonstrates how to use the Table Plus macro, which is part of the Advanced Tables for Confluence app, to download or export (as an attachment) a CSV representation of the table view. By specifying the Allow download and export parameter on the macro, users are given two icons (
) that can be clicked to download or export the current table view to a CSV file. Download places the file on the user local system and export creates an attachment.
Though, a comma (,) is used as a delimiter for the table contents by default, you can specify a different character in Export file delimiter. Enter any single character to act as a delimiter in the text box. For this example, let's use the default delimiter to download the current table view.
Screenshot
Message
Macro browser input
Select this macro
| Macro name | Advanced Tables - Table Plus |
| Macro syntax (Old editor) | {table-plus} |
| Macro syntax (New editor - case insensitive) | /Table Plus |
Define these parameters/values
Auto number on each row | On |
Auto total row | On |
| Allow download and export | On |
| Export file delimiter | , |
Sort descending | On |
Auto sort this column | 3 |
| Column types | S,E,I |
| Table id | Product Revenue |
Screenshot
Wiki markup input
{table-plus:allowExport=true|id=Product Revenue|autoNumber=true|autoTotal=true|sortDescending=true|sortColumn=3|columnTypes=S,E,FF"$0,0"}
|| Product || On Plan || Revenue ||
| A | (/) | 325100 |
| D | (/) | 315850 |
| C | (x) | 250420 |
| B | (/) | 98650 |
| E | (x) | 79010 |
{table-plus}
Exported CSV
The exported attachment, Product Revenue.csv, can be imported back to a Confluence page using the CSV (Comma Separated Values) macro. This could be used for showing snapshots of tables that have been archived for a historical view. The following is like CSV Table macro with the attachment on this page:
As Text
"","Product","On Plan","Revenue" "1","A","https://examplegear.com/s/en_GB/6214/6860359b26f1e8cc7164bebdad0e2f04c128c291.1/_/images/icons/emoticons/check.png","$325,100" "2","D","https://examplegear.com/s/en_GB/6214/6860359b26f1e8cc7164bebdad0e2f04c128c291.1/_/images/icons/emoticons/check.png","$315,850" "3","C","https://examplegear.com/s/en_GB/6214/6860359b26f1e8cc7164bebdad0e2f04c128c291.1/_/images/icons/emoticons/error.png","$250,420" "4","B","https://examplegear.com/s/en_GB/6214/6860359b26f1e8cc7164bebdad0e2f04c128c291.1/_/images/icons/emoticons/check.png","$98,650" "5","E","https://examplegear.com/s/en_GB/6214/6860359b26f1e8cc7164bebdad0e2f04c128c291.1/_/images/icons/emoticons/error.png","$79,010" "","","","$1,069,030"
With CSV Table macro as is
With CSV Table macro with a few parameters to make it look more like the original
Select this macro
| Macro Name | Advanced Tables - CSV Table |
| Macro Syntax | {csv} |
Define these parameters/values as follows:
| CSV Table settings > Data settings > Output format | wiki |
|---|---|
| Row settings > Header & footer rows > Number of header rows | 1 |
CSV Table settings > Data format > Augments to data row values | , , !%3%! |
CSV Table settings > Data format > Augments to footing row values | , , Total |
CSV Table settings > Data source > Method of locating JSON data (Attachment) > Attachment | Product Revenue.csv |
Column settings > Formatting > Column type (1 2 3 4) | I S E C |
Other examples
Visit our full list of product examples for additional inspiration!
