Kysymystyyppi - Päivämäärä

Lyhyt kuvaus

Tällä kysymystyypillä voidaan kysyä tiettyä päivämäärää, kellonaikaa tai niiden yhdistelmää. Vastaajat voivat valita arvot joko ponnahdusikkunan kalenterista tai pudotusvalikoista. Kyselyn ylläpitäjä voi määrittää vahvistuksen, minimi- ja/tai enimmäispäivämäärät. Erilaisia päivämäärä- ja aikamuotoja tuetaan.

Esimerkki: Example_Date_Time.zip

Yleiset asetukset

Pakollinen

Kuvaus

Tämän asetuksen avulla kyselyn ylläpitäjät voivat vaatia vastaajia vastaamaan tiettyihin kyselyn kysymyksiin. Jos pakollisiin kysymyksiin ei vastata, vastaajat eivät pääse etenemään eteenpäin. Jos sinulla on kysymys, jossa on useita alikysymyksiä, ja haluat vaatia vastauksen vain tiettyihin alikysymyksiin, käytä Logiikka-välilehdellä olevaa vähimmäisvastausmäärän attribuuttia.

Jos käytät jotakin esiasennetuista teemoista ja Pakollinen-kysymyksen attribuutti on käytössä, kysymyksen vieressä näytetään punainen tähti. Jos haluat piilottaa sen, katso nämä ohjeet.

Käytettävissä olevat vaihtoehdot

• On - Kysymykseen on vastattava, ennen kuin osallistuja voi siirtyä seuraavalle sivulle - vastausvaihtoehtoa 'Ei vastausta' ei koskaan näytetä.
• Soft - Jos kysymykseen ei ole vastattu, näytetään varoitus, kun yritetään siirtyä seuraavalle sivulle - osallistuja voi kuitenkin valita jättää varoituksen huomiotta ja jatkaa. Huomaa, että vaihtoehto 'Ei vastausta' näytetään edelleen (jos se on otettu käyttöön kyselyn esityksen asetuksissa)
• Off (oletus) - Kysymys voidaan jättää vastaamatta

Ehto

Kuvaus

Jos ehdon tulosarvo on "1" tai "true", kysymys on kyselyn kontekstissa "relevantti", eli se näytetään kyselyn osallistujalle. Muussa tapauksessa kysymys piilotetaan. Jokaiselle kyselyn kysymykselle voi määrittää relevanssiyhtälön. Tämä toiminto korvaa aiemmat ehdot ja tukee paljon monimutkaisempaa ehdollista logiikkaa.

Syntaksin korostus

Kun tallennat ehdon, se arvioidaan ja sen syntaksi korostetaan. Mahdolliset virheet merkitään väreillä, jotta voit havaita ja korjata ne nopeasti.

 Hint: Jos haluat tarkistaa, että kaikkia ehtoja käytetään kyselyssäsi oikein, lue logiikkatiedoston näyttäminen -toiminnosta.

Sallitut arvot

• Mikä tahansa ehto, joka käyttää ExpressionScript-syntaksia ilman ympäröiviä aaltosulkeita.

Esimerkkejä

Tässä on hyviä esimerkkejä syntaksin korostuksesta.

Näyttö

Näytä pudotusvalikot (dropdown_dates)

Kuvaus

Jos asetus on käytössä, päivämäärä/aika-kysymystyyppi näyttää vastaajille pudotusvalikon, josta he valitsevat päivämäärän/ajan oletuksena käytettävän ponnahdusikkunan sijaan.

Käytettävissä olevat vaihtoehdot

• Päällä
• Pois päältä (oletus)

Esimerkki

Jos asetus on päällä, kysymys näytetään seuraavasti:

Piilota vihje (hide_tip)

Kuvaus

Useimpiin kysymyksiin sisältyy yleensä vihje, kuten "Valitse yksi seuraavista vaihtoehdoista", tai ohjeteksti kysymykseen vastaamisesta. Tämän määritteen avulla voit piilottaa tai näyttää nämä vihjeet.

Nämä vihjeet sisältävät myös validointiehtojen viestit (kuten vastausten vähimmäis- tai enimmäismäärä sekä summan vähimmäis-, enimmäis- tai tarkka arvo). Jos hide_tip on käytössä, nämä viestit piilotetaan. Jos käyttäjä kuitenkin syöttää virheellisiä tietoja, vihjeet tulevat näkyviin. Ne näytetään punaisella, ja väri muuttuu vihreäksi, kun validointiehdot täyttyvät.

Käytettävissä olevat vaihtoehdot

• On - vihjeet piilotetaan;
• Off (oletus).

Kuukauden esitystapa (month_display_style)

Kuvaus

Kuukaudet voidaan näyttää vastaajille kolmella tavalla: lyhyillä nimillä (tammi, helmi jne.), koko nimillä (tammikuu, helmikuu jne.) tai kuukauden numerolla eli sijainnilla vuosikalenterissa (01 tammikuulle, 02 helmikuulle ja niin edelleen).

Käytettävissä olevat vaihtoehdot

• Lyhyet nimet
• Koko nimet
• Numerot

Käänteinen vastausjärjestys (reverse)

Kuvaus

Jos tämä on käytössä, vastausten järjestys käännetään.

Käytettävissä olevat vaihtoehdot

• Päällä
• Pois päältä (oletus)

Esimerkki

Oletetaan, että haluat käyttää kysymystyyppiä Taulukko (Numerot). Jos tämä asetus ei ole käytössä (oletusarvo), kyselyn osallistuja voi valita vastauksista: "1, 2, 3, ... , 10". Jos asetus on käytössä, käytettävissä olevien vastausten järjestys käännetään: "10, 9, 8, ... , 1".

Kysymyksen teema (question_theme)

Kuvaus

Sen avulla voit käyttää mukautettuja teemoja kyseiselle kysymykselle.

Käytettävissä olevat vaihtoehdot

• Luomasi kysymysteemat, jotka sijaitsevat kohdassa Kysymyksen teemat Teemat-paneelissa.

Katso: Kysymyksen teemat

Huomautus: Tämä ominaisuus on tällä hetkellä kehitteillä.

Piilota kysymys aina (hidden)

Kuvaus

Jos asetus on käytössä, kysymys on aina piilotettu eikä sitä näytetä kyselyn osallistujille. Tätä toimintoa voi käyttää seuraavissa tilanteissa:

• Jos haluat esitäyttää kysymyksen URL-osoitteen avulla etkä halua näyttää kysymystä ruudulla. Tämä ohittaa kaikki kyselyssä käytetyt ehdot, koska kyseistä kysymystä ei edes sisällytetä sivulle.
• Jos haluat tallentaa tai laskea arvon lennossa ExpressionScriptin avulla.

Huomautus: Tämän toiminnon kanssa käytetään usein Yhtälö-kysymystyyppiä.

Käytettävissä olevat vaihtoehdot

• Päällä
• Pois päältä (oletus)

CSS-luokka (css_class)

Kuvaus

Jos haluat lisätä tiettyihin kysymyksiin erityisiä CSS-luokkia, voit kirjoittaa CSS-luokan nimen tai nimet tähän kenttään. Varmista, että eri luokkien nimien väliin jää tyhjä välilyönti.

Sallitut arvot

• Mikä tahansa merkkijono, jossa eri CSS-luokkien nimet on erotettu välilyönnillä.

 Hint: Voit lisätä tähän kenttään myös lausekkeen ^{(New in 3.0.0 )}. Muista, että lausekkeen tulos ei päivity dynaamisesti.

  W3C:n mukaan CSS-luokkien nimet voivat sisältää vain merkkejä [a-zA-Z ja 0-9] sekä ISO 10646 -merkkejä U+00A1 ja sitä suurempia, lisäksi yhdysmerkin (-) ja alaviivan (_). Nimi ei saa alkaa numerolla eikä yhdysmerkillä, jota seuraa numero. LimeSurvey koodaa CSS-luokat, mutta ei korjaa niitä täysin.

Minimi päivämäärä (date_min)

Kuvaus

Tämän kysymyksen attribuutin avulla voidaan asettaa päivämääräkysymyksen minimiarvo (muodossa y-m-d tai millä tahansa kelvollisella englanninkielisellä merkkijonolla - lisätietoja alla). Sitä voidaan käyttää sekä ponnahdusikkunan että pudotusvalikon näyttöasetuksissa. Jos minimipäivämäärää ei ole asetettu, oletuksena käytetään arvoa 1.1.1900.

  Lausekehallinnan validointiasetusta voidaan käyttää myös "minimipäivämäärän" asettamiseen. Jos kuitenkin käytät ponnahduskalenteria ja lauseke perustuu samalla sivulla olevaan edelliseen kysymykseen, vuosi ei näy oikein ponnahduskalenterissa.

Sallitut arvot

• Mikä tahansa päivämääräarvo muodossa YYYY-MM-DD (esim. 2017-08-24);
• Mikä tahansa vuosiarvo;
• Mikä tahansa englanninkielinen merkkijono : "now", "-10 years", "tomorrow";
• Viittaus toiseen päivämäärä- tai aikakysymykseen : AnotherDateQuestion (kysymyskoodin avulla);
• Lausekkeet : Lausekkeiden avulla minimipäivämäärä voidaan laskea dynaamisesti. Voit esimerkiksi käyttää edellisen vastauksen päivämäärää + 3 päivää nykyisen kysymyksen minimiarvona syöttämällä: date("Y-m-d",strtotime(departuredate)+3*60*60*24).

Enimmäis päivämäärä (date_max)

Kuvaus

Tämän kysymyksen attribuutin avulla voidaan asettaa päivämääräkysymyksen maksimiarvo (muodossa v-k-p tai millä tahansa muulla kelvollisella englanninkielisellä merkkijonolla – lisää vaihtoehtoja on alla). Sitä voidaan käyttää sekä ponnahdusikkuna- että pudotusvalikkonäyttövaihtoehdoissa.

  Lausekehallinnan validointivaihtoehtoa voidaan käyttää myös "enimmäispäivämäärän" asettamiseen. Jos kuitenkin käytät ponnahduskalenteria ja lauseke perustuu samalla sivulla olevaan edelliseen kysymykseen, vuosi ei näy oikein ponnahduskalenterissa.

Sallitut arvot

• Mikä tahansa päivämääräarvo muodossa YYYY-MM-DD (esim. 2018-08-24);
• Mikä tahansa vuosiarvo;
• Mikä tahansa englanninkielinen merkkijono: "now", "-10 years", "tomorrow";
• Viittaus toiseen päivämäärä- tai aikakysymykseen: AnotherDateQuestion (käyttäen kysymyskoodia);
• Lausekkeet: Lausekkeiden avulla päivämäärä voidaan laskea dynaamisesti. Voit esimerkiksi käyttää edellisen vastauksen päivämäärää + 3 päivää nykyisen kysymyksen enimmäispäivämääränä syöttämällä: date("Y-m-d",strtotime(departuredate)+3*60*60*24).

Tulostettavan kyselyn relevanssin ohje (printable_survey_relevance_help)

Kuvaus

Jos haluat tulostaa kyselyn, voit tulostaa myös jokaisen kysymyksen relevanssiyhtälöt. Jos haluat kuitenkin tulostettuun lomakkeeseen lausekkeen sijaan selityksen, täytä tähän kenttään relevanssiyhtälön tekstimuotoinen selitys.

Sallitut arvot

• Mikä tahansa teksti ja/tai numerot, jotka haluat näyttää tulostettavassa lomakkeessa.

Syöte

Päivämäärän ja ajan muoto

Kuvaus

Tällä kysymyksen asetuksella voidaan määrittää oma päivämäärän muoto. Jos kenttä on tyhjä, käytetään kyselyn päivämäärän muotoa.

Sallitut arvot

• Muotoja d/dd, m/mm, yy/yyyy, H/HH ja M/MM voidaan käyttää päivämäärän ja/tai ajan näyttämiseen. Erottimina voidaan käyttää merkkejä "-", ".", "/" ja ":".

Esimerkkejä

• yyyy-mm-dd - vuosi-kuukausi-päivä;
• dd.mm.yyyy HH:MM - päivä.kuukausi.vuosi tunti:minuutti;
• HH:MM - tunti:minuutti (vain kellonaika on valittavissa);
• yyyy/mm - vuosi/kuukausi.

Askelintervalli minuuteille (minute_step_interval)

Kuvaus

 Hint: This feature changed with version 3.14.12

Sitä käytetään vain, kun syöttömuoto sisältää minuutit ("MM").

Sallitut arvot

• Mikä tahansa numeerinen arvo, joka on pienempi kuin 60. Arvon asettaminen suuremmaksi kuin 60 on tarpeetonta -> pudotusvalikossa näytetään vastausvaihtoehtona vain "0" tai "00".

Esimerkki

Alla olevassa esimerkissä askelintervalli minuuteille on asetettu arvoon 7:

Logiikka

Satunnaisuus ryhmän nimi (random_group)

Kuvaus

Tämä asetus sijoittaa kysymykset määritettyyn satunnaisryhmään. Kaikki määritettyyn ryhmään kuuluvat kysymykset näytetään kyselyn vastaajille satunnaisessa järjestyksessä.

Esimerkkikyselyn, jossa käytetään satunnaisryhmän nimeä, löydät sivulta ExpressionScript-esimerkkikysely.

Sallitut arvot

Kirjoita mikä tahansa haluamasi merkkijono (esimerkiksi: 'group1'). Kaikkien niiden kysymysten paikka kyselyssä satunnaistetaan (= vaihdetaan satunnaisesti keskenään), joiden Satunnaisuus ryhmän nimi -kenttään on asetettu sama merkkijono.

Esikatselu Kun haluat esikatsella kysymyksiä, käytä Esikatsele kyselyä -toimintoa Esikatsele kysymysryhmää -toiminnon sijaan, sillä jälkimmäisen on raportoitu olevan näyttämättä kysymyksiä satunnaisessa järjestyksessä.

Kysymyksen vahvistusyhtälö (em_validation_q)

Kuvaus

Tätä yhtälöä käytetään koko kysymyksen vahvistamiseen (esim. monivastauskysymyksessä kaikkien osien yhdessä). Jos kysymys ei läpäise vahvistuskriteerejä, näytetään em_validation_q_tip-viesti (se käyttää CSS-tyyliä .error). Tämä vihje käyttää CSS-tyyliä .em_q_fn_validation, joka on oletuksena piilotettu tiedostossa template.css.

Tämän ominaisuuden ja alikysymysten vahvistusyhtälöiden (em_validation_sq option) tärkein ero on se, että tässä ominaisuudessa voidaan näyttää virheilmoitus, jos kysymys (tai sen osat) ei läpäise vahvistusta. Alikysymysten vahvistuksessa jokaisen tekstinsyöttökentän (esim. taulukkotyyppisessä kysymyksessä, mutta sitä voidaan käyttää myös yhden syötteen kysymystyypeissä) taustaväri muutetaan (vaalean)punaiseksi.

Kelvolliset arvot

• Mikä tahansa yhtälö, joka käyttää ExpressionScript-syntaksia ilman ympäröiviä aaltosulkeita.

Esimerkki

• Haluat kerätä käyttäjiltä demografisia tietoja useita lyhyitä tekstikenttiä -kysymyksen avulla ja haluat varmistaa, että käyttäjä on syöttänyt kelvollisen sähköpostiosoitteen ja puhelinnumeron.

Tämä esimerkki näyttää, miltä kysymys näyttää virheellisillä vastauksilla:

Ja tältä se näyttää, kun yksi vastaus on virheellinen:

Näin muokkaat kysymystä syöttääksesi nämä tiedot:

Tässä on osa Näytä logiikkatiedosto -tulosteesta, jonka avulla voit tarkistaa lausekkeesi oikeellisuuden ja varmistaa, ettei siinä ole syntaksivirheitä:

Kuten näet, vahvistusyhtälö testaa, että sähköpostiosoite ja puhelinnumero ovat joko tyhjiä tai vastaavat säännöllisen lausekkeen suodatinta.

Vahvistusvihje näyttää varoitusviestin vain, jos puhelinnumero tai sähköpostiosoite näyttää virheelliseltä.

 Hint: Jos haluat luoda monimutkaisia vahvistusviestejä, lue ExpressionScriptin käytöstä.

Jos haluat tuoda yllä olevan esimerkin LimeSurvey-asennukseesi, lataa seuraava .lsq-tiedosto: Em_validation_q_example.zip.

 Hint: Muista, että LimeSurvey käyttää säännöllisissä lausekkeissa Perl-syntaksia, joten niiden tulee alkaa ja päättyä merkkiin / (kauttaviiva)!

Vinkki koko kysymyksen vahvistusyhtälölle (em_validation_q_tip)

Kuvaus

Jos käytät kysymyksen vahvistusyhtälöä, voit tämän kentän avulla näyttää valinnaisen viestin kysymyksen vinkkinä siitä, miten kysymykseen tulee vastata.

Sallitut arvot

• Mikä tahansa merkkijono tai yhtälö, joka käyttää ExpressionScript-syntaksia.

Esimerkki

Katso esimerkki wikin kysymyksen vahvistusyhtälö -osiosta. Se näyttää, miten vinkki voidaan räätälöidä näyttämään, mitkä osat Useita lyhyitä tekstikenttiä -kysymyksestä eivät täytä vahvistusehtoja.

Muut

Lisää tulostettavassa näkymässä sivunvaihto (page_break)

Kuvaus

Tämä attribuutti on aktiivinen vain, kun kysely todella tulostetaan tulostusnäkymästä. Se pakottaa sivunvaihdon ennen kysymystä.

Käytettävissä olevat vaihtoehdot

• Päällä
• Pois päältä (oletus)

Tilastot

Näytä kaavio (display_chart)

Kuvaus

Tämän attribuutin avulla kyselyn ylläpitäjä voi valita, näytetäänkö kysymyksen tuloksia sisältävä kaavio osallistujille sen jälkeen, kun he ovat täyttäneet kyselyn.

Huomautus: Jotta kaavio näytetään viimeisellä sivulla, sinun on otettava käyttöön seuraavat asetukset:

• julkiset tilastot -kyselyasetus kohdassa Esityksen & navigoinnin asetukset
• näytä kaaviot -kyselyasetus kohdassa Esityksen & navigoinnin asetukset
• julkiset tilastot -kysymyksen attribuutti ja
• näytä kaavio -kysymyksen attribuutti.

Käytettävissä olevat vaihtoehdot

• Käytössä
• Pois käytöstä (oletus)

Kaavion tyyppi (chart_type)

Kuvaus

Tämän attribuutin avulla kyselyn ylläpitäjä voi valita, minkä tyyppinen kaavio näytetään vastaajalle, kun hän on täyttänyt kyselyn.

Huomautus: Muista muuttaa kysymyksen ja kyselyn asetuksia, jotta kaaviot näytetään kyselyn lopussa. Lisätietoja löydät wikin kohdasta Näytä kaavio -kysymyksen attribuutti.

Käytettävissä olevat vaihtoehdot

• Palkkikaavio
• Ympyrädiagrammi
• Tutka
• Viiva
• Napakaavio
• Donitsikaavio

Päivämäärät ja ExpressionScript: Edistynyt validointi ja laskenta

Limesurvey (versiosta 2.05 alkaen) tekee päivämäärien validoinnista melko helppoa date_min- ja date_max-kenttien avulla (katso edellä). Käytä niitä aina, kun mahdollista. Jos tarvitset edistyneempää validointia, voit ehkä käsitellä päivämääriä (ja laskea niillä) ExpressionScriptin ja strtotime()-funktion avulla. Se laskee sekuntien määrän 1. tammikuuta 1970 ja annetun päivämäärän välillä.

Esimerkki: jos haluat näyttää kysymystekstissä, kuinka monta päivää on kulunut lähtöpäivästä (kysytty edellisessä kysymyksessä) tähän päivään, voit käyttää lauseketta {(strtotime("now")-strtotime(departure))/60/60/24}.

Huomaa, että strtotime() toimii monien eri muotojen kanssa, mutta ei kaikkien! Esimerkiksi Limesurveyn oletuspäiväysmuoto (MM-DD-YYYY) EI toimi strtotime()-funktion kanssa. Ongelmien välttämiseksi aseta kyselysi käyttämään jotakin seuraavista päiväysmuodoista: YYYY-MM-DD, YYYY/MM/DD, DD.MM.YYYY, MM/DD/YYYY tai DD-MM-YYYY.

  Limesurveyssä päivämäärät tallennetaan merkkijonona (tekstimuodossa). ExpressionScript muuntaa kaikki lausekkeen päivämäärät vakiomuotoon "yyyy-mm-dd HH:MM:SS". Tämä helpottaa päivämäärien vertailua lausekkeessa huomattavasti (esim. "date1>date2"). Jos tarvitset päivämäärän merkkijonona siinä muodossa, jossa se kysyttiin kysymyksessä, käytä ".shown"-attribuuttia (esim.: Synnyit {birthdate.shown}.)