Kullanıcı Kılavuzu

Update Attribute

27/7/25
Update Attribute

Kuika’nın Update Attribute aksiyonu, EAV (Entity-Attribute-Value) veri modeli kapsamında daha önce oluşturulmuş bir özniteliği (attribute) güncellemek için kullanılır. Bu aksiyon sayesinde kullanıcılar ya da yöneticiler, attribute’un adını, veri tipini, açıklamasını, zorunluluk durumunu veya varsayılan değerini değiştirebilir. Dinamik veri yapılarında esneklik ve sürdürülebilirlik için kritik bir elementtir.

Bir CRM uygulamasında, müşteri kayıtlarında “İletişim Tercihi” adında bir attribute bulunmaktadır ve başlangıçta bu alan String tipinde serbest metin olarak tanımlanmıştır. Ancak ilerleyen süreçte, yöneticiler bu alanın sadece belirli seçeneklerle (örneğin “Telefon”, “E-posta”, “SMS”) sınırlanmasını ister. Bu durumda, Update Attribute aksiyonu ile veri tipi String’den Dropdown (Seçim Listesi) tipine değiştirilir, açıklama güncellenir ve zorunluluk durumu ihtiyaca göre ayarlanır.

Bu sayede, sistem canlı ortamdayken kullanıcı ihtiyaçlarına göre esnek şekilde güncellenir ve veri kalitesi artırı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.

Teknik Özellikler

  • Attribute Güncelleme: Update Attribute aksiyonu, aşağıdaki zorunlu ve opsiyonel parametrelerle çalışır. 
    • Zorunlu Parametreler:
      • Id (Guid): Güncellenecek attribute’un sistemdeki benzersiz kimliğidir.
      • Name (String): Attribute’un yeni ya da güncellenmiş ismidir.
      • DataType (String): Attribute’un veri tipidir. String, Integer, Decimal, Boolean, Date gibi sistem destekli veri tipleri girilmelidir.
    • Opsiyonel Parametreler:
      • Description (String): Attribute için açıklayıcı bilgi.
      • CategoryId (Guid): Attribute’un ait olduğu kategori kimliği.
      • IsRequired (Boolean): Attribute’un doldurulmasının zorunlu olup olmadığını belirtir.
      • DefaultValue (Any): Attribute’un varsayılan değeri.
  • Veri Kaynağı Uyumluluğu: Tüm parametreler, Kuika’daki Symbol Picker üzerinden aşağıdaki kaynaklarla dinamik veya sabit olarak tanımlanabilir:
    • Component (Text Input, Switch vb.)
    • Fixed
    • Screen Input
    • Action Result
    • Current
  • Web & Mobil Destek: Update Attribute aksiyonu hem web hem de mobil senaryolarda kullanılabilir.

Update Attribute Aksiyonu Uygulama Adımları

1. UI Design’da Gerekli Formu Oluşturma

  • Güncellenecek attribute verilerini göstermek ve düzenlemek için bir Dynamic Form ekranı hazırlanır.
  • Gerekli elementler:
    • Text Input → Name
    • Select Box → DataType
    • Text Input → Description (opsiyonel)
    • Switch / Checkbox → IsRequired
    • Text / Number Input → DefaultValue
    • SelectBox (veya sabit) → CategoryId
    • Button → “Güncelle”

2. Get Attribute Aksiyonu ile Formu Doldurma

  • Sayfa yüklendiğinde veya bir attribute seçildiğinde Get Attribute aksiyonu çalıştırılır.
  • Dönen bilgiler Dynamic Form elementine dağıtılır (binding yapılır).

3. Update Attribute Aksiyonunu Ekleme

  • “Güncelle” butonuna tıklanıldığında:
    • + ADD ACTION > OnClick > EAV > Attribute > Update Attribute aksiyonu seçilir.
    • Parametreler Dynamic Form elementinden alınır:
  • Id → Symbol Picker > Action Result > Get Attribute > Id
  • Name → Symbol Picker > Form Component > Text Input
  • DataType → Symbol Picker > Form Component > SelectBox
  • Description → (opsiyonel)
  • IsRequired → (opsiyonel)
  • DefaultValue → (opsiyonel)
  • CategoryId → (opsiyonel)

4. Güncelleme Sonucunu İşleme

  • Başarılı işlem sonrası kullanıcıya modal ile bildirim gösterilebilir.
  • Dynamic Form otomatik olarak temizlenebilir veya liste güncellenebilir.

Kullanım Senaryosu: Ürün Özelliği (Attribute) Detaylarını Güncelleme

Bir e-ticaret platformunda, ürün yöneticisi sistemde daha önce tanımlanmış bir attribute’un adını, veri tipini veya varsayılan değerini değiştirmek ister. Örneğin, “referans_sayisi” olarak tanımlanmış bir attribute, daha anlaşılır olması için “referans_adedi” olarak güncellenmek istenir.

Adımlar:

  1. Yönetici, admin panelindeki attribute listesinden “referans_sayisi” adlı attribute’u seçer.
  2. Sistem, Get Attribute aksiyonu ile mevcut bilgileri (Name: referans_sayisi, DataType: Integer, DefaultValue: 0 vb.) formda gösterir.
  3. Yönetici, formda attribute adını “referans_adedi” olarak değiştirir; veri tipini Integer olarak bırakır ve gerekiyorsa açıklamayı günceller.
  4. “Güncelle” butonuna tıklayınca, Update Attribute aksiyonu çalışır ve attribute sistemde yeni haliyle kaydedilir.

Bu işlem sonrası, attribute hem kullanıcı arayüzünde hem de veri yapısında yeni adıyla görünür ve kullanıma devam eder.

Update Attribute Aksiyonu İleri Seviye Özelleştirmeler

  • Değişiklik Kontrolü: Eski ve yeni değer karşılaştırılarak yalnızca farklı alanlar güncellenebilir.
  • Validasyonlar: Boş alan, geçersiz veri tipi veya çakışan isim gibi kontroller aksiyon öncesinde yapılabilir.
  • Koşullu Güncellemeler: Belirli kullanıcı rollerine göre güncelleme hakkı verilebilir.

Teknik Riskler

  • Zorunlu Alanların Eksikliği: Id, Name veya DataType girilmediğinde sistem işlem yapmaz.
  • Geçersiz Veri Tipi: Desteklenmeyen bir DataType girilirse sistem hata verebilir.
  • Çakışan İsimler: Aynı kategori altında aynı isimde başka bir attribute varsa sistem güncellemeyi reddedebilir.
  • Beta Sürüm Riski: Özellik beta aşamasındadır; bazı kenar durumlarda beklenmeyen davranışlar olabilir.

Update Attribute aksiyonu, Kuika platformunda dinamik veri yapılarının sürdürülebilirliğini sağlamak için kullanılır. Kullanıcıların sistemdeki attribute’ları hızlı ve güvenli biçimde düzenleyebilmesini mümkün kılar. Beta sürümde olmasına rağmen, doğru yapılandırıldığında güçlü bir esneklik ve yönetilebilirlik sunar.

İlişkili diğer içerikler

No items found.

Sözlük

No items found.

Alt Başlıklar