Flow Studio
Widgets Capability Overview
Embedding interactive BizFirstGO UI widgets into workflow steps — a richer alternative to Atlas Forms for complex visual interactions in the WorkDesk inbox.
Widgets vs. Forms
| Aspect | Forms Capability | Widgets Capability |
|---|---|---|
| UI complexity | Data entry fields | Full interactive UI (charts, maps, custom layouts) |
| Interaction model | Form fields + Submit button | Any user action (click, select, drag-drop) |
| Output trigger | Submit/Cancel | Any configured interaction event |
| Examples | Expense claim form | Map pin selection, data table editor, approval dashboard |
Widget Node Flow
[WidgetNode]
│ Suspends; creates inbox task
│ Passes widgetProps (workflow data) to widget
│
Actor opens task → WidgetRenderer mounts widget
│
User interacts with widget (clicks, selects, etc.)
│
Widget fires interaction event
│
WidgetRenderer calls: POST /api/executions/{id}/resume
{ action: "interaction", interactionData: { ... } }
│
[WidgetNode resumes] — interactionData is node output
Platform Widgets Available
| Widget ID | Purpose |
|---|---|
data-approval-widget | Tabular data review with row-level approve/reject |
map-location-picker | Interactive map for selecting a location |
document-reviewer | PDF/document viewer with annotation and decision capture |
comparison-widget | Side-by-side data comparison with selection |
kanban-board | Drag-and-drop card assignment |
Custom widgets: Platform teams can register custom widgets by implementing
IWidgetDefinition and providing a frontend bundle URL. See the Custom Widget page for the full implementation pattern.