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:

Dear {if(ATTRIBUTE_2=='M','Mr','Mrs')} {LASTNAME},

you have been invited to participate in a survey:

https:/...

email View:

Calculation / Assessment Examples

Calculate assessment values at runtime and store the results in the survey data

This example uses all of EM's features, including Relevance, Tailoring, and the Equation question type.

It also shows that all of them are JavaScript-enabled, so if you have these features on a page, it will dynamically change as people set and change their answers.

#	Code	Question	Type	Relevance
1	numKids	How many children do you have?	Numerical input	1
2	kid1	How old is your first child?	Numerical input	numKids >= 1
3	kid2	How old is your second child?	Numerical input	numKids >= 2
4	kid3	How old is your third child?	Numerical input	numKids >= 3
5	kid4	How old is your fourth child?	Numerical input	numKids >= 4
6	sumKidAges	{sum(kid1.NAOK,kid2.NAOK,kid3.NAOK,kid4.NAOK)}	Equation	1
7	kidSummary	You said that you have {numKids}. {if(numKids==1,'child','children')}. {if(numKids>1,implode(' ','The sum of ages of your first ',min(numKids,4),' kids is ',sumKidAges,'.'),' ')}	Text display	1

To download this example, please click on the following link: Assessments_survey_example.

You may find below screenshots of representative questions. As you can see, EM syntax-highlights all fields that might contain tailoring. Here, you see examples of syntax-highlighting Relevance, the Equation question type, and substitutions within a question. You can also use substitutions within Help, Group header display, Welcome message, and End message.

In the next example, since the relevance is {numKids >= 2), the question will only be visible if the respondent reports that she has at least two children.

Below, you may observe that each variable has the .NAOK suffix attached to it. This is because of how EM supports cascading relevance. If you did not have .NAOK, then the sum would only be computed if the person said she has 4 children (e.g., if all of the variables are relevant). The usage of .NAOK means that we want to compute the sum even if all or some of the variables are irrelevant (e.g., "Not Applicable" (NA) is alright (OK)).

However, the .NAOK attribute only affects whether variables are passed into EM. If the respondent initially says she has 3 children, and enters ages for each, then changes her mind and says she has 2, we don't want to see the sum of the 3 entered values - since the third child is "not applicable" in our case anymore:

Each separate Expression is color coded with a tan background. As you can see, there are three separate Expressions here. The last one contains a message that is conditionally shown only if the person has more than one child.

Now, here are screenshots of the survey in action.

When you first visit the page, you see this. Note that is says "You have 0 children" instead of "You have 0 child".

If I change the value for number of children to 1, the display instantly changes to this, even though it is on the same page:

Now notice that the grammar is correct: "You have 1 child".

Now I change the value for number of children to 3, and the display instantly changes to this.

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: