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.
Section | ||||
---|---|---|---|---|
|
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 |
Parameters set in the macro editor
Wiki markup input (Old editor)
Code Block | ||||
---|---|---|---|---|
| ||||
{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 file
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 exported CSV file is added to a CSV (Comma Separated Values) macro as an attachment on this page:
As text
Code Block | ||
---|---|---|
| ||
"","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" |
As-is
Csv | ||
---|---|---|
| ||
With a few parameters to make it look more like the original
Csv | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
The following parameters were used in the CSV (Comma Separated Values) macro:
Select this macro
Macro name | Advanced Tables - CSV Table |
Macro syntax (Old editor) | {csv} |
Macro syntax (New editor - case insensitive) | /CSV (Comma Separated Values) |
Define these parameters/values
Output format | wiki |
---|---|
Header rows | 1 |
Augments to data row values | , , !%3%! |
Augments to footing row values | , , Total |
Location of CSV data | ^Product Revenue.csv |
Column types | I,S,E,C |
Other examples
Visit our full list of product examples for additional inspiration!