Kuika’nın Create Entity aksiyonu, EAV (Entity-Attribute-Value) veri modeli kapsamında yeni bir Entity (Varlık) tanımlamak için kullanılır. Entity’ler, dinamik formlarda kullanılan attribute’ların gruplanmasını ve mantıksal olarak bir varlık altında toplanmasını sağlar. Bu aksiyon, sistemde yeni bir varlık tipi oluşturmak isteyen uygulamalarda kullanılı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.

Bu aksiyon ile tanımlanan entity, attribute’larla birlikte çalışarak dinamik formların temelini oluşturur. Her entity, bir kategoriye ait olabilir ve açıklama ile desteklenebilir.

Teknik Özellikler

Entity Tanımlama (EAV Paneli): Create Entity aksiyonu aşağıdaki parametrelerle çalışır:
- Name (String - Zorunlu): Oluşturulacak entity’nin sistemdeki benzersiz adıdır. Boş bırakılamaz.
- Description (String - Opsiyonel): Entity hakkında bilgi veren açıklama alanıdır. Geliştirici ya da son kullanıcıya rehberlik sağlar.
- CategoryId (Guid - Opsiyonel): Entity’nin ait olduğu kategori kimliğidir. Category sistemiyle entity’ler gruplandırılarak daha organize bir yapı elde edilebilir.
Veri Kaynağı Uyumluluğu: Tüm parametreler Kuika Symbol Picker arayüzüyle aşağıdaki kaynaklardan alınabilir:
- Form Component
- Fixed (sabit metin veya guid)
- Screen Input / Current / Action Result
Web & Mobil Destek: Create Entity aksiyonu hem web hem de mobil uygulamalarda çalışır.

Create Entity Aksiyonu Uygulama Adımları

1. Kullanıcı Arayüzünde Form Tanımı

Kullanıcıdan alınacak entity bilgileri için bir form hazırlanır.
- Entity Adı (Text Input)
- Açıklama (Opsiyonel - Text Input)
- Kategori Seçimi (Select Box veya Text Input - Guid)

2. Aksiyon Tanımlama

“Entity Oluştur” adında bir buton oluşturulur.

Buton üzerine şu aksiyon eklenir:
- + ADD ACTION > OnClick > EAV > Entity > Create Entity

Parametreler şu şekilde yapılandırılır:
- Name: Symbol Picker > Form Component > Text Input
- Description: Symbol Picker > Form Component (isteğe bağlı)
- CategoryId: Symbol Picker > Fixed veya Component

3. Aksiyon Sonucu Kullanımı

Oluşturulan entity, formda attribute tanımlamalarıyla ilişkilendirilebilir.
Aksiyon sonrası kullanıcıya bildirim gösterilebilir veya başka bir sayfaya yönlendirme yapılabilir.

Kullanım Senaryosu: Dinamik Başvuru Süreci Tanımlama

Bir İK uygulamasında, her başvuru türü için özel formlar oluşturulmak istenir. Her formun kendi entity’si olur:

Kullanıcı “Yeni Başvuru Türü Oluştur” formunu doldurur.
“Kaydet” butonuna basıldığında Create Entity aksiyonu çalışır.
Sistem, “iş başvurusu”, “staj başvurusu” gibi yeni varlıkları tanımlar.
Bu entity’lere daha sonra attribute’lar (örneğin "mezuniyet yılı", "referans sayısı") eklenir.

‍

Create Entity Aksiyonu İleri Seviye Özelleştirmeler

Koşullu Oluşturma: Aynı isimde entity olup olmadığı kontrol edilerek tekrarlayan kayıtlar engellenebilir (If, Get Entities, Filter, vb.).
Kategoriye Göre Otomatik Atama: Ekrana göre CategoryId parametresi otomatik olarak belirlenebilir.
Sonuç Kaydetme: Oluşturulan entity’nin ID bilgisi başka bir aksiyonda kullanılabilir (Action Result üzerinden).

Create Entity aksiyonu, Kuika’nın EAV altyapısında temel yapı taşı olan varlıkların sistemde dinamik olarak tanımlanmasını sağlar. Bu sayede kullanıcıya özel veri yapılandırmaları, özelleştirilebilir formlar ve gelişmiş veri organizasyonları mümkün hale gelir.