BPMN 2.0 Compatibility Matrix

saccharine/bpmn implements the core subset of the OMG BPMN 2.0 specification required for queue-driven Laravel workflows. Unsupported elements are automatically pruned from the visual modeler's palette, context pad, and replace menu via engineCapabilities.js.

Legend

  • ✅ Supported: Parsed into the relational graph, enabled in the visual modeler, and executed by a dedicated runtime handler.
  • ⚠️ Visual / Partial: Allowed on the canvas for layout or partially implemented (see notes).
  • 🗓️ Planned: Tracked on the v1.0 milestone roadmap.
  • ❌ Not Supported: Excluded from the palette and runtime engine.

1. Events Matrix (Position × Trigger Type)

Rather than listing all 70+ abstract BPMN metamodel combinations, the matrix below maps the concrete event positions supported by BpmnParserService against standard OMG trigger definitions:

Event Trigger Type Start Event (<bpmn:startEvent>) Intermediate Catch (<bpmn:intermediateCatchEvent>) Boundary (<bpmn:boundaryEvent>) End Event (<bpmn:endEvent>) Notes
None (Blank) ✅ — — ✅ Initiates manual/API runs; End Events clean up active branch tokens.
Message ✅ 🗓️ 🗓️ ❌ Start Events bind messageRef to Eloquent/event triggers. Mid-process correlation is Milestone 1.
Timer ❌ ✅ ✅ — Supports ISO 8601 durations (timeDuration, e.g., PT24H) on Intermediate Catch and User Task Boundaries.
Error ❌ — ✅ ❌ Attaches to serviceTask, callActivity, and subProcess; injects _error_caught into $userData.
Signal / Escalation ❌ ❌ ❌ ❌ Pruned from the modeler UI.
Conditional ❌ ❌ ❌ — Use an Exclusive Gateway (XOR) downstream of a Start Event for conditional routing.
Compensation / Cancel ❌ ❌ ❌ ❌ Implement rollback logic programmatically inside Activity classes.
Terminate — — — ❌ Use administrative haltProcess interventions or allow active branches to reach standard End Events.
Link — ❌ — — Connect nodes directly via <bpmn:sequenceFlow>.

Note on Non-Interrupting & Event Sub-Processes: Non-interrupting boundary events (cancelActivity="false"), Intermediate Throw Events (<bpmn:intermediateThrowEvent>), and Event Sub-Processes (triggeredByEvent="true") are not currently supported.


2. Tasks & Activities

BPMN 2.0 Element XML Tag Status Engine Behavior & Notes
Service Task <bpmn:serviceTask> ✅ Resolves camunda:class against config('saccharine-bpmn.activities') and merges camunda:inputParameter defaults.
User Task <bpmn:userTask> ✅ Emits UserTaskPending and hibernates the Fiber until resumed via submitUserTask or a Timer Boundary timeout.
Call Activity <bpmn:callActivity> ✅ Resolves calledElement key to an active ProcessVersion and runs as an isolated child workflow.
Embedded Sub-Process <bpmn:subProcess> ✅ Scopes nested elements via parent_element_id and executes inside a bounded child workflow.
Generic Task <bpmn:task> ⚠️ Enabled in engineCapabilities.js for sketching, but lacks a runtime handler in NodeHandlerFactory.
Script / Business Rule / Manual / Send / Receive Tasks <bpmn:scriptTask>, etc. ❌ Pruned from the UI; implement custom logic in PHP Workflow\V2\Activity classes via Service Tasks.
Multi-Instance Loops multiInstanceLoopCharacteristics 🗓️ Sequential and parallel collection iteration on tasks and sub-processes is not yet implemented.

3. Gateways

BPMN 2.0 Element XML Tag Status Engine Behavior & Notes
Exclusive Gateway (XOR) <bpmn:exclusiveGateway> ✅ Evaluates outgoing conditionExpression rules via Symfony ExpressionLanguage; supports expressionless default flows.
Parallel Gateway (AND) <bpmn:parallelGateway> ✅ Spawns concurrent child workflows on split and synchronizes payload mutations at the join via Workflow\V2\all().
Inclusive Gateway (OR) <bpmn:inclusiveGateway> 🗓️ Multi-branch conditional routing and dynamic join synchronization under research.
Event-Based / Complex Gateways <bpmn:eventBasedGateway>, <bpmn:complexGateway> ❌ Pruned from the modeler palette and replace menu.

4. Connecting Objects, Swimlanes & Data

BPMN 2.0 Element XML Tag Status Engine Behavior & Notes
Sequence Flow <bpmn:sequenceFlow> ✅ Compiled into process_edges with optional <bpmn:conditionExpression> logic.
Pools, Lanes & Groups <bpmn:laneSet>, <bpmn:lane>, <bpmn:group> ⚠️ Allowed on the canvas for visual organization; ignored during runtime execution.
Text Annotations <bpmn:textAnnotation> ⚠️ Preserved in stored bpmn_xml for documentation; ignored by BpmnParserService.
Data Objects & Data Stores <bpmn:dataObject>, <bpmn:dataStore> ❌ Process state flows implicitly through $userData; declarative camunda:outputParameter mapping is Milestone 2.
Collaborations & Message Flows <bpmn:collaboration>, <bpmn:messageFlow> ❌ Cross-pool inter-process message flows are not supported.