Please check out our YouTube video or our Live Demo to get an idea about how Data Tables for Confluence works.
Table of Contents
Installation
As any app for Confluence Cloud, you can install the app via the Confluence admin menu.
Log into your Confluence instance as an admin.
Click on “Apps > Manage apps” in the header menu.
Click on “Find new apps” on the right navigation.
Search for “Data Tables for Confluence” and select it.
Click on “Try it free” to install the app.
Usage
Data Tables for Confluence provides macros to create powerful tables.
Data Tables: This macro uses regular Confluence tables as data source.
Data Tables CSV: This macro uses local CSV data (defined in the macro body) as data source.
Data Tables CSV (remote): This macro uses remote CSV data (defined via a remote URL) as data source.
Data Tables Attachments: This macro uses the attachments of a Confluence page as data source and renders a table with information such as the file name and file size.
To make use of one of the macros click the “Insert” / “+” Button in the edit mode, select one of the macros and follow the macro specific instructions below.
Macro “Data Tables”
The “Data Tables” macro uses regular Confluence tables as data source. After inserting the macro, add a regular Confluence table as macro body and change the macro settings appropriately.
The macro supports the following options:
Enable paging: Check to enable the paging functionality.
Enable searching: Check to enable the searching functionality.
Enable column selector: Check to enable the a button that allows to toggle visibility of individual columns.
Enable copy to clipboard: Check to enable a button that copies the table data to the clipboard.
Enable Excel export: Check to enable a button that exports the table data as .xlsx file.
Enable CSV export: Check to enable a button that exports the table data as .csv file.
Enable PDF export: Check to enable a button that exports the table data as .pdf file.
Enable printing: Check to enable a “print” button.
Order columns: Comma separated column numbers to order by initially (use “!” to order descending); “2!;1” for example uses column 2 (descending) as primary order column and column 1 (ascending) as second order column.
Footer row: Comma separated functions (“min”, “max”, “avg”, “sum”) to be used in the footer row.
Data locale: Define the locale that should be used to parse numbers.
Grouping columns: Comma separated column numbers to group; “2;3” for example groups by column 2 and then by column 3.
Detail column: Number of the column that contains the information that will be rendered as expandable/collapsible detail row.
Show information: Check to show dataset information such as number of records.
Disable state saving: Check to disable automatic state saving and restoring.
Macro “Data Tables CSV”
The “Data Tables CSV” macro uses (local) CSV data as data source. After inserting the macro, add the CSV data macro body and change the macro settings appropriately.
The macro supports the following options:
CSV header row: Check to use the first row as column header
CSV quote: Define the character that is used as CSV quote, leave empty if no quote us used.
CSV delimiter: Define the character that is used as CSV delimiter.
Enable paging: Check to enable the paging functionality.
Enable searching: Check to enable the searching functionality.
Enable column selector: Check to enable the a button that allows to toggle visibility of individual columns.
Enable copy to clipboard: Check to enable a button that copies the table data to the clipboard.
Enable Excel export: Check to enable a button that exports the table data as .xlsx file.
Enable CSV export: Check to enable a button that exports the table data as .csv file.
Enable PDF export: Check to enable a button that exports the table data as .pdf file.
Enable printing: Check to enable a “print” button.
Order columns: Comma separated column numbers to order by initially (use “!” to order descending); “2!;1” for example uses column 2 (descending) as primary order column and column 1 (ascending) as second order column.
Footer row: Comma separated functions (“min”, “max”, “avg”, “sum”) to be used in the footer row.
Data locale: Define the locale that should be used to parse numbers.
Grouping columns: Comma separated column numbers to group; “2;3” for example groups by column 2 and then by column 3.
Show information: Check to show dataset information such as number of records.
Disable state saving: Check to disable automatic state saving and restoring.
Macro “Data Tables CSV (remote)”
The “Data Tables CSV (remote)” macro uses CSV remote data as data source. After inserting the macro, the URL to load the CSV data and all other CSV and table options can be defined in the macro settings.
The macro supports the following options:
URL: URL to load the remote CSV data from
CSV header row: Check to use the first row as column header
CSV quote: Define the character that is used as CSV quote, leave empty if no quote us used.
CSV delimiter: Define the character that is used as CSV delimiter.
Enable paging: Check to enable the paging functionality.
Enable searching: Check to enable the searching functionality.
Enable column selector: Check to enable the a button that allows to toggle visibility of individual columns.
Enable copy to clipboard: Check to enable a button that copies the table data to the clipboard.
Enable Excel export: Check to enable a button that exports the table data as .xlsx file.
Enable CSV export: Check to enable a button that exports the table data as .csv file.
Enable PDF export: Check to enable a button that exports the table data as .pdf file.
Enable printing: Check to enable a “print” button.
Order columns: Comma separated column numbers to order by initially (use “!” to order descending); “2!;1” for example uses column 2 (descending) as primary order column and column 1 (ascending) as second order column.
Footer row: Comma separated functions (“min”, “max”, “avg”, “sum”) to be used in the footer row.
Data locale: Define the locale that should be used to parse numbers.
Grouping columns: Comma separated column numbers to group; “2;3” for example groups by column 2 and then by column 3.
Show information: Check to show dataset information such as number of records.
Disable state saving: Check to disable automatic state saving and restoring.
Macro “Data Tables Attachments”
The “Data Tables CSV Attachments” uses the list of attached files to that Confluence table as data source. After inserting the macro, the table options can be defined in the macro settings.
The macro supports the following options:
Enable paging: Check to enable the paging functionality.
Enable searching: Check to enable the searching functionality.
Enable column selector: Check to enable the a button that allows to toggle visibility of individual columns.
Enable copy to clipboard: Check to enable a button that copies the table data to the clipboard.
Enable Excel export: Check to enable a button that exports the table data as .xlsx file.
Enable CSV export: Check to enable a button that exports the table data as .csv file.
Enable PDF export: Check to enable a button that exports the table data as .pdf file.
Enable printing: Check to enable a “print” button.
Show columns: Select the columns to be included in the table.
Group column: (Optional) column to group the data.
Order columns: Comma separated column numbers to order by initially (use “!” to order descending); “2!;1” for example uses column 2 (descending) as primary order column and column 1 (ascending) as second order column.
Show information: Check to show dataset information such as number of records.
Disable state saving: Check to disable automatic state saving and restoring.