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!