Sari la conținut
Verificat

Tabele și câmpuri

Coloanele unui tabel sunt un set închis de șase tipuri, fiecare convertit la intrare, plus indexurile care fac un rând ușor de găsit.

Un tabel se definește o singură dată, în Xuda Studio, iar fiecare loc care îi arată datele, grila din Studio, fila Date din dashboard, un program Preia date sau un apel direct la API, citește aceleași definiții de câmpuri.

Referința completă a schemei

Această pagină descrie câmpurile așa cum le întâlnești când construiești și răsfoiești un tabel. Pentru lista completă de proprietăți, indexuri și cum indică un program Preia date sau Setează date spre un tabel, vezi Tabel în Blocuri de construcție.

Șase tipuri de câmpuri, nimic altceva

Fiecare câmp al unui tabel este exact unul din șase tipuri. Studio afișează fiecare tip cu propria pictogramă în antetul grilei, nu cu o etichetă text, deoarece o coloană este îngustă, iar un id de câmp precum ORD_Total ocupă deja cea mai mare parte din lățime:

Nu există un al șaptelea tip și nicio cale de a adăuga unul personalizat. Un câmp care nu se potrivește cu aceste șase, un bloc de text îmbogățit, un fișier, o relație cu alt tabel, se modelează ca un string (un id, o cale, un blob codificat JSON) sau ca un array/object de astfel de valori; nu există un tip de coloană separat, de prim rang, pentru niciuna dintre ele într-un tabel.

Ce face fiecare tip cu o valoare

Atât dbs_create, cât și dbs_update convertesc valoarea trimisă prin tipul declarat al câmpului înainte de a o stoca, așa că merită să știi exact ce face fiecare conversie, în loc să presupui un înțeles familiar:

string

Orice nu este deja un șir este convertit cu o conversie simplă la șir. O valoare goală sau lipsă se stochează ca "".

number

Se stochează Number(value). O valoare care nu se convertește într-un număr finit revine la 0, în loc să respingă scrierea. O valoare goală sau lipsă se stochează tot ca 0.

boolean

Doar o listă fixă de simboluri este citită ca true (Y, 1, true, TRUE, ON, YES), iar o altă listă fixă ca false (N, 0, false, FALSE, OFF, NO); orice altceva, inclusiv o valoare goală, se stochează ca false.

object

Un șir este interpretat ca JSON5; o valoare deja sub formă de obiect se stochează ca atare. O valoare goală sau lipsă, ori un șir care nu poate fi interpretat, se stochează ca {}.

array

Un șir este interpretat mai întâi ca JSON5 și, dacă asta eșuează, este evaluat ca literal JavaScript; o valoare deja sub formă de array se stochează ca atare. O valoare goală sau lipsă, ori un șir pe care niciuna dintre interpretări nu îl poate procesa, se stochează ca [].

date

Nu există o tratare dedicată a datei la intrare: orice șir trimiți se stochează exact așa cum a fost trimis. Alege un singur format, ISO 8601 (2026-09-25T00:00:00.000Z) este cea mai sigură valoare implicită, deoarece nimic din platformă nu normalizează un câmp de tip dată pentru tine, iar un tabel cu formate amestecate se sortează și se filtrează inconsistent.

Un număr nu respinge niciodată o scriere

Trimiterea unei valori care nu poate deveni un număr valid într-un câmp number nu face apelul să eșueze, ci stochează în tăcere 0. Validează tu însuți o valoare numerică înainte să o scrii, dacă un 0 ar fi greșit.

Denumirea câmpurilor

Nu există nicio regulă de denumire impusă în afară de unicitatea id-urilor de câmp în tabel, dar fiecare tabel deja existent într-un proiect Xuda urmează o convenție: prefixează fiecare câmp cu un cod scurt pentru tabelul însuși, astfel că ORD - Orders produce ORD_Id, ORD_Total, ORD_Status. Astfel numele câmpurilor rămân neambigue atunci când o interogare, o expresie sau un fișier de import trebuie să facă referire la mai multe tabele deodată.

Marcarea unui câmp ca obligatoriu

Un câmp poartă un indicator de obligatoriu pe care îl setezi când îl definești, alături de tipul și comentariul lui, pentru a indica faptul că un rând nu este menit să fie salvat fără o valoare acolo.

Tabelele au propria stare activ/arhivat

Separat de arhivarea unui singur rând (ștergere logică, vezi Interogarea datelor prin API), un tabel în sine poate fi activ sau arhivat ca nod Studio. Fila Date din dashboard listează tabelele unui proiect ca niște carduri, comutabile între Activ și Arhivat, fiecare card arătând numele tabelului și numărul curent de rânduri. Arhivarea unui tabel aici este o acțiune pe partea de Studio asupra nodului, o operație diferită de arhivarea rândurilor din interiorul lui.