Quick Start

In this guide, you will go through the entire path: from installation to process modeling.

Let’s get acquainted with Flowset using the demo process “Business Trip Request”.

Prerequisites

Before you begin, make sure you have the necessary tools installed (detailed instructions are provided in separate sections):

  • Flowset Studio — an environment for modeling BPMN diagrams and forms.

  • Flowset Control — a web interface for process monitoring and administration.

Demo Process

We will model a business trip request process consisting of three elements:

  • Start Event with a start form (Camunda Form) — the employee enters the data.

  • Service Task (JavaDelegate) — emulates notifying the accounting department (logs the data).

  • End Event — ends the process.

Demo process

Step 1. Creating a diagram in Flowset Studio

First, let’s create a simple Spring Boot application using the Flowset Studio plugin.

You can find the installation instructions for Flowset Studio at the link.

  1. Launch Studio and create a new application with an embedded BPM engine.

    Creating a new application

    You can currently choose between Camunda or Operaton.

  2. In the Flowset Explorer, select: Processes → New → Blank diagram.

    Creating a new diagram

  3. Specify the parameters:

    • Process ID: business-trip-process

    • Process name: Business trip process

      Filling in process properties

  4. Place the elements on the diagram: Start Event → Service Task → End Event and connect them.

    Building the diagram

  5. Configure the Service Task and generate a new class using the “+” icon in the Class field:

    • Name: Notify the accounting department

    • Task type: Java Class

      Service Task configuration

      Enter NotifyJavaDelegate as the new class name:

      Creating a class for the Service Task

  6. Add the following implementation to NotifyJavaDelegate:

    package com.example.workflow.delegate;

import org.operaton.bpm.engine.delegate.DelegateExecution;
import org.operaton.bpm.engine.delegate.JavaDelegate;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class NotifyJavaDelegate implements JavaDelegate {

    private static final Logger log = LoggerFactory.getLogger(NotifyJavaDelegate.class);

    @Override
    public void execute(DelegateExecution execution) {
        String employee = (String) execution.getVariable("employeeName");
        String destination = (String) execution.getVariable("destination");
        String startDate = (String) execution.getVariable("startDate");
        String endDate = (String) execution.getVariable("endDate");
        String purpose = (String) execution.getVariable("purpose");

        log.info("Business trip request: {} → {} ({} — {}). Purpose: {}",
                 employee, destination, startDate, endDate, purpose);
    }
}
    NotifyJavaDelegate emulates integration with an external accounting service.

Step 2. Creating the start form

Now let’s create a user form for the business trip request.

  1. In the Flowset Explorer, select: Forms → New → Blank form.

    Creating a new form

  2. In the form creation dialog, fill in:

    • Form ID: start-form.

      Filling in form properties

  3. Using the visual editor, add the following fields:

    Name Key Type Required?

    Name

    employeeName

    TextField

    Yes

    Destination

    destination

    TextField

    Yes

    Start date

    startDate

    Date

    Yes

    End date

    endDate

    Date

    Yes

    Purpose

    purpose

    TextArea

    Yes

    Form builder

  4. Bind the form to the Start Event:

    • Form type: Camunda form

    • Form reference: start-form.form [start-form]

      Form binding

Your process is ready!

Step 3. Running and testing

  1. Start your Spring Boot application.

    studio start project

  2. Open Operaton Tasklist at: http://localhost:8080

    The login credentials are specified in application.properties. Default: admin/admin.
    studio application properties

    Enter your login and password.

    Operaton Tasklist

  3. Go to Tasklist and start your process:

    tasklist start process 2

    tasklist start process 3

    Click Start.

    Process form

    After the process completes, a log entry will appear containing the submitted data.

    tasklist start process 6

Step 4. Monitoring in Flowset Control

You can view the process execution using Flowset Control. To do this, launch Control and connect it to your application.

Installation instructions for Flowset Control: link.

  1. Log into the application:

    • Login: admin

    • Password: admin

      control login

  2. On the main screen, click Add and fill in the fields:

  3. Go to Process Instances → Completed, find your process and click View.

    control process instance 1

  4. Make sure the execution passed through the Service Task. If successful, the process diagram will be highlighted in green.

    control process instance 2

Now you can extend the scenario: add date validations, branching rules, integrations with external systems, and approval tasks.