Dropbox List Files aksiyonu, Dropbox içinde belirtilen klasördeki dosyaların ve alt klasörlerin listesini almak için kullanılır. Bu işlem sayesinde uygulamanızda klasör içerikleri görüntülenebilir ve kullanıcıya dinamik dosya seçimi sunulabilir. Özellikle dosya yönetimi, içerik tarama, seçim veya kontrol senaryolarında tercih edilir.

Teknik Özellikler

Dosya Listeleme İşlemi (List Paneli): Bu aksiyon, path parametresi ile belirtilen klasörün içeriğini listeler ve Dropbox_FilesResult nesnesi döner.

Parametreler:

• settings (Object – zorunlu): Dropbox API entegrasyonu için gerekli ayarlardır. Configuration Manager üzerinden tanımlanan Dropbox ayarları buradan seçilmelidir.
• path (String – zorunlu): Dosyaların listeleneceği klasörün tam yolu. (Ör. /Reports/2025/)

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 List Files aksiyonu hem web hem de mobil uygulamalarda kullanılabilir.

Dropbox List Files Uygulama Adımları

1. UI Design’da Aksiyon Tanımlama

• Kuika projenizi açın.
• UI Design modülünde klasör içeriğinin listeleneceği ekranı seçin.
• Bir Button elementi ekleyin (ör. “Dosyaları Listele”).
• Butona tıklayın ve + ADD ACTION → Dropbox → Dropbox List Files 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 seçtiği veya sabit olarak belirlenen klasör yolunu girin (örn. /Projects/Design/).

Kullanım Senaryosu: Rapor Klasörünü Listeleme

Bir raporlama uygulamasında kullanıcı, “Raporları Göster” butonuna bastığında, /Reports/2025/ klasöründeki dosyaların listesi ekranda görüntülenir.

Adımlar:

1. “Raporları Göster” butonunu ekleyin.
2. OnClick → Dropbox List Files aksiyonunu ekleyin.
3. path parametresini sabit olarak /Reports/2025/ veya kullanıcı girişine bağlayın.
4. Dönen sonuçları List, Table veya GalleryView elementiyle ekranda gösterin.

Dropbox List Files İleri Seviye Özelleştirmeler

• Dinamik Klasör Seçimi: Kullanıcıya bir klasör seçtirilip, seçilen klasörün içeriği listelenebilir.
• Koşullu Gösterim: Eğer klasör boşsa “Bu klasörde dosya bulunmamaktadır” mesajı gösterilebilir.
• Sonuçların Kullanımı: Listelenen dosya yolları başka aksiyonlara (ör. Download File, Delete File) aktarılabilir.
• Alt Klasörlerle Entegrasyon: Alt klasör içerikleri de dinamik olarak gezilebilir.

Teknik Riskler ve Kontroller

• path boş olmamalıdır. Aksi halde işlem başarısız olur.
• Geçersiz yol: Eğer belirtilen klasör yoksa hata döner.
• settings doğru yapılandırılmalıdır. Configuration Manager’da Dropbox API ayarı yapılmazsa aksiyon çalışmaz.
• Büyük Klasörler: Çok fazla dosya olduğunda sonuçların yüklenmesi zaman alabilir, sayfalama gerekebilir.