Upravljalnik izrazov
From LimeSurvey Manual
Vodnik za hitri začetek
Pregled
Ko prilagajate svoje ankete, običajno potrebujete način, da določite naslednje:
- Navigacija/Razvejanje – dovolite, da odgovori subjekta spremenijo vrstni red zastavljenih vprašanj
- 'Tailoring/ Piping - kako ubesediti vprašanje (na primer sklicevanje na prejšnje odgovore ali spreganje stavkov glede na število ali spol vaših predmetov) ali kako ustvariti poročila po meri (kot so rezultati ocenjevanja ali prilagojeni nasveti).
#'Validacija – zagotavljanje, da odgovori izpolnjujejo določena merila, kot so najmanjše in največje vrednosti, ali ujemanje z vnosnim vzorcem
Expression Manager (EM) ponuja intuitiven način za določanje logike za vsako od teh funkcij. Skoraj vse, kar lahko zapišete kot standardno matematično enačbo, je veljaven izraz, tudi če kličete funkcije. EM trenutno omogoča dostop do 80 funkcij in ga je mogoče enostavno razširiti, da podpira več. Omogoča tudi dostop do vaših spremenljivk z uporabo človeku berljivih imen spremenljivk (namesto imen SGQA).
Naslednji razdelki prikazujejo glavna mesta, kjer se uporablja Expression Manager
Nekatere ankete uporabljajo "Pojdi na logiko", tako da če odgovorite na vprašanje 1 z možnostjo C, potem skočite na vprašanje 5. Ta pristop je zelo omejujoč, saj ga je težko preveriti in se zlahka prekine, ko morate preurediti vprašanja. EM uporablja Boolovo relevantno enačbo za določanje vseh pogojev, pod katerimi bi lahko bilo vprašanje veljavno. Če je vprašanje relevantno, se prikaže vprašanje, sicer ni uporabno, vrednost NULL pa je shranjena v bazi podatkov. To je podobno tistemu, kar lahko storite prek urejevalnika pogojev, vendar vam EM omogoča enostavno določanje veliko bolj zapletenih in zmogljivih kriterijev (in omogoča uporabo imena spremenljivke namesto poimenovanja SGQA).
Ta slika prikazuje en način za pregled logike ustreznosti za anketo. Izračunava indeks telesne mase. Enačba ustreznosti je prikazana v oglatem oklepaju takoj za imenom spremenljivke (ki je zelene barve). Torej je ustreznost teže, teže_enot, višine in višine enot 1, kar pomeni, da so ta vprašanja vedno postavljena. Vendar pa je relevantnost za ITM {!is_empty(height) in !is_empty(weight)}, kar pomeni, da bo ITM izračunan samo, če subjekt vnese vrednost za višino in težo (s čimer se izognemo tveganju deljenja z ničlo napaka). Poleg tega je vprašanje Poročilo prikazano samo, če preiskovanec odgovori na vsa štiri glavna vprašanja (višina, višina_enote, teža, teže_enote).
Ustreznost je prikazana in jo je mogoče urejati na naslednjih mestih:
Ogled/urejanje Ustreznost na ravni vprašanja
Ta enačba izračuna indeks telesne mase (ITM). Vpraša se le, ali oseba najprej vnese svojo višino in težo.
To je zaslon za urejanje vprašanja ITM.
Upoštevajte, da ne uporabite zavitih oklepajev, ko vnašate enačbo ustreznosti.
Ogled/urejanje ustreznosti na ravni skupine
To je vzorčna popisna raziskava. Prva stran vpraša, koliko ljudi živi z vami, in to shrani v spremenljivko "cohabs". Ta stran je prikazana samo, če imate več kot enega sostanovalca (torej je prikazana za drugo osebo, ki živi z vami), prav tako pa je prikazana samo, če ste navedli, kako je oseba ena povezana z vami (p1_rel).
Kot lahko vidite, ima skupina tudi kriterije ustreznosti na ravni vprašanja, tako da se vsako vprašanje pojavi šele, ko odgovorite na vprašanje pred njim (npr. {!is_empty(p1_sex)}). EM za vas združuje ustreznost na ravni skupine in vprašanja. Vprašanja v skupini se zastavljajo samo, če je pomembna skupina kot celota. Nato se zastavi samo podmnožica vprašanj znotraj skupine, ki so pomembna.
Tukaj je zaslon za urejanje ustreznosti na ravni skupine za to vprašanje:
Upoštevajte, da ne uporabite zavitih oklepajev, ko vnašate enačbo ustreznosti.
Krojenje/Piping
EM vam omogoča preprosto in zapleteno pogojno prilagajanje vaših vprašanj. Včasih potrebujete preprosto zamenjavo, na primer: "Rekel si, da si kupil [ Izdelek]. Kaj vam je bilo pri tem najbolj všeč?". Včasih potrebujete pogojno zamenjavo, kot je " [ Gospod Gospa.] [ Priimek], bi bili pripravljeni izpolniti našo anketo?". V tem primeru želite uporabiti g. ali gospa glede na spol osebe. Drugič potrebujete še bolj zapleteno zamenjavo (na primer na podlagi matematičnega izračuna) EM podpira vsako od teh vrst krojenja/cevovodov.
Pogojne enačbe
Primer indeksa telesne mase prikazuje zmožnost izračuna ITM osebe, čeprav ji dovolite, da svojo višino in težo vnese v metričnih ali nemetričnih enotah.
Tu je weight_kg {if(weight_units == 'kg', teža, teža * .453592)}. Ta funkcija if() pomeni, da če je subjekt vnesel težo v kilogramih, uporabite to vrednost, sicer pomnožite vneseno vrednost (ki je bila v funtih) z 0,453592, da jo pretvorite v kilograme. Spremenljivka height_m uporablja podoben pristop za izračun višine osebe v metrih, tudi če je vnesla svojo višino v palcih.
ITM izračuna formulo teže kot {teža_kg / (višina_m * višina_m)}.
Nazadnje poročilo pogojno prilagodi sporočilo subjektu in mu pove, kaj je vnesel. ("Rekli ste, da ste visoki 2 metra in težki 70 kg.")
Čeprav na zgornji sliki ni dobro prikazano, weight_status uporablja ugnezdene stavke if(), da kategorizira osebo kot prenizko telesno težo do zelo debelo. Njegovo enačbo si lahko ogledate v prikazu Logic View
V oknu za urejanje tega vprašanja lahko vidite dve stvari:
- Tailoring mora obdati izraze z zavitimi oklepaji
- Izrazi lahko zajemajo več vrstic, če želite, kot v tem primeru, olajšati branje ugnezdena pogojna logika.
Prilagojena vprašanja, odgovori in poročila
Ta primer prikazuje poročilo ITM.
Tukaj je okno za urejanje istega vprašanja.
Kot lahko vidite, je vse v zavitih oklepajih obravnavano kot izraz, zato je sintaksa poudarjena (barvno kodirana) na prejšnji sliki. Če bi imeli kakršne koli tipkarske napake (na primer napačno črkovana ali nedefinirana imena ali funkcije spremenljivk), bi EM prikazal napako, kot je ta, ki kaže, da je height_unit nedefinirano ime spremenljivke (pravzaprav je height_units), rnd() pa je nedefinirana funkcija (pravilno ime funkcije je round()). V obeh primerih so napake obdane z rdečim poljem, da jih lažje opazimo in odpravimo.
Opazite lahko tudi, da lahko hitro ustvarite kompleksna poročila, kot je tabela vnesenih vrednosti ali prilagojeni nasveti.
Zapomnite si, da mora vsako prilagajanje obdati izraze z zavitimi oklepaji, tako da LimeSurvey ve, kateri deli vprašanja so prosto besedilo in katere je treba razčleniti z upraviteljem izrazov.
Potrjevanje
EM nadzoruje, kako deluje večina naprednih možnosti vprašanj. Ti nadzorni vidiki, kot so najmanjše/največje število odgovorov; min/max posamezne vrednosti; min/max vsota vrednosti; in preverjanje, ali se vnesene vrednosti ujemajo z določenimi vzorci nizov. Še naprej vnašate te napredne možnosti vprašanj kot običajno. Vendar pa se zdaj katera koli vrednost v enem od teh polj šteje za izraz, tako da lahko imate minimalna/največja merila s kompleksnimi pogojnimi razmerji do drugih vprašanj.
V vseh teh primerih, ker se možnost naprednega vprašanja vedno obravnava kot izraz, pri določanju ne uporabite zavitih oklepajev.
Strani Vzorčne ankete prikazujejo številne delujoče primere uporabe izrazov za validacije.
Uvod
LimeSurvey uporablja nov modul Expression Manager (EM), ki bo LimeSurveyju omogočil podporo za bolj zapleteno razvejanje, ocenjevanje, validacijo in prilagajanje. Zamenjal bo način, kako LimeSurvey upravlja zamenjave, pogoje in ocene v ozadju. Prav tako bo znatno pospešil obdelavo, saj odpravlja večino branj baze podatkov med izvajanjem. EM je razvil dr. Thomas White (TMSWhite).
Ta stran wiki je dokončna referenca za sintakso in funkcionalnost Expression Managerja.
Ključne definicije
- Izraz': Vse, kar je obdano z zavitimi oklepaji
- Dokler ni praznega prostora takoj za začetnim oklepajem ali pred zaključnim zavitim oklepajem
- Vsebino izrazov ovrednoti EM, tako da lahko vsebujejo matematične formule, funkcije ter zapleteno obdelavo nizov in datumov.
- 'Krojenje': včasih imenovano "cevovod", je to proces pogojno spreminjanje besedila
- Imate dostop do vseh 'nadomestnih polj', podatkov o udeležencih in podatkov o odzivih.
- Imate tudi lažji dostop do vprašanj, odgovorov in njihovih lastnosti.
- Enačba 'Relevantnost': nov atribut vprašanja, ki nadzoruje vidnost vprašanja
- Če obstaja enačba relevantnosti, potem je vprašanje prikazano le, če je relevantnost ocenjena kot res.
- Interno, vsi array_filter in array_filter_exclude ukazi postanejo relevantni na ravni podvprašanja
- Equation Vrsta vprašanja: Nova vrsta vprašanja, ki shranjuje izračune ali poročila v zbirko podatkov
- Je kot vprašanje Boilerplate, vendar se njegova vsebina shrani v baze podatkov, tudi če nastavite "Vedno skrij to vprašanje"
- Koda vprašanja: To je prednostno ime spremenljivke za EM
- To je lahko opisno ime, ki označuje namen vprašanja , kar olajša branje zapletene logike
- Veljavne kode vprašanj se NE smejo začeti s številko, zato, ko uporabljate kodo vprašanja za oštevilčenje vprašanj, preprosto uporabite »q1«, »q1a« ali »g1q2«.! N!#*To je tisto, kar trenutno postane ime spremenljivke, če izvozite podatke v SPSS ali R, tako da, če izvajate statistično analizo, ste to verjetno že naredili edinstveno.
Ali moram uporabiti EM?
Kratek odgovor je Ne (a tudi da).
EM je popolnoma nazaj združljiv z obstoječimi raziskavami. Če torej z veseljem uporabljate pogoje in ocene v slogu, ki ga je LimeSurvey uporabljal v različicah <= 1.91+, lahko to počnete še naprej.
Vendar pa EM popolnoma nadomesti način, na katerega LimeSurvey interno obravnava pogoje. Čeprav lahko še vedno uporabljate urejevalnik pogojev za ustvarjanje in upravljanje pogojev, jih bo LimeSurvey 1.92 pretvoril v enakovredne enačbe ustreznosti. Kot del nadgradnje bo LimeSurvey 1.92 samodejno pretvoril vse obstoječe pogoje v enačbe ustreznosti.
To bi vam moralo dati najboljše iz obeh svetov – lahko nadaljujete z uporabo LimeSurvey, kot ste navajeni, vendar boste videli ekvivalent Relevance Equation, tako da lahko postopoma preidete neposredno na Relevance Equations, kadar koli se vam zdi primerno.
Ali lahko kombiniram uporabo pogojev in ustreznosti?
ja Za nekatera vprašanja lahko uporabite urejevalnik pogojev, za druga pa urejevalnik ustreznosti. Ko shranite vprašanje, se pogoji samodejno pretvorijo v ustreznost.
Upoštevajte, da predpostavljamo, da če uporabljate urejevalnik pogojev, želite, da ti pogoji prepišejo vsako ročno vneseno enačbo ustreznosti. Torej, če imate obstoječe pogoje in želite ročno urediti ustreznost, najprej izbrišite pogoje za to vprašanje. Natančneje, kopirajte ustvarjeno enačbo ustreznosti v urejevalnik besedil, uporabite meni Pogoji, da izbrišete vse pogoje za to vprašanje (s čimer boste izbrisali tudi ustreznost), nato uredite vprašanje in prilepite ustvarjeno enačbo ustreznosti iz urejevalnika besedil nazaj v polje ustreznosti za to vprašanje (in shranite vprašanje). Če obstaja dovolj povpraševanja po izbrisu pogojev brez izbrisa ustvarjene enačbe pomembnosti, lahko dodamo postopek množične pretvorbe.
Kako naj izbiram med pogoji in ustreznostjo?
Tukaj je seznam prednosti in slabosti vsakega sloga:
Slog | Prednosti | Slabosti |
---|---|---|
Pogoji | 1. Lep GUI za ustvarjanje preprostih pogojev 2. GUI je dobro dokumentiran in ga razume skupina za podporo |
1. Podpira samo preproste primerjave in ne pogojuje dobro IN/ALI 2. Kaskadni pogoji delujejo neredno 3. Počasen - podatkovna baza je intenzivna, zato lahko upočasni dolge ankete 4. Nekateri so poročali o težavah s pogoji ponovnega nalaganja 5. GUI se ne prilagaja dobro, če je vprašanj na desetine, stotine ali tisoče 6. Pretvorba anket v papirni obliki je morda počasna, ker morajo uporabljati imena SGQA 7. Pogosto potrebujejo programerja za kodiranje logike po meri, potrebne za kompleksno razvejanje |
Ustreznost | 1. Podpira zelo kompleksno logiko, vključno z 80+ funkcijami in matematičnimi/niznimi operaterji 2. Popolna podpora za kaskadno logiko 3. Hitro – brez dodatnih klicev baze podatkov, zato podpira 1000+ anket z vprašanji 4. Brez težav z logiko ponovnega nalaganja, saj ne zahteva kod SGQA 5. Označevanje sintakse meri na 1000+ anket z vprašanji 6. Enostaven in hiter za uporabo za skupine, ki želijo računalniško obdelati obstoječe papirnate ankete. 7. Preprosto podpira polstrukturirane intervjuje in epidemiološke raziskave, ne da bi potrebovali programerje |
1. Brez GUI za preproste pogoje - namesto tega uporabite označevanje sintakse 2. Novo, zato podporne ekipe še niso obvladale EM. |
Bistvo je, da če ste zadovoljni z delovanjem LimeSurvey 1.91+, ni razloga, da bi spreminjali svoje početje.
Katere so druge prednosti uporabe EM?
Tukaj je nekaj drugih razlogov, zakaj bi morda želeli uporabiti EM.
- Izračuni - ustvarite lahko poljuben izračun, ki vam pade na pamet:
- Imate dostop do vseh običajnih matematičnih operatorjev in funkcij
- Imate dostop do 70+ matematičnih funkcij, funkcij za obdelavo datumov in nizov
- Razvijalcem je dokaj enostavno dodati nove funkcije, če jih uporabniki potrebujejo
- Shranjevanje izračunov v zbirko podatkov
- Zdaj lahko izračunate preproste in zapletene izračune in/ali ocene na lestvici IN jih shranite v zbirko podatkov, ne da bi potrebovali JavaScript.
- Za to uporabite vrsto vprašanja Equation.
- Ocene
- Zdaj lahko ustvarite ocene ali lestvice rezultatov iz katere koli vrste vprašanja, ne samo iz podmnožice, ki je bila prej podprta
- Uporabite lahko prilagoditev za prikaz tekočih ali skupnih rezultatov ocenjevanja, kjer koli je to potrebno – tudi na isti strani
- Imate več nadzora nad poročili, ustvarjenimi na podlagi teh ocenjevalnih rezultatov
- Ocenjevalne rezultate lahko shranite v bazo podatkov, ne da bi potrebovali JavaScript
- Ocenjevalne rezultate lahko skrijete, ne da bi potrebovali JavaScript ali CSS
- Nadomestna polja
- *Namesto uporabe {INSERTANS:SGQA} lahko uporabite samo kodo vprašanja - to olajša branje in preverjanje.
- S tem se tudi izognete pogosti potrebi po urejanju vprašanj za spreminjanje kode SGQA, da bo vse delovalo .
- Prilagoditev - besedilo lahko pogojno prikažete na podlagi drugih vrednosti
- Uporabite ustrezen naslov za zadevo, na primer (npr. »Pozdravljeni [ G./Mrs.] Smith")
- Izdaj slovnično pravilne stavke, ki temeljijo na ednini/množini: (npr. "Imaš 1 otroka" proti "Imaš 2 otroka")
- Ustrezno spreženi glagoli in zaklanjajte samostalnike glede na spol in množino osebka.
- Novi atributi spremenljivk - za prilagajanje lahko dostopate do naslednjega:
- (brez pripone) - vzdevek za qcode.code
- . koda - izbrana koda odgovora na vprašanje, če je relevantno (sicer prazno), ali besedilna vrednost, če ni kodirano vprašanje
- .NAOK - enako kot .code, vendar je lahko del izračunov ali seznamov tudi če je nepomembno
- .value - vrednost ocene za vprašanje, če je relevantno (sicer prazno), ali besedilna vrednost, če ni kodirano vprašanje -- na voljo, če so ocene omogočene za anketo, sicer vedno zero
- .valueNAOK - enako kot .value, vendar je lahko del izračunov ali seznamov, tudi če ni pomembno
- .shown - odgovor, kot je prikazan uporabniku (to počne {INSERTANS:xxx} )
- .qid - ID vprašanja
- .gid - ID skupine
- .sgqa - vrednost SGQA za vprašanje
- .jsName - pravilno ime spremenljivke javascript za vprašanje, ne glede na to, ali je definirano na tej ali drugi strani
- .qseq - zaporedje vprašanj (začenši z 0)
- .gseq - zaporedje skupine (začenši z 0)
- . obvezno - ali je vprašanje obvezno (Y/N)
- .question - besedilo vprašanja
- .relevance - enačba relevantnosti za vprašanje
- .grelevance - enačba relevantnosti za skupino
- .relevanceStatus - ali je vprašanje trenutno relevantno ali ne (logična vrednost (lahko se razlikuje v PHP in JS))
- .type - vrsta vprašanja (koda z enim znakom)!N !#Dinamične spremembe na strani
- Vsa ustreznost, izračuni in prilagajanje delujejo dinamično na strani – tako spremembe vrednosti takoj posodobijo stran
- Vaša vprašanja se torej dinamično pojavljajo/izginejo glede na to, ali so ustrezni
- Vprašanja so tudi dinamično prilagojena glede na odgovore na strani, tako da lahko vidite tekoče vsote, prilagojene stavke in prilagojena poročila.
- Nov zaslon za vnos podatkov
- Poleg uporabe trenutnem sistemu za vnos podatkov, lahko preprosto uporabite Survey-All-In-One.
- To podpira ustreznost in prilagajanje na strani, tako da lahko uradniki za vnos podatkov hitro pregledajo in bodo morali vnesti samo ustrezne odzive
- To je lahko ključnega pomena, če mora vaša oseba za vnos podatkov videti prilagoditev, ki je tudi dinamična.
- Odpravlja potrebo po večini JavaScripta po meri
- EM enostavno podpira zapletene izračune, točkovanje , prilagajanje in pogojna logika.
- Nekatere stvari bodo še vedno potrebovale JavaScript (na primer postavitve po meri in pogojno skrivanje podelementov vprašanj), vendar lahko vaš JavaScript uporablja funkcije EM, tako da lahko dostopate do vprašanj z njihovo Qcode namesto SGQA in dostop do katere koli zgoraj navedene lastnosti vprašanja.
Katere so druge uporabne nove funkcije, ki jih omogoča EM?
Ne glede na to, ali boste še naprej uporabljali urejevalnik pogojev ali ročno sestavljali enačbe ustreznosti, boste prejeli te dodatne prednosti:
- Ustvarite lahko bolj zapletena merila za preverjanje veljavnosti
- Vse napredne atribute vprašanj (kot so max_answers, min_num_value_n, max_num_value) lahko uporablja izraze. Tako je mogoče vaša najmanjša/največja merila preprosto prilagoditi glede na predhodne odgovore, tudi če so na isti strani.
- EM obravnava tudi vsa preverjanja, ki temeljijo na regularnih izrazih, tako da lahko robustno kombinirate preg in enačbo- na podlagi atributov vprašanj.
- Enostavno prerazvrščanje (ali brisanje) vprašanj in skupin
- Pred različico 1.92 niste mogli prerazporediti vprašanj ali skupin, če je LimeSurvey menil, da bi se takšno prerazporejanje lahko pokvarilo pogojih, v katerih so bili uporabljeni. Podobno ne morete izbrisati vprašanj, če so bila od njih odvisna katera koli druga vprašanja.
- Z označevanjem sintakse EM je preprosto videti in potrditi, ali poskušate uporabiti vprašanja, preden so navedena. Tako vam zdaj omogočamo, da vprašanja in skupine preuredite ali izbrišete, kadar koli želite. EM bo posodobil vse označevanje sintakse, da vam bo pokazal morebitne napake.
- Pogled vprašanj za ponovno vrstni red je bil izboljšan za pomoč pri takem pregledu. Zdaj prikazuje enačbo pomembnosti vprašanja in njegovo prilagajanje, tako da lahko takoj vidite, ali katera koli spremenljivka postane rožnata (kar pomeni, da se uporabi, preden se razglasi).
- Navigacijski indeks vprašanj/skupin je vedno na voljo in točen
- Pred različico 1.92 ti indeksi niso bili na voljo, če so bili zapleteni pogoji
- Z EM lahko zagotovimo, da so točni.
- Subjekt lahko celo skoči nazaj na prejšnje vprašanje, spremeni odgovor , nato skočite naprej (ali pošljite)
- Pri skoku naprej bo EM ponovno preveril vsa vmesna vprašanja/skupine.
- Če katero koli vprašanje postane nepomembno, bo v zbirki podatkov razglašeno za NULL. tako da so vaši podatki interno skladni
- Če kakršna koli vprašanja postanejo pomembna ali na novo ne izpolnjujejo obveznih ali pravil preverjanja, se bo EM ustavil na tej strani in prisilil uporabnika, da odgovori na ta vprašanja, preden skoči na končni cilj.
#Samodejna pretvorba pogojev v ustreznost
- Ko nadgradite svojo zbirko podatkov, bodo za vse obstoječe ankete, ki imajo pogoje, ustvarjene enačbe ustreznosti
- Kadar koli uvozite anketo, bodo po potrebi ustvarjene enačbe ustreznosti
- Kadar koli dodate, izbrišete ali spremenite pogoje, bo EM ustvaril ustrezno enačbo ustreznosti.
- Priročno označevanje sintakse
- Ko EM prikaže enačbo pomembnosti, bo prikazal Qcode, tudi če vnesli ste kodo SGQA, saj predvidevamo, da bo to lažje brati.
- Vse spremenljivke so barvno kodirane, da pokažejo, ali so bile deklarirane pred ali za trenutnim vprašanjem (ali pred ali za trenutno skupino). To vam omogoča hitro odkrivanje in popravljanje primerov, ko poskušate uporabiti spremenljivke za ustreznost (vključno z array_filter), prilagajanje ali validacijske enačbe, preden jih objavite.
- Poleg tega, če z miško premaknete nad barvno kodirano spremenljivko , boste videli najpomembnejše metapodatke o tem vprašanju. To vključuje zaporedje skupine #, zaporedje vprašanja #, kodo Q, besedilo vprašanja in vse razpoložljive izbire odgovorov (če gre za vrsto vprašanja z oštevilčenimi možnostmi odgovorov).
- Seznam izbir odgovorov uporablja to sintakso : 'odgovori':{ključ:val, ... }.
- ključ ima sintakso 'lestvica~koda', kjer je lestvica lestvica odgovorov (npr. za dvojno lestvico) in koda je koda odgovora.
- val ima sintakso 'prikazana vrednost', kjer je vrednost vrednost ocene (če uporabljate ocene, drugače koda)(npr. Qcode.value) in prikazano je prikazana vrednost, kot jo vidi subjekt (npr. Qcode.shown)
- To pomeni, da lahko številne raziskave uporabljajo izračune, ne da bi potrebovali način ocenjevanja. Če ste našteli možnosti odgovorov, ki so edinstveni, nedecimalni in nenegativni, lahko preprosto izračunate vrednosti Qcode.code.
- Enostaven pregled celotne logike in vsebine ankete
- Obstaja nova funkcija Prikaži logiko ankete, ki vam omogoča ogled vsega o anketi (ali skupini ali vprašanju) na eni strani.
- Prikaže podrobnosti na ravni skupine, vprašanja, podvprašanja in odgovora za izbran obseg (anketa v primerjavi s skupino v primerjavi z vprašanjem)
- Prikaže tudi ustreznost, ustreznost na ravni podvprašanja (za array_filter in array_filter_exclude) in ustvarjeno validacijsko enačbo (za preg in morebitna validacijska pravila, kot je najmanjša/največja vsota/število vrednosti) in vsi atributi vprašanj, ki niso prazni.
- Vse je skladenjsko označeno, tako da lahko vidite morebitne sintaksne napake (kot so neuravnoteženi oklepaji ali uporaba spremenljivk, preden so bile deklarirane)
- Skladnja- Highligting podpira hitro navigacijo in urejanje ankete.
- Če kliknete ime spremenljivke, se odpre okno brskalnika (ali zavihek), ki vam prikaže to vprašanje in vam omogoča urejanje.
- Če kliknete ime skupine, se odpre okno (ali zavihek) brskalnika, ki prikazuje pogled za preurejanje skupine, tako da lahko preprosto premikate vprašanja.
- Vsi atributi vprašanja so sintaktično označeni. To vam omogoča nastavitev in ogled izrazov v naprednih možnostih vprašanj (na primer določanje največjega/najmanjšega števila/vsote vrednosti na izrazu)
- Avtor EM je uporabil podoben pogled (malo čistejši), da je svojim sodelujočim epidemiologom in institucijam omogočil Nadzorni odbor potrdi in odobri ankete s tisoči vprašanj v zelo razvejanih in prilagojenih strukturiranih intervjujih
Začetek
Najboljši način, da začnete z EM je:
- Namestiti najnovejšo stabilno različico s http://www.limesurvey.org/en/download
- Uvoziti in raziskati vzorčne ankete .
- Raziščite primere uporabe in navodila in primere po korakih.
- Raziščite dokumentacijo EM (ta stran)! N!*Preglejte vgrajeno zbirko testov EM
- V kateri koli anketi pod orodji izberite možnost EM
- Razpoložljive funkcije navajajo 70+ funkcij in sintakso
- Preizkusi enot izoliranih Izrazi
- prikazuje primere uporabe vseh funkcij in operatorjev EM ter rezultatov PHP in JavaScript
- upoštevajte, da obstaja nekaj funkcij, ki ustvarjajo različne rezultate v različicah PHP in JavaScript, zato vam ta stran omogoča ustrezno načrtujte svojo EM logiko.
Katero funkcionalnost razširi/zamenja Expression Manager? (LimeSurvey <= 1,91+)
Pogoji => Ustreznost
Pogoji so nadzorovali, katera vprašanja so vidna. Splošna sintaksa je bila Vrednost operaterja SGQA, na primer 111X2X3 == "Y". Pogoje je bilo mogoče kombinirati z IN ali ALI, vendar je bilo mešanje IN in ALI težko. Sami pogoji so bili shranjeni v ločeni tabeli, velik del kode LimeSurvey pa je bil namenjen upravljanju pogojev. Zaradi obsežnega dostopa do baze podatkov lahko obdelava velikega števila pogojev povzroči opazne težave z delovanjem. Poleg tega, ko so bili vprašanjem ali skupinam dodeljeni pogoji, jih pogosto ni bilo dovoljeno preurediti ali izbrisati.
Ocenjevanja => Enačbe in mikro krojenje
Ocene uporabnikom omogočajo ustvarjanje rezultatov na lestvici iz zbirke vprašanj. Vendar se na trenutni strani niso mogli dinamično spremeniti in njihove vrednosti niso bile shranjene v zbirki podatkov.
Zamenjave => Mikro krojenje
Uporabniki lahko prilagodijo nekatera sporočila in vprašanja na podlagi predhodnih odgovorov. Vprašanje je lahko na primer: »{TOKEN:FIRSTNAME}, rekli ste, da je {INSERTANS:111X3X4} vaš najljubši šport«. Vendar pa ni bilo mogoče izvesti pogojnega prilagajanja (kot recimo »gospod« ali »gospa«, odvisno od spola osebe) ali spregati glagolov ali zavrniti samostalnikov brez modnega JavaScripta. Avtorji so lahko izvajali ankete, za katere se je zdelo, da prilagajajo vprašanja, vendar so zahtevala ločena vprašanja za vsako permutacijo in zapletene pogoje za odločitev, katera vprašanja prikazati.
Potrjevanje
Vprašanje je mogoče potrditi z regularnimi izrazi ali najmanjšimi/največjimi vrednostmi ali pustiti, da odgovor SGQA služi kot najmanjša ali največja vrednost. Vendar validacije ne morejo temeljiti na izračunih drugih spremenljivk brez modnega JavaScripta.
Enačbe
Enačbe niso bile podprte brez modnega JavaScripta.
Enačba Vrsta vprašanja
Enačb ni bilo mogoče shraniti v zbirko podatkov (npr. končnega rezultata za oceno) brez modnega JavaScripta.
Kako bo Expression Manager nadomestil/razširil to funkcionalnost?
Expression Manager je nov osrednji modul znotraj LimeSurvey, ki omogoča veliko lažjo podporo vrsti kompleksne funkcionalnosti, ki je prej zahtevala JavaScript po meri. Prav tako nadomešča način, na katerega LimeSurvey trenutno upravlja pogoje in ocene.
Nova terminologija pri sklicevanju na Expression Manager (EM)
EM "razmišlja" o svoji funkcionalnosti v naslednjih izrazih:
- Relevance-based Branching - če je vprašanje relevantno, ga postavite, sicer ne (npr. naredite ga nevidnega in označite kot NULL v bazi podatkov). Na voljo je novo polje Ustreznost za vse vrste vprašanj in tudi za vsako skupino (tako da lahko nabor pogojev uporabite za celotno skupino, ne da bi morali kopirati isti pogoj za vsako vprašanje in/ali združiti skupino in pogoj na ravni vprašanja logic).
- Tailoring - Ko veste, katera vprašanja je treba postaviti, krojenje (včasih imenovano piping) določa, kako naj se vprašanje postavi. To vam omogoča ne samo podporo preproste zamenjave (kot je {TOKEN:FIRSTNAME}), ampak tudi spreganje glagolov in sklanjanje samostalnikov glede na spol ali število vaših subjektov. Prav tako vam omogoča, da spremenite sporočilo, ki ga pošljete subjektu glede na to, ali je odgovoril (ali kako je odgovoril) na druga vprašanja.
- Equations'' - EM doda novo vrsto vprašanja, imenovano Equation, ki shrani rezultat izraza. Rezultati teh enačb se izračunajo in zapišejo v bazo podatkov, tudi če jih skrijete na strani. Tako so uporabne za skrite izračune točkovanja, navigacijo na podlagi zapletenih enačb, ocene in poročila, ki jih je treba ustvariti in zlahka dostopna v bazi podatkov.
Ustreznost in kaskadna ustreznost
Vsaka vrsta vprašanja ima zdaj možnost Ustreznost, ki nadzira, ali je vprašanje prikazano. EM obdela vsako od enačb ustreznosti v vrstnem redu, v katerem naj bi se pojavile v anketi. Če je izraz resničen (ali manjka – za podporo starim anketam), bo vprašanje prikazano. Če ni relevantno, bo vprašanje skrito, vrednost pa bo v zbirki podatkov označena z NULL. Če v skupini ni ustreznih vprašanj, bo celotna skupina preskočena.
Poleg tega, če je katera od spremenljivk v izrazu nepomembna, potem je izraz vedno ovrednoten kot false. To omogoča kaskadno ustreznost, tako da vam ni treba pisati zelo dolgih enačb ustreznosti za vsako vprašanje.
Recimo, da imate 5 vprašanj Q1-Q5 in želite prikazati samo Q2, če je bil odgovor na Q1, in Q3, če je bil odgovor na Q2 itd. Enačbe ustreznosti so lahko:
Koda vprašanja | Ustreznost | Vprašanje |
---|---|---|
Q1 | 1 | Kako ti je ime? |
Q2 | Q1 | {Q1}, koliko si star? |
Q3 | Q2 | Torej, star si {Q2} let. Ste poročeni? |
Q4 | Q3 == "Y" | {Q1}, koliko časa ste poročeni? |
Q5 | Q4 | Koliko otrok imaš, {Q1}? |
Izračuni ustreznosti delujejo tudi v JavaScriptu – tako da bi lahko vsa zgornja vprašanja postavili na eno stran in bi še vedno delovalo po pričakovanjih. Pravzaprav EM popolnoma nadomešča način, kako EM obdeluje formate anket Anketa vs. Skupina vs. Vprašanje naenkrat. Zdaj vsi uporabljajo popolnoma enak navigacijski mehanizem, tako da delujejo enako ne glede na slog raziskovanja.
Dokler ste na isti strani, bodo vsi podatki, ki ste jih vnesli, še vedno tam, samo skriti. Torej, če vnesete nekaj informacij, nato izberete možnost, ki jih naredi nepomembne, nato pa jih znova naredite ustrezne, bodo vaši odgovori še vedno na voljo. Vendar takoj, ko se premaknete na drugo stran, bodo vsi nepomembni odgovori izgubljeni zaradi celovitosti nabora podatkov.
Ustreznost na ravni skupine
Expression Manager podpira tudi ustreznost na ravni skupine. To olajša izvajanje zanke. Recimo, da želite zbrati informacije o do 10 subjektih (kot so izdelki ali ljudje v gospodinjstvu), pri čemer najprej določite, koliko subjektov potrebuje nadaljnje ukrepanje (na primer tako, da vprašate, koliko ljudi živi v gospodinjstvu, ali da ljudi preverijo kateri izdelki so jim všeč z dolgega seznama). Ko veste, koliko subjektov potrebuje nadaljnje ukrepanje, lahko uporabite ustreznost na ravni skupine, kot je {count >= 1}, {count >=2}, ... {count >= 10} za vsako od 10 skupin spremljanja. gor vprašanja. Znotraj vsake skupine imate lahko pogojno logiko na ravni vprašanja (npr. dodatna vprašanja glede spola ali starosti za vsak predmet). Vprašanje in enačbe ustreznosti na ravni skupine se povežejo z IN, da se določi, katera naj bo prikazana.
Krojenje / Piping
Karkoli v zavitih oklepajih se zdaj obravnava kot izraz (z eno izjemo, ki je opisana spodaj). Izrazi imajo dostop do vseh polj LimeReplacementFields, vseh spremenljivk (prek več vzdevkov), vseh tipičnih operatorjev enačb (matematičnih, logičnih in primerjalnih) in na desetine funkcij (ki delujejo celo dinamično na strani odjemalca).
Z uporabo teh enačb lahko naredite stvari, kot so:
- Pogojno prikažite prilagojena sporočila anketirancem na podlagi predhodnih odgovorov
- Ustvarite ocene in pokažite rezultate ocenjevanja (ali pogojno razvejajte ali prikažite sporočila) na podlagi teh rezultatov, vse brez uporabe samega modula za ocenjevanje
- Spregajte glagole in zavrnite samostalnike v vprašanjih, odgovorih in poročilih.
- Prikažite povzetke odgovorov pred stranjo »Pokažite svoje odgovore« na koncu ankete
Enačbe
Obstaja nova vrsta vprašanja, imenovana Enačba. Je kot Boilerplate vprašanja, le da shrani vrednost tega, kar je prikazano v bazi podatkov. Torej, če besedilo Equation Question vsebuje izračun ocene, bi bila ta vrednost shranjena v zbirki podatkov v spremenljivki, ki jo je mogoče prikazati v javnih ali zasebnih statistikah.
To rešuje običajno zahtevo za shranjevanje rezultatov ocenjevanja v bazi podatkov
Sintaksa
Vse, kar je v zavitih oklepajih, se zdaj obravnava kot izraz (z eno izjemo: ne sme biti presledkov na začetku ali na koncu – to je potrebno za zagotovitev, da upravitelj izrazov ne poskuša obdelati vdelanega JavaScripta).
Upoštevajte, da je v redu, če izrazi obsegajo več vrstic, če za začetnim zavitim oklepajem ali pred zaključnim zavitim oklepajem ni presledka. To je še posebej koristno za ugnezdene stavke if(), kot je ta:
{if(is_empty(PFTotals),
'',
if(PFTotals >= -5 && PFTotals <= -4,
'Zelo mehko',
if(PFTotals >= -3 && PFTotals <= -2,
'Mehko',
if(PFTotals == -1,
'Nekoliko mehko',
if(PFTotals == 0,
'Zmerno',
if(PFTotals == 1,
'Nekoliko težko',
if(PFTotals >= 2 && PFTotals <= 3,
'Hard',
if(PFTotals >= 4 && PFTotals <= 5,
'Zelo težko',
''
)
)
)
)
)
)
)
)}
- Vsi standardni matematični operatorji (npr. +,-,*,/,!)
- Vsi standardni primerjalni operatorji (npr. <,<=,==,!=,>,>=, plus ti ustrezniki: lt,le,eq,ne,gt,ge)
- Oklepaji (da lahko združite podizraze)
- Pogojni operatorji (npr. &&,| | in ti ustrezniki: in,ali)
- Nizi z enojnimi in dvojnimi narekovaji (ki lahko vsak vdela nize z drugo vrsto narekovajev)
- Operator vejice (tako ima lahko seznam izrazov in samo vrne končni rezultat)
- Operator dodelitve (=)
- Vnaprej določene spremenljivke (za sklicevanje na vprašanja, atribute vprašanj in odgovore) - npr. vse kode SGQA
- Vnaprej določene funkcije (obstaja že 70+ in jih je preprosto dodati več)
Operaterji
Sintaksa EM sledi običajni prednosti operatorja:
Raven | Operator(ji) | Opis |
---|---|---|
1 | () | oklepaji za združevanje ali klicanje funkcij |
2 | ! - + | unarni operatorji: ne, negacija, unarni-plus |
3 | * / | krat, deli |
4 | + - | plus , minus |
5 | < <= > >= lt le gt ge | relativne primerjave |
6 | == != eq ne | primerjave enakosti |
7 | in | logično IN |
8 | ali | logično ALI |
9 | = | dodelitev operator |
10 | , | vejica operator |
Opozorilo z operatorjem plus (+)
Zaradi skladnosti med JavaScriptom in PHP operater plus (+) sešteva, če sta oba operanda številska, vendar združuje, če sta oba dela neštevilska niza. Vendar pa priporočamo uporabo funkcije join() za veriženje in funkcije sum() za seštevanje, saj je s tem vaš namen jasnejši in se izognete nepričakovanim rezultatom, če ste pričakovali nize, a namesto tega dobili številke (ali obratno obratno).
Opozorilo z neujemanjem med številom in nizom ter abecedno primerjavo
Ko želite primerjati vrednost z relativnimi primerjavami ali primerjavami enakosti, bodite pozorni na neujemanje vrste. Vrednost, ki jo vnese uporabnik, ali izbrana koda odgovora se lahko uporabi kot številka, če je očitno številka.
Če eno od vrednosti obdate z "
, bo primerjava vsiljena kot besedilo (abecedna primerjava). Če želite primerjati številčno, številke nikoli ne obkrožite z narekovaji, "
.
Na primer Q0.NAOK > "50"
velja, če je Q0.NAOK številsko vprašanje z vrednostjo 9. To je zato, ker bo operator >
domneval, da gre za abecedno primerjavo in ne za številko.
Če želite zagotoviti primerjavo celoštevilske vrednosti, lahko uporabite intval(Q0.NAOK) > 50
, samo zapomnite si, če Q0.NAOK ni število (prazno ali niz), potem intval(Q0. NAOK) === 0. Za primerjavo vrednosti niza ("A" < "B") neposredno uporabite strcmp: strcmp(Q0.NAOK,"B")
ali strcmp(Q0.NAOK,"A5")
.
Previdno pri uporabi operatorja dodelitve (=)
Opomba: izogibajte se uporabi operatorjev dodelitve, razen če je to nujno potrebno, saj lahko povzročijo nepričakovane stranske učinke. Če na primer spremenite vrednost prejšnjega odgovora, se kaskadna ustreznost in logika preverjanja veljavnosti med tem vprašanjem in trenutnim vprašanjem ne izračunata znova, tako da lahko na koncu dobite notranje neskladne podatke (npr. vprašanja, na katera ostane odgovor, vendar bi morala imeti bila NULLed ali vprašanja, ki so preskočena, a bi nanje morali odgovoriti). Na splošno velja, da če želite spremenljivki dodeliti vrednost, ustvarite vrsto vprašanja Equation in uporabite izraz za nastavitev njene vrednosti. Vendar pa ljudje redko potrebujejo tega operaterja, zato smo ga dali na voljo.
To help caution you about this operator, it is shown in red font within the syntax equations (so that you don't confuse it with "==")
Using Assignment Operator
The main reasons you may want to use assignment are:
- You need to set the default value for a question that does not accept defaults via equation (such as list radio, where the user interface lets you pick one of the answer options, but does not let you enter an equation). However, be careful, as LimeSurvey will not be able to validate that your equation generates one of the allowable answers for that question.
- You need to forcibly change the response to a previous question based upon a later response
- You need complex quota : using one hidden single choice for quota and set it using assignment
- etc...
You can use all expression manager system for this purpose.
Some example:
- Set answer to a short text question in lowercase :
{QCODE=strtolower(QCODE.NAOK)}
- Set a default answer to an array question type at start of a survey :
{Q1_SQ1=((is_empty(Q1_SQ1.NAOK),"A99",Q1_SQ1.NAOK)}
- Set a default answer to an array texts question type at start of a survey :
{Q1_SQY1_SQX1 = ((is_empty(Q1_SQY1_SQX1.NAOK),"Inserted answer", Q1_SQY1_SQX1.NAOK)}
- Set an answer with condition :
{QCODE=if(YesNo="Y","A1","")}
XSS security
With XSS enable, some expression manager system can not be used :
- starting a HTML tag in expression but ending in another expression
- use a complex expression in URL.
Example and workaround
{if( 1 ,"<strong>","")}information{if( 1 ,"</strong>","")}
is broken with XSS security, here you can use{if(1,"<strong>information</strong>","information")}
<a href="/script.php?value={if(QCODE == "Y","yes","no")}">next</a>
, here you can use an equation question because using a complete question code is OK :<a href="/script.php?value={EQUATION.NAOK}">next</a>
Access to Variables
Expression Manager provides read-only access to whichever variables we might need. For backwards compatibility, it provides access to the following:
- TOKEN:xxx - the value of a TOKEN (e.g. TOKEN:FIRSTNAME, TOKEN:ATTRIBUTE_5) (Only for NOT anonymous survey).
- INSERTANS:SGQA - the display value of an answer (e.g. "Yes"). For Expression Manager it's the same that using {QCODE.shown}.
- All {XXX} values used by templates.
- In question text, you can use {QID} replaced by the question id and {SGQ} replaced by the SGQA of the question
In addition, Expression Manager lets you refer to variables by the Question Code (the 'title' column in the questions table within the database). This is also the variable label used when you export your data to SPSS, R, or SAS. For example, if you have questions about name, age, and gender, you could call those variables name, age, and gender instead of 12345X13X22, 12345X13X23, and 12345X13X24. This makes equations easier for everyone to read and validate the logic, plus makes it possible to shuffle questions around without having to keep track of group or question numbers.
Important: It is only safe to refer to variables that occur in preceding pages or questions.
Furthermore, Expression Manager lets you access many properties of the Question:
Syntax | Meaning | Example | Example Result |
---|---|---|---|
Qcode | an alias for Qcode.code | {implode(',',name,gender)} | 'Tom','M' |
Qcode.code | the selected response code for the question if it is relevant (otherwise blank), or the text value if it is not a coded question | {implode(',',name.code,gender.code)} | 'Tom','M' |
Qcode.NAOK | same as Qcode - see discussion of NAOK | {gender.NAOK} | 'M' |
Qcode.value | the assessment value for the question if it is relevant (otherwise blank), or the text value if it is not a coded question | {gender.value} | '1' |
Qcode.valueNAOK | same as Qcode.value - see discussion about NAOK | {gender.valueNAOK} | '1' |
Qcode.shown | the dispay value for the question | {implode(',',name.shown,gender.shown)} | 'Tom','Male' |
Qcode.question | the text of the question | {gender.question} | 'What is your gender?' |
Qcode.mandatory | whether the question is mandatory (Y/N) | {gender.mandatory} | 'N' |
Qcode.qid | the internal question number (not the sequential number) | {gender.qid} | 337 |
Qcode.type | the question type | {gender.type} | 'G' |
Qcode.jsName | the correct javascript name for the question, regardless whether declared on or off this page | {gender.jsName} | 'java1827X3X337' |
Qcode.gid | the internal group number (not the sequential number) | {gender.gid} | 3 |
Qcode.qseq | the sequential number of the question, starting from 0 | {gender.qseq} | 5 |
Qcode.gseq | the sequential number of the group, starting from 0 | {gender.gseq} | 1 |
Qcode.relevanceStatus | whether the question is currently relevant (0 or 1) | {gender.relevanceStatus} | 1 |
Qcode.relevance | the question-level relevance equation | {gender.relevance} | '!is_empty(name)' |
Qcode.grelevance | the group-level relevance equation | {gender.grelevance} | 'num_children >= 5' |
Qcode.sgqa | the SGQA value for this question | {gender.sgqa} | '1827X3X337' |
HTML editor issue
If you use HTML editor, some characters are replaced by HTML entities.
- & by &
- < by <
- > by >
If you use HTML editor you need to use :
- and for &
- lt for <
- le for <=
- gt for >
- ge for >=
Qcode Variable Naming
Here are the details of how to construct a Qcode (and access some properties) by question type. In general, Qcodes are constructed as:
QuestionCode . '_' . SubQuestionID . '_' . ScaleId
For comment and other, question code are QuestionCode_comment and QuestionCode_other
Type | Description | Code | SubQs | Answer Options | Scales | Answer Code | Answer Shown | Relevance |
---|---|---|---|---|---|---|---|---|
5 | 5 Point Choice Radio-Buttons | Q1 | 1-5 | {Q1} | {Q1.shown} | {Q1==3} | ||
B | Array (10 Point Choice) Radio-Buttons | Q2 | L1-L6 | 1-10 | {Q2_L2} | {Q2_L2.shown} | {Q2_L2==7} | |
A | Array (5 Point Choice) Radio-Buttons | Q3 | 1-5 | 1-5 | {Q3_1} | {Q3_1.shown} | {Q3_1>=3} | |
1 | Array (Flexible Labels) Dual Scale | Q4 | sq1-sq5 | 0:a1-a3 | 1:b1-b3 | {Q4_sq1_0} | {Q4_sq1_1.shown} | {Q4_sq1_1=='b2'} |
H | Array (Flexible) - Column Format | Q5 | 1-5 | s,m,t | {Q5_1} | {Q5_1.shown} | {Q5_1=='s'} | |
F | Array (Flexible) - Row Format | Q6 | F1-F5 | 1-5 | {Q6_F3} | {Q6_F3.shown} | {Q6_F3==4} | |
E | Array (Increase/Same/Decrease) Radio-Buttons | Q7 | 1-7 | I,S,D | {Q7_4} | {Q7_4.shown} | {Q7_4=='D'} | |
: | Array (Multi Flexi) 1 To 10 | Q8 | ls1,todo,ls2 | min,max,avg | {Q8_ls1_max} | {Q8_ls2_avg.shown} | {Q8_ls2_min==7} | |
; | Array (Multi Flexi) Text | Q9 | hp,st,sw | 1st,2nd,3rd | {Q9_hp_3rd} | {Q9_hp_3rd.shown} | {Q9_hp_3rd=='Peter'} | |
C | Array (Yes/Uncertain/No) Radio-Buttons | Q10 | 1-5 | Y,N,U | {Q10_1} | {Q10_1.shown} | {Q10_3=='Y'} | |
X | Boilerplate Question | Q11 | {Q11.shown} | |||||
D | Date | Q12 | {Q12} | {Q12.shown} | ||||
* | Equation | Q13 | {Q13} | {Q13.shown} | {Q13>5} | |||
~124~ | File Upload (records number of files uploaded) | Q14 | {Q14} | {Q14>0} | ||||
G | Gender Drop-Down List | Q15 | M,F | {Q15} | {Q15.shown} | {Q15=='M'} | ||
U | Huge Free Text | Q16 | {Q16} | {Q16.shown} | {strlen(Q16)>100} | |||
I | Language Question | Q17 | {Q17} | {Q17.shown} | {Q17=='en'} | |||
! | List - Dropdown | Q18 | 1-5 | {Q18} | {Q18.shown} | {Q18==3} | ||
L | List Drop-Down/Radio-Button List | Q19 | A-Z | {Q19} | {Q19.shown} | {Q19=='X'} | ||
O | List With Comment Drop-Down/Radio-Button List + Textarea | Q20 | A-F | {Q20},{Q20comment} | {Q20.shown} | {Q20=='B'} | ||
T | Long Free Text | Q21 | {Q21} | {Q21.shown} | {strstr(Q21,'hello')>0} | |||
M | Multiple Choice Checkbox | Q22 | A-F, other | {Q22_E}, {Q22_other} | {Q22_E.shown}, {Q22_other.shown} | {Q22_E=='Y'} | ||
P | Multiple Choice With Comments Checkbox + Text | Q23 | A-F | {Q23_D}, {Q23_Dcomment} | {Q23_D.shown} | {!is_empty(Q23)} | ||
K | Multiple Numerical Question | Q24 | self,mom,dad | {Q24_self} | {Q24_self.shown} | {Q24_self>30} | ||
Q | Multiple Short Text | Q25 | A-F | {Q25_B} | {Q25_B.shown} | {substr(Q25_B,1,1)=='Q'} | ||
N | Numerical Question Type | Q26 | {Q26} | {Q26.shown} | {Q26 > 30} | |||
R | Ranking Style | Q27 | 1-4 | {Q27_1} | {Q27_1.shown} | {Q27_1==3} | ||
S | Short Free Text | Q28 | {Q28} | {Q28.shown} | {Q28=='mine'} | |||
Y | Yes/No Radio-Buttons | Q29 | {Q29} | {Q29.shown} | {Q29=='Y'} |
The reserved 'this', 'self', and 'that' variables
Quite often, you want to evalute all parts of a question, such as counting how many subquestions have been answered, or summing the scores. Other times, you want to process just certain rows or columns of a question (such as getting the row or column sums and storing them in the database). These reserved variables make that process relatively painless.
The 'this' variable is used exclusively within the "Whole question validation equation" and "Sub-question validation equation" advanced question options. It expands to the variable names of each of the cells within those questions. So, if you want to make sure that each entry is greater than three, you would set the "Sub-question validation equation" to (this > 3).
The 'self' and 'that' variable are more powerful, and serve as macros which are expanded prior to processing equations. The syntax choices are:
- self
- self.suffix
- self.sub-selector
- self.sub-selector.suffix
suffix is any of the normal qcode suffixes (e.g. NAOK, value, shown)
sub-selector is one of:
- comments - only subquestions that are comments (e.g., from multiple choice with comment and list with comment)
- nocomments - only subquestions that are not comments
- sq_X - where X is a row or column identifier. Only subquestions matching pattern X are selected. Note that search is done on complete code identifier, then sq_X match and include subquestions nX, X, Xn (e.g. if you use sq_1, subquestions a1, 1a, 1, 11 or 001 was included). Put attention at dual scale question type where subquestions code are QCODE_SQCODE_1 and QCODE_SQCODE_1 and to ranking question type where subquestions code are QCODE_1,QCODE_2 ....
- nosq_X - where X is a row or column identifier. Only subquestions not matching pattern X are selected. Note that search is done on complete code identifier, then nosq_X match and does not include subquestions nX, X, Xn
Examples:
- Has any part of a question been answered? {count(self.NAOK)>0}
- What is the assessment score for this question? {sum(self.value)}
You can also use these to get row and column totals. Say you have a array of numbers with rows A-E and columns 1-5.
- What is the grand total? {sum(self.NAOK)}
- What is the total of row B? {sum(self.sq_B.NAOK)}
- What is the total of column 3? {sum(self.sq_3.NAOK)}
The 'that' variable is like the 'self' variable, but lets you refer to other questions. Its syntax is:
- that.qname
- that.qname.suffix
- that.qname.sub-selector
- that.qname.sub-selector.suffix
qname is the question name without any subquestion extensions. So, say you create a question 'q1', that is its qname
Examples:
- Has any part of question q1 been answered? {count(that.q1.NAOK)>0}
- What is the assessment score for q2? {sum(that.q2.NAOK)}
- What is the grand total of q3? {sum(that.q3.NAOK)}
- What is the total of row C in q4? {sum(that.q4.sq_C.NAOK)}
- What is the total of column 2 in q4? {sum(that.q4.sq_2.NAOK)}
The 'self' and 'that' variables can be used in any relevance, validation, or tailoring.
The one caveat is that when you use the Show Logic File feature, it will show you the expanded value of 'self' and 'that'. This lets you see the actual equation that will be generated so that you (and Expression Manager) can validate that the variables exist. This may seem confusing since you may see quite lenghty equations. However, if you edit the question, you will see the original equation using 'self' and/or 'that'
Also note that you should not use these variables if (a) you want to explicitly name each variable used in an equation, or (b) use variables that do not have subquestions (e.g. single response questions). In those cases, prefixing a variable with 'that' is overkill, and you run the risk of getting unexpected results.
Usage of NAOK
NAOK --> "Not Applicable" (NA) is alright (OK)
Using NAOK, means that all or some of the variables are irrelevant (e.g. "Not Applicable" (NA) is alright (OK)).
When you put some variable from question in any equation : if this question (or subquestion) is hidden by condition : this disable all equation.
For example : count(Q1_SQ1,Q1_SQ2,Q1_SQ3,Q1_SQ4) give always an empty string if one subquestion of Q1 is filtered. To count the number of checked subquestion in such question can be count(Q1_SQ1.NAOK,Q1_SQ2.NAOK,Q1_SQ3.NAOK,Q1_SQ4.NAOK). If the sub question is hidden :Expression manager return an empty string.
Without NAOK : if one question or one subquestion is hidden : Expression Manager return always an empty string, same to return false.
The .shown always use the NAOK system (empty string if hidden) but if you need the code of the answer : it's always a good idea to add .NAOK after the question code. Except if you need it and know what you do.
Another example and information is provided at Overriding Cascading Conditions
Access to Functions
Expression Manager provides access to mathematical, string, and user-defined functions, as shown below. It has PHP and JavaScript equivalents for these functions so that they work identically on server-side (PHP) and client-side (JavaScript). It is easy to add new functions.
Implemented Functions
The following functions are currently available:
Function | Meaning | Syntax |
---|---|---|
abs | Absolute value | number abs(number) |
acos | Arc cosine | number acos(number) |
addslashes | Quote string with slashes | string addslashes(string) |
asin | Arc sine | number asin(number) |
atan | Arc tangent | number atan(number) |
atan2 | Arc tangent of two variables | number atan2(number, number) |
ceil | Round fractions up | number ceil(number) |
checkdate | Returns true(1) if it is a valid date in gregorian calendar | bool checkdate(month,day,year) |
convert_value | Convert a numerical value using a inputTable and outputTable of numerical values | number convert_value(fValue, iStrict, sTranslateFromList, sTranslateToList) |
cos | Cosine | number cos(number) |
count | count the number of answered (non-blank) questions in the list | number count(arg1, arg12, ..., argN) |
countif | Count the number of answered questions in the list equal to the first argument | number countif(matches, arg1, arg2, ... argN) |
countifop | Count the number of answered questions in the list which pass the criteria (arg op value) | number countifop(op, value, arg1, arg2, ... argN) |
date | Format a local date/time | string date(format [, timestamp=time()]) |
exp | Calculates the exponent of e | number exp(number) |
fixnum | Display numbers with comma as radix separator, if needed | string fixnum(number) |
floor | Round fractions down | number floor(number) |
gmdate | Format a GMT date/time | string gmdate(format [, timestamp=time()]) |
html_entity_decode | Convert all HTML entities to their applicable characters (always uses ENT_QUOTES and UTF-8) | string html_entity_decode(string) |
htmlentities | Convert all applicable characters to HTML entities (always uses ENT_QUOTES and UTF-8) | string htmlentities(string) |
expr_mgr_htmlspecialchars | Convert special characters to HTML entities (always uses ENT_QUOTES and UTF-8) | string htmlspecialchars(string) |
expr_mgr_htmlspecialchars_decode | Convert special HTML entities back to characters (always uses ENT_QUOTES and UTF-8) | string htmlspecialchars_decode(string) |
idate | Format a local time/date as integer | string idate(string [, timestamp=time()]) |
if (Updated in 3.0.2 ) | Excel-style if(test,result_if_true[,result_if_false = ""]) | if(test,result_if_true[,result_if_false = ""]) |
implode | Join array elements with a string | string implode(glue,arg1,arg2,...,argN) |
intval | Get the integer value of a variable | int intval(number [, base=10]) |
is_empty | Determine whether a variable is considered to be empty | bool is_empty(var) |
is_float | Finds whether the type of a variable is float | bool is_float(var) |
is_int | Find whether the type of a variable is integer | bool is_int(var) |
is_nan | Finds whether a value is not a number | bool is_nan(var) |
is_null | Finds whether a variable is NULL | bool is_null(var) |
is_numeric | Finds whether a variable is a number or a numeric string | bool is_numeric(var) |
is_string | Find whether the type of a variable is string | bool is_string(var) |
join (New in 2.0 build 130129) | Join elements as a new string | join(arg1, arg2, ... argN) |
list | Return comma-separated list of non-blank values | string list(arg1, arg2, ... argN) |
listifop (New in 3.16.1 ) | Return a 'glue'-separated list of the specified question property (retProp) from questions in the list which pass the criteria (cmpProp op value) | string listifop(cmpProp, op, value, retProp, glue, sgqa1, sgqa2, ... sgqaN) |
log | The logarithm of number to base, if given, or the natural logarithm. | number log(number,base=e) |
ltrim | Strip whitespace (or other characters) from the beginning of a string | string ltrim(string [, charlist]) |
max | Find highest value | number max(arg1, arg2, ... argN) |
min | Find lowest value | number min(arg1, arg2, ... argN) |
mktime | Get UNIX timestamp for a date (each of the 6 arguments are optional) | number mktime([hour [, minute [, second [, month [, day [, year ]]]]]]) |
modulo-function | The modulo function is not supported yet. You can use the floor() function instead | floor(x/y)==(x/y) |
nl2br | Inserts HTML line breaks before all newlines in a string | string nl2br(string) |
number_format | Format a number with grouped thousands | string number_format(number) |
pi | Get value of pi | number pi() |
pow | Exponential expression | number pow(base, exp) |
quoted_printable_decode | Convert a quoted-printable string to an 8 bit string | string quoted_printable_decode(string) |
quoted_printable_encode | Convert a 8 bit string to a quoted-printable string | string quoted_printable_encode(string) |
quotemeta | Quote meta characters | string quotemeta(string) |
rand | Generate a random integer, see this example | int rand() OR int rand(min, max) |
regexMatch | compare a string to a regular expression | bool regexMatch(pattern,input) |
round | Rounds a number to an optional precision | number round(val [, precision]) |
rtrim | Strip whitespace (or other characters) from the end of a string | string rtrim(string [, charlist]) |
sin | Sine | number sin(arg) |
sprintf | Return a formatted string | string sprintf(format, arg1, arg2, ... argN) |
sqrt | Square root | number sqrt(arg) |
stddev | Calculate the Sample Standard Deviation for the list of numbers | number stddev(arg1, arg2, ... argN) |
str_pad | Pad a string to a certain length with another string | string str_pad(input, pad_length [, pad_string]) |
str_repeat | Repeat a string | string str_repeat(input, multiplier) |
str_replace | Replace all occurrences of the search string with the replacement string | string str_replace(search, replace, subject) |
strcasecmp | Binary safe case-insensitive string comparison | int strcasecmp(str1, str2) |
strcmp | Binary safe string comparison | int strcmp(str1, str2) |
strip_tags | Strip HTML and PHP tags from a string | string strip_tags(str, allowable_tags) |
stripos | Find position of first occurrence of a case-insensitive unicode string (starting by 0, return false if not found) | int stripos(haystack, needle [, offset=0]) |
stripslashes | Un-quotes a quoted string | string stripslashes(string) |
stristr | Case-insensitive strstr | string stristr(haystack, needle [, before_needle=false]) |
strlen | Get string length | int strlen(string) |
strpos | Find position of first occurrence of an unicode string (starting by 0, return false if not found) | int strpos(haystack, needle [ offset=0]) |
strrev | Reverse a string | string strrev(string) |
strstr | Find first occurrence of a string | string strstr(haystack, needle[, before_needle=false]) |
strtolower | Make a string lowercase | string strtolower(string) |
strtotime | Parse about any English textual datetime description into a Unix timestamp | int strtotime(string) |
strtoupper | Make a string uppercase | string strtoupper(string) |
substr | Return part of an unicode string | string substr(string, start [, length]) |
sum | Calculate the sum of values in an array | number sum(arg1, arg2, ... argN) |
sumifop | Sum the values of answered questions in the list which pass the criteria (arg op value) | number sumifop(op, value, arg1, arg2, ... argN) |
tan | Tangent | number tan(arg) |
time | Return current UNIX timestamp | number time() |
trim | Strip whitespace (or other characters) from the beginning and end of a string | string trim(string [, charlist]) |
ucwords | Uppercase the first character of each word in a string | string ucwords(string) |
unique | Returns true if all non-empty responses are unique | boolean unique(arg1, ..., argN) |
Functions that are Planned or Being Considered
Other functions that are planned (or being considered) but which are not implemented yet include the following. Some of these are for backwards compatability with another survey tool.
Syntax | Meaning | Comments |
---|---|---|
e() | returns the value of e | |
formatDate(X,PAT) | return the string value of date X formatted according to Java data format pattern PAT | |
formatNumber(X,PAT) | return the string value of number X formatted according to Java number format pattern PAT | |
getAnsOption(X) | Core plugin ExpressionAnswerOptions | |
getAnsOption(X,Y) | Core plugin ExpressionAnswerOptions | |
getRelevance(X) | returns the relevance equation for question X | |
getStartTime() | returns the date corresponding to the system time when the interview was started | |
getType(X) | returns the string name of the datatype - e.g. *NA* if isNA() | |
gotoFirst() | jumps to the first relevant set of questions - this violates the normal flow of the system | |
gotoNext() | jumps to the next set of relevant questions - this violates the normal flow of the system | |
gotoPrevious() | jumps to the previous set of relevant questions - this violates the normal flow of the system | |
isAsked(X) | returns true if the answer is neither *NA*, *INVALID*, nor *UNASKED* | |
isInvalid(X) | returns true if the answer is of type *INVALID* | |
isNA(X) | returns true if the answer is of type *NA* | |
isNotUnderstood(X) | returns true if the answer if of type *HUH* | |
isRefused(X) | returns true if the answer is of type *REFUSED* | |
isSpecial(X) | returns true if the answer is of type *UNASKED*, *NA*, *REFUSED*, *INVALID*, *UNKNOWN*, or *HUH* | |
isUnknown(X) | returns true if the answer is of type *UNKNOWN* | |
jumpTo(X) | jump to the group containing the named question -- this violates the normal flow of the system | |
jumpToFirstUnasked() | jump to the first unasked question |
|
lastIndexOf(X,Y) | returns the last index (base 0) of string Y in string X. Returns -1 if Y is not contained within X | |
list(X,...) | a string containing a comma separated list of the positive values with "and" separating the last two | |
mean(X,...) | returns the mean of a list of values | |
numAnsOptions(X) | returns the number of answer options that question X has | |
orlist(X,...) | a string containing a comma separated list of the positive values, with "or" separting the last two | |
parseDate(X,PAT) | returns the date value of string X parsed with Java date format pattern PAT | |
parseNumber(X,PAT) | returns the numerical value of string X parsed with Java number format pattern PAT | |
showAllResponsesExcept( questionList,attributeList,attributeTitleList) | questionList = pipe-delimited list of question identifiers; attributeList = pipe-delimited list of attributes (like question#, title, text, type - so you can decide what to show); attributeTitleList = pipe-delimited list of table headers, so can internationalize the report. | |
showTheseResponses( questionList,attributeList,attributeTitleList) | questionList = pipe-delimited list of question identifiers; attributeList = pipe-delimited list of attributes (like question#, title, text, type - so you can decide what to show); attributeTitleList = pipe-delimited list of table headers, so can internationalize the report. |
Expression Manager Knows Which Variables are Local
In order to properly build the JavaScript for page, Expression Manager needs to know which variables are set on the page, and what their JavaScript ID is (e.g. for document.getElementById(x)). It also must know which variables are set on other pages (so that it can ensure that the needed <input type='hidden' value='x'> fields are present and populated).
Cascading Conditions
If any of the variables are irrelevant, the whole equation will be irrelevant (false). For example, in the following table, N/A means that one of the variables was not relevant
Operator | Example | a | b | Result |
---|---|---|---|---|
+ (unary) | +a | N/A | false | |
! | !a | N/A | false | |
== (or eq) | a == b | N/A | 5 | false |
== (or eq) | a == b | N/A | 0 | false |
== (or eq) | a == b | N/A | N/A | false |
!= (or ne) | a != b | N/A | 5 | false |
!= (or ne) | a != b | N/A | N/A | false |
!= (or ne) | a != b | N/A | 0 | false |
> (or gt) | a > b | N/A | 5 | false |
>= (or ge) | a >= b | N/A | 5 | false |
< (or lt) | a < b | N/A | 5 | false |
<= (or le) | a <= b | N/A | 5 | false |
and | a and b | N/A | 5 | false |
and | a and b | N/A | N/A | false |
or | a or b | N/A | N/A | false |
or | a or b | N/A | 5 | false |
+ | a + b | N/A | 5 | false |
* | a * b | N/A | 5 | false |
/ | a / b | 5 | N/A | false |
() | (a) | N/A | false | |
(exp) | (a && b) | N/A | 5 | false |
(exp) op (exp) | (b + b) > (a && b) | N/A | 5 | false |
function | sum(a,b,b) | N/A | 5 | false |
function | max(a,b) | N/A | 5 | false |
function | min(a,b) | N/A | 5 | false |
function | implode(', ',a,b,a,b) | N/A | 5 | false |
function | if(a,a,b) | N/A | 5 | false |
function | is_empty(a) | N/A | false | |
function | is_empty(a) | 0 (or blank) | true | |
function | !is_empty(a) | N/A | false |
Overriding Cascading Conditions
Say you want to show a running total of all relevant answers. You might try to use the equation {sum(q1,q2,q3,...,qN)}. However, this gets translated internally to LEMif(LEManyNA('q1','q2','q3',...,'qN'),,sum(LEMval('q1'),LEMval('q2'),LEMval('q3'),...,LEMval('qN'))). So, if any of the values q1-qN are irrelevant, the equation will always return false. In this case, the sum() will show 0 until all questions are answered.
To get around this, each variable can have a ".NAOK" suffix (meaning that Not Applicable is OK) added to it. In such cases, the following behavior occurs. Say you have a variable q1.NAOK
- q1 is not added to the LEManyNA() clause
- LEMval('q1') will continue to check whether the response is relevant, and will return '' if it is not (so individual irrelevant responses will be ignored, but they will not void the entire expression).
So, the solution to the running total problem is to use the equation sum(q1.NAOK,q2.NAOK,q3.NAOK,...,qN.NAOK).
The use of the .NAOK suffix also lets authors design surveys that have several possible paths but then converge on common paths later. For example, say subjects answer a survey in a way that is outside the normal range of responses. The author could alert the subjects that they may not get valid results, and ask them whether they really want to continue with the survey. If they say Yes, then the rest of the questions will be shown. The condition for the "rest of the questions" would check whether the initial responses were answered within the normal range OR whether the subject said Yes to the question that is only relevant if they answered outside the normal range.
How does Expression Manager Support Conditional Micro-Tailoring?
Here is an example of micro-tailoring (where Question Type=='expr' means an Equation):
Question Code | Relevance | Question Type | Question |
---|---|---|---|
name | 1 | text | What is your name? |
age | 1 | text | How old are you? |
badage | !is_empty(age) | expr | {(age<16) or (age>80)} |
agestop | badage | message | Sorry, {name}, you are too {if( (age<16),'young',if( (age>80),'old','middle-aged') ) } for this test. |
kids | !badage | yesno | Do you have children? |
parents | 1 | expr | {!badage && kids=='Y'} |
numKids | parents | text | How many children do you have? |
kid1 | parents && numKids >= 1 | text | How old is your first child? |
kid2 | parents && numKids >= 2 | text | How old is your second child? |
kid3 | parents && numKids >= 3 | text | How old is your third child? |
kid4 | parents && numKids >= 4 | text | How old is your fourth child? |
kid5 | parents && numKids >= 5 | text | How old is your fifth child? |
sumage | 1 | expr | {sum(kid1.NAOK,kid2.NAOK,kid3.NAOK,kid4.NAOK,kid5.NAOK)} |
report | parents | yesno | {name}, you said you are {age} and that you have {numKids}. The sum of ages of your first {min(numKids,5)} kids is {sumage} |
All of these questions can be on a single page (e.g. in the same group), and only the relevant questions will display. Moreover, as you enter the ages of children, the sum() expression in the last question will dynamically update on the page.
Expression Manager provides this functionality by surrounding each expression with a named <span> element. Every time a value changes, it recomputes the expression that should appear in that <span> element and regenerates the display. You can have dozens, or even hundreds, of such tailored expressions on the same page, and the page will re-display all of them in a single screen refresh.
Mapping of LimeSurvey 1.91+ to Expression Manager Functionality
Old Feature | New Feature | Comments |
---|---|---|
Conditions | Relevance | You can use very complex conditional equations, and access a broader range of variables |
Assessments | Equation | Any assessment scores can be re-structured into an Equation. This both ensures that the score is written to the database, and also lets you see dynamic changes to the score value on the current page |
Replacements | Expression Manager | The core engine takes the input string and treats everything within curly braces as an Expression - so it handles all historical replacements types. To avoid messing up embedded JavaScript, Expression Manager only processes content between curly braces as long as (a) there is no leading or trailing whitespace within the curly braces - e.g. {expr} is an expression, but { expr}, {expr }, and { expr } are not expressions. Furthermore, Expression Manager does not process content within its own strings (e.g. {list('hi','there {braces}')} generates "hi there {braces}"). It also ignores escaped curly braces (e.g. \{this is not an expression\}) |
Validation | Expression Manager | The plan is to take the current min/max Question Attributes and have Expression Manager process them. That way the min/max values can be expressions themselves |
Syntax Highlighting
To help with entering and validating expressions, EM provides syntax highlighting with the following features:
Types and Meanings of Syntax Highlighting
Color | Sample | Meaning | Tooltip | Comments |
---|---|---|---|---|
tan background | Sample | the whole equation | none | Anything within curly braces that is recognized as an equation (e.g. there is no leading or trailing whitepace) will be color-coded with a tan background to help distinguish it from surrounding text |
bold red text | Sample | An error | Some explanation on error | Can be an unknow variable or an error in function, .... Survey can be totally broken, this don't show to public user. |
blue text | Sample | function name | meaning and allowable syntax | function names, or things that should be functions since they are followed by an opening parenthesis, are presented in bold blue text. Tooltips show the meaning and allowable syntax for the function. |
grey text | Sample | string | none | single and double-quoted strings are shown in grey text |
cyan text | Sample | variable set on the same page, | [name or SGQA code]: question; value; answerList showing codes for each value | Any variable that is set on the same page to the current question is shown in cyan text, showning it can be updated in javascript. The tooltip shows its name (if you used INSERTANS:xxx) or SGQA code (if you used the new naming system), the actual question, and its current value (or blank if not set). If the question type expects responses from an enumerated value set, the mapping of the codes to display values is show. |
green text | Sample | variable set on a prior page | [name or SGQA code]: question; value; answerList showing codes for each value | Any variable that is set on a prior page is shown in bold green text. The tooltip shows its name (if you used INSERTANS:xxx) or SGQA code (if you used the new naming system), the actual question, and its current value (or blank if not set). If the question type expects responses from an enumerated value set, the mapping of the codes to display values is show. |
bold pink text | Sample | variable set on a later page in general : empty at survey start, but can be filled with index or move previous | [name or SGQA code]: question; value; answerList showing codes for each value | Any variable that is set on a next page is shown in bold pink text. The tooltip shows its name (if you used INSERTANS:xxx) or SGQA code (if you used the new naming system), the actual question, and its current value (or blank if not set). If the question type expects responses from an enumerated value set, the mapping of the codes to display values is show. |
bold tan text | Sample | a lime replacement value | the value | Lime Replacement Strings (like {TOKEN:xxx}, {PRIVACY_MESSAGE}) are shown in bold tan text. |
red text | Sample | assignment operator (=) | warning message | If you use one of the assignment operator (=) that operator will be displayed in red text. This is meant to help prevent accidental re-assignment of values when you really meant to check whether a == b instead of setting the value of a = b. |
normal black text | Sample | punctuation | none | All other punctuation within the expression is shown as normal black text. |
red-boxed text | a bold red line surrounds the error | syntax error | description of the error | Any detected syntax errors are shown by surrounding the error with a red box. The tooltip shows the error. Examples include unmatched parentheses, use of undefined functions, passing the wrong number of arguments to functions, poorly structured expressions (e.g. missing operators between variables), trying to assign a new value to a read-only variable, trying to assign values to non-variables, or using unsupported syntax. Note that the syntax error dectection system may only report one error in an expression even if there are multiple errors; however, if any errors are detected, at least one error will be shown. |