Primeri ExpressionScript

Struktura

V prvem delu članka bo opisano, za kaj se lahko uporabljajo izrazi in kje najti/dodati izraz. Drugi del vsebuje primere uporabe izraza.

Kategorije izrazov

LimeSurvey uporablja izraze za naslednje namene:

• Relevantnost
• Validacija
• Besedilni izpis! N!* Shranjevanje odgovorov

Ustreznost

Namen: Skrivanje skupin vprašanj/vprašanj

Ustreznost nadzira, ali je skupina vprašanj ali vprašanje prikazano ali skrito. Če je rezultat izraza "true" (tj. 1), bo element prikazan. V nasprotnem primeru (če je rezultat izraza "false" (tj. 0)), bo element skrit.

Vrsta	Prikaže/skrije	Kje najti	Posnetek zaslona
Skupina vprašanj Ustreznost	skupina vprašanj	Ustvari/Uredi skupino vprašanj -> "Enačba ustreznosti:"	30px
Ustreznost vprašanja	vprašanje	Ustvari/uredi vprašanje -> "Enačba ustreznosti:"	30px
Ustreznost podvprašanja	podvprašanje	Uredi podvprašanja -> "Enačba ustreznosti:"	30px

Potrjevanje

Namen: Potrjevanje vnosa/dejanja na vprašanja/podvprašanja/odgovore

Validacija nadzira, ali je anketirančev vnos v vprašanje ali dejanje veljaven ali ne. Če je rezultat izraza "true" (tj. 1), bo razred "good" uporabljen za element in potrditveno sporočilo. V nasprotnem primeru, če je rezultat izraza "false" (tj. 0)), bo razred "napaka" uporabljen za element in potrditveno sporočilo. Slog za te razrede lahko deklarirate v template.css.

Type	Validates	Kje najti	Screenshot
Validacija vprašanja	vprašanje	Ustvari/uredi vprašanje -> "Zavihek Logika" - > "Enačba validacije vprašanja"	30px
Validacija podvprašanja	podvprašanja	Ustvari/uredi vprašanje -> "Zavihek Logika" -> " Enačba preverjanja podvprašanja"	30px ‎

Izpis besedila

Nameni: (Naredi nekaj) in napiši nekaj besedila

Izraz se lahko uporabi za pisanje besedila. Na primer, lahko preizkusite ali izračunate nekaj in določite rezultat glede na rezultat preizkusa ali izračuna. Uporablja se lahko tudi za vstavljanje besedila vprašanja, odgovorov, vrst vprašanj ... vprašanja, uporabljenega pred uporabo izraza. Izhod besedila je mogoče uporabiti povsod, kjer je prikazano besedilo, in lahko vrne vse vrste rezultatov.

Primer uporabe	Opis
Mikro krojenje	Prilagodite besedilo, npr. napišite »gospod« ali »gospa«, odvisno od vprašanja o spolu, postavljenega prej
Izračun	Izračunajte vrednost in jo izpišite, npr. "Vaš družinski dohodek je xxx"
Referenca	Vstavite besedilo iz elementa, npr. "Ime ti je xxx. Koliko si star?"

Shranjevanje odgovorov

Nameni: (Narediti nekaj,) (napisati nekaj besedila) in shraniti nekaj v bazo

Vrsta vprašanja enačbe se lahko uporablja za shranjevanje nečesa v zbirko podatkov. Nekaj lahko naredite z izrazom, prikažete vprašanje enačbe (ki je podobno prikaz besedila) in shranite rezultat izraza v zbirko podatkov. Odgovor shrani v tabelo odgovorov. Nato lahko rezultat uporabite v statistični funkciji ali pa ga lahko tudi uvozite v enega od formatov, ki jih ponuja funkcija izvoza LimeSurvey.

Primeri za izraze

Vstavi odgovor iz prejšnjega vprašanja

Namen	Vstavi odgovor iz prejšnjega vprašanja
Vrsta	Sklic
Primer	Prvo vprašanje (koda vprašanja " Q00"): V katerem mestu živiš? Drugo vprašanje (koda vprašanja "Q01") Kako dolgo že živite v CITY? Narediti: Uporabite odgovor iz prvega vprašanja namesto "CITY" iz drugega vprašanja.
Izraz	{QOO}
Opis	Odgovor v Q00 nadomešča polje Q00 iz drugega vprašanja
Koraki	Ustvari/Uredi drugo vprašanje Vstavite "Kako dolgo ste živeli v {QOO} (let)?" v besedilno polje vprašanja

Uporaba vprašanja s skrito enačbo za samodejno izpolnjevanje odgovora

Problem:

Predstavljajte si, da imate dve vprašanji Q1 in Q2. Q1 vpraša anketirance po njihovi starosti. Q2 razdeli anketirance v tri skupine: starost je manjša od 20 let, starost je 20 let, starost je več kot 20. 

Torej, Q2 naj uporablja vrednosti "1", "2", "3", ki ustrezajo zgornjih pogojev. Prav tako ne smemo pozabiti narediti Q2 nevidnega (vprašanje ne bo prikazano v anketi, ampak bodo vrednosti preko "postopka v ozadju" v tabeli odgovorov).

Če želite izpolniti zbirko podatkov z uporabo vprašanja Equation, vnesite:

• Najprej ustvarite vprašanje s kodo Q1 kot vprašanje za numerični vnos.
• Nato ustvarite drugo vprašanje s kodo Q2 kot vprašanje enačbe .
• V poglavju zavihka "Nastavitve zaslona" v Q2:
  • nastavite polje "Vedno skrij to vprašanje" kot "Vklopljeno"
  • v polje "Enačba" vnesite izraz:

 {if(Q1.NAOK < 20, "1", if(Q1.NAOK > 20, "3", "2"))}

Ustvarite stran s povzetkom z ogradami

Ta vadnica prikazuje, kako lahko na koncu ankete ustvarite pregled, v katerem navedete vsa vprašanja in odgovore prek oznak mesta ExpressionScript. Pokaže tudi, kako omejite tak pregled samo na vprašanja z odgovori.

Naš primer lahko prenesete od tukaj: Primer ankete o označbah mesta.

Tukaj uporabljene vrste vprašanj:'

'1. Vprašanja z eno izbiro / eno besedilo/številska vprašanja

• Seznam (spustni meni)
• Seznam (radio) [L]
• Da/Ne [Y]
• Dolgo prosto besedilo [T ]
• Kratko prosto besedilo [S]
• Numerični vnos [N]
• Enačba [*]

'2. Vprašanje s podvprašanji

• Večkratno kratko besedilo [Q]
• Večkratna izbira [M]
• Matrika [F]
• Matrika (Da/Ne/Negotovo) [C]
• Matrika (izbira 10 točk) [B]

'3. Vprašanja z 2 lestvicama

• Dvojna lestvica polja [1]

'4. Vprašanja z lestvicami X in Y

• Array (Numbers) [:]

'5. Vprašanja maske

• Prikaz besedila [X]

V tem preprostem primeru bo naš pregled preprost seznam z:

- Besedilo vprašanja: Uporabnikov odgovor

Vprašanja z eno izbiro/vprašanja z enim besedilom/številska vprašanja

Za vse te vrste vprašanj bo Limesurvey shranil en odgovor:

• Seznam (spustni)
• Seznam (radio)
• Seznam s komentarjem
• Izbira 5 točk
• Da/Ne
• Kratko prosto besedilo
• Dolgo prosto besedilo!N !*Ogromno prosto besedilo
• Številski vnos
• Enačba
• Datum
• Spol

Ob predpostavki, da je koda vprašanja q1, se lahko sklicujemo na besedilo vprašanja in odgovorimo z:

- {q1.vprašanje}: {q1.prikazano}

primer:

- Koliko si star?: 25

Če želite preveriti, ali je bilo na to vprašanje odgovorjeno, lahko okrog svojega izhoda postavite stavek IF:

{if(!is_empty(q1),join("- ",q1.question,": ",q1.shown),"")}

To se "prevede" v: ČE vprašanje s kodo q1 ni prazno, izpis "- " IN besedilo vprašanja IN ": " IN besedilo odgovora (funkcija join() združi elemente kot nov niz; DRUGAČE: izhod ni nič (" " pomeni prazen niz).

Vprašanje s podvprašanji

Za vse te vrste vprašanj LimeSurvey uporablja podvprašanja:

• Večkratno kratko besedilo
• Večkratna izbira
• Večkratna izbira s komentarji
• Matrika
• Matrika (izbira 5 točk)
• Matrika (izbira 10 točk)
• Matrika (da /Ne/Negotovo)
• Matrika (povečanje/enako/zmanjšanje)
• Matrika po stolpcu

Ob predpostavki, da je koda vprašanja vprašanja q2 in da so podvprašanja oštevilčena SQ001, SQ002 (samodejno oštevilčenje izvaja LimeSurvey), se lahko sklicujemo na besedilo vprašanja in odgovor z uporabo:

- {q2_SQ001.vprašanje}: {q2_SQ001.prikazano}

- {q2_SQ002.vprašanje}: {q2_SQ002.prikazano}

Pri vprašanjih z več izbirami je zdaj smiselno prikazati besedilo označenega podvprašanja, vendar prikazati Y za vsako izbrano možnost:

- {q2_SQ001.vprašanje}: {q2_SQ001}

- {q2_SQ002.vprašanje}: {q2_SQ002}

...

Upoštevajte, da trenutno ni mogoče izpisati besedila vprašanj s podvprašanji, glejte to zahtevo za funkcijo.

Primer 1 (ob predpostavki, da je vrsta vprašanja več možnih izbir)

- Ali poznate te znamke avtomobilov?

-- Mercedes: Y

-- Audi: N

-- Volvo: Y

Če želite izpisati samo označene elemente, lahko okoli izpisa postavite stavek IF in preverite vrednost potrditvenega polja:

{ if( q2_SQ001=="Y", join( "- ", q2_SQ001.question, ": ", q2_SQ001.shown ), "" ) }

Uporabite funkcijo listifop , če želite izpisati seznam samo izbranih elementov, npr.: Mercedes, Volvo

{ listifop( 'vrednost', '==', 'Y', 'vprašanje', ', ', that.q2.sgqa ) }

Kjer se that.q2 razširi na vsa podvprašanja q2. Glejte self, this and that za več podrobnosti.

Primer 2 (ob predpostavki, da je vrsta vprašanja Array (izbira 10 točk))

- Prosimo, ocenite kakovost spodnjih znamk avtomobilov na lestvici od 1=zelo slabo do 10=zelo dobro?

-- Mercedes: 7

-- Audi: 9

-- Volvo: 9

Če želite izpisati le ocenjene elemente, lahko okrog izpisa postavite izjavo IF in preverite, ali je bil odgovor na trenutno podvprašanje z uporabo:

{ if( ! is_empty( q3_SQ001 ), join( "- ", q3_SQ001.question, ": ", q3_SQ001.shown ), "" ) }

Uporabite funkcijo listifop , če na primer želite izpisati samo seznam izbranih elementov, večjih od osem, npr.: Audi / Volvo

{ listifop( 'vrednost', '>', 8, 'vprašanje', ' / ', that.q3.sgqa ) }

Vprašanje z dvema lestvicama

Predpostavimo, da so uporabljene naslednje kode:

• Oznaka vprašanja: q4
• Oznaka podvprašanja: SQ001, SQ002, ...
• Oznake odgovorov na lestvici 1: A1, A2, ...
• Oznake odgovorov na lestvici 2: B1, B2, ...

Template:Opomba

Izpišemo rezultate za obe lestvici in prvi dve podvprašanji:

- {q4_SQ001_0.vprašanje}: {q4_SQ001_0.prikazano} / {q4_SQ001_1.prikazano}

- {q4_SQ002_0.vprašanje}: {q4_SQ002_0.prikazano} / {q4_SQ002_1.prikazano}

Če želite izpisati besedilo podvprašanja, morate nadomestnemu mestu dodati ID lestvice (čeprav sta besedili enaki za obe lestvici). Torej namesto {q4_SQ001.question} moramo uporabiti {q4_SQ001_0.question} ali {q4_SQ001_1.question}.

Če želite izvoziti/prikazati rezultate podvprašanj z vsaj enim odgovorom, uporabite to sintakso za vsako podvprašanje:

{if(count(q4_SQ001_0,q4_SQ001_1)>0,join("- ",q4_SQ001_0.vprašanje,": ",q4_SQ001_0.prikazano," / ",q4_SQ001_1.prikazano),"")}

Vprašanje z lestvicama X in Y

To velja za vsa matrična vprašanja, ki omogočajo odgovor za vsako celico (ne le za vsako vrstico, kot je prikazano prej):

• Matrična besedila
• Matrična števila

Uporabljene domnevne kode:

• Oznaka vprašanja: q5
• Oznaka podvprašanja: SQ001, SQ002, ...
• Oznaka odgovora: A1, A2, ...

Če se želite sklicevati na rezultat določenega podvprašanja iz določenega stolpca, morate uporabiti QuestionCode. '_'. Koda podvprašanja. '_'. AnswerCode. Primer sklicevanja na odgovor tretjega podvprašanja in drugega stolpca: q5_SQ003_A2.

Izpišimo rezultate za stolpce 1-3 prvih dveh podvprašanj:

- {q5_SQ001_A1.vprašanje}: {q5_SQ001_A1.prikazano} | {q5_SQ001_A2.prikazano} | {q5_SQ001_A3.prikazano}

- {q5_SQ002_A1.vprašanje}: {q5_SQ002_A1.prikazano} | {q5_SQ002_A2.prikazano} | {q5_SQ002_A3.prikazano}

Ker pri teh vrstah vprašanj vsaka celica (kombinacija osi X in osi Y) ustreza eni možnosti odgovora, je treba za vsako celico opraviti preizkus obstoječih podatkov. primer:

{if(!is_empty(q5_SQ001_A1),join("- ",q5_SQ001_A1.vprašanje,": ",q5_SQ001_A1.prikazano),"")}

Template:Opomba

Skrij vprašanje, če je odgovor prejšnjega vprašanja prazen

Namen	Skrij vprašanje, če je odgovor prejšnjega vprašanja prazen
Vrsta	Ustreznost vprašanja
Primer	Vprašanje eno: koda vprašanja "ime", besedilo vprašanja "Kako ti je ime?" Drugo vprašanje: besedilo vprašanja "{name}, koliko si star?" Narediti: Skrij drugo vprašanje, če je besedilno polje prvega vprašanja prazno
Izraz	!is_empty(name)
Description	is_empty() določa, ali spremenljivka velja za prazno. "!" izniči rezultat. Torej, če spremenljivka ni prazna, bo izraz resničen in prikazano je vprašanje
Koraki	Ustvari/uredi drugo vprašanje Vstavite »!is_empty(name)« v »Enačbo ustreznosti:«
Vzorčna datoteka	Hide_question_if_empty_question_group.zip
Datoteka:Skrij vprašanje, če je prazno 1.pngDatoteka:Skrij vprašanje, če je prazno 2.png

Skrij skupino vprašanj, če je odgovor prejšnjega vprašanja Da ali Ne

Namen	Skrij skupino vprašanj, če je odgovor prejšnjega vprašanja Da ali Ne
Vrsta	Skupina vprašanj Ustreznost
Primer	Stran ena, skupina vprašanj ena, vprašanje ena: koda vprašanja "PET", besedilo vprašanja "Ali imate hišnega ljubljenčka?" -Da -Ne Stran dve, skupina vprašanj dve: Naslov "O vaših hišnih ljubljenčkih" Narediti: Pokaži/skrij drugo skupino vprašanj, če je odgovor prvega vprašanja Da/Ne
Izraz	PET == "Y"
Opis	PET je kodo vprašanja za vprašanje, na katerega želite preveriti odgovor. Če ne uporabljate pripone, bo EM uporabil "Qcode.code". Torej primerjate kodo odgovora iz vprašanja PET z vrednostjo "Y". Če udeleženec odgovori z "Da", je izraz resničen in prikazana bo skupina vprašanj "O vaših hišnih ljubljenčkih".
Koraki	Ustvarite/uredite skupino vprašanj dve Vstavite "PET == "Y"" v "Enačbo ustreznosti:"
Vzorčna datoteka	Skrij skupino vprašanj_if_answer_from_previous_question_is_Yes_or_No. zip
Datoteka:Skrij skupino vprašanj, če je odgovor prejšnjega vprašanja Da ali Ne 1.pngDatoteka:Skrij vprašanje skupina, če je odgovor prejšnjega vprašanja Da ali Ne 2.png

Prikaz vrednosti polja z vprašanji za vnos več odgovorov

Namen	Prikaz vrednosti polja za vnos vprašanja z več odgovori
Vrsta	Sklic
Primer	Prvo vprašanje : koda vprašanja "AskChildAge", besedilo vprašanja "Koliko so stari vaši otroci?". Kode podvprašanj -Otrok1 -Otrok2 -Otrok3 -OtrokXXX Drugo vprašanje: koda vprašanja "ReportChildAge" besedilo vprašanja "O vašem prvem otroku: - CHILD1 je STAR1."
Izraz	{AskChildAge_Child1.question}, {AskChildAge_Child1.value}
Opis	Želite uporabiti vrednost podvprašanja v naslednjem vprašanju. Do vrednosti podvprašanja lahko dostopate s to vrsto izraza: QcodeQuestion_QcodeSubquestion.value
Koraki	Ustvarite/uredite drugo vprašanje V opis vstavite to besedilo: "O vašem prvem otroku: - {AskChildAge_Child1.question} je {AskChildAge_Child1.value}."
Vzorčna datoteka	Display_value_of_a_multiple_answer_input_question _polje. zip
Datoteka:Display value of a multiple answer input question field 1.png

Potrdi število odkljukanih polj na vrstico za vprašanje "Potrditveno polje niza (števil)"

Namen	Potrdi število odkljukanih polj na vrstico
Tip	Validacija
Primer	Vprašanje vrste " Matrična števila (postavitev potrditvenega polja)"
Izraz	vsota(...)
Opis	(vsota(Preizkus_A_1, Preizkus_A_2, Preizkus_A_3, Preizkus_A_4, Preizkus_A_5) <= X) določa, ali je označenih najmanj X potrditvenih polj v vrstici A. Če želite preveriti vse tri vrstice (A, B, C), lahko izraz povežete z uporabo "&&": (vsota (Test_A_1, Test_A_2, Test_A_3, Test_A_4, Test_A_5) <= X) && (vsota (Test_B_1, Test_B_2, Test_B_3, Test_B_4, Test_B_5) <= X) && (vsota(Test_C_1, Test_C_2, Test_C_3, Test_C_4, Test_C_5) <= X)
Koraki	Ustvarite/uredite vprašanje tipa "Matrika števil (postavitev potrditvenega polja)". Vstavite zgornji izraz v »Enačbo za preverjanje vprašanja« v naprednih nastavitvah vprašanja (morda boste morali prilagoditi poimenovanja spremenljivk!).
Vzorčna datoteka	Potrdite število polja označbe na vrstico za matriko (števila) Checkbox.lss
Datoteka: Preveri število polj oznak na vrstico za matriko ( Številke) Potrditveno polje 05.pngDatoteka: Preveri število polj tickerja na vrstico za polje (številke) Potrditveno polje 1.png

Calculate difference between two dates

Purpose	Calculate difference between two dates
Type	Relevance / Equation question type / Validation
Example	Question one (date/time, code: DOB): What is your date of birth? Question two (date/time, code: datetoday): What is the date today? Question three (boilerplate): You are XXXX days old. To do: Calculate and display the number of days between the date given in question 1 and the question 2.
Expression	{(strtotime(datetoday)-strtotime(DOB))/60/60/24}
Description	strtotime calculates the number of seconds between the 1st of January 1970 and the given date. The above expression calculates the number of seconds between the two given dates. The term "/60/60/24" just calculates the number of days from the number of seconds. Instead of asking for the "datetoday", you can also use strtotime('now') or simply time(), which directly returns the number of seconds from January 1970 until now (i.e. the time the survey was taken). Thus you could quickly figure out the age of a person in years with the equation {(time() - strtotime(DOB)) / 60 / 60 / 24 / 365.25} In any of these cases, it is critical that the date is entered in a proper format, otherwise the strtotime() function will not work right.
Steps	Create two date questions (for the date of birth and for today's date) and a boilerplate question. In the question text of the boilerplate question insert: "On {datetoday} you were {(strtotime(today)-strtotime(dob))/60/60/24} days days old." Please note: The function strtotime can work with MANY but not all date formats. If you run into problems set your survey's date format to mm/dd/yyyy or yyyy-mm-dd or dd.mm.yyyy"
Sample File	Date_difference.zip

Using ExpressionScript for Assessments

Here comes another example on how to use the ExpressionScript with Array type questions and assessments:</ br>

Let's say you have 2 array questions and you want to save the results of the calculation data to your database. It is actually simple, you will need to create and test your arrays and submit a dummy response to see if it works and gives you the results in the completed page.

Implementation details:

• add a question of type equation
• add the following line assuming that Q1 is your array question code while Q2 is the second one:

  • {sum(Q1_SQ001.value,Q2_SQ001.value)}

Note that SQ001 is the default code for any subquestion. If you change the subquestion code, adjust the equation above accordingly.

Using em_validation_q in array

You can use the question validation equation to control an array with any condition.

Implementation details:

• for the first array : array of single choice
  • Question code is ARRAY
  • Sub question code are SQ01,SQ02,SQ03 and SQ04
  • update the Whole question validation equation and put

    !is_empty(ARRAY_SQ01) and !is_empty(ARRAY_SQ03) 

• for the second array : array of text
  • Question code is ARRAYTEXT
  • Sub question at Y axis code are SY01,SY02,SY03, and SY04
  • Update the Whole question validation equation and put

    count(self.sq_SY01 >= 1) and count(self.sq_SY03 >= 3)