Kuika’nın Get Entities aksiyonu, sistemde tanımlı tüm entity (varlık) kayıtlarını listelemek için kullanılır. Bu aksiyon, kullanıcıya ait ya da sistem genelinde tanımlanmış entity’lerin dinamik olarak alınmasını sağlar. Elde edilen veriler, listeleme, filtreleme, veya ilişkili veri işleme gibi işlemler için kullanılabilir.

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 opsiyonel parametrelerle esnek hale getirilebilir; sadece belirli bir kategoriye ait entity’ler ya da içerdikleri attribute ve değer bilgileriyle birlikte alınabilir.

Teknik Özellikler

Entity Listeleme (EAV Paneli): Get Entities aksiyonu aşağıdaki opsiyonel parametrelerle çalışabilir:
- CategoryId (Guid - Opsiyonel): Sadece belirli bir kategoriye ait entity’leri filtrelemek için kullanılır. Symbol Picker ile Fixed, Form Component, Action Result gibi kaynaklardan alınabilir.
- IncludeAttributes (Boolean - Opsiyonel): true olarak ayarlanırsa, her entity ile birlikte ona ait attribute bilgileri 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: Tüm parametreler Symbol Picker arayüzüyle şu kaynaklardan alınabilir:
- Fixed (sabit değer)
- Form Component
- Action Result
- Screen Input
Web & Mobil Destek: Get Entities aksiyonu hem web hem de mobil uygulamalarda çalışır.

Get Entities Aksiyonu Uygulama Adımları

1. Aksiyon Tanımlama

Örneğin bir ekran yüklendiğinde ya da kullanıcı bir filtre seçtiğinde:
- + ADD ACTION > OnLoad / OnClick > EAV > Entity > Get Entities aksiyonu eklenir.

Parametreler şu şekilde ayarlanabilir:
- CategoryId: Symbol Picker > Select Box > [Kategori seçimi]
- IncludeAttributes: Fixed > true (isteğe bağlı)
- IncludeValues: Fixed > true (isteğe bağlı)

2. Aksiyon Sonucunun Kullanımı

Aksiyon sonucu, Table, Select Box vb. veri olarak kullanılabilir.
Her entity objesi:
- id, name, description, categoryId
- (IncludeAttributes=true ise) attributes[]
- (IncludeValues=true ise) attributeValues[]
  içerir.

Kullanım Senaryosu: Kategoriye Göre Varlık Listeleme

Bir kullanıcı, sol menüden bir kategori seçer ve o kategoriye ait entity’lerin listelenmesini ister:

Kullanıcı Kategori Seç Select Box’ından bir kategori seçer.
Seçilen kategoriye göre Get Entities aksiyonu çalışır.
Elde edilen entity’ler, Table elementinde gösterilir.

IncludeAttributes ve IncludeValues parametreleri true yapılarak, entity detayları (örneğin “bu entity hangi alanları içeriyor, hangi değerler girilmiş”) da dinamik olarak gösterilebilir.

Get Entities Aksiyonu İleri Seviye Özelleştirmeler

Koşullu Yükleme: If aksiyonlarıyla sadece belirli koşullarda yüklenebilir.
Arama / Filtreleme: Kullanıcının metinle arama yapması sağlanabilir (örneğin name contains "xyz").

Teknik Riskler

Kategoride Hiç Entity Yoksa: Aksiyon sonuç listesi boş döner, bu durum UI’da yönetilmelidir.
IncludeAttributes & IncludeValues Kullanımı: Bu parametreler veri boyutunu artırabilir, özellikle mobilde dikkatli kullanılmalıdır.
Entity Verisi ile Uyum: Kullanılacak bileşenlerde veri yapısının doğru eşleştirildiğinden emin olunmalıdır.

Get Entities aksiyonu, Kuika platformunda entity bazlı veri yönetimini ve listeleme işlemlerini kolaylaştıran temel araçlardan biridir. Opsiyonel parametreleri sayesinde hem sade hem de kapsamlı veri çekme ihtiyaçlarına uyum sağlar.