Kuika’nın Big File Upload elementi, kullanıcıların büyük boyutlu dosyaları hızlı, güvenli ve kesintisiz şekilde yüklemelerine olanak tanır. Bu element, özellikle medya içerikleri, proje dosyaları veya büyük veri setleri gibi yüksek boyutlu verilerin yönetiminde kullanılır.

Yalnızca web uygulamalarında desteklenir.

Kullanım Alanları

• Kimlik, diploma, sertifika veya sözleşme yükleme alanları
• Büyük medya dosyaları (video, ses, görsel) yükleme
• Rapor veya veri seti paylaşım ekranları
• Proje, belge veya dosya arşivleme uygulamaları
• Kullanıcı bazlı doküman yönetim modülleri

Kullanım Senaryosu – Kullanıcı Belge Yükleme Modülü

Bir web uygulamasında kullanıcıların kimlik, diploma veya sertifika gibi belgeleri yükleyip daha sonra görüntüleyebilmesi, indirebilmesi ve silebilmesi gerekir. Belgeler her kullanıcıya özel dizinlerde saklanır ve işlemler sistem üzerinden takip edilir.

Senaryoda:

• Kullanıcı “Click or drag file to this area to upload.” alanına tıklar veya dosyayı sürükleyip bırakır.
• Sistem dosyayı otomatik olarak küçük parçalara böler (chunk upload) ve yüklemeye başlar.
• Yükleme tamamlandığında sistem dosyaya benzersiz bir File ID (GUID) atar.
• Dosya bilgisi (File ID, File Name, Upload Date) kullanıcıyla ilişkilendirilerek veritabanına kaydedilir.
  

Veri Kaynağı Bağlama

• Datasources modülüne gidin.
• Ardından Tables başlığı yanındaki + ikonuna tıklayın ve tabloya “UserDocuments” ismini verin. 
• Aşağıdaki tabloyu oluşturun. 

• SQL Actions sekmesinde yeni bir aksiyon oluşturun: InsertUserDocument

INSERT INTO UserDocuments (UserId, FileId, FileName, UploadDate)VALUES (@UserId, @FileId, @FileName, NOW());

• Switch elementine yükleme sonrası InsertUserDocument aksiyonunu bağlayın.
• Parametreleri eşleştirin:
  
  • @UserId = Current.User.Id
  • @FileId = Uploaded.File.Id
  • @FileName = Uploaded.File.Name

UI Design Modülü İşlemleri

1. UI Design modülüne gidin.
2. Sol panelden Elements > Special > Big File Upload elementini seçin.
3. Elementi ekranınıza sürükleyip bırakın.
4. Properties panelinde aşağıdaki ayarları yapılandırın:
   
   • Label: Upload your document
   • Hint: Only .pdf, .jpg or .png files allowed. Max size: 200 MB
   • Chunk Size: 10 MB
   • File Upload Path: /userUploads/

Özelliklerin Senaryo Bağlamında Kullanılması

• Chunk Size: Dosyanın küçük parçalara bölünerek yüklenmesini sağlar.
• Label: Yükleme alanının amacını belirtir (ör. “Upload your document”).
• Hint: Kullanıcıya dosya türü ve limitler hakkında bilgi verir.
• File Upload Path: Dosyaların saklanacağı sunucu dizinini belirtir.
• On Upload Finish: Yükleme tamamlandığında tetiklenecek aksiyonu tanımlar.

Dosya Yükleme – İndirme – Silme

• Yükleme: Kullanıcı dosyayı yükler → sistem dosyayı Chunk Size kadar parçalayıp kaydeder.
• İndirme:

• Bir Button elementi ekleyin ve “Download file” ismini verin. 
• OnClick → Device → Download File From Server seçeneğini seçin.
• File ID olarak {{selectedDocument.FileId}} yazın.

• Silme:

• Bir Button elementi ekleyin ve “Delete File” ismini verin.
• OnClick → Device → Delete File From Server seçeneğini seçin.
• File ID olarak {{selectedDocument.FileId}} yazın.
• Silmeden önce kullanıcı onayı alın.

Senaryo Tamamlandığında

• Kullanıcı dosyasını yükler.
• Sistem yüklemeyi parçalara bölerek tamamlar.
• Dosya, kullanıcı kimliğiyle ilişkilendirilir.
• Kullanıcı yüklediği belgeyi indirip silebilir.
• Tüm işlemler sistem üzerinden loglanır.

Kısıtlamalar

• Yalnızca tek dosya yüklemesi desteklenir.
• Çok büyük dosyalarda (1 GB+) Chunk Size değeri optimize edilmelidir.
• File ID kaydedilmezse dosya üzerinde işlem (indirme/silme) yapılamaz.
• Dinamik yükleme dizini tanımlanamaz; path Configuration Manager’dan ayarlanır.

İpuçları ve Best Practices

• Label ve Hint alanlarını kullanıcıyı yönlendirecek biçimde özelleştirin.
• Dosya türü ve boyut limitlerini açıkça belirtin.
• Kritik dosyalar için “upload success” bildirimi gösterin.
• Büyük dosyalar için kullanıcıya yükleme ilerleme durumu sunun.
• Silme işleminde mutlaka onay diyalogu kullanın.