Kullanıcı Kılavuzu

Create Attribute

28/7/25
Create Attribute

Kuika’nın Create Attribute aksiyonu, EAV (Entity-Attribute-Value) veri modeli kapsamında, bir varlığa ait yeni bir öznitelik (attribute) tanımlamak için kullanılır. Bu aksiyon sayesinde dinamik veri yapıları, yazılım geliştiriciye ihtiyaç duymadan son kullanıcı tarafından genişletilebilir hale gelir. Böylece canlı sistemlerde dahi, iş süreçlerine özel yeni alanlar hızlıca eklenebilir; form yapıları ya da içerik modelleri sonradan özelleştirilebilir.

Bu esneklik, özellikle kullanıcı tanımlı alanların gerektiği formlar, esnek veri girişleri ve özelleştirilebilir içerik sistemleri için idealdir. Örneğin bir e-ticaret uygulamasında, “Ayakkabı” adlı bir varlık tanımlandıktan sonra, bu varlığa ait olabilecek “Numara”, “Renk”, “Materyal” gibi alanlar Create Attribute aksiyonu ile tanımlanabilir. Günlük yaşamda bu durum, bir ürün kartına istediğiniz kadar özellik ekleyebilmek gibidir—tıpkı bir kıyafet mağazasının, ürünlerine sonradan "Kumaş Türü" ya da "Yıkama Talimatı" alanlarını kolayca ekleyebilmesi gibi.

Her Attribute için bir isim, veri tipi (örn. String, Integer, Boolean) ve isteğe bağlı olarak açıklama ya da varsayılan değer belirlenebilir. Örneğin “Batarya Kapasitesi” adlı bir öznitelik için, Integer veri tipi seçilerek mAh cinsinden bir değer girilmesi sağlanabilir.

Create Attribute aksiyonu sayesinde, sistemdeki veri yapısı zaman içinde ihtiyaçlara göre şekillendirilebilir ve geliştirilebilir—bu da hem kullanıcı deneyimini hem de operasyonel verimliliği artırır.

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): Bu özellik, tanımlanan Attribute’un doldurulmasının zorunlu olup olmadığını belirtir. Eğer true olarak işaretlenirse, Attribute’un bağlı olduğu dinamik form alanında otomatik olarak bir zorunluluk (*) işareti gösterilir ve kullanıcı bu alanı doldurmadan formu tamamlayamaz. Böylece son kullanıcıya hem görsel bir uyarı sağlanır hem de veri girişinde tutarlılık ve doğruluk garanti altına alınmış olur.
    • DefaultValue (Any - Opsiyonel): Özniteliğin varsayılan değeridir.
  • 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.

Kuika’da Attribute (Özellik) Tanımlama – Örnek Senaryo

Kuika’da bir varlık (Entity) tanımlandıktan sonra, bu varlığa ait olabilecek tüm özellikler Create Attribute aksiyonu ile tanımlanır. Attribute'lar, EAV (Entity-Attribute-Value) modelinin temel yapı taşlarından biridir ve sistemin dinamik şekilde genişletilmesine olanak tanır. Her Attribute için bir isim, veri tipi (örneğin String, Integer, Boolean), isteğe bağlı açıklama, varsayılan değer ve zorunluluk durumu (IsRequired) tanımlanabilir.

Örneğin bir CRM uygulaması geliştiriyorsunuz ve kullanıcıların kendi müşteri kartlarına özel alanlar ekleyebilmelerini istiyorsunuz. Kullanıcı, "Yeni Alan Ekle" butonuna tıklayarak aşağıdaki gibi bir Attribute oluşturabilir:

  • Name: referans_sayisi
  • DataType: Integer
  • IsRequired: true
  • DefaultValue: 0

Bu işlem sonucunda, kullanıcı arayüzündeki ilgili dinamik form alanına otomatik olarak bir zorunluluk (*) işareti eklenir. Kullanıcı bu alanı doldurmadan formu gönderemez. Böylece hem veri bütünlüğü korunur hem de son kullanıcılar kendi iş süreçlerine uygun veri alanlarını sistem çalışırken tanımlayabilir hale gelir.

Bu örnek, EAV modelinin sağladığı canlı ortamda yapılandırılabilirlik özelliğini doğrudan yansıtır. Geleneksel veri yapılarında veritabanı şemasına müdahale edilmesi gereken bir senaryo, Kuika’nın EAV destekli sistemi sayesinde sadece bir aksiyonla, sistem kesintisine gerek kalmadan çözülür.

Sonuç olarak, Kuika’da Attribute tanımlamak yalnızca bir özellik oluşturmak değil, aynı zamanda son kullanıcıya özelleştirilmiş veri yapıları inşa etme yetkisi vermek anlamına gelir. Bu da Kuika’nın dinamik, ölçeklenebilir ve sürdürülebilir uygulama altyapısını destekleyen en önemli unsurlardan biridir.

Create Attribute Aksiyonu İleri Seviye Özelleştirmeler

  • 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: Sistemde aynı Name değeriyle birden fazla Attribute tanımlanmamalıdır. Teknik olarak sistem bu durumu her zaman doğrudan bir çakışma hatasıyla engellemeyebilir, ancak veri modelinde tutarsızlığa ve yönetimsel karmaşaya yol açabilir. Bu nedenle, her Attribute için benzersiz ve anlamlı bir Name değeri belirlenmesi önemlidir. Öte yandan, bir kez tanımlanmış bir Attribute, birden fazla Entity (varlık) ile ilişkilendirilebilir. Örneğin "ekran_boyutu" adlı bir Attribute, hem Telefon hem de Bilgisayar Entity’leri için kullanılabilir. Bu, EAV modelinin sunduğu özelliklerin yeniden kullanılabilirliği avantajını yansıtır. Aynı özelliği farklı varlık tiplerinde tekrar tanımlamak yerine, merkezi olarak bir kez tanımlayıp farklı Entity’lere eşlemek, sistemde hem bütünlüğü korur hem de bakım maliyetini azaltır. Bu nedenle, Name alanı belirlenirken sadece o Attribute’un sistemdeki teknik adı değil, aynı zamanda yeniden kullanılabilirliğini de göz önünde bulundurmak gerekir.
  • 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. Canlı ortamlarda, son kullanıcılar tarafından yönetilebilen bir yapı sunar. EAV modeli, sistem yayındayken dahi geliştirici müdahalesine ihtiyaç duymadan yeni alanların tanımlanmasına ve mevcut yapıların esnetilmesine olanak tanır. Bu sayede kullanıcılar, kendi iş süreçlerine özel veri alanlarını arayüz üzerinden tanımlayabilir, formlarını zenginleştirebilir ve sistemde kesinti olmadan yapılarını özelleştirebilir.

İlişkili diğer içerikler

No items found.

Sözlük

No items found.

Alt Başlıklar