The Automation widget runs an automation every time the widget renders and displays whatever the automation returns. The automation has complete control over the output, so this widget is the most flexible – use it when none of the built-in widgets quite fit.

Typical uses include custom HTML layouts, embedded third-party data, conditional dashboards that change shape based on a worker's role, or composite views that combine several data sources into a single block.

Configuration

The configuration is a KATA event handler for the ui.widget render event. Use the toolbar's Automation button to insert a new handler. Each handler chooses an automation to run and optionally passes inputs to it.

The selected automation should return content suitable for inline rendering – typically HTML, but the automation can also drive charts and interactive controls through Cerb's standard rendering helpers.

Because handlers can be conditional, a single widget can pick between automations based on the current worker, dashboard prompts, or any other placeholder.

See ui.widget for a worked example.