Dropbox Download File aksiyonu, Dropbox üzerinde kayıtlı bir dosyayı belirlenen path (yol) üzerinden indirmenizi sağlar. Kullanıcılar bu aksiyon sayesinde uygulama içerisinde dosyaları çekebilir ve farklı aksiyonlarda kullanabilir. Özellikle rapor indirme, belge paylaşımı veya offline kullanım senaryolarında tercih edilir.

Teknik Özellikler

Dosya İndirme İşlemi (Download Paneli): Bu aksiyon, path parametresi ile belirtilen dosyayı Dropbox’tan indirir ve Dropbox_DownloadFileResponse nesnesi olarak döndürür.

Parametreler:

• settings (Object – zorunlu): Dropbox API entegrasyonu için gerekli ayarlardır. Config Manager üzerinden tanımlanan Dropbox ayarları buradan seçilmelidir.
• path (String – zorunlu): İndirilecek dosyanın tam yolu. (Ör. /Reports/2025/Q1_Report.pdf)

Veri Kaynağı Uyumluluğu: Parametreler sabit (Fixed) değerlerle girilebileceği gibi, Symbol Picker aracılığıyla Form Input, Action Result, Current, Method Input gibi dinamik kaynaklardan da alınabilir.

Web & Mobil Destek: Dropbox Download File aksiyonu, hem web hem de mobil uygulamalarda kullanılabilir.

Dropbox Download File Uygulama Adımları

1. UI Design’da Aksiyon Tanımlama

• Kuika projenizi açın.
• UI Design modülünde dosya indirmenin yapılacağı ekranı seçin.
• Bir Button elementi ekleyin (ör. “Dosyayı İndir”).
• Butona tıklayın ve + ADD ACTION → Dropbox → Dropbox Download File aksiyonunu seçin.

2. Parametreleri Yapılandırma

• settings: Configuration Manager’da oluşturduğunuz Dropbox API ayarını seçin.
• path: İndirilecek dosyanın yolunu belirleyin (örn. /Reports/2025/Annual.pdf).

Kullanım Senaryosu: Rapor İndirme

Bir raporlama uygulamasında kullanıcı, “Son Raporu İndir” butonuna bastığında, Dropbox’taki ilgili PDF dosyası uygulamaya indirilir.

Adımlar:

1. “Raporu İndir” butonu ekleyin.
2. OnClick → Dropbox Download File aksiyonunu tanımlayın.
3. path parametresine dosyanın tam yolunu sabit (Fixed) veya dinamik (Form Input’tan) bağlayın.
4. Kullanıcı butona bastığında dosya indirilir ve uygulama içinde kullanılabilir.

Dropbox Download File İleri Seviye Özelleştirmeler

• Dinamik Dosya Seçimi: Kullanıcının listeden seçtiği dosya dinamik olarak indirilebilir.
• Koşullu İndirme: Eğer dosya mevcut değilse kullanıcıya uyarı verilebilir.
• Sonucun Kullanımı: İndirilen dosya başka bir aksiyona (ör. e-posta ekine ekleme) aktarılabilir.
• Format Kontrolü: Sadece belirli uzantılardaki dosyaların indirilmesine izin verilebilir (örn. .pdf, .xlsx).

Teknik Riskler ve Kontroller

• path boş olmamalıdır. Zorunlu parametre olduğu için boş bırakılırsa işlem başarısız olur.
• Geçersiz yol: Dosya yolu yanlış girilirse aksiyon hata döndürür.
• settings doğru yapılandırılmalıdır. Configuration Manager’da Dropbox API ayarı yapılmazsa aksiyon çalışmaz.
• Dosya boyutu: Çok büyük dosyalarda indirme süresi uzayabilir veya timeout oluşabilir.