---
title: Workflow definition comparison
description: Versions of IDM prior to 7.0 used the Activiti workflow engine. If you are upgrading from one of these versions, your current workflow definitions will continue to work in compatibility mode, but new definitions must be written for the new engine, Flowable. The following overview shows the main differences between the old and new workflow definitions:
component: pingidm
version: 8
page_id: pingidm:workflow-guide:workflow-def-comp
canonical_url: https://docs.pingidentity.com/pingidm/8/workflow-guide/workflow-def-comp.html
keywords: ["Workflows", "Workflow Definition", "Activiti", "Flowable"]
---

# Workflow definition comparison

Versions of IDM prior to 7.0 used the Activiti workflow engine. If you are upgrading from one of these versions, your current workflow definitions will continue to work in compatibility mode, but new definitions must be written for the new engine, Flowable. The following overview shows the main differences between the old and new workflow definitions:

|   |                                                                                                                                  |
| - | -------------------------------------------------------------------------------------------------------------------------------- |
|   | You can view additional upgrade information in the [Flowable Migration Guide](https://flowable.com/open-source/docs/migration/). |

1. Change all occurrences of `activiti` to `flowable`. Update examples:

   * Namespace

     ```none
     xmlns:flowable="http://flowable.org/bpmn"
     ```

   * Elements

     ```xml
     <flowable:formProperty id="givenName" name="First Name" type="string" required="true"></flowable:formProperty>
     <flowable:formProperty id="sn" name="Last Name" type="string" required="true"></flowable:formProperty>
     <flowable:formProperty id="department" name="Department" type="string"></flowable:formProperty>
     ```

2. Change `task.getExecution()`, per the changes to the sample file [`contractorOnboarding.bpmn20.xml`](custom-workflow-template.html):

   ![getExecution-flow-upgrade](_images/getExecution-flow-upgrade.png)
