Form Modeling

CIB seven Modeler includes a form builder for creating Camunda embedded forms (JSON schema-based). Forms built here can be referenced directly from BPMN User Tasks.

Opening the Form Editor

  1. Navigate to the Forms tab on the start page
  2. Click New to create a blank form, or Import to load an existing .json form schema
  3. The form editor opens with a drag-and-drop canvas

Building a Form

Adding Fields

Drag a field type from the left palette onto the canvas:

Field Type Description
Text Field Single-line text input
Textarea Multi-line text input
Number Numeric input
Checkbox Boolean toggle
Select Dropdown with static or dynamic options
Date Date picker
Tag List Multi-value tag input
Group Layout container for grouping fields
Columns Multi-column layout
Button Submit button

Configuring a Field

Select any field to open the properties panel:

  • Key — The variable name used by the process engine when the form is submitted
  • Label — Display text shown to the end user
  • Validation — Required, min/max length, pattern constraints
  • Disabled / Hidden — Conditional visibility via FEEL expressions
  • Default Value — Pre-filled value

Saving a Form

Forms are saved as JSON schemas in the form_entity table. Click Save in the toolbar to persist changes.

You can also Download the form schema as a .json file to use in other tools.

Referencing a Form from a BPMN Task

After saving a form, link it to a User Task:

  1. Open the BPMN diagram containing the User Task
  2. Select the User Task in the canvas
  3. In the Properties Panel, go to Forms
  4. Enter the Form ID that matches the formId field of the saved form

When the task is activated in a running process instance, CIB seven renders the form for the assignee.

On this Page: