--- title: "Reporting tools" canonical: "https://support.appfire.com/space/COMALACDCLS/649728975/Reporting%20tools" format: markdown --- > Macro (aura-html) ## Overview Several in-app reporting tools are included to help you keep track of workflow events activities and assignments. > Macro (excerpt) > > Users can view **workflow events and actions** for a page using > > - the **document activity report** > - the **document report **for the space > - **CQL** to search and report on workflow activity and information > > Users can also see their **Document Actions report** in their user profile to view their pending assigned approvals. ## 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 will be recorded in the page workflow activity history. ![image](media://b6646696-ae61-4326-a1a5-9eb754df4cde) The report can be filtered using the tabs and exported as a CSV format file. It is also available from blog post content as well as for page content. The `pageactivity`** **macro can also be added to content. > 📝 The **page activity report** is available in > 📝 > 📝 - Comala Document Control Server > 📝 - legacy spaces in Comala Document Control v2.0+ Data Center that are yet not upgraded to use 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 will be recorded in the page workflow [document activity report](https://appfire.atlassian.net/wiki/spaces/COMALACDCLS/pages/650122699). ![image](media://97fb95c0-3890-4da7-a8d3-9d61f401c116) > 📝 The **document activity report** is only accessible in data center instances with at least Comala Document Control 2.0+ for Data Center installed and legacy spaces (from before the of installation of v2.0+) after the space is upgraded to use document activity using the [Document Activity Upgrade console](https://appfire.atlassian.net/wiki/spaces/COMALACDCLS/pages/649696436). ## My Document Actions Report You can view your pending approval actions in the Comala Document Management Actions report. The [report can be viewed by accessing your ](https://appfire.atlassian.net/wiki/spaces/COMALACDCLS/pages/649958930)**[User Profile](https://appfire.atlassian.net/wiki/spaces/COMALACDCLS/pages/649958930)**. ![image](media://d553e319-719e-4511-b1d7-d222632d6f75) It is also displayed for the current user on the Confluence dashboard. ## Document Control 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. ### Macros Confluence provides some 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. ### Confluence Search  In the Confluence general search screen, you can add filters to perform an advanced search.  Comala Document Control adds filters for a workflow state and workflow properties. For example - searching for pages and content currently in the applied workflow state named **Draft** ``` http:///rest/api/content/search?cql=state=Draft ``` - searching for workflow metadata properties ``` /rest/api/content/?expand=metadata.properties.comalaworkflows ``` > 📝 Search syntax is case sensitive. > Macro (excerpt) > > **REST API** > > The following search returns the details of the workflow states > > ``` > rest/cw/1/content//status?expand=state,states,approvals,actions,tasks > ``` > > ``` > {"expand":"","workflowName":"Simple Approval Workflow","state":{"name":"Approved","nameTranslation":"Approved","initial":false,"colour":"#14892c","hideStates":false,"taskable":false,"changeDueDate":true,"transitions":{"updated":{"state":"Review"},"expired":{"state":"Review"},"select":[]},"final":true},"publishedState":{"name":"Approved","initial":false,"colour":"#14892c","hideStates":false,"taskable":false,"changeDueDate":false,"final":true},"approvals":[],"states":[{"name":"Review","nameTranslation":"Review","transitions":{"approved":{"state":"Approved"},"rejected":{"state":"Rejected"},"select":[]},"colour":"#ffab00","approvals":[{"name":"Review this page","approvers":{"minimum":"*"}}]},{"name":"Rejected","nameTranslation":"Rejected","transitions":{"approved":{"state":"Approved"},"updated":{"state":"Review"},"select":[]},"hideFromPath":true,"colour":"#ff5630","approvals":[{"name":"Review this page","approvers":{"minimum":"*"}}]},{"name":"Approved","nameTranslation":"Approved","transitions":{"updated":{"state":"Review"},"expired":{"state":"Review"},"select":[]},"changeDueDate":true,"colour":"#14892c","final":true}],"actions":[],"tasks":[],"messages":[],"displayProgressTracker":true,"displaySuppressReadConfirmation":false,"contributors":{"totalSize":-1,"result":[]}} > ``` > > > 📝 > > Several APIs used for reporting are available in the [Comala Document Management for Data Center app](https://marketplace.atlassian.com/apps/142/comala-document-management?hosting=datacenter&tab=overview). For information refer to the [Comala Document Management Developer Guides](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649330694). ## Related pages - [https://appfire.atlassian.net/wiki/spaces/COMALACDCLS/pages/650122699](https://appfire.atlassian.net/wiki/spaces/COMALACDCLS/pages/650122699) - [https://appfire.atlassian.net/wiki/spaces/COMALACDCLS/pages/754712724](https://appfire.atlassian.net/wiki/spaces/COMALACDCLS/pages/754712724) - [https://appfire.atlassian.net/wiki/spaces/COMALACDCLS/pages/649696657](https://appfire.atlassian.net/wiki/spaces/COMALACDCLS/pages/649696657) - [https://appfire.atlassian.net/wiki/spaces/COMALACDCLS/pages/649958930](https://appfire.atlassian.net/wiki/spaces/COMALACDCLS/pages/649958930) - [https://appfire.atlassian.net/wiki/spaces/COMALACDCLS/pages/649629729](https://appfire.atlassian.net/wiki/spaces/COMALACDCLS/pages/649629729)