1. Aksiyon Tanımlama

• Kuika platformunda projenizi açın.

• UI Design modülünde sağ kenardaki Add Action butonuna tıklayın ve Download File From Bucket aksiyonunu seçin.

2. Parametreleri Belirleme

• Key Name (String – zorunlu): Bucket içindeki dosyanın benzersiz adıdır. Örnek: user_123/avatar.png
  
  • Genellikle Action Result, Current, Form Component, Screen Input veya Fixed değer olarak atanabilir.
• Bucket Name (String – zorunlu): Bulut sağlayıcısı olarak yalnızca AWS veya Google seçebilirsiniz.
• File Name (String – zorunlu): İndirilen dosyanın istemci tarafında kaydedileceği isim ve uzantısı. Örnek: my_avatar.png
• Encrypt (Boolean – opsiyonel): Bucket şifreleme kullanıyorsa, indirme işlemi sırasında doğrulama için bu parametre kullanılabilir.
  
  • true → Şifreleme kontrolü yapılır.
  • false → Şifreleme kontrolü yapılmaz.

Aksiyonun Çalıştırılması ve Test Edilmesi

1. Preview modunda aksiyonu çalıştırın.
2. Başarılı olduğunda, belirtilen dosya istemciye indirilir veya arka planda kullanılabilir hale gelir.
3. Başarısız olursa, hata mesajı üzerinden bucket adı, key, filename veya connection bilgileri kontrol edilmelidir.
4. Örnek Test: AWS S3 için terminalde aws s3 cp s3://kuika-media-storage/user_123/avatar.png ./my_avatar.png komutu ile dosyanın indirildiğini doğrulayabilirsiniz.

Bir sosyal medya uygulamasında kullanıcı, profil resmini görüntülemek istediğinde:

• Key Name ile avatar dosyası Bucket’tan çağrılır.
• Dosya File Name parametresi ile istemciye indirilir veya önizleme için yüklenir.
• Bu sayede kullanıcı eski veya yeni avatarı hızlıca görüntüleyebilir.

Adım Adım Kullanım

1. Dosya Kontrolü: Kullanıcı profil ekranında, avatarın Object Key’i alınır.
2. Download File From Bucket Aksiyonunun Çalıştırılması: OnClick olayına bağlanır.
   
   • Parametreler:
     
     • Key Name: user_123/avatar.png
     • Bucket Name:  Bulut sağlayıcısı olarak yalnızca AWS veya Google seçebilirsiniz.
     • File Name: my_avatar.png
     • Encrypt: false
3. Sonraki Aksiyonlar:
   
   • Dosya başarıyla indirildiyse: Önizleme ekranında gösterilir.
   • İndirme başarısız olursa: Kullanıcıya “Dosya indirilemedi, lütfen tekrar deneyin” uyarısı gösterilir.

• Dinamik Key Name: Dosya, kullanıcı kimliği, tarih veya başka bir parametreye göre dinamik olarak belirlenebilir.
• Çoklu Dosya İndirme: Birden fazla dosya indirmek için aksiyon ardışık çalıştırılabilir veya döngü ile tetiklenebilir.
• Koşullu İndirme: Sadece belirli role sahip kullanıcılar dosyayı indirebilir (Authorization paneli ile entegre edilebilir).
• Cache veya Depolama ile Entegrasyon: Önceden indirilen dosyalar Cache’e alınarak tekrar indirilmesi önlenebilir.

Teknik Riskler

• Yanlış Key Name Kullanımı: Yanlış veya eksik key girildiğinde dosya bulunamaz.
• Yetkisiz Erişim: Bucket indirme işlemleri yalnızca yetkili kullanıcılar tarafından tetiklenmelidir.
• Encrypt Ayarları: Yanlış şifreleme parametresi indirme işlemini başarısız hale getirebilir.
• Connection Hataları: Yanlış Connection String veya Access Key, Bucket’a erişimi engelleyebilir.
• Provider Farklılıkları: AWS veya GCP’de hata mesajları farklı olabilir; Provider’a özel loglama yapılmalıdır.

Download File From Bucket aksiyonu, Kuika uygulamalarında bucket içinde tutulan dosyaları güvenli ve kontrollü şekilde istemciye indirmenizi sağlar. Dinamik parametre desteği, şifreleme kontrolü ve provider uyumluluğu sayesinde esnek ve güvenli bir dosya yönetimi sunar.