Table of Contents | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Overview
The metadata-matches
macro totals up the number of matching pages which have a particular value for metadata. This result can be shown directly or can be used as input to another statistics macro.
In addition, this macro allows for another metadata value to be calculated for each matching page. If another metadata value name is specified the macro will display a calculation based on the values of this metadata on the matching pages rather than the count of the number of occurrences.
Parameters
Parameter | Required | Default | Notes | Version |
---|---|---|---|---|
first parameter |
| The metadata value name whose values will be matched. This can include added metadata and internal metadata. The value of the metadata to be matched is added to the macro placeholder (macro body). If a | ||
| sum | If a
The metadata value that is compared includesany wiki markup characters used for the value. | ||
|
| Limits the content returned to be within the space with the given key. | ||
|
| Use If this is specified and the pages option is not, then the report will run over only the pages listed here. | ||
| lImits the content to that with the specified label or labels. A comma separated list produces ANY pages that match. | |||
| Specifies which Confluence content types should be considered for a report. This feature is based on the Confluence contentbylabel macro which has the same attribute. | |||
|
| Second metadata value that can be used to generate a calculation - the default is |
...
Another example of use of the metadata-matches
macro is to add multiple versions of the macro to populate a table, creating a dashboard of information from a group of pages
Multiple versions of the metadata-matches macro can also be added to the Confluence chart macro to visualise and present the collated data from each report.
Reference Markup
Code Block | ||
---|---|---|
| ||
{metadata-matches:Current Lifecycle status}|Active|{metadata-matches} |
...