Dashboard builder

Filters: volledige setting reference

Deze pagina documenteert alle velden uit Edit Page Filters: type, value type, datasource-scope, option source, defaults, date/number-range opties en compare-set gedrag.

Workflow Filtervelden Default values Type-specifiek Runtime filterbar

1. Workflow

Open dashboard in edit mode.
Klik Edit Filters.
Voeg filters toe met Add Filter.
Koppel bronnen, fields en defaults.
Klik Apply en test in filterbar.

Filters-editor screenshot placeholder — De editor bepaalt het contract tussen paginastate, widgets en eventuele datasource-requests.

Runtime filterbar screenshot placeholder — Dit is de dagelijkse runtimeweergave voor eindgebruikers; houd hem compact en voorspelbaar.

2. Filtervelden (setting-by-setting)

Key	Type	Beschrijving
`key`	string	Stabiele logische filter-id voor filterstatus, defaults en placeholders zoals `@filters.dateFrom`. Dit hoeft geen bronkolom te zijn.
`type`	string	Toegestane waarden: `single`, `multi`, `date-range`, `number-range`. Controltype in filterbar.
`valueType`	string	Toegestane waarden: `string`, `number`, `decimal`, `currency`, `percent`, `date`, `datetime`, `time`, `html`. Coercion voor filterwaarden.
`label`	string	Display label.
`placeholder`	string	Placeholder in control.
`labelIcon`	string	PrimeIcon class voor label.
`applyFields[]`	string[]	Werkelijke datasourcevelden waarop het filter wordt toegepast; leeg = gebruik `key` als veld.
`applyFieldsMode`	string	Toegestane waarden: `and`, `or`. Alle velden matchen of een van de velden.
`dataSourceUid` / `dataSourceUids[]`	string / string[]	Bronnen waarop filter wordt toegepast.
`optionsDataSourceUid` / `optionsDataSourceUids[]`	string / string[]	Bronnen waar Dashview optiewaarden uit laadt; leeg = zelfde als data sources. Dit bepaalt niet waar het filter wordt toegepast.
`optionsValueField`	string	Kolom waaruit selectiewaarden worden geladen; leeg = gebruik `applyFields`, daarna `key`.
`optionsLabelField`	string	Kolom voor option labels.
`optionsFilter`	object	Extra filter op option-load query.
`hidden`	boolean	Filter actief houden maar verbergen in filterbar.
`viewOnly`	boolean	Alleen doorgeven aan views, niet direct naar datasource queries.

Key, filterveld en optiewaardeveld

key is de logische filter-id. Gebruik een stabiele naam zoals date, customer of region; dit hoeft geen datasourcekolom te zijn.
dataSourceUid(s) plus applyFields bepalen waar het filter op wordt toegepast in datasource-queries.
optionsDataSourceUid(s) plus optionsValueField bepalen waar keuzewaarden voor selectie-filters vandaan komen. Laat optionsValueField leeg om applyFields te gebruiken, en daarna key als fallback.
optionsLabelField is alleen de displaytekst voor opties; de werkelijke filterwaarde blijft uit optionsValueField, applyFields of key komen.

Validatie

Combinatie key + datasource-targets moet uniek zijn.
optionsFilter moet een JSON object zijn.
Bij multi-field apply-mode is and/or beschikbaar vanaf 2 velden.
Je kunt hier gewone datasources en direct gepubliceerde Element-datasources door elkaar gebruiken.

3. Default values schema

Filter type	Default keys in `filtersDefaults`	Waardevorm
`single`	`key`	Array met 1 coerced waarde.
`multi`	`key`	Array met meerdere coerced waardes.
`date-range`	`keyFrom`, `keyTo` of `keyPreset`	ISO datums; `keyTo` is de exclusieve bovengrens.
`number-range`	`keyFrom`, `keyTo`	Numerieke waarden.

Extra defaults JSON

De editor ondersteunt aanvullende defaults via een los JSON-object. Dit object wordt samengevoegd met automatisch gegenereerde defaults per filter.

4. Type-specifieke instellingen

Date-range

date-range slaat keyTo direct op als exclusieve bovengrens: 25-03-2026 t/m 25-03-2026 wordt dus keyFrom=2026-03-25 en keyTo=2026-03-26.
Preset support via keyPreset en runtime date preset util.
Custom range via keyFrom/keyTo.

Number-range

numberRangeAllowDecimal en numberRangeDecimalPlaces.
numberRangeMin, numberRangeMax, numberRangeStep.
numberRangeDefaultsFromData voor auto min/max defaults.

5. Runtime filterbar, presets en compare sets

Filterbar functies

Global search (q).
Preset opslaan/laden/verwijderen.
Filterset delen via URL/state.
Reset en set toevoegen.

Compare sets

Meerdere sets naast elkaar voor vergelijking.
Widgets met compare support tonen set-delta's direct.
KPI, chart en table comparison opties bouwen hierop voort.