Versions Compared

Old Version 2

changes.mady.by.user Robert Alexander Marshall

Saved on

compared with

New Version Current

changes.mady.by.user Robert Alexander Marshall

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
maxLevel2
minLevel2
absoluteUrltrue
excludeSee also
typeflat
separatorpipe

Insert excerpt
Workflow Report Macro
Workflow Report Macro
namenewreportmacros
nopaneltrue

Overview

Excerpt
hiddentrue

Keep track of content reviews across multiple spaces.

...

  • choose Workflow Report in the macro browser

  • set the Type setting to approvals

  • choose Save

    Image RemovedImage Added

  • Publish the page

...

Filters can be applied to the report by a user on the page.

Filter

Description

​View

View Pending, Approved or Rejected​ approvals

Approvals

Which approval (name) to filter by

Report Columns

Report Column

Description

​Title

Page title​

Last updated by

User who last modified the page

Updated

Timestamp of page modification

State

Workflow state page is currently in

Status

Displays one or more approval status icon(s) for approvals in the current state for each page and a hyperlink to the content version at the time when the approval became active.

This is only shown when a named approval is selected in the filter options above the report header. Details for the status will also be displayed in the last (No name) column of the report.

Status icon

Choose the Pending filter along with the named Approvals filter

  • active pending approval are displayed with a  (tick) (tick in circle)

The active pending status icon will also include

  • last approval decision (star) (star) is displayed indicates awaiting approval or the last approval decision for this approval was approved

  • last approval decision ❌  (cross) is displayed indicates the last approval decision for this approval was rejected

If the approval is not active but pending (for example the approval limits reviewers to assignees and none have been assigned) the last approval decision will be displayed without the green tick.

Choose the Approved or Rejected filter is along with the named Approvals filter

  • completed Rejected approvals are displayed with a rejected decision icon (large red cross)

  • completed Approved approvals are displayed with an approved decision icon (green tick in check box)

A link to the page version that existed when the approval became active. If no further edits have yet been made then the link will be to the (Current) version.

If further edits have been made choosing the link displays a message warning the user that a more current version exists.

(No name)

Details of the Approval status showing any action required and recent activity related to the approval.

Only shown when an approval is selected in options above header.

The report content can be customized by editing workflow report macro settings.

...

The report can also be customized to sort on a specific column, the sort order and the maximum number of entries.

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.

Approval

approval name (required)

Note

You must specify the name of a content review for this report to work.

The name is defined by the approval macro, and is shown in the workflow popup during content reviews.

Max Entries

20

The number of results to show per page.†

Filter

pending

Which stage of the content review should the content be in?

  • pending – the review is not yet complete

  • approved – the review was approved

  • rejected – the review was rejected

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

Approver


Should the report be filtered to content that the specified user can currently review?

  • Leave empty to include all content

  • Specify a username to filter to results which that user can review

  • Specify @self to filter to results that the current user can review

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

User Guide

...