File
Питання типу file дозволяють респондентам завантажувати документи та інші файли як частину відповідей на опитування.
Тип питання file дозволяє респондентам завантажувати будь-який файл зі свого пристрою — документи, таблиці, PDF або інші типи файлів. На відміну від image, audio та video, які запускають конкретні інструменти захоплення, file відкриває загальний вибір файлів.
Базова специфікація XLSForm
| type | name | label |
|---|---|---|
| file | document | Please upload your document |
Для отримання додаткових відомостей про стандартний тип питання file дивіться специфікацію XLSForm.
Використання
Питання типу file зазвичай використовуються для:
- Збору підтримуючих документів (квитанції, сертифікати, контракти, звіти)
- Завантаження заповнених паперових форм, що були відскановані
- Збору таблиць або експортів даних з інших систем
- Будь-якого типу цифрового файлу, що не охоплений image/audio/video
Формат даних
Завантажені файли зберігаються як бінарні вкладення:
- Формат: Зберігається в оригінальному форматі (PDF, XLSX, DOCX тощо)
- Іменування:
{instanceID}-{fieldname}.{extension} - Зберігання: Завантажується до медіапапки сервера поряд з відправленням
- Доступ: Завантаження з інтерфейсу управління відправленнями
Розширення rtSurvey
Дозволені типи файлів
Використовуйте стовпець parameters для обмеження типів файлів, що можна вибрати:
| type | name | label | parameters |
|---|---|---|---|
| file | report | Upload the inspection report | accept=.pdf |
| file | spreadsheet | Upload the data file | accept=.xlsx,.csv |
Параметр accept використовує стандартний синтаксис розширень файлів (через кому).
Вказівки щодо розміру файлу
rtSurvey не застосовує жорсткого обмеження розміру файлу на рівні питання, але застосовуються обмеження завантаження сервера. Використовуйте hint для повідомлення очікувань анкетеру:
| type | name | label | hint |
|---|---|---|---|
| file | receipt | Upload the payment receipt | Accepted: PDF or image. Maximum file size: 5 MB |
Інтеграція з файловою системою пристрою та хмарним сховищем
На Android та iOS питання file відкриває рідний вибір файлів пристрою, який може включати доступ до:
- Локального сховища пристрою
- SD-картки (Android)
- iCloud Drive (iOS)
- Google Drive, Dropbox (якщо встановлено)
У веб-версії відкривається стандартний діалог завантаження файлів браузера.
Приклад використання
Обов’язкове завантаження PDF
| type | name | label | hint | required | required_message |
|---|---|---|---|---|---|
| file | signed_consent | Upload the signed consent form | PDF only, max 2MB | yes | A consent form is required |
Умовне завантаження документа
| type | name | label | relevant |
|---|---|---|---|
| select_one yesno | has_land_title | Does the household have a land title? | |
| file | land_title_doc | Upload a photo or scan of the land title | ${has_land_title} = 'yes' |
Найкращі практики
- Використовуйте
acceptдля обмеження типів файлів — це запобігає випадковому завантаженню анкетерами неправильних файлів. - Завжди включайте вказівки щодо розміру та формату у стовпці
hint. - Для фотографій та зображень використовуйте тип
image— він пропонує кращу компресію та послідовну обробку формату. - Для великих опитувань з файловими вкладеннями плануйте ваше зберігання даних та пропускну здатність для завантаження відповідно.
- Тестуйте вибір файлів на цільовому типі пристрою (Android проти iOS проти веб) перед розгортанням — доступ до хмарних дисків варіюється.
Міркування щодо обробки даних
- Файли зберігаються в оригінальному форматі; вони не конвертуються або стискаються rtSurvey.
- Аналізуйте файли після завантаження — rtSurvey не витягує та не індексує вміст файлів.
- Великі файлові вкладення значно збільшують час, необхідний для завантаження повного набору даних.
Обмеження
- Питання типу file не валідують вміст файлу — лише перевірка розширення файлу через
acceptзастосовується на рівні UI. - Дуже великі файли (100 МБ+) можуть перевищувати час очікування під час завантаження у середовищах з низьким підключенням.
- Офлайн-анкетери можуть прикріплювати файли, але вони не завантажаться до відновлення підключення.
- Деякі конфігурації пристроїв обмежують доступ до певних місць зберігання (наприклад, корпоративні політики MDM).