Actions

Przykłady ExpressionScript

From LimeSurvey Manual

Revision as of 09:16, 15 October 2024 by C schmitz (talk | contribs) (Text replacement - "http://manual.limesurvey.org" to "https://manual.limesurvey.org")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Template:Uwaga


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ść

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

Template:Uwaga


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)