Page Comparison

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 value-name is NOT specified for a calculation in the value-name field, then the macro will return a count of the number of occurrences of this first parameter metadata valuespecified in the body of the macro placeholder.

function

sum

If a value-name is specified for a calculation, then the macro will use the specified function on the values taken from the matching pages and display the calculated value of this function.

• sum - returns the sum of each non-empty value (default)

• average - returns the average of each non-empty value

• maximum - returns the minimum of each non-empty value

• minimum - returns the maximum of each non-empty value

The metadata value that is compared includesany wiki markup characters used for the value.

key

current space

Limits the content returned to be within the space with the given key.

root

current page (@self)

Use @self for the current page (the default), @parent for the parent page, or the name of any page, e.g MySpace:MyPage.

If this is specified and the pages option is not, then the report will run over only the pages listed here.

label

lImits the content to that with the specified label or labels. A comma separated list produces ANY pages that match.

type

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.

value-name

sum

Second metadata value that can be used to generate a calculation - the default is sum. However it can also apply the same functions as used in the metadata-calculate macro.