Details
-
Type:
Task
-
Status:
Done
(View Workflow)
-
Priority:
Normal
-
Resolution: Unresolved
-
Affects Version/s: None
-
Fix Version/s: None
-
Component/s: FN
-
Labels:None Labels
-
Customer:Mobinets
Description
We identified an issue with the current Flowable process definitions on cloud env related to empty <errorEventDefinition/> elements in BPMN end events.
Problem:
In some deployed process definitions, end events had <errorEventDefinition/> without an errorRef.
Flowable requires an error code for error end events.
When these processes are executed, the following exception occurs:
org.flowable.common.engine.api.FlowableIllegalArgumentException: Error Code must not be null
at org.flowable.engine.delegate.BpmnError.setErrorCode(BpmnError.java:53)
at org.flowable.engine.delegate.BpmnError.<init>(BpmnError.java:48)
at org.flowable.engine.impl.bpmn.behavior.ErrorEndEventActivityBehavior.execute(ErrorEndEventActivityBehavior.java:48)
Root Cause:
Flowable engine requires all <errorEventDefinition/> elements to have a valid errorRef.
Some older BPMN files were deployed without a global error or without specifying errorRef on end events.
Activity
| Field | Original Value | New Value |
|---|---|---|
| Gantt Options | Milestone (set to milestone: having a due date but zero effort) | |
| Planned Start | 2026-01-27 24:00 (milestone: set planned start date to due date) | |
| Planned End | 2026-01-27 24:00 (milestone: set planned end date to due date) |
| Assignee | Hassan Abdine [ habdine ] | Ayed Bada [ abada ] |
| Summary | atch Flowable BPMN End Events to Fix Missing Error Codes | Patch Flowable BPMN End Events to Fix Missing Error Codes |
| Description |
We identified an issue with the current Flowable process definitions in the system related to empty <errorEventDefinition/> elements in BPMN end events.
Problem: In some deployed process definitions, end events had <errorEventDefinition/> without an errorRef. Flowable requires an error code for error end events. When these processes are executed, the following exception occurs: org.flowable.common.engine.api.FlowableIllegalArgumentException: Error Code must not be null at org.flowable.engine.delegate.BpmnError.setErrorCode(BpmnError.java:53) at org.flowable.engine.delegate.BpmnError.<init>(BpmnError.java:48) at org.flowable.engine.impl.bpmn.behavior.ErrorEndEventActivityBehavior.execute(ErrorEndEventActivityBehavior.java:48) Root Cause: Flowable engine requires all <errorEventDefinition/> elements to have a valid errorRef. Some older BPMN files were deployed without a global error or without specifying errorRef on end events. |
| Description |
We identified an issue with the current Flowable process definitions in the system related to empty <errorEventDefinition/> elements in BPMN end events.
Problem: In some deployed process definitions, end events had <errorEventDefinition/> without an errorRef. Flowable requires an error code for error end events. When these processes are executed, the following exception occurs: org.flowable.common.engine.api.FlowableIllegalArgumentException: Error Code must not be null at org.flowable.engine.delegate.BpmnError.setErrorCode(BpmnError.java:53) at org.flowable.engine.delegate.BpmnError.<init>(BpmnError.java:48) at org.flowable.engine.impl.bpmn.behavior.ErrorEndEventActivityBehavior.execute(ErrorEndEventActivityBehavior.java:48) Root Cause: Flowable engine requires all <errorEventDefinition/> elements to have a valid errorRef. Some older BPMN files were deployed without a global error or without specifying errorRef on end events. |
We identified an issue with the current Flowable process definitions on cloud env related to empty <errorEventDefinition/> elements in BPMN end events.
Problem: In some deployed process definitions, end events had <errorEventDefinition/> without an errorRef. Flowable requires an error code for error end events. When these processes are executed, the following exception occurs: org.flowable.common.engine.api.FlowableIllegalArgumentException: Error Code must not be null at org.flowable.engine.delegate.BpmnError.setErrorCode(BpmnError.java:53) at org.flowable.engine.delegate.BpmnError.<init>(BpmnError.java:48) at org.flowable.engine.impl.bpmn.behavior.ErrorEndEventActivityBehavior.execute(ErrorEndEventActivityBehavior.java:48) Root Cause: Flowable engine requires all <errorEventDefinition/> elements to have a valid errorRef. Some older BPMN files were deployed without a global error or without specifying errorRef on end events. |
| Status | Open Bug [ 10108 ] | Dev Scheduled [ 10014 ] |
| Status | Dev Scheduled [ 10014 ] | Implementation in progress [ 10016 ] |
| Status | Implementation in progress [ 10016 ] | To Be Released [ 10400 ] |
| Component/s | FN [ 16303 ] |
| Status | To Be Released [ 10400 ] | Ready for QA [ 10023 ] |
| Remaining Estimate | 0 minutes [ 0 ] | |
| Time Spent | 7 hours [ 25200 ] | |
| Worklog Id | 289834 [ 289834 ] |
| Baseline Start | 2026-01-27 24:00 (set baseline based of initial work logging) | |
| Baseline End | 2026-01-27 24:00 (set baseline based of initial work logging) |
| Time Spent | 7 hours [ 25200 ] | 1 day, 3 hours [ 39600 ] |
| Worklog Id | 289835 [ 289835 ] |
| Time Spent | 1 day, 3 hours [ 39600 ] | 1 day, 6 hours [ 50400 ] |
| Worklog Id | 289836 [ 289836 ] |
| Worklog Id | 289836 [ 289836 ] |
| Time Spent | 1 day, 6 hours [ 50400 ] | 1 day, 5 hours [ 46800 ] |
| Worklog Id | 289836 [ 289836 ] |
| Time Spent | 1 day, 5 hours [ 46800 ] | 1 day, 6 hours [ 50400 ] |
| Worklog Id | 289836 [ 289836 ] |
| Issue Type | Bug [ 1 ] | Task [ 3 ] |
| Workflow | Mobinets_Dev_BugWF_J4.4 [ 203612 ] | ACE: Software Development Workflow [ 203807 ] |
| Status | Ready for QA [ 10023 ] | Done [ 10000 ] |
| Reporter | Ayed Bada [ abada ] | Zein Trabelsi [ ztrabelsi ] |
| Transition | Time In Source Status | Execution Times | Last Executer | Last Execution Date | |||||
|---|---|---|---|---|---|---|---|---|---|
|
10m 47s | 1 | Ayed Bada | 27/Jan/26 12:45 PM | |||||
|
5s | 1 | Ayed Bada | 27/Jan/26 12:45 PM | |||||
|
7s | 1 | Ayed Bada | 27/Jan/26 12:46 PM | |||||
|
1m 46s | 1 | Khaled Khalil | 27/Jan/26 12:47 PM | |||||
|
2d 1h 23m | 1 | Khaled Khalil | 29/Jan/26 2:10 PM |
|
Links Hierarchy |
 Documentation
|
This issue exists only on Cloud and is related to the Flowable version upgrade
-------
Solution Implemented--------1/// Developed a SOAP API method patchErrorEventDefinitions that:
-Reads the latest process definitions.
-Replaces empty <errorEventDefinition/> with <errorEventDefinition errorRef="ERR_TECHNICAL"/>.
-Redeploys the patched BPMN automatically.
2/// Intercepted all manual BPMN uploads through FN and SRD platforms to add any missing errorRef before deployment.
Only empty error end events are modified; all other BPMN logic remains untouched.
-------
Impact------Fixes runtime exceptions caused by missing error codes.
-Safe to deploy on staging or production before full validation.
-Prevents regression by automatically patching future manual BPMN uploads.