Deployment

Since Java EE 6 now supports the lightweight Web Profiles it is much easier to deploy Java EE component into a web module. To install and deploy the Imixs Workflow engine into your web application it is sufficient to bundle the Imixs Workflow engine together with the imixs-faces.jar into your web module. You can add the Imixs components into the /lib folder of your web module:

This includes also the Imixs Rest Services which allow the deployment of Workflow models and an easy web service interface.

To check for the latest versions and download components provided by this project you can browse the Maven repository and search for keyword 'imixs'.

Adding a Database connection

Finally you need to add a persistence.xml file into your web module. The persistence.xml file defines how the workitems managed by the Imixs Workflow Engine will be persisted into a database. Add a file named persistence.xml into your web module:

/
+- WEB-INF/classes/META-INF/
| |- persistence.xml

The persistence.xml describes the location of you database. The following example shows a typical configuration using the Eclipselink driver provided by most JEE Application servers.

You can download the Imixs Sample Web Application from the download center to get a deployable sample application. You can also checkout the source code from the Imixs souce code repository to start with a web application template.

Adding a BackingBean

After you have added the Imixs Workflow engine to you web project you can add a BackingBean provided by the Imixs-Faces jar file by simply extending the faces-config.xml file located in the /WEB-INF folder of you web project.