Kuika’nın Create Category aksiyonu, EAV (Entity-Attribute-Value) veri modeli kapsamında yeni bir kategori (category) tanımlamak için kullanılır. Bu aksiyon, attribute’ların gruplanması, yönetiminin kolaylaştırılması ve hiyerarşik yapıların oluşturulması amacıyla kullanılır. Özellikle büyük sistemlerde alanların düzenli bir şekilde sınıflandırılmasına olanak tanı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

Kategori Tanımlama (EAV Paneli): Create Category aksiyonu aşağıdaki parametrelerle çalışır:
- Zorunlu Parametre:
  - Name (String): Oluşturulacak kategorinin sistemdeki adıdır. Kategoriyi tanımlayan benzersiz ve anlamlı bir isim olmalıdır.
- Opsiyonel Parametreler:
  - Description (String): Kategorinin açıklamasıdır. Kullanıcıya veya geliştiriciye kategori hakkında bilgi vermek için kullanılır.
  - ParentId (Guid): Oluşturulacak kategorinin üst (parent) kategorisinin ID’sidir. Bu alan sayesinde kategoriler hiyerarşik yapıda tanımlanabilir.
Veri Kaynağı Uyumluluğu: Tüm parametreler Kuika’daki Symbol Picker aracılığıyla aşağıdaki kaynaklardan tanımlanabilir:
- Fixed
- Form Component (Text Input, Select Box)
- Screen Input
- Action Result
- Current
Web & Mobil Destek: Create Category aksiyonu hem web hem de mobil uygulamalarda çalışır.

Create Category Aksiyonu Uygulama Adımları

1. UI Design'da Kategori Tanımlama Dynamic Form Oluşturma

Yeni kategori eklenmesi planlanan bir ekran açılır.
Aşağıdaki Dynamic Form elementine aşağıdaki elementler eklenir:
- Text Input → Kategori Adı (Name)
- Text Input → Açıklama (Description) - Opsiyonel
- Select Box → Üst Kategori (ParentId) - Opsiyonel
- Button → "Kategori Oluştur"

2. Aksiyon Ekleme

“Kategori Oluştur” butonuna tıklanıldığında:
- + ADD ACTION > OnClick > EAV > Category > Create Category aksiyonu eklenir.
- Parametre eşleşmeleri:

Name → Symbol Picker > Form Component > Text Input
Description (Opsiyonel) → Symbol Picker > Form Component > Text Input
ParentId (Opsiyonel) → Symbol Picker > Component > Select Box / Fixed Guid

3. Başarı veya Hata Sonucu Gösterme

Kategori başarıyla oluşturulduğunda kullanıcıya toast bildirimi gösterilebilir.
Hatalı ya da eksik girişler için önceden validasyon yapılabilir (örneğin Name boşsa uyarı göster).

Kullanım Senaryosu: Hiyerarşik Kategori Oluşturma

Bir yönetici panelinde, sistemdeki alanların gruplanması için kategoriler tanımlanmak istenir. Örneğin:

Üst kategori: "Kullanıcı Bilgileri"
Alt kategori: "İletişim Bilgileri"
Description: “Telefon ve e-posta gibi alanları içerir.”
ParentId: “Kullanıcı Bilgileri” kategorisinin ID’si

Bu senaryoda, kullanıcı önce üst kategoriyi oluşturur, ardından alt kategoriyi tanımlarken ParentId olarak üst kategoriyi seçer.

‍

Create Category Aksiyonu İleri Seviye Özelleştirmeler

Kategori Listesinin Güncellenmesi: Yeni kategori oluşturulduktan sonra sayfa üzerindeki kategori Select Box’ı yeniden yüklenebilir.
Koşullu Görünürlük: Sadece yöneticiler için kategori oluşturma alanı gösterilebilir.
Hiyerarşik Görselleştirme: Kategoriler ağaç (tree) yapısında bir listede gösterilebilir.

Teknik Riskler

Boş veya Yinelenen İsim: Name parametresi boş bırakılmamalı ve aynı isimde bir kategori daha önce oluşturulmuşsa sistem hata verebilir.
Geçersiz ParentId: Tanımlı olmayan bir ParentId girilmesi durumunda işlem başarısız olabilir.
Beta Sürüm Riski: Aksiyon beta aşamasında olduğundan istikrarsızlık veya geçici sınırlamalar olabilir.

Create Category aksiyonu, Kuika platformunda attribute gruplarını mantıklı, düzenli ve sürdürülebilir şekilde organize etmek için kullanılır. Kategori sisteminin hiyerarşik yapıya uygun şekilde tanımlanmasını ve dinamik olarak genişletilebilmesini sağlar. Özellikle çok sayıda alanla çalışan uygulamalarda büyük kolaylık ve ölçeklenebilirlik sunar.