1. Aksiyon Tanımlama

• Kuika platformunda projenizi açın.

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

2. Dosya İçeriğini Belirleme

• Yüklenecek dosyayı Base64String parametresi ile belirtin.
• Örnek: JVBERi0xLjQKJ....

3. Bucket Seçimi

• Dosyanın yükleneceği hedef Bucket’ı seçin.
•  Bulut sağlayıcısı olarak yalnızca AWS veya Google seçebilirsiniz.

4. Dosya Adını Belirleme

• Dosyanın Bucket içine kaydedileceği adı girin.
• Örnek: invoice_123.pdf

5. Encryption Kullanımı 

• Encrypt = true seçilirse dosya şifrelenmiş biçimde yüklenir.
• false veya boş bırakılırsa dosya normal olarak yüklenir.

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

• Preview modunda aksiyonu çalıştırın.
• Bucket içine dosyanın başarıyla yüklenip yüklenmediğini doğrulayın.

Önemli Noktalar

• Base64String doğru ve eksiksiz olmalıdır; hatalı içerik yükleme başarısız olur.
• FileName parametresine dosya uzantısı eklenmelidir (ör. .pdf, .png).
• Encrypt parametresi opsiyoneldir; kullanılmadığında dosya şifresiz yüklenir.
• Bucket Name’in yanlış girilmesi veya Configuration Manager’da tanımlı olmaması yükleme hatasına yol açar.

Bir sosyal medya uygulamasında kullanıcı, profil fotoğrafını seçip yüklemek ister. Fotoğraf uygulamada Base64 formatına çevrilir ve ardından Upload File to Bucket aksiyonu ile profile-pictures Bucket’ına yüklenir.

Adım Adım Kullanım

1. Fotoğraf Seçimi: Kullanıcı cihazından fotoğraf seçer.
2. Base64 Çevirme: Fotoğraf Base64 formatına çevrilir.
3. Upload File to Bucket Aksiyonu:
   
   • Base64String: ...
   • BucketName:  Bulut sağlayıcısı olarak yalnızca AWS veya Google seçebilirsiniz.
   • FileName: user_456.png
   • Encrypt: false
4. Sonraki Aksiyonlar: Yüklenen dosyanın URL’i veritabanına kaydedilir ve kullanıcıya gösterilir.

• Versiyonlama: Aynı dosya adı ile yüklemelerde önceki versiyonun üzerine yazma veya yeni versiyon olarak saklama stratejileri uygulanabilir.
• Dinamik Bucket Seçimi: Bucket Name parametresi kullanıcı, ortam (test/prod) veya rol bazlı dinamik hale getirilebilir.
• Şifreleme Politikaları: Hassas veriler için Encrypt parametresi zorunlu kılınabilir.
• FileName Kuralları: Dosya isimlendirmesi tarih, kullanıcı ID’si veya özel Prefix’lerle otomatik hale getirilebilir.

Teknik Riskler

• Hatalı Base64: Eksik veya bozuk Base64 string dosyanın yüklenmesini engeller.
• Yanlış FileName: Uzantısı olmayan dosyalar doğru şekilde açılmayabilir.
• Bucket Hataları: Yanlış veya erişim izni olmayan Bucket seçimi yüklemeyi başarısız kılar.
• Şifreleme Uyumsuzlukları: Encrypt özelliği aktifken Bucket tarafında şifreleme desteği olmaması hata verebilir.
• Performans Limitleri: Büyük boyutlu dosyaların Base64 çevrilmesi cihaz belleğini zorlayabilir.