Database-referentie (.base)

Laatst bijgewerkt: 2026-11-03

Deze pagina somt op wat een .base-bestand allemaal kan bevatten en wat Plainva met elk onderdeel doet: elke sleutel op het hoogste niveau, elke filtervorm, elk weergavetype met zijn opties, samenvattingen, sortering, beperkingen, wat er gebeurt met sleutels die Plainva niet kent, en waar Plainva zich anders gedraagt dan Obsidian Bases. De pagina beschrijft wat de code van Plainva vandaag leest, evalueert en schrijft — niet de documentatie van Obsidian.

Lees voor dagelijks gebruik eerst Databases (.base). De regels die een tool moet aanhouden wanneer hij vaultbestanden rechtstreeks schrijft, en het volledige relatievoorbeeld, staan in de Bestandsformaat-referentie.

In één oogopslag

Onderdeel van het bestandWat Plainva doet
filtersLeest en past de bronnen (map, tag) en de voorwaarden toe die onder Filters staan
viewsLeest alle acht weergavetypen, hun volgorde, sortering, filters en samenvattingen
propertiesLeest het kolomschema, de weergavenaam en het plainva-blok van Plainva
summaries (weergave)Berekent de veertien ingebouwde samenvattingen
formulasBewaart ze in het bestand, berekent ze niet
summaries (hoogste niveau)Bewaart eigen samenvattingsformules, berekent ze niet
thisNog niet ondersteund
Andere sleutelsBewaart ze in het bestand (zie Sleutels die Plainva niet kent)

Sleutels op het hoogste niveau

Een .base-bestand is YAML met deze sleutels op het hoogste niveau. Ze zijn allemaal optioneel; een bestand zonder views opent met één tabel.

SleutelInhoudIn Plainva
filtersWelke notities bij de database horen (bronnen)Gelezen en toegepast
propertiesEén item per kolom, met de eigenschaps-id als sleutelGelezen; de toevoegingen van Plainva staan in zijn plainva-blok
viewsDe lijst met weergavenGelezen; elke weergave heeft een name nodig
formulasObsidian-formules, name: expressionOngewijzigd bewaard, niet berekend
summariesEigen samenvattingsformules van ObsidianOngewijzigd bewaard, niet berekend

Plainva schrijft nooit een andere sleutel op het hoogste niveau: Obsidian weigert een .base te openen met een sleutel die het niet kent. Een sleutel columns: op het hoogste niveau, zoals zeer oude Plainva-versies die schreven, wordt nog steeds gelezen en bij het volgende opslaan van het bestand naar properties verplaatst.

Eigenschappen (properties)

Eigenschaps-id’s

Een eigenschaps-id geeft een kolom een naam. Er zijn drie soorten:

IdBetekentVoorbeeld
note.<key>Een sleutel van de frontmatter van de notitiesnote.status
file.<field>Een feit over het bestand (zie Bestandsvelden)file.mtime
formula.<name>Een Obsidian-formule uit formulasformula.price_per_unit

De sleutels van properties, de order van een weergave en sort[].property gebruiken deze id’s. In een filteruitdrukking en in een plainva-blok wordt een frontmattersleutel kaal geschreven (status); een filteruitdrukking begrijpt ook note.status.

Schrijft een notitie een sleutel in een andere schrijfwijze dan de kolom (Due tegenover de kolom due), dan toont Plainva de waarde toch in die kolom en schrijft het wijzigingen terug onder de eigen schrijfwijze van de notitie.

Weergavenaam

properties.<id>.displayName is het kolomlabel van Obsidian. Plainva toont het als kolomkop en bewaart het. Zonder dit label toont een frontmattersleutel een hoofdletter vooraan (alleen op het scherm); de bestandsvelden hebben hun eigen namen, bijvoorbeeld Naam, Gewijzigd, Grootte, Pad, Takenlijst en Dag uit de bestandsnaam.

Het plainva-blok van een kolom

Alles wat Plainva aan een kolom toevoegt, staat onder properties.<id>.plainva. Obsidian negeert het.

SleutelWaardeBetekenis
inputeen veldtype (lijst hieronder)Het veldtype van de kolom
ratingMaxgetal, 1 tot 10Uit hoeveel tekens een beoordeling bestaat (standaard 5)
ratingGlyphéén tekenHet teken dat een beoordeling tekent (standaard een punt)
optionslijst met optiesVaste waarden voor selectie, status en multiselectie
relationBase.base-pad ten opzichte van de vaultDe database waarnaar een relatie verwijst
relationLimitoneEen relatie bevat precies één link; ontbreekt de sleutel, dan is er geen limiet
reverseOf{ base, property }Een berekende kolom voor een omgekeerde relatie
rollup{ through, of, fn, where }Een berekende aggregatiekolom (zie Aggregaties)
previousKeyslijst met maximaal 8 vroegere namenLaat opmerkingen een hernoemde kolom terugvinden

Veldtypen (input)

text, number, rating, checkbox, date, datetime, select, status, multiselect, list, tags, url, email, phone, relation.

Twee oudere schrijfwijzen worden ook gelezen: multi-select als multiselect en link als relation. Een kolom zonder input — of met een waarde die niet in deze lijst staat — krijgt zijn type uit de waarden in de notities: true/false is een selectievakje, een getal een getal, een lijst met [[links]] een relatie, 2026-07-03 een datum, een webadres een URL, enzovoort. Een kolom voor een omgekeerde relatie en een aggregatiekolom hebben geen input.

Opties en kleuren

Een optie is { value, label, color, group }; alleen value is verplicht. color is een van de paletnamen gray, teal, blue, green, amber, coral, purple, pink — een onbekende naam valt terug op een kleur die van de waarde wordt afgeleid. group wordt alleen door Status gebruikt: opties met dezelfde groep vormen een fase. Een gewone tekenreeks wordt gelezen als een optie met die waarde.

Aggregaties

Een aggregatiekolom berekent een waarde uit de notities waar een linkkolom van deze database naar verwijst. De waarde staat in geen enkel bestand.

Een aggregatie waarvan een verplicht onderdeel ontbreekt, of die een functie noemt die niet in deze lijst staat, wordt genegeerd: de kolom blijft leeg en de database opent gewoon. Een aggregatie via een andere berekende kolom blijft ook leeg.

Bestandsvelden (file.*)

Deze waarden komen uit het bestand, niet uit de frontmatter. Elke rij van een database draagt het volgende:

VeldWaarde
file.nameDe eigenschap title van de notitie als die er is, anders de bestandsnaam zonder .md
file.pathHet pad ten opzichte van de vault
file.mtimeLaatst gewijzigd, in milliseconden
file.ctimeAangemaakt, in milliseconden, als het bestandssysteem dat meldt
file.sizeGrootte in bytes
file.tagsAlle tags van de notitie, uit frontmatter en tekst, elk met #; gevuld wanneer een filter, een prikbord of een weergave die de kolom toont of erop sorteert ze nodig heeft
file.tasksVoortgang van de selectievakjes als done/total; gevuld voor borden en voor een weergave die de kolom toont
file.dayDe dag waar de bestandsnaam van een dagnotitie voor staat, volgens de map en het formaat van de vault; alleen-lezen, en alleen het datumveld van een kalender of tijdlijn kan het gebruiken
file.revisionEen interne wijzigingsmarkering; reken er niet op

file.folder werkt als bron (zie Bronnen) maar is geen kolom. file.basename, file.ext, file.links, file.backlinks, file.embeds, file.properties en file.file worden niet geleverd: een kolom met een van deze velden blijft leeg, en een filter leest ze als leeg.

Filters

Waar filters staan

De filters op het hoogste niveau bevatten de bronnen — welke notities bij de database horen. Elke weergave kan haar eigen filters dragen met voorwaarden die alleen die weergave verder beperken; Plainva schrijft de voorwaarden daar. Beide niveaus gelden samen. Voorwaarden die een bestand op het hoogste niveau bewaart, werken nog steeds; bij het volgende opslaan in Plainva worden ze naar elke weergave verplaatst.

Bronnen

BronUitdrukking
Mapfile.folder == "Projects/Active" — de map en al haar submappen; "" en "/" zijn de hele vault
Tagfile.hasTag("project") — de notitie draagt precies deze tag; een voorafgaande # wordt genegeerd

Meerdere bronnen worden met and of or gecombineerd, net als elke andere voorwaarde. Een database zonder bronnen bevat elke notitie van de vault. Bijlagen, de gereserveerde index.md en log.md, en bestanden of mappen waarvan de naam met een punt begint, zijn nooit rijen.

Voorwaarden

Een voorwaarde is een tekenreeks. Waarden staan tussen dubbele aanhalingstekens; \" en \\ escapen een aanhalingsteken en een backslash. De eigenschap wordt kaal of met note. geschreven.

VoorwaardeUitdrukking
isstatus == "Done"
is nietstatus != "Done"
bevatcontains(labels, "urgent") of labels.contains("urgent")
bevat niet!contains(labels, "urgent") of !labels.contains("urgent")
groter dan, kleiner daneffort > "3", effort < "8"
minstens, hoogstensdue >= "2026-07-01", due <= "2026-07-31"
is leegstatus == "" of status.isEmpty()
is niet leegstatus != "" of !status.isEmpty()
heeft een tagfile.tags.contains("#work"), met ! ontkend
headerkleur, pictogramnote.plainva.header_color == "#2a7f7b", note.plainva.icon == "lucide:pin"

Hoe waarden worden vergeleken

and, or, not

Een filters-object heeft op elk niveau precies één van and, or en not; de items zijn voorwaardetekenreeksen of verdere filterobjecten.

SleutelKomt overeen wanneer
andelk item overeenkomt
orminstens één item overeenkomt
notgeen enkel item overeenkomt

Plainva evalueert elke diepte. Het filterpaneel bewerkt één niveau groepen onder Alle of Minstens één (Groep toevoegen); een diepere structuur verschijnt als Complex filter (niet bewerkbaar), blijft in het bestand staan en wordt toegepast — een voorwaarde daarin die Plainva niet kan lezen, wordt eronder als niet toegepast genoemd. Een ouder bestand met and en or naast elkaar op één niveau wordt gelezen als “alles van and en één van or” en bij het volgende opslaan in de geldige vorm geschreven.

Wat Plainva niet kan lezen

Alleen de vormen in de twee tabellen hierboven worden begrepen. Al het andere — file.inFolder(…), file.hasLink(…), file.hasProperty(…), een getal zonder aanhalingstekens (price > 2), && en || binnen één tekenreeks, rekenkunde, datumfuncties zoals now(), of this — blijft in het bestand staan en wordt in het filterpaneel getoond zoals het er staat, met de opmerking Niet toegepast: Plainva kan deze voorwaarde niet lezen, dus ze filtert niets. De weergave toont dan meer notities dan hetzelfde filter in Obsidian.

Formules

Plainva berekent geen Obsidian-formules. formulas blijft ongewijzigd in het bestand staan, en een kolom formula.<name> in de order van een weergave wordt zonder waarden getoond. Tabel exporteren → Formules (.base) schrijft sommige aggregaties als formules, zodat Obsidian ze kan berekenen (zie Databases).

Weergaven

Sleutels van elke weergave

SleutelWaardeIn Plainva
typetable, list, cardsHet weergavetype; zie de volgende tabel
nametekstVerplicht; Plainva geeft een weergave zonder naam er bij het opslaan een
orderlijst met eigenschaps-id’sDe zichtbare kolommen, in deze volgorde
sortlijst met { property, direction }Sorteerregels, ASC of DESC
filtersfilterobjectDe eigen voorwaarden van de weergave
summariesmap van eigenschaps-id → naam van de samenvattingDe kolomvoet van elke kolom
plainvamapDe weergaveopties van Plainva, hieronder

De acht weergavetypen

Obsidian kent table, list en cards. De andere weergavetypen van Plainva worden opgeslagen als type: table plus plainva.render, zodat Obsidian ze als tabel toont.

Weergavetypetype op schijfplainva.render
Tabel (table)table—
Lijst (list)list—
Galerij (gallery)cards—
Bord (board)tableboard
Kalender (calendar)tablecalendar
Tijdlijn (timeline)tabletimeline
Graaf (graph)tablegraph
Prikbord (pinboard)tablepinboard

Bord, Kalender, Tijdlijn, Graaf en Prikbord worden alleen als Weergavetype aangeboden zolang Plainva-extensies voor .base-bestanden toestaan aan staat. Een type dat Plainva niet kent, wordt als tabel getoond en blijft zoals het er staat in het bestand totdat je een ander Weergavetype kiest.

Weergaveopties (views[i].plainva)

Binnen het plainva-blok wordt een eigenschap kaal geschreven (status), niet als note.status.

SleutelWeergavetypenWaarde
renderBord, Kalender, Tijdlijn, Graaf, PrikbordHet weergavetype, zie hierboven
groupByBordDe eigenschap waaruit de kolommen bestaan; zonder deze de eigenschap van de eigen groupBy van Obsidian voor de weergave
boardLaneByBordEen tweede eigenschap voor Banen op
boardWipLimitsBordMap van kolomwaarde → maximaal aantal kaarten (WIP-limiet), gehele getallen boven 0
boardColorModeBordcolumn tint de hele kolom; ontbreekt de sleutel, dan alleen de chip in de kop
boardColumnOrderBordHandmatige kolomvolgorde; __UNGROUPED__ is de kolom zonder waarde
colorByBord, TijdlijnKaarten en balken nemen de optiekleur van deze eigenschap over (Kleur op)
dateFieldKalender, TijdlijnDe startdatum (Datumveld, Startdatum); een datumeigenschap of file.day
endFieldKalender, TijdlijnDe Einddatum
coverImageGalerijDe eigenschap met de Omslagafbeelding
subItemsPropertyTabelDe bovenliggende relatie voor Subitems
widthsTabelMap van kolom → breedte in pixels
dateFormatallelong, iso of relative; ontbreekt de sleutel, dan de standaard korte vorm
graphEdgesGraafRelatie-eigenschappen die als randen worden getekend
graphColorByGraafEen selectie- of statuseigenschap die de knooppunten kleurt
graphSizeByGraafEen getaleigenschap die de grootte van de knooppunten bepaalt
graphShowExternalGraaftrue toont ook linkdoelen buiten de weergave
graphShowIncomingGraaftrue toont ook links die uit andere databases binnenkomen
pinboardOrderPrikbordPaden van de niet-vastgezette kaarten, in handmatige volgorde
pinboardPinnedPrikbordPaden van de vastgezette kaarten, in volgorde
pinboardFilterByPrikbordLabelbron: een multiselectie-eigenschap; ontbreekt de sleutel, dan tags

Bestandsbrede opties (alleen eerste weergave)

Deze sleutels horen bij de hele database. Plainva schrijft ze alleen in het plainva-blok van de eerste weergave en leest van elke sleutel de eerste geldige waarde.

SleutelWaarde
fileIconColorHex-kleur van het databasepictogram (Icoonkleur van de database)
newItemFolderMap waarin Item nieuwe items opslaat
newItemTemplateSjabloon voor nieuwe items
contextFiltersEigenschappen die een ingesloten database beperken tot de notitie waarin hij is ingesloten (Deze notitie)
taskListAccount en lijst ("<account id> <list id>") waarin een nieuwe taak ook wordt aangemaakt

Samenvattingen

views[i].summaries koppelt een kolom aan een van deze namen; de kolomvoet berekent het over de rijen die de weergave toont.

NaamIn PlainvaResultaat
AverageGemiddeldeGemiddelde van de getallen
MinMinKleinste getal
MaxMaxGrootste getal
SumSomTotaal van de getallen
RangeBereikGrootste min kleinste getal; bij datums de spanne in dagen
MedianMediaanMiddelste waarde van de getallen
StddevStd.afw.Standaardafwijking van alle getallen (populatie)
EarliestVroegsteVroegste datum
LatestLaatsteLaatste datum
CheckedAangevinktRijen waarvan de waarde true of yes is
UncheckedNiet aangevinktAlle andere rijen
EmptyZonder waardeRijen zonder waarde
FilledMet waardeRijen met een waarde
UniqueVerschillendAantal verschillende waarden; items van een lijst tellen één voor één

Getallen worden op twee decimalen afgerond, en een decimale komma wordt ook gelezen. Een kolom zonder bruikbare waarde toont geen kolomvoet in plaats van 0. Elke andere naam is een eigen formule uit de summaries op het hoogste niveau: Plainva bewaart hem en toont Aangepast: … in het menu, maar berekent geen waarde.

Sorteren en groeperen

Een database insluiten, en this

![[Projects.base]] in een notitie toont de database in de notitie, in de leesweergave en in de editor. Een deel na # (een weergavenaam, zoals in ![[Projects.base#Board]]) wordt genegeerd: de insluiting toont de weergave die voor deze database het laatst is gebruikt. Een codeblok ```base in een notitie wordt als code getoond, niet als database.

this wordt nog niet ondersteund. Een filter of formule die this gebruikt, blijft in het bestand staan, maar Plainva evalueert het niet. Twee dingen dekken het meest voorkomende geval, “toon de items die bij deze notitie horen”: contextFilters (Deze notitie in het filterpaneel) beperkt een ingesloten database via een relatie-eigenschap tot de notitie waarin hij is ingesloten, en een ingesloten database die een relatie heeft met de database van zijn hostnotitie biedt zelf Deze database op de huidige notitie filteren aan. Beide werken alleen binnen Plainva; Obsidian toont alle rijen.

Beperkingen

Sleutels die Plainva niet kent

Plainva leest een .base, wijzigt alleen wat je in de app hebt gewijzigd, en schrijft het hele bestand opnieuw — als YAML met LF-regeleinden en zonder BOM, dus opmerkingen en de opmaak van een met de hand geschreven bestand blijven niet behouden. Van wat het niet kent:

Verschillen met Obsidian Bases

OnderwerpObsidianPlainva
Formules, eigen samenvattingenBerekendBewaard, niet berekend
thisOndersteundNog niet ondersteund
FilteruitdrukkingenDe volledige uitdrukkingstaalDe vormen onder Voorwaarden
file.folder == "X"Alleen notities direct in XX en al haar submappen
file.hasTag("x")Ook #x/childPrecies #x
file.nameDe bestandsnaamDe eigenschap title als de notitie die heeft
limit, groupBy van een weergaveToegepastlimit bewaard, niet toegepast; groupBy groepeert een bord, geen tabel
Weergavetypentable, list, cards en plug-intypenAcht typen; een onbekend type wordt als tabel getoond en blijft in het bestand
![[db.base#View]]Opent die weergaveDe laatst gebruikte weergave
Codeblok ```baseEen databaseEen codeblok
De plainva-blokken van PlainvaGenegeerdBord, kalender, tijdlijn, graaf, prikbord, relaties, aggregaties, veldtypen

Zie ook