Przejdź do treści
Zweryfikowano

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.

Pełna dokumentacja schematu

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.

Liczba nigdy nie odrzuca zapisu

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.