Dashview Docs

Admin reference

Tenant Config: tenantbrede instellingen

In Administration → Config beheer je tenant-brede branding, thema, default formats, rapportkleuren en notificatie-e-mail voor de normale tenant-admin frontend.

Overzicht Branding Globale regels Default formats Zoeken Uplink API keys Git sync Theme presets Theme keys Rapportkleuren Notificatie-e-mail Technische referentie

1. Config onderdelen

Tenantconfig overzicht
Deze pagina bundelt tenantbrede instellingen en werkt dus niet op individueel gebruikersniveau.

Secties in de UI

  • Branding en typografie
  • Globale weergaveregels
  • Standaardnotaties
  • Uplink API-sleutels
  • Git sync en tenantbrede repo-instellingen
  • Themapresets en preview
  • Licht en donker thema met groepen voor foundation, navigatie, controls, statussen, formulieren, vlakken/effecten en Dashbot
  • Rapportkleuren
  • Notificatie-e-mail

Deze handleiding volgt alleen de secties en velden die in de normale tenant-admin frontend zichtbaar zijn.

2. Branding en typografie

UI veld Payload key Beschrijving
Tenant namenameWeergavenaam van de tenant.
LogologoUrlTopbar logo als URL of inline SVG.
Naam naast logo tonenshowTenantNameWithLogoStandaard aan. Schakel uit om alleen het logo in de topbar en mobiele navigatie te tonen.
Font familyfontFamilyBasisfont voor de UI.
Heading font familyheadingFontFamilyOptioneel afwijkend font voor koppen.
Monospace fontmonoFontFamilyFont voor code en editorinhoud.
Base font scalefontScaleGlobale fontschaal voor de hele omgeving.
Afronding hoekenborderRadiusSchuifregelaar voor een basishoekradius van 0 tot en met 30 pixels. 0 maakt de gethematiseerde hoeken vierkant; hogere waarden schalen panelen, formulieren, knoppen, badges en andere afgeronde UI-elementen mee. Toggleknoppen en schakelaars behouden hun standaard afronding.

Gebruik deze sectie voor naam, logo, typografie en vormgeving die direct door de frontend worden overgenomen. Zonder opgeslagen waarde gebruikt Dashview de bestaande basisradius van 8px.

3. Globale weergaveregels

Page color rules

  • Rule kind value of range.
  • Gebruik dit om paginakoppen of badges tenantbreed consistent te kleuren.
  • Handig voor statusvelden zoals kritiek, waarschuwing of percentageranges.

Page value rules

  • Ondersteunt exact en regex matching.
  • Kan tekst, HTML, SVG, PNG of icon-uitvoer teruggeven.
  • Gebruik dit voor consistente vervanging van bekende waarden of statussen.

Default chart colors

  • Fallback kleurenpalet voor charts wanneer pagina of widget geen eigen kleuren opgeeft.
  • Datasets pakken kleuren in volgorde uit deze lijst.
  • In de theme-editor staat dit palet nu onder de subtab Widgets, niet meer onder Foundation.

JSON editors

  • Een aantal configuraties heeft zowel formuliervelden als raw JSON.
  • Ongeldige JSON blokkeert opslaan.
  • Gebruik raw JSON alleen wanneer je veel regels tegelijk wilt plakken of herstructureren.

4. Standaardnotaties

Key Gebruik
uiLanguageToegestane waarden: nl, en. Volledige producttaal van deze tenant.
defaultNumberLocaleLocale voor getalnotatie, bijvoorbeeld nl-NL.
defaultNumberDigitsStandaard Angular digitsInfo voor getallen en percentages.
defaultCurrencyCodeFallback valuta zoals EUR.
defaultCurrencyDisplayToegestane waarden: symbol, code, symbol-narrow. Weergave als symbool, code of smal symbool.
defaultDateFormatStandaard datumformat voor widgets en detailweergaven.
defaultDatetimeFormatStandaard datetimeformat.
defaultTimeFormatStandaard tijdnotatie.
timeZoneTenantbrede IANA-timezone, vooral relevant voor achtergrondruns, rapporten en niet-browserflows.

Git sync

Git sync koppelt de ene live tenantconfiguratie aan een externe repository. Configureer hier alleen de remote URL, standaardbranch en GitHub-authenticatie.

Niet-technische gebruikers werken met Concept, Preview, Controleren, Publiceren en Verwijderen. Technische gebruikers kunnen dezelfde repo daarnaast normaal clonen, branchten en pushen.

6. Themapresets en preview

Preset kiezen

  • Gebruik een preset als startpunt voor light en dark mode.
  • Pas daarna handmatig details aan voor topbar, sidebar, controls, widgets, statussen, vlakken en tabellen.

Preview en generator

  • De knop Preview tonen opent een los previewvenster.
  • Klik op onderdelen in de preview om direct naar het juiste themaveld te springen.
  • De zichtbaarheid en positie worden per gebruiker onthouden.
  • De sectie bevat ook een 4-kleuren generator om in één stap een light, dark of gecombineerd thema op te bouwen.
Preview eerst, sla daarna pas op als de tenantkleuren in alle kerncomponenten logisch blijven.

7. Theme key reference (light & dark)

Dezelfde themavelden bestaan voor theme.light en theme.dark. In de UI werk je per modus met groepen zoals foundation, topbar/navigatie, tabellen, knoppen, widgets, notificaties, statussen, formulieren, vlakken/effecten en Dashbot.

Theme key Gebruik
primary, secondaryHoofdaccenten voor knoppen, links en actieve staten.
topbarBackground, topbarEditBackground, topbarText, topbarButton*, topbarBadgeBackgroundTopbar basisstijl en knoppen. topbarEditBackground geeft de dashboard-editbalk in de topbar een eigen achtergrond; zonder waarde valt deze terug op de pagina-achtergrond.
pageBackground, pageText, pageSecondaryTextHoofdachtergrond, standaard tekstkleur en secundaire tekstkleur voor subtitels en muted tekst.
sidebarBackground, sidebarText, sidebarCategoryText, sidebarHoverBackground, sidebarTextActiveZijbalkkleuren en hover/actieve staten. sidebarCategoryText stuurt apart de sectiekoppen zoals Pages, Tasks en Admin.
defaultChartColorsFallback grafiekkleuren voor chartwidgets. In de editor vind je dit onder Widgets.
kpiComparePositiveBackground, kpiComparePositiveText, kpiComparePositiveIcon, kpiCompareNegativeBackground, kpiCompareNegativeText, kpiCompareNegativeIconKleuren voor KPI-vergelijkingschips en pijliconen. Deze gelden ook wanneer een KPI-widget de compare-kleuren omdraait.
notificationInfo*, notificationLow*, notificationMedium*, notificationHigh*, notificationCritical*Kleuren voor notificatie-severity labels. Info en laag hebben aparte velden zodat informatieve meldingen en lage prioriteit verschillend gestyled kunnen worden.
tableHeader*, tableScrollbar*, tableCellProgress*Tabelheaders, scrollbar en celprogressie.
buttonBackground, buttonText, buttonHoverBackground, buttonOutlinedText, buttonOutlinedHoverTextPrimaire knopstijl. buttonText en buttonHoverText gelden voor gevulde/opaque knoppen; de outlined keys sturen alleen de tekst van omlijnde knoppen. De rand van een outlined knop volgt buttonBackground en gebruikt buttonHoverBackground voor de hoverweergave.
buttonSecondary*, buttonSuccess*, buttonWarn*, buttonInfo*, buttonDanger*, buttonError*, buttonHelp*, buttonContrast*Variantspecifieke knopkleuren met aparte normale/hoverteksten voor opaque en outlined varianten. De rand van iedere outlined variant volgt de eigen achtergrond- en hoverachtergrondkleur, niet de opaque tekstkleur.
form*, popoverBackground, select*, multiselect*, toggle*Gedeelde control-styling voor formulieren, popovers, dropdownpanelen, geselecteerde opties, chips en toggles. popoverBackground stuurt rechtstreeks de PrimeNG-token --p-popover-background.
surfaceMutedBackground, panel*, dialog*Semantische surfaces voor panels, dialogs en gedempte contentblokken.
codeEditor*SQL-, JSON- en notebook-codevlakken, inclusief shell, editorvlak, gutter, selectie en actieve regel.
codeToken*Syntaxkleuren voor codefragmenten zoals keywords, numbers, strings, comments, types, functies, operators, punctuation, metadata en invalid tokens.
statusSuccess*, statusWarning*, statusError*, statusInfo*, statusMuted*, statusSelected*Semantische statuskleuren voor chips, lege staten, selecties, feedback en widgetstatussen.
dashbotAssistantBubble*, dashbotUserBubble*Kleuren voor Dashbot-berichten.

Volledige lijst met opgeslagen light/dark keys

Zowel theme.light als theme.dark accepteert dezelfde 220 keys hieronder. Dit zijn de exacte opgeslagen namen voor de API en Dashview MCP; labels in de UI kunnen korter zijn. 

boxShadowBlur
boxShadowColor
boxShadowOffsetX
boxShadowOffsetY
boxShadowOpacity
boxShadowSpread
browserScrollbarThumb
browserScrollbarTrack
buttonBackground
buttonContrastBackground
buttonContrastHoverBackground
buttonContrastHoverText
buttonContrastOutlinedHoverText
buttonContrastOutlinedText
buttonContrastText
buttonDangerBackground
buttonDangerHoverBackground
buttonDangerHoverText
buttonDangerOutlinedHoverText
buttonDangerOutlinedText
buttonDangerText
buttonErrorBackground
buttonErrorHoverBackground
buttonErrorHoverText
buttonErrorOutlinedHoverText
buttonErrorOutlinedText
buttonErrorText
buttonHelpBackground
buttonHelpHoverBackground
buttonHelpHoverText
buttonHelpOutlinedHoverText
buttonHelpOutlinedText
buttonHelpText
buttonHoverBackground
buttonHoverText
buttonInfoBackground
buttonInfoHoverBackground
buttonInfoHoverText
buttonInfoOutlinedHoverText
buttonInfoOutlinedText
buttonInfoText
buttonOutlinedHoverText
buttonOutlinedText
buttonSecondaryBackground
buttonSecondaryHoverBackground
buttonSecondaryHoverText
buttonSecondaryOutlinedHoverText
buttonSecondaryOutlinedText
buttonSecondaryText
buttonSuccessBackground
buttonSuccessHoverBackground
buttonSuccessHoverText
buttonSuccessOutlinedHoverText
buttonSuccessOutlinedText
buttonSuccessText
buttonText
buttonWarnBackground
buttonWarnHoverBackground
buttonWarnHoverText
buttonWarnOutlinedHoverText
buttonWarnOutlinedText
buttonWarnText
codeEditorActiveLineBackground
codeEditorBackground
codeEditorBorderColor
codeEditorGutterBackground
codeEditorGutterText
codeEditorSelectionBackground
codeEditorShellBackground
codeEditorText
codeTokenComment
codeTokenFunction
codeTokenInvalid
codeTokenKeyword
codeTokenMeta
codeTokenNumber
codeTokenOperator
codeTokenPunctuation
codeTokenString
codeTokenType
dashbotAssistantBubbleBackground
dashbotAssistantBubbleBorderColor
dashbotAssistantBubbleText
dashbotUserBubbleBackground
dashbotUserBubbleBorderColor
dashbotUserBubbleText
defaultChartColors
dialogBackground
dialogBorderColor
dialogFooterBackground
dialogHeaderBackground
dialogText
filterSetBackground
filterSetPalette
footerBackground
footerLink
footerLinkHover
footerText
formBackground
formBorderColor
formHoverBorderColor
formPlaceholderColor
glassBlur
glassBorder
glassHighlight
glassSaturation
glassShadow
glassTint
glassTintStrong
gridLineColor
kpiCompareNegativeBackground
kpiCompareNegativeIcon
kpiCompareNegativeText
kpiComparePositiveBackground
kpiComparePositiveIcon
kpiComparePositiveText
link
linkActive
linkHover
multiselectChipBackground
multiselectChipText
notificationCriticalBackground
notificationCriticalBorder
notificationCriticalText
notificationHighBackground
notificationHighBorder
notificationHighText
notificationInfoBackground
notificationInfoBorder
notificationInfoText
notificationLowBackground
notificationLowBorder
notificationLowText
notificationMediumBackground
notificationMediumBorder
notificationMediumText
pageBackground
pageSecondaryText
pageText
panelBackground
panelBorderColor
popoverBackground
primary
repeaterRowBackground
secondary
selectIconColor
selectOptionHoverBackground
selectOptionHoverText
selectOptionSelectedBackground
selectOptionSelectedText
selectPanelBackground
selectPanelText
sidebarActiveBackground
sidebarBackground
sidebarCategoryText
sidebarHoverBackground
sidebarOpacity
sidebarText
sidebarTextActive
sidebarTextHover
skeletonBackground
skeletonHighlight
statusErrorAccent
statusErrorBackground
statusErrorBorder
statusErrorText
statusInfoAccent
statusInfoBackground
statusInfoBorder
statusInfoText
statusMutedAccent
statusMutedBackground
statusMutedBorder
statusMutedText
statusSelectedAccent
statusSelectedBackground
statusSelectedBorder
statusSelectedText
statusSuccessAccent
statusSuccessBackground
statusSuccessBorder
statusSuccessText
statusWarningAccent
statusWarningBackground
statusWarningBorder
statusWarningText
surfaceCardBackground
surfaceMutedBackground
tableAlternateRowBackground
tableCellProgressFill
tableCellProgressOpacity
tableFooterBackground
tableFooterText
tableHeaderBackground
tableHeaderHoverBackground
tableHeaderSelectedBackground
tableHeaderSelectedText
tableHeaderText
tableRowBackground
tableRowHighlightBackground
tableScrollbarThumb
tableScrollbarTrack
tableScrollbarWidth
toggleBackground
toggleCheckedBackground
toggleHandleBackground
toggleHandleCheckedBackground
topbarBackground
topbarBadgeBackground
topbarButtonBackground
topbarButtonHoverBackground
topbarButtonText
topbarButtonTextHover
topbarEditBackground
topbarText
topbarTextHover
widgetBackground
widgetBorderColor
widgetBorderWidth
widgetOpacity

8. Rapportkleuren

9. Notificatie-e-mail

Wat tenant-admins beheren

  • Tenantnotificatie-e-mail inschakelen voor de tenantconfiguratie.
  • Onderwerp-prefix voor uitgaande rapport- en notificatiemails.
  • Optionele templates voor scheduled report, task en direct notification.
  • Token-insertie via klik of drag-and-drop naar onderwerp, HTML of platte tekst.

Beheeradvies

  • Werk vooral aan enable/disable, subject prefix en de inhoudelijke templates.
  • Gebruik tokens consequent in onderwerp, HTML en plain-text varianten.
  • Verstuur na wijziging een testnotificatie of geplande rapportmail om HTML en plain-text fallback te controleren.

10. Technische referentie

Dashview MCP-tools

  • view_tenant_display_config() retourneert de scoped bewerkbare displayconfiguratie plus het allowlist-schema.
  • update_tenant_display_config(patch) past een gedeeltelijke patch toe en bewaart overige tenantinstellingen.
  • De arrays schema.theme.light en schema.theme.dark bevatten alle 220 exacte schrijfbare keys per modus; schema.theme.report bevat de 8 rapportkeys.
  • De tools draaien in de context van de huidige gebruiker en volgen de tenant en actieve wijzigingsset die in de frontend zijn geselecteerd.

Toegestane scope

  • Branding en typografie: name, logoUrl, showTenantNameWithLogo, fontFamily, headingFontFamily, monoFontFamily, fontScale.
  • Standaardformaten onder defaultFormats.
  • Displaykleuren onder theme.light, theme.dark en theme.report.
  • Globale displayregels: pageColorRules, pageValueRules en defaultChartColors.
De scoped MCP-tools stellen gevoelige of operationele tenantconfiguratie zoals llm, notifications, uplinkApiKeys, search en mapId bewust niet beschikbaar.