Référence des bases de données (.base)

Dernière mise à jour : 2026-11-03

Cette page recense tout ce qu’un fichier .base peut contenir et ce que Plainva fait de chaque partie : chaque clé de premier niveau, chaque forme de filtre, chaque type de vue avec ses options, les synthèses, le tri, les limites, ce qui arrive aux clés que Plainva ne connaît pas, et les points où Plainva se comporte autrement qu’Obsidian Bases. Elle décrit ce que le code de Plainva lit, évalue et écrit aujourd’hui — pas la documentation d’Obsidian.

Pour l’usage courant, lisez d’abord Bases de données (.base). Les règles qu’un outil doit respecter lorsqu’il écrit directement dans les fichiers du vault, ainsi que l’exemple complet de relation, se trouvent dans la Référence du format de fichier.

Vue d’ensemble

Partie du fichierCe que fait Plainva
filtersLit et applique les sources (dossier, tag) et les conditions décrites sous Filtres
viewsLit les huit types de vue, leur ordre, leur tri, leurs filtres et leurs synthèses
propertiesLit le schéma des colonnes, le nom affiché et le bloc plainva de Plainva
summaries (vue)Calcule les quatorze synthèses intégrées
formulasLes conserve dans le fichier, ne les calcule pas
summaries (premier niveau)Conserve les formules de synthèse personnalisées, ne les calcule pas
thisPas encore pris en charge
Autres clésLes conserve dans le fichier (voir Clés que Plainva ne connaît pas)

Clés de premier niveau

Un fichier .base est du YAML avec ces clés de premier niveau. Toutes sont facultatives ; un fichier sans views s’ouvre avec un tableau.

CléContenuDans Plainva
filtersQuelles notes appartiennent à la base de données (sources)Lue et appliquée
propertiesUne entrée par colonne, indexée par l’identifiant de propriétéLue ; les ajouts de Plainva vivent dans son bloc plainva
viewsLa liste des vuesLue ; chaque vue a besoin d’un name
formulasFormules d’Obsidian, name: expressionConservées telles quelles, non calculées
summariesFormules de synthèse personnalisées d’ObsidianConservées telles quelles, non calculées

Plainva n’écrit jamais d’autre clé de premier niveau : Obsidian refuse d’ouvrir un .base contenant une clé qu’il ne connaît pas. Une clé columns: de premier niveau, écrite par de très anciennes versions de Plainva, est encore lue et déplacée dans properties à la prochaine sauvegarde du fichier.

Propriétés (properties)

Identifiants de propriété

Un identifiant de propriété désigne une colonne. Il en existe trois sortes :

IdSignificationExemple
note.<key>Une clé du frontmatter des notesnote.status
file.<field>Une information sur le fichier (voir Champs de fichier)file.mtime
formula.<name>Une formule d’Obsidian issue de formulasformula.price_per_unit

Les clés de properties, le order d’une vue et sort[].property utilisent ces identifiants. Dans une expression de filtre et dans un bloc plainva, une clé de frontmatter s’écrit nue (status) ; une expression de filtre comprend aussi note.status.

Lorsqu’une note écrit une clé avec une casse différente de celle de la colonne (Due pour la colonne due), Plainva affiche tout de même la valeur dans cette colonne et réécrit les modifications sous l’orthographe propre à la note.

Nom affiché

properties.<id>.displayName est le libellé de colonne d’Obsidian. Plainva l’affiche comme en-tête de colonne et le conserve. Sans lui, une clé de frontmatter s’affiche avec une majuscule initiale (à l’écran uniquement) ; les champs de fichier ont leurs propres noms, par exemple Nom, Modifié, Taille, Chemin, Liste de tâches et Jour d’après le nom du fichier.

Le bloc plainva d’une colonne

Tout ce que Plainva ajoute à une colonne vit sous properties.<id>.plainva. Obsidian l’ignore.

CléValeurSignification
inputun type de champ (liste ci-dessous)Le type de champ de la colonne
ratingMaxnombre, de 1 à 10Le nombre de repères d’une évaluation (5 par défaut)
ratingGlyphun caractèreLe repère que dessine une évaluation (un point par défaut)
optionsliste d’optionsValeurs fixes pour sélection, statut et sélection multiple
relationBasechemin .base relatif au vaultLa base de données vers laquelle pointe une relation
relationLimitoneUne relation contient exactement un lien ; absente, elle n’a pas de limite
reverseOf{ base, property }Une colonne de relation inverse calculée
rollup{ through, of, fn, where }Une colonne d’agrégation calculée (voir Agrégations)
previousKeysliste de 8 anciens noms au plusPermet aux commentaires de retrouver une colonne renommée

Types de champ (input)

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

Deux anciennes graphies sont lues aussi : multi-select comme multiselect, et link comme relation. Une colonne sans input — ou avec une valeur absente de cette liste — reçoit son type d’après les valeurs des notes : true/false donne une case à cocher, un nombre un nombre, une liste de [[links]] une relation, 2026-07-03 une date, une adresse web une URL, et ainsi de suite. Une colonne de relation inverse et une colonne d’agrégation n’ont pas d’input.

Options et couleurs

Une option est { value, label, color, group } ; seul value est obligatoire. color est l’un des noms de la palette gray, teal, blue, green, amber, coral, purple, pink — un nom inconnu se replie sur une couleur dérivée de la valeur. group ne sert qu’à Statut : les options du même groupe forment une étape. Une simple chaîne est lue comme une option portant cette valeur.

Agrégations

Une colonne d’agrégation calcule une valeur à partir des notes vers lesquelles pointe une colonne de lien de cette base de données. La valeur n’est enregistrée dans aucun fichier.

Une agrégation à laquelle il manque une partie requise, ou qui nomme une fonction absente de cette liste, est ignorée : la colonne reste vide et la base de données s’ouvre quand même. Une agrégation passant par une autre colonne calculée reste vide aussi.

Champs de fichier (file.*)

Ces valeurs viennent du fichier, pas de son frontmatter. Chaque ligne d’une base de données porte les champs suivants :

ChampValeur
file.nameLa propriété title de la note si elle en a une, sinon le nom du fichier sans .md
file.pathLe chemin relatif au vault
file.mtimeDernière modification, en millisecondes
file.ctimeCréation, en millisecondes, lorsque le système de fichiers l’indique
file.sizeTaille en octets
file.tagsTous les tags de la note, frontmatter et texte, chacun avec # ; rempli lorsqu’un filtre, un tableau d’affichage ou une vue qui affiche la colonne ou trie selon elle en a besoin
file.tasksProgression des cases à cocher sous la forme done/total ; rempli pour les boards et pour une vue qui affiche la colonne
file.dayLe jour que représente le nom de fichier d’une note quotidienne, d’après le dossier et le format du vault ; en lecture seule, et seul le champ de date d’un calendrier ou d’une chronologie peut l’utiliser
file.revisionUn repère de modification interne ; ne vous y fiez pas

file.folder fonctionne comme source (voir Sources) mais n’est pas une colonne. file.basename, file.ext, file.links, file.backlinks, file.embeds, file.properties et file.file ne sont pas fournis : une colonne qui en utilise un reste vide, et un filtre les lit comme vides.

Filtres

Où vivent les filtres

Le filters de premier niveau contient les sources — les notes qui appartiennent à la base de données. Chaque vue peut porter ses propres filters, avec des conditions qui ne restreignent que cette vue ; c’est là que Plainva écrit les conditions. Les deux niveaux s’appliquent ensemble. Les conditions qu’un fichier garde au premier niveau fonctionnent toujours ; la prochaine sauvegarde dans Plainva les déplace dans chaque vue.

Sources

SourceExpression
Dossierfile.folder == "Projects/Active" — le dossier et tous ses sous-dossiers ; "" et "/" désignent le vault entier
Tagfile.hasTag("project") — la note porte exactement ce tag ; un # initial est ignoré

Plusieurs sources se combinent avec and ou or comme n’importe quelle autre condition. Une base de données sans source contient toutes les notes du vault. Les pièces jointes, les fichiers réservés index.md et log.md, ainsi que les fichiers ou dossiers dont le nom commence par un point ne sont jamais des lignes.

Conditions

Une condition est une chaîne. Les valeurs sont entre guillemets doubles ; \" et \\ échappent un guillemet et une barre oblique inverse. La propriété s’écrit nue ou avec note..

ConditionExpression
eststatus == "Done"
n’est passtatus != "Done"
contientcontains(labels, "urgent") ou labels.contains("urgent")
ne contient pas!contains(labels, "urgent") ou !labels.contains("urgent")
supérieur à, inférieur àeffort > "3", effort < "8"
au moins, au plusdue >= "2026-07-01", due <= "2026-07-31"
est videstatus == "" ou status.isEmpty()
n’est pas videstatus != "" ou !status.isEmpty()
a un tagfile.tags.contains("#work"), négation avec !
couleur d’en-tête, icônenote.plainva.header_color == "#2a7f7b", note.plainva.icon == "lucide:pin"

Comment les valeurs se comparent

and, or, not

Un objet filters porte exactement un des éléments and, or et not à chaque niveau ; ses entrées sont des chaînes de condition ou d’autres objets de filtre.

CléCorrespond lorsque
andchaque entrée correspond
orau moins une entrée correspond
notaucune entrée ne correspond

Plainva évalue n’importe quelle profondeur. Le panneau de filtre modifie un niveau de groupes sous Toutes ou Au moins une (Ajouter un groupe) ; une structure plus profonde apparaît comme Filtre complexe (non modifiable), reste dans le fichier et est appliquée — une condition qu’elle contient et que Plainva ne sait pas lire est signalée en dessous comme non appliquée. Un ancien fichier avec and et or côte à côte au même niveau est lu comme « tous ceux de and et un de ceux de or », puis réécrit sous la forme valide à la prochaine sauvegarde.

Ce que Plainva ne sait pas lire

Seules les formes des deux tableaux ci-dessus sont comprises. Tout le reste — file.inFolder(…), file.hasLink(…), file.hasProperty(…), un nombre sans guillemets (price > 2), && et || dans une même chaîne, l’arithmétique, les fonctions de date comme now(), ou this — reste dans le fichier et s’affiche tel quel dans le panneau de filtre, avec la mention Non appliquée : Plainva ne sait pas lire cette condition, elle ne filtre donc rien. La vue montre alors plus de notes que le même filtre dans Obsidian.

Formules

Plainva ne calcule pas les formules d’Obsidian. formulas reste dans le fichier sans changement, et une colonne formula.<name> dans le order d’une vue s’affiche sans valeurs. Exporter le tableau → Formules (.base) écrit certaines agrégations sous forme de formules pour qu’Obsidian puisse les calculer (voir Bases de données).

Vues

Clés de chaque vue

CléValeurDans Plainva
typetable, list, cardsLe type de vue ; voir le tableau suivant
nametexteRequis ; Plainva donne un nom à une vue qui n’en a pas lorsqu’il enregistre
orderliste d’identifiants de propriétéLes colonnes visibles, dans cet ordre
sortliste de { property, direction }Règles de tri, ASC ou DESC
filtersobjet de filtreLes conditions propres à la vue
summariestable identifiant de propriété → nom de synthèseLe pied de chaque colonne
plainvatableLes options de vue de Plainva, ci-dessous

Les huit types de vue

Obsidian connaît table, list et cards. Les autres types de vue de Plainva sont enregistrés comme type: table plus plainva.render, de sorte qu’Obsidian les affiche comme un tableau.

Type de vuetype sur le disqueplainva.render
Tableau (table)table—
Liste (list)list—
Galerie (gallery)cards—
Kanban (board)tableboard
Calendrier (calendar)tablecalendar
Chronologie (timeline)tabletimeline
Graphe (graph)tablegraph
Tableau d’affichage (pinboard)tablepinboard

Kanban, Calendrier, Chronologie, Graphe et Tableau d’affichage ne sont proposés comme Type de vue que tant que Autoriser les extensions Plainva pour les fichiers .base est activé. Un type que Plainva ne connaît pas s’affiche comme un tableau et reste tel quel dans le fichier jusqu’à ce que vous choisissiez un autre Type de vue.

Options de vue (views[i].plainva)

Dans le bloc plainva, une propriété s’écrit nue (status), pas comme note.status.

CléTypes de vueValeur
renderKanban, Calendrier, Chronologie, Graphe, Tableau d’affichageLe type de vue, voir ci-dessus
groupByKanbanLa propriété dont sont faites les colonnes ; à défaut, la propriété du groupBy propre à Obsidian pour la vue
boardLaneByKanbanUne seconde propriété pour Couloirs par
boardWipLimitsKanbanTable valeur de colonne → nombre maximal de cartes (Limite de WIP), nombres entiers supérieurs à 0
boardColorModeKanbancolumn teinte toute la colonne ; absent = seulement la puce d’en-tête
boardColumnOrderKanbanOrdre manuel des colonnes ; __UNGROUPED__ est la colonne sans valeur
colorByKanban, ChronologieLes cartes et les barres prennent la couleur d’option de cette propriété (Couleur selon)
dateFieldCalendrier, ChronologieLa date de début (Champ de date, Date de début) ; une propriété de date ou file.day
endFieldCalendrier, ChronologieLa Date de fin
coverImageGalerieLa propriété qui contient l’Image de couverture
subItemsPropertyTableauLa relation parente pour les Sous-éléments
widthsTableauTable colonne → largeur en pixels
dateFormattouteslong, iso ou relative ; absent = la forme courte par défaut
graphEdgesGraphePropriétés de relation dessinées comme arêtes
graphColorByGrapheUne propriété de sélection ou de statut qui colore les nœuds
graphSizeByGrapheUne propriété numérique qui dimensionne les nœuds
graphShowExternalGraphetrue affiche aussi les cibles de lien extérieures à la vue
graphShowIncomingGraphetrue affiche aussi les liens venant d’autres bases de données
pinboardOrderTableau d’affichageChemins des cartes non épinglées, dans l’ordre manuel
pinboardPinnedTableau d’affichageChemins des cartes épinglées, dans l’ordre
pinboardFilterByTableau d’affichageSource des libellés : une propriété à sélection multiple ; absent = les tags

Options valables pour tout le fichier (première vue uniquement)

Ces clés appartiennent à toute la base de données. Plainva les écrit uniquement dans le bloc plainva de la première vue et lit la première valeur valide de chacune.

CléValeur
fileIconColorCouleur hexadécimale de l’icône de la base de données (Couleur de l’icône de la base de données)
newItemFolderDossier où Entrée enregistre les nouvelles entrées
newItemTemplateModèle des nouvelles entrées
contextFiltersPropriétés qui limitent une base de données intégrée à la note dans laquelle elle est intégrée (Cette note)
taskListCompte et liste ("<account id> <list id>") dans lesquels une nouvelle tâche est aussi créée

Synthèses

views[i].summaries associe une colonne à l’un de ces noms ; le pied de colonne le calcule sur les lignes que la vue affiche.

NomDans PlainvaRésultat
AverageMoyenneMoyenne des nombres
MinMinPlus petit nombre
MaxMaxPlus grand nombre
SumSommeTotal des nombres
RangeÉtenduePlus grand nombre moins plus petit ; pour les dates, l’écart en jours
MedianMédianeValeur centrale des nombres
StddevÉcart-typeÉcart-type de tous les nombres (population)
EarliestPlus ancienneDate la plus ancienne
LatestPlus récenteDate la plus récente
CheckedCochéesLignes dont la valeur est true ou yes
UncheckedNon cochéesToutes les autres lignes
EmptySans valeurLignes sans valeur
FilledAvec valeurLignes avec une valeur
UniqueDistinctesNombre de valeurs différentes ; les entrées d’une liste comptent une à une

Les nombres sont arrondis à deux décimales, et une virgule décimale est lue aussi. Une colonne sans valeur exploitable n’affiche pas de pied plutôt que 0. Tout autre nom est une formule personnalisée issue du summaries de premier niveau : Plainva la conserve et affiche Personnalisée : … dans le menu, mais ne calcule aucune valeur.

Tri et regroupement

Intégrer une base de données, et this

![[Projects.base]] dans une note affiche la base de données dans la note, en mode lecture et dans l’éditeur. Une partie après # (un nom de vue, comme dans ![[Projects.base#Board]]) est ignorée : l’intégration affiche la dernière vue utilisée pour cette base de données. Un bloc de code ```base dans une note s’affiche comme du code, pas comme une base de données.

this n’est pas encore pris en charge. Un filtre ou une formule qui utilise this reste dans le fichier, mais Plainva ne l’évalue pas. Deux choses couvrent le cas le plus courant, « afficher les entrées qui appartiennent à cette note » : contextFilters (Cette note dans le panneau de filtre) limite une base de données intégrée à la note dans laquelle elle est intégrée, via une propriété de relation, et une base de données intégrée qui est en relation avec la base de données de sa note hôte propose d’elle-même Filtrer cette base sur la note actuelle. Les deux n’agissent qu’à l’intérieur de Plainva ; Obsidian affiche toutes les lignes.

Limites

Clés que Plainva ne connaît pas

Plainva lit un .base, ne modifie que ce que vous avez modifié dans l’application, et réécrit le fichier en entier — en YAML avec des fins de ligne LF et sans BOM, de sorte que les commentaires et la mise en forme d’un fichier écrit à la main ne sont pas conservés. Parmi ce qu’il ne connaît pas :

Différences avec Obsidian Bases

SujetObsidianPlainva
Formules, synthèses personnaliséesCalculéesConservées, non calculées
thisPris en chargePas encore pris en charge
Expressions de filtreLe langage d’expressions completLes formes de Conditions
file.folder == "X"Seulement les notes directement dans XX et tous ses sous-dossiers
file.hasTag("x")Aussi #x/childExactement #x
file.nameLe nom du fichierLa propriété title si la note en a une
limit, groupBy d’une vueAppliquéslimit conservé, non appliqué ; groupBy regroupe un kanban, pas un tableau
Types de vuetable, list, cards et types de pluginsHuit types ; un type inconnu s’affiche comme un tableau et reste dans le fichier
![[db.base#View]]Ouvre cette vueLa dernière vue utilisée
Bloc de code ```baseUne base de donnéesUn bloc de code
Blocs plainva de PlainvaIgnorésKanban, calendrier, chronologie, graphe, tableau d’affichage, relations, agrégations, types de champ

Voir aussi