The Imixs-JSF-Sample Application
The Imixs-Workflow project provides a Sample Application which demonstrates the behavior and the concepts of the Imixs-Workflow Engine. The source code can be downloaded from GitHub. The following section gives a brief overview how to build and deploy the Imixs-Sample Application into an Application Server. The installation guide is also helpful to get a better understanding what is necessary to integrate Imixs-Workflow into your own project.
This introduction refers the basic steps needed to get the Imixs-Sample Application up and running on different platforms. If you need further informations about the deployment of the Imixs-Workflow components see the section deployment for more detailed information.
First checkout the sources from GitHub and build the Imixs-Sample Application in your workspace. All Imixs-Workflow projects are build on Maven. This makes it easy to build the application from the sources. After you have checked out the sources you can run the Maven install command to build the war file.
~/git/imixs-jsf-example$ mvn clean install
You find the war file in the target folder of your working directory.
- a Database to store the Workitems and the Workflow Model
- a JDBC Database connection from your Application Server to your database
- a JAAS Security Realm to allow users to authenticate against the Workflow Application.
In the following deployment sections you will find more information how to setup a server environment:
To run the workflow you need to provide a workflow model. The workflow model describes the behavior of the Workflow. Things like the different states, the Read- or Write-Access, the Process History or Email notifications are declared in the Model. The Imixs-Sample Application contains a valid model file of a “Trouble Ticket Workflow System”. A trouble ticket system is based on a business process that manages and maintains lists of issues, as needed by an organization. Trouble Ticket Systems are commonly used in an organization’s customer support call center to create, update, and resolve reported customer issues, or even issues reported by that organization’s other employees.
After you have installed and setup the Imixs-Sample Application start the application with the following url from your browser: