File
Câu hỏi file cho phép người trả lời tải lên tài liệu và các tệp khác như một phần của câu trả lời khảo sát.
Loại câu hỏi file cho phép người trả lời tải lên bất kỳ tệp nào từ thiết bị — tài liệu, bảng tính, PDF hoặc các loại tệp khác. Không giống như image, audio, và video vốn khởi chạy công cụ thu thập riêng, file mở một trình chọn tệp đa năng.
Cấu hình XLSForm cơ bản
| type | name | label |
|---|---|---|
| file | document | Vui lòng tải lên tài liệu của bạn |
Để biết thêm chi tiết về loại câu hỏi file tiêu chuẩn, xem thông số kỹ thuật XLSForm.
Ứng dụng
Câu hỏi file thường được dùng cho:
- Thu thập tài liệu hỗ trợ (biên lai, chứng chỉ, hợp đồng, báo cáo)
- Tải lên các biểu mẫu giấy đã được quét
- Thu thập bảng tính hoặc xuất dữ liệu từ hệ thống khác
- Bất kỳ loại tệp kỹ thuật số nào mà image/audio/video không bao gồm
Định dạng dữ liệu
Các tệp được tải lên được lưu dưới dạng tệp đính kèm nhị phân:
- Định dạng: Được giữ nguyên ở định dạng gốc (PDF, XLSX, DOCX, v.v.)
- Tên tệp:
{instanceID}-{fieldname}.{extension} - Lưu trữ: Tải lên thư mục media trên server cùng với bản ghi gửi
- Truy cập: Có thể tải xuống từ giao diện quản lý bản ghi gửi
Phần mở rộng của rtSurvey
Loại tệp được chấp nhận
Dùng cột parameters để hạn chế loại tệp có thể chọn:
| type | name | label | parameters |
|---|---|---|---|
| file | report | Tải lên báo cáo kiểm tra | accept=.pdf |
| file | spreadsheet | Tải lên tệp dữ liệu | accept=.xlsx,.csv |
Tham số accept sử dụng cú pháp phần mở rộng tệp tiêu chuẩn (phân cách bởi dấu phẩy).
Hướng dẫn kích thước tệp
rtSurvey không áp dụng giới hạn kích thước tệp cứng ở cấp câu hỏi, nhưng giới hạn tải lên server vẫn áp dụng. Dùng hint để truyền đạt kỳ vọng cho người điều tra:
| type | name | label | hint |
|---|---|---|---|
| file | receipt | Tải lên biên lai thanh toán | Chấp nhận: PDF hoặc ảnh. Kích thước tệp tối đa: 5 MB |
Tích hợp với hệ thống tệp thiết bị và lưu trữ đám mây
Trên Android và iOS, câu hỏi file mở trình chọn tệp gốc của thiết bị, có thể bao gồm:
- Bộ nhớ cục bộ trên thiết bị
- Thẻ SD (Android)
- iCloud Drive (iOS)
- Google Drive, Dropbox (nếu đã cài đặt)
Trên web, nó mở hộp thoại tải lên tệp tiêu chuẩn của trình duyệt.
Ví dụ sử dụng
Tải lên PDF bắt buộc
| type | name | label | hint | required | required_message |
|---|---|---|---|---|---|
| file | signed_consent | Tải lên biểu mẫu đồng ý đã ký | Chỉ PDF, tối đa 2MB | yes | Cần có biểu mẫu đồng ý |
Tải lên tài liệu có điều kiện
| type | name | label | relevant |
|---|---|---|---|
| select_one yesno | has_land_title | Hộ gia đình có giấy chứng nhận quyền sử dụng đất không? | |
| file | land_title_doc | Tải lên ảnh hoặc bản scan giấy chứng nhận | ${has_land_title} = 'yes' |
Thực hành tốt
- Dùng
acceptđể hạn chế loại tệp — điều này ngăn người điều tra vô tình tải lên tệp sai. - Luôn bao gồm hướng dẫn về kích thước và định dạng trong cột
hint. - Với ảnh và hình ảnh, dùng loại
imagethay thế — nó cung cấp nén tốt hơn và xử lý định dạng nhất quán hơn. - Với khảo sát lớn có tệp đính kèm, lên kế hoạch lưu trữ dữ liệu và băng thông tải xuống phù hợp.
- Kiểm tra trình chọn tệp trên loại thiết bị đích (Android, iOS, web) trước khi triển khai — khả năng truy cập cloud storage khác nhau.
Lưu ý xử lý dữ liệu
- Tệp được lưu ở định dạng gốc; rtSurvey không chuyển đổi hoặc nén chúng.
- Phân tích tệp sau khi tải xuống — rtSurvey không trích xuất hoặc lập chỉ mục nội dung tệp.
- Tệp đính kèm lớn tăng đáng kể thời gian cần thiết để tải xuống toàn bộ bộ dữ liệu.
Giới hạn
- Câu hỏi file không xác thực nội dung tệp — chỉ kiểm tra phần mở rộng qua
acceptđược thực thi ở cấp UI. - Tệp rất lớn (100 MB trở lên) có thể hết thời gian tải lên trong môi trường kết nối kém.
- Người điều tra ngoại tuyến có thể đính kèm tệp nhưng chúng sẽ không được tải lên cho đến khi có kết nối.
- Một số cấu hình thiết bị hạn chế truy cập vào một số vị trí lưu trữ nhất định (ví dụ: chính sách MDM doanh nghiệp).