ExpressionScript examples/ro: Difference between revisions
From LimeSurvey Manual
Maren.fritz (talk | contribs) (Created page with "<pre>{ listefop( 'valoare', '>', 8, 'întrebare', ' / ', that.q3.sgqa ) }</pre>") |
Maren.fritz (talk | contribs) (Created page with "===Întrebare cu două scale===") |
||
Line 277: | Line 277: | ||
</br> | </br> | ||
=== | ===Întrebare cu două scale=== | ||
{{ | {{Notă|Acest lucru se aplică numai tipului de întrebare cu scară duală.}} | ||
Revision as of 11:07, 9 November 2023
Structură
Prima parte a articolului va descrie pentru ce pot fi folosite expresiile și unde să găsiți/adăugați o expresie. A doua parte oferă exemple despre cum să utilizați Expression.
Categorii de expresii
LimeSurvey folosește expresii în următoarele scopuri:
Relevanța
Scop: ascunderea grupurilor de întrebări/întrebări
Relevanța controlează dacă un grup de întrebări sau o întrebare este afișat sau ascuns. Dacă rezultatul expresiei este „adevărat” (adică 1), elementul va fi afișat. În caz contrar (dacă rezultatul expresiei este „fals” (adică 0)), elementul va fi ascuns.
Tip | Afișează/ascunde | Unde se găsește | Captură de ecran |
---|---|---|---|
Grup de întrebări Relevanță | grup de întrebări | Creează/Editează grup de întrebări -> „Ecuația relevanței:” | |
Relevanța întrebării | întrebare | Creați/Editați întrebarea -> „Ecuația relevanței:” | |
Subchest Relevance | subintrebare | Editează subîntrebările -> „Ecuația relevanței:” | File:Subchetion relevance equation screenshot. png |
Validare
Scop: validarea intrărilor/acțiunilor la întrebări/subîntrebări/răspunsuri
Validarea controlează dacă contribuția respondentului într-o întrebare sau o acțiune este validă sau nu. Dacă rezultatul expresiei este „adevărat” (adică 1), clasa „bună” va fi aplicată elementului și mesajului de validare. În caz contrar, dacă rezultatul expresiei este „fals” (adică 0)), clasa „eroare” va fi aplicată elementului și mesajului de validare. Puteți declara un stil pentru aceste clase în template.css.
Ieșire text
Scopi: (Fă ceva) și scrie ceva text
O expresie poate fi folosită pentru a scrie un text. De exemplu, puteți testa sau calcula ceva și să specificați rezultatul în funcție de rezultatul testului sau al calculului. De asemenea, poate fi folosit pentru a insera textul întrebării, răspunsurile, tipurile de întrebări, ... ale unei întrebări utilizate înainte ca expresia să fie utilizată. Ieșirea textului poate fi folosită oriunde este afișat un text și poate returna orice fel de rezultate.
Cas de utilizare | Descriere |
---|---|
Micro croitorie | Ajustați un text, de exemplu, scrieți „Domnul” sau „Doamna” în funcție de întrebarea de gen adresată anterior |
Calcul | Calculați o valoare și scrieți-o, de exemplu, „Venitul familiei dvs. este xxx” |
Referință | Inserați un text dintr-un element, de exemplu, „Numele tău este xxx. Câți ani ai?” |
Stocarea răspunsurilor
Scopi: (Fă ceva,) (scrie ceva text) și stochează ceva în baza de date
Tipul de întrebare Ecuație poate fi folosit pentru a stoca ceva în baza de date. Puteți face ceva cu o Expresie, să afișați întrebarea Ecuație (care este similară cu un afișare text) și să stocați rezultatul expresiei în baza de date. Acesta stochează răspunsul în tabelul de răspunsuri. Apoi, rezultatul poate fi folosit în cadrul caracteristicii statistici sau poate fi importat și într-unul dintre formatele oferite de funcționalitatea de export LimeSurvey.
Exemple pentru expresii
Inserați un răspuns de la o întrebare anterioară
Utilizarea unei întrebări cu ecuație ascunsă pentru a completa automat un răspuns
Problemă: Imaginați-vă că aveți două întrebări Q1 și Q2. Q1 cere respondenților vârsta lor. Q2 împarte respondenții în trei grupuri: vârsta este sub 20 de ani, vârsta este 20, vârsta este mai mare de 20. Deci, Q2 ar trebui să utilizeze valorile „1”, „2”, „3”, care corespund cu conditiile de mai sus. De asemenea, nu trebuie să uităm să facem invizibil Q2 (întrebarea nu va fi afișată în sondaj, dar valorile vor fi prin „procesul de fundal” din tabelul de răspunsuri).
Pentru a completa baza de date folosind tipul de întrebare Ecuație:
- Mai întâi, creați o întrebare cu codul Q1 ca întrebare numerică de introducere.
- Apoi creați o altă întrebare cu codul Q2 ca întrebare de ecuație .
- În capitolul din fila „Setări afișare” din Q2:
- setați câmpul „Ascundeți întotdeauna această întrebare” ca „Activat”
- introduceți în câmpul „Ecuație” expresia:
{dacă(Q1.NAOK < 20, „1”, dacă(Q1.NAOK > 20, „3”, „2”))}
Creați o pagină de rezumat folosind substituenți
Acest tutorial demonstrează cum puteți crea o prezentare generală la sfârșitul sondajului, listând toate întrebările și răspunsurile prin substituenți ExpressionScript.
De asemenea, arată cum să limitați o astfel de prezentare generală doar la întrebările la care s-a răspuns.
Exemplul nostru poate fi descărcat de aici: Exemplu de sondaj cu substituenți de sondaj.
Tipuri de întrebări folosite aici:
1. Întrebări cu alegere unică/întrebări cu text unic/numerice
- Lista (menus derulant)
- Lista (radio) [L]
- Da/Nu [Y]
- Text lung liber [T ]
- Text scurt scurt [S]
- Introducere numerică [N]
- Ecuație [*]
2. Întrebare cu subîntrebări
- Text scurt multiplu [Q]
- Alegere multiplă [M]
- Matrice [F]
- Matrice (Da/Nu/Incert) [C]
- Matrice (alegere 10 puncte) [B]
3. Întrebări cu 2 scale
- Ray dual scale [1]
4. Întrebări cu scale X și Y
- Matrice (Numere) [:]
5. Mască întrebări
- Afișare text [X]
În acest exemplu simplu, prezentarea noastră de ansamblu va fi o listă simplă cu:
- Text întrebare: Răspunsul utilizatorului
Întrebări cu alegere unică/întrebări cu text unic/numerice
Pentru toate aceste tipuri de întrebări, Limesurvey va stoca un singur răspuns:
- Lista (menus derulant)
- Lista (radio)
- Lista cu comentariu
- Alegere 5 puncte
- Da/Nu
- Text scurt scurt
- Text lung liber
- Text liber imens
- Introducere numerică
- Ecuație
- Data
- Sex
Presupunând că codul întrebării este q1, putem face referire la textul întrebării și putem răspunde folosind:
- {q1.question}: {q1.sown}
Exemplu:
- Câți ani ai?: 25
Dacă doriți să verificați dacă s-a răspuns la această întrebare, puteți pune o declarație IF în jurul rezultatului dvs.:
{dacă(!este_gol(q1),alăturare("- ",q1.întrebare,": ",q1.arată),"")}
Aceasta „se traduce” în: DACĂ întrebarea cu codul q1 nu este goală, iese „- „ ȘI textul întrebării ȘI „: ” ȘI textul răspunsului (funcția join() unește elementele ca un șir nou; ELSE: nu scoate nimic (" " înseamnă șir gol).
Întrebare cu subîntrebări
Pentru toate aceste tipuri de întrebări, LimeSurvey folosește subîntrebări:
- Text scurt multiplu
- Alegere multiplă
- Alegere multiplă cu comentarii
- Matrice
- Matrice (5 puncte la alegere)
- Matrice (10 puncte la alegere)
- Matrice (Da /Nu/Nesigur)
- Matrice (Mărire/La fel/Scădere)
- Matrice după coloană
Presupunând că codul întrebării este q2 și că subîntrebările sunt numerotate SQ001, SQ002, (numerotare automată realizată de LimeSurvey), putem face referire la textul întrebării și putem răspunde folosind:
- {q2_SQ001.question}: {q2_SQ001.shown}
- {q2_SQ002.question}: {q2_SQ002.sown}
Pentru întrebările cu alegere multiplă, este logic să afișați acum textul subîntrebării bifate, dar să afișați un Y pentru fiecare opțiune selectată:
- {q2_SQ001.question}: {q2_SQ001}
- {q2_SQ002.question}: {q2_SQ002}
...
Rețineți că în prezent nu este posibil să scoateți textul întrebărilor cu subîntrebări, consultați această solicitare de caracteristică.
Exemplu 1 (presupunând că tipul de întrebare este cu alegere multiplă)
- Cunoașteți aceste mărci de mașini?
-- Mercedes: Da
-- Audi: N
-- Volvo: Y
Dacă doriți să scoateți numai elementele bifate, puteți pune o instrucțiune IF în jurul rezultatului și verificați valoarea casetei de selectare:
{ if( q2_SQ001=="Y", join( "- ", q2_SQ001.question, ": ", q2_SQ001.sown ), "" ) }
Utilizați funcția listfop dacă doriți să afișați o listă numai cu elementele selectate, de exemplu: Mercedes, Volvo
{ listefop( 'valoare', '==', 'Y', 'întrebare', ', ', that.q2.sgqa ) }
Unde asta.q2 se extinde la toate subîntrebările lui q2. Consultați self, this and that pentru mai multe detalii.
Exemplul 2 (presupunând că tipul de întrebare este Matrice (alegerea în 10 puncte))
- Vă rugăm să evaluați calitatea mărcilor de mașini de mai jos pe o scară de la 1=foarte rău la 10=foarte bine?
-- Mercedes: 7
-- Audi: 9
-- Volvo: 9
Dacă doriți să scoateți numai elemente evaluate, puteți pune o declarație IF în jurul rezultatului dvs. și puteți verifica dacă s-a răspuns la subîntrebarea curentă folosind:
{ dacă( ! is_empty( q3_SQ001 ), join( "- ", q3_SQ001.question, ": ", q3_SQ001. show ), "" ) }
Utilizați funcția listfop dacă, de exemplu, doriți să afișați numai o listă cu elementele selectate mai mare de opt, de exemplu: Audi / Volvo
{ listefop( 'valoare', '>', 8, 'întrebare', ' / ', that.q3.sgqa ) }
Întrebare cu două scale
Let's assume that the following codes are being used:
- Question code: q4
- Subquestion codes: SQ001, SQ002, ...
- Answer codes scale 1: A1, A2, ...
- Answer codes scale 2: B1, B2, ...
Example for referring to the answer of the third subquestion and second scale: q4_SQ003_1 - Question 4, subquestion 3, second scale.
Let's output the results for both scales and the first two subquestions:
- {q4_SQ001_0.question}: {q4_SQ001_0.shown} / {q4_SQ001_1.shown}
- {q4_SQ002_0.question}: {q4_SQ002_0.shown} / {q4_SQ002_1.shown}
To output the subquestion text, you need to add the scale ID to the placeholder (though the texts are the same for both scales). So instead of {q4_SQ001.question} we have to use {q4_SQ001_0.question} or {q4_SQ001_1.question}.
If you want to export/display the results of subquestions with at least one answer only, use this syntax for each subquestion:
{if(count(q4_SQ001_0,q4_SQ001_1)>0,join("- ",q4_SQ001_0.question,": ",q4_SQ001_0.shown," / ",q4_SQ001_1.shown),"")}
Question with X and Y scales
This applies to all matrix questions which allow an answer for every cell (not just every row as shown previously):
- Array Texts
- Array Numbers
Assumed codes used:
- Question code: q5
- Subquestion codes: SQ001, SQ002, ...
- Answer codes: A1, A2, ...
To refer to the result of a certain subquestion from a certain column, you need to use QuestionCode . '_' . SubQuestionCode . '_' . AnswerCode. Example for referring to the answer of the third subquestion and second column: q5_SQ003_A2.
Let's output the results for columns 1-3 of the first two subquestions:
- {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}
Since for these question types each cell (combination of X axes and Y axes) equals one answer option, a test for existing data needs to be done for each cell. Example:
{if(!is_empty(q5_SQ001_A1),join("- ",q5_SQ001_A1.question,": ",q5_SQ001_A1.shown),"")}
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)