Check survey logic - Advanced/nl

Algemeen

Een belangrijke optie die je helpt bij het maken en onderhouden van een complexe enquête is Enquête logica-bestand.

Tijdens het maken en het testen van de enquête is het belangrijk om de logica van de enquête te valideren voordat je de enquête activeert. Dit geldt met name als er complexe relevantie, maatwerk en validatie-vergelijkingen gebruikt worden, anders kan de enquête mogelijk niet goed ingevuld worden.

Met deze functie kun je snel controleren of de enquête, groep of vraag goed is ingevoerd. Selecteer eerst een enquête, kies daarna de functie in de instellingen van de enquête op het menu Hulpmiddelen;

Hierboven zie je dat de optie voor elke taal die in een enquête wordt gebruikt, kan worden uitgevoerd.

Beschrijving

Deze functie toont alles wat gespecificeerd is voor elke vraag (bijvoorbeeld: naam, tekst, help, condities/relevantie, validatie-regels, standaarden, subvragen, antwoorden) in een tabelvorm.  Fouten worden aangegeven en je kunt elke vraag en groep aanklikken (de ID's of de variabelen in vergelijkingen) om in een nieuw venster die vraag / groep te wijzigen. Je kunt daarna snel opnieuw de controle uitvoeren, voordat je enquête activeert.

Het overzicht is ook zo ontworpen dat onderzoekers het kunnen lezen en de nauwkeurigheid kunnen valideren van het ontwerp en de logica van de enquête. De functie ververst de cache voor alle gebruikte expressies van de geselecteerde enquête.

De kolommen zijn:

• # - toont een teller van de volgorde van groepen en vragen, beginnend bij 0.

• Naam [ID]- toont de vraagcode voor de groep / vraag / subvraag. Deze codes kunnen worden gebruikt als variabelen binnen expressies. ID is de vraag-id (QID) of het groeps-id (GID). Dit veld toont ook het vraagtype (bijv. Meerkeuzevraag [M])).

Lees meer over welke variabelen in expressies kunnen worden gebruikt,

• Relevance [Validation] (Default) - shows the following:
  • Relevance - the syntax-highlighted relevance equation for the question or group. If it is always true (to be shown in any scenario), the value will be 1.
  • Validation - ExpressionScript automatically generates the validation equation based upon the selected question attributes (e.g., min/max number of answers, min/max/equals sum values, min/max individual values or regular expression validation). This section shows the generated validation equation so that you can detect if there are any errors (such as undefined variables).
    • Question-level validation shows the equation needed to verify the above-described question attributes
    • Subquestion-level validation shows the equation needed to implement array_filter, array_filter_exclude, and exclusive_option
  • Default - if the question has a default value, it is shown here, syntax-highlighted (since the default could be an expression).

• Text [Help] (Tip) - shows the following:
  • Text - the text of the group, question, subquestion, or answer. It is syntax-highlighted to show any embedded tailoring, thus letting you verify that you have declared all the variables you plan to use in the tailoring.
  • Help - this shows the help text for the question, also syntax-highlighted.
  • Tip - this shows the internally generated validation tip, based upon the question attributes. This same tip is used in all survey styles, plus in the printable survey and data entry screens.
  • Question Attributes - this shows a table of all relevant question attributes for this question. Attributes that might be equations are syntax-highlighted so that you can validate their accuracy.

Het gebruik van kleuren:

• Groep - een lichtgrijze achtergrond
• Vraag - een lichtgroene achtergrond
• Subvraag - een lichtgele achtergrond
• Antwoord - een witte achtergrond

Bij antwoorden is er een extra attribuut in de kolom Relevantie:

• Value - de standaard waarde die intern gebruikt wordt bij berekeningen.  Als je beoordelingen gebruikt, is het de beoordelingswaarde.  Anders is het de antwoordnaam.

De beschrijving van de enquête, de welkomst- en eindtekst, de eind-URL, de gegevensbescherming en label staan in het logicabestand van de enquête (boven de tabel) als de bijbehorende velden niet leeg zijn!

Gebruik

Bovenaan het overzicht staat een samenvatting van het resultaat van de controle. Als er geen problemen zijn, staat er "Geen fouten gevonden in de enquête", of "Deze groep bevat geen fouten" of "Deze vraag bevat geen fouten".  Als er wel fouten zijn: "X vragen bevatten fouten die verbeterd moeten worden" (of "X vraag bevat fouten die verbeterd moeten worden").

Elke vraag met een fout wordt met rood gemarkeerd (en de achtergrondkleur van de linkerkolom ("#")).  Ook staat er een waarschuwing met het aantal fouten in de vraag onder de kolom Naam [ID]. De meest voorkomende fouten zijn:

• Undefined variable - if you have not defined all of your variables, or mistyped array_filter (or different sets of answer options for array_filter), then some of your validation questions will show errors. Undefined variables are shown in red text, boxed with a red line.

• Bad syntax - as you start to use relevance equations, you may use too many or too few parentheses. Such syntax problems are highlighted and boxed in red. If you hover the mouse over any such red-boxed text, a tool-tip will describe the error.

Niet gedefinieerde variabele

De naam van de niet gedefinieerde variabele is in het rood in een rood omlijnd vak.  Als je er met de muis overheen gaat, krijg je de melding "Onbekende variabele":

  Let op: LimeSurvey staat niet toe dat een vraagcode in een enquête niet uniek is. Het kan echter voorkomen dat er vergelijkbare vraagcodes in een enquête zijn als je een vraaggroep of een vraag importeert die dezelfde vraagcode gebruikt als een van de al bestaande vragen. De vraag kan nog steeds worden geïmporteerd omdat de vraag-ID's anders zijn. Als je echter de resultaten van de enquête wilt exporteren om de enquêteresultaten (R of SPSS) verder te onderzoeken, wees dan voorzichtig, want de vraagcode wordt als een variabele gezien!

}}

Syntaxfout

De meeste van de fouten in expressies hebben te maken met slechte syntaxis. Dit hangt samen met het feit dat enquêtebeheerders meestal vergeten om een ​​accolade toe te voegen, om op de juiste manier gebruik te maken van haakjes, of ze gebruiken expressies verkeerd:

Voorbeelden van het met kleur markeren, oftewel syntax markering.

Fouten in eigen JavaScript

The JavaScript errors will also be highlighted in the survey logic check:

Bestand: javascript_error.jpg

Snel wijzigen en valideren

All of the syntax-highlighted text has tooltips embedded, which are clickable:

1. Tooltips
   • Functions - hovering the mouse lets you see the purpose and syntax definition of the function;
   • Variable Names - hovering the mouse lets you see the position (group, question sequence), question text, and allowable answers for the question.
2. Actions
   • Variable Names - clicking on the variable name opens a new window that allows you to edit the question. This makes it easy to navigate and verify logic - simply keep clicking on variable names of relevance or validation criteria for the question to see where they come from and how they are used.

Voorbeelden

De volgende voorbeelden komen uit de ExpressieScript voorbeeld enquêtes.  Er staan schermafdrukken van enquêtes die uitgevoerd worden, uitleg en mogelijke downloads.

BMI

Voorbeeld: schermafdrukken van de BMI, de lichaamsgewicht index.

Dit is een weergave van de berekening van de BMI waarin de vraagvolgorde aangepast kan worden. Je ziet de relevantie vergelijkingen voor weight, height en BMI in de kolom Vragen:

Raadpleeg het logica-bestand voor aanvullende informatie:

Een goed voorbeeld met een geneste if() om de "weightstatus" te bepalen.

Trapsgewijze logica

Hier staan schermafdrukken van dit voorbeeld.

It shows the subquestion validation logic that is automatically generated when you use array_filter and array_filter_exclude. This example also shows how you can substitute the tailored "Other" value (the answer for Q02_other is Q01_other).

Q05 in this example shows simultaneous use of array_filter and array_filter_exclude on Q01 and Q02, respectively. This example demonstrates cascading array_filter capabilities. Note that one of the main reasons for showing the question and subquestion level validation criteria is to help ensure you have not made any typos in specifying the array_filter or array_filter_exclude variable names (or in case you use different variable names for your list of filtered subquestions). If you have such typos, all the invalid variable names will appear in red indicating that they are undefined, letting you quickly fix the problem.

Dynamische relevantie

Dit voorbeeld toont dynamische trapsgewijze relevantie logica om de zichtbaarheid van de vraag te regelen. Je kunt dit voorbeeld downloaden.

Also note that questions are displayed only if certain validation criteria are met. For example, if a person states that she has 2 kids, certain questions have to be filled in by the respondent (kid1 and kid2).

Relevantie op groepsniveau

In dit voorbeeld wordt relevantie op groepsniveau in het logica-bestand getoond. Hier staan schermafdrukken van de demo.

Zoals je kunt zien, komt de relevantie vergelijking op groepsniveau (cohabs > 1 && p1_rel != "") voor in de grijze rij Person 2 voor G-2.

Je ziet ook dat alle vragen verplicht (mandatory) zijn. Als de groep niet relevant is, dan zijn alle vragen in de groep niet relevant, dus de vragen zijn alleen echt verplicht als de groep relevant is.

Je ziet ook dat bepaalde vragen alleen worden weergegeven als het antwoord op de vorige vraag niet leeg is. Je ziet hieronder dat als p2_sex niet ingevuld is, p2_name niet wordt weergegeven, ook al zijn het verplichte vragen. De verplichte vraag p2_age wordt ook niet weergegeven als p2_name niet ingevuld is. Deze vragen kunnen als "voorwaardelijk verplicht" worden beschouwd.

Additionally, note that the tip messages are also automatically created for you. They are organized by value range (min/max), sum value range (min/max/equals), number of answers (min/max), etc (it depends on the used question type and active attributes). Sometimes you want to validate an answer range but don't want to display what might appear to be silly validation tips to the user. In such cases, you can use the hide_tip question option (as in this case, to avoid telling the user that the age must be between 0 and 115 unless they try to enter a bad value - see p2_age).

Komma als radix (decimaal) scheidingsteken

Deze demo toont dat, ondanks dat vanaf versie 1.92 het gebruik van komma als decimaal scheidingsteken bij het uitvoeren wordt ondersteunt, je toch nog een decimaal als scheidingsteken moet gebruiken bij het ontwerpen (bijvoorbeeld bij het specificeren van min/max waarden bij de speciale vraagattributen). Een werkend voorbeeld staat hier.

Also, remember that the validation logic is created for you automatically from the enabled question attributes. The equations may look overwhelming, but you don't need to worry about them.