Actions

URL fields/fr: Difference between revisions

From LimeSurvey Manual

(Created page with "Les paramètres des champs URL peuvent être utilisés dans le champ : * End URL de l'enquête (voir Éléments de texte|éléments de texte de...")
(Updating to match new version of source page)
 
(29 intermediate revisions by one other user not shown)
Line 16: Line 16:




'''At the end of a survey or when a quota causes a survey to terminate''', there is the option to set an ending URL. This URL is presented to the participant who has finished the survey on the end page or you can optionally set the participant to be automatically redirected to the respective URL. This can be done by filling in the End URL option from the [[Text elements|Survey text elements]] panel and by enabling the automatic load of the end URL from the [[Presentation]] panel once a survey is completed .
'''A la fin d'une enquête ou lorsqu'un quota entraîne la fin d'une enquête''', il existe la possibilité de définir une URL de fin. Cette URL est présentée au participant qui a terminé l'enquête sur la page de fin ou vous pouvez éventuellement configurer le participant pour qu'il soit automatiquement redirigé vers l'URL correspondante. Cela peut être fait en remplissant l'option URL de fin à partir du panneau [[Éléments de texte|Éléments de texte de l'enquête]] et en activant le chargement automatique de l'URL de fin à partir du panneau [[Présentation]] une fois l'enquête terminée.


But, LimeSurvey offers the possibility to use URL fields in many other ways which in turn allows you to enhance the functionality of your survey.
Mais LimeSurvey offre la possibilité d'utiliser les champs URL de nombreuses autres manières, ce qui vous permet d'améliorer les fonctionnalités de votre enquête.


If you go to “Survey participants” in the survey side menu and change the survey to be in “closed access mode“, after pre adding participants there with each having a token, the token parameter will be added in the end url.


==Basic fields==
==Champs de base==




You can use '''{SAVEDID}''', '''{TOKEN}''', '''{SID}''', and '''{LANG}''' in the end URL:
Vous pouvez utiliser '''{SAVEDID}''', '''{TOKEN}''', '''{SID}''' et '''{LANG}''' dans l'URL de fin : !N !*'''SAVEDID''' est l'identifiant attribué à cette soumission particulière;
*'''SAVEDID''' is the id assigned to this particular submission;
*'''TOKEN''' est le jeton utilisé pour participer à l'enquête;
*'''TOKEN''' is the token used to participate in the survey;
*'''SID''' est l'ID de l'enquête ;
*'''SID''' is the survey ID;
*'''LANG''' est le code de langue.
*'''LANG''' is the language code.


For example:
Par exemple:


<code>
<code>
Line 37: Line 37:




==Answer fields==
==Champs de réponse==




You can also use '''{INSERTANS:SGQA}''' or [[ExpressionScript - Presentation#Qcode_Variable_Naming|ExpressionScript variables]]. This URL field allows you to add the response to a specific question in the survey into the end URL. This can be useful for sending a response to an external script (i.e. an email address collected during the survey).
Vous pouvez également utiliser '''{INSERTANS:SGQA}''' ou des [[ExpressionScript - Présentation#Qcode_Variable_Naming|Variables ExpressionScript]]. Ce champ URL vous permet d'ajouter la réponse à une question spécifique de l'enquête dans l'URL de fin. Cela peut être utile pour envoyer une réponse à un script externe (c'est-à-dire une adresse e-mail collectée lors de l'enquête).


For example:
Par exemple:


<code><nowiki>
<code><nowiki>
Line 48: Line 48:
</nowiki></code>
</nowiki></code>


It is important to add "newtest/y" to the URL to force a new session whenever your survey participants wants to fill in your survey.
Il est important d'ajouter « newtest/y » à l'URL pour forcer une nouvelle session chaque fois que les participants à votre enquête souhaitent répondre à votre enquête.


<code><nowiki>
<code><nowiki>
Line 54: Line 54:
</nowiki></code>
</nowiki></code>


In the above scenario, the URL pertains to a survey with ID = 48315, group =2, question=22 and answercodes = 2007 and 2008.  
Dans le scénario ci-dessus, l'URL concerne une enquête avec l'ID = 48315, le groupe = 2, la question = 22 et les codes de réponse = 2007 et 2008.  


{{Note|For more details on the necessity of "newtest/y", check the following [https://www.limesurvey.org/forum/installation-a-update-issues/108334-use-case-for-not-using-newtest-y forum thread].}}
{{Remarque|Pour plus de détails sur la nécessité de "newtest/y", vérifiez ce qui suit [https://www.limesurvey.org/forum/installation-a-update-issues/108334-use-case-for-not -using-newtest-y fil de discussion].}}


==Expressions==
==Expressions==




You can also use any [[ExpressionScript - Presentation|expression]] here.
Vous pouvez également utiliser n'importe quelle [[ExpressionScript - Présentation|expression]] ici.


For example:
Par exemple:


<code><nowiki>
<code><nowiki>
Line 70: Line 70:




==Passthrough fields==
==Champs de passage==




To use passthrough fields, you '''must''' define the variable names via panel integration. If you don't assign a target question, the variables will not be saved into responses (read more about the LimeSurvey [[Panel integration|panel integration]] feature). To use such a parameter in the end URL, just insert the tag '''{PASSTHRU:<paramname>}''' where ''<paramname>'' is the name of your input parameter.
Pour utiliser les champs passthrough, vous ''' devez ''' définir les noms des variables via l'intégration du panneau. Si vous n'attribuez pas de question cible, les variables ne seront pas enregistrées dans les réponses (en savoir plus sur la fonctionnalité LimeSurvey [[Intégration du panneau|intégration du panneau]]). Pour utiliser un tel paramètre dans l'URL de fin, insérez simplement la balise '''{PASSTHRU :<paramname> }''' où ''<paramname> '' est le nom de votre paramètre d'entrée.


Let's suppose that you defined [[Panel integration|a parameter]] named "foobar". The survey is started with a link like this one:
Supposons que vous ayez défini un [[Intégration du panneau|un paramètre]] nommé "foobar". L'enquête commence par un lien comme celui-ci :


<code>
<code>
Line 81: Line 81:
</code>
</code>


The XYZ123 is the value you want "to pass".
Le XYZ123 est la valeur que vous souhaitez « transmettre ».


The end URL of a survey with the following URL <code><nowiki>https://www.limesurvey.org/test.php?foobarout={PASSTHRU:foobar}</nowiki></code> would then be converted to <code><nowiki>https://www.limesurvey.org/test.php?foobarout=XYZ123</nowiki></code>
L'URL de fin d'une enquête avec l'URL suivante<nowiki> <code>https://www.limesurvey.org/test.php?foobarout={PASSTHRU:foobar}</code></nowiki> serait alors converti en<nowiki> <code>https://www.limesurvey.org/test.php?foobarout=XYZ123</code></nowiki>


=Start URL=
=URL de démarrage=




==Prefilling a survey using GET parameters==
==Pré-remplir une enquête à l'aide des paramètres GET==




You can prefill all answers except the [[Question_type_-_File_upload|upload]] and [[Question type - Equation|equation question type]]. You can use [[ExpressionScript - Presentation#Access to Variables|qcode naming]] for parameters and set the value for single question types or use the [[SGQA identifier]].
Vous pouvez pré-remplir toutes les réponses à l'exception du [[Question_type_-_File_upload|upload]] et du [[Type de question - Équation|type de question équation]]. Vous pouvez utiliser [[ExpressionScript - Présentation#Access to Variables|qcode naming]] pour les paramètres et définir la valeur pour les types de questions uniques ou utiliser l'[[identifiant SGQA]].


Then, answers are set to the prefilled value. For single choice option, you must use the code of the answer, for multi choice question, you must use Y if you want to prefill the answer.
Ensuite, les réponses sont définies sur la valeur préremplie. Pour l'option à choix unique, vous devez utiliser le code de la réponse, pour les questions à choix multiples, vous devez utiliser Y si vous souhaitez pré-remplir la réponse.


Here are some start URL examples:
Voici quelques exemples d’URL de démarrage :


* <code><nowiki>http://ls.example.org/1234?QTEXT=prefilled</nowiki></code> : Fill in the question with code QTEXT with <nowiki>'prefilled'</nowiki>
*<nowiki> <code>http://ls.example.org/1234?QTEXT=prefilled</code></nowiki> : Remplissez la question avec le code QTEXT avec<nowiki> 'prérempli'</nowiki>  
* <code><nowiki>https://ls.example.org/1234?MULTI_SQ001=prefilled</nowiki></code> {{NewIn|v=3.14.1}} : Fill in the subquestion SQ001 of question with title MULTI with <nowiki>'prefilled'</nowiki> (for a multiple text question for example).
*<nowiki> <code>https://ls.example.org/1234?MULTI_SQ001=prefilled</code></nowiki> {{NewIn|v=3.14.1}} : Remplissez la sous-question SQ001 de la question de titre MULTI avec<nowiki> 'prérempli'</nowiki> (pour une question à plusieurs textes par exemple).
* <code><nowiki>https://ls.example.org/1234?single=-oth-&single_other=Other%20text</nowiki></code> {{NewIn|v=3.14.1}} : Select the "other" answer option of a single choice question and fill in the other value with the text "Other text".
*<nowiki> <code>https://ls.example.org/1234?single=-oth-&single_other=Other%20text</code></nowiki> {{NewIn|v=3.14.1}} : Sélectionnez l'option de réponse "autre" d'une question à choix unique et remplissez l'autre valeur avec le texte "Autre texte".
* <code><nowiki>https://ls.example.org/1234?1234X1X1SQ001=prefilled</nowiki></code> : Fill in the subquestion SQ001 of question with ID: 1 from group with ID: 1 with <nowiki>'prefilled'</nowiki>
*<nowiki> <code>https://ls.example.org/1234?1234X1X1SQ001=prefilled</code></nowiki> : Remplissez la sous-question SQ001 de la question avec ID : 1 du groupe avec ID : 1 avec<nowiki> 'prérempli'</nowiki>  
* <code><nowiki>https://ls.example.org/1234?1234X1X1SQ001=A1</nowiki></code> : Preselect the answer option <nowiki>'A1'</nowiki> of the subquestion SQ001 of question with ID: 1 from group that has ID: 1.
*<nowiki> <code>https://ls.example.org/1234?1234X1X1SQ001=A1</code></nowiki> : Présélectionnez l'option de réponse<nowiki> 'A1'</nowiki> de la sous-question SQ001 de la question avec l'ID : 1 du groupe qui a l'ID : 1.
* <code><nowiki>https://ls.example.org/1234?1234X1X1SQ001=Y</nowiki></code> : Preselect the subquestion SQ001 of the question that has the ID 1, from the group that has ID: 1.
*<nowiki> <code>https://ls.example.org/1234?1234X1X1SQ001=Y</code></nowiki> : Présélectionnez la sous-question SQ001 de la question qui a l'ID 1, du groupe qui a l'ID : 1.




{{Hint|Text=GET parameters use "?" for the first parameter and "&" for the subsequent ones. If you already have "?" in your URL, you must use "&" to add more GET parameters.}}
{{Astuce|Texte=Les paramètres GET utilisent "?" pour le premier paramètre et "&" pour les suivants. Si vous avez déjà "?" dans votre URL, vous devez utiliser "&" pour ajouter plus de paramètres GET.}}




{{Hint|Text=The extra GET parameters are only filled in when the survey starts anew. Therefore, for testing, always add newtest=Y to start a fresh survey. For example: <code><nowiki>http://ls.example.org/1234?QTEXT=prefilled&newtest=Y</nowiki></code>}}
{{Hint|Text=Les paramètres GET supplémentaires ne sont renseignés que lorsque l'enquête recommence. Par conséquent, pour les tests, ajoutez toujours newtest=Y pour démarrer une nouvelle enquête. Par exemple:<nowiki> <code>http://ls.example.org/1234?QTEXT=prefilled&newtest=Y</code></nowiki> }}


==Prefilling a survey using GET parameters using URL parameters tab==
==Pré-remplir une enquête à l'aide des paramètres GET à l'aide de l'onglet Paramètres d'URL==




You can prefill (sometimes easier) answers using URL parameters which can be configured in [[Panel integration|panel integration]].
Vous pouvez pré-remplir (parfois plus facilement) les réponses à l'aide des paramètres d'URL qui peuvent être configurés dans [[Intégration du panneau|intégration du panneau]].




==Prefilling and hiding the answer==
==Préremplir et masquer la réponse==




You can use the [[QS:Hidden|hidden attribute]] of a question to hide it from your respondents. If so, the question still remains prefilled.
Vous pouvez utiliser l'[[QS:Hidden|hiddenattribut]] d'une question pour la masquer à vos répondants. Si tel est le cas, la question reste toujours pré-remplie.

Latest revision as of 16:53, 2 April 2024

Other languages:


Présentation

Les paramètres des champs URL peuvent être utilisés dans le champ :


URL de fin

A la fin d'une enquête ou lorsqu'un quota entraîne la fin d'une enquête, il existe la possibilité de définir une URL de fin. Cette URL est présentée au participant qui a terminé l'enquête sur la page de fin ou vous pouvez éventuellement configurer le participant pour qu'il soit automatiquement redirigé vers l'URL correspondante. Cela peut être fait en remplissant l'option URL de fin à partir du panneau Éléments de texte de l'enquête et en activant le chargement automatique de l'URL de fin à partir du panneau Présentation une fois l'enquête terminée.

Mais LimeSurvey offre la possibilité d'utiliser les champs URL de nombreuses autres manières, ce qui vous permet d'améliorer les fonctionnalités de votre enquête.

If you go to “Survey participants” in the survey side menu and change the survey to be in “closed access mode“, after pre adding participants there with each having a token, the token parameter will be added in the end url.

Champs de base

Vous pouvez utiliser {SAVEDID}, {TOKEN}, {SID} et {LANG} dans l'URL de fin : !N !*SAVEDID est l'identifiant attribué à cette soumission particulière;

  • TOKEN est le jeton utilisé pour participer à l'enquête;
  • SID est l'ID de l'enquête ;
  • LANG est le code de langue.

Par exemple:

https://www.limesurvey.org/test.php?var1={SAVEDID}&var2={TOKEN}&var3={SID}&lang={LANG}


Champs de réponse

Vous pouvez également utiliser {INSERTANS:SGQA} ou des Variables ExpressionScript. Ce champ URL vous permet d'ajouter la réponse à une question spécifique de l'enquête dans l'URL de fin. Cela peut être utile pour envoyer une réponse à un script externe (c'est-à-dire une adresse e-mail collectée lors de l'enquête).

Par exemple:

https://www.limesurvey.org/test.php?email={EMAILADDRESS}

Il est important d'ajouter « newtest/y » à l'URL pour forcer une nouvelle session chaque fois que les participants à votre enquête souhaitent répondre à votre enquête.

https://exampletest.limequery.com/index.php/survey/index/sid/48315/newtest/Y?48315X2X222007=Y&48315X2X222008=Y

Dans le scénario ci-dessus, l'URL concerne une enquête avec l'ID = 48315, le groupe = 2, la question = 22 et les codes de réponse = 2007 et 2008.

Template:Remarque

Expressions

Vous pouvez également utiliser n'importe quelle expression ici.

Par exemple:

http://www.limesurvey.org/test.php?gender={if(sex=='Male','M','F')}&name;={name}


Champs de passage

Pour utiliser les champs passthrough, vous devez définir les noms des variables via l'intégration du panneau. Si vous n'attribuez pas de question cible, les variables ne seront pas enregistrées dans les réponses (en savoir plus sur la fonctionnalité LimeSurvey intégration du panneau). Pour utiliser un tel paramètre dans l'URL de fin, insérez simplement la balise {PASSTHRU :<paramname> } où <paramname> est le nom de votre paramètre d'entrée.

Supposons que vous ayez défini un un paramètre nommé "foobar". L'enquête commence par un lien comme celui-ci :

https://example.org/limesurvey/index.php/survey/index/sid/12345/lang/eb?foobar=XYZ123

Le XYZ123 est la valeur que vous souhaitez « transmettre ».

L'URL de fin d'une enquête avec l'URL suivante <code>https://www.limesurvey.org/test.php?foobarout={PASSTHRU:foobar}</code> serait alors converti en <code>https://www.limesurvey.org/test.php?foobarout=XYZ123</code>

URL de démarrage

Pré-remplir une enquête à l'aide des paramètres GET

Vous pouvez pré-remplir toutes les réponses à l'exception du upload et du type de question équation. Vous pouvez utiliser qcode naming pour les paramètres et définir la valeur pour les types de questions uniques ou utiliser l'identifiant SGQA.

Ensuite, les réponses sont définies sur la valeur préremplie. Pour l'option à choix unique, vous devez utiliser le code de la réponse, pour les questions à choix multiples, vous devez utiliser Y si vous souhaitez pré-remplir la réponse.

Voici quelques exemples d’URL de démarrage :

  • <code>http://ls.example.org/1234?QTEXT=prefilled</code> : Remplissez la question avec le code QTEXT avec 'prérempli'
  • <code>https://ls.example.org/1234?MULTI_SQ001=prefilled</code> (New in 3.14.1 ) : Remplissez la sous-question SQ001 de la question de titre MULTI avec 'prérempli' (pour une question à plusieurs textes par exemple).
  • <code>https://ls.example.org/1234?single=-oth-&single_other=Other%20text</code> (New in 3.14.1 ) : Sélectionnez l'option de réponse "autre" d'une question à choix unique et remplissez l'autre valeur avec le texte "Autre texte".
  • <code>https://ls.example.org/1234?1234X1X1SQ001=prefilled</code> : Remplissez la sous-question SQ001 de la question avec ID : 1 du groupe avec ID : 1 avec 'prérempli'
  • <code>https://ls.example.org/1234?1234X1X1SQ001=A1</code> : Présélectionnez l'option de réponse 'A1' de la sous-question SQ001 de la question avec l'ID : 1 du groupe qui a l'ID : 1.
  • <code>https://ls.example.org/1234?1234X1X1SQ001=Y</code> : Présélectionnez la sous-question SQ001 de la question qui a l'ID 1, du groupe qui a l'ID : 1.


Template:Astuce


 Hint: Les paramètres GET supplémentaires ne sont renseignés que lorsque l'enquête recommence. Par conséquent, pour les tests, ajoutez toujours newtest=Y pour démarrer une nouvelle enquête. Par exemple: <code>http://ls.example.org/1234?QTEXT=prefilled&newtest=Y</code>


Pré-remplir une enquête à l'aide des paramètres GET à l'aide de l'onglet Paramètres d'URL

Vous pouvez pré-remplir (parfois plus facilement) les réponses à l'aide des paramètres d'URL qui peuvent être configurés dans intégration du panneau.


Préremplir et masquer la réponse

Vous pouvez utiliser l'hiddenattribut d'une question pour la masquer à vos répondants. Si tel est le cas, la question reste toujours pré-remplie.

Retrieved from "http://manual.limesurvey.org/index.php?title=URL_fields/fr&oldid=376472"