Kuika’nın Get Entity aksiyonu, sistemde tanımlı tek bir entity’yi (varlık) detaylarıyla birlikte getirmek için kullanılır. Bu aksiyon sayesinde belirli bir entity’ye ait temel bilgiler (adı, açıklaması, kategorisi) ve isteğe bağlı olarak attribute ve attribute value (değer) bilgileri alınabilir.

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, bir entity’nin detay sayfasında, düzenleme formlarında veya ilişkili veri işlenmesi gereken durumlarda sıkça kullanılır.

Teknik Özellikler

Entity Getirme (EAV Paneli): Get Entity aksiyonu aşağıdaki parametrelerle çalışır:
- Id (Guid - Zorunlu): Getirilecek entity’nin sistemdeki benzersiz kimliğidir. Symbol Picker ile sabit (Fixed) veya dinamik olarak tanımlanabilir.
- IncludeAttributes (Boolean - Opsiyonel): true olarak ayarlandığında entity’ye ait attribute (öznitelik) listesi de döner.
- IncludeValues (Boolean – Opsiyonel): true olarak ayarlandığında, sadece attribute tanımları değil, entity’e ait kayıtların bu attribute’lara karşılık gelen değerleri de getirilir (örneğin, “Doğum Tarihi” attribute’u için “John – 12.03.1990”, “Maria – 05.06.1985” gibi).
Veri Kaynağı Uyumluluğu:
- Id: Fixed, Form Component, Screen Input, Action Result, vb.
- IncludeAttributes / IncludeValues: Fixed (true / false) ya da Screen Input ile dinamik olarak belirlenebilir.
Web & Mobil Destek: Get Entity aksiyonu hem web hem de mobil uygulamalarda çalışır.

Get Entity Aksiyonu Uygulama Adımları

1. UI Üzerinde Entity Seçimi

Kullanıcının detayını görmek istediği entity bir tablo ya da listeden seçilir.
Seçilen entity’nin Id bilgisi alınır.

2. Aksiyon Tanımlama

+ ADD ACTION > OnClick / OnLoad > EAV > Entity > Get Entity

Parametreler yapılandırılır:
- Id: Symbol Picker > Selected Item / Form Component / Fixed
- IncludeAttributes: Fixed > true (isteğe bağlı)
- IncludeValues: Fixed > true (isteğe bağlı)

3. Aksiyon Sonucunun Kullanımı

Sonuç; bir Set Value, Label, Dynamic Form veya özel elementle ekrana yazdırılabilir.
Attribute’lar Dynamic Form elementine yüklenerek düzenlenebilir hale getirilir.

Kullanım Senaryosu: Entity Detayını Görüntüleme ve Düzenleme

Kullanıcı entity listesinden bir satıra tıklar.
Get Entity aksiyonu çalışır.
Seçilen entity’nin adı, açıklaması ve ona ait tüm attribute ve değer bilgileri çekilir.
Bu bilgiler form bileşenlerinde gösterilir.
Kullanıcı gerekli düzenlemeleri yapabilir.

‍

Get Entity Aksiyonu İleri Seviye Özelleştirmeler

Koşullu Getirme: Yetki durumuna veya seçim kontrolüne göre çalıştırılabilir.
Verileri Otomatik Formlara Yayma: Getirilen entity bilgisi, Set Value aksiyonları ile farklı elementlere dağıtılabilir.
Ön Belleğe Alma: Aksiyon sonucu Set Variable ile cache'lenerek tekrar sorgular azaltılabilir.

Teknik Riskler

Geçersiz veya Eksik ID: Id parametresi boş ya da yanlışsa aksiyon başarısız olur.
IncludeAttributes / IncludeValues Performansı: Özellikle çok sayıda attribute veya değer varsa veri boyutu artabilir; mobilde dikkatli kullanılmalıdır.
Attribute Uyumsuzluğu: Getirilen attribute’ların beklenen veri tipi veya formatla uyumlu olduğundan emin olunmalıdır.

Get Entity aksiyonu, Kuika’da entity odaklı veri akışlarını kontrol etmek, formları önceden doldurmak ve varlık detaylarını işlemeye hazır hale getirmek için güçlü bir araçtır. Esnek parametre yapısı sayesinde hem basit detay alma hem de kapsamlı veri hazırlığı işlemleri için kullanılabilir.