...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
Table of Contents | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Overview
The {spaces-report
} macro allows you to generate a report detailing multiple space metadata attached to the matching spaces.
Any metadata created with the Comala Metadata App {space-metadata}and the {space-metadata-list} macros can be displayed in the report.
The macro will also retrieve also retrieve values for any Confluence internal space metadata, such as Space
Space
alongside metadata created with the Comala Metadata App.
Parameters
Parameter | Required | Default | Notes | Version |
---|---|---|---|---|
|
| The list of fields (columns) to be included in the report. This can include added metadata and internal metadata. |
sort
|
| Specifies which column in the report should be sorted by. You can also include a hint for the sort method before the sort direction. For instance "Name as istring asc" or "Name as istring" will apply a case-insensitive comparison, considering values as string. Other choices include
| ||||
| Specifies the maximum number of results in a report. Default is 500. |
Usage
Excerpt |
---|
To retrieve multiple metadata values from spaces in the instance, choose the |
...
Spaces Metadata Report |
...
macro from the Confluence macro browser: |
...
The macro editor allows you to configure the macro before you Insert the macro to the page. At least one metadata name is required. |
...
For |
...
each space with none of the specified metadata the report will display an empty |
...
row. If required, simply |
...
In the example, three spaces have space metadata attached - with the results sorted on one column and results restricted. |
...
No content can be added to the macro placeholder. The report displays the spaces metadata and their values in a tabular format. |
...
|
...
|
...
Reference Markup
Code Block |
---|
{spaces-report:Space,Owner,Purpose,Galaxy Base, Lead Commander, Last Time Changed|sort=Owner desc|maxResults=4} |
In our example this would display the following report:
...
The sort and maxResults have been chosen so only spaces with the added space metadata Owner
, Purpose
, Galaxy Base
and Lead Commander
are shown on the page with the internal metadata Space
and Last Time Changed
LastTimeChanged
.
Usage with the Comala Document Management app
The {The spaces-report
} macro macro is supported by by the Comala Document Management app and will work at workflow level.
...
Related Comala Metadata macros
Filter by label (Content by label) | ||||||
---|---|---|---|---|---|---|
|