TotalApp Dökümanlar

Özel Koleksiyonlar

Kod yazmadan kendi tablolarınızı özel alanlarla ve doğrulama kurallarıyla tasarlayın, ardından kayıt ekleyip görüntüleyin — SQL, migration veya kod gerekmez.

Genel Bakış

Özel Koleksiyonlar, Schema & Data Engine'in son kullanıcı ekranıdır. Kendi tablonuzu — koleksiyon — bir e-tabloda kolonları taslak haline getirir gibi tasarlamanızı sağlar: bir ad verin, alanlar ekleyin, her alanın tipini seçin ve hangi alanların zorunlu olduğunu belirleyin. Kaydettikten sonra, bu tasarımdan otomatik olarak bir veri giriş formu üretilir ve gönderdiğiniz her kayıt, depolanmadan önce tam olarak tanımladığınız kurallara göre sunucu tarafında doğrulanır.

Temel Özellikler

Görsel Alan Tasarımcısı

Alanları tek tek ekleyin — bir ad, bir tip ve bir zorunlu anahtarı. Şema dosyası, migration betiği veya kod yok.

Otomatik Üretilen Form

Veri giriş formu doğrudan alan tanımlarınızdan inşa edilir — bir seçenek listesi alanı açılır menü, bir evet/hayır alanı onay kutusu, bir sayı alanı sayısal girdi olur.

Sunucu Tarafında Doğrulama

Her kayıt, depolanmadan önce kurallarınıza göre kontrol edilir — eksik zorunlu alanlar, yanlış tipler ve geçersiz seçenek değerleri açık, belirli bir hatayla reddedilir.

Canlı Kayıt Tablosu

Bir koleksiyona eklediğiniz her kayıt, tasarladığınız her alan için bir kolonla birlikte anında filtrelenebilir bir tabloda listelenir.

Alan Tipi Referansı

Tip Ne saklar Üretilen form kontrolü
Metin Herhangi bir string değer Tek satırlık metin girdisi
Sayı Bir tam sayı veya ondalık değer Sayısal girdi
Evet/Hayır Bir boolean değer Onay kutusu
Seçenek listesi Tanımladığınız sabit bir setten bir değer (ör. beklemede, onaylandı, iptal) Yalnızca izin verilen değerleri listeleyen açılır menü

Her alan, tipinden bağımsız olarak Zorunlu olarak da işaretlenebilir — boş bırakılan zorunlu bir alan, kayıt gönderildiğinde reddedilir.

Koleksiyon Tasarlama

Koleksiyon tasarımcısını açmak için ekranın sağ üst köşesindeki Yeni Koleksiyon'a tıklayın.

Koleksiyon Adı Ver Alan Ekle Tip ve Zorunluluk Seç Kaydet
  1. Bir Koleksiyon Adı girin — "Envanter Sayımı", "Etkinlik Katılımcıları" veya "Freelancer Ödemeleri" gibi tamamen serbest bir şey.
  2. Her alan için bir alan adı girin (ör. order_id).
  3. Aşağıdaki Alan Tipi Referansı tablosundan bir alan tipi seçin.
  4. Tip Seçenek listesi ise, izin verilen değerleri virgülle ayrılmış olarak girin (ör. beklemede, onaylandı, iptal).
  5. Alan her kayıtta doldurulmalıysa Zorunlu'yu işaretleyin.
  6. Başka bir satır eklemek için + Alan Ekle'ye, bir alanı kaldırmak için o alandaki × düğmesine tıklayın.

Koleksiyona bir ad verdikten ve en az bir alan tanımladıktan sonra Kaydet'e tıklayın. Koleksiyon, sol taraftaki listede hemen görünür ve hemen kayıt eklemeye başlayabilmeniz için otomatik olarak seçilir.

Alanları daha sonra da ekleyebilirsiniz

Bir koleksiyonun tasarımı kilitli değildir — bir kere tasarlayıp daha sonra alan eklemek, zaten eklediğiniz kayıtları bozmaz. Mevcut kayıtlar, güncellenene kadar yeni eklenen bir alan için basitçe bir değere sahip olmaz.

Kayıt Ekleme ve Görüntüleme

Sol taraftaki listeden bir koleksiyon seçin, ardından veri giriş formunu açmak için Kayıt Ekle'ye tıklayın. Formun alanları doğrudan koleksiyonun tasarımından üretilir — doldurun ve Kaydet'e tıklayın.

Girdiğiniz bir değer koleksiyonun kurallarından birini ihlal ederse, form kaydetmek yerine sunucunun döndürdüğü tam hatayı gösterir — örneğin eksik bir zorunlu alan, sayısal olmayan bir sayı alanı veya izin verilen listenin dışında bir değere ayarlanmış bir seçenek listesi alanı. Değeri düzeltip yeniden gönderin.

Başarıyla kaydedilen her kayıt, her alan için bir kolon ve kaydın ne zaman eklendiğini gösteren bir Oluşturulma kolonuyla birlikte sağdaki kayıt tablosunda hemen görünür.

Yalnızca elle giriş için değil

Kayıtlar yalnızca bu form üzerinden eklenmez — workflow node'ları, gelen webhook'lar ve yapay zeka ajanları da aynı doğrulanmış yol üzerinden bir koleksiyona yazabilir. Kaydı ne yazmış olursa olsun aynı kurallar geçerlidir: şemayı ihlal eden her şey depolanmadan önce reddedilir.

Bir Koleksiyonu Silme

Sol taraftaki listede bir koleksiyonun üzerine gelin, çöp kutusu simgesine tıklayın ve Evet ile onaylayın. Bir koleksiyonu silmek onun alan tasarımını kaldırır; ona daha önce eklenmiş kayıtları otomatik olarak silmez.

Tenant İzolasyonu

Oluşturduğunuz her koleksiyon ve her kayıt, yalnızca kendi tenant'ınıza özeldir. Koleksiyonlar ve kayıtlar imzalı oturumunuzdan çözülür, tarayıcının doğrudan gönderdiği hiçbir şeyden değil — başka bir tenant, ID'sini bir şekilde tahmin etse bile size ait bir koleksiyonu asla göremez, listeleyemez veya ona yazamaz.

Uyarı

Geçersiz bir alan tüm kaydı reddeder — parçalı kaydetme yoktur. Bir kayıt, koleksiyonun tanımladığınız tüm kurallarını sağlıyorsa depolanır, aksi halde hiç depolanmaz.

Sık Sorulan Sorular

Özel Koleksiyonları kullanmak için SQL yazmam gerekiyor mu?
Hayır. Bir koleksiyon tasarlamak tamamen görseldir — alanları adlandırır ve tiplerini bir listeden seçersiniz. Hiçbir zaman migration veya SQL ifadesi gerekmez.
Kaydet'e tıkladığımda kaydım neden reddedildi?
Girdiğiniz değer koleksiyonun kurallarından birini ihlal etti — zorunlu bir alan boş bırakıldı, bir sayı alanına sayısal olmayan bir girdi verildi veya bir seçenek listesi alanı izin verilen listenin dışında bir değere ayarlandı. Hangi alanın ve hangi kuralın başarısız olduğu, düzeltip yeniden gönderebilmeniz için hata mesajında tam olarak gösterilir.
Zaten kayıtlar varken bir alanın tipini değiştirebilir miyim?
Koleksiyon tasarımcısı yeni koleksiyonlar ve alanlar oluşturmak içindir. Mevcut kayıtlar, değiştirilen bir alan tasarımına göre geriye dönük olarak yeniden doğrulanmaz — yeni kurallar, o andan itibaren eklenen kayıtlar için geçerli olur.
Hâlâ kayıtları olan bir koleksiyonu silersem ne olur?
Koleksiyonun alan tasarımı kaldırılır ve sol taraftaki listeden kaybolur. Daha önce kaydedilmiş kayıtları otomatik olarak silinmez, ancak koleksiyon tanımı olmadan bu ekrandan artık erişilebilir değildir.
Özel Koleksiyonlar verisi tenant bazlı mı?
Evet. Her koleksiyon ve her kayıt, kesinlikle kimliği doğrulanmış oturumunuzdan çözülür — oluşturduğunuz koleksiyonlar ve veriler başka bir tenant tarafından asla görülemez veya yazılamaz.