Content by Label macro
- Robert Alexander Marshall
Overview
The "Content by Label" macro, bundled with Confluence, allows you to build simple reports using Confluence search filters – including those added by the Comala Document Management app!
This feature requires Confluence 5.8 or above.
Setting up the report
Add the Content by Label macro to a wiki page in the usual way.
In the sidebar you'll see an option to specify a label, and, under it, an option to "Add filter":
Search the Add filter drop-down for filters containing the word Workflow – these are the filters added by the Comala Document Management app.
In the example above, we've selected the Workflow State filter. That filter automatically provides a list of all states available on your wiki, so all you need to do is choose one.
In the screenshot, we've chosen to list all pages with the Label macro and the Workflow State New Draft.
Chose Preview to see the results.
Essentially it allows you to define search criteria, just as you would on the main Confluence Search page, and have the results displayed directly in your content. This is perfect for creating documentation dashboards and "to do" lists.
Available Filters
The current workflow state can also be retrieved as a metadata value using @awpState@. For example, using the get-metadata macro.
An example of some of the filters in action:
See also
External Links: