Tablolar ve alanlar
Bir tablonun sütunları altı türden oluşan kapalı bir kümedir ve her biri girişte dönüştürülür; ayrıca bir satırı bulunabilir kılan dizinler vardır.
Bir tablo Xuda Studio'da bir kez tanımlanır ve verisini gösteren her yer (Studio tablosu, panelin Veri sekmesi, bir Veri Al programı veya doğrudan bir API çağrısı) aynı alan tanımlarını okur.
Bu sayfa alanları, bir tablo oluştururken ve gezerken karşılaştığınız şekilde ele alır. Tüm özellik listesi, dizinler ve bir Veri Al veya Veri Ayarla programının bir tabloya nasıl işaret ettiği için Yapı Taşları bölümündeki Tablo sayfasına bakın.
Altı alan türü, başka hiçbiri yok
Bir tablodaki her alan tam olarak altı türden biridir. Bir sütun dar olduğundan ve ORD_Total gibi bir
alan kimliği zaten genişliğin çoğunu kapladığından, Studio her türü metin rozeti yerine tablo başlığında
kendi simgesiyle gösterir:
Yedinci bir tür yoktur ve özel bir tür eklemenin yolu yoktur. Bu altısına uymayan bir alan (zengin metin
bloğu, dosya, başka bir tabloyla ilişki) bir string (bir kimlik, bir yol, JSON olarak kodlanmış bir
blok) veya bunların bir array/object biçimi olarak modellenir; bir tabloda bunlardan hiçbiri için ayrı
birinci sınıf bir sütun türü yoktur.
Her türün bir değerle gerçekte ne yaptığı
dbs_create ve dbs_update, gönderdiğiniz değeri saklanmadan önce alanın tanımlı türüne dönüştürür;
bu yüzden tanıdık bir anlam varsaymak yerine her dönüşümün tam olarak ne yaptığını bilmekte fayda var:
string
Zaten bir dize olmayan her şey düz bir dize dönüşümüyle çevrilir. Boş veya eksik bir değer "" olarak
saklanır.
number
Number(value) saklanır. Sonlu bir sayıya çözümlenemeyen bir değer, yazmayı reddetmek yerine 0 olur.
Boş veya eksik bir değer de 0 olarak saklanır.
boolean
Yalnızca sabit bir belirteç listesi true olarak okunur (Y, 1, true, TRUE, ON, YES) ve başka
bir sabit liste false olarak okunur (N, 0, false, FALSE, OFF, NO); boş değer dahil geri
kalan her şey false olarak saklanır.
object
Bir dize JSON5 olarak çözümlenir; zaten nesne biçimindeki bir değer olduğu gibi saklanır. Boş veya eksik
bir değer ya da çözümlenemeyen bir dize {} olarak saklanır.
array
Bir dize önce JSON5 olarak çözümlenir, başarısız olursa bunun yerine bir JavaScript sabiti olarak
değerlendirilir; zaten dizi biçimindeki bir değer olduğu gibi saklanır. Boş veya eksik bir değer ya da
iki çözümlemenin de işleyemediği bir dize [] olarak saklanır.
date
Girişte özel bir tarih işleme yoktur: gönderdiğiniz dize tam olarak gönderildiği gibi saklanır. Tek bir
biçim seçin; ISO 8601 (2026-09-25T00:00:00.000Z) en güvenli varsayılandır, çünkü platformda bir tarih
alanını sizin için normalleştiren hiçbir şey yoktur ve karışık biçimlere sahip bir tablo tutarsız
sıralanır ve süzülür.
Bir number alanı için geçerli bir sayıya dönüşemeyen bir değer göndermek çağrıyı başarısız kılmaz,
sessizce 0 saklar. 0 yanlış olacaksa sayısal bir değeri yazmadan önce kendiniz doğrulayın.
Alanları adlandırma
Alan kimliklerinin tabloda benzersiz olması dışında zorunlu bir adlandırma kuralı yoktur, ancak bir Xuda
projesindeki her mevcut tablo bir kurala uyar: her alanın önüne tablonun kendisi için kısa bir kod
ekleyin; böylece ORD - Orders tablosundan ORD_Id, ORD_Total, ORD_Status çıkar. Bir sorgunun, bir
ifadenin veya bir içe aktarma dosyasının aynı anda birkaç tabloya başvurması gerektiğinde alan adlarını
karışmaz tutar.
Bir alanı zorunlu işaretleme
Bir alan, tanımlarken türü ve açıklamasının yanında ayarladığınız bir zorunluluk bayrağı taşır; bu, bir satırın orada bir değer olmadan kaydedilmemesi gerektiğini belirtir.
Tabloların kendi etkin/arşivlenmiş durumu vardır
Tek bir satırın arşivlenmesinden (geçici silinmesinden, bkz. API ile veri sorgulama) ayrı olarak, bir tablonun kendisi de Studio düğümü olarak etkin veya arşivlenmiş olabilir. Panelin Veri sekmesi bir projenin tablolarını kartlar olarak listeler; Aktif ve Arşivlendi arasında geçiş yapılabilir ve her kart tablonun adını ve mevcut satır sayısını gösterir. Burada bir tabloyu arşivlemek düğüm üzerinde Studio tarafı bir işlemdir ve içindeki satırları arşivlemekten farklı bir işlemdir.