Тип питання - Дата

Короткий опис

Цей тип питання можна використовувати, щоб запитати певну дату, час або поєднання дати й часу. Учасники можуть вибрати значення або у спливаючому календарі, або з випадаючих списків. Адміністратор опитування може вибрати перевірку, мінімальну та/або максимальну дату. Підтримуються різні формати дати й часу.

Приклад: Example_Date_Time.zip

Загальні параметри

Обов'язково

Опис

Цей параметр дозволяє адміністраторам опитування вимагати від респондентів відповіді на певні питання опитування. Якщо на обов'язкові питання не надано відповіді, респонденти не зможуть перейти далі. Якщо у вас є питання з кількома підпитаннями і потрібно, щоб відповіді були надані лише на певні підпитання, скористайтеся атрибутом мінімум відповідей, розташованим на вкладці Логіка.

Якщо ви використовуєте будь-яку з попередньо встановлених тем і атрибут питання обов'язково увімкнено, поруч із питанням відображатиметься червона зірочка. Якщо ви хочете її приховати, ознайомтеся з цими інструкціями.

Доступні варіанти

• Увімк. - на питання потрібно відповісти, перш ніж учасник зможе перейти на наступну сторінку - варіант відповіді «Немає відповіді» ніколи не відображається.
• М'яко - якщо на питання не надано відповіді, при спробі перейти на наступну сторінку відображається попередження - однак учасник може проігнорувати попередження і продовжити. Зверніть увагу, що варіант «Немає відповіді» все одно відображається (якщо його активовано в налаштуваннях презентації опитування)
• Вимк. (за замовчуванням) - питання можна залишити без відповіді

Умова

Опис

Якщо результатом умови є значення "1" або "true", питання є "релевантним" у контексті опитування, тобто воно відображається учаснику опитування. В іншому випадку питання приховується. Для будь-якого питання опитування можна вказати рівняння релевантності. Ця функція є наступницею умов і підтримує набагато складнішу умовну логіку.

Підсвічування синтаксису

Щоразу, коли ви зберігаєте умову, вона перевіряється, а її синтаксис підсвічується. Усі помилки позначаються кольором, щоб ви могли швидко їх виявити та виправити.

 Hint: Щоб перевірити, чи правильно використано всі умови у вашому опитуванні, прочитайте про нашу функцію показу файлу логіки.

Допустимі значення

• Будь-яка умова, що використовує синтаксис ExpressionScript, без обрамлення фігурними дужками.

Приклади

Ось хороші приклади підсвічування синтаксису.

Відображення

Відобразити випадаючі списки (dropdown_dates)

Опис

Якщо цей параметр увімкнено, питання типу дата/час відображатиме для респондентів випадаючий список, з якого можна вибрати дату/час, замість стандартного спливного вікна.

Доступні варіанти

• Увімк.
• Вимк. (за замовчуванням)

Приклад

Якщо цей параметр увімкнено, питання відображатиметься так:

Сховати підказку (hide_tip)

Опис

Більшість питань зазвичай містять підказку на кшталт «Будь ласка, оберіть один із наведених варіантів» або текст-підказку про те, як заповнити питання. Цей атрибут дає змогу вимкнути або ввімкнути такі підказки.

Ці підказки містять повідомлення про критерії перевірки (наприклад, мінімальну/максимальну кількість відповідей, мінімальне/максимальне значення суми або значення, що дорівнює сумі). Якщо hide_tip увімкнено, ці повідомлення буде приховано. Однак якщо користувач введе некоректні дані, підказки з’являться. Вони будуть червоного кольору і зміняться на зелений, щойно критерії перевірки буде виконано.

Доступні варіанти

• Увімк. — підказки приховано;
• Вимк. (за замовчуванням).

Стиль відображення місяця (month_display_style)

Опис

Місяці можна показувати респондентам трьома способами: за допомогою коротких назв (січ, лют тощо), повних назв (січень, лютий тощо) або номера/позиції місяця в річному календарі (01 для січня, 02 для лютого і так далі).

Доступні варіанти

• Короткі імена
• Повні імена
• Числа

Зворотний порядок відповідей (reverse)

Опис

Якщо цей параметр увімкнено, порядок відповідей буде змінено на зворотний.

Доступні параметри

• Увімк.
• Вимк. (за умовчанням)

Приклад

Припустімо, що ви хочете використати тип питання Масив (числа). Якщо цей параметр вимкнено (значення за умовчанням), учасник опитування може вибрати такі відповіді: "1, 2, 3, ... , 10". Якщо параметр увімкнено, порядок доступних відповідей буде змінено на зворотний: "10, 9, 8, ... , 1".

Тема питання (question_theme)

Опис

Дозволяє використовувати налаштовані теми для відповідного питання.

Доступні опції

• Створені вами теми питань, які розташовані в розділі Теми питань на панелі Теми.

Див.: Теми питань

Примітка: Ця функція наразі перебуває в розробці.

Завжди ховати це запитання (hidden)

Опис

Якщо цей параметр увімкнено, питання завжди буде приховане — його не буде показано учасникам опитування. Цю функцію можна використовувати в таких випадках:

• Якщо ви хочете попередньо заповнити питання через URL і не хочете, щоб воно відображалося на екрані. Це перевизначає всі умови, використані в опитуванні, оскільки відповідне питання взагалі не буде вбудовано на сторінку.
• Якщо ви хочете зберегти або обчислити значення «на льоту» за допомогою ExpressionScript — презентація.

Примітка: Поширений тип питання, який використовується з цією функцією, — Рівняння.

Доступні параметри

• Увімкнено
• Вимкнено (за замовчуванням)

CSS-клас (css_class)

Опис

Якщо ви хочете додати спеціальні CSS-класи до певних питань, введіть назву (назви) CSS-класу в це поле. Обов’язково розділяйте різні назви класів пробілом.

Допустимі значення

• Будь-який текстовий рядок із пробілом між різними назвами CSS-класів.

 Hint: Ви також можете вставити в це поле вираз ^{(New in 3.0.0 )}. Пам’ятайте, що результат виразу не оновлюватиметься динамічно.

  Згідно з W3C, назви CSS-класів можуть містити лише символи [a-zA-Z та 0-9], символи ISO 10646 від U+00A1 і вище, а також дефіс (-) і підкреслення (_). Вони не можуть починатися з цифри або з дефіса, за яким іде цифра. LimeSurvey кодує CSS-класи, але не виправляє цього повністю.

Мінімальна дата (date_min)

Опис

Цей атрибут питання можна використовувати, щоб задати мінімальне значення для питання з датою (у форматі y-m-d або будь-який допустимий англійський рядок — докладніше див. нижче). Його можна використовувати як для спливного календаря, так і для випадаючого списку. Якщо мінімальну дату не задано, за замовчуванням використовується 1.1.1900.

  Параметр перевірки Менеджера виразів також можна використовувати для налаштування «мінімальної дати». Однак, якщо ви використовуєте спливний календар, а вираз залежить від попереднього питання, розташованого на тій самій сторінці, рік у спливному календарі відображатиметься некоректно.

Допустимі значення

• Будь-яке значення дати у форматі РРРР-ММ-ДД (напр., 2017-08-24);
• Будь-яке значення року;
• Будь-який англійський рядок: "now", "-10 years", "tomorrow";
• Посилання на інше питання з датою/часом: AnotherDateQuestion (за допомогою коду питання);
• Вирази: за допомогою виразів мінімальну дату можна обчислювати динамічно. Наприклад, можна використати дату з попередньої відповіді + 3 дні як мінімум для поточного питання, ввівши: date("Y-m-d",strtotime(departuredate)+3*60*60*24).

Максимальна дата (date_max)

Опис

Цей атрибут питання можна використовувати, щоб задати максимальне значення для питання з датою (у форматі р-м-д або будь-якому іншому дійсному англійському рядку — додаткові варіанти див. нижче). Його можна застосовувати як для спливного календаря, так і для випадаючого списку.

  Параметр перевірки Expression Manager також можна використовувати для налаштування «максимальної дати». Однак якщо ви користуєтеся спливним календарем, а вираз залежить від попереднього питання, розташованого на тій самій сторінці, рік у спливному календарі відображатиметься неправильно.

Допустимі значення

• Будь-яке значення дати у форматі РРРР-ММ-ДД (наприклад, 2018-08-24);
• Будь-яке значення року;
• Будь-який англійський рядок: "now", "-10 years", "tomorrow";
• Посилання на інше питання типу дата/час: AnotherDateQuestion (за допомогою коду питання);
• Вирази: за допомогою виразів дату можна обчислювати динамічно. Наприклад, можна використати дату з попередньої відповіді + 3 дні як максимальну дату для поточного питання, ввівши: date("Y-m-d",strtotime(departuredate)+3*60*60*24).

Довідка з релевантності для друкованого опитування (printable_survey_relevance_help)

Опис

Якщо ви хочете надрукувати опитування, можна також надрукувати рівняння релевантності для кожного питання. Якщо ж ви бажаєте, щоб у друкованій формі замість виразу відображалося пояснення, заповніть це поле текстовим поясненням рівняння релевантності.

Допустимі значення

• Будь-який текст та/або числа, які ви хочете відобразити у друкованій формі.

Введення

Формат дати/часу

Опис

Цей параметр питання можна використовувати, щоб указати власний формат дати. Якщо він порожній, буде використано формат дати опитування.

Допустимі значення

• Формати d/dd, m/mm, yy/yyyy, H/HH, M/MM можна використовувати для відображення дати та/або часу, а символи "-", ".", "/", ":" — як роздільники.

Приклади

• yyyy-mm-dd - рік-місяць-день;
• dd.mm.yyyy HH:MM - день.місяць.рік години:хвилини;
• HH:MM - години:хвилини (можна вибрати лише час);
• yyyy/mm - рік/місяць.

Інтервал кроку в хвилинах (minute_step_interval)

Опис

 Hint: This feature changed with version 3.14.12

Використовується лише тоді, коли формат введення містить хвилини ("MM").

Допустимі значення

• Будь-яке числове значення, менше за 60. Додавання значення більше за 60 є зайвим -> у випадаючому списку як можливі відповіді відображатиметься лише "0" або "00".

Приклад

У наведеному нижче прикладі параметр інтервалу кроку в хвилинах встановлено на 7:

Логіка

Назва групи рандомізації (random_group)

Опис

Розміщує питання в указану групу рандомізації. Усі питання, що входять до цієї групи, показуються респондентам опитування у випадковому порядку.

Приклад опитування з використанням назви групи рандомізації можна знайти в прикладі опитування ExpressionScript.

Допустимі значення

Просто введіть будь-який рядок (наприклад: 'group1'). Усі питання, для яких у полі назви групи рандомізації указано однаковий рядок, матимуть випадково впорядковане розташування в опитуванні (=випадково змінюватимуться місцями між собою).

Попередній перегляд Щоб переглянути питання, використовуйте функцію попередній перегляд опитування замість функції попередній перегляд групи питань, оскільки, за повідомленнями, остання не показує питання у випадковому порядку.

Рівняння перевірки питання (em_validation_q)

Опис

Це рівняння, яке використовується для перевірки всього питання (наприклад, усіх його частин разом для питання з кількома відповідями). Якщо питання не відповідає критеріям перевірки, буде показано повідомлення em_validation_q_tip (воно використовує CSS-стиль .error). Ця підказка використовує CSS-стиль .em_q_fn_validation, який за замовчуванням приховано у файлі template.css.

Головна відмінність між цією функцією та рівняннями перевірки підпитань (параметр em_validation_sq) полягає в тому, що для цієї функції, якщо питання (або його частини) не проходить перевірку, може бути показано повідомлення про помилку. Для перевірки підпитань кожну комірку введення тексту (наприклад, у типі питання «масив», але це також можна застосувати до типів питань з одним полем введення) буде позначено (світло-)червоним кольором фону.

Допустимі значення

• Будь-яке рівняння, що використовує синтаксис ExpressionScript, без оточуючих фігурних дужок.

Приклад

• Ви хочете зібрати демографічну інформацію від користувачів за допомогою питання «Кілька коротких текстів» і перевірити, що користувач ввів дійсну електронну адресу та номер телефону.

Цей приклад показує, як виглядає питання з недійсними відповідями:

А ось як воно виглядає з однією недійсною відповіддю:

Ось як потрібно редагувати питання, щоб ввести цю інформацію:

А ось частина виводу Показати файл логіки, яка дає змогу перевірити правильність вашого виразу та переконатися, що в ньому немає синтаксичних помилок:

Як видно, рівняння перевірки визначає, що електронна адреса та номер телефону або порожні, або відповідають фільтру регулярного виразу.

Підказка перевірки показує попередження лише тоді, коли телефон або електронна адреса виглядає недійсною.

 Hint: Щоб створити складні повідомлення перевірки, прочитайте про використання ExpressionScript.

Якщо ви хочете імпортувати наведений вище приклад у вашу інсталяцію LimeSurvey, завантажте такий файл .lsq: Em_validation_q_example.zip.

 Hint: Пам’ятайте, що LimeSuvey використовує синтаксис Perl для регулярних виразів, тому вони повинні починатися та закінчуватися символом / (скісна риска)!

Підказка для рівняння перевірки всього питання (em_validation_q_tip)

Опис

Якщо ви використовуєте рівняння перевірки питання, за допомогою цього поля можна відобразити необов'язкове повідомлення як підказку до питання про те, як потрібно його заповнити.

Допустимі значення

• Будь-який рядок або рівняння, що використовує синтаксис ExpressionScript.

Приклад

Перегляньте приклад у розділі вікі про рівняння перевірки питання — він показує, як можна налаштувати підказку, щоб вона показувала, які частини питання типу «Кілька коротких текстів» не відповідають критеріям перевірки.

Інше

Вставити розрив сторінки у вигляді для друку (page_break)

Опис

Цей атрибут активний, лише коли ви друкуєте опитування з вигляду для друку. Він примусово вставляє розрив сторінки перед питанням.

Доступні варіанти

• Увімк.
• Вимк. (за замовчуванням)

Статистика

Відобразити графік (display_chart)

Опис

Цей атрибут дозволяє адміністратору опитування вибрати, чи слід показувати учасникам опитування діаграму з результатами питання після заповнення опитування.

Примітка: Щоб діаграма відображалася на останній сторінці, потрібно ввімкнути такі параметри:

• налаштування опитування Публічна статистика у розділі Налаштування презентації та навігації
• налаштування опитування Показувати графіки у розділі Налаштування презентації та навігації
• атрибут питання «Публічна статистика» та
• атрибут питання «Відобразити графік».

Доступні варіанти

• Увімк.
• Вимк. (за замовчуванням)

Тип діаграми (chart_type)

Опис

Цей атрибут дозволяє адміністратору опитування вибрати тип діаграми, яка відображатиметься респонденту після завершення заповнення опитування.

Примітка: Не забудьте змінити налаштування питання та налаштування опитування, щоб діаграми відображалися в кінці опитування. Докладніше читайте в розділі вікі про атрибут питання «Відобразити графік (діаграму)».

Доступні параметри

• Гістограма
• Кругова діаграма
• Радарна діаграма
• Лінійна діаграма
• Полярна діаграма
• Кільцева діаграма

Дати та ExpressionScript: розширена перевірка та обчислення

Limesurvey (версії 2.05 і новіші) дає змогу досить легко перевіряти дати за допомогою полів date_min та date_max (див. вище). Використовуйте їх, коли це можливо. Якщо вам потрібна складніша перевірка, ви можете працювати з датами (і виконувати обчислення) за допомогою ExpressionScript та функції strtotime(). Вона обчислює кількість секунд від 1 січня 1970 року до заданої дати.

Приклад: якщо ви хочете показати в тексті питання кількість днів, що минули від дати відправлення (запитаної в попередньому питанні) до сьогодні, можна використати вираз {(strtotime("now")-strtotime(departure))/60/60/24}.

Зверніть увагу: strtotime() працює з багатьма форматами, але не з усіма! Наприклад, формат дати за замовчуванням у Limesurvey (MM-DD-YYYY) НЕ працює зі strtotime(). Щоб уникнути проблем, налаштуйте для опитування один із таких форматів дати: YYYY-MM-DD, YYYY/MM/DD, DD.MM.YYYY, MM/DD/YYYY або DD-MM-YYYY.

  Дати в Limesurvey зберігаються як рядок (текстовий формат). ExpressionScript перетворює всі дати у складі виразу на стандартний формат "yyyy-mm-dd HH:MM:SS". Це значно спрощує порівняння дат у виразі (наприклад, "date1>date2"). Якщо вам потрібен рядок дати у форматі, у якому її було запитано в питанні, скористайтеся атрибутом ".shown" (наприклад: Ви народилися {birthdate.shown}.)