The content below is for Apache Syncope 1.2 - for later versions the Reference Guide is available.
Due to licensing issues - see this comment for more information - it is not possible to embed Activiti Modeler, which provides a powerful graphical web editing interface for Activiti workflow, into any Apache Syncope artifact; thus, some manual steps are required to enable it on a working Apache Syncope environment.
This procedure requires Apache Maven to be available on the host where Apache Syncope console will be run since it is using a fake project to perform all required setup tasks.
Identify the Activiti version for Apache Syncope
Read release notes for your own Syncope version: for example, Apache Syncope 1.2.0-M1 ships with Activiti 5.16.2.
Identify the directory where Activiti Modeler will be deployed
This is the directory where Activiti Modeler will be run from: it needs to reside on the same physical host where Apache Syncope console will be run.
This is the same directory defined in Syncope's
Obtain a copy of TokenValue map
You can download it from the source repository
Run the fake Maven project
Create a file named
pom.xml in an empty directory of the same physical host where Apache Syncope console will be run with the following content:
Fill the XML elements under <properties> with the elements identified above (where
XXXXXXX is the path to a directory to be created and
YYYYYYYYYYY is the directory where you have placed the file
oryx.debug.js-tokenValueMap.properties), then run
this will download Activiti Modeler and adapt the configuration to work with Apache Syncope console.
At this point you will need to adjust the
activitiModelerDirectory property in
console.properties to point to the
YYYYYYYYYYY set above.
Restart the Java EE container
Now that modifications have been made, restart the Java EE container where the Syncope console is deployed to make it aware of changes.