ExpressionScript How-tos/pl

Przegląd tego, co zostało wcześniej wyjaśnione

Jeśli do tej pory śledziłeś strukturę podręcznika LimeSurvey, oznacza to, że znasz już terminologia LimeSurvey. Następnie omówiliśmy wyrażenia i zmienne, aby dowiedzieć się, jak ulepszyć nasze ankiety. W następnej części przeszliśmy do typów i znaczeń podświetlanie składni, aby dowiedzieć się, jak poprawić błędy składniowe.

Po omówieniu tych podstawowych pojęć moglibyśmy przejść do przykładów i wyjaśnienia, jak działają wyrażenia w LimeSurvey.

Podświetlanie składni

Poniższe zrzuty ekranu przedstawiają przykłady, ale nie pokazują wartości podpowiedzi. Etykietka narzędzia to pole informacyjne wyświetlane po najechaniu myszką na pogrubione kolorowe słowa.

Dzięki podświetleniu składni bardzo łatwo jest tworzyć poprawne wyrażenia, nawet te skomplikowane. Chociaż zespół LimeSurvey planuje spróbować zbudować GUI Konstruktora wyrażeń, możesz użyć istniejącego podświetlania składni, aby szybko identyfikować i naprawiać literówki. Możesz także użyć podpowiedzi, aby sprawdzić dokładność wyrażeń (np. potwierdzić, że wybrałeś żądane zmienne).

W każdym z przykładów znajdują się trzy kolumny:

1. Source - to jest surowy tekst, który należy wpisać w polu pytania LimeSurvey
2. Pretty Print - jest to podświetlony składniowo odpowiednik tego, co wpisałeś! N!#*Zauważ, że w tym podświetleniu wyrażenia są wyświetlane na brązowym tle, ale nie są otoczone nawiasami klamrowymi.
   • Ponieważ EM obsługuje podstawienia rekurencyjne, pokazanie nawiasów klamrowych w podświetleniu spowodowałoby błędy składniowe
3. Result - to jest wynik generowany, gdy EM przetwarza źródło
   • Wszystko, co można poprawnie zastąpić, to
   • Wyrażenia z błędami są wyświetlane w linii, z podświetlaniem składni. Błędy są otoczone czerwoną linią.

Właściwa składnia

Poniżej znajdziesz przykłady poprawnej składni:

1. Values: pokazuje, że znane zmienne są oznaczone kolorami w zależności od tego, czy są ustawione na bieżącej stronie. INSERTANS:xxxx w starym stylu otrzymuje swój własny styl kodowania kolorami
2. Atrybuty pytania: pokazuje, że notacja z kropkami może uzyskać dostęp do niektórych właściwości pytań
3. Math: pokazuje, że obsługiwane są podstawowe i złożone obliczenia
4. TextProcessing: pokazuje niektóre dostępne funkcje przetwarzania tekstu
5. Dates: pokazuje dwie dostępne funkcje związane z datą
6. Conditional: pokazuje użycie funkcji if(). Opcje można zagnieżdżać.
7. Dostosowany akapit: możesz całkowicie dostosować raport w oparciu o wcześniejsze wartości
8. EM procesy w ciągach: pokazuje, że może dokonywać podstawień w ciągach. Ten przykład generuje dostosowaną nazwę obrazu.
9. EM nie przetwarza nawiasów klamrowych w następujący sposób: pokazuje, że jeśli nawiasy klamrowe zostaną zmienione lub pomiędzy wyrażeniem a nawiasami klamrowymi znajduje się spacja, ES ignoruje wyrażenie.

Składnia EM zawierająca błędy

Oto przykłady typowych błędów podczas wpisywania wyrażeń ES. Zwróć uwagę, że podpowiedzi zawierają dodatkowe informacje.

1. Inline Javascript, który zapomniał dodać spacji po nawiasie klamrowym
   • Ponieważ „document.write” pojawia się zaraz po nawiasie klamrowym, EM uważa, że jest to wyrażenie i red- pola „dokumentuj” i „zapisz”, ponieważ są to odpowiednio niezdefiniowane zmienne i funkcje
2. Nieznane/błędnie napisane zmienne, funkcje i operatory
   • Tutaj zapomnieliśmy, że używamy nazwy zmiennej „gender” zamiast „ sex”, ale EM wychwytuje ten błąd. Zaznacza także „++”, ponieważ nie jest to obsługiwany operator.
3. Ostrzega, jeśli użyje = zamiast eq lub wykona przypisania wartości
   • Zauważ, że „=” i „+=” są zapisane czerwonym tekstem, a nie czarnym. Jeśli najedziesz na nie myszką, zobaczysz ostrzeżenie, że przypisujesz wartość.
4. Zła liczba argumentów funkcji
   • if() przyjmuje 3 argumenty, ale podano jej 4, więc najechanie nad zaznaczonym na czerwono „if” wyjaśni błąd i pokaże obsługiwaną składnię
   • sum() przyjmuje nieograniczoną liczbę argumentów, ale przed nawiasem zamykającym mieliśmy końcowy przecinek, więc jest to zaznaczone na czerwono! N!#Niedopasowane nawiasy
   • To jeden z najczęstszych błędów podczas zapisywania wyrażeń.
   • Pokazuje dwa przykłady braku nawiasów zamykających i jeden przykład posiadania o jeden za dużo nawiasów zamykających.

#Nieobsługiwana składnia

1. • Jeśli użyjesz operatora lub znaków interpunkcyjnych, których ES nie obsługuje, zostanie to zaznaczone czerwoną ramką.
2. Nieprawidłowe przypisania
   • Niektóre zmienne mają funkcję readWrite i można zmienić ich wartości. Inne są tylko do odczytu.
   • Jeśli spróbujesz zmienić wartość zmiennej tylko do odczytu, nie będzie to możliwe. EM oznaczy próbę czerwoną ramką.
   • Jeśli spróbujesz przypisać wartość do równania lub ciągu znaków, również otrzymasz błąd

"Żywe" przykłady podświetlania składni z aktywnymi podpowiedziami

Źródło	Ładny nadruk	Wynik
Oto przykład składni OK z podpowiedziami Witaj {if(gender=='M','Pan','Pani')} {nazwisko}, jest teraz {data('g:i a',time())}. Czy wiesz, gdzie są Twoje {sum(numPets,numKids)} dzieci i zwierzęta?	Oto przykład składni OK z podpowiedziami Witaj , jeśli ( płeć == „M” , „Pan” , „Pani” ) nazwisko , teraz jest data ( „g:i a” , godzina ()) . Czy wiesz, gdzie jest Twoja suma ( numPets , numKids ) dzieci i zwierząt domowych?	Oto przykład składni OK z podpowiedziami Witam, panie Smith , jest teraz 6:07. Czy wiesz, gdzie jest Twoja trójka dzieci i zwierzęta?
Oto typowe błędy, dzięki którym możesz zobaczyć podpowiedzi Zmienne używane przed ich zadeklarowaniem: {notSetYet} Nieznana funkcja: {iff(numPets>numKids,1,2)} Nieznana zmienna: {sum(age,num_pets,numKids)} Błędne # parametry: {sprintf()},{if(1,2)},{date()} Przypisz zmienne tylko do odczytu:{TOKEN:ATTRIBUTE_1+=10},{name='Sally'} Nawiasy niezrównoważone: {pow(3,4},{(pow(3,4)},{pow(3,4))}	Oto typowe błędy, dzięki którym możesz zobaczyć podpowiedzi Zmienne używane przed ich zadeklarowaniem: notSetYet Nieznana funkcja: iff ( numPets > numKids ,1,2) Nieznana zmienna: suma ( wiek , num_pets , numKids ) Błędne # parametry: sprintf () , if (1,2) , date () Przypisz zmienne tylko do odczytu: TOKEN:ATTRIBUTE_1 += 10 , name = 'Sally' Nawiasy niezrównoważone: pow (3,4 , ( pow (3,4) , pow (3,4) )	Oto typowe błędy, dzięki którym możesz zobaczyć podpowiedzi Zmienne używane przed ich zadeklarowaniem: notSetYet Nieznana funkcja: iff ( numPets > numKids ,1,2) Nieznana zmienna: suma ( wiek , num_pets , numKids ) Błędne # parametry: sprintf () , if (1,2) , date () Przypisz zmienne tylko do odczytu: TOKEN:ATTRIBUTE_1 += 10 , name = 'Sally' Nawiasy niezrównoważone: pow (3,4 , ( pow (3,4) , pow (3,4) )
Oto część nieobsługiwanej składni Brak obsługi „++”, „--”, „%”, „;”: {min(++age, --age,age % 2);} Ani „|”, „&”, „^”: {(suma(2 | 3,3 i 4,5 ^ 6)}} Ani tablice: {name[2], name['moje']}	Oto część nieobsługiwanej składni Brak obsługi '++', '--', '%',';': min ( ++ wiek , -- wiek , wiek % 2) ; Ani „|”, „&”, „^”: ( suma (2 | 3,3 i 4,5 ^ 6) } Ani tablice: nazwa [ 2 ] , nazwa [ 'moje' ]	Oto część nieobsługiwanej składni Brak obsługi '++', '--', '%',';': min ( ++ wiek , -- wiek , wiek % 2) ; Ani „|”, „&”, „^”: ( suma (2 | 3,3 i 4,5 ^ 6) } Ani tablice: nazwa [ 2 ] , nazwa [ 'moje' ]

Przykłady krawiectwa (np. rozszerzenie {INSERTANS:xxx})

"Szanowny {Panie}/{Pani} Smith..."

Użyj funkcji if(), aby warunkowo wybrać, czy wyświetlać „Pan”. lub „Pani”.

Składnia jest następująca: if(test,do_if_true,do_if_false).

#	Kod	Pytanie	Wpisz
1	płeć	Jaka jest Twoja płeć?	Płeć
|example1	Szanowny {if(gender=='M','Pan','Pani')} Smith, ...	Długi tekst

Jak można zaobserwować poniżej, określenia „Pan” i „Pani” są dopasowane do tego, co respondent wybiera jako odpowiedź na pytanie „płeć”.

"Szanowny {Panie}/{Pani} Smith..." w e-mailu z zaproszeniem

Możesz wykorzystać powyższy przykład w wiadomości e-mail z zaproszeniem, korzystając z atrybutów z tabeli tokenów. Użyj funkcji if(), aby wybrać, czy „Pan”. lub „Pani”. należy użyć w wiadomości e-mail.

Składnia jest następująca: „if(test,do_if_true,do_if_false)”.

#	atrybut	wartość
1	Nazwisko	Smith
2	Adres e-mail	test@test. com
3	ATRYBUT_2	M

Tekst w e-mailu z zaproszeniem:

Drogi {if(ATTRIBUTE_2=='M','Pan','Pani')} {LASTNAME},

zostałeś zaproszony do wzięcia udziału w ankiecie:

https://...

e-mail Widok:

Przykłady obliczeń/oceny

Oblicz wartości oceny w czasie wykonywania i zapisz wyniki w danych ankiety

W tym przykładzie wykorzystano wszystkie funkcje EM, w tym trafność, dopasowanie i typ pytania Równanie.

Pokazuje również, że wszystkie z nich obsługują JavaScript, więc jeśli masz te funkcje na stronie, będzie ona dynamicznie się zmieniać, gdy ludzie będą ustawiać i zmieniać swoje odpowiedzi.

#	Kod	Pytanie	Typ	Trafność
1	numKids	Ile masz dzieci?	Wprowadzenie numeryczne	-	2	kid1	Ile lat ma Twoje pierwsze dziecko?	Wprowadzenie numeryczne	numKids >= 1
3	kid2	Ile lat ma Twoje drugie dziecko dziecko?	Wprowadzenie liczbowe	numKids >= 2
4	kid3	Ile lat ma Twoje trzecie dziecko?	Wprowadzenie liczbowe	numKids >= 3
6	sumKidAges	{sum(kid1.NAOK,kid2. NAOK,kid3.NAOK,kid4.NAOK)}	Równanie	1
7	kidSummary	Powiedziałeś, że masz {numKids}. {if(numKids==1,'dziecko','dzieci')}. {if(numKids>1,implode(' ','Suma wieku Twoich pierwszych ',min(numKids,4),' dzieci to ',sumKidAges,'.'),' ')}	|1

Aby pobrać ten przykład, kliknij poniższy link: Assessments_survey_example.

Poniżej możesz znaleźć zrzuty ekranu z reprezentatywnymi pytaniami. Jak widać, składnia EM podświetla wszystkie pola, które mogą zawierać dostosowywanie. Tutaj zobaczysz przykłady trafności podświetlania składni, typu pytania Równanie i podstawień w pytaniu. Możesz także użyć podstawień w ramach Pomocy, wyświetlania nagłówka grupy, wiadomości powitalnej i wiadomości końcowej.

W następnym przykładzie, ponieważ trafność wynosi {numKids >= 2), pytanie będzie widoczne tylko wtedy, gdy respondent zgłosi, że ma co najmniej dwójkę dzieci.

Poniżej możesz zauważyć, że do każdej zmiennej dołączony jest przyrostek .NAOK. Dzieje się tak ze względu na sposób, w jaki EM obsługuje znaczenie kaskadowe. Jeśli nie masz .NAOK, suma zostanie obliczona tylko wtedy, gdy dana osoba oświadczyła, że ma 4 dzieci (np. jeśli wszystkie zmienne są istotne). Użycie .NAOK oznacza, że chcemy obliczyć sumę, nawet jeśli wszystkie lub niektóre zmienne są nieistotne (np. „Nie dotyczy” (NA) jest w porządku (OK)).

Jednak atrybut .NAOK wpływa tylko na to, czy zmienne są przekazywane do EM. Jeśli respondentka początkowo twierdzi, że ma 3 dzieci i podaje wiek każdego z nich, potem zmienia zdanie i twierdzi, że ma 2, to nie chcemy widzieć sumy 3 wprowadzonych wartości - ponieważ trzecie dziecko „nie dotyczy” w naszym przypadku już:

Każde oddzielne wyrażenie jest oznaczone kolorem i brązowym tłem. Jak widać, są tu trzy osobne wyrażenia. Ostatnia zawiera komunikat, który wyświetla się warunkowo tylko wtedy, gdy dana osoba ma więcej niż jedno dziecko.

Oto zrzuty ekranu przedstawiające ankietę w akcji.

Kiedy po raz pierwszy odwiedzasz tę stronę, widzisz to. Zauważ, że jest napisane „Masz 0 dzieci” zamiast „Masz 0 dzieci”.

Jeśli zmienię wartość liczby dzieci na 1, wyświetlacz natychmiast zmieni się na następujący, mimo że znajduje się na tej samej stronie:

Teraz zauważ, że gramatyka jest poprawna: „Masz 1 „dziecko””.

Teraz zmieniam wartość liczby dzieci na 3, a wyświetlacz natychmiast się na nią zmienia.

Notice that you now see the conditional message at the bottom:  "The sum of ages of your first 3 kids is 0.".

Now I'll enter ages for my imaginary children, and I get this display, summing up their ages:

Again, the score and display updates instantly as I enter the values, so you can use this to show a running total of an Assessment Score.

Now, I change the value for the number of children to 2. The display has changed to this:

Notice that although I had entered a value of 5.5 for the third child, the report now only sums the values of my first 2 children.

The reason for this is that the 3rd value is now irrelevant, and irrelevant values are actively ignored by EM.

If I were to change the number of kids back to 3, I would see the value of 5.5 I entered again. So, I don't lose any information I enter on the page.

However, if I navigate to the Next or Previous page, all irrelevant values will be NULLed out in the session and in the database. So, if I were to keep the value at 2, go to the next page, and then come back and state that I actually have 3 kids, I would no longer see the age of 5.5.

Enter data and see a dynamically changing report of what was entered on the same page

This example presents the Tailoring process within LimeSurvey.

To download this example, click on the following link: Dynamic changes survey example.

Here is what the page looks like initially. You only see the question asking what city you live in:

Once you start to enter an answer, the tailoring process is also starting:

As you enter answers, the table at the bottom of the page is updated to show the answer codes and values of your responses.

Common Debugging Examples

Nested if() Statements (Conditional Logic)

EM supports the function "if(test,do_if_true,do_if_false)" so that you can perform conditional logic or tailoring. This function can be nested to do the equivalent of "if { } else if { } else {  }". EM will let you know if the parentheses are not balanced (e.g., you are missing a closing right parenthesis), or if you have any extra right parentheses. You should try to count the parentheses as you compose long nested if statements, save it, check for syntax errors, and fix them if any are found. Let's check together the below example.

The group of questions used below can be accessed from here: Tailoring survey example.lsg

First, with nothing entered, you just see "Hello."

If you enter a name, it says, "Hello {name}."

If you enter an age, you get a tailored message, depending upon whether you are a pre-school-age child or not:

School aged, teenager, or adult. Here is a  teenager who wants to be anonymous:

Here is the logic file of the group. As you can see in the "if-based" question, there are nested if statements based upon the person's age.

When you are originally editing this question, it is likely that at some point, you will have the wrong number of parentheses. Here's what happens if you have too few:

If you hover over the word "if", which is surrounded by a red box, it says "Parentheses not balanced". In this case, there should be four closing parentheses after "already an adult!", but there are only three.

If, on the other hand, you have an extra right parenthesis, it will be surrounded by a red box, like this:

When you are actually editing the question, the question looks like this: