Skip to end of banner
Go to start of banner

Reporting Tools

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Current »

Overview

User Profile Reports

In their User Profile, each user can view

Page Activity

To view the record of who has approved or rejected the current page select Page Activity from the Page Tools menu or the workflow popup. All approvals and rejections together with comments and expirations are recorded in the page activity history:


The report can be filtered using the tabs and exported as a CSV format file. It is also available for blog posts as well as for page content.

The {pageactivity} macro can also be added to a page.

Document Activity is displayed in data center instances with Comala Document Approval v2.0+ for spaces using document activity to record and track workflow events and actions. Page Activity is displayed for pages in Atlassian Server and legacy spaces in Atlassian Data Center that have not been upgraded to Document Activity.

Document Activity DATA CENTER V2.0+

To view the record of who has approved or rejected the current page select Document Activity from the Page Tools menu or the workflow popup. All approvals and rejections together with comments and expirations are recorded in the page workflow document activity report.

The document activity report is only accessible in data center instances with at least Comala Document Approval 2.0+ for Data Center only installed. Existing spaces with workflow events and actions in the instance (prior to installation of v2.0+) will need to upgraded to use document activity. These existing spaces will access the page activity report until the space data is upgraded using the Document Activity Upgrade console.

Document Report

To view a report for the approval events and activity for pages and blog posts in an entire space choose the Document Report link in the Confluence left sidebar.cda_documentreport_sidebar_menu.png

The Document Approval report for the current space pages is displayed.

cda_documentapprovalreport.png

The report lists the current space content by page title and details of each page including

  • Updated by - the user who most recently updated the page

  • the current workflow State

Additional columns can be set for the report including

  • Date of last page update

  • the time the transition occurred to move to the current state

  • Read Confirmation status (if any)

The Settings option displays a menu used to customize the report columns for the report in the current space. The Settings dropdown menu is only displayed for administrators.

From V2.1, a Data Refresh option is displayed. This opens the space Data Refresh dashboard. A space administrator can use this dashboard to repopulate the data used by reporting tools and report macros in the space.

Confluence Search Filters

The workflow status and assignees can be used as filters in the default Confluence search or macros that support CQL.

Confluence Search

 In the Confluence general search screen, you can add filters to perform an advanced search.  Comala Document Approval adds filters for "Workflow state" or "Assigned approver".

Macros

Confluence provides several macros that support CQL filters, like the Content by label macro or the Page properties report macro.

REST API CQL fields

If you are searching with your own app using the Confluence REST API the following field names should be used:

Field

Field name

Workflow state

cw_state

Assigned approver

cw_approver

cw_state search is case sensitive

1

cql=cw_approver="John" and cw_state="Approved"


  • No labels