The states report is used to display lists of content and associated workflow state information. It's great for keeping track of content workflow states across multiple spaces.
This is one of several reports available from the Workflow Report Macro.
Anyone can see this report.
View-only users will only see results for content that has reached a Published (
final=true) state, even if there are subsequent draft-state edits to that content. Content that has not yet been published, or content under a workflow which does not define a published state, will not be shown.
Admins can make all results available to everyone by changing the Workflow Activity and Drafts Visibility setting.
Adding the report
To add the report to a page:
- In the editor, choose Insert
- Choose Edit the macro
- Set the report Type to states
- Choose Save to add to the draft page
- Choose Insert to add the report to the page
Here's how the report looks on your page:
Filtering the report
You can Filter the report to specific states by using the links at the top of the report.
Customising the report
You can customise the report with the following macro settings:
|Space Key(s)||Current space|
Which space(s) should be included in the report?
Should the report be filtered to specific state(s)?
|Max Entries||20||The number of results to show per page.†|
Should the report be filtered by content label(s)?
If using a list of labels, you can prefix the list with
|Parent Page Filter|
Should the report be filtered to a specific parent page and the child pages of the specific page?
Should the report be filtered to content that the specified user can currently review?
Which column of the report should results be sorted by?
|Sort Order||descending||Should the sort be in ascending or descending order?|
|† The macro has a 500-page limit for each report. If a larger report is required it may be useful to use the CQL REST API.|