Vai al contenuto
Verificata

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.

Il riferimento completo allo schema

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.

Un numero non rifiuta mai una scrittura

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.