Skip to main content
This guide teaches you how to involve humans in your BPMN 2.0 process by adding user tasks.

​
Add a user task

Open your process in the Camunda Modeler and follow these steps:
  1. Use the create/remove space tool to add space between the start event and the Charge Credit Card service task.
  2. Select the activity shape (rounded rectangle) and drag it between these elements.
  3. Name the new activity Approve Payment.
  4. Change its type to User Task using the wrench button.
Add an activity between the start event and the service task Change the activity type to user task

​
Configure the user task

In the properties panel on the right:
  1. Select your user task.
  2. Scroll to the Assignee property.
  3. Enter demo to automatically assign the task to the demo user.
Set the assignee

​
Configure a basic form

Still in the properties panel:
  1. Select the user task.
  2. Click the Forms tab.
  3. Set the following properties:
    • Type: Camunda Forms
    • Form Ref: payment-form
    • Binding: deployment
Create a new form file by selecting File > New File > Form and set the Id to payment-form. Reference the form from the user task Create a new form

​
Add form fields

Drag elements from the form elements library to create three fields: Field 1 (Number) — Key: amount, Label: Amount Add the amount field Field 2 (Text Field) — Key: item, Label: Item Add the item field Field 3 (Checkbox) — Key: approved, Label: Approved? Add the approved field Select Camunda Platform as your execution platform in the lower-left corner and click Apply. Select the execution platform Save the form as payment.form.

​
Deploy the process

  1. Switch back to the process diagram.
  2. Click the deploy button.
  3. In the deployment panel, select payment.form under include additional files.
  4. Click Deploy.
Include the form file in the deployment

​
Work on the task

Navigate to Tasklist at http://localhost:8080/camunda/app/tasklist/ and log in with the credentials demo / demo.
  1. Click Start process.
  2. Select Payment Retrieval from the list.
  3. Use the generic form to set process variables.
  4. Click Add a variable to create rows.
  5. Click Start.
Start a process instance with the generic form You should see the Approve Payment task in your Tasklist. Select it and view the Diagram tab to see the highlighted user task. The highlighted user task in the diagram Click the Form tab to work on the task using the auto-generated form fields. The generated task form
If you don’t see any tasks in your Tasklist, you might need a filter. Add one by clicking Add a simple filter on the left.

​
Next step

Learn how to make your process more dynamic by adding gateways.
Catch up: get the sources of Step-3
git clone https://github.com/camunda/camunda-get-started-quickstart.git
git checkout -f Step-3
Or download as a .zip.