Kullanıcı Kılavuzu

Set Entity Attribute Value

28/7/25

Kuika’nın Set Entity Attribute Value aksiyonu, belirli bir entity’ye (varlık) ait bir attribute’un (öznitelik) değerini sistemde güncellemek veya ilk kez atamak için kullanılır. Bu aksiyon sayesinde dinamik veriler esnek biçimde kaydedilebilir ve güncellenebilir.

Örneğin, bir kullanıcı sipariş formunda teslimat notu alanını doldurduğunda, bu bilgi "DeliveryNote" attribute’u olarak Orders entity’sine ait ilgili sipariş kaydına atanabilir. Böylece sistemde daha önce tanımlı olmayan bir bilgi sonradan kolaylıkla eklenmiş veya mevcut bilgi güncellenmiş olur. Bu esneklik, kullanıcıdan alınan verilerin gerçek zamanlı olarak yönetilmesini sağlar.

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, kullanıcı girişlerinin veriyle eşleştirilmesinde, dinamik formların backend'e veri göndermesinde ve özelleştirilmiş veri yönetiminde kritik rol oynar.

Teknik Özellikler

Attribute Değeri Ayarlama (EAV Paneli): Set Entity Attribute Value aksiyonu aşağıdaki zorunlu parametrelerle çalışır:
- EntityId (Guid - Zorunlu): Değeri atanacak entity’nin benzersiz kimliğidir.
- AttributeId (Guid - Zorunlu): Değeri ayarlanacak attribute’un kimliğidir.
- Value (Any - Zorunlu): Attribute’a atanacak yeni değerdir. Veri tipi, attribute’un DataType’ı ile uyumlu olmalıdır (örneğin: String, Integer, Boolean, Date vs.).
Veri Kaynağı Uyumluluğu:Tüm parametreler Symbol Picker ile aşağıdaki kaynaklardan alınabilir:
- Form Component (kullanıcının girdiği veri)
- Action Result
- Fixed
- Current
Web & Mobil Destek: Set Entity Attribute Value aksiyonu hem web hem de mobil uygulamalarda çalışır.

Set Entity Attribute Value Aksiyonu Uygulama Adımları

1. Kullanıcıdan Giriş Almak

Form bileşenleriyle kullanıcıdan veri toplanır (örneğin metin kutusu, tarih seçici).
Formdan alınan veri Value parametresine aktarılır.

2. Aksiyon Ekleme

“Kaydet”, “Güncelle” veya form gönderim butonuna şu aksiyon eklenir:
- + ADD ACTION > OnClick > EAV > Entity Attribute Value > Set Entity Attribute Value

Parametreler ayarlanır:
- EntityId: Symbol Picker > Form Component / Select Box / Action Result
- AttributeId: Symbol Picker > Select Box / Fixed
- Value: Symbol Picker > Form Component

3. Sonucun Kullanımı

İşlem başarılıysa:
- Bilgi mesajı gösterilebilir.
- Sayfa yönlendirmesi yapılabilir
- Form sıfırlanabilir (Clear Dynamic Form)
Hatalı giriş varsa kullanıcıya uyarı gösterilebilir.

Kullanım Senaryosu: Profil Bilgisi Güncelleme

Bir kullanıcı kendi profilinde “Telefon Numarası” alanını günceller:

Kullanıcı numarayı form bileşenine girer.
“Güncelle” butonuna tıklanır.
Set Entity Attribute Value aksiyonu çalışır.
Yeni telefon numarası, ilgili entity’ye ve attribute’a kaydedilir.

‍

Set Entity Attribute Value Aksiyonu İleri Seviye Özelleştirmeler

Koşullu Değer Atama: Belirli bir koşul sağlanırsa farklı bir değer atanabilir (If aksiyonlarıyla).
Çoklu Değer Güncelleme: Farklı Set Entity Attribute Value aksiyonları zincir halinde çalıştırılarak tüm form alanları güncellenebilir.
Geri Bildirim Mekanizması: Başarılı güncellemeler sonrası kullanıcıya “Bilgileriniz başarıyla güncellendi” mesajı gösterilebilir.
Formdan Otomatik Değer Alımı: Value parametresi doğrudan dinamik formdan alınabilir ve form component ID'siyle eşleştirilebilir.

Teknik Riskler

Eksik veya Geçersiz ID’ler: EntityId ve AttributeId eksik veya sistemde kayıtlı değilse işlem başarısız olur.
Veri Tipi Uyumsuzluğu: Girilen Value, attribute’un tanımlı DataType’ı ile uyuşmuyorsa sistem hata verebilir.
Boş Değer Problemleri: Gerekli attribute’lara boş değer atanması veri tutarsızlığına yol açabilir (özellikle IsRequired=true olan attribute’larda).

Set Entity Attribute Value aksiyonu, Kuika platformunun dinamik ve kullanıcıya özel veri yönetimi altyapısının en temel parçalarından biridir. Özellikle EAV modelini kullanan uygulamalarda veri güncellemeyi sadeleştiren, esnek ve güçlü bir araçtır.

İlişkili diğer içerikler

No items found.

Sözlük

No items found.

Alt Başlıklar

Get Entity Attribute Values

Delete Entity Value