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)
 
(40 intermediate revisions by 3 users not shown)
Line 4: Line 4:




=Introduction=
=Présentation=


URL fields parameters can be used in the:
 
* End URL field of the survey (see the [[Survey texts|survey texts wiki section]]);
Les paramètres des champs URL peuvent être utilisés dans le champ :
* URL field of the quota rule (read more about [[Survey quotas|survey quotas here]])
* [[URL_fields#End_URL_field|End URL]] de l'enquête (voir [[Éléments de texte|éléments de texte de l'enquête]])  
* Start URL field of the survey.
* 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]] champ de l'enquête (voir [[Éléments de texte|éléments de texte d'enquête]]).




=URL de fin=
=URL de fin=


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 [[Survey texts]] panel and by enabling the automatic load of the end URL from the [[Presentation]] panel once a survey is completed .


However, there are a number of fields available to be used to enhance the functionality of this URL.
'''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.
 
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==


==Basic fields==


You can use '''{SAVEDID}''', '''{TOKEN}''', '''{SID}''' and '''{LANG}''' in this 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>
<nowiki>http://www.limesurvey.org/test.php?var1={SAVEDID}&var2={TOKEN}&var3={SID}&lang={LANG}</nowiki>
<nowiki>https://www.limesurvey.org/test.php?var1={SAVEDID}&var2={TOKEN}&var3={SID}&lang={LANG}</nowiki>
</code>
</code>


==Answer fields==


You can also use '''{INSERTANS:SGQA}'''. 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 (ie an email address collected during the survey).
==Champs de réponse==
 
 
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).
 
Par exemple:
 
<code><nowiki>
https://www.limesurvey.org/test.php?email={EMAILADDRESS}
</nowiki></code>


For example:
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>
http://www.limesurvey.org/test.php?email={INSERTANS:1234X56X7}
https://exampletest.limequery.com/index.php/survey/index/sid/48315/newtest/Y?48315X2X222007=Y&48315X2X222008=Y
</nowiki></code>
</nowiki></code>


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.
{{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|Expression Manager]] expression here.


For example:
Vous pouvez également utiliser n'importe quelle [[ExpressionScript - Présentation|expression]] ici.
 
Par exemple:


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


==Passthrough fields==


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.
==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|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
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>
<nowiki>http://example.org/limesurvey/index.php/survey/index/sid/12345/lang/eb?foobar=XYZ123</nowiki>
<nowiki>https://example.org/limesurvey/index.php/survey/index/sid/12345/lang/eb?foobar=XYZ123</nowiki>
</code>
</code>


The XYZ123 is the value you want "to pass".
Le XYZ123 est la valeur que vous souhaitez « transmettre ».
 
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=
 


The end URL of a survey with the following URL <code><nowiki>http://www.limesurvey.org/test.php?foobarout={PASSTHRU:foobar}</nowiki></code> would then be converted to <code><nowiki>http://www.limesurvey.org/test.php?foobarout=XYZ123</nowiki></code>
==Pré-remplir une enquête à l'aide des paramètres GET==




{{Alert|title=Attention|text=Please note that the passthrough fields can be used only with LimeSurvey 2.x or later!}}
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]].


=Start URL=
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 :


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


You can prefill all answer except upload and equation question type. You can use [[Expression Manager#Access to Variables|qcode naming]] for the parameters and set the value for single question types. For multiple question type, you must use a [[SGQA identifier]].


Then answer are set to the pre-filled 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 check the answer.
{{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.}}


Here are some start URL '''examples''':


* <code><nowiki>http://ls.example.org/1234?QTEXT=prefilled</nowiki></code> : Fill the question with code Q1 with <nowiki>'prefilled'</nowiki>
{{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> }}
* <code><nowiki>http://ls.example.org/1234?1234X1X1SQ001=prefilled</nowiki></code> : Fill the sub question SQ001 of question number 1 in group 1 with <nowiki>'prefilled'</nowiki>
* <code><nowiki>http://ls.example.org/1234?1234X1X1SQ001=A1</nowiki></code> : Check the answer <nowiki>'A1'</nowiki> at the sub question SQ001 of question  number 1 in group 1 .
* <code><nowiki>http://ls.example.org/1234?1234X1X1SQ001=Y</nowiki></code> : Check the  sub question SQ001 at question  number 1 in group 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.}}
==Pré-remplir une enquête à l'aide des paramètres GET à l'aide de l'onglet Paramètres d'URL==
{{Hint|Text=The extra GET parameters are only filled 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>}}




==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 the [[Panel integration|panel integration]].


==Préremplir et masquer la réponse==


==Prefilling and hiding the answer==


You can use hidden advanced settings to hide the question 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"