Get From Bag aksiyonu, Kuika platformunda belirli bir sepete (bag) ait verileri sistemden okumak için kullanılan bir aksiyondur. Bu aksiyon sayesinde daha önce Add to Bag ile sepete eklenen içerikler alınarak, ekranda listelenebilir, detayları görüntülenebilir ya da iş akışlarında kullanılabilir. E-ticaret, rezervasyon ve form önbellekleme gibi uygulamalarda kullanıcıya özel veri akışını sürdürmek için idealdir.
Teknik Özellikler
Sepet Verilerini Getirme: Belirtilen bag key ile ilişkili tüm verileri getirir.
Veri Listeleme ve İşleme: Gelen veriler ekran bileşenlerine, listelere veya hesaplamalara aktarılabilir.
Web ve Mobil Uyumluluk: Hem web hem de mobil projelerde tam uyumla çalışır.
Veri Güncelliği: Sepete sonradan eklenen ya da çıkarılan öğeler anlık olarak görüntülenebilir.
Sol kenardaki Elements panelinden Table elementini ekleyin.
Ekran yüklendiğinde verilerin getirilmesini sağlamak için, ekranın Properties panelinden
+ ADD ACTION → uygun tetikleyici (Initial Actions, OnClick, vb.) → Bag → Get From Bag aksiyonunu ekleyin.
Aksiyon Parametrelerini Yapılandırma
Bag Key (Zorunlu): Sepetin kimliğini belirten değer. Bu parametre sabit olarak girilir. Örnekler:
"default" (varsayılan sepet)
"wishlist" (favoriler sepeti)
"user_" + currentUser.id + "_cart" (kullanıcıya özel sepet)
Veriyi Table Elementine Bağlama
Aksiyonun çıktısını, listeleme bileşeninin Items veya Data özelliğine bağlayarak kullanıcıya ürünleri gösterin.
Örneğin: TableView.Items → Action Result > Get From Bag
Bu yapı sayesinde kullanıcı, ilgili sepette yer alan ürünleri ekran yüklendiğinde otomatik olarak görebilir.
Kullanım Senaryosu: Kullanıcının Sepetindeki Ürünleri Listeleme
Bir e-ticaret uygulamasında, kullanıcı “Sepetim” ekranına girdiğinde daha önce eklenen ürünlerin gösterilmesi gerekir. Bu işlem için Get From Bag aksiyonu kullanılarak ilgili sepet verileri alınır ve liste bileşeni ile kullanıcıya sunulur.
Yapılandırma Adımları:
UI Design modülünde “Sepetim” ekranını oluşturun.
Liste bileşenini (ListView, Table, vb.) ekleyin.
Ekrandaki bir butonun OnClick olayına şu aksiyonu tanımlayın:
+ ADD ACTION → Bag → Get From Bag
Parametre olarak Bag Key değerini girin:
Örnek: "default" ya da "currentUser.id + '_bag'" gibi.
Aksiyon sonucunu Table elementinin veri kaynağına bağlayarak kullanıcıya içerikleri gösterin.
Get From Bag Aksiyonu İleri Seviye Özelleştirmeler
Koşullu Gösterim: Gelen içerikler filtrelenerek belirli kategorilere veya koşullara göre ayrıştırılabilir.
Boş Sepet Mesajı: Eğer dönen veri boşsa, Notify aksiyonu ile “Sepetinizde ürün bulunmamaktadır” mesajı gösterilebilir.
Toplam Tutar Hesaplama: Gelen ürünlerin fiyat bilgileri üzerinden toplam değer dinamik olarak hesaplanabilir.
Teknik Riskler ve Önlemler
Boş veya Hatalı Bag Key: Bag Key değeri boş ya da sistemde tanımlı değilse aksiyon boş veri döner. Doğru key kullanıldığından emin olunmalıdır.
Boş Veri Yönetimi: Eğer sepet boşsa, uygulama hata vermemeli, kullanıcıya uygun bilgi sunulmalıdır.
Get From Bag, kullanıcı etkileşimlerini sürdürmek, seçimleri hatırlamak ve alışveriş süreçlerini tamamlamak için kritik bir aksiyondur. Diğer bag aksiyonlarıyla birlikte kullanıldığında güçlü ve dinamik veri yönetimi sağlar.
