Dropbox Upload File aksiyonu, uygulama içinde oluşturulan veya kullanıcıdan alınan bir dosyayı Dropbox’a yüklemek için kullanılır. Dosya, Base64 formatında içerik olarak gönderilir ve belirtilen path parametresi ile Dropbox içinde istenilen konuma kaydedilir. Özellikle belge paylaşımı, rapor saklama ve kullanıcı dosya yükleme senaryolarında tercih edilir.

Teknik Özellikler

Dosya Yükleme İşlemi (Upload Paneli): Bu aksiyon, base64Content parametresiyle alınan dosya içeriğini Dropbox’a yükler ve path parametresi ile belirtilen konuma kaydeder.

Parametreler:

• settings (Object – zorunlu): Dropbox API entegrasyonu için gerekli ayarlardır. Configuration Manager üzerinden tanımlanan Dropbox ayarları seçilmelidir.
• path (String – zorunlu): Dosyanın Dropbox’a yükleneceği hedef yol. (Ör. /Reports/2025/Annual.pdf)
• base64Content (String – zorunlu): Yüklenecek dosyanın Base64 formatındaki içeriği.

Veri Kaynağı Uyumluluğu: Tüm parametreler sabit (Fixed) olarak girilebileceği gibi, Symbol Picker üzerinden Form Input, Action Result, Current, Method Input gibi dinamik kaynaklardan da bağlanabilir.

Web & Mobil Destek: Dropbox Upload File aksiyonu hem web hem de mobil uygulamalarda sorunsuz çalışır.

Dropbox Upload File Uygulama Adımları

1. UI Design’da Aksiyon Tanımlama

• Kuika projenizi açın.
• UI Design modülünde dosya yükleme işleminin yapılacağı ekranı seçin.
• Bir Big File Upload ve bir Button (ör. “Dropbox’a Yükle”) elementi ekleyin.
• Butona tıklayın ve + ADD ACTION → Dropbox → Dropbox Upload File aksiyonunu seçin.

2. Parametreleri Yapılandırma

• settings: Configuration Manager’da oluşturduğunuz Dropbox API ayarını seçin.
• path: Kullanıcının dosyayı kaydedeceği klasör ve dosya adını belirleyin (örn. /Uploads/User123/profile.png).
• base64Content: Big File Upload elementinde  alınan içerikle bağlayın.

Kullanım Senaryosu: Kullanıcı Dosya Yükleme

Bir sosyal medya uygulamasında kullanıcı, profil fotoğrafını Dropbox’a yüklemek ister.

Adımlar:

1. Big File Upload elementi ekleyin.
2. “Yükle” butonunu ekleyin.
3. OnClick → Dropbox Upload File aksiyonunu tanımlayın.
4. path parametresine kullanıcıya özel yol oluşturun (örn. /Profiles/{UserID}/profile.jpg).
5. base64Content parametresini Big File Upload elementine bağlayın.
6. Kullanıcı dosya seçip yüklediğinde, dosya Dropbox’a kaydedilir.

Dropbox Upload File İleri Seviye Özelleştirmeler

• Dinamik Dosya İsimlendirme: Dosya adını kullanıcı ID’si veya tarih bilgisi ile dinamik hale getirebilirsiniz (örn. Report_2025_09_17.pdf).
• Versiyonlama: Aynı isimde dosya varsa üzerine yazma yerine yeni versiyon eklenebilir.
• Koşullu Yükleme: Dosya türü veya boyutu kontrol edilerek yalnızca belirli kriterlere uyan dosyalar yüklenebilir.
• Sonucun Kullanımı: Yüklenen dosya yolunu bir Set Value aksiyonuyla saklayabilir ve sonraki işlemlerde kullanabilirsiniz.
  
  

Teknik Riskler ve Kontroller

• path boş olmamalıdır. Aksi halde dosya nereye yükleneceği bilinmez ve işlem başarısız olur.
• base64Content zorunludur. Dosya içeriği olmadan işlem yapılamaz.
• settings doğru yapılandırılmalıdır. Configuration Manager’da Dropbox API ayarı yapılmazsa aksiyon çalışmaz.
• Büyük dosyalar: Çok büyük dosyaların Base64 olarak gönderilmesi performans sorunlarına yol açabilir.