ExpressionScript voorbeelden

Help door dit artikel uit te breiden door uw eigen voorbeelden toe te voegen. Dit zal anderen helpen Expressiebeheer te gebruiken.

Structuur

In het eerste deel van het artikel wordt beschreven waarvoor expressies gebruikt kunnen worden en waar je ze kunt vinden en hoe je ze kunt wijzigen. Het tweede deel bevat voorbeelden van het gebruik van een expressie.

Categorieën van expressies

LimeSurvey gebruikt expressies voor:

• Relevantie
• Validatie
• Tekstuitvoer
• Antwoorden opslaan

Relevantie

Doel: verbergen van vraaggroep/vraag

Relevantie bepaalt of een vraaggroep of vraag wordt getoond of verborgen. Als het resultaat van de expressie "waar" is (d.w.z. 1), wordt het element getoond. Anders (d.w.z. 0), zal het element verborgen zijn.

Type	Tonen/verbergen	Waar staat het	Screenshot
Vraaggroep relevantie	vraaggroep	Vraag aanmaken/aanpassen -> "Relevantievergelijking:"
Vraag relevantie	Vraag	Vraag aanmaken/aanpassen -> "Relevantievergelijking:"
Subvraaggroep relevantie	Subvraag	Wijzig subvragen -> "Relevantievergelijking:"

Validatie

Doel: Valideren van invoer / acties op vragen / subvragen / antwoorden

Met validatie bedoelen we het controleren of de gebruikersinvoer als antwoord op een vraag geldig is of niet. Bij een resultaat "true" (1) van de expressie, wordt de class "good" gebruikt voor het element en het validatie-bericht. In het andere geval wordt de class "error" hierbij gebruikt. Je kunt de classes declareren in het bestand template.css.

Type	Valideren	Waar staat het	Screenshot
Vraag validatie	Vraag	Vraag aanmaken/aanpassen -> tab "Logica" -> "Vraag relevantievergelijking"
Subvraag validatie	Subvragen	Vraag aanmaken/aanpassen -> tab "Logica" -> "Subvraag relevantievergelijking"	‎

Tekstuitvoer

Doel: (doe iets) en toon wat tekst

Een expressie kan worden gebruikt om tekst te tonen. U kunt bijvoorbeeld iets testen en berekenen en de uitvoer specificeren afhankelijk van het resultaat van de test of berekening. Het kan ook worden gebruikt om de vraagtekst, antwoorden, vraagtypen, ... in een vraag toe te voegen die werd gebruikt voordat de uitdrukking wordt gebruikt. Tekstuitvoer kan overal worden gebruikt waar een tekst wordt getoond en kan alle soorten resultaten retourneren.

Gebruik	Beschrijving
Klein maatwerk	Gebruik een tekst, bijv. "Dhr." of "Mevr." afhankelijk van het eerder gevraagde geslacht
Berekening	Bereken een waarde en toon die, bijv. "Het inkomen van uw familie is xxx"
Referentie	Gebruik een element, bijv. "Je naam is xxx. Hoe oud ben je?"

Antwoorden opslaan

Doel: (doe iets,) (toon wat tekst) en sla iets op in de database

Het vraagtype vergelijking kan worden gebruikt om iets in de database op te slaan. U kunt dit met een expressie doen, de vergelijkingsvraag (die lijkt op een tekst scherm) weergeven en het resultaat van de expressie opslaan in de database. Het slaat het antwoord op in de tabel responses. Het resultaat kan vervolgens worden gebruikt binnen de statistiekfunctie, het kan ook worden geïmporteerd in een van de formaten die worden geboden bij de exportfunctie van LimeSurvey.

Voorbeelden van een expressie

Voeg een antwoord van een vorige vraag in

Doel	Gebruik een eerder gegeven antwoord in de vraag
Type	Referentie
Voorbeeld	Vraag 1 (vraagcode "Q00"): What city do you live in? Vraag 2 (vraagcode "Q01"): How long have you lived in CITY? Bedoeling: Het antwoord op vraag 1 gebruiken in vraag 2 in plaats van CITY.
Expressie	{QOO}
Beschrijving	Het in Q00 gegeven antwoord vervangt het Q00-veld in vraag 2.
Stappen	Maak of wijzig vraag 2 Voer "How long have you lived in {QOO} (years)?" in bij het invoerveld

Verborgen vergelijkingsvraag gebruiken om een ​​antwoord alvast in te vullen

Probleem: Je hebt twee vragen. Vraag 1 vraagt ​​respondenten naar hun leeftijd. Vraag 2 deelt respondenten in drie groepen in: jonger dan 20 jaar, 20 jaar, ouder dan 20 jaar. Dus zou vraag 2 gebruik moeten maken van de waarden "1", "2", "3", die overeenkomen met deze genoemde voorwaarden. Ook moeten we niet vergeten om de vraag te verbergen (onzichtbaar te maken, de vraag zal niet in de enquête worden getoond, maar de waarden zullen wel in de antwoordentabel worden opgeslagen).

Sla de gegevens op in de database met behulp van het vraagtype Vergelijking:

• Maak eerst een vraag met code Q1 als een numerieke invoervraag.
• Maak vervolgens een nieuwe vraag met code Q2 als vergelijkingsvraag.
• Zet in vraag 2 op de tab "Tonen":
  • het veld "Deze vraag altijd verbergen" op "Aan"
  • tik bij "Vergelijking" de expressie in:

 Q2 = if (Q1.NAOK <20, "1", if (Q1.NAOK> 20, "3", "2"))} 

Maak een overzichtspagina met behulp van placeholders

Hier laten we zien hoe je aan het einde van de enquête een overzicht kunt maken met alle vragen en antwoorden met behulp van placeholders. Het laat ook zien hoe je het overzicht kunt beperken tot beantwoorde vragen.

Voorbeeld: downloaden.

Hier relevante vraagtypes:

1. Enkele keuzevragen / enkele tekst / numerieke vragen

• Lijst (Dropdown)
• Lijst (Radioknoppen) [L]
• Ja / Nee [Y]
• Lange vrije tekst [T ]
• Korte vrije tekst [S]
• Numerieke invoer [N]
• Vergelijking [*]

2. Vraag met subvragen

• Meerdere korte vrije teksten [Q]
• Meerkeuze [M]
• Array [F]
• Array (Ja / Nee / Weet niet) [C]
• Array (10-puntskeuze) [B]

3. Vragen met 2 schalen

• Array dubbele schaal [1]

4. Vragen met X- en Y-schalen

• Array (getallen) [:]

5. Gesloten vragen

• Tekst scherm [X]

Simpeler dan dit kunnen we het overzicht niet maken:

- Vraagtekst: Antwoord van de deelnemer

Enkelekeuzevragen, enkele test- getalvragen

Voor deze vraagtypes slaat LimeSurvey een waarde op:

• Lijst (Dropdown)
• Lijst (Radioknoppen)
• Lijst met opmerkingen
• 5-puntskeuze
• Ja / Nee
• Korte vrije tekst
• Lange vrije tekst
• Extra lange vrije tekst
• Numerieke invoer
• Vergelijking
• Datum
• Geslacht

Als de vraagcode van de vraag q1 is, kunnen we de vraagtekst en het antwoord raadplegen met:

- {q1.question}: {q1.shown}

Voorbeeld:

- Hoe oud ben je?: 25

Als je wilt controleren of die vraag is beantwoord, kun je een IF-statement gebruiken:

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

Dit wordt "vertaalt" naar: INDIEN vraag met code q1 niet leeg is, uitvoer "- " EN de vraagtekst EN ": " EN de antwoordtekst (de functie join voegt elementen samen als een nieuwe string; ANDERS: geen uitvoer ("" is een lege string).

Vraag met subvragen

Voor deze vraagtypen gebruikt LimeSurvey subvragen:

• Meerdere korte vrije teksten
• Meerkeuzevraag
• Meerkeuzevraag met opmerkingen
• Array
• Array (5-puntskeuze)
• Array (10-puntskeuze)
• Array (Ja/Nee/Weet niet)
• Array (Meer/Gelijk/Minder)
• Array per kolom

Ervan uitgaande dat de vraagcode van de vraag q2 is en de deelvragen SQ001, SQ002 zijn (automatische nummering uitgevoerd door LimeSurvey), kunnen we de vraag tekst en antwoord raadplegen met:

- {q2_SQ001.question}: {q2_SQ001.shown}

- {q2_SQ002.question}: {q2_SQ002.shown}

Voor meerkeuzevragen is het logisch om nu de tekst van de aangevinkte subvraag weer te geven en om voor elke geselecteerde optie een Y te tonen:

- {q2_SQ001.question}: {q2_SQ001}

- {q2_SQ002.question}: {q2_SQ002}

...

Het is momenteel niet mogelijk om de vraagtekst van vragen met subvragen te tonen, zie wijzingingsverzoek.

Voorbeeld 1 (vraagtype is meerkeuze)

- Ken je deze automerken?

-- Mercedes: J

-- Audi: N

Als u alleen geselecteerde items wilt tonen, kunt u een IF-statement gebruiken:

{if(q2_SQ001=="Y",join("- ",q2_SQ001.question,": ",q2_SQ001.shown),"")}

Voorbeeld 2 (vraagtype is Array (10-puntskeuze))

- Beoordeel de kwaliteit van de onderstaande automerken op een schaal van 1 : zeer slecht tot 10 : zeer goed?

-- Mercedes: 7

-- Audi: 9

Als u alleen beoordeelde items wilt tonen, kunt u een IF-statement gebruiken en testen of de huidige subvraag beantwoordt is :

{if(!is_empty(q3_SQ001),join("- ",q3_SQ001.question,": ",q3_SQ001.shown),"")}

Vraag met twee schalen

Dit is alleen van toepassing op het vraagtype dubbele schaal.

Laten we aannemen dat de volgende codes worden gebruikt:

• Vraagcode: q4
• Subvraagcodes: SQ001, SQ002, ...
• Antwoordcodes schaal 1: A1, A2, ...
• Antwoordcodes schaal 2: B1, B2, ...

Om te verwijzen naar het resultaat van een bepaalde subvraag op een bepaalde schaal, moet u QuestionCode gebruiken. '_'. SubQuestionCode. '_'. ScaleID. Let op: "ScaleID" is 0 voor de eerste schaal en 1 voor de andere!
Voorbeeld voor verwijzing naar het antwoord op de derde subvraag en tweede schaal: q4_SQ003_1 - vraag 4, deelvraag 3, tweede schaal.

Laten we de resultaten voor zowel de schalen als de eerste twee subvragen weergeven:

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

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

Om de subvraagtekst te tonen, moet je de schaal-ID toevoegen aan de tijdelijke aanduiding (hoewel de teksten voor beide schalen hetzelfde zijn). Dus in plaats van {q4_SQ001.question} moet je {q4_SQ001_0.question} of {q4_SQ001_1.question} gebruiken.

Als je de resultaten van subvragen met ten minste één antwoord wilt exporteren / weergeven, gebruik dan deze syntaxis voor elke subvraag:

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

Vraag met X en Y schaal

Dit geldt voor alle matrixvragen die een antwoord voor elke cel mogelijk maken (niet alleen elke rij zoals eerder getoond) :

• Array (teksten)
• Array (getallen)

Als de gebruikte code als volgt zijn:

• Vraagcode: q5
• Subvraagcodes: SQ001, SQ002, ...
• Antwoordcodes: A1, A2, ...

Als je naar het resultaat van een bepaalde subvraag in een bepaalde kolom wilt verwijzen, moet je gebruiken VraagCode . '_'. SubvraagCode. '_'. Antwoordcode. Voorbeeld voor het verwijzen naar het antwoord van de derde subvraag en de tweede kolom: q5_SQ003_A2.

Als we de resultaten voor de kolommen 1-3 voor de eerste twee subvragen willen weergeven:

- {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}

Aangezien voor deze vraagtypes elke cel (combinatie van X-as en Y-as) gelijk is aan één antwoordoptie, moet voor elke cel een test op bestaande gegevens worden uitgevoerd. Voorbeeld:

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

Om de subvraagtekst te tonen moet je de antwoordcode aan de tijdelijke aanduiding toevoegen (hoewel de teksten voor alle antwoordopties hetzelfde zijn). Dus in plaats van {q5_SQ001.question} moeten je {q5_SQ001_A1.question} of {q5_SQ001_A2.question} gebruiken.

Verberg vraag als er geen antwoord is op voorafgaande vraag

Doel	Vraag verbergen als de voorgaande vraag niet is beantwoordt
Type	Vraag relevantie
Voorbeeld	Vraag 1: vraagcode "name", vraagtekst "What's your name?" Vraag 2: vraagtekst "{name}, how old are you?" Doen: Niet naar leeftijd vragen als er geen naam is ingevuld
Expressie	!is_empty(name)
Beschrijving	is_empty() bepaalt of een variabele gevuld is. De "!" draait het resultaat om. Dus als de variabele gevuld is wordt de vraag getoond
Stappen	Maak/wijzig vraag 2 Voer "!is_empty(name)" in bij "Relevantievergelijking:"
Voorbeeld	downloaden

Verberg vraaggroep als antwoord op voorafgaande vraag is Ja of Nee

Doel	Verberg vraaggroep als antwoord op voorafgaande vraag is Ja of Nee
Type	Vraaggroep relevantie
Voorbeeld	Pagina 1, Vraaggroep 1, Vraag 1: vraagcode code "PET", vraagtekst "Do you have a pet?" -Yes -No Pagina 2, Vraaggroep 2: Titel "About your pet(s)" Doen: Tonen/verbergen vraaggroep 2 afhankelijk van antwoord op vraag 1
Expressie	PET == "Y"
Beschrijving	Je wilt het antwoord op de vraag met vraagcode PET controleren. Zonder prefix in ExpressieBeheer is dit "Qcode.code". Dus vergelijk de antwoordcode van PET met de waarde "Y". Als een deelnemer "Yes" antwoordt dan is de expressie waar en wordt de tekst bij vraaggroep 2 "About your pet(s)" getoond.
Stappen	Maak/wijzig vraaggroep 2 Vul "PET == "Y"" in bij "Relevantievergelijking:"
Voorbeeld	downloaden

Toon waarde van een meerkeuze invoerveld

Doel	Toon waarde van een meerkeuze invoerveld
Type	Referentie
Voorbeeld	Vraag 1: vraagcode "AskChildAge", vraagtekst "How old are your children?". Subvraagcodes -Child1 -Child2 -Child3 - ChildXXX Vraag 2: vraagcode "ReportChildAge" vraagtekst "About your first child: - CHILD1 is AGE1."
Expressie	{AskChildAge_Child1.question}, {AskChildAge_Child1.value}
Beschrijving	Je wilt de waarde van een subvraag gebruiken in de volgende vraag, je kunt die waarde benaderen met de expressie: QcodeQuestion_QcodeSubquestion.value
Stappen	Maak/wijzig vraag 2 Vul bij de beschrijving in: "About your first child: - {AskChildAge_Child1.question} is {AskChildAge_Child1.value}."
Voorbeeld	downloaden

Valideer het aantal vakjes dat per rij is aangevinkt bij een "Array (getallen)"-vraag

Doel	Valideer aantal per rij geselecteerde boxen
Type	Validatie
Voorbeeld	Vraagtype "Array (getallen) (Checkbox weergave)"
Expressie	sum(...)
Beschrijving	(sum(Test_A_1, Test_A_2, Test_A_3, Test_A_4, Test_A_5) <= X) bepaald of minstens X checkboxen in rij A zijn aangevinkt. Als je alle drie rijen wilt controleren (A, B, C), kun je "&&" gebruiken: (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)
Stappen	Maak/wijzig vraagtype "Array (getallen) (Checkbox weergave)". Vul de gegeven expressie in bij "Vraag validatievergelijking" bij de geavanceerde vraaginstellingen (de naam van de variabele moet je natuurlijk wel aanpassen!).
Voorbeeld	downloaden

Bereken periode tussen twee datums

Doel	Bereken duur periode
Type	Relevantie / vraagtype vergelijking / Validatie
Voorbeeld	Vraag 1 (date/time, code: DOB): What is your date of birth? Vraag 2 (date/time, code: datetoday): What is the date today? Vraag 3 (boilerplate): You are XXXX days old. Doen: Bepalen en tonen aantal dagen tussen de ingevulde datums.
Expressie	{(strtotime(datetoday)-strtotime(DOB))/60/60/24}
Beschrijving	strtotime bepaalt het aantal seconden tussen 1 january 1970 en de meegegeven datum. Dat doen we voor beide datums en kijken dan naar het verschil. Met "/60/60/24" zetten we de seconden weer om naar dagen. Je hoeft niet naar de huidige datum te vragen maar je kunt ook strtotime('now') of time() gebruiken, de tijd waarop de deelnemer de enquête invult. Je bepaalt dus de leeftijd met {(time() - strtotime(DOB)) / 60 / 60 / 24 / 365.25} De datum moet dan wel goed zijn ingevuld, anders werkt de functie strtotime() niet goed.
Stappen	Maak twee datumvragen aan (geboortedatum en vandaag) en een boilerplate vraag. Vul als vraagtekst in de boilerplate vraag in: "On {datetoday} you were {(strtotime(today)-strtotime(dob))/60/60/24} days days old." NB: De functie kan veel datumformaten aan, maar niet alle. Gebruik als datumformaat in je enquête mm/dd/yyyy, yyyy-mm-dd of dd.mm.yyyy.
Voorbeeld	downloaden

Gebruik Expressiebeheer voor beoordelingen

Hier komt nog een voorbeeld over het gebruik van Expressiebeheer met het vraagtype Array en beoordelingen:

Stel je hebt 2 arrayvragen en je wilt de resultaten van de berekeningen in de database opslaan. Het is eigenlijk eenvoudig, je moet je arrays maken en testen en een dummy-reactie invullen om te zien of het werkt en je de resultaten op de voltooide pagina krijgt.

Implementatiedetails:

• Voeg een vraag van vraagtype vergelijking toe
• Voeg de volgende regel toe, aannemende dat Q1 de vraagcode is, terwijl Q2 de tweede is:

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

Hier staat SQ001 voor de standaardcode bij elke subvraag. Als je de subvraagcode wijzigt, pas je de bovenstaande vergelijking natuurlijk ook aan.

Gebruik em_validation_q in array

Je kunt de vraag validatievergelijking gebruiken om een array met een conditie te controleren.

Implementatiedetails:

• Voor het eerste array: array met enkele keuze
  • Vraagcode is ARRAY
  • Subvraagcode is SQ01, SQ02, SQ03 en SQ04
  • Wijzig de hele vraag validatievergelijking en zet

    ! is_empty (ARRAY_SQ01) AND ! is_empty (ARRAY_SQ03) 

• Voor het tweede array
  • Vraagcode is ARRAYTEXT
  • Subvraag bij Y-as-code zijn SY01, SY02, SY03 en SY04
  • Wijzig de hele vraag validatievergelijking en zet

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