Kuika’nın Save Entity Value aksiyonu, dinamik bir model kullanarak bir entity’ye ait attribute değerini oluşturmak veya güncellemek için kullanılır. Bu aksiyonda, tüm gerekli bilgiler tek bir model yapısı içinde toplanır ve sistem bu model üzerinden işlemi gerçekleştirir.

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.

Model parametresi, attribute değerine ait entity bilgisi, attribute kimliği, değer ve diğer opsiyonel alanları içeren kapsamlı bir veri yapısıdır.

Teknik Özellikler

Model (Object - Zorunlu):Attribute değerine ait tüm bilgilerin bulunduğu nesnedir. İçeriğinde genellikle aşağıdaki alanlar bulunur:
- EntityId (Guid)
- AttributeId (Guid)
- Value (Any)
- EntityValueId (Guid) — var ise güncelleme, yoksa yeni kayıt için
- Diğer opsiyonel metadata alanları
Veri Kaynağı Uyumluluğu: Model parametresi, Symbol Picker aracılığıyla şu kaynaklardan seçilebilir:
- Form Component (örneğin dinamik form model objesi)
- Action Result (önceki aksiyon sonucu)
- Fixed (sabit JSON obje)
- Current
Web & Mobil Destek: Save Entity Value aksiyonu hem web hem de mobil uygulamalarda çalışır.

Save Entity Value Aksiyonu Uygulama Adımları

1. Model Nesnesinin Hazırlanması

Dinamik form veya başka bir kaynaktan tüm attribute bilgileri ve değerleri model objesi olarak toplanır.

2. Aksiyon Ekleme

Örneğin “Kaydet” butonuna:
- + ADD ACTION > OnClick > EAV > Entity Value > Save Entity Value

Parametre olarak:
- Model: Symbol Picker > Form Component veya Action Result

3. İşlem Sonucu

Sistem modeldeki bilgilerle yeni bir entity value yaratır veya mevcut kaydı günceller.
Başarı durumunda kullanıcı bilgilendirilebilir.
Hata durumunda uyarı verilebilir.

Kullanım Senaryosu: Dinamik Formdan Veri Kaydetme

Bir uygulamada, kullanıcıların farklı attribute’lardan oluşan dinamik bir formu doldurup bu bilgileri sistemde kaydetmesi gerekir. Bu form alanları, önceden tanımlanmış sabit alanlar olmayıp, kullanıcı veya sistem tarafından dinamik olarak belirlenmiştir.

Senaryo Adımları:

Dinamik Form Oluşturma:
- Uygulama, Get Entity Attributes aksiyonu ile ilgili entity’ye ait attribute yapısını alır.
- Bu attribute bilgilerine göre dinamik form bileşenleri (input, dropdown, checkbox, tarih seçici vb.) oluşturulur.
- Form, her attribute için uygun bileşenleri içerir ve kullanıcıya gösterilir.
Kullanıcı Veri Girişi:
- Kullanıcı formu doldurur. Örneğin:
  - Ad (String)
  - Doğum Tarihi (Date)
  - Abonelik Durumu (Boolean)
  - Referans Sayısı (Integer)
- Girilen her değer, form bileşenleri üzerinde tutulur.
Model Nesnesinin Oluşturulması:
- Formdaki tüm değerler, sistemde tek bir model (JSON objesi) halinde toplanır.
- Model, her attribute için şu bilgileri içerir:
  - EntityId: İlgili varlık kimliği (örneğin müşteri ID’si)
  - AttributeId: Her form alanına karşılık gelen attribute’un ID’si
  - Value: Kullanıcının girdiği değer
  - (Varsa) EntityValueId: Daha önce kaydedilmiş değerin kimliği (güncelleme için)
Save Entity Value Aksiyonunun Tetiklenmesi:
- Kullanıcı formu tamamladıktan sonra “Kaydet” butonuna tıklar.
- Butonun OnClick olayına, form modelini parametre olarak alan Save Entity Value aksiyonu eklenir.
- Bu aksiyon, modeldeki tüm attribute değerlerini sistemde oluşturur veya günceller.
İşlem Sonrası Geri Bildirim:
- Kayıt başarılıysa kullanıcıya “Bilgiler başarıyla kaydedildi” mesajı gösterilir.
- Form sıfırlanabilir veya kullanıcı başka işlemlere yönlendirilebilir.
- Eğer hata varsa, uygun hata mesajı sunulur.

Save Entity Value Aksiyonu İleri Seviye Özelleştirmeler

Toplu Kayıt: Model içinde birden fazla attribute değeri aynı anda taşınabilir.
Versiyon Kontrolü: Güncelleme sırasında versiyon numarası veya tarih bilgisi eklenebilir.
Koşullu Kayıt: Belirli koşullar sağlanırsa kayıt yapılabilir veya iptal edilebilir.
Geri Bildirim: Kayıt sonrası form temizleme, sayfa yenileme veya mesaj gösterme yapılabilir.

Teknik Riskler

Model Yapısı Uyuşmazlığı: Model içindeki alan isimleri ve veri tipleri sistemle tam uyumlu olmalıdır.
Eksik Alanlar: Özellikle EntityId, AttributeId ve Value alanları zorunludur.
Veri Bütünlüğü: Gönderilen değerler attribute’ların DataType’ları ile uyumlu olmalıdır.

Save Entity Value aksiyonu, Kuika platformunda dinamik ve kapsamlı veri kaydetme/güncelleme süreçlerini kolaylaştıran güçlü bir yöntemdir. Model tabanlı yapısı, çoklu veri alanlarının etkin yönetimini sağlar.