Actions

Questions - introduction/ru: Difference between revisions

From LimeSurvey Manual

(Updating to match new version of source page)
(Updating to match new version of source page)
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
<languages />  
<languages />  
__ОГЛАВЛЕНИЕ__
__ОГЛАВЛЕНИЕ__
{{Alert|title=Attention|text=Please note that the explanations and screenshots from this wiki section are based on LimeSurvey 3.}}


=Вступление=
=Вступление=


После того как Вы [[Creating a question group|создали Ваши группы]], Вы можете начать добавлять вопросы в каждую группу. Создайте новый вопрос кликнув по значку [[File:add.png]] справа в меню "Группа".
Once you [[Question groups - introduction#create a question group|created your question groups]], you can start adding questions within each group. There are multiple ways through which you can do that. Two solutions are presented below:
 
* You may add questions from the [[Survey structure|survey structure menu]];
 
 
<center>[[File:Survey structure - add new question.png]]</center>
 
 
* Access a question group and look for the ''add question'' quick action button;
 
 
<center>[[File:Question group - add a new question.png]]</center>
 


При добавлении нового вопроса от Вас будет запрошен "Код вопроса", "Текст вопроса (Вопрос)", "Подсказка" и "Тип вопроса". Все новые вопросы будут связываться именно с той группой, которую Вы просматриваете (открыли) в данный момент времени. Вы можете изменить группу к которой будет принадлежать вопрос в дальнейшем.
=Field descriptions=


=Описания полей=
When adding a question, you will be asked about the '''question code''', '''question''' and '''help''' texts, and the general question options:
*'''Код''': ID, число, код вопроса. Это поле предназначено для быстрой идентификации вопроса при экспорте или в выражениях. Старайтесь придать кодировке логику. Хорошее планирование позволит гораздо проще составлять Ваши выражения в будущем. Данное поле обычно не отображается для участников опроса.


<div class="simplebox">Примечание: Код вопроса должен быть уникален в пределах данного опроса, а также начитаться с буквы и состоять только из букв и цифр. Если Вы уже пытались экспортировать данные в SPSS или R, то Вы могли заметить, что код вопроса становился значением меток, и Вы получали на выходе уникальный код. Временно LiveSurvey будет поддерживать режим совместимости значений кодов, но кнопка [[Show Logic File|Файл с логикой опроса]] будет выделять цветом такие вопросы, чтобы Вы знали, что их имена следует изменить.</div>
*'''Вопрос''': Это поле для заполнения текстом конкретного вопроса. Несмотря на то, что для данного поля нет никаких явных ограничений по длине текста, мы рекомендуем Вам пользоваться полем "Подсказка" для объяснения того, каким образом следует отвечать на поставленный вопрос. В данном поле может быть использован HTML-код, например, для вставки изображений <br /><nowiki><img src="http://www.yourdomain.com/yourpics/pic.jpg"></nowiki>. Встроенный визуальный редактор всегда может помочь Вам решить подавляющее большинство задач.
*'''Подсказка''': Это не обязательное поле. Оно весьма полезно тогда, когда вопрос может быть понят неоднозначно и требуются дополнительные пояснения для корректного ответа на заданный вопрос. После того как Вы напишете текст в данном поле он в дальнейшем будет отображаться под соответствующим вопросом с изображенным специальным значком подсказки.
*'''Тип вопроса''': Определяет типы ответов, разрешенные в данном опросе. Обзор секции [[Question types|Типы вопросов]] описывает различные доступные варианты ответов.
*'''Проверка''': Эта возможность доступна для всех вопросов требующих ввода текста или числовых данных. Вы можете воспользоваться стандартными [[Using regular expressions|Регулярные выражения]] для проверки правильности заполнения ответов на вопросы в этом поле и, если ответ не удовлетворяет выражению, пользователю будет сообщено о необходимости повторного ввода данных чтобы продолжить опрос.


*'''Другое''': Данная опция присутствует лишь в некоторых типах вопросов. Ее включение позволяет участнику указывать свой собственный ответ, не похожий ни на один из имеющихся заранее (предложенных ему системой).
<center>[[File:Add a question - 1.png]]</center>
*'''Обязательное''': Для всех типов вопросов данная опция указывает, является ли данный вопрос обязательным для ответа. Пользователь не может двигаться далее по опросу пока не ответит на все обязательные вопросы заданные ему в данный момент. Для вопросов ранжирования это означает, что предложенные варианты должны быть полностью ранжированы.


*'''Актуальность''':  Это логическое выражение задающее условия для данного вопроса. Если она установлена в 1 (Истина), то вопрос будет показан; в противном случае вопрос будет скрыт т. к. по определенным причинам более не является актуальным и значения ответов в базе данных будут присвоены NULL. Информацию о том как можно использовать параметр Актуальность можно найти на странице [[Expression Manager|Менеджер выражений]].


*'''Показать дополнительные настройки''': Дополнительные настройки отличающиеся в зависимости от выбранного типа вопроса. Для более подробной информации, пожалуйста, обратитесь к документации по Вашему конкретному [[Question types|типу вопросов]].
*'''Question code:''' It represents the ID, number or code for the question that is used for quick identification. This field is normally not displayed to people taking the survey unless specified in the [[Presentation]] panel - '''Show question number and/or code'''. It is especially useful if you wish to use the [[Assessments|LimeSurvey assessments feature]] and/or the [[Expression Manager|Expression Manager]].
 
<div class="simplebox">[[File:help.png]] '''Note:''' The question '''code''' must be unique across the same survey, must start with a letter, and can only contain alphanumeric characters. If you ever try to export your data to SPSS or R, you will discover that the "qcode" becomes the value label, so you have to make the code unique. For the time being, LimeSurvey will support legacy code values, but the [[Show logic file|Show logic file]] button will color-code such questions so that you know you should change their names.</div>
*'''Question:''' This is the actual question being asked. There is no real limit to the length of the question here, however if you want to explain how to fill out the question, leave that for the "Help" field. HTML-code can be used, e.g., for including images:
 
<syntaxhighlight lang="html" enclose="pre">     
<img src="http://www.yourdomain.com/yourpics/pic.jpg">
</syntaxhighlight>
 
<div class="simplebox">[[File:help.png]] '''Hint:''' You can also use the HTML WYSIWYG editor, which offers a GUI to perform the most important tasks such as using different fonts or sizes, including images, etc. To find out more about it, read the following [[First_login_-_your_user_preferences#HTML_editor_mode|wiki section]].</div>
 
*'''Help:''' This is an optional field. It is useful if a question needs some explanation or you want to explain how it should be answered. When you put text in this field, a "question mark" icon appears on the survey entry screens with the help text right beside it.
 
 
<div class="simplebox">[[File:help.png]] '''Note:''' The '''General options''' tab is accessed by default when you wish to add/edit a question (on the right side of the panel). The most important attributes can be found here such as the question type, question theme, as well as the mandatory attribute. However, you can edit further your question by making use of all the other attributes located under the rest of the tabs (see the below screenshot). To find out more about the multitude ways of designing questions in LimeSurvey, please continue reading the following [[Question types|wiki section]].</div>
 
 
<center>[[File:Add question - 2.png]]</center>
 
=General options=
 
Different tabs are displayed on the right part of the screen. The most basic and important one is the '''General options''' tab. The following question settings can be changed from here:
 
*'''Question type:''' This determines the type of response the survey allows. View the [[Question types|question types]] section for a description on the various available options;
*'''Question group''': To change the question group of a question, select from the dropdown list the desired group;
*'''Validation:''' This feature is available in all text- and numeric- type questions. You can use standard [[Using regular expressions|regular expressions]] in this field to validate the responses to the question, and if the responses don't validate against this expression, the user will be prompted to try again before he or she can progress further;
 
*'''Other?:''' This option can be used only with certain question types. If enabled, the question will include as a possible answer an extra "other" option/answer box, which can be selected by the survey participant if he or she is not satisfied with the predefined answer options;
*'''Mandatory?:''' This setting allows you to require survey participants to answer all the mandatory questions before they can move on to the next question. Note that for ranking question, all items have to be ranked;
 
*'''Relevance''': This is the Boolean equation that specifies the question conditions. If it evaluates to true, the question will be displayed to the survey participant; otherwise it is hidden and since it is irrelevant, data for that question is NULLed in the database. Details about how to use this option can be found in the [[Expression Manager|Expression Manager]] wiki section.
 
<div class="simplebox">[[File:help.png]] '''Note:''' As it can be observed in the above screenshot, many other options can be used besides the general options tab to customize your question. These more advanced question settings are different for each question type! Therefore, please consult the documentation for your particular [[Question types|question type]].</div>
 


=Импорт вопроса=
=Импорт вопроса=


В самом низу страницы под формой создания нового вопроса Вы можете найти форму для выбора и загрузки файла-вопроса. Здесь Вы можете произвести импорт любого файла-вопроса (*.lsq or *.csv (старый формат)), который был ранее экспортирован - это очень полезно, если Вы хотите повторно использовать вопрос из другого опроса.
You may find on the top of the '''Add question''' page a toolbar with different options, one of them being the import one:
 
 
<center>[[File:Import a question 1.png]]</center>
 
 
The following options will be displayed:
 
 
<center>[[File:Import a question 2.png]]</center>
 
 
* '''Browse:''' Select the .lsq file (the LimeSurvey question-type format);
* '''Destination question group:''' Select the question group you wish to add the imported question to;
* '''Automatically rename question code if already exists:''' If the question code already exists, enable this option to use another question code. You can also have two questions that use the same question code. However, some issues might appear if you use more complex LimeSurvey options such as the [[Expression Manager]] or when you work with the exported data in R or SPSS (qcode becoming a value label).
 
<div class="simplebox">[[File:help.png]] '''Hint:''' To check if the question codes are unique across your survey, use the [[Show logic file]] LimeSurvey function to highlight the similar question codes.</div>
 
*'''Convert resource links:''' It is usually used together with the [[Expression Manager]] to create advanced question types. If you use them together, complex branching, assessments, validation, and/or tailoring can be done.
 
To import the question, click on the '''Import''' button located on the upper right part of the screen. If succeeded, the question import summary should look like this:


<div class="simplebox">Важно: При импорте вопроса всегда будет создаваться новый вопрос. Оригинальный вопрос не будет затерт/переписан. Если Вы хотите скопировать вопрос внутри текущего опроса, то проще будет выбрать этот вопрос и воспользоваться кнопкой "Копировать этот вопрос".</div>


=Информация из таблицы ключей доступа=
<center>[[File:Import a question 3.png]]</center>


Вы можете внедрить информацию/текст из таблицы ключей доступа в Ваш вопрос, чтобы он мог показывать контекстную информацию. Для этого в LimeSurvey необходимо чтобы опрос был не анонимным (т.е. отслеживаемым) и имел таблицу ключей доступа.<br /><br />Доступные для этого поля:<br />
 
=Information from survey participants table=
 
<div class="simplebox">[[File:help.png]] Please note that the token tables are called now survey participants tables.</div>
 
You can insert information or text from the survey participants table into your question so that it can show context related information. For LimeSurvey to do this, the survey needs to be set as [[Participant settings#Participant settings panel|not anonymous]] (i.e: tracked) and it needs to have a [[Survey participants|survey participants table]] created.
 
The following placeholders can be used within a question:


{|
{|
|{TOKEN:FIRSTNAME}||вставляет значение из поля "firstname" в таблицу ключей доступа
|{TOKEN:FIRSTNAME}||inserts the value from the "firstname" field located in the survey participants table
|-
|-
|{TOKEN:LASTNAME}||вставляет значение из поля "lastname" в таблицу ключей доступа
|{TOKEN:LASTNAME}||inserts the value from the "lastname" field located in the survey participants table
|-
|-
|{TOKEN:EMAIL}||вставляет значение из поля "email" в таблицу ключей доступа
|{TOKEN:EMAIL}||inserts the value from the "email" field located in the survey participants table
|-
|-
|{TOKEN:ATTRIBUTE_1}||вставляет значение из поля "attribute_1" в таблицу ключей доступа
|{TOKEN:ATTRIBUTE_1}||inserts the value from the "attribute_1" field located in the survey participants table
|-
|-
|{TOKEN:ATTRIBUTE_2}||вставляет значение из поля "attribute_2" в таблицу ключей доступа
|{TOKEN:ATTRIBUTE_2}||inserts the value from the "attribute_2" field located in the survey participants table
|}
|}


Чтобы использовать данный функционал Вы должны ввести в поле вопроса текст так, как показано выше.
To use any of the placeholders from above, you must type it/them as written above in the question field text. For example:  
Пример:


Здравствуйте, {TOKEN:FIRSTNAME}! Мы отправили письмо на Ваш адрес: {TOKEN:EMAIL}. Он указан правильно?
''Hello {TOKEN:FIRSTNAME}. We sent an email to you using this address {TOKEN:EMAIL}.''


Другой пример с более тонкой настройкой, но используя JavaScript (см. [[Optional settings|Необязательные параметры]] как разрешить JavaScript для настройки вопросов и почему данная идея не всегда хорошая. Для использования JavaScript Вы должны отключить XSS-фильтр в [[Global settings|Глобальные настройки]]):
 
<syntaxhighlight lang="php" enclose="pre">
 
 
If you wish to further customize your questions, use the [[Expression Manager]]. For example, if you wish to make use of the tailoring technique, type in:
 
<syntaxhighlight lang="php" enclose="div">Что Вы думаете как {TOKEN:ATTRIBUTE_1} о Вашем {if(TOKEN:ATTRIBUTE_1=='worker','начальстве','персонале')}?</syntaxhighlight>
 
<hr width="50%" style="margin:auto">
 
You may also use JavaScript to achieve further question customization. First, you have to allow JavaScript to be used when setting up questions. This can be achieved by deactivating the XSS filter from the [[Global settings|global settings]] of your LimeSurvey installation. However, deactivating this option is not always a good idea - read the following [[Optional settings|wiki section]] for further information. Question tailoring via JavaScript:


<syntaxhighlight lang="php" enclose="div">Здравствуйте,  {TOKEN:FIRSTNAME}. Мы отправили Вам письмо используя следующий адрес: {TOKEN:EMAIL}. Он указан верно?
<syntaxhighlight lang="php" enclose="div">Здравствуйте,  {TOKEN:FIRSTNAME}. Мы отправили Вам письмо используя следующий адрес: {TOKEN:EMAIL}. Он указан верно?
Line 66: Line 141:
</syntaxhighlight>
</syntaxhighlight>


=Информация из предыдущих ответов=


<div class="simplebox">Начиная с версии 1.92, Вы можете использовать [[Expression Manager|Менеджер выражений]], для внедрения подобных конструкций не прибегая к JavaSctipt.   Аналогичная запись в 1.92 будет выглядеть следующим образом:</div>
LimeSurvey allows survey administrator to insert answer(s) from the previous question(s) into the text of a question:
 
*You can refer to answers on the same page and even dynamically update tailored messages as responses change on the page.
 
*You can use question code naming - for more details, see the [[Expression Manager]] documentation.
<syntaxhighlight lang="php" enclose="div">Что Вы думаете как {TOKEN:ATTRIBUTE_1} о Вашем {if(TOKEN:ATTRIBUTE_1=='worker','начальстве','персонале')}?</syntaxhighlight>
 
=Информация из предыдущих ответов=


В настоящее время имеется возможность внедрять ответы на предыдущие вопросы в текст текущего ответа при соблюдении следующих условий:
A wizard has been integrated in the WYSIWYG HTML editor (FCKeditor), so that you can easily insert previous question/answer codes. This plugin is called ''LimeReplacementFields''. In order to use this feature in the FCKeditor, click on the "lime between brackets" icon and select a question from the select box. Only answers from previous pages are displayed.
* Вопрос должен быть отвечен на предыдущей '''странице''' опроса - ответы на вопросы располагающиеся на данной странице не доступны!
* Вам необходимо указать точные данные: ID опроса, ID группы вопросов и ID вопроса ответ на который был сделан - в форме: {INSERTANS:SIDXGIDXQID} - т.е. {INSERTANS:1X2X3}. Почитайте больше [[SGQA identifier|SGQA идентификаторе]], чтобы понять как создать подобный код.


Мастер интегрирован в визуальный (WYSIWYG) HTML-редактор (FCKeditor), так что вы с легкостью сможете вставлять SGQA коды предыдущих ответов: данный плагин называется LimeReplacementFields. Чтобы воспользоваться данной функцией в FCKeditor кликните по значку "лимон в фигурных скобках" и выберите нужный вопрос из списка. Будут отображены ответы только с предыдущих страниц.
<center>[[File:Editor_replacementfields_button.png]]</center>


<div class="simplebox">LimeReplacementFields примечание: чтобы корректно удалить ссылку на SGQA-тег Вам необходимо выделить все символы от скобки до скобки и затем нажать Delete. Если же Вы будете пытаться стереть данный тег по символам использую клавиши Backspace или Delete, то запись будет появляться снова и снова.</div>
<div class="simplebox">[[File:help.png]] '''LimeReplacementFields notice:''' When you want to delete a reference to a {name} tag, please select all chars from the openning bracket to the closing bracket and press delete: DO NOT erase it char by char with the Delete or Backspace key otherwise the field will appear again.</div>


=Оформление вида вопросов=
=Оформление вида вопросов=


Используя [[The template editor|редактор шаблонов]] Вы можете полностью редактировать дизайн вопроса с помощью CSS.
It is possible to generally edit the question layout/design with CSS using [[Theme editor|the theme editor]].

Revision as of 20:25, 17 July 2018

__ОГЛАВЛЕНИЕ__


  Attention : Please note that the explanations and screenshots from this wiki section are based on LimeSurvey 3.


Вступление

Once you created your question groups, you can start adding questions within each group. There are multiple ways through which you can do that. Two solutions are presented below:



  • Access a question group and look for the add question quick action button;



Field descriptions

When adding a question, you will be asked about the question code, question and help texts, and the general question options:



  • Question code: It represents the ID, number or code for the question that is used for quick identification. This field is normally not displayed to people taking the survey unless specified in the Presentation panel - Show question number and/or code. It is especially useful if you wish to use the LimeSurvey assessments feature and/or the Expression Manager.
Note: The question code must be unique across the same survey, must start with a letter, and can only contain alphanumeric characters. If you ever try to export your data to SPSS or R, you will discover that the "qcode" becomes the value label, so you have to make the code unique. For the time being, LimeSurvey will support legacy code values, but the Show logic file button will color-code such questions so that you know you should change their names.
  • Question: This is the actual question being asked. There is no real limit to the length of the question here, however if you want to explain how to fill out the question, leave that for the "Help" field. HTML-code can be used, e.g., for including images:
       
<img src="http://www.yourdomain.com/yourpics/pic.jpg">
Hint: You can also use the HTML WYSIWYG editor, which offers a GUI to perform the most important tasks such as using different fonts or sizes, including images, etc. To find out more about it, read the following wiki section.
  • Help: This is an optional field. It is useful if a question needs some explanation or you want to explain how it should be answered. When you put text in this field, a "question mark" icon appears on the survey entry screens with the help text right beside it.


Note: The General options tab is accessed by default when you wish to add/edit a question (on the right side of the panel). The most important attributes can be found here such as the question type, question theme, as well as the mandatory attribute. However, you can edit further your question by making use of all the other attributes located under the rest of the tabs (see the below screenshot). To find out more about the multitude ways of designing questions in LimeSurvey, please continue reading the following wiki section.


General options

Different tabs are displayed on the right part of the screen. The most basic and important one is the General options tab. The following question settings can be changed from here:

  • Question type: This determines the type of response the survey allows. View the question types section for a description on the various available options;
  • Question group: To change the question group of a question, select from the dropdown list the desired group;
  • Validation: This feature is available in all text- and numeric- type questions. You can use standard regular expressions in this field to validate the responses to the question, and if the responses don't validate against this expression, the user will be prompted to try again before he or she can progress further;
  • Other?: This option can be used only with certain question types. If enabled, the question will include as a possible answer an extra "other" option/answer box, which can be selected by the survey participant if he or she is not satisfied with the predefined answer options;
  • Mandatory?: This setting allows you to require survey participants to answer all the mandatory questions before they can move on to the next question. Note that for ranking question, all items have to be ranked;
  • Relevance: This is the Boolean equation that specifies the question conditions. If it evaluates to true, the question will be displayed to the survey participant; otherwise it is hidden and since it is irrelevant, data for that question is NULLed in the database. Details about how to use this option can be found in the Expression Manager wiki section.
Note: As it can be observed in the above screenshot, many other options can be used besides the general options tab to customize your question. These more advanced question settings are different for each question type! Therefore, please consult the documentation for your particular question type.


Импорт вопроса

You may find on the top of the Add question page a toolbar with different options, one of them being the import one:



The following options will be displayed:



  • Browse: Select the .lsq file (the LimeSurvey question-type format);
  • Destination question group: Select the question group you wish to add the imported question to;
  • Automatically rename question code if already exists: If the question code already exists, enable this option to use another question code. You can also have two questions that use the same question code. However, some issues might appear if you use more complex LimeSurvey options such as the Expression Manager or when you work with the exported data in R or SPSS (qcode becoming a value label).
Hint: To check if the question codes are unique across your survey, use the Show logic file LimeSurvey function to highlight the similar question codes.
  • Convert resource links: It is usually used together with the Expression Manager to create advanced question types. If you use them together, complex branching, assessments, validation, and/or tailoring can be done.

To import the question, click on the Import button located on the upper right part of the screen. If succeeded, the question import summary should look like this:



Information from survey participants table

Please note that the token tables are called now survey participants tables.

You can insert information or text from the survey participants table into your question so that it can show context related information. For LimeSurvey to do this, the survey needs to be set as not anonymous (i.e: tracked) and it needs to have a survey participants table created.

The following placeholders can be used within a question:

{TOKEN:FIRSTNAME} inserts the value from the "firstname" field located in the survey participants table
{TOKEN:LASTNAME} inserts the value from the "lastname" field located in the survey participants table
{TOKEN:EMAIL} inserts the value from the "email" field located in the survey participants table
{TOKEN:ATTRIBUTE_1} inserts the value from the "attribute_1" field located in the survey participants table
{TOKEN:ATTRIBUTE_2} inserts the value from the "attribute_2" field located in the survey participants table

To use any of the placeholders from above, you must type it/them as written above in the question field text. For example:

Hello {TOKEN:FIRSTNAME}. We sent an email to you using this address {TOKEN:EMAIL}.


If you wish to further customize your questions, use the [[Expression Manager]]. For example, if you wish to make use of the tailoring technique, type in:

<syntaxhighlight lang="php" enclose="div">Что Вы думаете как {TOKEN:ATTRIBUTE_1} о Вашем {if(TOKEN:ATTRIBUTE_1=='worker','начальстве','персонале')}?

You may also use JavaScript to achieve further question customization. First, you have to allow JavaScript to be used when setting up questions. This can be achieved by deactivating the XSS filter from the global settings of your LimeSurvey installation. However, deactivating this option is not always a good idea - read the following wiki section for further information. Question tailoring via JavaScript:

Здравствуйте,  {TOKEN:FIRSTNAME}. Мы отправили Вам письмо используя следующий адрес: {TOKEN:EMAIL}. Он указан верно?
Что Вы думаете как {TOKEN:ATTRIBUTE_1} о Вашем
<script type="text/javascript" language="Javascript">;
   var job='{TOKEN:ATTRIBUTE_1}';
   if (job=='worker') {
      document.write ('начальстве')
   } else {
      document.write('персонале')
   }
</script>
?

Информация из предыдущих ответов

LimeSurvey allows survey administrator to insert answer(s) from the previous question(s) into the text of a question:

  • You can refer to answers on the same page and even dynamically update tailored messages as responses change on the page.
  • You can use question code naming - for more details, see the Expression Manager documentation.

A wizard has been integrated in the WYSIWYG HTML editor (FCKeditor), so that you can easily insert previous question/answer codes. This plugin is called LimeReplacementFields. In order to use this feature in the FCKeditor, click on the "lime between brackets" icon and select a question from the select box. Only answers from previous pages are displayed.

LimeReplacementFields notice: When you want to delete a reference to a {name} tag, please select all chars from the openning bracket to the closing bracket and press delete: DO NOT erase it char by char with the Delete or Backspace key otherwise the field will appear again.

Оформление вида вопросов

It is possible to generally edit the question layout/design with CSS using the theme editor.