Create Category

Create Category

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 InputKategori Adı (Name)
    • Text InputAçı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.

İlişkili diğer içerikler

No items found.

Sözlük

No items found.

Alt Başlıklar