Confluence 4.1 : Detailssummary Macro

 

The Detailssummary macro presents a tabulated summary of metadata that has been embedded on any page or blog post in the current Confluence space using the Metadata Macro. The Detailssummary macro collects metadata from only those pages or blog posts that have had a particular page label added to them.

The left-most column of the summary shows the name of each page or blog post with the specified label that contains metadata. Each page or blog post is presented on a single row and is hyperlinked to its appropriate destination page.

Each subsequent column represents a unique field within the selected metadata. The value associated with each metadata field on a page or blog post is presented in the appropriate cell of the summary table. For example, the following Detailssummary macro shows the pages in the current space that have metadata embedded using the Metadata macro, and also the 'test' label.

  Author-Firstname Author-Nickname Is-Secret
Detailssummary Macro <p>Fred</p> <p>Strawberry Sundae</p>  
Metadata Macro   <p>Banana Split</p> <p>Yes</p>

Using the Detailssummary Macro

To add the Detailssummary macro to a page:

  1. In the Confluence editor, choose Insert > Other Macros.
  2. Find and select the required macro.

Parameters

When editing, you can click on the macro placeholder and choose Edit to display the parameters for this macro in the Macro Browser.

Parameters are options that you can set for Confluence macros to control the content or format of the macro output. The table below lists parameters for this macro that can be set in the Macro Browser.

Parameter

Default

Description

Metadata Label

none

Restricts the summary to the contents of Metadata macros on the pages in the current space that have this page label.

Another Metadata Macro Example

The following Metadata macro example generates the second line in the Detailssummary macro (above). Note that this current page requires the 'test' label for this to work.

Author-Nickname

Strawberry Sundae

Author-Firstname

Fred

Related Topics

Working with Macros

Working with Labels

Take me back to the Confluence User's Guide.