Dashboards and widgets
What it is
Section titled “What it is”A dashboard is a screen of widgets. It can be a company dashboard (seen by everyone or only some roles) or a personal one (only you). Widget types:
- Collection: records, figures and charts. Modes: value (one number), group (by category), list (latest records with columns) and trend (by day, week or month). Aggregates: count, distinct, sum, average, min and max.
- IoT: values, charts, maps, buttons and device status from MQTT.
- Script value: a number published by a script.
- Content for screens: video, image, gallery, announcement, QR or clock, fixed or from a collection with validity dates.
- Actions: buttons for daily operations (create record, next in queue, script, flow or link).
How it works
Section titled “How it works”- Open Dashboard in the menu and create one: «New company dashboard» or «New personal dashboard».
- Click Customize (Personalizar) → Add widget, choose the type and configure it (title, size from 1 to 4 columns, filters, period).
- A collection list can have actions on its rows: state transitions and row actions.
- In «Name and visibility» (Nombre y visibilidad) choose which roles see a company dashboard.
Rules and limits
Section titled “Rules and limits”- Up to 40 widgets per dashboard and 10 personal dashboards per person.
- A company dashboard requires
dashboards:editto create or change it; a personal one only needsdashboards:view. - Each person sees data with their own permissions: what they cannot read shows as «(no access)» or «—».
For agents (MCP)
Section titled “For agents (MCP)”get_dashboard_widget_guide: each widget’s shape, filters and examples; withcollectionId, the useful fields. Read it before configuring.list_dashboards,get_dashboard.create_dashboard(personal: truefor your own),update_dashboard(name, icon, roles) andset_dashboard_widgets(replaces the whole configuration: read it first withget_dashboard).