Hidden
Приховані поля зберігають значення, які ніколи не показуються респонденту — використовуються для передачі контексту, попереднього заповнення даних або зберігання проміжних результатів.
Поле hidden зберігає значення, яке ніколи не відображається респонденту. На відміну від calculate (що обчислює значення), hidden використовується для зберігання зовні наданого значення — наприклад, ID завдання, ID домогосподарства, переданого з іншої системи, або коду анкетера, введеного при запуску форми.
Базова специфікація XLSForm
| type | name | label |
|---|---|---|
| hidden | household_id |
Мітки не потрібні для прихованих полів, оскільки нічого не відображається на екрані.
Використання
Приховані поля зазвичай використовуються для:
- Передачі попередньо призначеного ID з системи управління опитуваннями (наприклад, ID домогосподарства, номер справи, код завдання)
- Зберігання версії форми або метаданих розгортання
- Введення специфічної для анкетера конфігурації при запуску форми
- Перенесення даних з батьківської форми до дочірньої форми в пов’язаних робочих процесах
- Зберігання значення, отриманого з параметрів URL при відкритті форми через веб-посилання
Встановлення значення за замовчуванням
Найпоширеніший шаблон — використовувати hidden з виразом default, щоб значення встановлювалося при відкритті форми:
| type | name | default |
|---|---|---|
| hidden | deployment_code | ‘ZONE_A_2024’ |
| hidden | form_version | ‘3.1’ |
Посилання на приховане поле в обчисленнях
Приховані значення можна посилатися так само, як на будь-яке інше поле, за допомогою ${fieldname}:
| type | name | label | calculation |
|---|---|---|---|
| hidden | zone_code | ||
| calculate | label_prefix | concat(’[’, ${zone_code}, ‘] ‘) | |
| note | intro | ${label_prefix} Welcome to the household survey |
Використання hidden з попереднім заповненням / параметрами URL
При запуску веб-форми через URL ви можете передавати параметри, що заповнюють приховані поля. Це дозволяє попередньо завантажувати ID домогосподарства або код завдання без введення анкетером:
https://your-server.com/form/FORMID?household_id=H00123&zone_code=NORTH
Поле з назвою household_id буде автоматично заповнено значенням H00123.
Найкращі практики
- Використовуйте
hidden(а неcalculate), коли значення надається ззовні і не повинно перераховуватися. - Використовуйте
calculate, коли значення виводиться з інших полів форми. - Завжди встановлюйте
default, якщо приховане поле повинно мати значення — приховане поле без default буде порожнім. - Чітко називайте приховані поля, щоб відрізнити їх (наприклад, з префіксом
_hidden_або використовуйте послідовну угоду про іменування).
Обмеження
- Приховані поля включаються в експортовані дані так само, як і будь-яке інше поле.
- Вони не можуть відображатися умовно — вони завжди присутні (але невидимі).
- Якщо вам потрібне поле, що динамічно обчислюється, використовуйте
calculate.