Start Event Activity
The Start Event activity defines the initiation point of a process. As the most common event type, it enables the creation of processes without any pre-conditions, often triggered by a human user through a graphical interface.
| Field | Description | Requirement |
|---|---|---|
| Initiator | Specifies the entity or user who initiates the process. | Required |
| Form key | Provides a reference to a specific form definition. | Optional |
| Form reference | Defines the name of a particular form to be used. | Optional |
| Validate form fields | Determines whether the fields of the associated form should be validated. Set to true to enable validation, or false to disable it. | Optional |
| Form properties | Allows for the definition of the form's structure and properties as a list of key-value pairs. | Optional |
Action Types & Examples
Initiator
- Format: String
- Example Result: "system_user"
Form Validation Status
- Format: Boolean
- Example Result: "true"
Implementation Examples
Field Setup - Initiator: admin@example.com - Form key: new_employee_onboarding - Validate form fields: true
Execution Parameters - Initiator: current_logged_in_user - Form key: customer_inquiry_form - Validate form fields: false - Form properties: { "customerName": "Acme Corp", "issueType": "Billing" }
Technical Notes
The Start Event activity serves as the mandatory entry point for any process definition. It cannot have incoming sequence flows and typically initiates a new process instance. When configured with a form, it facilitates the collection of initial data, which can then be passed as process variables. This event type is often used for processes triggered manually by a user or through an external API call.