Check survey logic - Advanced/it

Generale

Un'opzione importante che ti aiuta a creare e mantenere facilmente sondaggi complessi è Check Survey Logic.

Durante lo sviluppo e il test del sondaggio, e prima di attivarlo, è molto importante convalidare la logica del sondaggio. Ciò è particolarmente vero quando si utilizzano complesse equazioni di pertinenza, personalizzazione e convalida: è necessario essere sicuri che nulla si rompa durante l'esecuzione del sondaggio.

Questa funzione ti consente di convalidare rapidamente l'accuratezza del sondaggio, dei gruppi e delle domande. È possibile accedervi dalle opzioni del menu della barra superiore situate sotto le impostazioni relative al sondaggio. È disponibile tramite il menu Strumenti:

Come puoi osservare sopra, puoi eseguire questa opzione quattro volte, per ogni lingua utilizzata all'interno di un sondaggio.

Descrizione

L'opzione Check Survey Logic mostra tutto ciò che hai specificato per ogni domanda e gruppo (es. nome, testo, aiuto, condizioni/rilevanza, regole di validazione, default, sottodomande, risposte) in un comodo formato tabulare. Evidenzia gli errori e ti consente di fare clic sulla domanda e sugli ID di gruppo (o sulle variabili utilizzate all'interno delle equazioni) per aprire nuove schede del browser per modificare tali domande o gruppi. In questo modo è facile modificare rapidamente eventuali errori e aggiornare la pagina di controllo della logica per confermare l'accuratezza del sondaggio prima di attivarlo.

Il display è inoltre progettato per essere leggibile da ricercatori e sponsor dello studio in modo che possano convalidare l'accuratezza del progetto e della logica del sondaggio. Il controllo della logica del sondaggio aggiorna la cache per tutte le espressioni utilizzate all'interno di un sondaggio attivo.

Comprende le seguenti colonne:

• # - mostra i conteggi della sequenza di gruppi e domande, a partire da 0.

• Nome [ ID] - mostra il codice della domanda per il gruppo/domanda/sottodomanda. Questi codici possono essere usati come variabili all'interno di espressioni. ID è l'ID della domanda (QID) o l'ID del gruppo (GID). Questo campo mostra anche il tipo di domanda (ad esempio, Scelta multipla [M])).

Template:Nota

• Rilevanza [ Validation] (Predefinito) - mostra quanto segue:
  • Pertinenza - l'equazione di pertinenza evidenziata dalla sintassi per la domanda o il gruppo. Se è sempre vero (da mostrare in qualsiasi scenario), il valore sarà 1.
  • Validation - ExpressionScript genera automaticamente la convalida equazione in base agli attributi della domanda selezionati (ad es. numero min/max di risposte, valori somma min/max/uguale, valori individuali min/max o convalida dell'espressione regolare). Questa sezione mostra l'equazione di convalida generata in modo da poter rilevare eventuali errori (come variabili non definite).
    • La convalida a livello di domanda mostra l'equazione necessaria per verificare gli attributi della domanda sopra descritti
• **La convalida a livello di sottodomanda mostra l'equazione necessaria per implementare array_filter, array_filter_exclude e exclusive_option
  • Predefinito - se la domanda ha un valore predefinito, viene mostrato qui, con la sintassi evidenziata (poiché il valore predefinito potrebbe essere un'espressione).

• Testo [ Aiuto] (Suggerimento) - mostra quanto segue:
  • Testo - il testo del gruppo, domanda, sottodomanda o risposta. La sintassi è evidenziata per mostrare qualsiasi tailoring incorporato, permettendoti così di verificare di aver dichiarato tutte le variabili che intendi utilizzare nel tailoring.
  • Aiuto - questo mostra il testo di aiuto per la domanda, anch'esso evidenziato dalla sintassi.
  • Suggerimento - questo mostra il suggerimento di convalida generato internamente, basato sugli attributi della domanda. Questo stesso suggerimento viene utilizzato in tutti gli stili di indagine, oltre che nelle schermate di indagine stampabili e di immissione dati.
  • Attributi domanda: mostra una tabella di tutti gli attributi della domanda rilevanti per questa domanda. Gli attributi che potrebbero essere equazioni sono evidenziati dalla sintassi in modo da poterne convalidare l'accuratezza.

Le righe sono codificate a colori come segue:

• Gruppi - sono mostrate con uno sfondo grigio chiaro
• Domande - sono mostrate con uno sfondo verde chiaro
• ' Domande secondarie' - sono mostrate con uno sfondo giallo pallido
• Risposte - sono mostrate con uno sfondo bianco semplice

Le risposte hanno un attributo aggiuntivo nella colonna Rilevanza:

• Valore - questo è il valore interno predefinito utilizzato dai calcoli. Se stai utilizzando Valutazioni, questo sarà il valore della valutazione. Altrimenti, questo sarà lo stesso del nome della risposta.

Template:Nota

Utilizzo

Nella parte superiore della pagina è presente un messaggio di riepilogo. Se tutto va bene, dirà "Nessun errore di sintassi rilevato in questo sondaggio", oppure "Questo gruppo" o "Questa domanda", "di per sé, non contiene errori di sintassi". Se è vero il contrario, dirà "X domande hanno errori di sintassi che devono essere corretti".

Ogni domanda che ha errori di sintassi ha lo sfondo della sua colonna più a sinistra (cioè #) codificato con il colore rosso. Inoltre, sotto la colonna Nome [ID] verrà visualizzato un avviso che indica il numero minimo di errori di una domanda. I seguenti errori sono comuni:

• Variabile non definita - se non hai definito tutte le tue variabili o hai digitato in modo errato array_filter (o set diversi di opzioni di risposta per array_filter), alcune delle tue domande di convalida mostreranno errori . Le variabili non definite sono visualizzate in testo rosso, delimitate da una linea rossa.

• Sintassi errata - quando inizi a utilizzare le equazioni di pertinenza, potresti utilizzare troppe o troppo poche parentesi. Tali problemi di sintassi sono evidenziati e racchiusi in rosso. Se passi il mouse su uno di questi testi nella casella rossa, un suggerimento descriverà l'errore.

Colori nella sintassi ExpressScript

La sintassi delle condizioni e delle equazioni è evidenziata per capire più facilmente cosa stai guardando:

1. Verde / Azzurro: una variabile che fa riferimento a una domanda precedente nel sondaggio
2. Blu : una funzione
3. Grigio: un'espressione stringa
4. Marrone: un'espressione TOKEN (dati del partecipante)
5. Nero: Operatore

Cose da controllare:

1. Viola: una variabile che fa riferimento a domanda più avanti nel sondaggio. Di solito si tratta di un errore e deve essere controllato.
2. Cornice rossa o rossa: una variabile inesistente o un riferimento a una domanda precedente o un errore di sintassi - di solito deve essere controllato.

Variabili non definite

Se vengono utilizzate variabili non definite, il nome della rispettiva variabile sarà codificato a colori in rosso e circondato da una linea rossa. Se passi il mouse sopra il nome della variabile, dirà "variabile non definita":

  Tieni presente che LimeSurvey non consente agli amministratori del sondaggio di creare domande che utilizzano lo stesso codice domanda. Tuttavia, potrebbe capitare di avere codici domanda simili all'interno di un sondaggio se importi un gruppo di domande o una domanda che utilizza lo stesso codice domanda di una delle tue domande già definite. La domanda può ancora essere importata perché gli ID delle domande sono diversi. Tuttavia, se desideri esportare i risultati del sondaggio per esplorare ulteriormente i risultati del sondaggio (R o SPSS), fai attenzione perché il codice della domanda viene visto come una variabile!

}}

Sintassi errata

La maggior parte degli errori relativi alle espressioni sono legati a una cattiva sintassi. Ciò è legato al fatto che gli amministratori del sondaggio di solito non aggiungono una parentesi graffa, usano correttamente le parentesi o usano le espressioni in modo errato:

Ecco molti buoni esempi sull'uso di evidenziazione della sintassi.

JavaScript personalizzato errato

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

Speeding editing and validation

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.

Examples

The following examples are taken from the ExpressionScript sample surveys. You can find screenshots of running surveys, explanations, and downloads on that page.

Body Mass Index

Here are screenshots of this example.

This is the question-reorder view of the Body Mass Index calculation. You can see the relevance equations for weight, height, and BMI under the Question column:

For a better survey overview, check the survey logic page:

This survey example is also a good example of nested if() statements to generate the "weightstatus".

Cascading logic

Here are screenshots of this example.

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.

Dynamic relevance

This example demonstrates dynamic cascading relevance logic to control display of question visibility. You can download this example here.

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).

Group-level relevance

This example shows how group-level relevance appears in the logic check. Here are screenshots of the example described below.

As you can see, the group-level relevance equation (cohabs > 1 && p1_rel != "") appear in the grey Person 2 row for G-2.

You may also notice that all of the questions are mandatory. However, if the group is irrelevant, so are all its questions. As a result, those questions are only truly mandatory if the group is relevant.

You may also note that certain questions are displayed only if the answer to the previous question is not empty. You may see below that if p2_sex is not filled in, p2_name is not going to be displayed, even though it is a mandatory questions. The mandatory question p2_age is also not going to be displayed if p2_name is not filled in. These questions can be considered "conditionally mandatory".

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).

Comma as radix (decimal) separator

Although LimeSurvey fully supports the use of comma as radix (decimal) separator at run-time, you must still use a decimal as the radix separator at the design-time (e.g., when specifying min/max values in advanced question attributes). The working example can be found here.

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.