Kuika’nın Get Categories aksiyonu, EAV (Entity-Attribute-Value) veri modeli kapsamında tanımlanmış olan kategori (category) kayıtlarını listelemek için kullanılır. Bu aksiyon, attribute’ların gruplanması, kullanıcıya kategori seçimi sunulması ve hiyerarşik kategori yapılarını oluşturmak için 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

Kategori Listeleme (EAV Paneli): Get Categories aksiyonu aşağıdaki parametreyle çalışır:
- Opsiyonel Parametre:
  - ParentId (Guid): Belirli bir üst kategoriye bağlı olan alt kategorileri listelemek için kullanılır. Eğer bu parametre belirtilmezse, tüm kategoriler veya üst kategoriler getirilir. Bu sayede:
    - Tüm kategori yapısı çekilebilir.
    - Sadece bir kategoriye ait alt kategoriler görüntülenebilir (hiyerarşik yapı oluşturulabilir).
Veri Kaynağı Uyumluluğu: ParentId parametresi aşağıdaki kaynaklardan alınabilir:
- Select Box veya Tree Elementi (üst kategori seçimi)
- Fixed (Sabit Guid)
- Action Result (başka bir aksiyonun çıktısı)
- Current
- Screen Input
Web & Mobil Destek: Get Categories aksiyonu hem web hem de mobil uygulamalarda çalışır.

Get Categories Aksiyonu Uygulama Adımları

1. UI Üzerinde Listeleme Bileşeni Oluşturma

Bir Select Box, Table veya Tree elementi eklenir.
Bu elemente kategori verisi yüklenmek üzere Get Categories aksiyonu bağlanır.

2. Aksiyon Ekleme

Sayfa yüklendiğinde ya da kullanıcı belirli bir üst kategori seçtiğinde:
- + ADD ACTION > OnPageLoad veya OnChange → EAV > Category > Get Categories aksiyonu eklenir.

‍

Opsiyonel olarak ParentId parametresi tanımlanabilir:
- Symbol Picker > SelectBox.SelectedValue
- veya sabit bir Guid

3. Sonuçları UI Elementine Bağlama

Aksiyon sonucu, listeleme elementine Value alanından bağlanır.
Dönen veri genellikle şu formatta olur:
- Id (kategori kimliği)
- Name (kategori adı)
- Description (isteğe bağlı)

Kullanım Senaryosu: Üst Kategoriye Göre Alt Kategorileri Listeleme

Bir kullanıcı, bir kategori sisteminde önce bir üst kategori seçer. Ardından, sistem yalnızca bu kategoriye bağlı alt kategorileri listelemek ister.

Kullanıcı bir Select Box elementinden üst kategoriyi seçer.
Bu seçimle birlikte Get Categories aksiyonu ParentId parametresiyle tetiklenir.
Dönen alt kategoriler bir başka Tree elementi veya Table’da listelenir.
Kullanıcı bu alt kategorilerden birini seçerek işlemine devam eder.

Get Categories Aksiyonu İleri Seviye Özelleştirmeler

Kategorileri Tree Yapıda Gösterme: ParentId değerlerine göre bir ağaç yapısı (Tree) oluşturulabilir.
Boş Liste Durumu: Seçilen üst kategoriye bağlı alt kategori yoksa kullanıcıya “Alt kategori bulunamadı” mesajı gösterilebilir.
Filtreleme: İsteğe bağlı olarak Category Name gibi filtreler de eklenerek veri daraltılabilir.

Teknik Riskler

Geçersiz ParentId: Tanımlı olmayan bir ParentId ile sorgulama yapılırsa boş sonuç dönebilir.
Beta Sürüm Riski: Özellik henüz beta sürümde olduğundan bazı uç senaryolarda kararsız sonuçlar dönebilir.
Veri Formatı Uyumsuzluğu: Aksiyon çıktısı, UI elementiyle uyumlu şekilde yapılandırılmalıdır (Label, Value, Id, Text gibi).

Get Categories aksiyonu, Kuika platformunda EAV veri modeline dayalı kategori yönetiminin dinamik, hiyerarşik ve filtrelenebilir şekilde uygulanmasını sağlar. ParentId parametresiyle birlikte kullanıldığında, kategoriler arasında alt-üst ilişkiler kurulabilir ve kullanıcıya özelleştirilmiş seçim alanları sunulabilir.

‍