Bag Has Key aksiyonu, Kuika platformunda tanımlı bir sepetin (bag) var olup olmadığını kontrol etmek için kullanılır. Bu aksiyon, sepet işlemleri öncesinde koşullu aksiyon akışları kurmak, kullanıcıya özel sepet mantığı geliştirmek veya sepetin içeriğini önceden doğrulamak amacıyla kullanılır. Özellikle koşullu görünürlük, buton aktifliği ya da otomatik yönlendirme gibi senaryolarda önemli rol oynar.

Teknik Özellikler

Sepet Varlık Kontrolü: Belirtilen Bag Key’e sahip bir sepet sistemde mevcut mu, bunu sorgular.
Koşullu Aksiyonlar İçin Uygunluk: Sonuç, true veya false olarak döner ve bu değerle koşullu aksiyonlar tetiklenebilir.
Symbol Picker ile Dinamik Değerler: Kontrol edilecek Bag Key dinamik olarak belirlenebilir.‍
Web ve Mobil Uyumluluk: Aksiyon hem web hem de mobil projelerde çalışır.

Bag Has Key Aksiyonu Uygulama Adımları

UI Design'da Aksiyonu Tanımlama

Kuika platformuna giriş yapın.
Apps ekranından projenizi seçin.
UI Design modülüne geçin.
Sepet kontrolü yapılacak ekranı açın (örneğin: Ana Sayfa, Sepet Butonu, Checkout Ekranı).

Uygun bir elemente (örneğin, görünürlüğü koşula bağlı bir buton) aksiyon ekleyin.
+ ADD ACTION → uygun tetikleyici (Initial Actions, OnClick, vb.) → Bag → Bag Has Key aksiyonunu seçin.

Aksiyon Parametrelerini Yapılandırma

Bag Key (Zorunlu – Symbol Picker): Varlığı kontrol edilecek sepetin anahtarıdır. Örneğin:
- "default"
- currentUser.id + "_bag"
- screenInput.selectedCategory + "_bag"
Bag Key, dinamik olarak Symbol Picker aracılığıyla kullanıcıya özgü veya duruma göre alınmalıdır.

Kullanım Senaryosu: Sepeti Kontrol Edip Devam Etme

Bir ödeme ekranında, kullanıcı "Ödeme Yap" butonuna bastığında önce sepetin varlığı kontrol edilmeli, eğer sepet mevcut değilse kullanıcıya uyarı verilmeli veya aksiyon iptal edilmelidir.

Yapılandırma Adımları:

"Ödeme Yap" butonuna OnClick ile aksiyonu ekleyin.
İlk aksiyon olarak:
- Bag → Bag Has Key
- Bag Key: currentUser.id + "_bag"
Sonucu kontrol eden Condition (Koşul) aksiyonu ekleyin:
- Eğer true ise: Devam et → Ödeme akışını başlat.
- Eğer false ise: Notify → "Sepetiniz boş. Lütfen önce ürün ekleyin."

Bag Has Key Aksiyonu İleri Seviye Özelleştirmeler

Koşullu Buton Görünürlüğü: Eğer kullanıcıya ait sepet varsa “Devam Et” butonunu göster, yoksa gizle.
Navigasyon Koşulları: Sepeti olmayan kullanıcıyı alışveriş ekranına yönlendir.

Teknik Riskler ve Önlemler

Boş Bag Key: Bag Key parametresi boş olursa sistem kontrol yapamaz, bu durumda aksiyon hiçbir şey döndürmez.
Yanlış Bag Key Formatı: Bag Key’in doğruluğu sistemde tanımlanmış sepet yapısıyla uyumlu olmalıdır.
Senaryoya Uygun Sonuç Kullanımı: Bag Has Key sadece true/false döner; bu değer sonrasında mutlaka koşullu yönlendirmelerle işlenmelidir.

Bag Has Key aksiyonu, sepet mantığına dayalı işlevlerde karar mekanizmalarının temelini oluşturur. Doğru kullanıldığında, kullanıcı deneyimini güçlendirir ve sistemin daha kontrollü çalışmasını sağlar. Özellikle “Eğer varsa devam et” türü akışlarda en çok başvurulan kontrollerden biridir.