Overview
User Profile Reports
In their User Profile, each user can view
their pending assigned approvals in the Document Actions report
their pending Read Assignments in the My Read Assignments report
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. The Document Approval report for the current space pages is displayed. 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 |
|