This documentation is for a version that is out of support.

You may want to view the same page for the latest version, or for any of the versions available in the drop-down menu in the top-right corner.

Start building your application: draw a BPMN process diagram

Now that you have your development environment (i.e. Bonita Studio) up and running, you are ready to start building your first Bonita Living Application.

In this tutorial we will build a claims management solution. Making sure that claims are handled and answered in a timely manner by the appropriate employee(s) can be key to customer satisfaction. It is also a good fit for a process-based application that uses automation. We will of course drastically simplify the application in this tutorial so you can focus on learning about Bonita and not about claims management!

Here is an overview of process execution:

  • The process will be started by a customer who submits a claim, which is a simple text description in our example

  • Next, an employee will review the claim and provide an answer

  • The customer will be able to review the employee’s answer and provide a satisfaction rating

  • If the rating is equal to or greater than 3, the process will finish after the customer has read the answer

  • If the rating is lower than 3 an extra task will be assigned to the manager of the employee to work with this customer who is not really satisfied. Once this task is done the process will be completed

To design this process we will use the Business Process Model and Notation (BPMN) standard. You don’t need to learn everything about BPMN to follow this tutorial but, if you would like to know more, you can read the Ultimate Guide to BPMN 2.0.

We will use an iterative approach in the process development. This means that in the first iteration, we will have a few limitations:

  • a single user will perform all the tasks

  • we won’t collect data from the user

  • the process will follow a single path - the one for an unsatisfied customer

As we introduce data in our process definition and configure actors, a user will be able to input data in web forms, the process will follow paths that depend on data values, and different users will be involved.

Create the process diagram

Create a new diagram:

  1. In the Bonita Studio menu, click on File  New diagram.

    Add user task

The new diagram includes:

  • One pool: one process definition

  • One lane inside the pool: lane default name is Employee lane (more about lanes in another chapter)

  • A start event: the starting point of process execution

  • A user task: a task (or step) that needs to be performed by a user

and it should look like this:

Default diagram content

Before we continue, let’s rename the diagram and the pool:

  1. In the Project explorer on the left-hand side of the Bonita Studio window, select the diagram MyDiagram-1.0.proc

  2. Right click and select Rename…​ Rename contextual menu

  3. In the pop-up window, enter the new name for the diagram: ClaimsManagementDiagram, and for the pool: ClaimsManagement Choose a new name and version pop-up window

Now let’s rename the start event (i.e. the green disc on the left hand side of the process):

  1. Select the start event in the diagram

  2. At the bottom of the Bonita Studio screen, go to the General  General tab

  3. Edit the Name attribute and set the value: Submit claim

    Rename start event

Also rename the default user task:

  1. Select the user task Step1

  2. At the bottom of the Bonita Studio screen go to the General  General tab

  3. Edit the Name attribute and set the value: Review and answer claim

Now we will add another task to the process:

  1. Select the Review and answer claim task

  2. At the border of the selected task, click on the task icon and drag and drop it onto the diagram

  3. Make sure that the newly added task is selected

  4. Click on the toolbox icon

  5. Select the user icon

  6. Rename the task to: Read the answer and rate it

    Add user task

In order to define another path in our process execution, we will add an exclusive gateway. This gateway will direct the process execution to a different path based on certain conditions. Adding an exclusive gateway is done quite the same as adding a task:

  1. Select the user task Read the answer and rate it

  2. Drag and drop the diamond-shaped gateway icon

  3. Click on the toolbox icon

  4. Change the gateway type from parallel (the one with the + sign) to exclusive (the one with the x sign)

    Switch from parallel to exclusive gateway
  5. Rename the gateway to: Satisfaction level

From the gateway, there are two possibles paths. The first one completes the process if the customer satisfaction level is good. The end of a process is identified by an end event, a red disc. Adding the end event is similar to how you added a task and a gateway:

  1. Select the gateway

  2. Drag and drop the event icon (the disc icon)

  3. Select the end event type (red disc icon)

    Event type selection: end event
  4. Rename the event to: End client satisfied

The second path from the gateway will lead to another user task:

  1. Select the Satisfaction level gateway

  2. Drag and drop the task icon

  3. Click on the toolbox icon

  4. Select the user icon

  5. Rename the task Deal with unsatisfied customer

And from this Deal with unsatisfied customer task we need to go to a second end event:

  1. Select the Deal with unsatisfied customer user task

  2. Drag and drop the event icon (the disc icon)

  3. Select the end event type (red disc icon)

  4. Rename the event to: End client unsatisfied

  5. Refresh the diagram validation: at the bottom of the screen, select the Validation status tab and click on the Refresh button

Your process diagram should look like this:

Process diagram

Now you can see a validation error on the gateway. The error is displayed because we didn’t define the conditions for process execution when it reaches the gateway. Trying to execute the process will fail because the process execution engine cannot determine which path to follow.

We need to configure the conditions required to define the path to follow when executing the process. Conditions are defined on the gateway outgoing transitions (i.e. the arrows going out of the gateway):

  1. Select the transition going to the end event

  2. Name it to Good

  3. Go to the General  General tab

  4. Check the checkbox Default flow

    Transitions names and conditions configuration

Default flow means that the transition will be activated only if all other conditions configured on the gateway outgoing transitions are false (boolean value).

We need to configure the condition on the transition from the gateway to the Deal with unsatisfied customer task:

  1. Select the transition going into the task Deal with unsatisfied customer

  2. Name the transition Bad

  3. Go in General  General tab

  4. In Condition type the value true

  5. In the Bonita Studio menu, click on File  Save

Due to the static value true, this version of the process will always go through the Deal with unsatisfied customer task.

In order to make the error go away, refresh the diagram validation: at the bottom of the screen, select the Validation status tab and click on the Refresh button. You should have only five warnings left.

Congratulations! You have now your first valid BPMN process diagram!

Run your process

You can now easily build, package, deploy and execute this process definition in the Bonita Studio embedded test environment:

  1. Select the process pool, the rectangle shape that includes start events and tasks

  2. Click on the Run button Run button in the toolbar at the top of the Bonita Studio window

  3. On the instantiation form, click on the Start button. The process instance is started and you are redirected to the Bonita Portal task list

  4. Move your mouse over the Review and answer claim form on the right hand side of the Bonita Portal and click on the Take button to "claim" the task

  5. Click on the Execute button to actually perform the task and move the process execution forward

  6. Click on the Refresh button Refresh button at the top of the task list to update it

  7. Click on the Overview tab on the right side to see the process execution overview form with information about process execution

  8. Click on the Form tab to get back to the Read the answer and rate it user task form

  9. You can click on Take and execute for both tasks, Read the answer and rate it and Deal with unsatisfied customer, to finish the process execution

  10. In the Bonita Portal top menu, click on Cases Cases button

  11. Click on the Archived cases tab

  12. Click on the View case overview action (i.e. the "eye" icon) to display the overview form with information about process execution

Process execution

When you click on the Run button, the process definition and its dependencies are built, packaged and deployed in the Bonita Studio test environment. A user is logged in by default (username: walter.bates, password: bpm) and the auto-generated start form for the process is opened in your web browser. If you submit the instantiation form, it will start a new process instance (or case) and load the user task list in the Bonita Portal. In the task list, you can’t immediately submit a user task because, by default, all users (of the test organization) are candidates to perform the tasks of the process. In order to act on the task you need first to "claim" it, which then makes you the only one - among all the possible candidates - who can do perform an action on it.

You can view process instance information in the Cases section of the Bonita Portal. You can switch between Open cases and Archived cases to either view the ongoing process instances or see completed ones. Note that if you want to start a second case (i.e. a process instance), you must go into the Bonita Portal Processes menu and click on the Start a new case button (i.e. the "play" icon in the Action column) next to the process definition name. If you click on the Run button from Bonita Studio, it will clean / overwrite any information related to any process with same name and version, including previous cases. Note that if you did any modifications to your project, you probably want to click on the Run button to be sure that the latest version is deployed.

You successfully built and executed your first process. So far it is not very useful as it does not deal with any data and web forms, and only includes a single submit button. In following chapters we will define a business data model and bind it to the process to save information related to the claim submitted by the user.