Kullanıcı Kılavuzu

Get Entity Attributes

28/7/25
Get Entity Attributes

Kuika’nın Get Entity Attributes aksiyonu, bir entity’ye (varlık) ait tüm attribute’ların (özniteliklerin) listesini almak için kullanılır. Bu aksiyon sayesinde, belirli bir entity'nin tanımlı tüm alanları dinamik olarak çekilebilir ve dinamik formlar, filtreleme arayüzleri ya da özelleştirilebilir veri girişleri oluşturulabilir. Örneğin, “Çalışan” adlı bir entity tanımlıysa ve bu entity altında “Ad”, “Soyad”, “Departman”, “İşe Başlama Tarihi” gibi attribute’lar varsa, Get Entity Attributes aksiyonu çalıştırıldığında bu özniteliklerin tümü liste halinde elde edilir. Böylece sistem, kullanıcıya dinamik olarak “Çalışan” formunu oluşturabilir ya da filtreleme panelinde bu alanları seçim olarak sunabilir.

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.

Bu aksiyon, EAV modelinde attribute yönetimi için temel bileşenlerden biridir ve özellikle dinamik formlar oluşturulurken kullanılır.

Teknik Özellikler

  • Attribute Listeleme: Get Entity Attributes aksiyonu şu parametre ile çalışır:
    • EntityId (Guid - Zorunlu): Attribute’ları alınacak olan entity’nin sistemdeki benzersiz kimliğidir. Symbol Picker aracılığıyla sabit veya dinamik kaynaklardan alınabilir.
  • Veri Kaynağı Uyumluluğu: EntityId parametresi şuralardan alınabilir:
    • Symbol Picker > Form Component
    • Select Box / Fixed / Action Result / Current
  • Web & Mobil Destek: Get Entity Attributes aksiyonu hem web hem de mobil uygulamalarda çalışır.

Get Entity Attributes Aksiyonu Uygulama Adımları

1. UI’da Entity Seçimi

  • Kullanıcının bir entity seçebileceği bir Select Box veya tablo hazırlanır.
  • Seçilen entity’nin id bilgisi alınır.

2. Aksiyon Tanımlama

  • + ADD ACTION > OnClick > EAV > Entity Attributes > Get Entity Attributes
  • EntityId parametresi Symbol Picker üzerinden belirlenir.

3. Aksiyon Sonucunun Kullanımı

  • Attribute listesi bir Dynamic Form, Table, Select Box elementleri ya da Set Value aksiyonu ile kullanılabilir.
  • Örnek çıktı: [  id, name, dataType, isRequired, defaultValue , ... ]

Kullanım Senaryosu: Dinamik Form Oluşturma

Bir insan kaynakları uygulamasında, yeni bir çalışan bilgisi eklemek isteyen kullanıcı, sistemde daha önce tanımlanmış "Çalışan" entity’sine ait formu doldurmak ister.

  1. Kullanıcı, "Çalışan" entity’sini seçer.
  2. Sistem, Get Entity Attributes aksiyonunu çalıştırarak "Çalışan" entity’sine ait tüm attribute’ları getirir.
    Gelen attribute’lar örneğin şu şekildedir:

    • Ad (Text)
    • Soyad (Text)
    • Departman (Select Box)
    • İşe Başlama Tarihi (Date)
  3. Bu attribute bilgileri, Dynamic Form elementine yüklenir.
  4. Sistem, bu bilgilerle otomatik olarak formu oluşturur. Kullanıcının manuel olarak alanları tanımlamasına gerek kalmaz.
  5. Kullanıcı, formu doldurur ve kaydeder.

“Çalışan” entity’sine ait attribute’lar temel alınarak, sistemde tamamen dinamik ve yeniden kullanılabilir bir form yapısı oluşturulmuş olur. Bu yapı sayesinde her entity için tek tek form tasarlamaya gerek kalmaz; yapı değiştiğinde form da otomatik güncellenir.

Get Entity Attributes Aksiyonu İleri Seviye Özelleştirmeler

  • Koşullu Yükleme: Entity seçilmeden aksiyon çalıştırılmaz (If ile kontrol).
  • Attribute Filtreleme: İstenirse Filter aksiyonlarıyla sadece belirli veri tipine ya da isimdeki attribute’lar gösterilebilir.
  • UI Güncelleme: Gelen attribute’lara göre bileşen sayısı ve türü dinamik olarak oluşturulabilir.

Teknik Riskler

  • Eksik EntityId: ID boş veya geçersizse attribute’lar getirilemez.
  • İlişkili Veri Uyuşmazlığı: Attribute’ların veri tipleri Dynamic Form elementi ile  uyumlu olmalıdır.
  • Performans: Çok sayıda attribute varsa listeleme performansı dikkatle test edilmelidir.

Get Entity Attributes aksiyonu, Kuika platformunun EAV mimarisinde dinamik form ve veri yapıları kurmanın temel adımlarındandır. Belirli bir entity’nin tüm alanlarını sistematik olarak çekerek kullanıcıya özel ve esnek arayüzlerin oluşturulmasına olanak tanır.

İlişkili diğer içerikler

No items found.

Sözlük

No items found.

Alt Başlıklar