Tabele i pola
Kolumny tabeli to zamknięty zestaw sześciu typów, każdy rzutowany przy zapisie, oraz indeksy, dzięki którym wiersz można znaleźć.
Tabelę definiuje się raz, w Xuda Studio, a każde miejsce pokazujące jej dane, siatka w Studio, karta Dane w panelu, program Pobierz dane albo bezpośrednie wywołanie API, czyta te same definicje pól.
Ta strona opisuje pola tak, jak spotykasz je przy budowaniu i przeglądaniu tabeli. Pełną listę właściwości, indeksy i to, jak program Pobierz dane lub Ustaw dane wskazuje tabelę, znajdziesz w Tabeli w Elementach składowych.
Sześć typów pól i nic więcej
Każde pole tabeli jest dokładnie jednym z sześciu typów. Studio pokazuje każdy z własną ikoną w
nagłówku siatki zamiast tekstowej odznaki, bo kolumna jest wąska, a identyfikator pola, taki jak
ORD_Total, zajmuje już większość szerokości:
Nie ma siódmego typu ani sposobu na dodanie własnego. Pole, które nie pasuje do tych sześciu,
blok tekstu sformatowanego, plik, relacja do innej tabeli, modeluje się jako string (identyfikator,
ścieżka, zakodowany w JSON blob) albo array/object takich wartości. Żadne z nich nie ma w tabeli
osobnego, pełnoprawnego typu kolumny.
Co każdy typ naprawdę robi z wartością
Zarówno dbs_create, jak i dbs_update rzutują wysyłaną wartość przez zadeklarowany typ pola,
zanim zostanie zapisana, więc warto wiedzieć dokładnie, co robi każde rzutowanie, zamiast zakładać
znajome znaczenie:
string
Wszystko, co nie jest już ciągiem znaków, jest konwertowane zwykłą konwersją na ciąg. Pusta lub
brakująca wartość zapisuje się jako "".
number
Zapisywane jest Number(value). Wartość, która nie daje się sparsować do skończonej liczby, wraca
do 0, zamiast odrzucić zapis. Pusta lub brakująca wartość także zapisuje się jako 0.
boolean
Tylko stała lista tokenów jest odczytywana jako true (Y, 1, true, TRUE, ON, YES),
a inna stała lista jako false (N, 0, false, FALSE, OFF, NO). Wszystko inne, także
pusta wartość, zapisuje się jako false.
object
Ciąg jest parsowany jako JSON5, a wartość już mająca kształt obiektu jest zapisywana bez zmian.
Pusta lub brakująca wartość albo ciąg, który się nie parsuje, zapisuje się jako {}.
array
Ciąg jest najpierw parsowany jako JSON5, a jeśli to się nie uda, jest zamiast tego obliczany jako
literał JavaScript. Wartość już mająca kształt tablicy jest zapisywana bez zmian. Pusta lub
brakująca wartość albo ciąg, z którym nie poradzi sobie żadne z parsowań, zapisuje się jako [].
date
Przy zapisie nie ma specjalnej obsługi dat: dowolny ciąg, który wyślesz, jest zapisywany dokładnie
tak, jak został wysłany. Wybierz jeden format, najbezpieczniejszy domyślnie jest ISO 8601
(2026-09-25T00:00:00.000Z), bo nic w platformie nie normalizuje pola daty za Ciebie, a tabela z
mieszanymi formatami sortuje i filtruje niespójnie.
Wysłanie wartości, która nie może stać się poprawną liczbą, do pola number nie kończy wywołania
błędem, tylko po cichu zapisuje 0. Jeśli 0 byłoby błędem, sprawdź wartość liczbową sam przed
zapisem.
Nazywanie pól
Nie ma wymuszonej reguły nazywania poza tym, że identyfikatory pól muszą być unikalne w tabeli, ale
każda tabela w projekcie Xuda już stosuje jedną konwencję: poprzedź każde pole krótkim kodem samej
tabeli, tak że ORD - Orders daje ORD_Id, ORD_Total, ORD_Status. Dzięki temu nazwy pól są
jednoznaczne, gdy zapytanie, wyrażenie lub plik importu musi odwoływać się naraz do kilku tabel.
Oznaczanie pola jako obowiązkowe
Pole ma flagę obowiązkowości, którą ustawiasz przy jego definiowaniu, obok typu i komentarza, żeby zapisać, że wiersz nie powinien być zapisany bez wartości w tym miejscu.
Tabele mają własny stan aktywna/zarchiwizowana
Niezależnie od archiwizacji pojedynczego wiersza (miękkie usunięcie, zobacz Zapytania o dane przez API), sama tabela może być aktywna albo zarchiwizowana jako węzeł Studio. Karta Dane w panelu pokazuje tabele projektu jako karty, z przełączaniem między Trwa a Zarchiwizowano, a każda karta pokazuje nazwę tabeli i bieżącą liczbę wierszy. Zarchiwizowanie tabeli tutaj to akcja po stronie Studio na węźle, to inna operacja niż archiwizowanie wierszy w jej wnętrzu.