Kuika’nın Create Attribute aksiyonu, EAV (Entity-Attribute-Value) veri modeli kapsamında yeni bir öznitelik (attribute) tanımlamak için kullanılır. Bu aksiyon sayesinde dinamik veri yapıları kolayca genişletilebilir. Özellikle kullanıcı tanımlı alanların gerektiği formlar, esnek veri girişleri ve özelleştirilebilir içerik sistemlerinde idealdir.
Bu aksiyon şu an Beta sürümde sunulmaktadır ve geliştirme süreci devam etmektedir. Üretim ortamında kullanılmadan önce dikkatli test edilmesi önerilir.
Teknik Özellikler
Attribute Tanımlama (EAV Paneli): Create Attribute aksiyonu, yeni bir attribute oluşturmak için aşağıdaki parametrelerle çalışır:
Name (String - Zorunlu): Tanımlanacak özniteliğin sistemdeki adıdır. Eşsiz olmalıdır.
DataType (String - Zorunlu): Öznitelik için kullanılacak veri tipi. Örneğin String, Integer, Decimal, Boolean, Date gibi değerler alabilir.
Description (String - Opsiyonel): Attribute’un açıklayıcı bilgisidir. Kullanıcıya veya geliştiriciye bilgi sunmak için kullanılır.
CategoryId (Guid - Opsiyonel): Attribute’un ait olduğu kategori ID’si. Kategoriler sayesinde attribute gruplamaları yapılabilir.
IsRequired (Boolean - Opsiyonel): Attribute’un doldurulmasının zorunlu olup olmadığını belirtir.
Veri Kaynağı Uyumluluğu: Parametreler, Kuika’daki Symbol Picker aracılığıyla Screen Input, Fixed, Form Component, Current, Action Result gibi kaynaklardan dinamik veya statik olarak belirlenebilir.
Web & Mobil Destek: Create Attribute aksiyonu hem web hem de mobil uygulama senaryolarında kullanılabilir.
Create Attribute Aksiyonu Uygulama Adımları
1. UI Design'da Aksiyonu Tanımlama
Kuika platformunda projenizi açın.
UI Design modülüne geçin.
Yeni bir attribute oluşturulmasını istediğiniz ekranı seçin.
Örneğin “Alan Oluştur” adında bir buton oluşturun.
Bu butona tıklanıldığında çalışması için: + ADD ACTION > OnClick > EAV > Attribute >Create Attribute aksiyonunu seçin.
2. Aksiyon Parametrelerini Yapılandırma
Aksiyon parametreleri, Symbol Picker aracıyla dinamik ya da sabit şekilde tanımlanabilir. Aşağıda her parametre için örnek tanım yöntemleri ve kullanım amaçları yer almaktadır:
Name (Zorunlu):Kullanıcının form üzerinden attribute ismini yazdığı metin alanıdır.
Symbol Picker > Form Component > Text Input
Örnek: "referans_sayisi"
DataType (Zorunlu): Bu parametre ile attribute’un veri tipi belirlenir. Sabit bir değer olarak atanmalıdır.
Symbol Picker > Fixed > "String" (veya "Integer", "Decimal", "Boolean" gibi desteklenen veri tipleri)
Örnek: "Integer"
Description (Opsiyonel): Kullanıcının attribute hakkında açıklama girebildiği metin alanı.
Symbol Picker > Form Component > Text Input
Örnek: "Kişinin referans sayısını belirtir"
CategoryId (Opsiyonel): Attribute’un ait olduğu kategori ID’si sabit bir değer olabilir veya kullanıcı bir seçim yapabilir.
Symbol Picker > Fixed > Guid veya Symbol Picker > Component > SelectBox
Örnek: "cd253d3b-6a9a-48d2-afe7-e8303f2e9094"
IsRequired (Opsiyonel): Bu alan attribute’un zorunlu olup olmadığını belirler.
Sabit olarak true/false atanabilir ya da kullanıcı bir anahtar ile seçebilir.
Symbol Picker > Fixed > true/false veya Component > Switch
Örnek: true
DefaultValue (Opsiyonel): Attribute’un varsayılan değeridir. Sabit bir değer atanabileceği gibi kullanıcı girişiyle de alınabilir.
Symbol Picker > Fixed veya Component > Text/Number Input
Örnek: 0 (Integer için) veya "Bilinmiyor" (String için)
3. Attribute’un Sistem Üzerinde Oluşturulması
Tanımlanan parametreler doğrultusunda, sistemde yeni bir attribute kaydı oluşturulur. Bu işlem, veri tabanı şemasını değiştirmeden özelleştirilmiş veri girişi sağlar.
Kullanım Senaryosu: Dinamik Form Alanı Tanımlama
Bir CRM uygulamasında, kullanıcılar kendi alanlarını tanımlayabilmek ister. Örneğin “Hobiler” veya “Referans Sayısı” gibi özel alanlar oluşturmak için “Yeni Alan Ekle” butonuna tıklanıldığında bu aksiyon tetiklenebilir.
Name: "referans_sayisi"
DataType: "Integer"
IsRequired: true
DefaultValue: 0
Bu şekilde kullanıcıya özel, genişletilebilir veri yapıları oluşturulabilir.
Koşullu Oluşturma: Belirli kullanıcı rolleri veya ekran durumlarına göre attribute oluşturma işlemi koşullu hale getirilebilir.
Doğrulama: Aynı ada sahip attribute varsa sistem hata mesajı gösterebilir.
Otomatik Kategori Atama: Belirli ekranlara göre CategoryId otomatik belirlenebilir.
Teknik Riskler
Yinelenen İsimler: Aynı Name değeri ile attribute oluşturulmamalıdır. Sistem çakışma verebilir.
Geçersiz Veri Tipi: DataType olarak yalnızca sistemin desteklediği veri tipleri girilmelidir.
Eksik Zorunlu Alanlar: Name ve DataType alanları boş bırakılmamalıdır.
Beta Sürüm Riski: Özellik henüz beta aşamasındadır; bazı davranışlar istikrarsız olabilir.
Create Attribute aksiyonu, Kuika platformunun dinamik veri modellemesi yeteneklerini güçlendiren önemli bir bileşendir. Beta sürümde olmasına rağmen, uygulamalarınızda esnek alan yönetimi ve özelleştirilebilir veri toplama ihtiyaçları için güçlü bir altyapı sunar.
