file 問題類型允許受訪者從其裝置上傳任何文件——文件、試算表、PDF 或其他文件類型。與啟動特定擷取工具的 image、audio 和 video 不同，file 打開通用文件選擇器。

基本 XLSForm 規格

typenamelabel
filedocument請上傳您的文件

有關標準 file 問題類型的更多詳細資訊，請參閱 XLSForm 規格。

用途

文件問題通常用於：

  1. 收集支援文件（收據、證書、合約、報告）
  2. 上傳已掃描的紙本表單
  3. 收集來自其他系統的試算表或資料匯出
  4. 任何 image/audio/video 未涵蓋的數位文件類型

資料格式

上傳的文件作為二進位附件儲存：

  • 格式： 以原始格式保存（PDF、XLSX、DOCX 等）
  • 命名： {instanceID}-{fieldname}.{extension}
  • 儲存： 與提交記錄一起上傳至伺服器媒體資料夾
  • 存取： 可從提交管理介面下載

rtSurvey 擴展

接受的文件類型

使用 parameters 欄限制可選擇的文件類型：

typenamelabelparameters
filereport上傳檢查報告accept=.pdf
filespreadsheet上傳資料文件accept=.xlsx,.csv

accept 參數使用標準文件擴展名語法（逗號分隔）。

文件大小指導

rtSurvey 在問題層級不強制執行硬性文件大小限制，但伺服器上傳限制適用。使用 hint 向調查員傳達預期：

typenamelabelhint
filereceipt上傳付款收據接受格式：PDF 或圖片。最大文件大小：5 MB

與裝置文件系統和雲端儲存的整合

在 Android 和 iOS 上，file 問題打開裝置的原生文件選擇器，可能包括存取：

  • 本機裝置儲存
  • SD 卡（Android）
  • iCloud Drive（iOS）
  • Google Drive、Dropbox（如已安裝）

在網頁上，它打開瀏覽器的標準文件上傳對話框。

使用範例

必填 PDF 上傳

typenamelabelhintrequiredrequired_message
filesigned_consent上傳已簽署的同意書僅限 PDF，最大 2MByes需要提供同意書

條件文件上傳

typenamelabelrelevant
select_one yesnohas_land_title家庭是否有土地所有權狀？
fileland_title_doc上傳土地所有權狀的照片或掃描件${has_land_title} = 'yes'

最佳實踐

  1. 使用 accept 限制文件類型——這可以防止調查員意外上傳錯誤的文件。
  2. 始終在 hint 欄中包含大小和格式指導。
  3. 對於照片和圖片，改用 image 類型——它提供更好的壓縮和一致的格式處理。
  4. 對於包含文件附件的大型問卷調查，相應規劃您的資料儲存和下載頻寬。
  5. 在部署前在目標裝置類型（Android vs. iOS vs. 網頁）上測試文件選擇器——對雲端磁碟的存取可能有所不同。

資料處理注意事項

  • 文件以原始格式儲存；rtSurvey 不會轉換或壓縮它們。
  • 下載後分析文件——rtSurvey 不提取或索引文件內容。
  • 大型文件附件會顯著增加下載完整資料集所需的時間。

限制

  • 文件問題不驗證文件內容——僅在 UI 層級透過 accept 強制執行文件擴展名檢查。
  • 非常大的文件（100 MB 以上）在低連線環境中上傳時可能超時。
  • 離線調查員可以附加文件，但在恢復連線之前不會上傳。
  • 某些裝置配置限制對某些儲存位置的存取（例如企業 MDM 政策）。
此頁面有幫助嗎？