Kuika’nın Update Entity aksiyonu, sistemde mevcut bir entity'nin (varlık) bilgilerini güncellemek için kullanılır. Bu aksiyon sayesinde entity’nin adı, açıklaması ve ait olduğu kategori gibi temel bilgileri dinamik olarak değiştirilebilir. Özellikle yönetim panellerinde ya da kullanıcıya özel veri modellemesi yapılan 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, bir entity’yi yeniden adlandırmak, açıklama eklemek veya kategori değişikliği yapmak gibi işlemler için uygundur. Güncellenen entity bilgisi, sistemdeki attribute yapısını etkilemeden kaydedilir.

Teknik Özellikler

Entity Güncelleme (EAV Paneli): Update Entity aksiyonu şu parametrelerle çalışır:
- Id (Guid - Zorunlu): Güncellenecek entity’nin sistemdeki benzersiz kimliğidir. Formdan, listeden ya da sabit olarak alınabilir.
- Name (String - Zorunlu): Entity’nin yeni adıdır. Boş bırakılamaz.
- Description (String - Opsiyonel): Entity’ye ait açıklayıcı bilgi alanıdır. Kullanıcılara ya da geliştiricilere bilgi sağlar.
- CategoryId (Guid - Opsiyonel): Entity’nin ait olduğu kategori ID’sidir. Kategori yapısını değiştirmek için kullanılabilir.
Veri Kaynağı Uyumluluğu Parametreler, Symbol Picker üzerinden aşağıdaki kaynaklardan alınabilir:
- Id, Name: Form Component, Current, Action Result, Fixed
- Description, CategoryId: Form Component, Fixed, Action Result, vb.
Web & Mobil Destek: Update Entity aksiyonu hem web hem de mobil uygulamalarda çalışır.

Update Entity Aksiyonu Uygulama Adımları

1. Düzenleme Formu Oluşturma

Kullanıcıya entity bilgilerini güncelleyebileceği bir form gösterilir:
- Entity Adı (Text Input) → Name
- Açıklama (Text Area) → Description (opsiyonel)
- Kategori Seçimi (Select Box) → CategoryId (opsiyonel)

2. Aksiyon Tanımlama

“Kaydet” butonuna şu aksiyon eklenir:
- + ADD ACTION > OnClick > EAV > Entity > Update Entity

Parametreler Symbol Picker ile eşlenir:
- Id: Form Component veya Seçili Satır
- Name: Text Input
- Description: Opsiyonel alan
- CategoryId: Opsiyonel alan (Select Box)

3. Aksiyon Sonrası Kullanım

Güncelleme tamamlandığında:
- Kullanıcıya bilgi mesajı gösterilir (ör. Show Toast)
- Liste veya detay ekranı yenilenir (Refresh Data)
- Başka bir sayfaya yönlendirme yapılabilir (Navigate)

Kullanım Senaryosu: Entity Bilgilerini Güncelleme

Bir yönetici panelinde, kullanıcı sistemdeki bir entity’nin adını ve açıklamasını değiştirmek ister.

Entity bilgileri formda gösterilir.
Kullanıcı düzenleme yapar.
“Güncelle” butonuna basıldığında Update Entity aksiyonu çalışır.

Güncel bilgiler kaydedilir ve kullanıcıya başarı mesajı gösterilir.

Update Entity Aksiyonu İleri Seviye Özelleştirmeler

1. Koşullu Güncelleme: Kullanıcının yaptığı değişiklikleri kontrol ederek sadece gerçekten değişen alanların güncellenmesini sağlayabilirsin. Örneğin:

If aksiyonu ile yeni Name değeri mevcut değerden farklıysa güncelleme işlemi yapılır.
Böylece gereksiz API çağrılarından kaçınılır.

2. Otomatik Kategori Atama: Entity oluşturulurken ya da güncellenirken, kullanıcının ekran ya da rolüne göre CategoryId dinamik olarak belirlenebilir. Örneğin:

Belirli kullanıcılar sadece belirli kategori ID’lerine güncelleme yapabilir.

3. Form Validasyonu: Update işlemi öncesinde form alanlarının doğruluğu kontrol edilebilir. Özellikle Name alanının boş olup olmadığı, özel karakter içerip içermediği gibi kontroller yapılabilir.

4. Güncelleme Sonrası Zincirleme Aksiyonlar: Entity güncellemesi tamamlandıktan sonra:

İlgili listeyi Refresh etmek
Güncellenen veriyi başka bir form alanına set etmek (Set Value)
Güncellenen bilgiyi veri tabanına tekrar kaydetmek veya loglamak gibi zincirleme işlemler yapılabilir.

5. Geri Bildirim ve Takip: Güncelleme işlemi sonrası:

Kullanıcıya özel bilgi mesajı gösterilebilir (Show Toast)
Hatalı güncellemelerde özel hata mesajı veya uyarı ile yönlendirme yapılabilir
İşlemler loglanarak denetlenebilirlik sağlanabilir

6. Yetkiye Bağlı Güncelleme Yeteneği: Kullanıcının rolüne göre sadece belirli alanların güncellenmesine izin verilebilir. Örneğin:

Yönetici, hem adı hem kategoriyi değiştirebilir
Son kullanıcı sadece açıklamayı değiştirebilir

Teknik Riskler

Eksik Zorunlu Alanlar: Id ve Name parametreleri boş ya da geçersizse aksiyon başarısız olur.
Kategori ID Uyuşmazlığı: Geçerli olmayan bir CategoryId verilirse entity yanlış gruplanabilir.
Veri Çakışması: Aynı ada sahip başka bir entity varsa kullanıcı bilgilendirilmeli.

Update Entity aksiyonu, Kuika platformunda varlık yönetimini esnek ve dinamik hale getiren temel araçlardan biridir. Entity’lerin güncel tutulması, kategori bazlı organizasyon yapılması ve kullanıcı dostu formlar oluşturulması için güçlü bir altyapı sunar.