Actions

URL fields/nl: Difference between revisions

From LimeSurvey Manual

(Created page with "In versies voor 1.92 moet je de SGQA gebruiken en neit de vraagcode.")
(Created page with "Als je naar 'Enquêtedeelnemers' gaat in het zijmenu van de enquête en de enquête wijzigt in de 'gesloten toegangsmodus', nadat je daar vooraf deelnemers hebt toegevoegd die...")
 
(100 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages />
<languages />
__TOC__
__TOC__


==Eind-URL veld==


Na het invullen van de enquête, of wanneer er door een quota een enquête wordt afgebroken, is er een mogelijkheid om een URL aan te geven. Deze URL wordt aan de respondent getoond op de afsluitpagina. Je kunt ook instellen dat de respondent automatisch naar deze URL doorgestuurd wordt.
=Inleiding=
 
 
URL velden kunnen gebruikt worden in de :
* Afsluiting-URL van de enquête (Lees: [[Text elements/nl|Enquête tekstelementen]]);
* URL-veld voor de [[Survey quotas/nl|quota]]-instelling;
* Start URL-veld van de enquête.


Er zijn een aantal velden beschikbaar die gebruikt kunnen worden in deze URL.


===Basisvelden===
=Afsluiting-URL veld=


Je kunt de velden {SAVEDID}, {TOKEN}, {SID} en {LANG} in de URL gebruiken.
* SAVEDID is het id dat toegekend is aan deze ingevulde enquête
* TOKEN is het token van de respondent voor deze enquête
* SID is het ID van de enquête
* LANG is de taalcode (vanaf versie 1.71+)


'''Voorbeeld'''
Na het invullen van de enquête, of wanneer er door een quota een enquête wordt afgebroken, is er een mogelijkheid om een URL aan te geven. Deze URL wordt aan de respondent getoond op de afsluitpagina. Je kunt ook instellen dat de respondent automatisch naar deze URL doorgestuurd wordt. Dit kan gedaan worden door deze optie te vullen in het paneel [[Text elements/nl|Enquête tekstelementen]] en het inschakelen van het automatisch laden van de afsluiting-URL op het scherm [[Presentation/nl|Presentatie]] na het afronden van de enquête.
 
Er zijn echter een aantal velden beschikbaar die gebruikt kunnen worden in deze URL om de functionaliteit uit te breiden.
 
Als je naar 'Enquêtedeelnemers' gaat in het zijmenu van de enquête en de enquête wijzigt in de 'gesloten toegangsmodus', nadat je daar vooraf deelnemers hebt toegevoegd die elk een token hebben, wordt de tokenparameter toegevoegd aan de eind-URL.
 
==Basisvelden==
 
 
Je kunt de velden '''{SAVEDID}''', '''{TOKEN}''', '''{SID}''' en '''{LANG}''' in de URL gebruiken.
* '''SAVEDID''' is het id dat toegekend is aan deze ingevulde enquête
* '''TOKEN''' is het token van de respondent voor deze enquête
* '''SID''' is het ID van de enquête
* '''LANG''' is de taalcode.
 
Bijvoorbeeld:


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


===Antwoordvelden===


Je kunt ook {INSERTANS:SGQA} in deze URL gebruiken (sinds versie 1.82+).
==Antwoordvelden==
* {INSERTANS: SGQA} staat toe dat het antwoord op een bepaalde vraag wordt toegevoegd in de URL. Dit kan handig zijn als je een respons wilt doorsturen naar een extern script (bijvoorbeeld een e-mailadres dat ingevuld is in de enquête).
 
 
Je kunt ook '''{INSERTANS:SGQA}''' of een [[ExpressionScript - Presentation/nl#Naamgeving Qcode Variabele|ExpressionScript variable]] gebruiken. Dit URL-veld staat toe dat het antwoord op een bepaalde vraag wordt toegevoegd in de URL. Dit kan handig zijn als je een respons wilt doorsturen naar een extern script (bijvoorbeeld een e-mailadres dat ingevuld is in de enquête).
 
Bijvoorbeeld:
 
<code><nowiki>
https://www.limesurvey.org/test.php?email={EMAILADDRESS}
</nowiki></code>


'''Voorbeeld'''
Het is wel belangrijk om "newtest/y" aan de URL toe te voegen om een nieuwe sessie af te dwingen als een deelnemer de enquête wil invullen.


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


===Expressies===
Deze URL start een enquête met ID = 48315, group = 2, question = 22 en answercodes = 2007 en 2008.
 
{{Note|Voor meer informatie over de noodzaak van "newtest/y": [https://www.limesurvey.org/forum/installation-a-update-issues/108334-use-case-for-not post op forum].}}


Je kunt ook een expressie gebruiken (sinds versie 1.92+).
==Expressies==


'''Voorbeeld'''
 
Je kunt hier ook een [[ExpressionScript_-_Presentation/nl|expressie]] gebruiken.
 
Bijvoorbeeld:


<code><nowiki>
<code><nowiki>
Line 43: Line 70:
</nowiki></code>
</nowiki></code>


===Parameters (vanaf LimeSurvey 2.x)===


Vanaf versie 2.0 kun je ook zelf velden definiëren die je als parameters in de URL wilt meegeven. Kijk bij de enquête algemene instellingen (Tab "Paneel-integratie"). Om een  parameter in de URL te gebruiken voeg je de tag {PASSTHRU:<naam van je invoerparameter>} toe.
==Parameters==


Voorbeeld


Je hebt in de tab Paneel-integratie een parameter 'foobar' toegevoegd. De enquête wordt gestart met een link als
Je kunt zelf ook velden definiëren die je als parameters in de afsluiting-URL wilt meegeven. Kijk voor meer informatie bij [[Panel integration/nl|functie paneel-integratie]]. Om een  parameter in de afsluiting-URL te gebruiken voeg je de tag {PASSTHRU:<naam van je invoerparameter>} toe.
 
We nemen aan dat je een [[Panel integration/nl|parameter]] "foobar" hebt gedefinieerd. De enquête wordt dan gestart met een link


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


de waarde die je wilt doorgeven is dus XYZ123.
de waarde die je wilt doorgeven is dus XYZ123.


Een eind-URL van een enquête <code><nowiki>http://www.limesurvey.org/test.php?foobarout={PASSTHRU:foobar}</nowiki></code> wordt dan omgezet naar <code><nowiki>http://www.limesurvey.org/test.php?foobarout=XYZ123</nowiki></code>
De afsluiting-URL van een enquête <code><nowiki>https://www.limesurvey.org/test.php?foobarout={PASSTHRU:foobar}</nowiki></code> wordt dan omgezet naar <code><nowiki>https://www.limesurvey.org/test.php?foobarout=XYZ123</nowiki></code>


===Parameters t/m versie 1.92===
=Start-URL=


Je kun ook een veldnaam en een waarde meegeven in de eind URL van een enquête.


Soms wil je een waarde doorgeven bij het initialiseren van een enquête en die waarde doorgeven met een extern script (bijvoorbeeld een id van een subsidie van een reclamebureau).
==Voorinvullen enquête m.b.v.  GET parameters==


'''Voorbeeld'''


In dit geval moet de enquête gestart worden query url "index.php?sid=12345&passthru;=subsid&subsid;=9999".
Je kunt alle antwoorden voorinvullen behalve die van de vraagtypes [[Question_type_-_File_upload/nl|upload]]  en [[Question type - Equation/nl|equation vergelijking]]. Je kunt de  [[ExpressionScript - Presentation/nl#Toegang tot variabelen|qcode naming]]  gebruiken voor de parameters en de waarde zetten voor de meeste vragen. Je kunt ook de [[SGQA identifier/nl|SGQA identifier]] gebruiken.


In je URL zou je gebruiken {PASSTHRULABEL} en {PASSTHRUVALUE} om deze waarden te hergebruiken aan het eind van de enquête.
De antwoorden worden dan gevuld met de vooringevulde waarde. Voor vragen met één enkel antwoord moet je de antwoordcode gebruiken, bij  meervoudige vragen moet je de Y gebruiken als je het antwoord wilt controleren.


Een URL als "http://www.limesurvey.org/test.php?{PASSTHRULABEL}={PASSTHRUVALUE}" wordt dan omgezet naar "http://www.limesurvey.org/test.php?subsid=9999"
'''Voorbeelden van Start-URL''':


=Plaatsen om URL velden te gebruiken=
* <code><nowiki>http://ls.example.org/1234?QTEXT=prefilled</nowiki></code> : Vul de vraag met code QTEXT in met <nowiki>'prefilled'</nowiki>
* <code><nowiki>https://ls.example.org/1234?MULTI_SQ001=prefilled</nowiki></code> {{NewIn/nl|v=3.14.1}} : Vul de subvraag SQ001 van vraag met titel MULTI in met  <nowiki>'prefilled'</nowiki> (bijvoorbeeld bij een meervoudige tekstvraag).
* <code><nowiki>https://ls.example.org/1234?single=-oth-&single_other=Other%20text</nowiki></code> {{NewIn/nl|v=3.14.1}} : Selecteer het veld 'Anders' bij een enkelekeuzevraag single en vul de waarde daarvan in bij “Anders".
* <code><nowiki>https://ls.example.org/1234?1234X1X1SQ001=prefilled</nowiki></code> : Vul de subvraag SQ001 van vraag nummer 1 in groep 1 met <nowiki>'prefilled'</nowiki>
* <code><nowiki>https://ls.example.org/1234?1234X1X1SQ001=A1</nowiki></code> : Vul alvast het antwoord <nowiki>'A1'</nowiki> bij de subvraag SQ001 van vraag nummer 1 in groep 1.
* <code><nowiki>https://ls.example.org/1234?1234X1X1SQ001=Y</nowiki></code> : Vul alvast de subvraag SQ001 van vraag nummer 1 in groep 1.


URL velden kunnen gebruikt worden in de algemene eind-URL ([[Creating a new survey/nl|Maken van een nieuwe enquête]]), en in de  URL instelling per  [[Quotas/nl|quota]].


==Start-URL==
{{Hint/nl|Text=De GET-parameters gebruiken ''?'' bij de eerste parameter en een ''&'' bij de andere parameters. Als er in de URL al een ''?'' staat moet je een ''&'' gebruiken bij elke parameter die je toevoegt.}}


==Voorinvullen enquête m.b.v.  GET parameters==


Je kunt alle antwoorden voorinvullen behalve die van de vraagtypes upload en vergelijking. Je kunt de  [[Expression Manager/nl#Toegang tot variabelen|qcode naming]]  gebruiken voor de parameters en de waarde zetten voor de meeste vragen. Voor meervoudige vraagtypes moet je de [[SGQA identifier/nl|SGQA identifier]] gebruiken
{{Hint|Text=De extra GET-parameters worden alleen ingevuld wanneer de enquête opnieuw begint. Voeg daarom voor het testen altijd newtest=Y toe om een nieuwe enquête te starten. Bijvoorbeeld: <code><nowiki>http://ls.example.org/1234?QTEXT=prefilled&newtest=Y</nowiki></code>.}}


De antwoorden worden dan gevuld met de vooringevulde waarde, je moet de antwoordcode gebruiken, bij  meervoudige vragen moet je de Y gebruiken als je het antwoord wilt controleren.
==Voorinvullen enquête m.b.v. GET parameters door gebruik van URL parameters tab==
 
'''Voorbeeld'''
 
* <code><nowiki>http://ls.example.org/1234?QTEXT=prefilled</nowiki></code> : Vul de vraag met code Q1 met <nowiki>'prefilled'</nowiki>
* <code><nowiki>http://ls.example.org/1234?1234X1X1SQ001=prefilled</nowiki></code> : Vul de subvraag SQ001 van vraagnummer 1 in groep 1 met <nowiki>'prefilled'</nowiki>
* <code><nowiki>http://ls.example.org/1234?1234X1X1SQ001=A1</nowiki></code> : Controleer het antworod <nowiki>'A1'</nowiki> op de subvraag SQ001 van vraagnummer 1 in groep 1 .
* <code><nowiki>http://ls.example.org/1234?1234X1X1SQ001=Y</nowiki></code> : Controleer de  subvraag SQ001 van vraagnummer 1 in groep 1.


{{Hint|Text=De GET parameters gebruiken ? bij de eerste parameter en bij een volgende paramater &. Als er in de URL al een ? staat moet je een & gebruiken bij parameters die je toevoegt.}}
{{Hint|Text=De extra GET parameters worden alleen gebruikt bij het starten van de enquête. Als je een eigen test maakt, kun je beter parameters aan Y toevoegen met : <code><nowiki>http://ls.example.org/1234?QTEXT=prefilled&newtest=Y</nowiki></code>}}
==Voorinvullen enquête m.b.v. GET parameters door gebruik van URL parameters tab==


Je kunt soms eenvoudiger antwoorden voorinvullen met [[Survey_settings/nl#Paneel-integratie (URL parameters)|URL parameters]]
Je kunt alvast van te voren met URL-parameters antwoorden invullen, die kun je instellen met [[Panel integration/nl|paneel-integratie]].


==Voorinvullen en het antwoord verbergen==


Je kun verborgen geavanceerde instellingen gebruiken om de vraag voor de invuller te verbergen. Het voorinvullen is ook dan mogelijk.
==Voorinvullen of verbergen van het antwoord==


==Voor versie 1.92==


In versies voor 1.92 moet je de SGQA gebruiken en neit de vraagcode.
Je kunt verborgen geavanceerde instellingen gebruiken om de vraag voor de invuller te [[QS:Hidden/nl|verbergen]]. Ook dan is voorinvullen mogelijk.

Latest revision as of 17:35, 2 April 2024


Inleiding

URL velden kunnen gebruikt worden in de :


Afsluiting-URL veld

Na het invullen van de enquête, of wanneer er door een quota een enquête wordt afgebroken, is er een mogelijkheid om een URL aan te geven. Deze URL wordt aan de respondent getoond op de afsluitpagina. Je kunt ook instellen dat de respondent automatisch naar deze URL doorgestuurd wordt. Dit kan gedaan worden door deze optie te vullen in het paneel Enquête tekstelementen en het inschakelen van het automatisch laden van de afsluiting-URL op het scherm Presentatie na het afronden van de enquête.

Er zijn echter een aantal velden beschikbaar die gebruikt kunnen worden in deze URL om de functionaliteit uit te breiden.

Als je naar 'Enquêtedeelnemers' gaat in het zijmenu van de enquête en de enquête wijzigt in de 'gesloten toegangsmodus', nadat je daar vooraf deelnemers hebt toegevoegd die elk een token hebben, wordt de tokenparameter toegevoegd aan de eind-URL.

Basisvelden

Je kunt de velden {SAVEDID}, {TOKEN}, {SID} en {LANG} in de URL gebruiken.

  • SAVEDID is het id dat toegekend is aan deze ingevulde enquête
  • TOKEN is het token van de respondent voor deze enquête
  • SID is het ID van de enquête
  • LANG is de taalcode.

Bijvoorbeeld:

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


Antwoordvelden

Je kunt ook {INSERTANS:SGQA} of een ExpressionScript variable gebruiken. Dit URL-veld staat toe dat het antwoord op een bepaalde vraag wordt toegevoegd in de URL. Dit kan handig zijn als je een respons wilt doorsturen naar een extern script (bijvoorbeeld een e-mailadres dat ingevuld is in de enquête).

Bijvoorbeeld:

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

Het is wel belangrijk om "newtest/y" aan de URL toe te voegen om een nieuwe sessie af te dwingen als een deelnemer de enquête wil invullen.

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

Deze URL start een enquête met ID = 48315, group = 2, question = 22 en answercodes = 2007 en 2008.

Voor meer informatie over de noodzaak van "newtest/y": post op forum.

Expressies

Je kunt hier ook een expressie gebruiken.

Bijvoorbeeld:

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


Parameters

Je kunt zelf ook velden definiëren die je als parameters in de afsluiting-URL wilt meegeven. Kijk voor meer informatie bij functie paneel-integratie. Om een parameter in de afsluiting-URL te gebruiken voeg je de tag {PASSTHRU:<naam van je invoerparameter>} toe.

We nemen aan dat je een parameter "foobar" hebt gedefinieerd. De enquête wordt dan gestart met een link

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

de waarde die je wilt doorgeven is dus XYZ123.

De afsluiting-URL van een enquête https://www.limesurvey.org/test.php?foobarout={PASSTHRU:foobar} wordt dan omgezet naar https://www.limesurvey.org/test.php?foobarout=XYZ123

Start-URL

Voorinvullen enquête m.b.v. GET parameters

Je kunt alle antwoorden voorinvullen behalve die van de vraagtypes upload en equation vergelijking. Je kunt de qcode naming gebruiken voor de parameters en de waarde zetten voor de meeste vragen. Je kunt ook de SGQA identifier gebruiken.

De antwoorden worden dan gevuld met de vooringevulde waarde. Voor vragen met één enkel antwoord moet je de antwoordcode gebruiken, bij meervoudige vragen moet je de Y gebruiken als je het antwoord wilt controleren.

Voorbeelden van Start-URL:

  • http://ls.example.org/1234?QTEXT=prefilled : Vul de vraag met code QTEXT in met 'prefilled'
  • https://ls.example.org/1234?MULTI_SQ001=prefilled (Nieuw in 3.14.1) : Vul de subvraag SQ001 van vraag met titel MULTI in met 'prefilled' (bijvoorbeeld bij een meervoudige tekstvraag).
  • https://ls.example.org/1234?single=-oth-&single_other=Other%20text (Nieuw in 3.14.1) : Selecteer het veld 'Anders' bij een enkelekeuzevraag single en vul de waarde daarvan in bij “Anders".
  • https://ls.example.org/1234?1234X1X1SQ001=prefilled : Vul de subvraag SQ001 van vraag nummer 1 in groep 1 met 'prefilled'
  • https://ls.example.org/1234?1234X1X1SQ001=A1 : Vul alvast het antwoord 'A1' bij de subvraag SQ001 van vraag nummer 1 in groep 1.
  • https://ls.example.org/1234?1234X1X1SQ001=Y : Vul alvast de subvraag SQ001 van vraag nummer 1 in groep 1.


 Tip: De GET-parameters gebruiken ? bij de eerste parameter en een & bij de andere parameters. Als er in de URL al een ? staat moet je een & gebruiken bij elke parameter die je toevoegt.


 Hint: De extra GET-parameters worden alleen ingevuld wanneer de enquête opnieuw begint. Voeg daarom voor het testen altijd newtest=Y toe om een nieuwe enquête te starten. Bijvoorbeeld: http://ls.example.org/1234?QTEXT=prefilled&newtest=Y.


Voorinvullen enquête m.b.v. GET parameters door gebruik van URL parameters tab

Je kunt alvast van te voren met URL-parameters antwoorden invullen, die kun je instellen met paneel-integratie.


Voorinvullen of verbergen van het antwoord

Je kunt verborgen geavanceerde instellingen gebruiken om de vraag voor de invuller te verbergen. Ook dan is voorinvullen mogelijk.