---
title: "Workflow Events"
canonical: "https://support.appfire.com/space/CDML/649923526/Workflow%20Events"
format: markdown
---
> Macro (aura-html)


> ℹ️ You need to [set up your project and environment](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649595250) go be able to handle Comala Document Management events.

You can have your app to *listen* to workflow related events using Confluence's [Event Listeners](http://confluence.atlassian.com/display/CONFDEV/Event+Listener+Module).

# Events

| Event | Description |
| --- | --- |
| `ApprovalApprovedEvent` | Fired when the page of blogpost is approved. [v7.0+]<br>> ℹ️ Replaces `ContentApprovedEvent` in Comala Document Management v7.0+ releases. |
| `StateChangeEvent` | Fired when the state of page or blog post is changed |
| `StateExpireEvent` | Fired when the state of a page of blog post has expired |
| `ApprovalAssignedEvent` | Fired when the approval is assigned |
| `ApprovalUnassignedEvent` | Fired when the approval is unassigned |
| `ContentApproveEvent` | Fired when the page or blog post is approved<br>> ℹ️ Removed from Comala Document Management v7.0+ releases. Use `ApprovalApprovedEvent` instead in v7.0+. |
| `ContentRejectEvent` | Fired when the page or blog post is rejected |
| `TaskCreateEvent` | Fired when a task is created |
| `TaskUpdatedEvent` | Fired when a task is updated |
| `TaskCompleteEvent` | Fired when a task is completed |
| `TaskCloseEvent` | Fired when a task is closed (usually when the state changed and there are still open tasks) |
| `TaskAssignEvent` | Fired when a task is assigned |
| `TaskDueDateExpiredEvent` | Fired when a task due date is expired |

> ℹ️ Check Comala Document Management API's `com.comalatech.workflow.event` package and subpackages for more event types in the Javadoc documentation [here](https://comalatech.bitbucket.io/comala-workflows/index.html).

> 📝 The JAVA API event [ContentApproveEvent (Comala Workflows API 6.17.3)](https://comalatech.bitbucket.io/comala-workflows/6.17.3/apidocs/com/comalatech/workflow/event/ContentApproveEvent.html) has been removed from v7.0+ releases. Comala Document Management Java API in v7.0+ releases use the following for approval events - [Approval ApprovedEvent (Comala Workflows API 7.0.0 API)](https://comalatech.bitbucket.io/comala-workflows/7.0.0/apidocs/com/comalatech/workflow/event/approval/ApprovalApprovedEvent.html)

# Usage

Workflow events are handled the same way as Confluence events

```java
public class WorkflowEventLogger implements EventListener {
    private static final Logger log = Logger.getLogger(WorkflowEventLogger.class);

    public void handleEvent(Event event) {
        if (log.isDebugEnabled()) {
            log.debug(event.toString());
        }
    }

    public Class[] getHandledEventClasses() {
        return new Class[] {
                // State Events
                StateChangeEvent.class,
                StateExpireEvent.class,
                ContentAssignEvent.class,
                // Approval event
                ContentApproveEvent.class,
                ContentRejectEvent.class,
                // Tasks Events
                TaskCreateEvent.class,
                TaskCompleteEvent.class,
                TaskCloseEvent.class,
                TaskAssignEvent.class,
        };
    }

}

```