Meta
Типи питань meta автоматично фіксують інформацію про пристрій, анкетера та часові позначки без будь-якого введення від респондента.
Типи питань meta — це спеціальні поля, що заповнюються автоматично — респондент їх ніколи не бачить. Вони фіксують контекст про відправлення: коли воно було зібрано, який пристрій використовувався та хто його збирав. Додайте їх у таблицю survey як будь-який інший тип питання; вони просто не з’являються на екрані.
Базова специфікація XLSForm
| type | name | label |
|---|---|---|
| start | start | |
| end | end | |
| deviceid | deviceid |
Мітки необов’язкові для мета-полів, оскільки вони ніколи не відображаються.
Мета-поля часу
start
Записує дату та час відкриття форми. Зберігається у форматі ISO 8601 (YYYY-MM-DDTHH:MM:SS.sss+HH:MM).
type | name | label
start | start |
end
Записує дату та час відправлення форми. Разом зі start ви можете обчислити час, витрачений на заповнення форми:
type | name | calculation
calculate | duration_min | (decimal-date-time(${end}) - decimal-date-time(${start})) * 1440
today
Записує поточну дату (без компоненту часу). Зберігається як YYYY-MM-DD. Корисно, коли потрібна лише дата без повної позначки часу.
type | name | label
today | today |
Мета-поля пристрою
deviceid
Записує унікальний ідентифікатор пристрою, що використовується для збору даних. На Android це зазвичай IMEI або Android ID. Корисно для відстеження того, який пристрій надіслав кожну форму, та виявлення дублікатів відправлень з одного пристрою.
type | name | label
deviceid | deviceid |
devicephonenum
Записує номер телефону SIM-карти в пристрої (якщо доступний). Може бути порожнім, якщо пристрій не має SIM-карти або якщо номер не збережений на SIM.
type | name | label
devicephonenum | devicephonenum |
simserial
Записує серійний номер SIM-карти (ICCID). Корисно для ідентифікації використаної SIM/оператора.
type | name | label
simserial | simserial |
subscriberid
Записує IMSI (Міжнародний ідентифікатор мобільного абонента) — унікальний ідентифікатор абонента на SIM-карті.
type | name | label
subscriberid | subscriberid |
Мета-поля анкетера
username
Записує ім’я користувача анкетера, що увійшов (обліковий запис, що використовується в додатку rtSurvey). Це найнадійніший спосіб відстеження того, хто зібрав кожне відправлення.
type | name | label
username | username |
email
Записує адресу електронної пошти анкетера, що увійшов.
type | name | label
email | email |
phonenumber
Записує номер телефону, пов’язаний з обліковим записом анкетера (якщо налаштовано).
type | name | label
phonenumber | phonenumber |
Журнал аудиту
audit
Мета-поле audit вмикає детальне журналювання аудиту — воно записує часовий журнал кожного питання, яке відвідував анкетер, скільки часу він витратив на кожному, та (за бажанням) їх GPS-положення на кожному кроці. Журнал аудиту зберігається як окремий файл audit.csv поряд з кожним відправленням.
type | name | parameters
audit | audit | location-priority=balanced location-min-interval=30 location-max-age=60
Параметри аудиту
| Параметр | Опис |
|---|---|
location-priority | Рівень точності GPS: no-gps, low-power, balanced, high-accuracy |
location-min-interval | Мінімальні секунди між захопленнями місцезнаходження |
location-max-age | Максимальний вік (секунди) кешованого місцезнаходження для прийняття |
Журнал аудиту фіксує:
- Назву питання та тип події (
question,form.start,form.exit,form.save,form.finalize) - Позначки часу початку та закінчення для кожної події
- GPS-координати (якщо встановлено
location-priority)
Поле audit генерує окремий файл для кожного відправлення. Переконайтеся, що ваш конвеєр обробки даних обробляє як основні дані форми, так і аудиторський CSV.
Повний приклад
Типове опитування домогосподарства може включати всі мета-поля часу та анкетера:
| type | name | label |
|---|---|---|
| start | start | |
| end | end | |
| today | today | |
| deviceid | deviceid | |
| username | username | |
| audit | audit | |
| text | household_id | Household ID |
| … | … | … |
Найкращі практики
- Завжди включайте
startтаend— вони безкоштовні, автоматичні та безцінні для моніторингу якості. - Завжди включайте
usernameдля відстеження анкетерів. - Включайте
deviceid, коли потрібно виявляти дублікати відправлень або відстежувати польові пристрої. - Використовуйте
auditу опитуваннях з високою відповідальністю, де потрібно перевіряти, що анкетери дійсно відвідували кожне питання. - Пов’язані з SIM поля (
simserial,subscriberid,devicephonenum) є надійними лише на пристроях Android з активними SIM-картами — пропускайте їх для розгортань лише на планшетах.
Обмеження
- Усі мета-поля є лише для читання — вони не можуть бути посилані або змінені іншими обчисленнями.
usernameтаemailвимагають авторизації анкетера; вони будуть порожніми для анонімних відправлень.- Пов’язані з SIM/телефоном мета-поля можуть повертати порожні значення на планшетах лише з Wi-Fi та деяких версіях Android через обмеження дозволів.