Actions

Tip vprašanja - Besedilo - kratko

From LimeSurvey Manual

Revision as of 14:06, 3 September 2013 by Anjaf (talk | contribs) (Created page with "{{QS:time_limit_warning_message/sl}}")

Kratek opis

This question type collects a single line of text input.


Glavne nastavitve

Obvezno

Opis

Ta možnost skrbnikom ankete omogoča, da od svojih anketirancev zahtevajo, da odgovorijo na določena anketna vprašanja. Če na obvezna vprašanja ne odgovorijo, anketiranci ne bodo mogli nadaljevati. Če imate vprašanje z več podvprašanji in zahtevate odgovor le na določena podvprašanja, uporabite atribut minimalni odgovor, ki se nahaja pod zavihkom Logika.

Template:Opomba


Razpoložljive možnosti

  • Vklopljeno - na vprašanje je treba odgovoriti, preden lahko udeleženec nadaljuje na naslednjo stran - možnost odgovora 'Brez odgovora' ni nikoli prikazana.
  • Soft - Če na vprašanje ni odgovorjeno, se ob poskusu nadaljevanja prikaže opozorilo naslednja stran - vendar se lahko udeleženec odloči, da opozorilo prezre in nadaljuje. Upoštevajte, da je možnost 'Brez odgovora' še vedno prikazana (če je aktivirana v nastavitvah predstavitve ankete)
  • Izklopljeno (privzeto) - Vprašanje lahko ostane brez odgovora


If the map is enabled as a google map, and the question is set to mandatory, the survey user must move the red point, or enter the Lat/Long text box.  The user may not merely rely on the default, and hit the "NEXT" button.  It is recommended that you so advise in the substance of the question text.


Preverjanje (z uporabo regularnih izrazov) (preg_validation)

Opis

Ta možnost vam omogoča, da določite regularni izraz, s katerim lahko potrdite vse dele vprašanja.

Če vrednost katerega koli vprašanja ali podvprašanja ne izpolnjuje zahtev za preverjanje veljavnosti, bo barva ozadja polja za vnos besedila spremenjena v rdečo, tako da lahko uporabniki zlahka vidijo, katere dele vprašanja je treba popraviti. Tako lahko opravite preverjanje na strani. Na ta način vam 'ne bo treba čakati, da uporabnik klikne na gumb za oddajo, da potrdi zadevno vprašanje.

'Veljavne vrednosti

  • Vsak veljaven regularni izraz

Primer


QS:Defaults/sl


Pogoj (prej "Enačba ustreznosti")

Opis

Če je rezultat pogoja »1« ali »true«, je vprašanje v kontekstu ankete »relevantno«, torej se prikaže anketirancu. Če ne, je vprašanje skrito. Vsako anketno vprašanje vam omogoča, da določite enačbo pomembnosti. Ta funkcija je naslednica pogojev in podpira veliko bolj zapleteno pogojno logiko.

Označevanje sintakse

Kadarkoli shranite pogoj, je ovrednoten in sintaktično poudarjen. Morebitne napake bodo označene z barvami, da jih boste lahko hitro odkrili in odpravili.

 Hint: Če želite preveriti, ali so vsi pogoji v vaši anketi pravilno uporabljeni, preberite o naši funkciji prikaži logično datoteko.


Veljavne vrednosti

  • Kateri koli pogoj, ki uporablja sintakso ExpressionScript brez okoliških zavitih oklepajev.

Primeri

Tu so dobri primeri označevanja sintakse.


Napredne nastavitve

Predpona (predpona)

Opis

Besedilna vrednost, ki bo prikazana kot predpona pred poljem(-i) za vnos besedila. Predpona je prikazana levo od vnosa.

Če je zaslon majhen, bo nad vnosom prikazana predpona. Če ga želite pustiti na levi strani (New in 3.0.0 ) : dodajte vprašanju razred suffix-prefix-force.

Veljavne vrednosti

  • Vsak znak ali nabor znakov, ki jih želite prikazati pred vnosom

Primer

Če bi za ta atribut vnesli vrednost "$", bi bil neposredno pred poljem za vnos besedila prikazan znak za dolar.



Pripona (končnica)

Opis

Besedilna vrednost, ki bo pripona k polju za vnos besedila. Pripona je prikazana tik ob vnosu.

Na majhnem zaslonu: pripona je prikazana pod vnosom. Če ga želite pustiti desno (New in 3.0.0 ) : vprašanju dodajte razred suffix-prefix-force.

Veljavne vrednosti

  • Vsak znak ali nabor znakov, za katerega želite, da se prikaže po vnosu

Primer

Če bi za ta atribut vnesli vrednost »%«, bi bil takoj za poljem za vnos besedila prikazan znak za odstotek.



Prikaži vrstice (display_rows)

Opis

Nastavi število vrstic, ki so prikazane brez uporabe drsnega traku za preverjanje celotne vsebine. Če je več vrstic, kot je navedeno v tem polju, se prikaže drsni trak. Privzeta vrednost za "Vrsta vprašanja z dolgim prostim besedilom" je 5, medtem ko je za "Vrsta vprašanja z ogromnim prostim besedilom" 30.

'Veljavne vrednosti

  • Kakršno koli pozitivno celo število, večje od 0



Širina vnosnega polja (text_input_width)

Opis

Ta atribut nastavi širino polj za vnos besedila ("ovija" polj za vnos besedila). V polje za vnos vnesemo odgovor na (pod)vprašanje. Če je vrednost širine dovolj visoka, se polje za vnos besedila prikaže v naslednji vrstici. Upoštevajte, da ta možnost ne nastavi velikosti vnosa ali širine celotnega stolpca!

Razpoložljive možnosti

  • Privzeto: če je izbrano, bo temu atributu dodeljena privzeta vrednost tako, da sta oznaka in njeno ustrezno polje za vnos besedila v isti vrstici. Če je na primer širina polja za vnos besedila 41 %, bo vrednost širine polja za vnos besedila vrednost, ki omogoča, da sta oznaka in polje za vnos v isti vrstici (v tem primeru 58 %). Če bi bila širina polja za vnos besedila višja od 58 %, bi bilo polje za vnos besedila prikazano v naslednji vrstici.
  • 8%; 17 %...92% , 100 %: večja kot je izbrana vrednost, večja je širina polja za vnos besedila.

Primer

  • Če želite, da se vnosni del prikaže pod podvprašanjem/oznako, na spustnem seznamu izberite možnost 100 %.


Vedno skrij to vprašanje (skrito)

Opis

Če je omogočeno, bo vprašanje vedno skrito – ne bo prikazano udeležencem ankete. To funkcijo je mogoče uporabiti v naslednjih scenarijih:

  • Če želite vprašanje vnaprej izpolniti z URL-jem in ne želite, da se prikaže na zaslonu. To preglasi vse pogoje, uporabljene v anketi, ker zadevno vprašanje sploh ne bo vdelano na stran.
  • Če želite sproti shraniti ali izračunati vrednost prek ExpressionScript - Presentation.
Opomba: Pogosta vrsta vprašanja, ki se uporablja s to funkcijo, je Equation.

'Razpoložljive možnosti

  • Vklopljeno
  • Izklopljeno (privzeto)



Največje število znakov (maximum_chars)

Opis

To vam omogoča, da nastavite največje število znakov, ki jih lahko vnesete za besedilno vprašanje. Vnos vrednosti, na primer 20, pomeni, da udeleženec ne more vnesti več kot 20 znakov.

'Veljavne vrednosti

  • Katera koli cela vrednost nad 0



Ime naključne skupine (random_group)

Opis

Vprašanja postavi v določeno naključno skupino, pri čemer so vsa vprašanja, vključena v navedeno skupino, prikazana v naključnem vrstnem redu anketirancem.

V ExpressionScript sample survey lahko najdete vzorec ankete z imenom skupine za naključno izbiranje.

Veljavne vrednosti

Samo vnesite poljuben niz (na primer: 'group1'). Vsa vprašanja, ki so v polju 'ime skupine za naključno izbiro nastavili isti niz, bodo imela svoje mesto v anketi randomizirana (=naključno izmenjana med seboj).


Predogled Za predogled vprašanj uporabite predogled ankete namesto funkcije predogled skupine vprašanj, saj so poročali, da druga ne prikazuje vprašanj v naključnem vrstnem redu.



Uporabi kartografsko storitev (location_mapservice)

Opis

Če je ta možnost aktivirana, bo vrsta vprašanja s prostim besedilom anketirancem prikazala zemljevid in ne polje z besedilom (obojega ni mogoče uporabiti hkrati).

'Razpoložljive možnosti

  • Izklopljeno (privzeto)
  • OpenStreetMap prek MapQuest
  • Google Maps


Template:Opozorilo


Template:Opomba


'Napredno


Template:Opomba




IP kot privzeta lokacija (location_defaultfromip)

Opis

Če je omogočeno, mora privzeti položaj na zemljevidu temeljiti na naslovu IP uporabnika.

Da bo to delovalo, morate nastaviti veljaven ključ v IP Info DB API Key.

'Razpoložljive možnosti

  • Da (privzeto)
  • Ne



Shrani državo (location_country)

Opis

Če je omogočeno, bodo podatki o državi shranjeni v tabeli rezultatov ankete. Uporabno samo z google map in veljavnim google map API ključem.

'Razpoložljive možnosti

  • Da
  • Ne (privzeto)



Shrani mesto (location_city)

Opis

Če je aktivirana, bodo informacije o mestu shranjene v tabeli rezultatov ankete. Uporabno samo z Google Zemljevidi in veljavnim ključem API za Google Zemljevide.

'Razpoložljive možnosti

  • Da
  • Ne (privzeto)



Shrani stanje (location_state)

Opis

Če je aktivirana, bodo informacije o stanju shranjene v tabeli rezultatov ankete. Uporabno samo z Google Zemljevidi in veljavnim ključem API za Google Zemljevide.

'Razpoložljive možnosti

  • Ne (privzeto)
  • Da



Shrani poštno številko (location_postal)

Opis

Omogočite to možnost, če želite, da se poštna številka shrani v tabeli rezultatov ankete. Uporabno samo z google map in veljavnim google map API ključem.

'Razpoložljive možnosti

  • Da
  • Ne



Privzeti položaj (location_defaultcoordinates)

Opis

Tukaj vnesite zemljepisno širino in dolžino, kjer bo zemljevid ob nalaganju osredotočen.

Primer

Širina [prostor] dolžina: 52,1605 9,8438



Stopnja povečave (location_mapzoom)

Ta možnost omogoča skrbniku ankete, da nastavi stopnjo povečave za zemljevid.

'Veljavne vrednosti

  • Najmanjša vrednost, ki jo lahko vstavite, je 0, največja pa 11.

Primer

Spodnja slika prikazuje zemljevid velikosti 500 x 300 z uporabo stopnje povečave = 5:

Datoteka:map_zoom_level.png



Širina zemljevida (location_mapwidth)

V tem polju nastavite širino zemljevida v slikovnih pikah. Privzeta vrednost je 500 slikovnih pik.



Višina zemljevida (location_mapheight)

V tem polju nastavite višino zemljevida v slikovnih pikah. Privzeta vrednost je 300.



Samo številke (samo številke)

Opis

Če omogočite to možnost, lahko udeleženec vnaša samo številke v besedilna polja.

Za vrste vprašanj z enačbo ta nastavitev nakazuje, da je lahko rezultat samo število, ne pa niz. To bo zagotovilo pravilne izračune/pretvorbe v nadaljnjih enačbah glede decimalne oznake.

Vedenje glede na vrsto vprašanja

  1. Privzeto: Če subjekt vnese vrednost, ki ni številka, se ta vrednost takoj počisti iz besedilnega polja, tako da subjekt lahko vnese ustrezno vrednost.
  2. Array (Texts): Če je možnost samo številke onemogočena, bosta možnosti "Prikaži vsote za" in "Prikaži skupno vsoto" preglasovani, medtem ko skupna besedilna polja ne bodo prikazana.
  3. Enačba: Če omogočite to možnost, bodo rezultati enačbe pretvorjeni v številsko vrednost. Če rezultat enačbe ni število (in ni prazno), bo enačba vrnila NaN in bo shranjena kot prazen niz v tabeli odgovorov.

'Razpoložljive možnosti

  • Vklopljeno
  • Izklopljeno (privzeto)


Vstavi prelom strani v pogledu za tiskanje (page_break)

Opis

Ta atribut je aktiven le, ko dejansko natisnete anketo iz »Pogleda za tiskanje«. Vsili prelom strani pred vprašanjem.

Razpoložljive možnosti

  • Vklopljeno
  • Izklopljeno (privzeto)


Časovna omejitev (time_limit)

Opis

Nastavitev atributa time_limit za vprašanje bo povzročila, da bo odštevalnik začel odštevati takoj, ko se to vprašanje/stran naloži. Po izteku odštevalnika se bo vprašanje samodejno premaknilo na naslednjo stran ali pa bo postalo samo za branje.

'Veljavne vrednosti

  • Katero koli pozitivno celo število

Primer

Nastavite na 240 za odštevanje od 4 minut (240 sekund).


<onlyinclude>

Dejanje časovne omejitve (time_limit_action)

Opis


Nastavi dejanje, ki se izvede, ko time_limit poteče. Privzeto je dejanje za časovno omejitev »Opozori in pojdi naprej«, kar pomeni, da bo sistem izdal kratko opozorilo, da je časovna omejitev potekla, preden shrani vprašanje in dejansko samodejno klikne »Naprej >>«. Nadomestne možnosti so:

  • »Naprej brez opozorila«, ki samodejno klikne gumb »Naprej >>«, ko se časovnik konča, vendar brez kakršnega koli opozorilnega sporočila.
  • »Samo onemogoči«, ki onemogoči spremembe v vprašanju, tako da udeleženec ne more ničesar spremeniti, vendar samodejno ne klikne gumba »Naprej >>«.

Ta nastavitev je uporabna le, če je aktivirana splošna nastavitev časovna omejitev.

'Razpoložljive možnosti

  • Opozori in pojdi naprej (privzeto): udeleženca bo opozoril, da je čas potekel, nato pa kliknil gumb Naprej
  • Nadaljuj brez opozorila: takoj kliknil Naslednji gumb po poteku časovne omejitve
  • Samo onemogoči: onemogoči odgovor po poteku časovne omejitve, vendar ne bo samodejno kliknil naprej


Dodatne informacije


  Pozor : Če je vprašanje obvezno ali je vprašanje v skupini obvezno, bo ustvarjena zanka JavaScript, če na obvezno vprašanje(a) ni odgovor(a). Posledično se bo na zaslonu izpisala napaka, da določena vprašanja niso bila izpolnjena, kar bo sprožilo osvežitev strani.
Namesto da bi se zanašali na obvezna vprašanja, lahko uporabite izraze (preberite več o vprašanju in podvprašanju validacijskih enačbah), da uporabnik ne polja za odgovore pustite prazna. Če si želite ogledati, kako delujejo validacijske enačbe, preverite naslednji primer.



V primeru, da želite uporabiti časovnik za skupino vprašanj, aktivirajte način anketiranja po skupinah, nastavite vprašanje za uporabo funkcije časovne omejitve in izberite možnost opozorila in nadaljevanja (privzeto) kot dejanje časovne omejitve. Ko poteče časovnik za vprašanja, se anketa premakne na naslednjo stran.


Kategorija:Nastavitve vprašanjKategorija:Možnosti časovnika vprašanj


Naslednje onemogočanje časovne omejitve (time_limit_disable_next)

Opis

Omogoča onemogočanje gumba "naprej", medtem ko poteka odštevanje časovne omejitve. Običajno lahko udeleženec, tudi če je odštevanje časovne omejitve aktivno, klikne »Naprej« in se premakne na naslednje vprašanje ali skupino vprašanj, preprosto klikne gumb »Naprej« (tako skrajša čas, porabljen za vprašanje ali skupina vprašanj). Če aktivirate to funkcijo, bo naslednji gumb zatemnjen in ne bo na voljo, dokler se odštevalnik ne konča.

Ta nastavitev je uporabna le, če je aktivirana splošna nastavitev časovna omejitev.

'Razpoložljive možnosti

  • Vklopljeno - gumb "Naprej" bo onemogočen, dokler se odštevanje časovne omejitve ne konča.
  • Izklopljeno (privzeto)
Datoteka:help.png Opomba: Če vaša anketa uporablja oblik po skupinah, ta funkcija velja za celotno skupino, ki ji to vprašanje pripada.



Onemogoči časovno omejitev prej (time_limit_disable_prev)

Opis

Omogoča onemogočanje gumba »prejšnji«, medtem ko poteka odštevanje časovne omejitve. Običajno, tudi če je odštevanje časovne omejitve aktivno, če želi udeleženec klikniti »Prejšnje« in se premakniti na prejšnje vprašanje ali skupino vprašanj, lahko preprosto klikne gumb »Prejšnje« (tako skrajša čas, porabljen za vprašanje ali skupina vprašanj). Če aktivirate to funkcijo, bo prejšnji gumb prikazan sivo in ne bo na voljo, dokler se odštevalnik ne konča.

Ta nastavitev je uporabna le, če je aktivirana splošna nastavitev časovna omejitev.

'Razpoložljive možnosti

  • Vklopljeno - gumb »Prejšnji« bo onemogočen, dokler se odštevanje časovne omejitve ne zaključi.
  • Izklopljeno (privzeto)
Datoteka:help.png Opomba: Če vaša anketa uporablja format po skupinah, ta funkcija velja za celotno skupino, ki ji to vprašanje pripada.



Sporočilo o odštevanju časovne omejitve (time_limit_countdown_message)

Opis

V to polje vpišite besedilno sporočilo, za katerega želite, da se prikaže v odštevalniku med odštevanjem. Ta nastavitev je uporabna le, če je aktivirana splošna nastavitev časovne omejitve. Če ni nič zapisano, bo polje uporabilo privzeto vrednost: "Preostali čas".



Slog CSS časovnika (time_limit_timer_style)

Opis

Omogoča (in preglasi privzeto) oblikovanje css, ki se uporablja za prikaz odštevalnika časa. Privzeta vrednost sloga za ta atribut bo uporabljena, če ne obstaja, kar je: 'width: 150px; rob-levo: samodejno; rob-desno: samodejno; obroba: 1px polna #111; poravnava besedila: sredina; barva ozadja: #EEE; rob-spodaj: 5px; velikost pisave: 8pt;'.

Vsako besedilo, vneseno v ta atribut, bo prepisalo celoten privzeti slog css, zato poskrbite, da bodite previdni pri vnosu vrednosti za ta atribut. Preprost način, da to skrijete, je, da kopirate privzeti slog v ta atribut in dodate 'display: none;' do konca.

Ta nastavitev je uporabna le, če je aktivirana splošna nastavitev časovne omejitve.



Čas prikaza sporočila o izteku časovne omejitve (time_limit_message_delay)

Opis

Ta atribut določa, koliko sekund je time_limit_message prikazano, preden pride do time_limit_action. Če ta atribut ni nastavljen, je privzeta vrednost 1 (1 sekunda).

Ta nastavitev je uporabna le, če so aktivirane splošne nastavitve časovne omejitve.

Primer

time_limit_message_delay: 5 = sporočilo se prikaže 5 sekund



Sporočilo o izteku časovne omejitve (time_limit_message)

Opis

To je besedilo sporočila, ki se prikaže udeležencu, ko poteče time_limit'. Privzeto je to sporočilo »Vaš čas za odgovor na to vprašanje je potekel«. Če je atribut time_limit_action nastavljen na "Nadaljuj brez opozorila", to sporočilo ni prikazano. Slog CSS za to besedilo lahko nastavite v atributu time_limit_message_style (glejte spodaj).

Ta nastavitev je uporabna samo, če so aktivirane splošne nastavitve časovne omejitve.

Primer

time_limit_message: Časovna omejitev za odgovor na to vprašanje je zdaj potekla.



Slog CSS sporočila o časovni omejitvi (time_limit_message_style)

Opis

Omogoča (in preglasi privzeto) oblikovanje css, ki se uporablja za prikaz sporočila o časovni omejitvi. Privzeta vrednost sloga za ta atribut bo uporabljena, če ne obstaja, kar je: 'top: 10px; levo: 35 %; širina: 30 %; višina: 60px; oblazinjenje: 16px; obroba: 8px polna #555; barva ozadja: bela; z-indeks: 1002; poravnava besedila: sredina; overflow: auto'.

Vsako besedilo, vneseno v ta atribut, bo prepisalo celoten privzeti slog css, zato poskrbite, da bodite previdni pri vnosu vrednosti za ta atribut. Močno priporočamo, da ponovno uporabite vrednost z-indeksa ali da je vsaj vrednost z-indeksa višja od tiste, ki se uporablja za atribut time_limit_warning_message_style (ki je privzeto 1001).

Primer

Nastavi na: top: 10px; levo: 35 %; širina: 30 %; višina: 60px; oblazinjenje: 16px; obroba: 8px polna #555; barva ozadja: črna; barva: bela; z-indeks: 1010; poravnava besedila: sredina; preliv: avto



Časovnik opozorilnega sporočila o časovni omejitvi (time_limit_warning)

Opis

S pomočjo tega atributa lahko nastavite čas (v sekundah), ko bo prikazano time_limit_warning_message preden poteče time limit'. Nastavitev vrednosti za ta atribut aktivira opozorilno sporočilo o časovni omejitvi.

Ta nastavitev je uporabna le, če je aktivirana splošna časovna omejitev. Ta nastavitev obstaja tudi za drugo opozorilno sporočilo.

Primer

Če to nastavite na '20', se bo opozorilno sporočilo o časovni omejitvi pojavilo 20 sekund preden odštevanje časovne omejitve doseže nič.



Čas prikaza opozorilnega sporočila o časovni omejitvi (time_limit_warning_display_time)

Opis

Določa, kako dolgo je opozorilno_sporočilo o časovni omejitvi prikazano, preden se odstrani/skrije z zaslona. Če se prikaže opozorilno_sporočilo o časovni omejitvi, bo privzeto ostalo vidno, dokler odštevalnik ne zaključi odštevanja. Če je v to polje vnesena vrednost večja od nič, bo sporočilo po toliko sekundah skrito.

Ta nastavitev je uporabna le, če je aktivirana splošna nastavitev časovne omejitve. Ta nastavitev obstaja tudi za drugo opozorilno sporočilo.

Primer

time_limit_warning_display_time: 10 = Opozorilno sporočilo o časovni omejitvi bo izginilo 10 sekund po trenutku, ko se prikaže.



Opozorilno sporočilo o časovni omejitvi (time_limit_warning_message)

Opis

Če je nastavljen, prikaže besedilo opozorilnega sporočila, ki je prikazano za določeno časovno obdobje pred potekom časovne omejitve. Privzeto besedilo je "Vaš čas za odgovor na to vprašanje je skoraj potekel. Imate še {TIME}." {TIME} je nadomeščen z oblikovanim opisom, ki predstavlja količino preostalega časa (tj. "30 sekund", "1 minuta ali 5 sekund"). To sporočilo se prikaže le, če obstaja atribut time_limit_warning. Iz atributa time_limit_warning lahko nastavite, kdaj se pojavi sporočilo (time_limit_warning_message).

Ta atribut vprašanja je uporaben samo, če je aktivirana nastavitev časovne omejitve in nastavite nekaj besedila v opozorilnem sporočilu o časovni omejitvi. Ta nastavitev obstaja tudi za drugo opozorilno sporočilo.

Primer

Pozor: čez {TIME} bo potekel rok za odgovor na vprašanje.



Time limit warning CSS style (time_limit_warning_style)

Description

It allows (and overrides the default) css styling used to display the time limit warning message. The default style value for this attribute will be used if it does not exist, which is: 'top: 10px; left: 35%; width: 30%; height: 60px; padding: 16px; border: 8px solid #555; background-color: white; z-index: 1001; text-align: center; overflow: auto'.

Any text entered into this attribute will overwrite the entire default css style for the warning message, so you should ensure that care is taken when entering a value for this attribute. It is strongly recommended that you re-use the z-index value, or that, at least, the z-index value be lower than that used for the time_limit_message_style attribute (which defaults to 1002).

This settings is only applicable if the general time limit setting is activated. This setting also exists for a second warning message.

Example

top: 10px; left: 35%; width: 30%; height: 60px; padding: 16px; border: 8px solid #555; background-color: gray; color: white; z-index: 1001; text-align: center; overflow: auto



Question validation equation (em_validation_q)

Description

This is an equation that is used to validate the entire question (e.g, all of its parts collectively for a multi-answer question). If the question fails the validation criteria, then em_validation_q_tip message will be displayed (it uses the CSS style .error). This tip uses the .em_q_fn_validation CSS style, which is hidden by default within template.css.

The main difference between this feature and the subquestion validation equations (em_validation_sq option) is that for this feature, if the question (or question parts) fail validation, then an error message could be shown. For the subquestion validation, each text entry cell (e.g., in an array question type, but it can also be applied to single entry question types) will be styled so that the background color is (light) red.

Valid values

  • Any equation that makes use of the ExpressionScript syntax, without surrounding curly braces.

Example

  • You want to collect demographic information from users via a multiple short text question, and you want to validate that the user has entered a valid email address and phone number.

This example shows how the question looks with invalid answers:

And here is what it looks like with one invalid answer:

Here is how you edit a question to enter that information:

And here is part of the Show Logic File output that lets you check the accuracy of your expression and ensure that there are no syntax errors:

As you can see, the validation equation tests that both the email and phone number are either empty or match a regular expression filter.

The validation tip only shows the warning message if the phone or email appears invalid.

 Hint: In order to create complex validation messages, read about the usage of the ExpressionScript.


If you wish to import the example from above into your LimeSurvey installation, download the following .lsq file: Em_validation_q_example.zip.

 Hint: Remember, LimeSuvey uses the Perl syntax for regular expressions, so they should start and end with / (slash character)!



Tip for whole question validation equation (em_validation_q_tip)

Description

If you are using the question validation equation, you can use this box in order to display an optional message as question tip on how the question has to be filled out.

Valid values

Example

See the example from the question validation equation wiki section- it shows how the tip can be tailored to show which parts of a multiple short text question fail the validation criteria.



Sub-question validation equation (em_validation_sq)

Description

This is an equation that is used to validate each subquestion (text field) individually. Any text field that does not pass these validation conditions will have its background color turned pink (using the .em_sq_fn_validation CSS style) to highlight the error. Note that this is available in addition to the regular expression-based validation option.

Valid values

Any equation that makes use of the ExpressionScript syntax, without surrounding curly braces.

Examples

For example, if you want to allow only numbers that are a multiple of 3 as answers, the equation would be:

(this / 3) == floor(this/3)

The reserved variable this is automatically replaced by a reference to the active text entry cell.



Tip for sub-question validation equation (em_validation_sq_tip)

Description

If you are using em_validation_sq, this is an optional message/tip that will be displayed if the introduced answer is incorrect.

Valid values

  • Any string

Example

  • Continuing the example of validating emails, the tip might be "Please enter valid email addresses."