ExpressionScript példák

Struktúra

A cikk első része leírja, hogy mire használhatók a kifejezések, és hol találhat/adhat hozzá kifejezést. A második rész példákat mutat be az Expression használatára.

Kifejezések kategóriái

A LimeSurvey a következő célokra használja a kifejezéseket:

• Relevancia
• Validation
• Szövegkimenet! N!* Answers Storing

Relevancia

Cél: kérdéscsoportok/kérdések elrejtése

A relevancia határozza meg, hogy egy kérdéscsoport vagy kérdés megjelenjen-e vagy rejtve legyen. Ha a kifejezés eredménye "igaz" (azaz 1), akkor az elem megjelenik. Ellenkező esetben (ha a kifejezés eredménye "false" (azaz 0)), az elem el lesz rejtve.

Típus	Megjelenít/rejti	Hol található	Képernyőkép
Kérdéscsoport Relevancia	Kérdéscsoport	Kérdéscsoport létrehozása/szerkesztése -> "Relevanciaegyenlet:"	30px
Kérdés Relevancia	question	Kérdés létrehozása/szerkesztése -> "Relevanciaegyenlet:"	File:Question Relevance equation screenshot.png
Alkérdés Relevancia	Subquestion	Alkérdések szerkesztése -> "Relevanciaegyenlet:"	30px

Érvényesítés

Cél: A kérdések/alkérdések/válaszok bemenetének/műveleteinek ellenőrzése

Az érvényesítés szabályozza, hogy a válaszadó kérdéshez vagy művelethez való hozzájárulása érvényes-e vagy sem. Ha a kifejezés eredménye "igaz" (azaz 1), akkor a "jó" osztály kerül alkalmazásra az elemre és az érvényesítési üzenetre. Ellenkező esetben, ha a kifejezés eredménye "false" (azaz 0), akkor az "error" osztály kerül alkalmazásra az elemre és az érvényesítési üzenetre. Ezekhez az osztályokhoz stílust deklarálhat a 'template.css fájlban.

Típus	Érvényesítések	Hol található	Képernyőkép
Kérdés ellenőrzése	kérdés	Kérdés létrehozása/szerkesztése -> "Logika lap" - > "Kérdésérvényesítési egyenlet"
Részkérdés ellenőrzése	alkérdések	Kérdés létrehozása/szerkesztése -> "Logika lap" -> " Alkérdés érvényesítési egyenlete"	‎ ‎

Szövegkimenet

Célok: (Csinálj valamit) és írj ki szöveget

Egy kifejezés használható szöveg kiírásához. Például tesztelhet vagy kiszámíthat valamit, és megadhatja a kimenetet a teszt vagy számítás eredményétől függően. Használható a Kifejezés használata előtt használt kérdés szövegének, válaszainak, kérdéstípusainak, ... beszúrására is. A szövegkimenet mindenhol használható, ahol szöveg jelenik meg, és mindenféle eredményt visszaadhat.

Use Case	Leírás
Mikroszabás	Szöveg módosítása, pl.: "Mr" vagy "Mrs" a korábban feltett nemi kérdéstől függően
Számítás	Számítson ki egy értéket, és írja ki, pl.: "Család jövedelme xxx"
Referencia	Szöveg beszúrása egy elemből, pl. "A neved xxx. Hány éves vagy?"

A válaszok tárolása

Célok: (Csinálj valamit,) (írj ki egy kis szöveget) és tárolj valamit az adatbázisban

A Az egyenlet kérdéstípusa használható valaminek az adatbázisban való tárolására. Egy kifejezéssel csinálhatsz valamit, megjelenítheted az Egyenletkérdést (ami hasonló a szöveges megjelenítés), és a kifejezés eredményét eltárolhatod az adatbázisban. A választ a választáblázatban tárolja. Ezután az eredmény felhasználható a statisztikai szolgáltatáson belül, vagy importálható a LimeSurvey exportálási funkciója által biztosított formátumok valamelyikébe.

Példák kifejezésekre

Szúrjon be egy korábbi kérdésre adott választ

Cél	Egy korábbi kérdés válaszának beszúrása
Típus	Hivatkozás
Példa	Első kérdés (kérdéskód " Q00"): Melyik városban élsz? Második kérdés (kérdéskód "Q01") Mióta él a CITY-ben? Teendő: A második kérdés "VÁROS" helyett az első kérdés válaszát kell használni.
Kifejezés	{QOO}
Leírás	A Q00-ban megadott válasz a második kérdés Q00 mezőjét helyettesíti
Lépések	Kettes kérdés létrehozása/szerkesztése Illessze be a "Mennyi ideig élt {QOO} (év)" szöveggel? a kérdés szövegmezőjébe
Fájl:Egyszerű kifejezés városnév.png

Rejtett egyenletkérdés használata a válasz automatikus kitöltéséhez

Probléma: Képzeld el, hogy két kérdése van: Q1 és Q2. Q1 megkérdezi a válaszadók életkorát. A Q2 három csoportra osztja a válaszadókat: életkor 20 év alatti, 20 év feletti, 20 év feletti. Tehát a Q2-nek az "1", "2", "3" értékeket kell használnia, amelyek megfelelnek a a fenti feltételeket. Nem szabad megfeledkeznünk a Q2 láthatatlanná tételéről sem (a kérdés nem jelenik meg a kérdőívben, hanem az értékek a választáblázaton belüli "háttérfolyamat"-on keresztül).

Az adatbázis kitöltéséhez az Egyenlet kérdéstípus használatával:

• Először hozzon létre egy kérdést Q1 kóddal numerikus beviteli kérdésként.
• Ezután hozzon létre egy másik kérdést Q2 kóddal egyenletkérdésként .
• A Q2:
  • "Megjelenítési beállítások" lapfejezetében állítsa a "Mindig elrejteni ezt a kérdést" mezőt "Be" értékre
  • írja be az "Egyenlet" mezőbe a következő kifejezést:

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

Összefoglaló oldal létrehozása helyőrzők használatával

Ez az oktatóanyag bemutatja, hogyan hozhat létre áttekintést a felmérés végén, felsorolva az összes kérdést és választ a ExpressionScript helyőrzők segítségével. Azt is bemutatja, hogyan korlátozza az ilyen áttekintést a megválaszolt kérdésekre.

Példánk innen tölthető le: Survey placeholders survey example.

'Az itt használt kérdéstípusok:'

1. Egyválasztós kérdések / egyetlen szöveges/numerikus kérdések

• Lista (legördülő)
• Lista (rádió) [L]
• Igen/Nem [I]
• Hosszú szabad szöveg [T ]
• Rövid szabad szöveg [S]
• Numerikus bevitel [N]
• Egyenlet [*]

'2. Kérdés alkérdésekkel

• Több rövid szöveg [Q]
• Többszörös választás [M]
• Tömb [F]
• Tömb (Igen/Nem/Bizonytalan) [C]
• Tömb (10 pontos választás) [B]

'3. Kérdések 2 skálával

• Kettős skálájú tömb [1]

'4. Kérdések X és Y skálákkal

• Tömb (számok) [:]

'5. Maszk kérdések

• Szöveg megjelenítése [X]

Ebben az egyszerű példában az áttekintésünk egy egyszerű lista lesz:

- Kérdés szövege: Felhasználó válasza

Egyválasztós kérdések / egyetlen szöveges/numerikus kérdések

A Limesurvey az összes ilyen típusú kérdésre egyetlen választ tárol:

• Lista (legördülő)
• Lista (rádió)
• Lista megjegyzéssel
• 5 pontos választás
• Igen/Nem
• Rövid szabad szöveg
• Hosszú szabad szöveg
• Hatalmas szabad szöveg
• Numerikus bevitel
• Egyenlet
• Dátum
• Nem

Feltételezve, hogy a kérdés kérdéskódja q1, akkor a kérdés szövegére hivatkozhatunk és válaszolhatunk:

- {q1.question}: {q1.shown}

Példa:

- Hány éves vagy?: 25

Ha ellenőrizni szeretné, hogy a kérdés megválaszolásra került-e, a kimenet köré írhat egy IF utasítást:

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

Ez a következőre "fordítható": HA a q1 kódú kérdés nem üres, "- " ÉS a kérdés szövege ÉS ": " ÉS a válaszszöveg (a join() függvény új karakterláncként kapcsolja össze az elemeket; ELSE: nem ad ki semmit (" " üres karakterláncot jelent).

Kérdés alkérdésekkel

A LimeSurvey az összes ilyen kérdéstípushoz alkérdéseket használ:

• Több rövid szöveg
• Több választási lehetőség
• Többszörös választási lehetőség megjegyzésekkel
• Tömb
• Tömb (5 pontos választás)
• Tömb (10 pontos választás)
• Tömb (Igen /Nem/Bizonytalan)
• Tömb (Növekedés/Azonos/Csökkentés)
• Oszloponkénti tömb

Feltételezve, hogy a kérdés kérdéskódja q2, és az alkérdések számozása SQ001, SQ002, (az automatikus számozást a LimeSurvey végzi), akkor a kérdés szövegére és a válaszadásra a következő módon hivatkozhatunk:

- {q2_SQ001.question}: {q2_SQ001.shown}

- {q2_SQ002.question}: {q2_SQ002.shown}

A feleletválasztós kérdéseknél érdemes most a bejelölt részkérdés szövegét megjeleníteni, de minden kiválasztott opciónál Y-t kell mutatni:

- {q2_SQ001.question}: {q2_SQ001}

- {q2_SQ002.question}: {q2_SQ002}

...

Vegye figyelembe, hogy jelenleg nem lehetséges az alkérdéseket tartalmazó kérdések kérdésszövege kiadni, lásd ez a szolgáltatáskérés.

1. példa (feltéve, hogy a kérdés típusa feleletválasztós)

- Ismeri ezeket az autómárkákat?

-- Mercedes: Y

-- Audi: N

-- Volvo: Y

Ha csak a bejelölt elemeket szeretné kiadni, akkor a kimenet köré helyezhet egy IF utasítást, és ellenőrizze a jelölőnégyzet értékét:

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

Használja a listifop funkciót, ha csak a kiválasztott elemeket szeretné megjeleníteni, pl.: Mercedes, Volvo

{ listifop( 'value', '==', 'Y', 'question', ', ', that.q2.sgqa ) }

Ahol az.q2 kiterjeszti a q2 összes részkérdését. További részletekért lásd: self, this and that.

2. példa (feltételezve, hogy a kérdés típusa Array (10 pontos választás))

- Kérjük, értékelje az alábbi autómárkák minőségét egy 1=nagyon rossz és 10=nagyon jó közötti skálán?

-- Mercedes: 7

-- Audi: 9

-- Volvo: 9

Ha csak minősített tételeket szeretne kiadni, akkor a kimenet köré írhat egy IF utasítást, és ellenőrizze, hogy az aktuális alkérdésre a következő használatával válaszolt-e:

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

Használja a listifop funkciót, ha például csak nyolcnál nagyobb kiválasztott elemek listáját szeretné megjeleníteni, pl.: Audi / Volvo

{ listifop( 'value', '>', 8, 'question', ' / ', that.q3.sgqa ) }

Két skálájú kérdés

Tegyük fel, hogy a következő kódok használatban vannak:

• Kérdéskód: q4
• Kérdéskódok: SQ001, SQ002, ...
• Válaszkódok 1-es skála: A1, A2, ...
• A válaszkódok skála 2: B1, B2, ...

Template:Megjegyzés

Adjuk ki mindkét skála és az első két részkérdés eredményeit:

- {q4_SQ001_0.question}: {q4_SQ001_0.shown} / {q4_SQ001_1.shown}

- {q4_SQ002_0.question}: {q4_SQ002_0.shown} / {q4_SQ002_1.shown}

Az alkérdés szövegének kiadásához hozzá kell adni a skálaazonosítót a helyőrzőhöz (bár a szövegek mindkét skála esetében azonosak). Tehát a {q4_SQ001.question} helyett a {q4_SQ001_0.question} vagy a {q4_SQ001_1.question} kifejezést kell használnunk.

Ha csak legalább egy választ tartalmazó alkérdések eredményeit szeretné exportálni/megjeleníteni, használja ezt a szintaxist minden alkérdésnél:

{if(count(q4_SQ001_0,q4_SQ001_1)>0,join("- ",q4_SQ001_0.question,": ",q4_SQ001_0.shown," / ",q4_SQ001_1.shown),"")}

Kérdés X és Y skálával

Ez vonatkozik minden olyan mátrixkérdésre, amely minden cellára választ ad (nem csak minden sorra, ahogyan korábban látható):

• Tömbszövegek
• Tömbszámok

Felhasznált feltételezett kódok:

• Kérdéskód: q5
• Alkérdési kódok: SQ001, SQ002, ...
• Válaszkódok: A1, A2, ...

Ha egy adott oszlopból egy bizonyos alkérdés eredményére szeretne hivatkozni, akkor a QuestionCode-ot kell használnia. '_' . SubQuestionCode. '_' . Válaszkód. Példa a harmadik részkérdés és a második oszlop válaszára való hivatkozásra: q5_SQ003_A2.

Adjuk ki az első két részkérdés 1-3. oszlopának eredményeit:

- {q5_SQ001_A1.question}: {q5_SQ001_A1.shown} | {q5_SQ001_A2.shown} | {q5_SQ001_A3.shown}

- {q5_SQ002_A1.question}: {q5_SQ002_A1.shown} | {q5_SQ002_A2.shown} | {q5_SQ002_A3.shown}

Mivel ezeknél a kérdéstípusoknál minden cella (X tengely és Y tengely kombinációja) egy válaszlehetőséget jelent, minden cellánál el kell végezni a meglévő adatok tesztelését. Példa:

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

To output the subquestion text you need to add the answer code to the placeholder (though the texts are the same for all answer options). So instead of {q5_SQ001.question} we have to use {q5_SQ001_A1.question} or {q5_SQ001_A2.question}.

Hide question if answer from previous question is empty

Purpose	Hide question if answer from previous question is empty
Type	Question Relevance
Example	Question one: question code "name", question text "What's your name?" Question two: question text "{name}, how old are you?" To do: Hide question two if the textfield of question one is empty
Expression	!is_empty(name)
Description	is_empty() determines whether a variable is considered to be empty. The "!" negates the result. So if the variable is not empty the Expression will be true and the question is shown
Steps	Create/edit question two Insert "!is_empty(name)" into "Relevance equation:"
Sample File	Hide_question_if_empty_question_group.zip

Hide question group if answer from previous question is Yes or No

Purpose	Hide question group if answer from previous question is Yes or No
Type	Question group Relevance
Example	Page one, Question Group one, Question one: question code "PET", question text "Do you have a pet?" -Yes -No Page two, Question Group two: Title "About your pet(s)" To do: Show/Hide question group two if answer from question one is Yes/No
Expression	PET == "Y"
Description	PET is the question code for the question you want to check the answer. If you don't use a suffix EM will use "Qcode.code". So you compare the answer code from the PET question to the value "Y". If the participant answers "Yes" the Expression is true and the question group "About your pet(s)" will be shown.
Steps	Create/edit question group two Insert "PET == "Y"" into "Relevance equation:"
Sample File	Hide_question group_if_answer_from_previous_question_is_Yes_or_No.zip

Display value of a multiple answer input question field

Purpose	Display value of a multiple answer input question field
Type	Reference
Example	Question one: question code "AskChildAge", question text "How old are your children?". Subquestions codes -Child1 -Child2 -Child3 - ChildXXX Question two: question code "ReportChildAge" question text "About your first child: - CHILD1 is AGE1."
Expression	{AskChildAge_Child1.question}, {AskChildAge_Child1.value}
Description	You want to use the value of a subquestion in a following question. You can access the subquestion value with this kind of expression: QcodeQuestion_QcodeSubquestion.value
Steps	Create/edit the second question Insert this text in the description: "About your first child: - {AskChildAge_Child1.question} is {AskChildAge_Child1.value}."
Sample File	Display_value_of_a_multiple_answer_input_question_field.zip

Validate number of boxes ticked per row for an "Array (Numbers) Checkbox" question

Purpose	Validate number of boxes ticked per row
Type	Validation
Example	Question of type "Array Numbers (Checkbox Layout)"
Expression	sum(...)
Description	(sum(Test_A_1, Test_A_2, Test_A_3, Test_A_4, Test_A_5) <= X) determines whether at least X checkboxes in row A are checked. If you want to check all three rows (A, B, C), you can connect the expression using "&&": (sum(Test_A_1, Test_A_2, Test_A_3, Test_A_4, Test_A_5) <= X) && (sum(Test_B_1, Test_B_2, Test_B_3, Test_B_4, Test_B_5) <= X) && (sum(Test_C_1, Test_C_2, Test_C_3, Test_C_4, Test_C_5) <= X)
Steps	Create/edit question of type "Array Numbers (Checkbox Layout)". Insert the above expression into "Question validation equation" at the advanced question settings (you might have to adjust variable namings!).
Sample File	Validate number of boxes ticker per row for an Array (Numbers) Checkbox.lss

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)