workflow-reporter macro

Looking for the Comala Document Management report macro? See workflow-report macro and the Reporting Guide.

Overview

The workflow-reporter macro is used to generate a collection of Pages and News (blog posts) objects to use with the Appfire Reporting for Confluence app version 6.0 or above.

Using the Reporting add-on is an alternative to using the workflowreport macro. It allows you to create more advanced and customizable reports using the Reporting app reporting framework.

Where to use it?

Optional.

This is an optimised alternative to the content-reporter which provides access to workflow-related information.

The workflow-related information can be accessed through the report-info macro by using the Workflow Supplier.

For further documentation, refer to the Appfire (formerly ServiceRocket) Reporting app documentation

Parameters

Parameter	Required	Default	Notes

Parameter	Default	Notes
`space`	`@self`	Which spaces should be included in the report? `@self` – current space `@all` – all spaces or specify a comma-separated list of space keys for a collection of spaces
`label`		Should the report be filtered by content label(s)? leave empty to include all pages and blog posts specify one label name to filter to a specific label list multiple label names, separated by commas, to filter to content with any of those labels If using a list of labels, you can prefix the list with `&` (ampersand) to require that content has all the labels.
`filter`		A comma-separated list of CQL filters in the form `FieldName:Value` – the values must be indexed. Workflow CQL Fields Advanced Searching Using CQL (Atlassian) CQL Field Reference (Atlassian) CQL Function Reference (Atlassian) CQL Keywords Reference (Atlassian) CQL Operators Reference (Atlassian) Performing Text Searches with CQL (Atlassian)
`state`		Should the report be filtered to specific state(s)? leave empty to report on all states specify one state name to report on that state list multiple state names, separated by commas, to report on specific states
`max`	`100`	Maximum number of entries in the report
`sort`	`+modified`	The sort order: + for ascending, `A→Z` - for descending, `Z→A` And the sort field: `modified` – the most recent date on which the content was modified `created` – the date on which content was created `pagestate` – the current workflow state of the content `statechanged` – the date on which the state most recently changed `statechangedby` – user who most recently changed the state

Example

The Reporting app report below will generate a report similar to the states report of the workflowreport macro.

{report-table}
 {workflow-reporter:spaces=@self|state=Published}
 {workflow-reporter}

 {report-column:title=Page}{report-info:content:title|link=true}{report-column}
 {report-column:title=Last Updated By}{report-info:content:modifier>name|link=true}{report-column}
 {report-column:title=Updated}{report-info:content:modification date}{report-column}
 {report-column:title=State}{report-info:workflow:state>name}{report-column}
 {report-column:title=State changed on}{report-info:workflow:state>date}{report-column}
 {report-column:title=State changed by}{report-info:workflow:state>user>name|link=true}{report-column}
{report-table}

Comala Document Management for Data Center

workflow-reporter macro

Overview

Where to use it?

Parameters

Example

All examples

See also