Error Handler
Overview
The Error Handler node becomes available in the Process Data Explorer when configuring activities within a Custom Error Handler.
It provides access to detailed information about the activity that generated the error, allowing workflows to inspect failures, generate notifications, perform recovery actions, or create audit records.
The Error Handler node is available only within a Custom Error Handler execution path.
Activity Error
The Error Handler node contains a single object named Activity Error.
Error Handler
└── Activity Error
├── Source
├── Exception
├── Context
└── Inputs
The object is populated automatically when the Custom Error Handler begins execution.
Source
Provides information about the activity that generated the error.
| Property | Description |
|---|---|
| Activity ID | Workflow activity identifier. |
| Activity Instance ID | Runtime activity instance identifier. |
| Activity Type | Activity type. |
| Activity Name | Internal activity name. |
| Activity Display Name | Display name shown in the Designer. |
| Node ID | Canvas node identifier. |
Exception
Provides details about the exception.
| Property | Description |
|---|---|
| Message | Error message. |
| Type | Exception type. |
| Stack Trace | Stack trace, when available. |
| Source | Component that generated the exception. |
Context
Provides execution context for the failure.
| Property | Description |
|---|---|
| Occurred At | Timestamp of the failure. |
| Workflow ID | Workflow identifier. |
| Workflow Instance ID | Workflow execution identifier. |
| Automation ID | Automation execution identifier. |
Inputs
Provides the input values supplied to the activity when the error occurred.
Unlike the other sections of Activity Error, the structure of Inputs depends on the activity that failed.
For example:
Activity Error
└── Inputs
├── File Path
├── Connection
└── Timeout
Using Error Handler Data
Error Handler data can be used to:
- Send detailed failure notifications.
- Record audit information.
- Create incidents.
- Perform recovery logic.
- Diagnose execution failures.
Because Error Handler data is available through the Process Data Explorer, it can be bound directly to activity properties, expressions, and conditions.
Runtime Behavior
The Error Handler node exists only while executing a Custom Error Handler.
It is not available during normal workflow execution.
The Activity Error object is populated automatically by the workflow engine when an activity failure redirects execution to the Custom Error Handler.