Actions

URL fields/fr: Difference between revisions

From LimeSurvey Manual

(Updating to match new version of source page)
(Updating to match new version of source page)
 
(35 intermediate revisions by 3 users not shown)
Line 4: Line 4:




=Introduction=
=Présentation=




URL fields parameters can be used in the:
Les paramètres des champs URL peuvent être utilisés dans le champ :
* [[URL_fields#End_URL_field|End URL]] field of the survey (see [[Text elements|survey text elements]])  
* [[URL_fields#End_URL_field|End URL]] de l'enquête (voir [[Éléments de texte|éléments de texte de l'enquête]])  
* URL field of the quota rule (read more about survey quotas [[Survey quotas|here]])
* Champ URL de la règle de quota (en savoir plus sur les quotas d'enquête [[Quotas d'enquête|ici]])
* [[URL_fields#Start_URL|Start URL]] field of the survey (see [[Text elements|survey text elements]]).
* [[URL_fields#Start_URL|Start URL]] champ de l'enquête (voir [[Éléments de texte|éléments de texte d'enquête]]).




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 [[Expression_Manager#Qcode_Variable_Naming|Expression Manager 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 [[Expression Manager - 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 passhtrough fields, you have to define any additional parameters that should be passed into the end URL in the survey settings (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>


=URL de démarrage=


=Start URL=


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


==Prefilling a survey using GET parameters==


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]].


You can prefill all answers except the [[Question_type_-_File_upload|upload]] and [[Question type - Equation|equation question type]]. You can use [[Expression Manager - presentation#Access to Variables|qcode naming]] for parameters and set the value for single question types. For the multiple question type, you must use a [[SGQA identifier]].
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.


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.
Voici quelques exemples d’URL de démarrage :


Here are some start URL examples:
*<nowiki> <code>http://ls.example.org/1234?QTEXT=prefilled</code></nowiki> : Remplissez la question avec le code QTEXT avec<nowiki> 'prérempli'</nowiki>
*<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).
*<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".
*<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>
*<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.
*<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.


* <code><nowiki>http://ls.example.org/1234?QTEXT=prefilled</nowiki></code> : Fill in the question with code QTEXT with <nowiki>'prefilled'</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).
* <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".
* <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>
* <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.
* <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.


{{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=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.}}


{{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> }}


{{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>}}
==Pré-remplir une enquête à l'aide des paramètres GET à l'aide de l'onglet Paramètres d'URL==




==Prefilling a survey using GET parameters using URL parameters tab==
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]].




You can prefill (sometimes easier) answers using URL parameters which can be configured in [[Panel integration|panel integration]].
==Préremplir et masquer la réponse==




==Prefilling and hiding the answer==
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.
 
 
You can use the [[QS:Hidden|hidden attribute]] of a question to hide it from your respondents. If so, the question still remains prefilled.

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"