İçeriğe geç
Doğrulandı

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.

Şemanın tam başvurusu

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 sayı hiçbir zaman yazmayı reddetmez

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.