URL-kentät

Johdanto

URL-kenttien parametreja voi käyttää seuraavissa:

• kyselyn Loppusivun osoite -kentässä (katso kyselyn tekstielementit)
• kiintiösäännön URL-kentässä (lue lisää kyselyn kiintiöistä täältä)
• kyselyn aloitus-URL-kentässä (katso kyselyn tekstielementit).

Loppusivun osoite -kenttä

Kyselyn lopussa tai kun kiintiö päättää kyselyn voit asettaa päättymis-URL:n. Tämä URL näytetään kyselyn suorittaneelle osallistujalle loppusivulla, tai voit halutessasi asettaa osallistujan ohjautumaan automaattisesti kyseiseen URL-osoitteeseen. Tämä tehdään täyttämällä Loppusivun osoite -asetus Kyselyn tekstielementit -paneelissa ja ottamalla käyttöön loppusivun osoitteen automaattinen lataus Esitys-paneelissa, kun kysely on valmis.

LimeSurvey tarjoaa kuitenkin mahdollisuuden käyttää URL-kenttiä monella muullakin tavalla, minkä avulla voit laajentaa kyselysi toiminnallisuutta.

Jos siirryt kyselyn sivuvalikossa kohtaan “Osallistujat” ja asetat kyselyn suljettuun pääsytilaan (“closed access mode“) ja lisäät sinne osallistujat etukäteen niin, että jokaisella on tunniste, tunniste-parametri lisätään loppusivun osoitteeseen.

Peruskentät

Voit käyttää loppusivun osoitteessa tunnisteita {SAVEDID}, {TOKEN}, {SID} ja {LANG}:

• SAVEDID on tälle lähetykselle annettu tunnus;
• TOKEN on kyselyyn osallistumiseen käytetty tunniste;
• SID on kyselyn ID;
• LANG on kielikoodi.

Esimerkiksi:

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

Vastauskentät

Voit käyttää myös ExpressionScript-muuttujia. Tämän URL-kentän avulla voit lisätä loppusivun osoitteeseen vastauksen kyselyn tiettyyn kysymykseen. Tämä voi olla hyödyllistä, kun vastaus lähetetään ulkoiselle skriptille (esim. kyselyn aikana kerätty sähköpostiosoite).

Esimerkiksi:

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

On tärkeää lisätä URL-osoitteeseen "newtest/y", jotta uusi istunto pakotetaan aina, kun kyselyn osallistuja haluaa täyttää kyselysi.

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

Yllä olevassa esimerkissä URL viittaa kyselyyn, jonka ID = 48315, ryhmä = 2, kysymys = 22 ja vastauskoodit = 2007 ja 2008.

Lisätietoja "newtest/y":n tarpeellisuudesta löydät tästä keskusteluketjusta.

Lausekkeet

Voit käyttää tässä myös mitä tahansa lauseketta.

Esimerkiksi:

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

Läpivientikentät

Läpivientikenttien käyttöä varten sinun täytyy määrittää muuttujien nimet Paneelin integraatio -toiminnon kautta. Jos et määritä kohdekysymystä, muuttujia ei tallenneta vastauksiin (lue lisää LimeSurveyn paneelin integraatio -ominaisuudesta). Jos haluat käyttää tällaista parametria loppusivun osoitteessa, lisää tunniste {PASSTHRU:<paramname>}, jossa <paramname> on syöteparametrisi nimi.

Oletetaan, että olet määrittänyt parametrin nimeltä "foobar". Kysely aloitetaan tämän kaltaisella linkillä:

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

XYZ123 on arvo, jonka haluat "välittää".

Kyselyn loppusivun osoite https://www.limesurvey.org/test.php?foobarout={PASSTHRU:foobar} muunnettaisiin tällöin muotoon https://www.limesurvey.org/test.php?foobarout=XYZ123

Aloitus-URL

Kyselyn esitäyttö GET-parametreilla

Voit esitäyttää kaikki vastaukset paitsi tiedoston lähetys- ja yhtälö-kysymystyypin vastaukset. Voit käyttää parametreissa qcode-nimeämistä ja asettaa arvon yksittäisille kysymystyypeille tai käyttää SGQA-tunnistetta.

Tämän jälkeen vastauksiksi asetetaan esitäytetty arvo. Yhden valinnan vaihtoehdossa sinun on käytettävä vastauksen koodia, ja monivalintakysymyksessä sinun on käytettävä arvoa Y, jos haluat esitäyttää vastauksen.

Tässä on joitakin aloitus-URL-esimerkkejä:

• http://ls.example.org/1234?QTEXT=prefilled : Täytä kysymys, jonka koodi on QTEXT, arvolla 'prefilled'
• https://ls.example.org/1234?MULTI_SQ001=prefilled ^{(New in 3.14.1 )} : Täytä sellaisen kysymyksen alikysymys SQ001, jonka otsikko on MULTI, arvolla 'prefilled' (esimerkiksi monitekstikysymyksessä).
• https://ls.example.org/1234?single=-oth-&single_other=Other%20text ^{(New in 3.14.1 )} : Valitse yhden valinnan kysymyksen "Muu"-vastausvaihtoehto ja täytä muu-arvoksi teksti "Other text".
• https://ls.example.org/1234?1234X1X1SQ001=prefilled : Täytä alikysymys SQ001 kysymyksestä, jonka ID on 1 ja joka kuuluu ryhmään, jonka ID on 1, arvolla 'prefilled'
• https://ls.example.org/1234?1234X1X1SQ001=A1 : Esivalitse vastausvaihtoehto 'A1' alikysymyksestä SQ001 kysymyksessä, jonka ID on 1 ja joka kuuluu ryhmään, jonka ID on 1.
• https://ls.example.org/1234?1234X1X1SQ001=Y : Esivalitse alikysymys SQ001 kysymyksestä, jonka ID on 1 ja joka kuuluu ryhmään, jonka ID on 1.

 Hint: GET-parametreissa ensimmäinen parametri aloitetaan merkillä "?" ja seuraavat merkillä "&". Jos URL-osoitteessasi on jo "?", sinun on lisättävä muut GET-parametrit käyttämällä merkkiä "&".

 Hint: Ylimääräiset GET-parametrit täytetään vain, kun kysely alkaa alusta. Lisää siksi testauksessa aina newtest=Y, jotta kysely alkaa alusta. Esimerkiksi: http://ls.example.org/1234?QTEXT=prefilled&newtest=Y

Kyselyn esitäyttö GET-parametreilla URL-parametrit-välilehden avulla

Voit esitäyttää vastauksia (joskus helpommin) URL-parametreilla, jotka voidaan määrittää Paneelin integraatio -toiminnossa.

Vastauksen esitäyttö ja piilottaminen

Voit piilottaa kysymyksen vastaajilta käyttämällä kysymyksen piilotusmääritettä. Tällöin kysymys pysyy silti esitäytettynä.