Групування питань
Групи в XLSForm дозволяють організовувати пов’язані питання разом, покращуючи структуру вашого опитування та розширюючи можливості аналізу даних. rtSurvey повністю підтримує групи XLSForm і розширює їх функціональність додатковими можливостями.
Базова структура групи
Щоб створити групу питань, використовуйте синтаксис begin_group та end_group:
| type | name | label |
|--------------|------------|------------------------------------------|
| begin_group | respondent | Respondent Information |
| text | name | Enter the respondent's name |
| text | position | Enter the respondent's position |
| end_group | | |
Ключові моменти:
- Рядок
begin_groupвимагаєnameтаlabel. - Рядок
end_groupне потребує імені або мітки. - Питання між
begin_groupтаend_groupє частиною групи.
Appearance групи
rtSurvey підтримує різні варіанти appearance для груп:
field-list: Відображає кілька питань на одному екрані.
| type | name | label | appearance | |--------------|------------|-----------|------------| | begin_group | respondent | Respondent| field-list | | text | name | Name | | | text | position | Position | | | end_group | | | |grid: Створює компактний табличний макет для груп (специфічно для rtSurvey).
| type | name | label | appearance | |--------------|------------|-----------|------------| | begin_group | household | Household | grid | | text | member_name| Name | | | integer | member_age | Age | | | end_group | | | |collapsible: Створює розгортальні/згортальні групи (специфічно для rtSurvey).
| type | name | label | appearance | |--------------|------------|-----------|-------------| | begin_group | details | Details | collapsible | | text | address | Address | | | text | phone | Phone | | | end_group | | | |
Вкладені групи
Групи можна вкладати в інші групи для більш складних структур:
| type | name | label |
|--------------|------------|------------------------------------------|
| begin_group | hospital | Hospital Information |
| text | hosp_name | What is the name of this hospital? |
| begin_group | medication | Medication Availability |
| select_one y_n| hiv_meds | Does this hospital have HIV medication? |
| end_group | | |
| end_group | | |
Примітка: Завжди завершуйте найбільш недавно розпочату групу першою, щоб підтримувати правильне вкладення.
Логіка пропуску для груп
Використовуйте стовпець relevant для реалізації логіки пропуску для цілих груп:
| type | name | label | relevant |
|--------------|--------|----------------------------------------------|-----------------|
| integer | age | How old are you? | |
| begin_group | child | Child | ${age} <= 5 |
| integer | muac | Record child's mid-upper arm circumference | |
| select_one y_n| mrdt | Is the child's rapid diagnostic test positive?| |
| end_group | | | |
У цьому прикладі група child з’явиться лише якщо вік респондента 5 або менше.
Найкращі практики використання груп
- Використовуйте значущі імена для груп для покращення аналізу даних.
- Тримайте групи сфокусованими на пов’язаних питаннях.
- Використовуйте вкладені групи обережно, щоб уникнути надмірно складних структур.
- Ретельно тестуйте логіку пропуску при використанні
relevantдля груп. - Розгляньте використання appearance
field-listдля коротких груп для зменшення прокрутки. - Використовуйте сітковий макет rtSurvey для компактного відображення пов’язаної інформації.
- Використовуйте згортальні групи для довгих форм для покращення навігації.
Специфічні функції rtSurvey
- Сітковий макет: Використовуйте appearance
gridдля табличних відображень. - Згортальні групи: Реалізуйте appearance
collapsibleдля розгортальних розділів. - Кастомна стилізація: Застосовуйте кастомний CSS до груп для унікальних візуальних дизайнів.
- Динамічна поведінка груп: Реалізуйте складну логіку пропуску та обчислення всередині груп.
Підтримка кількох мов
rtSurvey підтримує багатомовні групи. Використовуйте мовно-специфічні стовпці для міток:
| type | name | label::English | label::French |
|--------------|------------|----------------|---------------|
| begin_group | personal | Personal Info | Infos Personnelles |
| text | name | Name | Nom |
| end_group | | | |
Міркування щодо мобільного додатку
- Групи з appearance
field-listвідображаються як єдиний екран у мобільному додатку. - Згортальні групи можуть покращити навігацію на менших екранах.
- Сіткові макети можуть адаптуватися для кращої видимості на мобільних пристроях.
Відомі обмеження
- Дуже глибоке вкладення груп може вплинути на продуктивність на деяких пристроях.
- Деякі розширені параметри стилізації можуть бути недоступні для груп у мобільному додатку.
Усунення неполадок груп
- Переконайтеся, що кожний
begin_groupмає відповіднийend_group. - Перевірте, що імена груп є унікальними у межах форми.
- Переконайтеся, що логіка пропуску посилається на правильні імена питань.
- Ретельно тестуйте групи як у веб-, так і в мобільних інтерфейсах.
Ефективно використовуючи групи у ваших XLSForm з rtSurvey, ви можете створювати добре організовані, ефективні опитування, що покращують як досвід збору даних, так і якість аналізу даних.