Tabelle e campi
Le colonne di una tabella sono un insieme chiuso di sei tipi, ciascuno convertito in ingresso, più gli indici che rendono rintracciabile una riga.
Una tabella si definisce una sola volta, in Xuda Studio, e ogni posto che ne mostra i dati, la griglia di Studio, la scheda Dati della dashboard, un programma Get Data o una chiamata API diretta, legge le stesse definizioni dei campi.
Questa pagina tratta i campi come li incontri mentre crei e sfogli una tabella. Per l'elenco completo delle proprietà, gli indici e come un programma Get Data o Set Data punta a una tabella, vedi Tabella in Building Blocks.
Sei tipi di campo, nient'altro
Ogni campo di una tabella è esattamente di uno di sei tipi. Studio mostra ciascuno con la propria icona
nell'intestazione della griglia invece di un badge di testo, dato che una colonna è stretta e un id di campo come ORD_Total occupa
già quasi tutta la larghezza:
Non esiste un settimo tipo e non c'è modo di aggiungerne uno personalizzato. Un campo che non rientra in questi sei,
un blocco di testo formattato, un file, una relazione con un'altra tabella, si modella come una string (un id,
un percorso, un blob codificato in JSON) o come un array/object di essi; non esiste un tipo di
colonna di prima classe a parte per nessuno di questi in una tabella.
Cosa fa davvero ogni tipo con un valore
Sia dbs_create sia dbs_update convertono il valore che invii attraverso il tipo dichiarato del campo
prima che venga archiviato, quindi vale la pena sapere esattamente cosa fa ogni conversione invece di dare per scontato un
significato familiare:
string
Tutto ciò che non è già una stringa viene convertito con una semplice conversione in stringa. Un valore vuoto o
mancante viene archiviato come "".
number
Viene archiviato Number(value). Un valore che non diventa un numero finito ricade su 0
invece di rifiutare la scrittura. Anche un valore vuoto o mancante viene archiviato come 0.
boolean
Solo un elenco fisso di token vale true (Y, 1, true, TRUE, ON, YES) e un altro
elenco fisso vale false (N, 0, false, FALSE, OFF, NO); tutto il resto, compreso un valore
vuoto, viene archiviato come false.
object
Una stringa viene analizzata come JSON5; un valore che è già un oggetto viene archiviato così com'è. Un valore vuoto o
mancante, o una stringa che non si analizza, viene archiviato come {}.
array
Una stringa viene analizzata prima come JSON5 e, se fallisce, valutata invece come un letterale JavaScript;
un valore che è già un array viene archiviato così com'è. Un valore vuoto o mancante, o una stringa che nessuna delle due
analisi gestisce, viene archiviato come [].
date
Non c'è alcuna gestione dedicata delle date in ingresso: qualunque stringa invii viene archiviata esattamente come
inviata. Scegli un solo formato, ISO 8601 (2026-09-25T00:00:00.000Z) è il predefinito più sicuro, perché nulla
nella piattaforma normalizza un campo data per te, e una tabella con formati misti si ordina e si filtra
in modo incoerente.
Inviare un valore che non può diventare un numero valido per un campo number non fa fallire la chiamata, archivia
in silenzio 0. Convalida tu stesso un valore numerico prima di scriverlo se uno 0 sarebbe sbagliato.
Dare un nome ai campi
Non c'è una regola di denominazione imposta oltre al fatto che gli id dei campi devono essere univoci nella tabella, ma ogni tabella
già presente in un progetto Xuda segue una convenzione: prefissa ogni campo con un breve codice della
tabella stessa, così ORD - Orders produce ORD_Id, ORD_Total, ORD_Status. Mantiene i nomi dei campi
privi di ambiguità quando una query, un'espressione o un file di importazione deve fare riferimento a più tabelle
insieme.
Contrassegnare un campo come obbligatorio
Un campo ha un flag di obbligatorietà che imposti quando lo definisci, insieme al suo tipo e al suo commento, per indicare che una riga non deve essere salvata senza un valore lì.
Le tabelle hanno un proprio stato attivo/archiviato
Separatamente dal fatto che una singola riga sia archiviata (eliminata in modo non definitivo, vedi Interrogare i dati tramite API), una tabella stessa può essere attiva o archiviata come nodo di Studio. La scheda Dati della dashboard elenca le tabelle di un progetto come schede, commutabili tra Attivo e Archiviato, ciascuna scheda con il nome della tabella e il suo numero attuale di righe. Archiviare una tabella qui è un'azione lato Studio sul nodo, è un'operazione diversa dall'archiviare le righe al suo interno.