---
title: "Reporting tools"
canonical: "https://support.appfire.com/space/CDALS/649823076/Reporting%20tools"
format: markdown
---
> Macro (aura-html)

## Overview

> Macro (excerpt)
> 
> Users can view the space **Document Report macro,** the page **Document Activity Report,** and **CQL** to search and report on workflow approval activity and information. each user can also view pending actions in their user profile **Document Actions**, and **My Read Assignments **reports.

## User Profile reports

> Macro (excerpt)
> 
> In their **User Profile,** each user can view
> 
> - their pending assigned approvals in the **[Document Actions report](https://appfire.atlassian.net/wiki/spaces/CDALS/pages/649789865)**
>   
> - their pending** Read Assignments** in the **[My Read Assignments report](https://appfire.atlassian.net/wiki/spaces/CDALS/pages/649659268)**

## 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 approval state dialog box. All approvals and rejections, together with comments and expirations, are recorded in the page activity history:

![image](media://14527d29-4421-4d10-bad1-15f8c74fd408)

  
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+]

> Macro (excerpt)
> 
> To view the record of who has approved or rejected the current page* *select **[Document Activity](https://appfire.atlassian.net/wiki/spaces/CDALS/pages/649724585)** 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**.
> 
> ![image](media://a4202d81-813d-42af-9130-c2e23f373581)
> 
> > ℹ️ 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](https://docs.comalatech.com/space/CDCLS/14050394450).

## Document Report

> Macro (excerpt-include)



## 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](https://confluence.atlassian.com/doc/content-by-label-macro-145566.html) macro or the [Page properties report](https://confluence.atlassian.com/conf58/page-properties-report-macro-771892380.html#PagePropertiesReportMacro-CQLfields) 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"` |