Dynamische visualisatie
Gebruik deze widget wanneer het uiteindelijke widgettype of de inhoud pas tijdens runtime bepaald kan worden.
Widget reference
Element widget: Python-logica direct op je dashboard
De Element widget is de meest flexibele dashboardwidget in Dashview. Zij voert een gepubliceerd Element uit en verwacht een renderbare widgetconfig terug. Daarmee kun je dynamische widgets bouwen die standaard widgettypes slim combineren met Python-logica.
1. Wanneer kies je voor een Element widget?
Python-first logica
Geschikt voor complexe berekeningen, custom renderinglogica of output die niet netjes in een gewone chart of tabel past.
Herbruikbaar bouwblok
Wanneer hetzelfde Element ook in een automation of datasource-transform terugkomt, houd je logica gecentraliseerd.
Niet voor
Gebruik geen Element widget voor simpele KPI’s, tabellen of charts die met standaardopties al onderhoudbaar zijn.
2. Runtime-instellingen
| Optie | Verplicht | Beschrijving |
|---|---|---|
elementId | Ja | Het Element dat de widget aanstuurt. Zonder deze waarde kan de widget niet draaien. |
elementVersion | Nee | Laat leeg voor de laatste gepubliceerde versie of pin bewust een specifieke release. |
entrypoint | Nee | Override op de standaard entrypoint als je Element meerdere uitvoerpaden heeft. |
timeoutSeconds | Nee | Beschermt het dashboard tegen te lange runs; houd dit laag genoeg voor een prettige UX. |
runnerTier | Nee | Kies alleen een zwaardere tier als het Element dat echt nodig heeft. |
tableName | Nee | Naam voor inline row-output wanneer het Element naast de widgetconfig ook rijen terugstuurt. |
3. Filterdoorgifte en params
Een Element widget kan de actieve dashboardcontext meekrijgen. Dat maakt haar krachtig, maar ook gevoelig voor verkeerde aannames. Test daarom altijd met echte paginafilters.
- Schakel filterdoorgifte in wanneer het Element moet reageren op dezelfde filters als de rest van de pagina.
- Gebruik een expliciete filterbron als de widget met een specifieke datasourcecontext moet werken.
- Gebruik een duidelijke
filters-sleutel of eigen param key zodat collega’s meteen begrijpen wat er wordt doorgegeven. - Extra params moeten een JSON-object zijn. Gebruik geen losse array of scalar als rootwaarde.
{
"from": "2026-03-01",
"to": "2026-03-31",
"segment": "enterprise",
"showWarnings": true
}4. Resultaatcontract
Wat het Element terug moet geven
- Een renderbare widgetconfig, meestal onder
result.widget. - Optioneel extra rows of feed-data als de uiteindelijke widget die zelf nodig heeft.
- Een stabiele, begrijpelijke outputvorm zodat het dashboard voorspelbaar blijft bij volgende releases.
Wat je beter vermijdt
- Een tweede Element widget als resultaat. Dat maakt de runtimeketen onnodig moeilijk te begrijpen.
- Te zware of te trage renderlogica voor elke dashboardrefresh.
- Verborgen afhankelijkheden van secrets, runtime vars of filters zonder documentatie.
5. Aanbevolen werkwijze
- Bouw en test het Element eerst los in de Elements-sectie.
- Publiceer daarna pas een stabiele versie.
- Koppel die gepubliceerde versie in de widget-editor.
- Controleer met echte dashboardfilters en tenantrechten of de widget exact de verwachte output geeft.
- Gebruik een pinned versie voor kritische dashboards wanneer voorspelbaarheid belangrijker is dan automatisch meeliften op de laatste publish.
6. Veelvoorkomende problemen
| Probleem | Wat meestal helpt |
|---|---|
| Widget slaat niet op | Controleer of elementId gevuld is en extra params geldig JSON-object zijn. |
| Runtimefout bij openen dashboard | Controleer publish-status, runtime vars/secrets en of het Element nog een geldige widgetconfig retourneert. |
| Output verandert onverwacht | Pin een specifieke elementVersion in plaats van altijd de nieuwste release te gebruiken. |
| Filters lijken niet mee te gaan | Controleer filterdoorgifte, filterbron en de sleutel waaronder filters in params belanden. |
7. Editoruitleg
Element widget editor
- Kies eerst het juiste Element en beslis daarna of je een vaste versie wilt pinnen.
- Timeout, filterdoorgifte en JSON-params bepalen het runtimegedrag van de widget.
- Test altijd de uiteindelijke widgetoutput op de pagina, niet alleen het losse Element.