Activiti 5.x Business Process Management Beginner's Guide

Download the latest Apache Tomcat from http://tomcat.apache.org/download-70.cgi and extract it onto your local system.

Copy activiti-explorer.war from the activiti-5.x\wars folder and place it in the apache-tomcat-7.0.33\webapps folder, as shown in the following screenshot:

Now we will start the Apache Tomcat server so that the activiti-explorer.war file is deployed to the webapps folder.

For the Windows operating system, browse to apache-tomcat-7.0.33\bin and double-click on startup.bat, as shown in the following screenshot:

Now, the startup.bat file will start executing and deploying the Activiti Explorer on the system. During installation, it will set up the Activiti Engine, H2 database, default users, and much more. The result of this installation can be seen in the following screenshot:

All the directories of the Activiti Explorer will be created on the apache-tomcat-7.0.33\webapps\activiti-explorer path once the installation is completed.

For the Linux operating system, we can use the command prompt to start Apache Tomcat.

The location of the war file will be the same as that for the Windows operating system. To start Apache Tomcat, we need to browse to the ../apache-tomcat-7.0.33/bin path using the command prompt and execute the following command:

sh catalina.sh run

The result of executing the previous command is shown in the following screenshot:

Create a new Activiti project in Eclipse by navigating to File | New | Project | Activiti Project and name your project SimpleLeave-Process.

The SimpleLeave-Process project will have a folder structure as shown in the following screenshot:

Now create an Activiti Diagram in the src/main/rersource/diagrams folder structure.

To create a diagram, navigate to File | New | Other | Activiti Diagram and name your diagram SimpleLeaveProces s. The folder structure is shown in the following screenshot:

On opening the .bpmn file, a white canvas will appear on which you can design the business process.

To draw a business process, there is a Palette option available which contains most of the BPMN diagrams for designing the business process. First, we will be adding a StartEvent on the canvas from the Event tab of the Palette option. All these options are shown in the following screenshot:

To add a script task, click on StartEvent and it will display the options as shown in the following screenshot. From those options, select the new element option, which will list down all the elements; from those elements, select Create script task, as shown in the following screenshot:

To add a user task, click on Script Task and select new user task, which is the option displayed with a human icon as shown in the following screenshot:

As each and every business process should have at least one end event, to add an end event, click on User Task and select the new end event option, as shown in the following screenshot:

After adding the end event to the process, your business process should look similar to the following screenshot:

Now we have to make some changes to the properties of the process.

First, we will change the properties of the start event. Select the start event, open the Properties tab, and add Form Properties in the Form tab using the New button as shown in the following screenshot:

Now, edit the properties for the script task. In the Main config tab, there is a Script field available; within that, insert the print statement out:println"ApplyforLeaveby"+Empname;. The Empname property is the form property that we created in the start event. The script task will print the message on the console when it is executed, as shown in the following screenshot:

Now we will edit the user task properties. In the General tab, we will populate the Name property, which will be displayed in the user task node, as shown in the following screenshot:

As the user task is to be performed by a specific user, we have to provide the name of the user who will be responsible for executing it.

We have to populate the Assignee property of the Main config tab with the name of the person to whom the task should be assigned; as shown in the following screenshot, we will be assigning it to kermit:

We can also view the .bpmn file in the XML format. Right-click on the SimpleLeaveProcess.bpmn file, browse to OpenWith | XML Editor, and it will be available in the XML format. The result of this step is shown in the following screenshot:

Right-click on the SimpleLeaveProcess.bpmn file and browse to Activiti | Generate unit test, as shown in the following screenshot:

On performing the previous step, a test class file is created in src/test/java package, as shown in the following screenshot:

In the ProcessTestMyProcess.java file, replace the code with the following:

@Test
  public void startProcess() throws Exception {
    RepositoryService repositoryService = activitiRule.getRepositoryService();
    repositoryService.createDeployment().addInputStream("SimpleLeaveProcess.bpmn20.xml",
      new FileInputStream(filename)).deploy();
    RuntimeService runtimeService = activitiRule.getRuntimeService();
    Map<String, Object> variableMap = new HashMap<String, Object>();
    variableMap.put("Empname", "Irshad");
    ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("leaveProcess", variableMap);
    assertNotNull(processInstance.getId());
    System.out.println("id " + processInstance.getId() + " "
      + processInstance.getProcessDefinitionId());
  }

To view the test result, you can right-click on the ProcessTestMyProcess class file and browse to Run As | JUnit Test, as shown in the following screenshot:

The output after executing the test case is shown in the following screenshot: