Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
maxLevel2
minLevel2
absoluteUrltrue
excludeRelated Links
typeflat
separatorpipe

Overview

The document -state-states report macro can be added to a page and configured to report on the workflows added to the content.

...

You can use Confluence CQL to further filter the report to show workflows on the grandchildren of a page.

Note

Prior prior to v6.16.5 CQL filter must be in the form FieldName:Value. The standard CQL format of fieldname=value is accepted for v6.16.5+

Using the parent filter in the document states report macro

In our scenario, a Comala Document workflow has been applied to all the pages in a group of pages with the Document states report and CQL query page as the top-level page.



We can add the document -state-states report macro to a page and filter on the Parent page filter in the macro editor.

...

The document states report on the published page would only display the children of the Parent page filter. 


The document -state-states report macro has an option to add and use some Confluence CQL filters. We can use one CQL filter to expand our display to show all workflows on the pages within a hierarchy.

Adding a CQL filter

 The CQL field reference we will use is ancestor.

...

Once saved to the page the document-states-report displays the workflow state data on the direct descendants of the page identified from the pageid.


Other CQL field references

Multiple CQL field reference filters can be added together to the CQL filter with each field filter being separated by a comma in the macro editor to create a more complex filter.

...

Further details of Atlassian CQL field references are https://developer.atlassian.com/server/confluence/cql-field-reference/

For details Details of the macro filters see - document-state-report macro pagecan be found on the document states report macro page.

Other document states report macro CQL filter examples

Filter by label (Content by label)
showLabelsfalse
showSpacefalse
excludeCurrenttrue
cqllabel = "cql_example"