NextERP/documentation
5
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

[IMP] surveys:update get started docs

Browse Source 
closes odoo/documentation#3414

X-original-commit: 3cf6e25f06
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Kevin Scannell (ksc) <ksc@odoo.com>
This commit is contained in:
KC (ksc)
2022-07-29 18:15:47 +00:00
committed by Zachary Straub (ZST)
parent 620387b9e8
commit 28237e3835
20 changed files with 278 additions and 107 deletions
Download Patch File Download Diff File Expand all files Collapse all files
content/applications/marketing/surveys/overview/time_random.rst
+36 -22
View File
@@ -1,34 +1,48 @@
============================
Time and Randomize Questions
============================
==============================
Timed and randomized questions
==============================
Time Limit
When creating a survey in Odoo, there are options to set a time limit on the survey and randomize
the questions.
Time limit
==========
| On timed surveys, respondents need to complete the survey within a certain period of time. It can
be used to ensure that all respondents get the same amount of time to find the answers, or to
decrease the chance of having them looking at external resources.
| Set the *Time limit* under the tab *Options*.
During a timed survey, participants must finish the survey within a specified period of time.
A common use case for implementing a time limit is that it greatly reduces the chance of
participants looking up responses via external resources (e.g. web search), and reduces the survey
to a "closed book" testing environment.
.. image:: time_random/tab_options_timelimit.png
Find the :guilabel:`Survey Time Limit` setting in the :guilabel:`Options` tab of the survey form,
under the :guilabel:`Questions` section.
.. image:: time_random/time-limit.png
:align: center
:alt: View of a survey form emphasizing the time limit feature in Odoo Surveys
:alt: Time limit field in the options tab of a survey template form.
A timer is shown on the pages so the user can keep track of the remaining time. Surveys not \
submitted by the *Time limit* do not have their answers saved.
When the :guilabel:`Survey Time Limit` option is checked, a timer will be displayed on every page
of the survey, letting participants keep track of the time remaining while the survey is active.
Selection
=========
.. note::
Participants that do not submit their survey by the preconfigured time limit will *not* have
their answers saved.
| When you randomize a survey, you allow for the questions to be shuffled in a random order every
time someone opens the questionnaire. This can be useful to avoid having respondents looking at
each others' answers.
| To do so, under the tab *Options*, enable *Randomized per section*. Now, under the tab *Questions*,
set how many of the questions in that section should be taken into account during the shuffling.
Randomized selection
====================
.. image:: time_random/random_question.png
When a survey is randomized, Odoo shuffles the questions and reveals them in a random order every
time a participant begins the questionnaire. Using randomization as a survey method discourages
participants from looking at each other's responses, and helps control for individual testing.
To randomize a survey, click the :guilabel:`Options` tab on the survey form. In the
:guilabel:`Questions` section, select :guilabel:`Randomized per section` for the
:guilabel:`Selection` field. After enabling, navigate to the :guilabel:`Questions` tab and look in
the :guilabel:`Random questions count` column. From there, determine how many questions (per
section) Odoo should select and display during the shuffling of questions.
.. image:: time_random/random-questions.png
:align: center
:alt: View of a survey form emphasizing the random questions count column in Odoo Surveys
:alt: Randomized question count in the questions tab of a survey.
.. seealso::
- :doc:`scoring`
:doc:`scoring`