Update Entity

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)

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

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

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

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.