Actions

URL velden

From LimeSurvey Manual

Revision as of 19:42, 23 April 2016 by Han (talk | contribs) (Created page with "==Voorinvullen enquête m.b.v. GET parameters==")

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.

Er zijn een aantal velden beschikbaar die gebruikt kunnen worden in deze 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 (vanaf versie 1.71+)

Voorbeeld

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

Antwoordvelden

Je kunt ook {INSERTANS:SGQA} in deze URL gebruiken (sinds versie 1.82+).

  • {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).

Voorbeeld

http://www.limesurvey.org/test.php?email={INSERTANS:1234X56X7}

Expressies

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

Voorbeeld

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

Doorgeefvelden

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.

Voorbeeld

Je hebt in de tab Paneel-integratie een parameter 'foobar' toegevoegd. De enquête wordt gestart met een link als

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

de waarde die je wilt doorgeven is dus XYZ123.

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

Doorgeefvelden tot en met versie 1.92

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

Voorbeeld

In dit geval moet de enquête gestart worden query url "index.php?sid=12345&passthru;=subsid&subsid;=9999".

In je URL zou je gebruiken {PASSTHRULABEL} en {PASSTHRUVALUE} om deze waarden te hergebruiken aan het eind van de enquête.

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

Plaatsen om URL velden te gebruiken

URL velden kunnen gebruikt worden in de algemene eind-URL (Maken van een nieuwe enquête), en in de URL instelling per quota.

Start-URL

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

You can prefill all answer except upload and equation question type. You can use qcode naming for the parameters and set the value for single question. For multiple question type, you must use SGQA identifier

Then answer 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 check the answer.

Example

  • http://ls.example.org/1234?QTEXT=prefilled : Fill the question with code Q1 with 'prefilled'
  • http://ls.example.org/1234?1234X1X1SQ001=prefilled : Fill the sub question SQ001 of question number 1 in group 1 with 'prefilled'
  • http://ls.example.org/1234?1234X1X1SQ001=A1 : Check the answer 'A1' at the sub question SQ001 of question number 1 in group 1 .
  • http://ls.example.org/1234?1234X1X1SQ001=Y : Check the sub question SQ001 at question number 1 in group 1.
 Hint: The GET parameters use ? is it the first and & after the first. If you already have ? in your url you must use & to add GET parameters.
 Hint: The extra GET parameters is filled only when survey start. Then, when you make your own test , it's better to add newtest parameters to Y like : http://ls.example.org/1234?QTEXT=prefilled&newtest=Y


Prefilling a survey using GET parameters using URL parameters tab

You can prefill to, sometimes more easily, answer using URL parameters

Prefilling and hidding the answer

You can use hidden avanced settings to hide the question to respondant. Prefilling is happen too.

Before 1.92 version

Before 1.92 version, you must use SGQA and not directly the question code.