Process Instances Widget
The Process Instances widget displays the instances of a specific BPMN process directly on the dashboard. Filtering by status is available: running, completed, failed, or cancelled instances.
This provides an overview of process activity without navigating to the Process Explorer.
Typical Use Cases
| Use Case | Description |
|---|---|
| Pending approvals | Overview of all open approval processes (leave, procurement, etc.). |
| Order processing | How many orders are currently being handled? |
| Failed processes | Immediately spot when an automated process has errored. |
| Onboarding status | Which new employees are currently going through onboarding? |
| Invoice generation | All running invoice creation workflows at a glance. |
| QA inspections | How many quality checks are currently in progress? |
Features
- Status filter: One or more statuses can be selected (e.g., only running instances).
- Direct link: Clicking an instance opens the detail view in the Process Explorer.
- Sorting: Instances are sorted by start date by default.
- Real-time updates: New instances and status changes are displayed automatically.
Configuration
The following settings are configured in the properties panel:
- Process: Which BPMN process should provide the instances?
- Status filter: Which instance statuses should be visible?
- Running
- Completed
- Failed
- Cancelled
Available Statuses
| Status | Description |
|---|---|
| Running | The instance is currently being executed. |
| Completed | The instance finished successfully. |
| Failed | The instance ended with an error. |
| Cancelled | The instance was manually cancelled. |
Example
A team lead has a widget displaying all running instances of the "Goods Receipt Inspection" process. At a glance, they can see how many inspections are currently in progress and can open individual instances directly.
Tips
- Multiple widgets per process: For the same process, multiple widgets with different status filters can be set up – e.g., one for running and one for failed instances.
- Monitor failed instances: A dedicated widget for failed instances helps identify problems quickly.