| Div |
|---|
|
On this page| Table of Contents |
|---|
| maxLevel | 1 |
|---|
| exclude | On this page |
|---|
| type | flat |
|---|
| separator | pipe |
|---|
|
|
Overview
Augments are a set of macro parameters that provide the ability to augment the data found in the table with additional columns derived from other information available. More capabilities are planned for the future. This is supported by the CSV Macro and Table macro and the JSON Table Macro. The list of supported replacements follows later.Why would you use augments? In some cases, you may
Sometimes, users have little control over how the data is produced. For instance, importing csv files produced , for example, when importing CSV files generated by external processes. The data This affects the way data is displayed in Confluence as the format may not be in the best format for displaying in Confluence. In some cases, if the data could be changed in minor ways, then it would be shown better in Confluence. For instance, links could be added or data manipulated to more accurately reflect the contextoptimal. However, use of both augments and replacement keys can improve the look of such data in Confluence. The use of replacement keys that can be used with augments are explained in a subsequent section.
Parameters
| Table plus |
|---|
|
| Macro Editor Label | Defaulteditor label | | Macro Parameter |
|---|
| Augments to data row values | Comma Enter a comma-separated list of augments to the data row values, one for each column. Specify double quotes for values with a comma. | augments | | Augments to heading row values | Comma Enter a comma-separated list of augments to the dataheading row values, one for each column. | headingAugments | | Augments to footer row values | Comma Enter a comma-separated list of augments to the datafooting row values, one for each column. | footingAugments | | Columns to display | Comma Enter a comma-separated list of comma separated list of column names or numbers in any order. Defaults to By default, all columns are displayed in its existing order. Columns are enumerated starting at 1. Note that columns are indexed beginning at "1" and exclude any auto-numbered columns. For augment support, use * to represent a an augmented column to be added. | columns |
|
Replacement
...
keys
Replacement keys enclosed in % will can have replacements as indicated below. Example: %#% will be replaced by in the table. For example, a %#% key is replaced with the current row number.
| Table plus |
|---|
|
| Key | Replacement | Difference if heading or footing row? |
|---|
| * | original value |
| | empty | original value |
| | blank | blank |
| | # | row number (starting at 1 for the first data row) | blank | | number | value of the column identified by column number (1 based) |
| | name | value of the column identified by column name lookup if valid |
| | ! | | (may be needed when using wiki markup) |
| | [ | { (may be needed when using wiki markup) |
| | ] | } (may be needed when using wiki markup) |
|
|
Examples
| Child pages (Children Display) |
|---|
Additional
...
references
...