Actions

Difference between revisions of "Surveys - introduction/fr"

From LimeSurvey Manual

m (FuzzyBot moved page Creating surveys - introduction/fr to Surveys - introduction/fr without leaving a redirect: Part of translatable page "Creating surveys - introduction".)
(Updating to match new version of source page)
 
(39 intermediate revisions by 3 users not shown)
Line 2: Line 2:
  
  
=Overview=
 
  
To create a new survey, click on the small arrow beside the '''Surveys''' menu, and then '''Create a new survey'''.  
+
{{Alert|title=Attention|text=Veuillez noter que ce tutoriel comporte des explications et des copies d'écran concernant LimeSurvey 3.xx. De légères différences existent entre LimeSurvey 3.xx et LimeSurvey 2.xx, plus spécifiquement pour ce qui a trait à l'interface graphique utilisateur (GUI). Nous recommandons l'usage de la dernière version de LimeSurvey.}}
  
[[File:createnewsurvey.png]]
+
=Général=
  
A '''Create New Survey''' screen will appear.  
+
Plusieurs paramètres interconnectés dans la base constituent un questionnaire : ceux des langages, des groupes de questions, des questions, des attributs des questions, des réponses, des sous-questions, des réponses par défaut, des évaluations, des quotas, des membres des quotas et des langages de quota. Pour faciliter la [[Surveys - introduction#Surveys|gestion des questionnaires]], une nouvelle fonctionnalité a été introduite {{NewIn|3.0}}, il s'agit des [[Surveys - introduction#Survey groups|groupes de questionnaires]].
  
[[File:newsurveyscreen.png]]
+
=Les questionnaires=
  
You can edit most of these settings later again by clicking the '''Survey properties''' and then '''General settings & text'''.
+
Il y a deux manières d'atteindre la page '''[[Surveys - introduction#Create a new survey|créer un nouveau questionnaire]]''':
  
[[File:token_manage_30.png]]
+
<div class="mw-translate-fuzzy">
 +
1. La première façon est de cliquer sur la flèche à côté du bouton '''Questionnaires''' situé dans la barre d'outil principale de l'accueil de LimeSurvey. Une liste déroulante apparaît qui vous proposera l'option '''Créer un nouveau questionnaire''' :
 +
</div>
  
=Tutoriels vidéo=
 
  
There are a number of tutorial videos for LimeSurvey out there. This is a list of the ones we think that are the best. You are welcome to create a new tutorial and add it here.
+
<center>[[File:createnewsurvey.png]]</center>
*[[LimeSurvey Video-Tutorial|Tutorial A]] - this video tutorial was made available to us by Andreas Pursche ([http://www.paul-consultants.de/ PAUL Consultants e.V.] of University of Technology Dresden).
 
*[http://www.youtube.com/watch?v=KWE0wAoyvak Tutorial 'How to get started - a first survey' ] - this one is really nice and available on YouTube and should be viewed in HD
 
*[http://youtu.be/Uk3FQyDTIY0 LimeSurvey training video - template customization] - A very good introduction on how to customize a Limesurvey template
 
  
=Éléments de base d'un sondage=
+
<div class="mw-translate-fuzzy">
 +
2. La seconde est de cliquer directement sur ce bouton '''Questionnaires''' :
 +
</div>
  
Un '''sondage''' est constitué au minimum des trois composantes fondatrices suivantes:
 
*Un nom de sondage
 
*Au minimum un groupe de questions
 
*Au minimum une [[Types de questions|question]]
 
  
Les composants optionnels peuvent être:
+
<center>[[File:Surveys-alternative button.png]]</center>
*Une liste de réponses applicables aux questions
 
*Des étiquettes personnalisables
 
*Des conditions qui peuvent déterminer si une question doit être affichée ou non
 
  
Simply import those surveys into your installation (or into the [http://www.limesurvey.org/en/demo public LimeSurvey demo]), and test the survey.  One of the easiest ways to review the survey logic is via the new [[Show Logic File|Show Survey Logic]] feature.
 
  
=Basic survey elements=
+
<div class="mw-translate-fuzzy">
 +
Une liste des questionnaires s'affiche. Pour créer un nouveau questionnaire, cliquez sur le bouton '''Créer un nouveau questionnaire''' situé en haut à gauche de la fenêtre, au-dessus de la liste de questionnaires.
 +
</div>
  
A '''survey''' has three integral elements, each of which must exist:
 
*A survey name
 
*At least one group
 
*At least one [[Question types|question]]
 
  
Optional elements to a new '''survey''' include:
+
<center>[[File:Create a new survey alternative.png]]</center>
*Applicable answers to each question
 
*Modifiable labels (known as label sets)
 
*Conditions that determine whether a question should be asked
 
  
==Nom du sondage==
+
==Créer un nouveau questionnaire==
  
Le '''nom du sondage''' parle de lui même: C'est le nom donné au sondage, ce nom permet d'accéder à de nombreuses options relatives au sondage dans son ensemble. On y trouvera notamment les options telles que le 'message de bienvenue', la description du sondage, les informations pour contacter l'administrateur du sondage, sous quelle forme le sondage doit être présenté.
+
<div class="mw-translate-fuzzy">
 +
Après le clic sur '''Créer un nouveau questionnaire''', la page suivante s'affiche :
 +
</div>
  
==Groupe==
 
  
les questions d'un sondage sont réparties dans des groupes. Cela permet de structurer logiquement le sondage en regroupant les questions par thème. Un groupe de questions possède un titre et une description optionnelle. Vous devez définir au minimum un groupe par sondage, même si vous ne désirez pas subdiviser le sondage en plusieurs groupes.
+
(1) Enter the '''Survey title'''.  
  
<div class="simplebox">'''Note''':<br />This whole chapter deals with '''question groups'''. Do not confuse a '''question group''' with a '''user group'''.  Each is very different and used in different ways, based on the object being grouped.</div>
 
  
A question '''group''' has a title and an optional description. You must have at least one '''group''' in each survey, even if you do not wish to divide the survey into multiple groups.
+
'''Note''': The Survey title field is required.  The remaining fields are optional. For a detailed explanation of each field, please refer to the Text Elements section below.
  
==Questions==
 
  
Les questions sont le coeur de votre sondage et sont placées dans des groupes, comme nous l'avons expliqué précédemment. Il n'y a pas de limite technique au nombre de questions que vous pouvez définir dans votre sondage, ni dans le nombre de questions par groupe. Une question comprend le texte de la question ainsi que des paramètres permettant de définir le type de réponse que vous attendez. Vous pouvez aussi ajouter une 'Aide' sous forme d'un petit texte explicatif ainsi que préciser si la question est obligatoire (ie: la question doit avoir une réponse pour continuer le sondage).
+
(2) Click '''Save''' (In the top-right just below your '''Username''').
  
=Basics of navigating the survey administrative interface=
 
  
The '''LimeSurvey''' tool presents horizontal tool bars to the survey creator in their web browser.  These toolbars are the header of a window allowing interaction.
 
  
==Administrative Tool Bar==
+
<center>[[File:newsurveyscreen.png]]</center>
  
The top toolbar is usually the '''Administrative Tool Bar''' providing top level, global actions.  One of the key items there is the drop down list of surveys along with a '''Create New (Survey)''' button [[File:CreateSurvey-button.png]] ; if available and enabled for your login account.  Both are on the right side of the toolbar.
 
  
[[File:SystemAdmin.png]]
+
<div class="mw-translate-fuzzy">
 +
Pour ajuster les options disponibles pour votre questionnaire, vous pouvez parcourir les différents onglets présents sous la barre d'outils '''Créer un nouveau questionnaire''' :
 +
*[[Surveys - introduction#Text elements|Text elements]]
 +
*[[Surveys - introduction#General settings|General settings]]
 +
*[[Surveys - introduction#Presentation & navigation|Presentation & navigation]]
 +
*[[Surveys - introduction#Publication & access control|Publication & access control]]
 +
*[[Surveys - introduction#Notification & data management|Notification & data management]]
 +
*[[Surveys - introduction#Participant settings|Participant settings]]
 +
</div>
  
<div class="simplebox">'''Hint''':<br />Want to know more about a particular icon button in a tool bar?  Hover over the icon to see its name or click on the Help button [[File:help-button.png]] in the '''Administrative Tool Bar''' to see a description of icons in the currently active toolbar.</div>
+
*[[Surveys - introduction#Text elements|Text elements]]
 +
*[[Surveys - introduction#General settings|General settings]]
 +
*[[Surveys - introduction#Presentation & navigation|Presentation & navigation]]
 +
*[[Surveys - introduction#Publication & access control|Publication & access control]]
 +
*[[Surveys - introduction#Notification & data management|Notification & data management]]
 +
*[[Surveys - introduction#Participant settings|Participant settings]]
  
If the '''Administrative Tool Bar''' does not appear to be on top, click the home button [[File:button-home.png]] to get back to it.  The Labelset [[File:button-labelset.png]] and Template [[File:button-template-editor.png]] editors, available in this tool bar, are the only ones that can replace the '''Administrative Tool Bar'''.
 
  
By clicking the '''Create New (Survey)''' button [[File:CreateSurvey-button.png]] or selecting an existing survey, you minimize the Administrative window and open a new tool bar below to manage the '''Survey'''.
+
{{Box|You can also re-edit most of these settings by accessing the [[Survey settings|settings menu]] of the newly created survey and editing the desired options.}}
 +
{{Alert|title=Attention|text=The HTML WYSIWYG editor does not allow you to upload files during the survey creation process. Doing so will cause an error message: E.g., "This file uploader is disabled". If you need to upload pictures or other resources, please do so after the survey creation by accessing the [[Resources|resources panel]] from the [[Survey settings|survey settings menu]].}}
  
[[File:GroupToolbarSmall.png]]
+
===Les éléments textuels===
  
==Survey Tool Bar==
+
Les options suivantes sont disponibles sur cet onglet :
  
Similar to before, one can click on the drop down list of question '''Groups''' or on the '''Create New (Group)''' button [[File:CreateSurvey-button.png]] on the '''Survey''' toolbar.  Either selection will bring up the question '''Group''' toolbar below the '''Survey''' toolbar.
+
*'''Titre du questionnaire''' Le titre du questionnaire peut être modifié depuis ce champ;
  
[[File:SurveyToolbarSelectGroupSmall.png]]
+
<div class="mw-translate-fuzzy">
 +
*'''Créer un exemple de question et groupe de question ?:'''{{NewIn|3.0}} Si c'est activé, une question et un groupe de question par défaut seront ajoutés à votre questionnaire lorsque vous créez celui-ci;
 +
{{Alert|title=Attention|text=Il est à noter qu'une question doit d'abord être ajoutée à un groupe de question pour apparaître dans le questionnaire! Sinon la question ne sera pas montrée au participant du questionnaire.}}
 +
</div>
  
==Group Tool Bar==
+
*'''Base Language''': This represents the main language of the survey. If you wish to add other survey languages, first create a survey, then access the [[General_settings#General_settings_panel|general settings]] of the newly created survey and add ''additional languages''.
  
In the Question Group, you can click on the drop down list of '''Questions''' or click the '''Create New (Question)''' button [[File:CreateSurvey-button.png]] to add a fourth toolbar to now edit a '''Question'''.
+
*'''Description:''' You can type in a survey description. If enabled from the [[Global settings|global settings]], you can use the [[Global_settings#General|HTML editor]] to better customize the description field.
  
[[File:GroupToolbarSelectQuestion.png]]
+
*'''End URL:''' You have the possibility to redirect users to another page when they finish filling out the questionnaire. If you wish to redirect them, type in the URL and activate the '''automatically load URL''' option that is located under the [[Surveys - introduction#Presentation & navigation|Presentation & navigation tab]].
  
==Common Buttons==
+
*'''URL Description:''' A short end URL description can be added in instances where the user is redirected to a non-related survey webpage. It may help if the survey administrator adds notes relating to the usage of the respective URL.
  
In these nested toolbars are some common, navigational buttons.  There is an '''Edit''' button [[File:edit-button.png]] to edit the object you selected.  By default, you will be put in the editor if you create the object.  There is a '''Delete''' button [[File:delete-button.png]] to delete the object.  For '''Groups''' and '''Questions''', there is a '''Reorder''' button [[File:change-order-button.png]] to change the order the object appears in during the survey execution.  Finally, there is an '''Export''' button [[File:export-button.png]] to export a survey, question group or question that you can import back into another survey.  Note that the '''Create''' button [[File:CreateSurvey-button.png]] also allows you to import a previously exported object.
+
*'''Date Format:''' This option is important when you want to record [[Surveys - introduction#Notification & data management|timestamps]] together with the survey participants' answers. If you click on it, a drop-down list will show up with a several date formats. Choose the date format used in the geographical location of your respondents. Do not forget that different date formats are used across the world. For example, it is recommended that you use a different time format if your questionnaire focuses on the US market (mm-dd-yyyy) and not on the British market (dd-mm-yy).
  
[[File:QuestionToolbar.png]]
+
*'''Decimal Mark:''' Two options are available: dot (.) and comma (,). Choose the one that fits the place (the geographical location) where you conduct your study (e.g. US vs Germany).
  
Finally, there are two to three small buttons to the far right [[File:CommonButtons.png]] to minimize, maximize, and close the window of a toolbar.  The maximize button will take you back to the summary window of the currently selected object.
+
*'''Welcome Message:''' Type in a message that will welcome the survey participants when they access your survey link.
  
As seems natural, the window of the current toolbar is automatically minimized when you select a lower level object to edit.  Only the current toolbar and its window can be closed.  You can open a previous toolbar and window by clicking on its maximize button.  And you can jump around by selecting or creating a new object in another toolbar without having to close the currently open window first.
+
*'''End Message:''' Type in a message that will be displayed to the survey participants once they finish the questionnaire. If the '''end URL''' field is [[Surveys - introduction#Presentation & navigation|automatically loaded]], the end message is no longer displayed.
  
We will discuss navigating through a survey itself later on in the section on testing the survey.
+
===Paramètres généraux===
  
=Survey settings=
+
Les options suivantes sont disponibles sur cet onglet :
  
Now that we have some basics down, lets move on and create our first survey. When doing so, we first have to define the basic [[Survey settings|survey settings]].
+
 
 +
<center>[[File:Create a new survey - General settings.png]]</center>
 +
 
 +
*'''Survey Owner:''' Type in the real name of the survey owner.
 +
*'''Administrator:''' The name of the administrator.
 +
*'''Admin Email:''' Type in the email address of the survey administrator.
 +
 
 +
{{Note|'''Administrator''' and '''admin email''' are managed in the LimeSurvey [[Email templates|email templates]] system.}}
 +
<div class="simplebox">[[File:help.png]]Many hosting providers' SMTP servers will only accept emails whose "From" address is on a local domain. All emails that do not conform to this rule are discarded silently, without any visible error message. If this happens, ensure that you are using a provider-based email address in the "Admin Email" field. You could also set up email forwarding on the provider's side, so that any messages sent there are forwarded to your preferred address.</div>
 +
 
 +
*'''Bounce email:''' This is the email address where the delivery error notification emails (bounced emails) will be sent to.
 +
<div class="simplebox">[[File:help.png]] A bounce email is an electronic email which is returned to the sender for various reasons (e.g. invalid address, temporary unavailable mail server, the recipient's mailbox is full, etc).</div>
 +
 
 +
*'''Fax To:''' This field is used to print a fax number on the "printable survey" - i.e.: when you want to send someone a hard copy because he or she cannot use the online survey.
 +
 
 +
*'''Group'''{{NewIn|3.0}}''':''' Select the [[Surveys - introduction#Survey groups|survey group]] that the newly created survey should be added to.
 +
 
 +
*'''Format:''' This function allows you to choose the way in which the questions will be displayed to the survey respondents. Three options are available:
 +
**''Question by Question'' : The questions will be displayed one by one (one question per page). If this option is chosen, a separate "welcome" page and "end" page will be displayed when taking the survey.
 +
**''Group by Group'' : Each survey page will display a question group. Also, a separate "welcome" page and "end" page will be displayed when taking the survey, as with the "Question by Question" surveys.
 +
**''All In One'' : If chosen, all the pages will be displayed on a single page. If you select this option, no separate pages will be displayed for the "welcome" and "end" pages - they will all appear on the same page, together with the questions.
 +
 
 +
*'''Template:''' The default template is rather simple, but functional. More information on creating your own templates is available [[Theme  editor|here]].
 +
 
 +
===Presentation & navigation===
 +
The following options can be found under the Presentation & Navigation tab:
 +
 
 +
 
 +
<center>[[File:Create a new survey - Presentation & navigation.png]]</center>
 +
 
 +
 
 +
*'''Navigation Delay (Seconds):''' This feature displays the number of seconds before the previous, next, and submit buttons are enabled. If none is specified, the option will use the default value, which is "0" (seconds).
 +
 
 +
*'''Show Question Index / Allow Jumping:''' A question index can be displayed in the survey if this function is enabled, allowing the user to jump from one question group to another. You can choose the following:
 +
**''Disabled'' : If this option is selected, no index is shown in the survey.
 +
**''Incremental'' : If this option is selected, the question groups will be shown incrementally in an index menu located on the survey page. You are allowed to "jump back" only to the question groups that were previously visited/accessed.
 +
**''Full'' : Jumping from question group to question group is allowed via the index menu.
 +
 
 +
*'''Show "There Are X Questions In This Survey"''': This shows the total number of questions in your survey.
 +
 
 +
*'''Show Group Name and/or Group Description:''' This function allows you to choose whether your survey will show participants the question group name only, the group description only or both. You may also choose to hide both.
 +
 
 +
*'''Show Question Number and/or Code:''' This function allows you to choose whether your survey will show participants the question number only, the question code only or both.  You may also choose to hide both.  Please note, the question number is shown the moment someone starts the survey, while the question code is shown next to each survey question.
 +
 
 +
*'''Show "No Answer":''' When a ''"radio button"'' or ''"select type"'' question that contains editable answers (e.g.: List & Array questions) has the '''Show "No Answer"''' option enabled and it is also '''not mandatory''', an additional entry "No Answer" is displayed for each question/sub-question. In this way, the respondents may choose not to answer the respective question/sub-question. The following two options are available for survey administrators:
 +
 
 +
**''On'' : If this option is selected, the respondents can choose the "No Answer" option for a non-mandatory question.
 +
**''Off'' : If selected, the "No Answer" option will not be displayed as a possible answer for any non-mandatory question.
 +
 
 +
{{Box|Options set in the [[Global settings#Presentation|global settings]] override all other survey settings.  Therefore, if the super-administrator chooses to have the "No Answer" option displayed, then the '''Show "No Answer"''' of the local survey field becomes non-selectable.  The same applies to the ''"Off"'' option. To offer freedom to survey administrators, the super-administrator has to choose "Selectable" for the '''Show "No Answer"''' option from the global settings of your LimeSurvey installation.}}
 +
 
 +
*'''Show Welcome Screen:''' If turned off, the welcome text message will not be displayed at the beginning of the questionnaire.
 +
 
 +
*'''Allow Backward Navigation:''' If enabled, this will allow the users to navigate backwards and change his or her previous answers.
 +
 
 +
*'''Show On-Screen Keyboard:''' If turned on, an on-screen keyboard will will be displayed when answering questions that require typing in information.
 +
 
 +
*'''Show Progress Bar:''' When enabled, this function displays a progress bar that shows participants how much of the survey they have completed and how much is left to be completed.
 +
 
 +
*'''Participants May Print Answers:''' If turned on, the survey participants may choose at the end of the survey to print their answers.
 +
 
 +
*'''Public Statistics:''' A link to a set of statistics will be shown at the end of the survey if this option is enabled.
 +
 
 +
*'''Show Graphs In Public Statistics:''' If enabled, graphs will also be shown in the Public Statistics at the end of the survey. Please note that the "Public Statistics" option has to be enabled to allow the survey participants to see the graphs.
 +
 
 +
*'''Automatically Load URL When Survey Complete:''' The end URL becomes a redirect link once the survey is completed if this option is turned on.
 +
 
 +
===Publication & access control===
 +
 
 +
The following options can be found under the Publication & Access Control tab:
 +
 
 +
 
 +
<center>[[File:Publication & access control.png]]</center>
 +
 
 +
 
 +
*'''Start Date/Time:''' This is the date/time the survey starts.
 +
 
 +
*'''Expiry Date/Time:''' This function allows you to choose a date for your survey to expire.  This is the last date on which the public survey script will let people participate. (Example: If you set the expiry date for the 31st of December, then people will no longer be able to fill out the survey on the 1st of January). To remove an expiry date, just clear the date from the input field.
 +
 
 +
*'''List Survey Publicly:''' The default value is "No". When it is set to "Yes", your survey will be listed in the "Available Surveys" portal where it can be seen by all [[Manage users|LimeSurvey users]].
 +
 
 +
*'''Set Cookie to Prevent Repeated Participation:''' If this is turned on, a survey participant will be blocked from completing a survey a second time.
 +
 
 +
*'''Use CAPTCHA for Survey Access:''' In order to access the survey, a CAPTCHA code has be typed in by the survey participant.
 +
 
 +
*'''Use CAPTCHA for Registration:''' In order to register for the survey, a CAPTCHA code has be typed in by the survey participant.
 +
 
 +
*'''Use CAPTCHA for Save and Load:''' Enable this function if you want a survey participant to type in a CAPTCHA code when he or she loads the survey again after only a part of it was completed (to prevents automated responses).
 +
 
 +
===Notification & data management===
 +
 
 +
The following options can be found under the Notification & Data Management tab:
 +
 
 +
 
 +
<center>[[File:Create a new survey - Notification & data management.png]]</center>
 +
 
 +
 
 +
*'''Date Stamp:''' Enable this functionality if you would like to see the time when the answers were submitted.
 +
 
 +
*'''Save IP Address:''' If "yes" is selected, the IP address of the survey respondent will be stored together with his or her answers.
 +
 
 +
*'''Save Referrer URL:''' If "yes" is selected, the referrer URL will be stored together with the answers.
 +
 
 +
*'''Save Timings:''' If this functionality is enabled, the time spent on each page of the survey by each participant is recorded.
 +
 
 +
*'''Enable Assessment Mode:''' You can enable/disable assessments for this survey with this setting.
 +
 
 +
*'''Participant May Save and Resume Later:''' This setting allows a participant to save his/her responses and resume the survey at a later time. Please note that this is most useful with open surveys or surveys in which the participants are anonymous. If you are using [[Survey participants|tokens]] and the survey [[Participant settings|is not anonymous]], in most cases it is better to activate '''token-based response persistence''' from the [[Participant settings]] panel.
 +
 
 +
*'''Send Basic Admin Notification Email To''' and '''Send Detailed Admin Notification Email To''': These two functions allow you to send notifications or survey responses to any email address once the survey is submitted. You can edit the templates for these emails from the [[Survey settings#Email templates|Email templates menu]]. You can choose the option to send emails to multiple recipients simultaneously by separating the email address entries with a semicolon (;) (e.g "yourname@test.com; myname@test.com; hisname@test.com" or (if using placeholders) "yourname@test.com;{INSERTANS:82733X12X73};{TOKEN:EMAIL}").
 +
 
 +
{{Box|To send an email to the survey administrator, '''you must use {ADMINEMAIL}'''.
 +
 
 +
There are different ways for entering an email address:
 +
#Enter a specific email address (ie: yourname@test.com).
 +
#Enter a SGQA code and the response will be sent to an email address entered as an answer to that particular question (use the format {INSERTANS:9999X88X12} in the same way you would reuse information from previous answers).
 +
#'''The following is only possible if your survey is not anonymous'''.  Enter a token code and the response will be sent to an email address retrieved from a token field.  Use the format {TOKEN:EMAIL} or {TOKEN:ATTRIBUTE_1} in the same way you would re-use Information from the '''Survey participants''' table.}}
 +
 
 +
*'''Google Analytics Settings:''' If you would like to get details about the survey web traffic, use Google Analytics. Three options are available:
 +
**''None'' : Google Analytics will not be used.
 +
**''Use Settings Below'' : If this option is chosen, the survey owner can type in his or her Google Analytics Tracking ID to be stored only with the respective survey. You also have the ability to choose one of the three Google Analytics styles.
 +
***Do Not Use Google Analytics - so {GOOGLE_ANALYTICS_JAVASCRIPT} is an empty string.
 +
***Default Google Analytics - {GOOGLE_ANALYTICS_JAVASCRIPT} uses the standard Google Analytics code, inserting the proper Google Analytics Key.
 +
***SurveyName-[SID]/GroupName - {GOOGLE_ANALYTICS_JAVASCRIPT} contains customized Google Analytics code to log the URL as {SURVEYNAME}-[{SID}]/{GROUPNAME}. This can be helpful if you want to analyze navigation paths through your survey, time spent per page, and drop-off rates per page.
 +
**''Use Global Settings'' : If this option is chosen, the survey will use the same Google Analytics Tracking ID as the one saved in the [[Global settings#General|global settings]] and then you choose the desired Google Analytics style.
 +
 
 +
{{Box|Google Analytics Tracking ID for a specific survey allows for integration with Google Analytics. The tracking ID can be inserted into templates using {GOOGLE_ANALYTICS_API_KEY}. The full JavaScript that Google Analytics expects (including the key) can be included in templates via {GOOGLE_ANALYTICS_JAVASCRIPT}.}}
 +
{{Note|For further details on how to use Google's API with LimeSurvey, check our [[Google API howto|Google API howto page]].}}
 +
 
 +
===Invitations===
 +
 
 +
Les options suivantes sont disponibles :
 +
 
 +
 
 +
<center>[[File:Create a new survey - participant settings.png]]</center>
 +
 
 +
 
 +
*'''Définir la longueur du code à :''' Habituellement la valeur par défaut de 15 (valeur max; supportée : 35) digits n'a pas à être modifiée. Cependant vous pouvez, si vous le souhaitez, entrer un nombre (X) plus grand que 5. Si ce nombre renseigné est plus petit que 5, il sera alors redéfini à la valeur par défaut de 15. '''Lorsque vous générerez les codes d'invitation, ceux-ci auront tous une longueur de X digits''';
 +
 
 +
*'''Anonymized Responses:''' This functionality allows you to determine whether responses to your survey are matched with information from the '''Survey Participants''' table (utilized in the respective survey) or are kept "anonymous". The default is "No". If you choose "Yes", then your survey is set to anonymize responses - '''there will be no way to connect answers and participants'''. Even the survey administrator will not be able to link response data and participant/token data. However, you will always be able to specifically view each response entered by your participants in the survey. Thus individual and anonymous analyses can still be done.
 +
 
 +
{{Alert|title=Attention|text=If this feature is activated, the response submission date and the token completed date are always set to 1980-01-01 00:00, regardless of other settings. Invalidating the submission date ensures no match with the web server logs where the token key might show up when a survey is started. Invalidating the token completed date guarantees that you cannot align the order of submitted responses to the order of the token date/time.}}
 +
 
 +
*'''Enable Token-Based Response Persistence:''' If your survey uses tokens and your responses are not anonymized, you may want to enable this feature. If you enable this feature, your participants will be able to leave the survey and resume later at any time without using the '''Resume Later''' function - for example, when they get distracted or their browser crashes. Upon clicking the invitation link again, they will be returned to the point in the survey where they left off with previous entries saved.
 +
 
 +
*'''Allow Multiple Responses or Update Responses With One Token:''' If this option is activated, participants will be able to return to their survey by clicking the invitation link, even if they have already submitted the survey. If the survey is anonymous or "Enable Token-Based Response Persistence" is set to "No", this will add a new response. If the survey is not anonymous and "Enable Token-Based Response Persistence" is enabled, the user will update the existing responses.
 +
 
 +
*'''Allow Public Registration:''' If you use tokens to control access to your survey, the only people who can use the survey are those who have an entry and a unique token code allocated in the [[Survey participants|Survey participants table]]. If you would like to use tokens, but also allow public registration, set this to "Yes". The "Yes" setting will allow visitors to register his or her name and email address. The script will create a new entry in your '''Survey Participants''' table for this person, then send them an invitation email. The script will ensure that only one person per email address can complete your survey.
 +
 
 +
*'''Use HTML Format For Token Emails:''' When enabled, all emails sent by the token management interface (invite, reminder, confirmation) will be formatted as HTML. You will then be able to use rich formatting for these emails. The default value is "Yes".
 +
{{Alert|title=Attention|text=When you switch this feature on or off, you will have to double check that your email templates are still displayed as you want.}}
 +
 
 +
*'''Send Confirmation Emails:''' If enabled, the participant will receive a confirmation email that the survey was submitted.
 +
 
 +
==Import a survey==
 +
 
 +
You can import a survey from the ''Create, import, or copy survey'' screen.
 +
 
 +
 
 +
(1) From the '''Surveys''' dropdown options (on the top toolbar of your Limesurvey homepage) select '''Import a survey'''. 
 +
 +
(2) On the Import tab, click '''Browse''' and choose the file you wish to import.
 +
 
 +
(3) Click the '''Import survey''' button.
 +
 
 +
 
 +
<center>[[FIle:Import a survey.png]]</center>
 +
 
 +
 
 +
Choose from the following formats:
 +
*.[[Display/Export survey#Export_survey_structure_.28.lss.29|LSS files]] (XML-format created by LimeSurvey 1.90 or later);
 +
*.[[Display/Export survey#Export_survey_archive_.28.lsa.29|LSA files]] (Survey archive which may include also token, responses and timings - available since LimeSurvey 2.0);
 +
*.[[Display/Export survey#Export tab-separated-values format (.txt)|TXT files]] (Text-format created by Excel - available since LimeSurvey 2.0);
 +
*.CSV files (Created by early LimeSurvey versions from 1.50 to 1.90).
 +
 
 +
The import function "intelligently" re-numbers the survey, groups, questions, answers, and condition IDs so that they all match each other. No existing survey is going to be overwritten during the import process.
 +
 
 +
By default, the resource links and expression fields are also imported. Basically, the more advanced type of questions are going to be also imported along questions that include complex branching, assessments, validation, and tailoring.
 +
 
 +
{{Note|For further details on LimeSurvey expression manager, read [[ExpressionScript - Presentation|our wiki]].}}
 +
 
 +
Once the import process is completed, a survey structure import summary will be displayed, showing whether it was successful or not:
 +
 
 +
 
 +
<center>[[File:Survey structure import summary.png]]</center>
 +
 
 +
 
 +
<div class="simplebox">[[File:help.png]] If you wish to use another method, read our wiki on [[Alternatives to the LimeSurvey import function|import alternatives]] for more information.</div>
 +
 
 +
==Copy a survey==
 +
 
 +
(1) Access your LimeSurvey homepage and from the '''Surveys''' dropdown options (on the top toolbar) select '''Copy a survey'''. 
 +
 
 +
(2) From the Copy tab, choose the survey that want to copy from the '''Select survey to copy''' options.
 +
 
 +
(3) Complete the required fields and set preferred options.
 +
 
 +
(4) Once you are done selecting the preferred options, click the '''Copy survey button''' located on the bottom of the page. A survey copy summary will be displayed:
 +
 
 +
 
 +
<center>[[FIle:Copy a survey.png]]</center>
 +
 
 +
 
 +
'''Copy Survey Fields:'''
 +
 
 +
*'''New survey title:''' Type in the title you wish the copied survey to have.
 +
 
 +
*'''New survey id:''' You can type in a new survey ID or leave the field empty.  If the field is left empty, a survey ID will be automatically assigned.
 +
 
 +
*'''Convert resource links and expression fields:''' If you disable this option, the more [[ExpressionScript - Presentation|advanced question types that use the expression manager]] will not be copied.
 +
 
 +
*'''Exclude quotas''': The [[Survey quotas|quotas]] are going to be excluded if this option is disabled.
 +
 
 +
*'''Exclude survey permissions:''' If enabled, no survey permissions will be copied into the new survey.
 +
 
 +
*'''Exclude answers:''' Exclude the answer options.
 +
 
 +
*'''Reset conditions/relevance:''' You can choose to reset the conditions that were set in the original survey.
 +
 
 +
*'''Reset start/end date/time?:''' You can choose to reset the survey start/end date/time.
 +
 
 +
*'''Reset response start ID?:''' Each response has a corresponding ID. If enabled, the ID of the responses will be reset. However, bear in mind that it is better not to have an ID with two matching responses because it might influence the output of your survey.
 +
 
 +
Below is a screenshot of the Survey Copy Summary.
 +
 
 +
 
 +
<center>[[File:Survey copy summary.png]]</center>
 +
 
 +
 
 +
To access the copied survey, click '''Go to survey''' to be redirected to the settings of the newly added survey.
 +
 
 +
==List surveys==
 +
 
 +
There are now two ways to see a list of available surveys.
 +
 
 +
 
 +
(1) From the '''Surveys''' options (on the top toolbar of your LimeSurvey homepage) select '''List surveys'''.
 +
 
 +
[[File:List Surveys1.png]]
 +
 
 +
 
 +
(2) Or click the '''List surveys box''' on your LimeSurvey homepage.
 +
[[File:List Surveys2.png]]
 +
 
 +
 
 +
A list of surveys will be displayed.
 +
 
 +
 
 +
<center>[[File:List a survey.png]]</center>
 +
 
 +
 
 +
*'''Survey ID:''' When created, the survey receives a unique id that is used to make the connection between different LimeSurvey tables.
 +
 
 +
*'''Status:''' Status of available surveys:
 +
**''active'' - If this option is selected, all surveys except inactive surveys are displayed.
 +
**''active and running'' - [[File:Active survey symbol.png]].
 +
**''inactive'' - [[File:Inactive survey.png]].
 +
**''active but expired'' - [[File:Expired survey icon.png]].
 +
**''active but not yet started'' - [[File:active but not yet started icon.png]].
 +
 
 +
*'''Title:''' The title of the survey.
 +
*'''Group:''' The survey group to which the survey belongs to.
 +
*'''Created:''' The date when the survey was created.
 +
*'''Owner:''' The name of the user that owns the survey.
 +
*'''Anonymized responses:''' This shows whether the responses are anonymized when stored into the database or not.
 +
*'''Partial:''' The number of surveys that were partially completed.
 +
*'''Full:''' The number of surveys that were fully completed.
 +
*'''Total:''' The number of partially and fully completed surveys.
 +
*'''Closed group:''' This is either "Yes" (if a '''Survey participants''' table is used) or "No".
 +
 
 +
*'''Actions:''' The last column presents the actions that are available for each survey:
 +
** [[File:Settings - small symbol.png]] - ''General settings & text :'' You will be redirected to the '''General settings & text''' tab.
 +
** [[File:Add new quesiton small symbol.png]] - ''Add a new question :'' Used when you want to quickly add a question to the survey.
 +
** [[File:Statistics small symbol.png]] - ''Statistics :'' The survey statistics ("simple" mode) will be shown if this button is clicked.
 +
 
 +
 
 +
<center>[[File:Search survey list.png]]</center>
 +
 
 +
 
 +
If you want to look for a specific survey, use the search bar and filter the results via the survey status field ("active", "active and running", "inactive", "active but expired", and "active but not yet started").
 +
 
 +
==Delete a survey==
 +
 
 +
(1) From the list of '''Surveys''' dropdown options (on the top toolbar of your LimeSurvey homepage) select '''List surveys'''.
 +
 
 +
[[File:DeleteASurvey.png]]
 +
 
 +
(2) Select the survey(s) you wish to delete (by ticking the box to the left of the survey ID).
 +
 
 +
(3) Click on the '''Selected survey(s)...''' button located on the bottom-left side of the page.
 +
 
 +
(4) Select '''Delete'''.
 +
 
 +
<center>[[File:Delete survey.png]]</center>
 +
 
 +
 
 +
(5) When you click Delete, a confirmation window will appear asking you to confirm your action. Select '''Yes''' to confirm.
 +
 
 +
==Export a survey==
 +
 
 +
(1) From the '''Surveys''' dropdown options (on the top toolbar of your LimeSurvey homepage) select '''List Surveys'''.
 +
 
 +
(2) Select the survey(s) that you want to export by ticking the box to the left of the survey ID.
 +
 
 +
(3) Click the '''Selected survey(s)...'''  box at the bottom of the list of surveys.
 +
 
 +
 
 +
<center>[[File:Export_survey_simple.png]]</center>
 +
 
 +
 
 +
The following options are available:
 +
*[[Display/Export survey#Export survey archive (.lsa)|Survey archive (*.lsa)]];
 +
*[[Display/Export survey#Export survey structure (.lss)|Survey structure (*.lss)]];
 +
*Printable survey (*.html): This option allows you to export the survey in a printable format in order to be filled out "offline".
 +
 
 +
 
 +
(4) Select the export file type that you want to export the survey as.
 +
 
 +
 
 +
For more details, check [[Display/Export survey|how to export a survey structure]].
 +
 
 +
=Survey groups=
 +
 
 +
<div class="simplebox">The survey group functionality has been added with the launch of LimeSurvey 3. More survey group features will be added in future releases. If you wish to help, join us on [irc://irc.freenode.net/limesurvey IRC] and give us a hand with [https://github.com/LimeSurvey/LimeSurvey the code] or else [https://www.limesurvey.org/component/nbill?action=orders&task=order&cid=2 donate] to help the core LimeSurvey development group.
 +
 
 +
Currently survey groups can list a set of surveys and apply theme/template options.</div>
 +
 
 +
 
 +
(1) To access the survey group functionalities, click '''Surveys''' located on the main toolbar of the LimeSurvey home page.
 +
 
 +
 
 +
[[File:DisplaySurveys.png]]
 +
 
 +
 
 +
(2) Then click the '''Survey groups''' tab:
 +
 
 +
 
 +
<center>[[File:Survey groups list.png]]</center>
 +
 
 +
 
 +
A survey groups list will be displayed.
 +
 
 +
On this page you can:
 +
*[[Surveys - introduction#Create a survey group|Create a survey group]] - located above the survey groups table;
 +
*[[Surveys - introduction#Edit survey group|Edit a survey group]] - located on the last column (the green pencil icon);
 +
*[[Surveys - introduction#Delete a survey group|Delete a survey group]] - located on the last column (the red trash icon).
 +
 
 +
==Create a survey group==
 +
 
 +
To create a new survey group:
 +
 
 +
(1) Click '''Surveys''' located on the main toolbar of the LimeSurvey home page.
 +
 
 +
 
 +
[[File:CreateSurveyGroup0.png]]
 +
 
 +
(2) Click the '''Survey groups''' tab.
 +
 
 +
 
 +
[[File:CreateSurveyGroupTab.png]]
 +
 
 +
 
 +
(3) Click the '''Create a new survey group''' button located above the survey groups list.
 +
 
 +
 
 +
[[File:CreateSurveyGroup.png]]
 +
 
 +
 
 +
(4) Complete the following fields and '''Save''':
 +
 
 +
*'''Name:''' Type in the name of the survey group;
 +
*'''Title:''' Type in the title of the survey group;
 +
*'''Description:''' Type in a short description of the survey group;
 +
*'''Order:''' Helps you organize the order of the survey groups within a parent group;
 +
*'''Parent:''' Choose the survey group that will be the parent survey group. The parent group option is used to ease the edit of template-related options of a high number of survey groups via a few clicks.
 +
 
 +
 
 +
'''To add surveys to the group''':
 +
 
 +
(1) Go to the '''General settings''' tab of a survey.
 +
 
 +
(2) Click the arrow in the '''Group''' field to display a list of survey groups.
 +
 
 +
(3) Select the survey group and '''Save'''.
 +
 
 +
 
 +
[[File:AddSurveyToGroups.png]]
 +
 
 +
==Edit survey group==
 +
 
 +
The following options of a survey group can be edited:
 +
 
 +
*[[Surveys - introduction#Surveys in this group|Surveys in this group]];
 +
*[[Surveys - introduction#Settings for this survey group|Settings for this survey group]];
 +
*[[Surveys - introduction#Template options for this survey group|Template options for this survey group]]{{NewIn|3.0}}.
 +
 
 +
 
 +
(1) From the top toolbar of your LimeSurvey homepage, click '''Surveys'''.
 +
 
 +
[[File:EditSurveyGroupI.png]]
 +
 
 +
(2) Click the '''Survey group''' tab.
 +
 
 +
(3) Select the survey group that you want to edit, by clicking the '''edit''' icon under the Actions column.
 +
 
 +
 
 +
[[File:EditSurveyGroupII.png]]
 +
 
 +
 
 +
The survey group will be displayed in edit mode.
 +
 
 +
 
 +
===Surveys in this group===
 +
 
 +
If you click on the first tab, all the surveys from the respective group will be displayed.
 +
 
 +
 
 +
<center>[[File:List LimeSurvey groups.png]]</center>
 +
 
 +
 
 +
This works as a filtering function, filtering out all the surveys not listed in the chosen survey group. You can now select the desired survey and start editing it. To see which survey-editing functionalities are available, check the [[Surveys - introduction#List surveys|list surveys]] section.
 +
 
 +
 
 +
===Settings for this survey group===
 +
 
 +
 
 +
The following fields can be edited from the '''Settings for this Surveygroup''' tab:
 +
 
 +
 
 +
<center>[[File:Edit Survey Group.png]]</center>
 +
 
 +
 
 +
*'''Title:''' Type in the title of the survey group;
 +
*'''Description:''' Type in a short description of the survey group;
 +
*'''Order:''' Helps you organize the order of the survey groups within a parent group;
 +
*'''Parent:''' Choose the survey group that will be the parent survey group. The parent group option is used to ease the edit of template-related options to a higher number of survey groups via a few clicks.
 +
 
 +
===Template options for this survey group===
 +
 
 +
The template options functionalities are present in LimeSurvey 3.0+. It offers a set of various options that allows you to quickly and easily change the templates-related settings of the surveys that belong to the same survey group:
 +
 
 +
 
 +
<center>[[File:Template options for survey groups.png]]</center>
 +
 
 +
 
 +
The '''Inherit everything''' functionality lets you decide whether you want the survey group to inherit everything or not from the parent survey group theme.
 +
If you do not want this to happen, select "No". The following options will show up which will allow you to choose what should be inherited from the parent survey group theme:
 +
 
 +
 
 +
<center>[[File:Not inheriting everything survey group.png]]</center>
 +
 
 +
 
 +
Below, you will see that you can choose a bootswatch theme for your survey group. Bootswatch themes can be used to quickly edit your templates. Basically, bootswatch is a collection of themed swatches which can be [https://bootswatch.com/ freely downloaded] and dropped into your Bootstrap site. Some of these themes are already included into your LimeSurvey installation and they can be selected from the '''Bootswatch theme''' drop-down list.
 +
{{Box|Bootstrap is a free and open-source front-end web framework for designing websites and web applications. For more details, check [https://en.wikipedia.org/wiki/Bootstrap_(front-end_framework) the following wiki].}}
 +
{{Box|Bootswatch enables users to easily try new looks without investing too much time or energy. For more information on bootswatch themes, check [https://bootswatch.com/ the following link].}}
 +
 
 +
If you want to tweak more a survey group template options, click on the '''advanced option''' tab (recommended for advanced users):
 +
 
 +
 
 +
<center>[[File:Advanced options survey group templates.png]]</center>
 +
 
 +
==Delete a survey group==
 +
 
 +
(1) Display a list of your surveys.  (From the '''Surveys''' tab on the top toolbar of your LimeSurvey homepage, click '''List surveys''' or click the '''List surveys box''').
 +
 
 +
(2) Click the '''Survey group''' tab.
 +
 
 +
(3) Select the survey group you want to delete and click the '''Delete''' icon located in the Actions column.
 +
 
 +
 
 +
[[File:DeleteSurveyGroup.png]]
 +
 
 +
 
 +
(4) Confirm the deletion by clicking '''Yes'''.
 +
 
 +
[[File:ConfirmSurveyGroupDeletion.png]]

Latest revision as of 17:15, 5 June 2021

Other languages:
Deutsch • ‎English • ‎Nederlands • ‎español • ‎français • ‎italiano • ‎português do Brasil • ‎slovenščina • ‎русский • ‎中文(中国大陆)‎ • ‎日本語


Important.png
  Attention : Veuillez noter que ce tutoriel comporte des explications et des copies d'écran concernant LimeSurvey 3.xx. De légères différences existent entre LimeSurvey 3.xx et LimeSurvey 2.xx, plus spécifiquement pour ce qui a trait à l'interface graphique utilisateur (GUI). Nous recommandons l'usage de la dernière version de LimeSurvey.

Général

Plusieurs paramètres interconnectés dans la base constituent un questionnaire : ceux des langages, des groupes de questions, des questions, des attributs des questions, des réponses, des sous-questions, des réponses par défaut, des évaluations, des quotas, des membres des quotas et des langages de quota. Pour faciliter la gestion des questionnaires, une nouvelle fonctionnalité a été introduite (New in 3.0 ), il s'agit des groupes de questionnaires.

Les questionnaires

Il y a deux manières d'atteindre la page créer un nouveau questionnaire:

1. La première façon est de cliquer sur la flèche à côté du bouton Questionnaires situé dans la barre d'outil principale de l'accueil de LimeSurvey. Une liste déroulante apparaît qui vous proposera l'option Créer un nouveau questionnaire :


Createnewsurvey.png

2. La seconde est de cliquer directement sur ce bouton Questionnaires :


Surveys-alternative button.png


Une liste des questionnaires s'affiche. Pour créer un nouveau questionnaire, cliquez sur le bouton Créer un nouveau questionnaire situé en haut à gauche de la fenêtre, au-dessus de la liste de questionnaires.


Create a new survey alternative.png

Créer un nouveau questionnaire

Après le clic sur Créer un nouveau questionnaire, la page suivante s'affiche :


(1) Enter the Survey title.


Note: The Survey title field is required. The remaining fields are optional. For a detailed explanation of each field, please refer to the Text Elements section below.


(2) Click Save (In the top-right just below your Username).


Newsurveyscreen.png


Pour ajuster les options disponibles pour votre questionnaire, vous pouvez parcourir les différents onglets présents sous la barre d'outils Créer un nouveau questionnaire :


You can also re-edit most of these settings by accessing the settings menu of the newly created survey and editing the desired options.
Important.png
  Attention : The HTML WYSIWYG editor does not allow you to upload files during the survey creation process. Doing so will cause an error message: E.g., "This file uploader is disabled". If you need to upload pictures or other resources, please do so after the survey creation by accessing the resources panel from the survey settings menu.

Les éléments textuels

Les options suivantes sont disponibles sur cet onglet :

  • Titre du questionnaire Le titre du questionnaire peut être modifié depuis ce champ;
  • Créer un exemple de question et groupe de question ?: (New in 3.0 ) Si c'est activé, une question et un groupe de question par défaut seront ajoutés à votre questionnaire lorsque vous créez celui-ci;
Important.png
  Attention : Il est à noter qu'une question doit d'abord être ajoutée à un groupe de question pour apparaître dans le questionnaire! Sinon la question ne sera pas montrée au participant du questionnaire.
  • Base Language: This represents the main language of the survey. If you wish to add other survey languages, first create a survey, then access the general settings of the newly created survey and add additional languages.
  • Description: You can type in a survey description. If enabled from the global settings, you can use the HTML editor to better customize the description field.
  • End URL: You have the possibility to redirect users to another page when they finish filling out the questionnaire. If you wish to redirect them, type in the URL and activate the automatically load URL option that is located under the Presentation & navigation tab.
  • URL Description: A short end URL description can be added in instances where the user is redirected to a non-related survey webpage. It may help if the survey administrator adds notes relating to the usage of the respective URL.
  • Date Format: This option is important when you want to record timestamps together with the survey participants' answers. If you click on it, a drop-down list will show up with a several date formats. Choose the date format used in the geographical location of your respondents. Do not forget that different date formats are used across the world. For example, it is recommended that you use a different time format if your questionnaire focuses on the US market (mm-dd-yyyy) and not on the British market (dd-mm-yy).
  • Decimal Mark: Two options are available: dot (.) and comma (,). Choose the one that fits the place (the geographical location) where you conduct your study (e.g. US vs Germany).
  • Welcome Message: Type in a message that will welcome the survey participants when they access your survey link.
  • End Message: Type in a message that will be displayed to the survey participants once they finish the questionnaire. If the end URL field is automatically loaded, the end message is no longer displayed.

Paramètres généraux

Les options suivantes sont disponibles sur cet onglet :


Create a new survey - General settings.png
  • Survey Owner: Type in the real name of the survey owner.
  • Administrator: The name of the administrator.
  • Admin Email: Type in the email address of the survey administrator.
Help.pngAdministrator and admin email are managed in the LimeSurvey email templates system.
Help.pngMany hosting providers' SMTP servers will only accept emails whose "From" address is on a local domain. All emails that do not conform to this rule are discarded silently, without any visible error message. If this happens, ensure that you are using a provider-based email address in the "Admin Email" field. You could also set up email forwarding on the provider's side, so that any messages sent there are forwarded to your preferred address.
  • Bounce email: This is the email address where the delivery error notification emails (bounced emails) will be sent to.
Help.png A bounce email is an electronic email which is returned to the sender for various reasons (e.g. invalid address, temporary unavailable mail server, the recipient's mailbox is full, etc).
  • Fax To: This field is used to print a fax number on the "printable survey" - i.e.: when you want to send someone a hard copy because he or she cannot use the online survey.
  • Group (New in 3.0 ): Select the survey group that the newly created survey should be added to.
  • Format: This function allows you to choose the way in which the questions will be displayed to the survey respondents. Three options are available:
    • Question by Question : The questions will be displayed one by one (one question per page). If this option is chosen, a separate "welcome" page and "end" page will be displayed when taking the survey.
    • Group by Group : Each survey page will display a question group. Also, a separate "welcome" page and "end" page will be displayed when taking the survey, as with the "Question by Question" surveys.
    • All In One : If chosen, all the pages will be displayed on a single page. If you select this option, no separate pages will be displayed for the "welcome" and "end" pages - they will all appear on the same page, together with the questions.
  • Template: The default template is rather simple, but functional. More information on creating your own templates is available here.

Presentation & navigation

The following options can be found under the Presentation & Navigation tab:


Create a new survey - Presentation & navigation.png


  • Navigation Delay (Seconds): This feature displays the number of seconds before the previous, next, and submit buttons are enabled. If none is specified, the option will use the default value, which is "0" (seconds).
  • Show Question Index / Allow Jumping: A question index can be displayed in the survey if this function is enabled, allowing the user to jump from one question group to another. You can choose the following:
    • Disabled : If this option is selected, no index is shown in the survey.
    • Incremental : If this option is selected, the question groups will be shown incrementally in an index menu located on the survey page. You are allowed to "jump back" only to the question groups that were previously visited/accessed.
    • Full : Jumping from question group to question group is allowed via the index menu.
  • Show "There Are X Questions In This Survey": This shows the total number of questions in your survey.
  • Show Group Name and/or Group Description: This function allows you to choose whether your survey will show participants the question group name only, the group description only or both. You may also choose to hide both.
  • Show Question Number and/or Code: This function allows you to choose whether your survey will show participants the question number only, the question code only or both. You may also choose to hide both. Please note, the question number is shown the moment someone starts the survey, while the question code is shown next to each survey question.
  • Show "No Answer": When a "radio button" or "select type" question that contains editable answers (e.g.: List & Array questions) has the Show "No Answer" option enabled and it is also not mandatory, an additional entry "No Answer" is displayed for each question/sub-question. In this way, the respondents may choose not to answer the respective question/sub-question. The following two options are available for survey administrators:
    • On : If this option is selected, the respondents can choose the "No Answer" option for a non-mandatory question.
    • Off : If selected, the "No Answer" option will not be displayed as a possible answer for any non-mandatory question.
Options set in the global settings override all other survey settings. Therefore, if the super-administrator chooses to have the "No Answer" option displayed, then the Show "No Answer" of the local survey field becomes non-selectable. The same applies to the "Off" option. To offer freedom to survey administrators, the super-administrator has to choose "Selectable" for the Show "No Answer" option from the global settings of your LimeSurvey installation.


  • Show Welcome Screen: If turned off, the welcome text message will not be displayed at the beginning of the questionnaire.
  • Allow Backward Navigation: If enabled, this will allow the users to navigate backwards and change his or her previous answers.
  • Show On-Screen Keyboard: If turned on, an on-screen keyboard will will be displayed when answering questions that require typing in information.
  • Show Progress Bar: When enabled, this function displays a progress bar that shows participants how much of the survey they have completed and how much is left to be completed.
  • Participants May Print Answers: If turned on, the survey participants may choose at the end of the survey to print their answers.
  • Public Statistics: A link to a set of statistics will be shown at the end of the survey if this option is enabled.
  • Show Graphs In Public Statistics: If enabled, graphs will also be shown in the Public Statistics at the end of the survey. Please note that the "Public Statistics" option has to be enabled to allow the survey participants to see the graphs.
  • Automatically Load URL When Survey Complete: The end URL becomes a redirect link once the survey is completed if this option is turned on.

Publication & access control

The following options can be found under the Publication & Access Control tab:


Publication & access control.png


  • Start Date/Time: This is the date/time the survey starts.
  • Expiry Date/Time: This function allows you to choose a date for your survey to expire. This is the last date on which the public survey script will let people participate. (Example: If you set the expiry date for the 31st of December, then people will no longer be able to fill out the survey on the 1st of January). To remove an expiry date, just clear the date from the input field.
  • List Survey Publicly: The default value is "No". When it is set to "Yes", your survey will be listed in the "Available Surveys" portal where it can be seen by all LimeSurvey users.
  • Set Cookie to Prevent Repeated Participation: If this is turned on, a survey participant will be blocked from completing a survey a second time.
  • Use CAPTCHA for Survey Access: In order to access the survey, a CAPTCHA code has be typed in by the survey participant.
  • Use CAPTCHA for Registration: In order to register for the survey, a CAPTCHA code has be typed in by the survey participant.
  • Use CAPTCHA for Save and Load: Enable this function if you want a survey participant to type in a CAPTCHA code when he or she loads the survey again after only a part of it was completed (to prevents automated responses).

Notification & data management

The following options can be found under the Notification & Data Management tab:


Create a new survey - Notification & data management.png


  • Date Stamp: Enable this functionality if you would like to see the time when the answers were submitted.
  • Save IP Address: If "yes" is selected, the IP address of the survey respondent will be stored together with his or her answers.
  • Save Referrer URL: If "yes" is selected, the referrer URL will be stored together with the answers.
  • Save Timings: If this functionality is enabled, the time spent on each page of the survey by each participant is recorded.
  • Enable Assessment Mode: You can enable/disable assessments for this survey with this setting.
  • Participant May Save and Resume Later: This setting allows a participant to save his/her responses and resume the survey at a later time. Please note that this is most useful with open surveys or surveys in which the participants are anonymous. If you are using tokens and the survey is not anonymous, in most cases it is better to activate token-based response persistence from the Participant settings panel.
  • Send Basic Admin Notification Email To and Send Detailed Admin Notification Email To: These two functions allow you to send notifications or survey responses to any email address once the survey is submitted. You can edit the templates for these emails from the Email templates menu. You can choose the option to send emails to multiple recipients simultaneously by separating the email address entries with a semicolon (;) (e.g "yourname@test.com; myname@test.com; hisname@test.com" or (if using placeholders) "yourname@test.com;{INSERTANS:82733X12X73};{TOKEN:EMAIL}").
To send an email to the survey administrator, you must use {ADMINEMAIL}.

There are different ways for entering an email address:

  1. Enter a specific email address (ie: yourname@test.com).
  2. Enter a SGQA code and the response will be sent to an email address entered as an answer to that particular question (use the format {INSERTANS:9999X88X12} in the same way you would reuse information from previous answers).
  3. The following is only possible if your survey is not anonymous. Enter a token code and the response will be sent to an email address retrieved from a token field. Use the format {TOKEN:EMAIL} or {TOKEN:ATTRIBUTE_1} in the same way you would re-use Information from the Survey participants table.


  • Google Analytics Settings: If you would like to get details about the survey web traffic, use Google Analytics. Three options are available:
    • None : Google Analytics will not be used.
    • Use Settings Below : If this option is chosen, the survey owner can type in his or her Google Analytics Tracking ID to be stored only with the respective survey. You also have the ability to choose one of the three Google Analytics styles.
      • Do Not Use Google Analytics - so {GOOGLE_ANALYTICS_JAVASCRIPT} is an empty string.
      • Default Google Analytics - {GOOGLE_ANALYTICS_JAVASCRIPT} uses the standard Google Analytics code, inserting the proper Google Analytics Key.
      • SurveyName-[SID]/GroupName - {GOOGLE_ANALYTICS_JAVASCRIPT} contains customized Google Analytics code to log the URL as {SURVEYNAME}-[{SID}]/{GROUPNAME}. This can be helpful if you want to analyze navigation paths through your survey, time spent per page, and drop-off rates per page.
    • Use Global Settings : If this option is chosen, the survey will use the same Google Analytics Tracking ID as the one saved in the global settings and then you choose the desired Google Analytics style.
Google Analytics Tracking ID for a specific survey allows for integration with Google Analytics. The tracking ID can be inserted into templates using {GOOGLE_ANALYTICS_API_KEY}. The full JavaScript that Google Analytics expects (including the key) can be included in templates via {GOOGLE_ANALYTICS_JAVASCRIPT}.
Help.pngFor further details on how to use Google's API with LimeSurvey, check our Google API howto page.

Invitations

Les options suivantes sont disponibles :


Create a new survey - participant settings.png


  • Définir la longueur du code à : Habituellement la valeur par défaut de 15 (valeur max; supportée : 35) digits n'a pas à être modifiée. Cependant vous pouvez, si vous le souhaitez, entrer un nombre (X) plus grand que 5. Si ce nombre renseigné est plus petit que 5, il sera alors redéfini à la valeur par défaut de 15. Lorsque vous générerez les codes d'invitation, ceux-ci auront tous une longueur de X digits;
  • Anonymized Responses: This functionality allows you to determine whether responses to your survey are matched with information from the Survey Participants table (utilized in the respective survey) or are kept "anonymous". The default is "No". If you choose "Yes", then your survey is set to anonymize responses - there will be no way to connect answers and participants. Even the survey administrator will not be able to link response data and participant/token data. However, you will always be able to specifically view each response entered by your participants in the survey. Thus individual and anonymous analyses can still be done.
Important.png
  Attention : If this feature is activated, the response submission date and the token completed date are always set to 1980-01-01 00:00, regardless of other settings. Invalidating the submission date ensures no match with the web server logs where the token key might show up when a survey is started. Invalidating the token completed date guarantees that you cannot align the order of submitted responses to the order of the token date/time.
  • Enable Token-Based Response Persistence: If your survey uses tokens and your responses are not anonymized, you may want to enable this feature. If you enable this feature, your participants will be able to leave the survey and resume later at any time without using the Resume Later function - for example, when they get distracted or their browser crashes. Upon clicking the invitation link again, they will be returned to the point in the survey where they left off with previous entries saved.
  • Allow Multiple Responses or Update Responses With One Token: If this option is activated, participants will be able to return to their survey by clicking the invitation link, even if they have already submitted the survey. If the survey is anonymous or "Enable Token-Based Response Persistence" is set to "No", this will add a new response. If the survey is not anonymous and "Enable Token-Based Response Persistence" is enabled, the user will update the existing responses.
  • Allow Public Registration: If you use tokens to control access to your survey, the only people who can use the survey are those who have an entry and a unique token code allocated in the Survey participants table. If you would like to use tokens, but also allow public registration, set this to "Yes". The "Yes" setting will allow visitors to register his or her name and email address. The script will create a new entry in your Survey Participants table for this person, then send them an invitation email. The script will ensure that only one person per email address can complete your survey.
  • Use HTML Format For Token Emails: When enabled, all emails sent by the token management interface (invite, reminder, confirmation) will be formatted as HTML. You will then be able to use rich formatting for these emails. The default value is "Yes".
Important.png
  Attention : When you switch this feature on or off, you will have to double check that your email templates are still displayed as you want.
  • Send Confirmation Emails: If enabled, the participant will receive a confirmation email that the survey was submitted.

Import a survey

You can import a survey from the Create, import, or copy survey screen.


(1) From the Surveys dropdown options (on the top toolbar of your Limesurvey homepage) select Import a survey.

(2) On the Import tab, click Browse and choose the file you wish to import.

(3) Click the Import survey button.


Import a survey.png


Choose from the following formats:

  • .LSS files (XML-format created by LimeSurvey 1.90 or later);
  • .LSA files (Survey archive which may include also token, responses and timings - available since LimeSurvey 2.0);
  • .TXT files (Text-format created by Excel - available since LimeSurvey 2.0);
  • .CSV files (Created by early LimeSurvey versions from 1.50 to 1.90).

The import function "intelligently" re-numbers the survey, groups, questions, answers, and condition IDs so that they all match each other. No existing survey is going to be overwritten during the import process.

By default, the resource links and expression fields are also imported. Basically, the more advanced type of questions are going to be also imported along questions that include complex branching, assessments, validation, and tailoring.

Help.pngFor further details on LimeSurvey expression manager, read our wiki.

Once the import process is completed, a survey structure import summary will be displayed, showing whether it was successful or not:


Survey structure import summary.png


Help.png If you wish to use another method, read our wiki on import alternatives for more information.

Copy a survey

(1) Access your LimeSurvey homepage and from the Surveys dropdown options (on the top toolbar) select Copy a survey.

(2) From the Copy tab, choose the survey that want to copy from the Select survey to copy options.

(3) Complete the required fields and set preferred options.

(4) Once you are done selecting the preferred options, click the Copy survey button located on the bottom of the page. A survey copy summary will be displayed:


Copy a survey.png


Copy Survey Fields:

  • New survey title: Type in the title you wish the copied survey to have.
  • New survey id: You can type in a new survey ID or leave the field empty. If the field is left empty, a survey ID will be automatically assigned.
  • Exclude quotas: The quotas are going to be excluded if this option is disabled.
  • Exclude survey permissions: If enabled, no survey permissions will be copied into the new survey.
  • Exclude answers: Exclude the answer options.
  • Reset conditions/relevance: You can choose to reset the conditions that were set in the original survey.
  • Reset start/end date/time?: You can choose to reset the survey start/end date/time.
  • Reset response start ID?: Each response has a corresponding ID. If enabled, the ID of the responses will be reset. However, bear in mind that it is better not to have an ID with two matching responses because it might influence the output of your survey.

Below is a screenshot of the Survey Copy Summary.


Survey copy summary.png


To access the copied survey, click Go to survey to be redirected to the settings of the newly added survey.

List surveys

There are now two ways to see a list of available surveys.


(1) From the Surveys options (on the top toolbar of your LimeSurvey homepage) select List surveys.

List Surveys1.png


(2) Or click the List surveys box on your LimeSurvey homepage. List Surveys2.png


A list of surveys will be displayed.


List a survey.png


  • Survey ID: When created, the survey receives a unique id that is used to make the connection between different LimeSurvey tables.
  • Status: Status of available surveys:
    • active - If this option is selected, all surveys except inactive surveys are displayed.
    • active and running - Active survey symbol.png.
    • inactive - Inactive survey.png.
    • active but expired - Expired survey icon.png.
    • active but not yet started - Active but not yet started icon.png.
  • Title: The title of the survey.
  • Group: The survey group to which the survey belongs to.
  • Created: The date when the survey was created.
  • Owner: The name of the user that owns the survey.
  • Anonymized responses: This shows whether the responses are anonymized when stored into the database or not.
  • Partial: The number of surveys that were partially completed.
  • Full: The number of surveys that were fully completed.
  • Total: The number of partially and fully completed surveys.
  • Closed group: This is either "Yes" (if a Survey participants table is used) or "No".
  • Actions: The last column presents the actions that are available for each survey:
    • Settings - small symbol.png - General settings & text : You will be redirected to the General settings & text tab.
    • Add new quesiton small symbol.png - Add a new question : Used when you want to quickly add a question to the survey.
    • Statistics small symbol.png - Statistics : The survey statistics ("simple" mode) will be shown if this button is clicked.


Search survey list.png


If you want to look for a specific survey, use the search bar and filter the results via the survey status field ("active", "active and running", "inactive", "active but expired", and "active but not yet started").

Delete a survey

(1) From the list of Surveys dropdown options (on the top toolbar of your LimeSurvey homepage) select List surveys.

DeleteASurvey.png

(2) Select the survey(s) you wish to delete (by ticking the box to the left of the survey ID).

(3) Click on the Selected survey(s)... button located on the bottom-left side of the page.

(4) Select Delete.

Delete survey.png


(5) When you click Delete, a confirmation window will appear asking you to confirm your action. Select Yes to confirm.

Export a survey

(1) From the Surveys dropdown options (on the top toolbar of your LimeSurvey homepage) select List Surveys.

(2) Select the survey(s) that you want to export by ticking the box to the left of the survey ID.

(3) Click the Selected survey(s)... box at the bottom of the list of surveys.


Export survey simple.png


The following options are available:


(4) Select the export file type that you want to export the survey as.


For more details, check how to export a survey structure.

Survey groups

The survey group functionality has been added with the launch of LimeSurvey 3. More survey group features will be added in future releases. If you wish to help, join us on IRC and give us a hand with the code or else donate to help the core LimeSurvey development group. Currently survey groups can list a set of surveys and apply theme/template options.


(1) To access the survey group functionalities, click Surveys located on the main toolbar of the LimeSurvey home page.


DisplaySurveys.png


(2) Then click the Survey groups tab:


Survey groups list.png


A survey groups list will be displayed.

On this page you can:

Create a survey group

To create a new survey group:

(1) Click Surveys located on the main toolbar of the LimeSurvey home page.


CreateSurveyGroup0.png

(2) Click the Survey groups tab.


CreateSurveyGroupTab.png


(3) Click the Create a new survey group button located above the survey groups list.


CreateSurveyGroup.png


(4) Complete the following fields and Save:

  • Name: Type in the name of the survey group;
  • Title: Type in the title of the survey group;
  • Description: Type in a short description of the survey group;
  • Order: Helps you organize the order of the survey groups within a parent group;
  • Parent: Choose the survey group that will be the parent survey group. The parent group option is used to ease the edit of template-related options of a high number of survey groups via a few clicks.


To add surveys to the group:

(1) Go to the General settings tab of a survey.

(2) Click the arrow in the Group field to display a list of survey groups.

(3) Select the survey group and Save.


AddSurveyToGroups.png

Edit survey group

The following options of a survey group can be edited:


(1) From the top toolbar of your LimeSurvey homepage, click Surveys.

EditSurveyGroupI.png

(2) Click the Survey group tab.

(3) Select the survey group that you want to edit, by clicking the edit icon under the Actions column.


EditSurveyGroupII.png


The survey group will be displayed in edit mode.


Surveys in this group

If you click on the first tab, all the surveys from the respective group will be displayed.


List LimeSurvey groups.png


This works as a filtering function, filtering out all the surveys not listed in the chosen survey group. You can now select the desired survey and start editing it. To see which survey-editing functionalities are available, check the list surveys section.


Settings for this survey group

The following fields can be edited from the Settings for this Surveygroup tab:


Edit Survey Group.png


  • Title: Type in the title of the survey group;
  • Description: Type in a short description of the survey group;
  • Order: Helps you organize the order of the survey groups within a parent group;
  • Parent: Choose the survey group that will be the parent survey group. The parent group option is used to ease the edit of template-related options to a higher number of survey groups via a few clicks.

Template options for this survey group

The template options functionalities are present in LimeSurvey 3.0+. It offers a set of various options that allows you to quickly and easily change the templates-related settings of the surveys that belong to the same survey group:


Template options for survey groups.png


The Inherit everything functionality lets you decide whether you want the survey group to inherit everything or not from the parent survey group theme. If you do not want this to happen, select "No". The following options will show up which will allow you to choose what should be inherited from the parent survey group theme:


Not inheriting everything survey group.png


Below, you will see that you can choose a bootswatch theme for your survey group. Bootswatch themes can be used to quickly edit your templates. Basically, bootswatch is a collection of themed swatches which can be freely downloaded and dropped into your Bootstrap site. Some of these themes are already included into your LimeSurvey installation and they can be selected from the Bootswatch theme drop-down list.

Bootstrap is a free and open-source front-end web framework for designing websites and web applications. For more details, check the following wiki.
Bootswatch enables users to easily try new looks without investing too much time or energy. For more information on bootswatch themes, check the following link.


If you want to tweak more a survey group template options, click on the advanced option tab (recommended for advanced users):


Advanced options survey group templates.png

Delete a survey group

(1) Display a list of your surveys. (From the Surveys tab on the top toolbar of your LimeSurvey homepage, click List surveys or click the List surveys box).

(2) Click the Survey group tab.

(3) Select the survey group you want to delete and click the Delete icon located in the Actions column.


DeleteSurveyGroup.png


(4) Confirm the deletion by clicking Yes.

ConfirmSurveyGroupDeletion.png