Przykłady ExpressionScript

Struktura

W pierwszej części artykułu opisano, do czego można używać wyrażeń i gdzie znaleźć/dodać wyrażenie. Druga część zawiera przykłady użycia wyrażenia.

Kategorie wyrażeń

LimeSurvey używa wyrażeń w następujących celach:

• Trafność
• Walidacja
• Tekst wyjściowy! N!* Przechowywanie odpowiedzi

Trafność

Cel: Ukrycie grup pytań/pytań

Trafność kontroluje, czy grupa pytań lub pytanie są wyświetlane, czy ukrywane. Jeśli wynik wyrażenia ma wartość „true” (tzn. 1), element zostanie pokazany. W przeciwnym razie (jeśli wynikiem wyrażenia jest „fałsz” (tj. 0)) element zostanie ukryty.

Typ	Pokazuje/ukrywa	Gdzie znaleźć	Zrzut ekranu
Grupa pytań Trafność	grupa pytań	Utwórz/edytuj grupę pytań -> "Równanie istotności:"	30px
Trafność pytania	pytanie	Utwórz/edytuj pytanie -> "Równanie istotności:"	30px
Trafność podpytania	podpytanie	Edytuj pytania podrzędne -> "Równanie istotności pytania:"	30px

Weryfikacja

'Cel: sprawdzenie danych wejściowych/działań dotyczących pytań/pytań dodatkowych/odpowiedzi

Walidacja kontroluje, czy wkład respondenta w pytanie lub działanie jest prawidłowy, czy nie. Jeśli wynikiem wyrażenia jest „prawda” (tj. 1), do elementu i komunikatu walidacyjnego zostanie zastosowana klasa „dobra”. W przeciwnym razie, jeśli wynikiem wyrażenia będzie „false” (tzn. 0)), do elementu i komunikatu sprawdzającego zostanie zastosowana klasa „error”. Możesz zadeklarować styl dla tych klas w pliku „template.css”.

Typ	Weryfikacja	Gdzie znaleźć	Zrzut ekranu
Weryfikacja pytania	pytanie	Utwórz/edytuj pytanie -> "Karta Logika" - > "Równanie sprawdzania poprawności pytania"	30px
Weryfikacja podpytania	podpytania	Utwórz/Edytuj pytanie -> "Zakładka Logika" -> " Równanie sprawdzające poprawność podpytania"	30px ‎

Wyjście tekstowe

Cele: (Zrób coś) i napisz jakiś tekst

Do zapisania tekstu można użyć wyrażenia. Na przykład możesz przetestować lub obliczyć coś i określić wynik w zależności od wyniku testu lub obliczenia. Można go również użyć do wstawienia tekstu pytania, odpowiedzi, typów pytań, ... pytania użytego przed użyciem wyrażenia. Wynik tekstowy może być używany wszędzie tam, gdzie wyświetlany jest tekst i może zwracać wszelkiego rodzaju wyniki.

Przypadek użycia	Opis
Mikro krawiectwo	Dostosuj tekst, np. napisz „Pan” lub „Pani” w zależności od zadanego wcześniej pytania dotyczącego płci
Obliczenia	Oblicz wartość i zapisz ją, np. „Dochód Twojej rodziny wynosi xxx”
Referencja	Wstaw tekst z elementu, np. „Masz na imię xxx. Ile masz lat?”

Przechowywanie odpowiedzi

Cele: (zrobić coś) (napisać jakiś tekst) i zapisać coś w bazie danych

Typ pytania z równania można wykorzystać do przechowywania czegoś w bazie danych. Możesz coś zrobić z wyrażeniem, wyświetlić pytanie z równania (które jest podobne do wyświetlanie tekstu) i zapisać wynik wyrażenia w bazie danych. Zapisuje odpowiedź w tabeli odpowiedzi. Następnie wynik można wykorzystać w funkcji statystycznej lub można go również zaimportować do jednego z formatów udostępnianych przez funkcję eksportu LimeSurvey.

Przykłady wyrażeń

Wstaw odpowiedź z poprzedniego pytania

Cel	Wstaw odpowiedź z poprzedniego pytania
Typ	Referencja
Przykład	Pytanie pierwsze (kod pytania " Q00"): W jakim mieście mieszkasz? Pytanie drugie (kod pytania „Q01”) Jak długo mieszkasz w MIEŚCIE? Sposób wykonania: Należy użyć odpowiedzi z pytania pierwszego zamiast "MIASTO" z pytania drugiego.
Wyrażenie	{QOO}
Opis	Odpowiedź podana w Q00 zastępuje pole Q00 z drugiego pytania
Kroki	Utwórz/edytuj pytanie drugie Wstaw „Jak długo mieszkasz w {QOO} (lata)?” do pola tekstowego pytania
Plik:Nazwa miasta prostego wyrażenia.png

Używanie ukrytego pytania z równaniem do automatycznego wypełniania odpowiedzi

Problem: Wyobraź sobie, że masz dwa pytania Q1 i Q2. W pytaniu pierwszym pyta się respondentów o wiek. Q2 dzieli respondentów na trzy grupy: wiek poniżej 20 lat, wiek 20 lat, wiek powyżej 20 lat. Więc w Q2 należy posługiwać się wartościami „1”, „2”, „3”, które odpowiadają powyższe warunki. Nie powinniśmy także zapominać o ukryciu Q2 (pytanie nie będzie wyświetlane w ankiecie, ale wartości będą przekazywane w ramach „procesu w tle” w tabeli odpowiedzi).

Aby wypełnić bazę danych za pomocą pytania z równania, wpisz:

• Najpierw utwórz pytanie z kodem Q1 jako pytaniem do wprowadzania danych liczbowych.
• Następnie utwórz kolejne pytanie z kodem Q2 jako pytaniem z równaniem .
• W zakładce „Ustawienia wyświetlania” w rozdziale Q2:
  • w polu „Zawsze ukrywaj to pytanie” ustaw wartość „Wł.”
  • w polu „Równanie” wpisz wyrażenie:

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

Utwórz stronę podsumowania, używając symboli zastępczych

W tym samouczku pokazano, jak utworzyć przegląd na końcu ankiety, zawierający listę wszystkich pytań i odpowiedzi za pomocą symboli zastępczych ExpressionScript. Pokazuje także, jak to zrobić ograniczyć taki przegląd wyłącznie do pytań, na które udzielono odpowiedzi.

Nasz przykład można pobrać stąd: Przykład ankiety dotyczącej symboli zastępczych ankiety.

Typy pytań używane tutaj:

'1. Pytania pojedynczego wyboru / pojedynczy tekst/pytania numeryczne

• Lista (rozwijana)
• Lista (radio) [L]
• Tak/Nie [T]
• Długi tekst [T ]
• Krótki tekst dowolny [S]
• Wprowadzenie numeryczne [N]
• Równanie [*]

2. Pytanie z pytaniami podrzędnymi

• Wiele krótkich tekstów [Q]
• Wielokrotny wybór [M]
• Tablica [F]
• Tablica (Tak/Nie/Niepewne) [C]!N !*Tablica (wybór za 10 punktów) [B]

3. Pytania z 2 skalami

• Tablica z podwójną skalą [1]

4. Pytania ze skalą X i Y

• Array (Liczby) [:]

5. Maskuj pytania

• Wyświetlanie tekstu [X]

W tym prostym przykładzie naszym przeglądem będzie prosta lista zawierająca:

- Treść pytania: Odpowiedź użytkownika

Pytania jednokrotnego wyboru / pytania tekstowe/numeryczne

Dla wszystkich tych typów pytań Limesurvey będzie przechowywać jedną odpowiedź:

• Lista (rozwijana)
• Lista (radio)
• Lista z komentarzem
• Wybór za 5 punktów
• Tak/Nie
• Krótki tekst dowolny
• Długi tekst dowolny!N !*Ogromny tekst
• Wprowadzanie liczbowe
• Równanie
• Data
• Płeć

Zakładając, że kod pytania to q1, możemy odwoływać się do tekstu pytania i odpowiedzi za pomocą:

- {q1.question}: {q1.pokazane}

Przykład:

- Ile masz lat?: 25

Jeśli chcesz sprawdzić, czy udzielono odpowiedzi na to pytanie, możesz umieścić instrukcję JEŻELI wokół wyniku:

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

To „przekłada się” na: JEŻELI pytanie z kodem q1 nie jest puste, wypisz „-” ORAZ tekst pytania AND „:” ORAZ tekst odpowiedzi (funkcja Join() łączy elementy jako nowy ciąg znaków; W przeciwnym razie: nie wypisz niczego („ " oznacza pusty ciąg znaków).

Pytanie z pytaniami podrzędnymi

Dla wszystkich tych typów pytań LimeSurvey używa pytań podrzędnych:

• Kilka krótkich tekstów
• Wielokrotny wybór
• Wielokrotny wybór z komentarzami
• Tablica
• Tablica (wybór za 5 punktów)
• Tablica (wybór za 10 punktów)
• Tablica (Tak /Nie/Niepewne)
• Tablica (zwiększ/tak samo/zmniejsz)
• Tablica według kolumn

Zakładając, że kod pytania to q2, a pytania podrzędne mają numery SQ001, SQ002 (automatyczne numerowanie wykonane przez LimeSurvey), możemy odnieść się do tekstu pytania i odpowiedzi za pomocą:

- {q2_SQ001.question}: {q2_SQ001.pokazano}

- {q2_SQ002.question}: {q2_SQ002.pokazano}

W przypadku pytań wielokrotnego wyboru sensowne jest teraz pokazanie tekstu zaznaczonego pytania podrzędnego, ale pokazanie Y dla każdej wybranej opcji:

- {q2_SQ001.pytanie}: {q2_SQ001}

- {q2_SQ002.pytanie}: {q2_SQ002}

...

Należy pamiętać, że obecnie nie jest możliwe wygenerowanie tekstu pytań z pytaniami podrzędnymi, zobacz tę prośbę o funkcję.

Przykład 1 (zakładając, że typ pytania to pytania wielokrotnego wyboru)

- Czy znasz te marki samochodów?

-- Mercedes: Y

--Audi: N

-- Volvo: T

Jeśli chcesz wyprowadzić tylko zaznaczone elementy, możesz umieścić instrukcję IF wokół swoich wyników i sprawdzić wartość pola wyboru:

{ if( q2_SQ001=="T", Join( "- ", q2_SQ001.question, ": ", q2_SQ001.pokazane ), "" ) }

Użyj funkcji listifop , jeśli chcesz wyprowadzić listę tylko wybranych pozycji, np.: Mercedes, Volvo

{ listifop( 'wartość', '==', 'Y', 'pytanie', ', ', that.q2.sgqa ) }

Gdzie this.q2 rozszerza się na wszystkie pytania podrzędne q2. Zobacz self, to i tamto, aby uzyskać więcej szczegółów.

Przykład 2 (zakładając, że typ pytania to Tablica (wybór za 10 punktów))

- Proszę ocenić jakość poniższych marek samochodów w skali od 1 = bardzo zła do 10 = bardzo dobra?

--Mercedesy: 7

--Audi: 9

--Volvo: 9

Jeśli chcesz wyprowadzić tylko ocenione pozycje, możesz umieścić instrukcję IF wokół swoich wyników i sprawdzić, czy udzielono odpowiedzi na bieżące pytanie podrzędne, używając:

{ if(! is_empty( q3_SQ001 ), dołącz( "- ", q3_SQ001.question, ": ", q3_SQ001.pokazane ), "" ) }

Użyj funkcji listifop , jeśli na przykład chcesz wyprowadzić tylko listę wybranych pozycji większą niż osiem, np.: Audi / Volvo

{ listifop( 'wartość', '>', 8, 'pytanie', ' / ', that.q3.sgqa ) }

Pytanie z dwiema skalami

Załóżmy, że używane są następujące kody:

• Kod pytania: q4
• Kody podpytania: SQ001, SQ002, ...
• Kody odpowiedzi w skali 1: A1, A2, ...!N !*Kody odpowiedzi w skali 2: B1, B2, ...

Template:Uwaga

Wyprowadźmy wyniki dla obu skal i pierwszych dwóch pytań cząstkowych:

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

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

Aby wyprowadzić tekst pytania pomocniczego, musisz dodać identyfikator skali do symbolu zastępczego (chociaż teksty są takie same dla obu skal). Zatem zamiast {q4_SQ001.question} musimy użyć {q4_SQ001_0.question} lub {q4_SQ001_1.question}.

Jeśli chcesz wyeksportować/wyświetlić wyniki pytań podrzędnych zawierających tylko jedną odpowiedź, użyj tej składni dla każdego pytania podrzędnego:

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

Pytanie ze skalą X i Y

Dotyczy to wszystkich pytań macierzowych, które umożliwiają odpowiedź dla każdej komórki (a nie tylko każdego wiersza, jak pokazano wcześniej):

• Teksty tablicowe
• Liczby tablicowe

Zakładane użyte kody:

• Kod pytania: q5
• Kody podpytania: SQ001, SQ002, ...
• Kody odpowiedzi: A1, A2, ...

Aby odwołać się do wyniku określonego pytania podrzędnego z określonej kolumny, musisz użyć kodu pytania. „_” . Kod podpytania . „_” . Kod odpowiedzi. Przykład odniesienia się do odpowiedzi trzeciego pytania pomocniczego i drugiej kolumny: q5_SQ003_A2.

Wypiszmy wyniki dla kolumn 1-3 pierwszych dwóch pytań cząstkowych:

- {q5_SQ001_A1.pytanie}: {q5_SQ001_A1.pokazane} | {q5_SQ001_A2.pokazano} | Pokazano {q5_SQ001_A3.}

- {q5_SQ002_A1.pytanie}: {q5_SQ002_A1.pokazane} | {q5_SQ002_A2.pokazano} | Pokazano {q5_SQ002_A3.}

Ponieważ w przypadku tego typu pytań każda komórka (kombinacja osi X i Y) równa się jednej opcji odpowiedzi, dla każdej komórki należy przeprowadzić test istniejących danych. Przykład:

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

Template:Uwaga

Ukryj pytanie, jeśli odpowiedź na poprzednie pytanie jest pusta

Cel	Ukryj pytanie, jeśli odpowiedź z poprzedniego pytania jest pusta
Typ	Trafność pytania
Przykład	Pytanie jeden: kod pytania „imię”, tekst pytania „Jak masz na imię?” Pytanie drugie: tekst pytania „{name}, ile masz lat?” Sposób wykonania: Ukryj pytanie drugie, jeśli pole tekstowe pierwszego pytania jest puste
Wyrażenie	!is_empty(name)
Opis	is_empty() określa, czy zmienna uważa się za puste. „!” neguje wynik. Zatem jeśli zmienna nie jest pusta, wyrażenie będzie prawdziwe i wyświetli się pytanie
Kroki	Utwórz/edytuj pytanie drugie Wstaw „!is_empty(name)” do „Równania istotności:”
Przykładowy plik	Hide_question_if_empty_question_group.zip
Plik:Ukryj pytanie, jeśli jest pusty 1.pngPlik:Ukryj pytanie, jeśli jest pusty 2.png

Ukryj grupę pytań, jeśli odpowiedź z poprzedniego pytania brzmi Tak lub Nie

Cel	Ukryj grupę pytań, jeśli odpowiedź z poprzedniego pytania brzmi Tak lub Nie
Typ	Grupa pytań Trafność
Przykład	Strona pierwsza, Grupa pytań pierwsza, Pytanie pierwsze: kod pytania „ZWIERZĘ”, tekst pytania „Czy masz zwierzę?” -Tak nie Strona druga, grupa pytań druga: Tytuł „O Twoim zwierzaku(-ach)” Wykonaj: Pokaż/Ukryj drugą grupę pytań, jeśli odpowiedź na pytanie pierwsze brzmi Tak/Nie
Wyrażenie	PET == "T"
Opis	PET to kod pytania, na które chcesz sprawdzić odpowiedź. Jeśli nie użyjesz przyrostka, EM użyje „Qcode.code”. Porównujesz więc kod odpowiedzi z pytania PET z wartością „Y”. Jeśli uczestnik odpowie „Tak”, wyrażenie jest prawdziwe i wyświetli się grupa pytań „O Twoim zwierzaku(-ach)”.
Kroki	Utwórz/edytuj drugą grupę pytań Wstaw „PET == „Y”” do „Równania istotności:”
Przykładowy plik	Ukryj_pytanie group_if_answer_from_previous_question_is_Yes_or_No. zip
Plik:Ukryj grupę pytań, jeśli odpowiedź na poprzednie pytanie brzmi Tak lub Nie 1.pngPlik:Ukryj pytanie grupuj, jeśli odpowiedź na poprzednie pytanie brzmi Tak lub Nie 2.png

Wyświetla wartość pola pytania z wieloma odpowiedziami

Cel	Wyświetlanie wartości pola pytania z wieloma odpowiedziami
Typ	Referencja
Przykład	Pytanie pierwsze : kod pytania „AskChildAge”, tekst pytania „Ile lat mają Twoje dzieci?”. Kody podrzędnych pytań -Dziecko1 -Dziecko2 -Dziecko3 -DzieckoXXX Pytanie drugie: kod pytania „ReportChildAge” Tekst pytania „O Twoim pierwszym dziecku: - CHILD1 ma WIEK 1.”
Wyrażenie	{AskChildAge_Child1.question}, {AskChildAge_Child1.value}
Opis	Chcesz użyć wartości pytania podrzędnego w kolejnym pytaniu. Dostęp do wartości pytania podrzędnego można uzyskać za pomocą tego rodzaju wyrażenia: QcodeQuestion_QcodeSubquestion.value
Kroki	Utwórz/edytuj drugie pytanie Wstaw ten tekst do opisu: „O Twoim pierwszym dziecku: - {AskChildAge_Child1.question} to {AskChildAge_Child1.value}.”
Przykładowy plik	Display_value_of_a_multiple_answer_input_question_field. zip
Plik:Wyświetlanie wartości pola pytania wejściowego z wieloma odpowiedziami 1.png

Sprawdź liczbę zaznaczonych pól w wierszu dla pytania „Pole wyboru tablicy (liczby)”

Cel	Weryfikacja liczby zaznaczonych pól w wierszu
Typ	Walidacja
Przykład	Pytanie typu " Liczby tablicy (układ pola wyboru)"
Wyrażenie	suma(...)
Opis	(suma(Test_A_1, Test_A_2, Test_A_3, Test_A_4, Test_A_5) <= X) określa, czy zaznaczonych jest co najmniej X pól wyboru w wierszu A. Jeśli chcesz sprawdzić wszystkie trzy wiersze (A, B, C), możesz połączyć wyrażenie za pomocą „&&”: (suma(Test_A_1, Test_A_2, Test_A_3, Test_A_4, Test_A_5) <= X) && (suma(Test_B_1, Test_B_2, Test_B_3, Test_B_4, Test_B_5) <= X) && (suma(Test_C_1, Test_C_2, Test_C_3, Test_C_4, Test_C_5) <= X)
Kroki	Utwórz/edytuj pytanie typu „Numery tablicy (układ pola wyboru)”. Wstaw powyższe wyrażenie do „Równania sprawdzania poprawności pytania” w zaawansowanych ustawieniach pytań (być może będziesz musiał dostosować nazewnictwo zmiennych!).
Przykładowy plik	Zweryfikuj liczbę znaczniki pól w wierszu dla tablicy (Liczby) Checkbox.lss
Plik: Sprawdź liczbę znaczników pól w wierszu dla tablicy ( Numbers) Pole wyboru 05.pngPlik: Sprawdź liczbę pól w wierszu dla tablicy (Liczby) Pole wyboru 1.png

Oblicz różnicę między dwiema datami

Cel	Obliczenie różnicy między dwiema datami
Typ	Trafność / Typ pytania równania / Walidacja
Przykład	Pytanie pierwsze (data/godzina, kod: DOB): Jaka jest Twoja data urodzenia? Pytanie drugie (data/godzina, kod: datetoday): Jaki jest dzisiaj dzień? Pytanie trzecie (schemat): Masz XXXX dni. Sposób wykonania: Oblicz i wyświetl liczbę dni pomiędzy datą podaną w pytaniu 1 a pytaniem 2.
Wyrażenie	{(strtotime(datetoday)-strtotime(DOB))/60/60 /24}
Opis	strtotime oblicza liczbę sekund pomiędzy 1 stycznia 1970 r. a podaną datą. Powyższe wyrażenie oblicza liczbę sekund pomiędzy dwiema podanymi datami. Termin „/60/60/24” po prostu oblicza liczbę dni na podstawie liczby sekund. Zamiast pytać o „data dzisiaj”, możesz także użyć strtotime('now') lub po prostu time(), które bezpośrednio zwraca liczbę sekund od stycznia 1970 r. do chwili obecnej (tzn. czas wypełnienia ankiety). W ten sposób można szybko obliczyć wiek osoby w latach za pomocą równania {(time() - strtotime(DOB)) / 60 / 60 / 24 / 365,25} W każdym z tych przypadków istotne jest wprowadzenie daty w odpowiednim formacie, w przeciwnym razie funkcja strtotime() nie będzie działać poprawnie.
Kroki	Utwórz dwa pytania dotyczące daty (dla daty urodzenia i dzisiejszej daty) oraz pytanie standardowe. W tekście pytania standardowego pytania wstaw: „W dniu {datetoday} miałeś {(strtotime(today)-strtotime(dob))/60/60/24} dni i dni.” Uwaga: funkcja strtotime może współpracować z WIELU, ale nie wszystkimi formatami daty. Jeśli napotkasz problemy, ustaw format daty ankiety na mm/dd/rrrr lub rrrr-mm-dd lub dd.mm.rrrr"
Przykładowy plik	Różnica_daty.zip
Plik:Przykład_różnicy_daty.png

Używanie ExpressionScript do ocen

Oto kolejny przykład użycia ExpressionScript z pytania typu tablica i ocenami:</ br>

Załóżmy, że masz 2 pytania tablicowe i chcesz zapisać wyniki obliczeń w swojej bazie danych. W rzeczywistości jest to proste. Będziesz musiał utworzyć i przetestować swoje tablice oraz przesłać fikcyjną odpowiedź, aby sprawdzić, czy działa i wyświetlić wyniki na wypełnionej stronie.

Szczegóły implementacji:

• dodaj pytanie typu równanie
• dodaj następujący wiersz zakładając, że Q1 jest kodem pytania w tablicy, a Q2 jest drugim:

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

Należy pamiętać, że SQ001 jest domyślnym kodem dla każdego pytania podrzędnego. Jeśli zmienisz kod pytania podrzędnego, dostosuj odpowiednio powyższe równanie.

Używanie em_validation_q w tablicy

Możesz użyć równania sprawdzającego pytanie, aby kontrolować tablicę z dowolnym warunkiem.

Szczegóły implementacji:

• dla pierwszej tablicy: tablica pojedynczego wyboru
  • Kod pytania to ARRAY
  • Podkody pytania to SQ01,SQ02,SQ03 i SQ04

** zaktualizuj równanie sprawdzające całe pytanie i wstaw

 !is_empty(ARRAY_SQ01) i !is_empty(ARRAY_SQ03)

• dla drugiej tablicy: tablica tekstu
  • Kod pytania to ARRAYTEXT
  • Pytanie podrzędne na osi Y to SY01, SY02, SY03 i SY04
  • Zaktualizuj całe pytanie równanie sprawdzające i umieścić

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