Workflow Report Macro - Tasks

Owned by Robert Alexander Marshall
Last updated: Jun 05, 2024
2 min read

Overview

The tasks report is used to display lists of tasks and associated information. It's great for keeping track of workflow tasks across multiple spaces.

This is one of several reports available from the workflow report macro.

Permissions

Anyone can view this report. It will only list tasks that the user has access to.

Adding the report

To add the report to a page:

  • choose Workflow Report in the macro editor

  • set the Type setting to tasks

  • choose Save

  • Publish the page

Here's how the macro looks on your page.

You can filter the displayed report on the page by Assignee or Tasks by using the links at the top of the report.

You can also sort the table by clicking the column headings.

Customizing the report

You can customize the report with the following macro settings:

Setting

Default

Notes

Setting

Default

Notes

Space Key(s)

Current space

Which space(s) should be included in the report?

  • Leave empty to report on the current space

  • Specify one space key to report on a specific space

  • List multiple space keys, separated by commas, to report on multiple spaces

  • Specify any to report on all spaces. If you do this, you must specify only one state in the State setting.

Max Entries

20

The number of results to show per page.†

Label



Should the report be filtered by content label(s)?

  • Leave empty to include all content

  • 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.

Parent Page Filter



Should the report be filtered to a specific parent page and the child pages of the specific page?

  • Leave empty to include all content in the space

  • Specify a page title to include the specified page and its child pages

Sort

modified

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.

See also

Reporting Guide:

User Guide:

Workflow Authoring Guide: