Riferimento dei database (.base)

Ultimo aggiornamento: 2026-11-03

Questa pagina elenca tutto ciò che un file .base può contenere e cosa fa Plainva con ciascuna parte: ogni chiave di primo livello, ogni forma di filtro, ogni tipo di vista con le sue opzioni, i riepiloghi, l’ordinamento, i limiti, cosa succede alle chiavi che Plainva non conosce e dove Plainva si comporta in modo diverso da Obsidian Bases. Descrive ciò che il codice di Plainva legge, valuta e scrive oggi — non la documentazione di Obsidian.

Per l’uso quotidiano leggi prima Database (.base). Le regole che uno strumento deve rispettare quando scrive direttamente i file del vault e l’esempio completo di relazione sono nella File Format Reference.

In sintesi

Parte del fileCosa fa Plainva
filtersLegge e applica le origini (cartella, tag) e le condizioni elencate in Filtri
viewsLegge tutti gli otto tipi di vista, il loro ordine, l’ordinamento, i filtri e i riepiloghi
propertiesLegge lo schema delle colonne, il nome visualizzato e il blocco plainva di Plainva
summaries (vista)Calcola i quattordici riepiloghi integrati
formulasLe conserva nel file, non le calcola
summaries (primo livello)Conserva le formule di riepilogo personalizzate, non le calcola
thisNon ancora supportato
Altre chiaviLe conserva nel file (vedi Chiavi che Plainva non conosce)

Chiavi di primo livello

Un file .base è YAML con queste chiavi di primo livello. Tutte sono facoltative; un file senza views si apre con una tabella.

ChiaveContenutoIn Plainva
filtersQuali note appartengono al database (origini)Letta e applicata
propertiesUna voce per colonna, con l’ID della proprietà come chiaveLetta; le aggiunte di Plainva stanno nel suo blocco plainva
viewsL’elenco delle visteLetta; ogni vista richiede un name
formulasFormule di Obsidian, name: expressionConservata invariata, non calcolata
summariesFormule di riepilogo personalizzate di ObsidianConservata invariata, non calcolata

Plainva non scrive mai un’altra chiave di primo livello: Obsidian rifiuta di aprire un .base con una chiave che non conosce. Una chiave columns: di primo livello, scritta dalle versioni di Plainva molto vecchie, viene ancora letta e spostata in properties al successivo salvataggio del file.

Proprietà (properties)

ID delle proprietà

Un ID di proprietà dà il nome a una colonna. Esistono tre tipi:

IDSignificaEsempio
note.<key>Una chiave del frontmatter delle notenote.status
file.<field>Un’informazione sul file (vedi Campi del file)file.mtime
formula.<name>Una formula di Obsidian da formulasformula.price_per_unit

Le chiavi di properties, l’order di una vista e sort[].property usano questi ID. All’interno di un’espressione di filtro e di un blocco plainva una chiave del frontmatter si scrive nuda (status); un’espressione di filtro capisce anche note.status.

Quando una nota scrive una chiave con maiuscole e minuscole diverse da quelle della colonna (Due contro la colonna due), Plainva mostra comunque il valore in quella colonna e scrive le modifiche con la grafia della nota stessa.

Nome visualizzato

properties.<id>.displayName è l’etichetta di colonna di Obsidian. Plainva la mostra come intestazione della colonna e la conserva. Senza di essa una chiave del frontmatter viene mostrata con l’iniziale maiuscola (solo a schermo); i campi del file hanno nomi propri, per esempio Nome, Modificato, Dimensione, Percorso, Elenco cose da fare e Giorno dal nome del file.

Il blocco plainva di una colonna

Tutto ciò che Plainva aggiunge a una colonna sta sotto properties.<id>.plainva. Obsidian lo ignora.

ChiaveValoreSignificato
inputun tipo di campo (elenco sotto)Il tipo di campo della colonna
ratingMaxnumero, da 1 a 10Quanti segni ha una valutazione (predefinito 5)
ratingGlyphun carattereIl segno che disegna una valutazione (predefinito un punto)
optionselenco di opzioniValori fissi per selezione, stato e selezione multipla
relationBasepercorso .base relativo al vaultIl database verso cui punta una relazione
relationLimitoneUna relazione contiene esattamente un link; se assente, nessun limite
reverseOf{ base, property }Una colonna di relazione inversa calcolata
rollup{ through, of, fn, where }Una colonna di aggregazione calcolata (vedi Aggregazioni)
previousKeyselenco di al massimo 8 nomi precedentiPermette ai commenti di ritrovare una colonna rinominata

Tipi di campo (input)

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

Vengono lette anche due grafie più vecchie: multi-select come multiselect e link come relation. Una colonna senza input — o con un valore che non è in questo elenco — prende il suo tipo dai valori nelle note: true/false è una casella di controllo, un numero è un numero, un elenco di [[links]] è una relazione, 2026-07-03 è una data, un indirizzo web è un URL, e così via. Una colonna di relazione inversa e una colonna di aggregazione non hanno input.

Opzioni e colori

Un’opzione è { value, label, color, group }; solo value è obbligatorio. color è uno dei nomi della tavolozza gray, teal, blue, green, amber, coral, purple, pink — un nome sconosciuto ripiega su un colore ricavato dal valore. group è usato solo da Stato: le opzioni con lo stesso gruppo formano una fase. Una semplice stringa viene letta come un’opzione con quel valore.

Aggregazioni

Una colonna di aggregazione calcola un valore dalle note a cui punta una colonna di collegamento di questo database. Il valore non è memorizzato in nessun file.

Un’aggregazione a cui manca una parte obbligatoria, o che nomina una funzione non presente in questo elenco, viene ignorata: la colonna resta vuota e il database si apre comunque. Anche un’aggregazione attraverso un’altra colonna calcolata resta vuota.

Campi del file (file.*)

Questi valori provengono dal file, non dal suo frontmatter. Ogni riga di un database porta con sé i seguenti:

CampoValore
file.nameLa proprietà title della nota, se ne ha una, altrimenti il nome del file senza .md
file.pathIl percorso relativo al vault
file.mtimeUltima modifica, in millisecondi
file.ctimeCreazione, in millisecondi, dove il file system la fornisce
file.sizeDimensione in byte
file.tagsTutti i tag della nota, nel frontmatter e nel testo, ciascuno con #; valorizzato quando un filtro, una bacheca appunti o una vista che mostra la colonna o ordina in base a essa ne ha bisogno
file.tasksAvanzamento delle caselle di controllo come done/total; valorizzato per le bacheche e per una vista che mostra la colonna
file.dayIl giorno a cui corrisponde il nome del file di una nota giornaliera, secondo la cartella e il formato del vault; sola lettura, e solo il campo data di un calendario o di una cronologia può usarlo
file.revisionUn marcatore interno di modifica; non farci affidamento

file.folder funziona come origine (vedi Origini) ma non è una colonna. file.basename, file.ext, file.links, file.backlinks, file.embeds, file.properties e file.file non sono forniti: una colonna con uno di essi resta vuota, e un filtro li legge come vuoti.

Filtri

Dove stanno i filtri

Il filters di primo livello contiene le origini — quali note appartengono al database. Ogni vista può avere i propri filters con condizioni che restringono solo quella vista; Plainva scrive le condizioni lì. I due livelli si applicano insieme. Le condizioni che un file tiene al primo livello funzionano ancora; il successivo salvataggio in Plainva le sposta in ciascuna vista.

Origini

OrigineEspressione
Cartellafile.folder == "Projects/Active" — la cartella e tutte le sue sottocartelle; "" e "/" sono l’intero vault
Tagfile.hasTag("project") — la nota porta esattamente questo tag; un # iniziale viene ignorato

Più origini si combinano con and oppure or come qualsiasi altra condizione. Un database senza origini contiene tutte le note del vault. Gli allegati, i file riservati index.md e log.md e i file o le cartelle il cui nome inizia con un punto non sono mai righe.

Condizioni

Una condizione è una stringa. I valori stanno tra virgolette doppie; \" e \\ rappresentano una virgoletta e una barra rovesciata. La proprietà si scrive nuda o con note..

CondizioneEspressione
èstatus == "Done"
non èstatus != "Done"
contienecontains(labels, "urgent") oppure labels.contains("urgent")
non contiene!contains(labels, "urgent") oppure !labels.contains("urgent")
maggiore di, minore dieffort > "3", effort < "8"
almeno, al massimodue >= "2026-07-01", due <= "2026-07-31"
è vuotostatus == "" oppure status.isEmpty()
non è vuotostatus != "" oppure !status.isEmpty()
ha un tagfile.tags.contains("#work"), negato con !
colore dell’intestazione, iconanote.plainva.header_color == "#2a7f7b", note.plainva.icon == "lucide:pin"

Come si confrontano i valori

and, or, not

Un oggetto filters ha esattamente uno tra and, or e not a ogni livello; le sue voci sono stringhe di condizione o altri oggetti filtro.

ChiaveCorrisponde quando
andogni voce corrisponde
oralmeno una voce corrisponde
notnessuna voce corrisponde

Plainva valuta qualsiasi profondità. Il pannello dei filtri modifica un livello di gruppi sotto Tutte o Almeno una (Aggiungi gruppo); una struttura più profonda appare come Filtro complesso (non modificabile), resta nel file e viene applicata — una condizione al suo interno che Plainva non sa leggere viene indicata sotto di essa come non applicata. Un file più vecchio con and e or affiancati sullo stesso livello viene letto come «tutte quelle di and e almeno una di or» e scritto nella forma valida al successivo salvataggio.

Cosa Plainva non sa leggere

Sono comprese solo le forme nelle due tabelle qui sopra. Tutto il resto — file.inFolder(…), file.hasLink(…), file.hasProperty(…), un numero senza virgolette (price > 2), && e || dentro una stessa stringa, l’aritmetica, le funzioni di data come now(), oppure this — resta nel file e viene mostrato nel pannello dei filtri così com’è, con la nota Non applicata: Plainva non riesce a leggere questa condizione, quindi non filtra nulla. La vista mostra allora più note dello stesso filtro in Obsidian.

Formule

Plainva non calcola le formule di Obsidian. formulas resta nel file invariato, e una colonna formula.<name> nell’order di una vista viene mostrata senza valori. Esporta tabella → Formule (.base) scrive alcune aggregazioni come formule, così che Obsidian possa calcolarle (vedi Database).

Viste

Chiavi di ogni vista

ChiaveValoreIn Plainva
typetable, list, cardsIl tipo di vista; vedi la tabella successiva
nametestoObbligatorio; Plainva dà un nome a una vista che ne è priva quando salva
orderelenco di ID di proprietàLe colonne visibili, in questo ordine
sortelenco di { property, direction }Regole di ordinamento, ASC o DESC
filtersoggetto filtroLe condizioni proprie della vista
summariesmappa ID di proprietà → nome del riepilogoIl piè di pagina di ogni colonna
plainvamappaLe opzioni di vista di Plainva, qui sotto

Gli otto tipi di vista

Obsidian conosce table, list e cards. Gli altri tipi di vista di Plainva sono memorizzati come type: table più plainva.render, così Obsidian li mostra come tabella.

Tipo di vistatype su discoplainva.render
Tabella (table)table—
Elenco (list)list—
Galleria (gallery)cards—
Bacheca (board)tableboard
Calendario (calendar)tablecalendar
Cronologia (timeline)tabletimeline
Grafo (graph)tablegraph
Bacheca appunti (pinboard)tablepinboard

Bacheca, Calendario, Cronologia, Grafo e Bacheca appunti sono offerti come Tipo di vista solo finché Consenti le estensioni Plainva per i file .base è attivo. Un type che Plainva non conosce viene mostrato come tabella e resta nel file così com’è finché non scegli un altro Tipo di vista.

Opzioni della vista (views[i].plainva)

All’interno del blocco plainva una proprietà si scrive nuda (status), non come note.status.

ChiaveTipi di vistaValore
renderBacheca, Calendario, Cronologia, Grafo, Bacheca appuntiIl tipo di vista, vedi sopra
groupByBachecaLa proprietà di cui sono fatte le colonne; in sua assenza, la proprietà del groupBy proprio di Obsidian della vista
boardLaneByBachecaUna seconda proprietà per Corsie per
boardWipLimitsBachecaMappa valore della colonna → numero massimo di schede (Limite WIP), numeri interi maggiori di 0
boardColorModeBachecacolumn tinge l’intera colonna; se assente = solo il chip dell’intestazione
boardColumnOrderBachecaOrdine manuale delle colonne; __UNGROUPED__ è la colonna senza valore
colorByBacheca, CronologiaSchede e barre prendono il colore dell’opzione di questa proprietà (Colore per)
dateFieldCalendario, CronologiaLa data di inizio (Campo data, Data di inizio); una proprietà data o file.day
endFieldCalendario, CronologiaLa Data di fine
coverImageGalleriaLa proprietà che contiene l’Immagine di copertina
subItemsPropertyTabellaLa relazione genitore per i Sottoelementi
widthsTabellaMappa colonna → larghezza in pixel
dateFormattuttilong, iso o relative; se assente = la forma breve predefinita
graphEdgesGrafoProprietà di relazione disegnate come archi
graphColorByGrafoUna proprietà di selezione o di stato che colora i nodi
graphSizeByGrafoUna proprietà numerica che dimensiona i nodi
graphShowExternalGrafotrue mostra anche i bersagli dei link fuori dalla vista
graphShowIncomingGrafotrue mostra anche i link in arrivo da altri database
pinboardOrderBacheca appuntiPercorsi delle schede non fissate, in ordine manuale
pinboardPinnedBacheca appuntiPercorsi delle schede fissate, in ordine
pinboardFilterByBacheca appuntiOrigine delle etichette: una proprietà di selezione multipla; se assente = i tag

Opzioni dell’intero file (solo prima vista)

Queste chiavi appartengono all’intero database. Plainva le scrive solo nel blocco plainva della prima vista e legge il primo valore valido di ciascuna.

ChiaveValore
fileIconColorColore esadecimale dell’icona del database (Colore dell’icona del database)
newItemFolderCartella in cui Voce memorizza le nuove voci
newItemTemplateModello per le nuove voci
contextFiltersProprietà che limitano un database incorporato alla nota in cui è incorporato (Questa nota)
taskListAccount ed elenco ("<account id> <list id>") in cui viene creata anche una nuova attività

Riepiloghi

views[i].summaries associa una colonna a uno di questi nomi; il piè di pagina lo calcola sulle righe che la vista mostra.

NomeIn PlainvaRisultato
AverageMediaMedia dei numeri
MinMinIl numero più piccolo
MaxMaxIl numero più grande
SumSommaTotale dei numeri
RangeIntervalloIl numero più grande meno il più piccolo; per le date l’intervallo in giorni
MedianMedianaValore centrale dei numeri
StddevDev. standardDeviazione standard di tutti i numeri (popolazione)
EarliestPiù remotaLa data più remota
LatestPiù recenteLa data più recente
CheckedSpuntateRighe il cui valore è true o yes
UncheckedNon spuntateTutte le altre righe
EmptySenza valoreRighe senza valore
FilledCon valoreRighe con un valore
UniqueDistintiNumero di valori diversi; le voci di un elenco contano una per una

I numeri sono arrotondati a due decimali, e viene letta anche la virgola decimale. Una colonna senza alcun valore utilizzabile non mostra alcun piè di pagina invece di 0. Qualsiasi altro nome è una formula personalizzata del summaries di primo livello: Plainva la conserva e mostra Personalizzato: … nel menu, ma non calcola alcun valore.

Ordinamento e raggruppamento

Incorporare un database e this

![[Projects.base]] in una nota mostra il database dentro la nota, nella vista di lettura e nell’editor. Una parte dopo # (il nome di una vista, come in ![[Projects.base#Board]]) viene ignorata: l’incorporamento mostra la vista usata per ultima per questo database. Un blocco di codice ```base in una nota viene mostrato come codice, non come database.

this non è ancora supportato. Un filtro o una formula che usa this resta nel file, ma Plainva non lo valuta. Due cose coprono il caso più comune, «mostra le voci che appartengono a questa nota»: contextFilters (Questa nota nel pannello dei filtri) limita un database incorporato alla nota in cui è incorporato tramite una proprietà di relazione, e un database incorporato che è in relazione con il database della nota che lo ospita offre da sé Filtra questo database sulla nota corrente. Entrambe agiscono solo dentro Plainva; Obsidian mostra tutte le righe.

Limiti

Chiavi che Plainva non conosce

Plainva legge un .base, cambia solo ciò che hai cambiato nell’app e riscrive l’intero file da capo — come YAML con terminatori di riga LF e senza BOM, quindi i commenti e la spaziatura di un file scritto a mano non vengono conservati. Di ciò che non conosce:

Differenze rispetto a Obsidian Bases

ArgomentoObsidianPlainva
Formule, riepiloghi personalizzatiCalcolatiConservati, non calcolati
thisSupportatoNon ancora supportato
Espressioni di filtroIl linguaggio di espressioni completoLe forme in Condizioni
file.folder == "X"Solo le note direttamente in XX e tutte le sue sottocartelle
file.hasTag("x")Anche #x/childEsattamente #x
file.nameIl nome del fileLa proprietà title, se la nota ne ha una
limit, groupBy della vistaApplicatilimit conservato, non applicato; groupBy raggruppa una bacheca, non una tabella
Tipi di vistatable, list, cards e tipi dei pluginOtto tipi; uno sconosciuto viene mostrato come tabella e conservato nel file
![[db.base#View]]Apre quella vistaLa vista usata per ultima
Blocco di codice ```baseUn databaseUn blocco di codice
I blocchi plainva di PlainvaIgnoratiBacheca, calendario, cronologia, grafo, bacheca appunti, relazioni, aggregazioni, tipi di campo

Vedi anche