Source changes

POM

In the root pom.xml:

change parent/version from 2.1.1 to 2.1.2
change properties/syncope.version from 2.1.1 to 2.1.2

In core/pom.xml, replace

         <dependency>
          <groupId>org.apache.syncope.core</groupId>
          <artifactId>syncope-core-workflow-flowable</artifactId>
           <version>${syncope.version}</version>
         </dependency>

with

        <dependency>
          <groupId>org.apache.syncope.ext.flowable</groupId>
          <artifactId>syncope-ext-flowable-rest-cxf</artifactId>
          <version>${syncope.version}</version>
        </dependency>

In console/pom.xml, add

        <dependency>
          <groupId>org.apache.syncope.ext.flowable</groupId>
          <artifactId>syncope-ext-flowable-client-console</artifactId>
          <version>${syncope.version}</version>
        </dependency>

as first child of the <dependencies> element in the all profile; then remove

        <dependency>
          <groupId>org.flowable</groupId>
          <artifactId>flowable-ui-modeler-app</artifactId>  
          <type>war</type>
          <scope>test</scope>
        </dependency>

and the whole <plugins/> element (including children).

Files

In the workflow.properties file enabled with Flowable support (it could be core/src/main/resources/workflow.properties, core/src/main/resources/all/workflow.properties or other, depending on your project setup), replace
```
uwfAdapter=org.apache.syncope.core.workflow.flowable.FlowableUserWorkflowAdapter
```
with
```
uwfAdapter=org.apache.syncope.core.flowable.impl.FlowableUserWorkflowAdapter
```

In both console/src/main/resources/console.properties and console/src/test/resources/console.properties, remove

flowableModelerDirectory=${flowable-modeler.directory}

and

page.workflow=org.apache.syncope.client.console.pages.Workflow

then add

topology.corePoolSize=10
topology.maxPoolSize=20
topology.queueCapacity=50

Internal Storage

If not using Flowable

Stop the Java EE container running Syncope Core, then execute the following SQL statement:

DROP VIEW user_search;
ALTER TABLE SyncopeUser DROP COLUMN workflowId;
CREATE VIEW user_search AS SELECT u.id as any_id, u.* FROM SyncopeUser u;

Finally start again the Java EE container.

If using Flowable

Stop the Java EE container running Syncope Core, then follow the instructions to download and extract the upgrade tool, the run it by adding the "-flowable-2.1.2" switch to the command line as follows:

./syncopeupgrade.sh org.postgresql.Driver \
 jdbc:postgresql://localhost:5432/syncope syncope syncope postgres \
-flowable-2.1.2 \
 upgradeFlowable212.sql

Now execute the SQL statements as generated above in the upgradeFlowable212.sql file against the internal storage: in case of errors, apply manual corrections until everything runs clear; consider to restore from the backup taken above if needed, before executing the updated SQL statements again.

Finally start again the Java EE container and watch the log files to check for any error.

User workflow definition

The user workflow must be updated: in the XML definition, replace any occurrence like as follows:

flowable:expression="#{create.execute(execution.processInstanceId)}"