Actions

Expression Manager/it: Difference between revisions

From LimeSurvey Manual

Maren.fritz (talk | contribs)
Created page with "''qname'' è il nome della domanda senza alcuna estensione della sottodomanda. Quindi, diciamo che crei una domanda 'q1', che è il suo ''qname''"
Maren.fritz (talk | contribs)
Created page with "Esempi: *È stata data risposta a qualche parte della domanda q1? {count(that.q1.NAOK)>0} *Qual è il punteggio di valutazione per q2? {sum(that.q2.NAOK)} *Qual è il totale c..."
Line 649: Line 649:
''qname'' è il nome della domanda senza alcuna estensione della sottodomanda. Quindi, diciamo che crei una domanda 'q1', che è il suo ''qname''
''qname'' è il nome della domanda senza alcuna estensione della sottodomanda. Quindi, diciamo che crei una domanda 'q1', che è il suo ''qname''


Examples:
Esempi:
*Has any part of question q1 been answered?  {count(that.q1.NAOK)>0}
*È stata data risposta a qualche parte della domanda q1? {count(that.q1.NAOK)>0}
*What is the assessment score for q2?  {sum(that.q2.NAOK)}
*Qual è il punteggio di valutazione per q2? {sum(that.q2.NAOK)}
*What is the grand total of q3? {sum(that.q3.NAOK)}
*Qual è il totale complessivo di q3? {sum(that.q3.NAOK)}
*What is the total of row C in q4?  {sum(that.q4.sq_C.NAOK)}
*Qual è il totale della riga C in q4? {sum(that.q4.sq_C.NAOK)}
*What is the total of column 2 in q4? {sum(that.q4.sq_2.NAOK)}
*Qual è il totale della colonna 2 in q4? {sum(that.q4.sq_2.NAOK)}


The 'self' and 'that' variables can be used in any relevance,  validation, or tailoring.
The 'self' and 'that' variables can be used in any relevance,  validation, or tailoring.

Revision as of 13:19, 16 August 2023

Nota: questa funzionalità è disponibile solo a partire dalla versione 1.92 di LimeSurvey 1.92.

Quick Start Tutorial

Introduzione

Nella gestione dei sondaggi, spesso è necessario utilizzare alcune delle seguenti caratteristiche:

  1. Navigazione/Ramificazione - fare in modo che le risposte inserite precedentemente condizionino l'ordine in cui le domande sono mostrate.
  2. Personalizzazione e incatenamento degli eventi (Tailoring & Piping) - fare in modo che le domande siano declinate in base a risposte fornite precedente, ad esempio coniugando i verbi in base al numero o al genere dei sostantivi; oppure generazione di report personalizzati come ad esempio valutazioni con punteggio o suggerimenti mirati.
  3. Convalida - imporre il rispetto di determinati criteri per le risposte inserite: ad esempio valore massimo e minimo, oppure il rispetto di un certo formato.

Il Gestore delle Espressioni o GE (in Inglese, Expression Manager o EM) fornisce una modalità intuitiva per specificare la logica delle funzionalità descritte. È possibile costruire espressioni valide per praticamente ogni equazione matematica standard, anche contenente funzioni. Il Gestore Espressioni consente l'utilizzo di 80 funzioni e può anche essere esteso per includerne di ulteriori. Le variabili possono essere chiamate con nomi facilmente leggibili e non solo con i codici SGQA.

Le sezioni seguenti mostrano i vari posti nei quali si può utilizzare il Gestore Espressioni

Rilevanza (Controllo della navigazione/Ramificazione)

Alcuni sistemi di gestione per sondaggi utilizzano una logica di tipo "GoTo": ad esempio, se si sceglie l'opzione C per la Domanda 1, allora vai alla Domanda 5. Questo approccio è piuttosto limitato, perché implica difficoltà di convalida e soprattutto perché la struttura logica si rompe se le domande vengono riordinate. Il GE utilizza una equazione di rilevanza booleana, con la quale sono specificate tutte le condizioni che una domanda deve rispettare per essere valida. Se la domanda ha "rilevanza", allora essa viene mostrata; altrimenti, è "non applicabile" e il valore NULL è salvato nel database delle risposte. Si tratta di qualcosa di simile a quanto può essere fatto dall'editor delle condizioni ma il GE permette di specificare facilmente criteri molto più complessi e potenti - e, inoltre, permette di usare il nome della variabile invece dei codici SGQA.

L'immagine seguente mostra un modo di sfruttare la logica di rilevanza in un sondaggio. il sondaggio dell'esempio calcola l'Indice di Massa Corporea, in inglese "Body Mass Index" o BMI. L'esempio è in inglese. L'equazione di rilevanza è mostrata in parentesi quadrate, subito dopo il nome della variabile (che è scritto in verde). Quindi, la rilevanza di weight, weight_units, height and height_units vale in tutti i casi 1, pertanto tutte queste domande sono sempre mostrate. L'equazione di rilevanza per il BMI, invece, è {!is_empty(height) and !is_empty(weight)}: questo significa che il BMI sarà calcolato solo se chi risponde al sondaggio ha inserito un valore sia per height ("altezza") che per weight ("peso"); in tal modo si evita di eseguire una divisione per zero con conseguente messaggio di errore. Anche la domanda Report è mostrata solo se sono state fornite a tutte e quattro le domande principali (height, height_units, weight, weight_units).

La pertinenza è mostrata e modificabile nei seguenti punti:

Visualizzazione/modifica della pertinenza a livello di domanda

Questa equazione calcola l'indice di massa corporea (BMI). Viene chiesto solo se la persona inserisce prima altezza e peso.

Questa è la schermata di modifica per la domanda BMI.

Si noti che non si utilizzano le parentesi graffe quando si immette un'equazione di rilevanza.

Visualizzazione/modifica della pertinenza a livello di gruppo

Questo è un campione di censimento. La prima pagina chiede quante persone vivono con te e le memorizza nella variabile "cohabs". Questa pagina viene mostrata solo se hai più di un convivente (quindi viene mostrata per la seconda persona che convive con te), e mostra anche solo se hai specificato in che modo la Persona Uno è imparentata con te (p1_rel).

Come puoi vedere, il gruppo ha anche criteri di pertinenza a livello di domanda, in modo tale che ogni domanda appaia solo dopo che hai risposto alla domanda precedente (es. {!is_empty(p1_sex)}). EM combina per te la pertinenza a livello di gruppo e di domanda. Le domande in un gruppo vengono poste solo se il gruppo nel suo insieme è rilevante. Quindi, viene chiesto solo il sottoinsieme di domande pertinenti all'interno del gruppo.

Ecco la schermata per modificare la pertinenza a livello di gruppo per quella domanda:

Si noti che non si utilizzano le parentesi graffe quando si immette un'equazione di rilevanza.

Sartoria/Piping

EM ti consente di eseguire facilmente adattamenti condizionali semplici e complessi delle tue domande. A volte hai solo bisogno di una semplice sostituzione, come dire: "Hai detto di aver acquistato [ Prodotto]. Cosa ti è piaciuto di più?". A volte hai bisogno di una sostituzione condizionale come " [ Signor signora.] [ Cognome], saresti disposto a completare il nostro sondaggio?". In questo caso, vuoi usare Mr. o Mrs. in base al sesso della persona. Altre volte hai bisogno di sostituzioni ancora più complesse (come basate su un calcolo matematico) EM supporta ciascuno di questi tipi di sartoria/piping.

Equazioni condizionali

L'esempio dell'indice di massa corporea mostra la capacità di calcolare l'indice di massa corporea di una persona, anche lasciandole inserire altezza e peso in unità metriche o non metriche.

File:Sartoria7.jpg

Qui peso_kg è {if(weight_units == 'kg', peso, peso * .453592)}. Questa funzione if() significa che se il soggetto ha inserito il peso usando i chilogrammi, usa quel valore, altrimenti moltiplica il valore inserito (che era in libbre) per .453592 per convertirlo in chilogrammi. La variabile height_m usa un approccio simile per calcolare l'altezza della persona in metri, anche se ha inserito la sua altezza in pollici.

BMI calcola la formula del peso come {peso_kg / (altezza_m * altezza_m)}.

Infine, il rapporto adatta in modo condizionale il messaggio al soggetto, dicendogli cosa ha inserito. ("Hai detto che sei alto 2 metri e pesi 70 kg.")

Anche se non ben mostrato nell'immagine sopra, weight_status utilizza istruzioni if() nidificate per classificare la persona da sottopeso a gravemente obesa. Puoi vedere la sua equazione nella vista Mostra logica

File:Sartoria8.jpg

Dalla finestra di modifica per questa domanda, puoi vedere due cose:

  1. Tailoring deve circondare le espressioni con parentesi graffe
  2. Le espressioni possono estendersi su più righe se, come in questo caso, vuoi rendere più facile la lettura del logica condizionale annidata.

File:Sartoria9.jpg

Domande, risposte e rapporti su misura

Nota: la personalizzazione dinamica potrebbe non funzionare se le opzioni di risposta sono rese disponibili in caselle selezionate nella stessa pagina della domanda. Ciò deriva dal fatto che la sartoria inserisce a tag che non è valido all'interno delle opzioni selezionate.

Questo esempio mostra il rapporto BMI.

Ecco la finestra di modifica per la stessa domanda.

Come puoi vedere, qualsiasi cosa tra parentesi graffe viene trattata come un'espressione, quindi viene evidenziata la sintassi (con codice colore) nell'immagine precedente. In caso di errori di battitura (come nomi di variabili o funzioni con errori di ortografia o non definiti), EM mostrerebbe un errore, come questo, che mostra che height_unit è un nome di variabile non definito (in realtà è height_units) e rnd() è una funzione non definita (il nome corretto della funzione è round()). In entrambi i casi, gli errori sono circondati da un riquadro rosso per facilitarne l'individuazione e la correzione.

Puoi anche vedere che puoi creare rapidamente report complessi, come una tabella di valori inseriti o consigli personalizzati.

Ricorda che tutte le personalizzazioni devono circondare le espressioni con parentesi graffe, in modo che LimeSurvey sappia quali parti della domanda sono testo libero e quali devono essere analizzate tramite Expression Manager.

Convalida

EM controlla il funzionamento della maggior parte delle opzioni di domande avanzate. Questi controllano aspetti come il numero minimo/massimo di risposte; valori individuali min/max; valori somma min/max; e controllando che i valori immessi corrispondano ai modelli di stringa specificati. Continui a inserire quelle opzioni di domande avanzate come al solito. Tuttavia, ora qualsiasi valore in uno di questi campi è considerato un'espressione, quindi puoi avere criteri min/max con relazioni condizionali complesse con altre domande.

In tutti questi casi, poiché l'opzione della domanda avanzata è sempre considerata un'espressione, non si usano le parentesi graffe quando la si specifica.

Le pagine Sondaggi di esempio mostrano molti esempi funzionanti dell'utilizzo delle espressioni per le convalide.

Introduzione

LimeSurvey utilizza il nuovo modulo Expression Manager (EM) che consentirà a LimeSurvey di supportare branching, valutazioni, convalida e personalizzazione più complessi. Sostituirà il modo in cui LimeSurvey gestisce le sostituzioni, le condizioni e le valutazioni nel back-end. Inoltre, accelererà notevolmente l'elaborazione poiché elimina la maggior parte delle letture del database in fase di esecuzione. EM è stato sviluppato dal Dr. Thomas White (TMSWhite).

Questa pagina wiki è il riferimento definitivo per la sintassi e la funzionalità di Expression Manager.

Definizioni chiave

  1. Espressione: Qualsiasi cosa racchiusa tra parentesi graffe
    • Sempre che non vi siano spazi bianchi immediatamente dopo la parentesi graffa di apertura o prima della parentesi graffa di chiusura
#*I contenuti delle espressioni sono valutati da EM, quindi possono contenere formule matematiche, funzioni ed elaborazioni complesse di stringhe e date.
  1. Adattamento: a volte chiamato "piping", questo è il processo di modifica condizionale del testo
    • Hai accesso a tutti i "campi sostitutivi", ai dati dei partecipanti e ai dati delle risposte.
    • Hai anche un accesso più facile a domande, risposte e alle loro proprietà.
  2. 'Rilevanza' Equazione: un nuovo attributo della domanda che controlla la visibilità della domanda
    • Se esiste un'equazione di rilevanza, la domanda viene mostrata solo se la pertinenza risulta vera.
    • Internamente, tutti array_filter e array_filter_exclude i comandi diventano rilevanti a livello di sottodomanda
  3. Equazione Tipo di domanda: un nuovo tipo di domanda che salva calcoli o report nel database
    • È come una domanda Boilerplate, ma il suo contenuto viene salvato in il database anche se imposti "Nascondi sempre questa domanda"
  4. Codice domanda: questo è il nome di variabile preferito per EM
    • Questo può essere un nome descrittivo che indica lo scopo della domanda , facilitando la lettura di logiche complesse
    • I codici domanda validi NON devono iniziare con un numero, quindi quando si utilizza il codice domanda per numerare le domande, utilizzare semplicemente "q1", o "q1a" o "g1q2".! N!#*Questo è ciò che attualmente diventa il nome della variabile se esporti i dati in SPSS o R, quindi se esegui un'analisi statistica, probabilmente l'hai già reso univoco.

Devo usare EM?

La risposta breve è No (ma anche sì).

EM è completamente retrocompatibile con i sondaggi esistenti. Quindi, se sei felice di utilizzare Condizioni e Valutazioni nello stile utilizzato da LimeSurvey nelle versioni <= 1.91+, puoi continuare a farlo.

Tuttavia, EM sostituisce completamente il modo in cui LimeSurvey gestisce internamente le condizioni. Sebbene tu possa ancora utilizzare l'editor delle condizioni per creare e gestire le condizioni, LimeSurvey 1.92 le convertirà nelle equazioni di pertinenza equivalenti. Come parte dell'aggiornamento, LimeSurvey 1.92 convertirà automaticamente tutte le condizioni esistenti in equazioni di rilevanza.

Questo dovrebbe darti il meglio di entrambi i mondi: puoi continuare a utilizzare LimeSurvey come sei abituato, ma vedrai l'equivalente di Equazione di pertinenza in modo da poter migrare gradualmente a Equazioni di pertinenza direttamente ogni volta che lo ritieni opportuno.

Posso combinare l'uso di Condizioni e Rilevanza?

SÌ. Puoi utilizzare l'editor delle condizioni per alcune domande e l'editor della pertinenza per altre. Le condizioni vengono convertite automaticamente in Rilevanza quando salvi la domanda.

Nota, supponiamo che se stai utilizzando l'editor delle condizioni, desideri che tali condizioni sovrascrivano qualsiasi equazione di rilevanza inserita manualmente. Pertanto, se disponi di Condizioni esistenti e desideri modificare manualmente la Rilevanza, elimina prima le Condizioni per quella domanda. Nello specifico, copia l'equazione di pertinenza generata in un editor di testo, utilizza il menu Condizioni per eliminare tutte le condizioni per quella domanda (che eliminerà anche la pertinenza), quindi modifica la domanda e incolla nuovamente l'equazione di pertinenza generata dall'editor di testo in il campo di pertinenza per quella domanda (e salva la domanda). Se c'è una domanda sufficiente per eliminare le condizioni senza eliminare l'equazione di pertinenza generata, potremmo aggiungere un processo di conversione in blocco.

Come devo scegliere tra Condizioni e Rilevanza?

Ecco un elenco di pro e contro di ogni stile:

Stile Pro Svantaggi
Condizioni 1. Bella GUI per la creazione di condizioni semplici
2. GUI ben documentata e compresa dal team di supporto
1. Supporta solo semplici confronti e non AND/OR condiziona bene
2. Le condizioni a cascata funzionano in modo irregolare
3. Lento: database intensivo, quindi può rallentare lunghi sondaggi
4. Alcuni problemi segnalati con le condizioni di ricaricamento
5. La GUI non si adatta bene quando ci sono dozzine, centinaia o migliaia di domande
6. Potrebbe essere lento convertire i sondaggi cartacei poiché devono utilizzare i nomi SGQA
7. Spesso è necessario un programmatore per codificare in modo personalizzato la logica necessaria per ramificazioni complesse
Rilevanza 1. Supporta logiche molto complesse, incluse oltre 80 funzioni e operatori matematici/stringa
2. Supporto perfetto per la logica a cascata
3. Veloce: nessuna chiamata aggiuntiva al database, quindi supporta oltre 1000 sondaggi di domande
4. Nessun problema con la logica di ricarica poiché non richiede codici SGQA
5. L'evidenziazione della sintassi scala fino a oltre 1000 sondaggi di domande
6. Facile e veloce da usare per i gruppi che vogliono informatizzare i sondaggi cartacei esistenti.
7. Supporta facilmente interviste semi-strutturate e indagini epidemiologiche senza bisogno di programmatori
1. Nessuna GUI per condizioni semplici: usa invece l'evidenziazione della sintassi
2. Nuovo, quindi i team di supporto non hanno ancora acquisito padronanza di EM.

Il fondo è che se sei soddisfatto di come funziona LimeSurvey 1.91+, non c'è motivo di cambiare ciò che fai.

Quali sono gli altri vantaggi dell'utilizzo di EM?

Ecco alcuni degli altri motivi per cui potresti voler utilizzare EM.

  1. Calcoli: puoi creare qualsiasi calcolo ti venga in mente:
    • Hai accesso a tutti i comuni operatori e funzioni matematiche
    • Hai accesso a oltre 70 funzioni matematiche, di data e di elaborazione di stringhe
    • È abbastanza facile per gli sviluppatori aggiungere nuove funzioni se gli utenti ne hanno bisogno
  2. Memorizzazione dei calcoli nel database
    • Ora puoi calcolare calcoli semplici e complessi e/o punteggi di scala E li hai memorizzati nel database senza bisogno di JavaScript.
    • Usa il tipo di domanda Equazione per eseguire questa operazione.
  3. Valutazioni
    • Ora puoi creare valutazioni o ridimensionare i punteggi di qualsiasi tipo di domanda, non solo del sottoinsieme che era supportato
    • Puoi utilizzare Tailoring per mostrare i punteggi delle valutazioni correnti o totali ovunque sia necessario, anche sulla stessa pagina
    • Hai più controllo sui report generati in base a tali punteggi di valutazione
    • Puoi memorizzare i punteggi di valutazione nel database senza bisogno di JavaScript
    • Puoi nascondere i punteggi di valutazione senza bisogno di JavaScript o CSS
  4. Campi sostitutivi
  5. *Invece di utilizzare {INSERTANS:SGQA}, puoi semplicemente utilizzare il codice domanda: questo semplifica la lettura e la convalida.
    • Questo evita anche la necessità comune di modificare le domande per cambiare il codice SGQA per far funzionare tutto .
  6. Tailoring - puoi visualizzare in modo condizionale il testo basato su altri valori
    • Usa il titolo appropriato per un oggetto, come (es. "Ciao [ Mr./Mrs.] Smith")
    • Produce frasi grammaticalmente corrette in base al singolare/plurale: (ad es. "You have 1 child" vs. "You have 2 children")
    • Coniugazione appropriata dei verbi e rifiuta i nomi in base al genere e alla pluralità del soggetto.
  7. Nuovi attributi variabili: puoi accedere a quanto segue per personalizzare:
    • (nessun suffisso) - un alias per qcode.code
    • . code - il codice di risposta selezionato per la domanda se è rilevante (altrimenti vuoto), o il valore del testo se non è una domanda codificata
    • .NAOK - uguale a .code, ma può far parte di calcoli o elenchi anche se irrilevante
    • .value - il valore di valutazione per la domanda se è rilevante (altrimenti vuoto), o il valore di testo se non è una domanda codificata -- disponibile se le valutazioni sono abilitate per il sondaggio, altrimenti sempre zero
    • .valueNAOK - uguale a .value, ma può far parte di calcoli o liste anche se irrilevante
    • .shown - la risposta mostrata all'utente (questo è ciò che fa {INSERTANS:xxx} )
    • .qid - l'ID domanda
    • .gid - l'ID gruppo
    • .sgqa - il valore SGQA per la domanda
    • .jsName - il nome corretto della variabile javascript per la domanda, indipendentemente dal fatto che sia definita in questa pagina o in un'altra
    • .qseq - la sequenza della domanda (a partire da 0)
    • .gseq - la sequenza del gruppo (a partire da 0)
    • . obbligatori - se la domanda è obbligatoria (S/N)
    • .question - il testo della domanda
    • .relevance - l'equazione di rilevanza per la domanda
    • .grelevance - l'equazione di rilevanza per il gruppo
    • .relevanceStatus - se la domanda è attualmente pertinente o meno (booleano (può essere diverso in PHP e JS))
    • .type - il tipo di domanda (il codice di un carattere)!N !#Modifiche dinamiche sulla pagina
    • Tutte le pertinenze, i calcoli e la personalizzazione funzionano in modo dinamico su una pagina, quindi le modifiche ai valori aggiornano istantaneamente la pagina
    • Quindi, le domande appaiono/scompaiono dinamicamente a seconda che sono pertinenti
    • Anche le domande sono adattate dinamicamente in base alle risposte sulla pagina, quindi puoi vedere i totali parziali, le frasi personalizzate e i rapporti personalizzati.
  8. Nuova schermata di immissione dati
    • Oltre a utilizzare l'attuale sistema di inserimento dati, puoi semplicemente utilizzare Survey-All-In-One.
    • Questo supporta la pertinenza e la personalizzazione della pagina, quindi gli addetti all'inserimento dati possono scorrere rapidamente e dovranno solo inserire il risposte pertinenti
    • Questo può essere fondamentale se la persona che inserisce i dati ha bisogno di vedere la personalizzazione, che è anche dinamica.
  9. Elimina la necessità della maggior parte dei JavaScript personalizzati
    • EM supporta facilmente calcoli complicati, punteggio , sartoria e logica condizionale.
    • Alcune cose avranno ancora bisogno di JavaScript (come layout personalizzati e sotto-elementi delle domande nascosti in modo condizionale), ma il tuo JavaScript può utilizzare le funzioni EM in modo che tu possa accedere alle domande tramite il loro Qcode invece di SGQA e accedere a qualsiasi proprietà della domanda sopra elencata.

Quali sono altre utili nuove funzionalità abilitate da EM?

Indipendentemente dal fatto che tu continui a utilizzare l'editor delle condizioni o a comporre manualmente le equazioni di pertinenza, ottieni questi vantaggi aggiuntivi:

  1. Puoi creare criteri di convalida più complessi
    • Tutti gli attributi delle domande avanzate (come max_answers, min_num_value_n, max_num_value) può utilizzare le espressioni. Pertanto, i criteri min/max possono essere facilmente regolati in base alle risposte precedenti, anche se si trovano sulla stessa pagina.
    • EM gestisce anche tutte le convalide basate sulle espressioni regolari, in modo da poter combinare in modo affidabile preg ed equazione- basati sugli attributi delle domande.
  2. Facile riordinamento (o eliminazione) di domande e gruppi
    • Prima della versione 1.92, non era possibile riordinare domande o gruppi se LimeSurvey riteneva che tale riordinamento potesse interrompersi condizioni in cui sono stati utilizzati. Allo stesso modo, non è possibile eliminare le domande se qualsiasi altra domanda dipende da esse.
    • Con l'evidenziazione della sintassi di EM, è facile vedere e convalidare se si tenta di utilizzare le domande prima che vengano dichiarate. Quindi, ora ti consentiamo di riordinare o eliminare domande e gruppi quando vuoi. EM aggiornerà tutta l'evidenziazione della sintassi per mostrarti potenziali errori.
    • La visualizzazione delle domande di riordino è stata migliorata per facilitare tale revisione. Ora mostra l'equazione di pertinenza e l'adattamento della domanda, in modo da poter vedere immediatamente se le variabili diventano rosa (nel senso che vengono utilizzate prima di essere dichiarate).
  3. L'indice di navigazione della domanda/gruppo è sempre disponibile e accurato
    • Prima della versione 1.92, questi indici non erano disponibili in presenza di condizioni complesse
    • Con EM, possiamo garantire che siano accurati.
    • I soggetti possono persino tornare indietro, a una domanda precedente, modificare la risposta , quindi salta in avanti (o invia)
      • Quando salti in avanti, EM convaliderà nuovamente tutte le domande/gruppi intervenuti.
      • Se qualsiasi domanda diventa irrilevante, verrà NULLATA nel database in modo che i tuoi dati siano internamente coerenti
      • Se qualsiasi domanda diventa pertinente o non rispetta le regole obbligatorie o di convalida, EM si fermerà su quella pagina e obbligherà l'utente a rispondere a tali domande prima di passare alla destinazione finale.
#Conversione automatica delle condizioni in pertinenza
    • Quando aggiorni il tuo database, tutte le indagini esistenti che hanno condizioni avranno equazioni di pertinenza generate per esse
    • Ogni volta che importi un'indagine, le equazioni di pertinenza verranno create secondo necessità
    • Ogni volta che aggiungi, elimini o modifichi condizioni, EM genererà l'equazione di rilevanza appropriata.
  1. Evidenziazione della sintassi conveniente
    • Quando EM mostra l'equazione di rilevanza, mostrerà il Qcode, anche se hai inserito un codice SGQA, poiché presumiamo che sarà più facile da leggere.
    • Tutte le variabili sono codificate a colori per mostrare se sono state dichiarate prima o dopo la domanda corrente (o prima o dopo il gruppo corrente). Ciò ti consente di rilevare e correggere rapidamente i casi in cui provi a utilizzare le variabili per la pertinenza (incluso array_filter), la personalizzazione o le equazioni di convalida prima di dichiararle.
    • Inoltre, se passi il mouse sopra la variabile con codice colore , vedrai i metadati più importanti relativi a quella domanda. Ciò include la sequenza di gruppo n., la sequenza di domande n., il Qcode, il testo della domanda e tutte le scelte di risposta disponibili (se si tratta di un tipo di domanda con scelte di risposta enumerate).
      • L'elenco delle scelte di risposta utilizza questa sintassi : 'risposte':{key:val, ... }.
      • key ha la sintassi 'scale~code' dove scale è la scala della risposta (es. per doppia scala), e code è il codice di risposta.
      • val ha la sintassi 'value~shown' dove value è il valore della valutazione (se si utilizzano le valutazioni, altrimenti code)(es. Qcode.value), e shown è il valore visualizzato dal soggetto (es. Qcode.shown)
      • Questo significa che molti sondaggi possono utilizzare i calcoli senza bisogno della modalità di valutazione. Se hai enumerato opzioni di risposta univoche, non decimali e non negative, puoi semplicemente eseguire calcoli sui valori Qcode.code.
  2. Facile revisione dell'intera logica e contenuto del sondaggio
    • C'è una nuova funzione Mostra logica sondaggio che ti consente di vedere tutto ciò che riguarda il sondaggio (o gruppo o domanda) su una singola pagina.
    • Mostra i dettagli a livello di gruppo, domanda, sotto-domanda e risposta per l'ambito selezionato (sondaggio vs. gruppo vs. domanda)
    • Mostra anche la pertinenza, la pertinenza a livello di sottodomanda (per array_filter e array_filter_exclude) e l'equazione di validazione generata (per preg e qualsiasi regola di validazione come min/max sum/number of valori) e tutti gli attributi delle domande non vuote.
    • Tutto è evidenziato in sintassi in modo da poter vedere potenziali errori di sintassi (come parentesi non bilanciate o uso di variabili prima che fossero dichiarate)
    • La sintassi- l'evidenziazione supporta la navigazione e la modifica rapide del sondaggio.
      • Se fai clic sul nome di una variabile, si apre una finestra del browser (o scheda) che mostra quella domanda e ti consente di modificarla.
      • Se fai clic sul nome di un gruppo, si apre una finestra del browser (o scheda) che mostra la vista di riordino del gruppo in modo da poter spostare facilmente le domande.
      • Tutti gli attributi della domanda sono anche evidenziati nella sintassi. Ciò ti consente di impostare e visualizzare le espressioni all'interno delle opzioni di domanda avanzate (come basare il numero massimo/minimo/la somma dei valori su un'espressione)
    • L'autore di EM ha utilizzato una visualizzazione simile (un po' più chiara) per consentire ai suoi collaboratori epidemiologi e istituzionali Review Board convalida e autorizza sondaggi con migliaia di domande in interviste strutturate altamente ramificate e personalizzate

Per iniziare

Il modo migliore per iniziare con EM è:

  • Installare l'ultima versione stabile da http://www.limesurvey.org/en/download
  • Importare ed esplorare i sondaggi di esempio .
  • Esplora casi d'uso e HowTo e esempi passo-passo.
  • Esplora la documentazione EM (questa pagina)! N!*Esamina la suite di test EM integrata
    • Da qualsiasi sondaggio, in Strumenti, seleziona l'opzione EM
    • Funzioni disponibili elenca le oltre 70 funzioni e la sintassi
    • Test unitari di test isolati Expressions
      • mostra esempi di utilizzo di tutte le funzioni e gli operatori EM e i risultati PHP e JavaScript
      • nota che ci sono poche funzioni che generano risultati diversi nelle versioni PHP e JavaScript, quindi questa pagina ti consente pianifica la tua logica EM di conseguenza.

Quali funzionalità vengono estese/sostituite da Expression Manager? (LimeSurvey <= 1.91+)

Condizioni => Rilevanza

Le condizioni controllano quali domande sono visibili. La sintassi generale era SGQA operator Value, come 111X2X3 == "Y". Le condizioni potevano essere combinate in AND o OR insieme, ma mescolare AND e OR era difficile. Le condizioni stesse erano memorizzate in una tabella separata e gran parte del codice di LimeSurvey era dedicato alla gestione delle condizioni. A causa dell'ampio accesso al database, l'elaborazione di un numero elevato di condizioni potrebbe causare notevoli problemi di prestazioni. Inoltre, una volta assegnate le condizioni alle domande o ai gruppi, spesso non era consentito riordinarli o eliminarli.

Valutazioni => Equazioni e Micro-Adattamento

Le valutazioni consentono agli utenti di creare punteggi di scala da una raccolta di domande. Tuttavia, non potevano cambiare dinamicamente nella pagina corrente e i loro valori non venivano archiviati nel database.

Sostituzioni => Micro-Sartoria

Gli utenti possono personalizzare alcuni messaggi e domande in base alle risposte precedenti. Ad esempio, una domanda potrebbe essere {TOKEN:FIRSTNAME}, hai detto che {INSERTANS:111X3X4} era il tuo sport preferito. Tuttavia, non era possibile adattare le condizioni (come dire "Mr." o "Mrs." a seconda del genere della persona), o coniugare verbi o rifiutare sostantivi senza JavaScript di fantasia. Gli autori potevano implementare sondaggi che sembravano adattare le domande, ma richiedevano domande separate per ogni permutazione e condizioni complesse per decidere quali domande visualizzare.

Convalida

La domanda può essere convalidata con espressioni regolari o valori minimo/massimo oppure lasciare che una risposta SGQA serva come valore minimo o massimo. Tuttavia, le convalide non possono essere basate su calcoli di altre variabili senza JavaScript di fantasia.

Equazioni

Le equazioni non erano supportate senza JavaScript di fantasia.

Tipo di domanda equazione

Le equazioni non possono essere salvate nel database (ad es. il punteggio finale per una valutazione) senza JavaScript sofisticato.

In che modo Expression Manager sostituirà/estenderà tale funzionalità?

Expression Manager è un nuovo modulo principale all'interno di LimeSurvey che rende molto più semplice supportare il tipo di funzionalità complesse che prima richiedevano JavaScript personalizzato. Sta anche sostituendo il modo in cui LimeSurvey attualmente gestisce Condizioni e Valutazioni.

Nuova terminologia quando si fa riferimento a Expression Manager (EM)

EM "pensa" alla sua funzionalità nei seguenti termini:

  • Branching basato sulla pertinenza - se una domanda è rilevante, allora ponila, altrimenti non farlo (ad es. rendila invisibile e contrassegnala come NULL nel database). C'è un nuovo campo Rilevanza per tutti i tipi di domanda e anche per ogni gruppo (quindi puoi applicare una serie di condizioni a un intero gruppo senza dover copiare la stessa condizione a ogni domanda e/o combinare condizioni di gruppo e a livello di domanda logica).
  • Tailoring - Una volta che sai quali domande dovrebbero essere poste, il tailoring (a volte chiamato piping) specifica come la domanda dovrebbe essere posta. Ciò ti consente di supportare non solo la semplice sostituzione (come {TOKEN:FIRSTNAME}), ma anche la coniugazione dei verbi e la declinazione dei sostantivi in base al genere o al numero dei tuoi soggetti. Ti consente anche di modificare il messaggio che invii a un soggetto in base al fatto che abbia risposto (o come abbia risposto) ad altre domande.
  • Equazioni - EM aggiunge un nuovo tipo di domanda chiamato Equazione che memorizza il risultato di un'Espressione. I risultati di queste equazioni vengono calcolati e scritti nel database, anche se li nascondi nella pagina. Pertanto, sono utili per calcoli di punteggio nascosti, navigazione basata su equazioni complesse, valutazioni e report che dovrebbero essere generati e facilmente disponibili all'interno del database.

Pertinenza e pertinenza a cascata

Ogni tipo di domanda ora ha un'opzione Rilevanza che controlla se la domanda viene visualizzata. EM elabora ciascuna delle equazioni di rilevanza nell'ordine in cui dovrebbe apparire nel sondaggio. Se l'espressione è vera (o mancante - per supportare i sondaggi precedenti), verrà visualizzata la domanda. Se non è rilevante, la domanda verrà nascosta e il valore verrà annullato nel database. Se non ci sono domande pertinenti in un gruppo, l'intero gruppo verrà saltato.

Inoltre, se una qualsiasi delle variabili all'interno di un'espressione è irrilevante, l'espressione restituisce sempre false. Ciò abilita la pertinenza a cascata in modo da non dover scrivere equazioni di pertinenza molto lunghe per ogni domanda.

Supponiamo che tu abbia 5 domande Q1-Q5 e desideri solo mostrare Q2 se è stata data risposta a Q1 e Q3 se è stata data risposta a Q2, ecc. Le equazioni di rilevanza potrebbero essere:

Codice domanda Rilevanza Domanda
Q1 1 Come ti chiami?
Q2 Q1 {Q1}, quanti anni hai?
Q3 Q2 Allora, hai {Q2} anni. Sei sposato?
Q4 Q3 == "S" {Q1}, da quanto tempo sei sposato?
Q5 Q4 Quanti figli hai, {Q1}?

I calcoli di pertinenza funzionano anche in JavaScript, quindi puoi inserire tutte le domande di cui sopra su una pagina e funzionerebbe comunque come previsto. In effetti, EM sostituisce totalmente il modo in cui EM elabora i formati di indagine Survey vs. Group vs. Question-at-a-time. Ora utilizzano tutti esattamente lo stesso motore di navigazione, quindi funzionano in modo identico indipendentemente dallo stile del sondaggio.

Finché ti trovi sulla stessa pagina, tutti i dati che hai inserito saranno ancora lì, solo nascosti. Quindi, se inserisci alcune informazioni, quindi scegli un'opzione che le rende irrilevanti, quindi rendile nuovamente rilevanti, le tue risposte saranno ancora disponibili. Tuttavia, non appena si passa a una pagina diversa, tutte le risposte irrilevanti andranno perse per l'integrità del set di dati.

Rilevanza a livello di gruppo

Expression Manager supporta anche la pertinenza a livello di gruppo. Ciò semplifica l'implementazione del looping. Supponiamo che tu voglia raccogliere informazioni su un massimo di 10 entità (come prodotti o persone in una famiglia), dove prima determini quante entità necessitano di follow-up (ad esempio chiedendo quante persone vivono in una famiglia o chiedendo alle persone di controllare quali prodotti preferiscono da un lungo elenco). Dopo aver saputo quante entità necessitano di follow-up, puoi utilizzare la pertinenza a livello di gruppo come {count >= 1}, {count >=2}, ... {count >= 10} per ciascuno dei 10 gruppi di follow- domande. All'interno di ogni gruppo, puoi avere una logica condizionale a livello di domanda (ad es. domande di follow-up specifiche per sesso o età per ogni materia). La domanda e le equazioni di rilevanza a livello di gruppo vengono combinate in AND insieme per determinare quale deve essere mostrato.

Sartoria / Tubazioni

Tutto ciò che si trova all'interno delle parentesi graffe viene ora trattato come un'espressione (con un'eccezione descritta di seguito). Le espressioni hanno accesso a tutti i LimeReplacementFields, a tutte le variabili (tramite diversi alias), a tutti i tipici operatori di equazioni (matematici, logici e di confronto) e a dozzine di funzioni (che funzionano anche dinamicamente sul lato client).

Usando queste equazioni, puoi fare cose come:

  1. Mostrare in modo condizionale messaggi personalizzati agli intervistati in base alle risposte precedenti
  2. Creare Valutazioni e mostrare i risultati della Valutazione (o diramare in modo condizionale o mostrare messaggi) in base a tali risultati, tutti senza utilizzare il modulo Valutazioni stesso
  3. Coniuga i verbi e rifiuta i nomi all'interno di domande, risposte e rapporti.
  4. Mostra i riepiloghi delle risposte prima della pagina "Mostra le tue risposte" alla fine del sondaggio

Equazioni

C'è un nuovo tipo di domanda chiamato Equazione. È come una domanda Boilerplate, tranne per il fatto che memorizza il valore di ciò che viene visualizzato nel database. Pertanto, se il testo della domanda sull'equazione contiene un calcolo di valutazione, tale valore verrà archiviato nel database in una variabile che può essere visualizzata all'interno di statistiche pubbliche o private.

Questo risolve una richiesta comune per l'archiviazione dei punteggi di valutazione all'interno del database

Sintassi

Tutto ciò che è contenuto all'interno delle parentesi graffe è ora considerato un'espressione (con un'eccezione: non devono essere presenti spazi bianchi iniziali o finali, necessari per garantire che Expression Manager non tenti di elaborare JavaScript incorporato).

Nota, è OK che le espressioni si estendano su più righe, purché non ci siano spazi bianchi dopo la parentesi graffa di apertura o prima della parentesi graffa di chiusura. Ciò è particolarmente utile per istruzioni if() annidate come questa:

{if(is_empty(PFTotals),
 '',
 if(PFTotals >= -5 && PFTotals <= -4,
 'Very Soft',
 if(PFTotals >= -3 && PFTotals <= -2,
 'Morbido',
 if(PFTotals == -1,
 'Un po' debole',
 if(PFTotals == 0,
 'Moderato',! N! if(PFTotals == 1,
 'Un po' difficile',
 if(PFTotals >= 2 && PFTotals <= 3,
 'Difficile',
 if(PFTotals >= 4 && PFTotals <= 5,
 'Molto difficile',
 ''
 )
 )
 )
 )
 )
 )
 )
)}
Expression Manager supporta la seguente sintassi:
  • Tutti gli operatori matematici standard (ad es. +,-,*,/,!)
  • Tutti gli operatori di confronto standard (ad es. <,<=,==,!=,>,>=, più questi equivalenti: lt,le,eq,ne,gt,ge)
  • Parentesi (così puoi raggruppare le sottoespressioni)
  • Operatori condizionali (es. &&,| | e questi equivalenti: and,or)
  • Stringhe con virgolette singole e doppie (ognuna delle quali può incorporare stringhe con l'altro tipo di virgolette)
  • Operatore virgola (quindi può avere un elenco di espressioni e restituire solo il risultato finale)
  • Operatore di assegnazione (=)!N !*Variabili predefinite (per fare riferimento a domande, attributi delle domande e risposte) - ad es. tutti i codici SGQA
  • Funzioni predefinite (ce ne sono già più di 70 ed è facile aggiungerne altre)

Operatori

La sintassi EM segue la normale precedenza degli operatori:

Livello Operatore(i) Descrizione
1 () parentesi per raggruppare o chiamare funzioni
2 ! - + operatori unari: non, negazione, unario-più
3 * / volte, dividere
4 + - più , minus
5 < <= > >= lt le gt ge confronti relativi
6 == != eq ne confronti di uguaglianza
7 e AND logico
8 o OR logico
9 = assegnazione operatore
10 , operatore virgola

Avviso con operatore più (+)

Per coerenza tra JavaScript e PHP, l'operatore più (+) esegue l'addizione se entrambi gli operandi sono numerici, ma esegue la concatenazione se entrambe le parti sono stringhe non numeriche. Tuttavia, ti consigliamo di utilizzare la funzione join() per la concatenazione e la funzione sum() per l'addizione, in quanto ciò rende più chiaro il tuo intento ed evita risultati imprevisti se ti aspettavi delle stringhe ma hai invece dei numeri (o viceversa versa).

Avviso con mancata corrispondenza tra numero e stringa e confronto alfabetico

Quando si desidera confrontare il valore con confronti relativi o di uguaglianza, prestare attenzione alla mancata corrispondenza del tipo. Il valore inserito dall'utente o il codice di risposta selezionato può essere utilizzato come numero se è chiaramente un numero. Se racchiudi uno dei valori tra " , verrà forzato il confronto come testo (confronto alfabetico). Se desideri confrontare numericamente, non racchiudere mai il numero tra virgolette, " .

Ad esempio Q0.NAOK > "50" è vero se Q0.NAOK è una domanda numerica con 9 come valore. Questo perché l'operatore > assumerà che sia un confronto alfabetico e non numerico.

Per essere sicuri di confrontare il valore intero, puoi usare intval(Q0.NAOK) > 50 , ricorda solo che se Q0.NAOK non è un numero (vuoto o una stringa), allora intval(Q0. NAOK) === 0. Per confrontare il valore stringa ("A" < "B") utilizzare strcmp direttamente: strcmp(Q0.NAOK,"B") o strcmp(Q0.NAOK,"A5") .

Attenzione sull'uso dell'operatore di assegnazione (=)

Nota, dovresti evitare di utilizzare gli operatori di assegnazione a meno che non sia assolutamente necessario, poiché potrebbero causare effetti collaterali imprevisti. Ad esempio, se modifichi il valore di una risposta precedente, la pertinenza a cascata e la logica di convalida tra quella domanda e la domanda corrente non vengono ricalcolate, quindi potresti ritrovarti con dati internamente incoerenti (ad es. stato annullato NULL o domande che sono state saltate ma avrebbero dovuto avere una risposta). In generale, se si desidera assegnare un valore a una variabile, è necessario creare un tipo di domanda Equazione e utilizzare un'espressione per impostarne il valore. Tuttavia, ci sono alcune rare volte in cui le persone hanno davvero bisogno di questo operatore, quindi l'abbiamo reso disponibile.

Per aiutarti a metterti in guardia su questo operatore, è mostrato in carattere rosso all'interno delle equazioni di sintassi (in modo da non confonderlo con "==")

Utilizzo dell'operatore di assegnazione

I motivi principali per cui potresti voler utilizzare l'assegnazione sono:

  • Devi impostare il valore predefinito per una domanda che non accetta i valori predefiniti tramite equazione (come list radio, dove l'interfaccia utente ti consente di scegliere una delle opzioni di risposta, ma non ti consente di inserire un'equazione). Tuttavia, fai attenzione, poiché LimeSurvey non sarà in grado di convalidare che la tua equazione generi una delle risposte consentite per quella domanda.
  • Devi forzare la modifica della risposta a una domanda precedente basata su una risposta successiva
  • Hai bisogno di una quota complessa: usa una singola scelta nascosta per la quota e impostala usando l'assegnazione! N! * ecc ...

È possibile utilizzare tutti i sistemi di gestione delle espressioni per questo scopo.

  L'assegnazione viene eseguita solo in PHP. Questo non aggiorna alcun valore sulla stessa pagina, ma solo quando l'utente naviga con next, previous, save ….


  Se non si utilizza un tipo di equazione domanda per questo scopo: l'assegnazione viene eseguita solo dopo che la logica della pagina corrente è terminata. Il metodo consigliato è utilizzare sempre una domanda sull'equazione.


Alcuni esempi:

  • Imposta la risposta a una breve domanda di testo in minuscolo: {QCODE=strtolower(QCODE.NAOK)}
  • Imposta una risposta predefinita a un tipo di domanda array all'inizio di un sondaggio: {Q1_SQ1=((is_empty(Q1_SQ1.NAOK),"A99",Q1_SQ1.NAOK)}
  • Imposta una risposta predefinita a un tipo di domanda di tipo array all'inizio di un sondaggio: {Q1_SQY1_SQX1 = ((is_empty(Q1_SQY1_SQX1.NAOK),"Inserted answer", Q1_SQY1_SQX1.NAOK)}
  • Imposta una risposta con condizione: {QCODE=if(YesNo="Y","A1","")}

Sicurezza XSS

Con XSS abilitato, alcuni sistemi di gestione delle espressioni non possono essere utilizzati:

  • inizia un tag HTML nell'espressione ma termina con un'altra espressione
  • utilizza un'espressione complessa nell'URL.

Esempio e soluzione alternativa

  • {if( 1 ,"","")}information{if( 1 ,"","")} funzionanti con la sicurezza XSS, qui puoi utilizzare
  • <a href="/script.php?value={if(QCODE == "Y","yes","no")}">next</a>, here you can use an equation question because using a complete question code is OK : <a href="/script.php?value={EQUATION.NAOK}">next</a> information","information"
  • <a href="/script.php?value={if(QCODE == "Y","yes","no")}">next</a>, here you can use an equation question because using a complete question code is OK : <a href="/script.php?value={EQUATION.NAOK}">next</a>

Accesso alle variabili

Expression Manager fornisce l'accesso in sola lettura a qualsiasi variabile di cui potremmo aver bisogno. Per retrocompatibilità, fornisce l'accesso a quanto segue:

  • TOKEN:xxx - il valore di un TOKEN (ad es. TOKEN:FIRSTNAME, TOKEN:ATTRIBUTE_5) (solo per sondaggi NON anonimi).
  • INSERTANS:SGQA - il valore visualizzato di una risposta (es. "Sì"). Per Expression Manager è lo stesso che usando {QCODE.shown}.
  • Tutti {XXX} valori usati dai modelli.
  • Nel testo della domanda, puoi usare {QID} sostituito dall'id della domanda e {SGQ} sostituiti dall'SGQA della domanda

Inoltre, Expression Manager consente di fare riferimento alle variabili tramite il codice domanda (la colonna "titolo" nella tabella delle domande all'interno del database). Questa è anche l'etichetta della variabile utilizzata quando si esportano i dati in SPSS, R o SAS. Ad esempio, se hai domande su nome, età e sesso, puoi chiamare queste variabili nome, età e sesso invece di 12345X13X22, 12345X13X23' ', e 12345X13X24. Ciò semplifica la lettura delle equazioni e la convalida della logica da parte di tutti, inoltre consente di mescolare le domande senza dover tenere traccia dei numeri di gruppo o delle domande.

Importante: È sicuro fare riferimento solo a variabili che si verificano nelle pagine o domande precedenti.

Inoltre, Expression Manager ti consente di accedere a molte proprietà della Domanda:


Sintassi Significato Esempio Esempio Risultato
Qcode un alias per Qcode.code {implode(',',name,gender )} 'Tom','M'
Qcode.code il codice di risposta selezionato per la domanda se è rilevante (altrimenti vuoto), o il valore del testo se non è un domanda in codice {implode(',',name.code,gender.code)} 'Tom','M'
Qcode.NAOK uguale a Qcode - vedi discussione su NAOK {gender.NAOK} 'M'
Qcode.value il valore di valutazione per la domanda se è rilevante (altrimenti vuoto), o il valore del testo se non lo è una domanda in codice {gender.value} '1'
Qcode.valueNAOK uguale a Qcode.value - vedi discussione su NAOK {gender.valueNAOK} '1 '
Qcode.shown il valore visualizzato per la domanda {implode(',',name.shown,gender.shown)} - Qcode.question il testo della domanda {gender.question} 'Qual è il tuo genere?'
Qcode.mandatory se la domanda è obbligatorio (S/N) {gender.mandatory} 'N'
Qcode.qid il numero della domanda interna (non il numero progressivo) {gender.qid} 337
Qcode.type il tipo di domanda {gender.type} 'G'
Qcode.jsName il nome javascript corretto per la domanda, indipendentemente dal fatto che sia dichiarato all'interno o all'esterno di questa pagina {gender.jsName} 'java1827X3X337'
Qcode.gid il numero di gruppo interno (non il numero sequenziale) {gender.gid} 3
Qcode.qseq il numero progressivo della domanda, partendo da 0 {gender.qseq} 5
Qcode.gseq il numero sequenziale del gruppo, a partire da 0 {gender.gseq} 1
Qcode.relevanceStatus se la domanda è attualmente pertinente (0 o 1 ) {gender.relevanceStatus} 1
Qcode.relevance l'equazione di rilevanza a livello di domanda {gender.relevance} '!is_empty(name)'
Qcode.grelevance l'equazione di rilevanza a livello di gruppo {gender.grelevance} 'num_children >= 5'
Qcode.sgqa il valore SGQA per questa domanda {gender.sgqa} '1827X3X337'

Problema con l'editor HTML

Template:Avviso

Se utilizzi l'editor HTML, alcuni caratteri vengono sostituiti da entità HTML.

  • & da &
  • < da <
  • > da >

Se usi un editor HTML devi usare :

  • e for &
  • lt for <
  • le for <=
  • gt for >
  • ge per >=

Denominazione variabile Qcode

Ecco i dettagli su come costruire un Qcode (e accedere ad alcune proprietà) per tipo di domanda. In generale, i Qcode sono costruiti come:

DomandaCodice . '_'. ID domanda secondaria . '_'. ID scala

Per comment e other, il codice della domanda è QuestionCode_comment e QuestionCode_other

Tipo Descrizione Codice SubQs Opzioni di risposta Scale Codice di risposta Risposta mostrata Pertinenza
5 5 Pulsanti radio Point Choice Q1 1-5 {Q1} {Q1.mostrato} {Q1==3}
B Array (10 punti di scelta) Pulsanti radio Q2 |1-10 {Q2_L2} {Q2_L2.mostrato} {Q2_L2==7}
A Array (scelta a 5 punti) Pulsanti radio Q3 |1-5 {Q3_1} {Q3_1.mostrato} {Q3_1>=3}
1 Array (etichette flessibili) Doppia scala Q4 sq1-sq5 0 :a1-a3 1:b1-b3 {Q4_sq1_0} {Q4_sq1_1.mostrato} {Q4_sq1_1=='b2'}
H Array (flessibile) - Formato colonna Q5 1-5 s,m,t {Q5_1} {Q5_1.mostrato} {Q5_1=='s'}
F Array (flessibile) - Formato riga Q6 |1-5 {Q6_F3} {Q6_F3.mostrato} {Q6_F3==4}
E Array (Aumenta/Uguale/Diminuisci) Pulsanti Radio Q7 1- 7 I,S,D {Q7_4} {Q7_4.mostrato} {Q7_4=='D'}
: Array (Multi Flexi) da 1 a 10 Q8 ls1,todo ,ls2 min,max,media {Q8_ls1_max} {Q8_ls2_avg.shown} {Q8_ls2_min==7}
; Array (Multi Flexi) Testo Q9 hp,st,sw 1°,2°,3° {Q9_hp_3rd} {Q9_hp_3rd.shown} {Q9_hp_3rd=='Peter'}
C Array (Sì/Incerto/No) Pulsanti radio Q10 1-5 Y,N,U {Q10_1} {Q10_1.mostrato} {Q10_3=='Y'}
X Domanda standard Q11 {Q11.mostrato}
G Data Q12 {Q12} {Q12.mostrato}
* Equazione Q13 {Q13} {Q13.mostrato} {Q13>5}
~124~ File Upload (registra il numero di file caricati) Q14 {Q14} {Q14>0}
G Elenco a discesa Sesso Q15 M,F {Q15} {Q15.mostrato} {Q15=='M'}
U Testo libero enorme Q16 {Q16} {Q16.mostrato} {strlen(Q16)>100}
I Domanda Lingua Q17 {Q17} {Q17.mostrato} {Q17=='it'}
! Lista - Dropdown Q18 1-5 {Q18} {Q18.mostrato} {Q18==3}
L Elenco a discesa/Elenco pulsanti radio Q19 AZ {Q19} {Q19.mostrato} {Q19=='X'}
O Elenco con menu a tendina commenti/Elenco pulsanti radio + Area di testo Q20 AF {Q20},{Q20comment} {Q20.shown} {Q20=='B'}
T Testo libero lungo Q21 {Q21} {Q21.mostrato} {strstr(Q21,'hello')>0}
M Casella di scelta multipla Q22 | {Q22_E}, {Q22_other} {Q22_E.shown}, {Q22_other.shown} {Q22_E=='Y'}
P Scelta multipla con commenti Casella di controllo + Testo Q23 AF {Q23_D}, {Q23_Dcomment} {Q23_D.mostrato} {!is_empty(Q23)}
K Domanda numerica multipla Q24 se stesso, mamma, papà {Q24_self} {Q24_self.mostrato} {Q24_self>30}
Q Testo breve multiplo Q25 AF {Q25_B} {Q25_B.mostrato} {substr(Q25_B,1,1)=='Q'}
N Tipo di domanda numerica Q26 {Q26} {Q26.mostrato} {Q26 > 30}
R Stile classifica Q27 1-4 {Q27_1} {Q27_1.mostrato} {Q27_1==3}
S Testo libero breve Q28 {Q28} {Q28.mostrato} {Q28=='mio'}
Y Pulsanti radio Sì/No Q29 {Q29} {Q29.mostrato} {Q29=='S'}

Le variabili riservate 'this', 'self' e 'that'

Molto spesso, si desidera valutare tutte le parti di una domanda, ad esempio contando quante sottodomande hanno ricevuto risposta o sommando i punteggi. Altre volte, vuoi elaborare solo determinate righe o colonne di una domanda (come ottenere le somme di righe o colonne e memorizzarle nel database). Queste variabili riservate rendono tale processo relativamente indolore.

La variabile "questa" viene utilizzata esclusivamente all'interno delle opzioni di domanda avanzata "Equazione di convalida dell'intera domanda" e "Equazione di convalida della sottodomanda". Si espande ai nomi delle variabili di ciascuna delle celle all'interno di tali domande. Quindi, se vuoi assicurarti che ogni voce sia maggiore di tre, devi impostare "Equazione di convalida della sottodomanda" su (this > 3).

Le variabili "sé" e "quella" sono più potenti e fungono da macro che vengono espanse prima dell'elaborazione delle equazioni. Le scelte di sintassi sono:

  • self
  • self.suffix
  • self.sub-selector
  • self.sub-selector. suffisso

suffisso è uno qualsiasi dei normali suffissi qcode (es. NAOK, valore, mostrato)

sub-selector è uno di:

  • comments - solo sottodomande che sono commenti (ad esempio, da scelta multipla con commento ed elenco con commento)
  • nocomments - solo sottodomande che non sono commenti
*sq_X - dove X è un identificatore di riga o colonna. Vengono selezionate solo le sottodomande che corrispondono al modello X. Si noti che la ricerca viene eseguita sull'identificatore di codice completo, quindi sq_X corrisponde e include le sottodomande nX, X, Xn (ad esempio, se si utilizza sq_1, le sottodomande a1, 1a, 1, 11 o 001 sono state incluse). Prestare attenzione al tipo di domanda a doppia scala in cui il codice delle domande secondarie è QCODE_SQCODE_1 e QCODE_SQCODE_1 e al tipo di domanda di classificazione in cui il codice delle domande secondarie è QCODE_1,QCODE_2 ....
  • nosq_X - dove X è un identificatore di riga o colonna. Vengono selezionate solo le domande secondarie che non corrispondono al modello X. Si noti che la ricerca viene eseguita sull'identificatore di codice completo, quindi nosq_X corrisponde e non include le sottodomande nX, X, Xn

Esempi:

  • È stata data risposta a qualche parte di una domanda? {count(self.NAOK)>0}
  • Qual è il punteggio di valutazione per questa domanda? {somma(self.valore)}

Puoi anche usarli per ottenere i totali di righe e colonne. Supponi di avere un array di numeri con righe AE e colonne 1-5.

  • Qual è il totale complessivo? {sum(self.NAOK)}
  • Qual è il totale della riga B? {sum(self.sq_B.NAOK)}
  • Qual è il totale della colonna 3? {sum(self.sq_3.NAOK)}

La variabile "quella" è come la variabile "self", ma ti consente di fare riferimento ad altre domande. La sua sintassi è:

  • that.qname
  • that.qname.suffix
  • that.qname.sub-selector' '
  • quello.qname.sottoselettore.suffisso

qname è il nome della domanda senza alcuna estensione della sottodomanda. Quindi, diciamo che crei una domanda 'q1', che è il suo qname

Esempi:

  • È stata data risposta a qualche parte della domanda q1? {count(that.q1.NAOK)>0}
  • Qual è il punteggio di valutazione per q2? {sum(that.q2.NAOK)}
  • Qual è il totale complessivo di q3? {sum(that.q3.NAOK)}
  • Qual è il totale della riga C in q4? {sum(that.q4.sq_C.NAOK)}
  • Qual è il totale della colonna 2 in q4? {sum(that.q4.sq_2.NAOK)}

The 'self' and 'that' variables can be used in any relevance,  validation, or tailoring.

The one caveat is that when you use the Show Logic File feature, it will show you the expanded value of 'self' and 'that'.  This lets you see the actual equation that will be generated so that you (and Expression Manager) can validate that the variables exist.  This may seem confusing since you may see quite lenghty equations.  However, if you edit the question, you will see the original equation using 'self' and/or 'that'

Also note that you should not use these variables if (a) you want to explicitly name each variable used in an equation, or (b) use variables that do not have subquestions (e.g. single response questions).  In those cases, prefixing a variable with 'that' is overkill, and you run the risk of getting unexpected results.

Usage of NAOK

NAOK --> "Not Applicable" (NA) is alright (OK)

Using NAOK, means that all or some of the variables are irrelevant (e.g. "Not Applicable" (NA) is alright (OK)).

When you put some variable from question in any equation : if this question (or subquestion) is hidden by condition : this disable all equation.

For example : count(Q1_SQ1,Q1_SQ2,Q1_SQ3,Q1_SQ4) give always an empty string if one subquestion of Q1 is filtered. To count the number of checked subquestion in such question can be count(Q1_SQ1.NAOK,Q1_SQ2.NAOK,Q1_SQ3.NAOK,Q1_SQ4.NAOK). If the sub question is hidden :Expression manager return an empty string.

Without NAOK : if one question or one subquestion is hidden : Expression Manager return always an empty string, same to return false.

The .shown always use the NAOK system (empty string if hidden) but if you need the code of the answer : it's always a good idea to add .NAOK after the question code. Except if you need it and know what you do.

Another example and information is provided at Overriding Cascading Conditions

Access to Functions

Expression Manager provides access to mathematical, string, and user-defined functions, as shown below.  It has PHP and JavaScript equivalents for these functions so that they work identically on server-side (PHP) and client-side (JavaScript).  It is easy to add new functions.

Implemented Functions

The following functions are currently available:

Function Meaning Syntax
abs Absolute value number abs(number)
acos Arc cosine number acos(number)
addslashes Quote string with slashes string addslashes(string)
asin Arc sine number asin(number)
atan Arc tangent number atan(number)
atan2 Arc tangent of two variables number atan2(number, number)
ceil Round fractions up number ceil(number)
checkdate Returns true(1) if it is a valid date in gregorian calendar bool checkdate(month,day,year)
convert_value Convert a numerical value using a inputTable and outputTable of numerical values number convert_value(fValue, iStrict, sTranslateFromList, sTranslateToList)
cos Cosine number cos(number)
count count the number of answered (non-blank) questions in the list number count(arg1, arg12, ..., argN)
countif Count the number of answered questions in the list equal to the first argument number countif(matches, arg1, arg2, ... argN)
countifop Count the number of answered questions in the list which pass the criteria (arg op value) number countifop(op, value, arg1, arg2, ... argN)
date Format a local date/time string date(format [, timestamp=time()])
exp Calculates the exponent of e number exp(number)
fixnum Display numbers with comma as radix separator, if needed string fixnum(number)
floor Round fractions down number floor(number)
gmdate Format a GMT date/time string gmdate(format [, timestamp=time()])
html_entity_decode Convert all HTML entities to their applicable characters (always uses ENT_QUOTES and UTF-8) string html_entity_decode(string)
htmlentities Convert all applicable characters to HTML entities (always uses ENT_QUOTES and UTF-8) string htmlentities(string)
expr_mgr_htmlspecialchars Convert special characters to HTML entities (always uses ENT_QUOTES and UTF-8) string htmlspecialchars(string)
expr_mgr_htmlspecialchars_decode Convert special HTML entities back to characters (always uses ENT_QUOTES and UTF-8) string htmlspecialchars_decode(string)
idate Format a local time/date as integer string idate(string [, timestamp=time()])
if (Updated in 3.0.2 ) Excel-style if(test,result_if_true[,result_if_false = ""]) if(test,result_if_true[,result_if_false = ""])
implode Join array elements with a string string implode(glue,arg1,arg2,...,argN)
intval Get the integer value of a variable int intval(number [, base=10])
is_empty Determine whether a variable is considered to be empty bool is_empty(var)
is_float Finds whether the type of a variable is float bool is_float(var)
is_int Find whether the type of a variable is integer bool is_int(var)
is_nan Finds whether a value is not a number bool is_nan(var)
is_null Finds whether a variable is NULL bool is_null(var)
is_numeric Finds whether a variable is a number or a numeric string bool is_numeric(var)
is_string Find whether the type of a variable is string bool is_string(var)
join (New in 2.0 build 130129) Join elements as a new string join(arg1, arg2, ... argN)
list Return comma-separated list of non-blank values string list(arg1, arg2, ... argN)
listifop (New in 3.16.1 ) Return a 'glue'-separated list of the specified question property (retProp) from questions in the list which pass the criteria (cmpProp op value) string listifop(cmpProp, op, value, retProp, glue, sgqa1, sgqa2, ... sgqaN)
log The logarithm of number to base, if given, or the natural logarithm. number log(number,base=e)
ltrim Strip whitespace (or other characters) from the beginning of a string string ltrim(string [, charlist])
max Find highest value number max(arg1, arg2, ... argN)
min Find lowest value number min(arg1, arg2, ... argN)
mktime Get UNIX timestamp for a date (each of the 6 arguments are optional) number mktime([hour [, minute [, second [, month [, day [, year ]]]]]])
modulo-function The modulo function is not supported yet. You can use the floor() function instead floor(x/y)==(x/y)
nl2br Inserts HTML line breaks before all newlines in a string string nl2br(string)
number_format Format a number with grouped thousands string number_format(number)
pi Get value of pi number pi()
pow Exponential expression number pow(base, exp)
quoted_printable_decode Convert a quoted-printable string to an 8 bit string string quoted_printable_decode(string)
quoted_printable_encode Convert a 8 bit string to a quoted-printable string string quoted_printable_encode(string)
quotemeta Quote meta characters string quotemeta(string)
rand Generate a random integer, see this example int rand() OR int rand(min, max)
regexMatch compare a string to a regular expression bool regexMatch(pattern,input)
round Rounds a number to an optional precision number round(val [, precision])
rtrim Strip whitespace (or other characters) from the end of a string string rtrim(string [, charlist])
sin Sine number sin(arg)
sprintf Return a formatted string string sprintf(format, arg1, arg2, ... argN)
sqrt Square root number sqrt(arg)
stddev Calculate the Sample Standard Deviation for the list of numbers number stddev(arg1, arg2, ... argN)
str_pad Pad a string to a certain length with another string string str_pad(input, pad_length [, pad_string])
str_repeat Repeat a string string str_repeat(input, multiplier)
str_replace Replace all occurrences of the search string with the replacement string string str_replace(search, replace, subject)
strcasecmp Binary safe case-insensitive string comparison int strcasecmp(str1, str2)
strcmp Binary safe string comparison int strcmp(str1, str2)
strip_tags Strip HTML and PHP tags from a string string strip_tags(str, allowable_tags)
stripos Find position of first occurrence of a case-insensitive unicode string (starting by 0, return false if not found) int stripos(haystack, needle [, offset=0])
stripslashes Un-quotes a quoted string string stripslashes(string)
stristr Case-insensitive strstr string stristr(haystack, needle [, before_needle=false])
strlen Get string length int strlen(string)
strpos Find position of first occurrence of an unicode string (starting by 0, return false if not found) int strpos(haystack, needle [ offset=0])
strrev Reverse a string string strrev(string)
strstr Find first occurrence of a string string strstr(haystack, needle[, before_needle=false])
strtolower Make a string lowercase string strtolower(string)
strtotime Parse about any English textual datetime description into a Unix timestamp int strtotime(string)
strtoupper Make a string uppercase string strtoupper(string)
substr Return part of an unicode string string substr(string, start [, length])
sum Calculate the sum of values in an array number sum(arg1, arg2, ... argN)
sumifop Sum the values of answered questions in the list which pass the criteria (arg op value) number sumifop(op, value, arg1, arg2, ... argN)
tan Tangent number tan(arg)
time Return current UNIX timestamp number time()
trim Strip whitespace (or other characters) from the beginning and end of a string string trim(string [, charlist])
ucwords Uppercase the first character of each word in a string string ucwords(string)
unique Returns true if all non-empty responses are unique boolean unique(arg1, ..., argN)

Functions that are Planned or Being Considered

Other functions that are planned (or being considered) but which are not implemented yet include the following.  Some of these are for backwards compatability with another survey tool.

Syntax Meaning Comments
e() returns the value of e
formatDate(X,PAT) return the string value of date X formatted according to Java data format pattern PAT
formatNumber(X,PAT) return the string value of number X formatted according to Java number format pattern PAT
getAnsOption(X) Core plugin ExpressionAnswerOptions
getAnsOption(X,Y) Core plugin ExpressionAnswerOptions
getRelevance(X) returns the relevance equation for question X
getStartTime() returns the date corresponding to the system time when the interview was started
getType(X) returns the string name of the datatype - e.g. *NA* if isNA()
gotoFirst() jumps to the first relevant set of questions - this violates the normal flow of the system
gotoNext() jumps to the next set of relevant questions - this violates the normal flow of the system
gotoPrevious() jumps to the previous set of relevant questions - this violates the normal flow of the system
isAsked(X) returns true if the answer is neither *NA*, *INVALID*, nor *UNASKED*
isInvalid(X) returns true if the answer is of type *INVALID*
isNA(X) returns true if the answer is of type *NA*
isNotUnderstood(X) returns true if the answer if of type *HUH*
isRefused(X) returns true if the answer is of type *REFUSED*
isSpecial(X) returns true if the answer is of type *UNASKED*, *NA*, *REFUSED*, *INVALID*, *UNKNOWN*, or *HUH*
isUnknown(X) returns true if the answer is of type *UNKNOWN*
jumpTo(X) jump to the group containing the named question -- this violates the normal flow of the system
jumpToFirstUnasked() jump to the first unasked question thus bypassing previous answered questions this violates the normal flow of the system
lastIndexOf(X,Y) returns the last index (base 0) of string Y in string X. Returns -1 if Y is not contained within X
list(X,...) a string containing a comma separated list of the positive values with "and" separating the last two
mean(X,...) returns the mean of a list of values
numAnsOptions(X) returns the number of answer options that question X has
orlist(X,...) a string containing a comma separated list of the positive values, with "or" separting the last two
parseDate(X,PAT) returns the date value of string X parsed with Java date format pattern PAT
parseNumber(X,PAT) returns the numerical value of string X parsed with Java number format pattern PAT
showAllResponsesExcept( questionList,attributeList,attributeTitleList) questionList = pipe-delimited list of question identifiers; attributeList = pipe-delimited list of attributes (like question#, title, text, type - so you can decide what to show); attributeTitleList = pipe-delimited list of table headers, so can internationalize the report.
showTheseResponses( questionList,attributeList,attributeTitleList) questionList = pipe-delimited list of question identifiers; attributeList = pipe-delimited list of attributes (like question#, title, text, type - so you can decide what to show); attributeTitleList = pipe-delimited list of table headers, so can internationalize the report.

Expression Manager Knows Which Variables are Local

In order to properly build the JavaScript for page, Expression Manager needs to know which variables are set on the page, and what their JavaScript ID is (e.g. for document.getElementById(x)).  It also must know which variables are set on other pages (so that it can ensure that the needed <input type='hidden' value='x'> fields are present and populated).

Cascading Conditions

If any of the variables are irrelevant, the whole equation will be irrelevant (false).  For example, in the following table, N/A means that one of the variables was not relevant

Operator Example a b Result
+ (unary) +a N/A false
! !a N/A false
== (or eq) a == b N/A 5 false
== (or eq) a == b N/A 0 false
== (or eq) a == b N/A N/A false
!= (or ne) a != b N/A 5 false
!= (or ne) a != b N/A N/A false
!= (or ne) a != b N/A 0 false
> (or gt) a > b N/A 5 false
>= (or ge) a >= b N/A 5 false
< (or lt) a < b N/A 5 false
<= (or le) a <= b N/A 5 false
and a and b N/A 5 false
and a and b N/A N/A false
or a or b N/A N/A false
or a or b N/A 5 false
+ a + b N/A 5 false
* a * b N/A 5 false
/ a / b 5 N/A false
() (a) N/A false
(exp) (a && b) N/A 5 false
(exp) op (exp) (b + b) > (a && b) N/A 5 false
function sum(a,b,b) N/A 5 false
function max(a,b) N/A 5 false
function min(a,b) N/A 5 false
function implode(', ',a,b,a,b) N/A 5 false
function if(a,a,b) N/A 5 false
function is_empty(a) N/A false
function is_empty(a) 0 (or blank) true
function !is_empty(a) N/A false

Overriding Cascading Conditions

Say you want to show a running total of all relevant answers.  You might try to use the equation {sum(q1,q2,q3,...,qN)}.  However, this gets translated internally to LEMif(LEManyNA('q1','q2','q3',...,'qN'),,sum(LEMval('q1'),LEMval('q2'),LEMval('q3'),...,LEMval('qN'))).  So, if any of the values q1-qN are irrelevant, the equation will always return false.  In this case, the sum() will show 0 until all questions are answered.

To get around this, each variable can have a ".NAOK" suffix (meaning that Not Applicable is OK) added to it.  In such cases, the following behavior occurs.  Say you have a variable q1.NAOK

  1. q1 is not added to the LEManyNA() clause
  2. LEMval('q1') will  continue to check whether the response is relevant, and will return '' if it is not (so individual irrelevant responses will be ignored, but they will not void the entire expression).

So, the solution to the running total problem is to use the equation sum(q1.NAOK,q2.NAOK,q3.NAOK,...,qN.NAOK).

The use of the .NAOK suffix also lets authors design surveys that have several possible paths but then converge on common paths later.  For example, say subjects answer a survey in a way that is outside the normal range of responses.  The author could alert the subjects that they may not get valid results, and ask them whether they really want to  continue with the survey.  If they say Yes, then the rest of the questions will be shown.  The condition for the "rest of the questions" would check whether the initial responses were answered within the normal range OR whether the subject said Yes to the question that is only relevant if they answered outside the normal range.

How does Expression Manager Support Conditional Micro-Tailoring?

Here is an example of micro-tailoring (where Question Type=='expr' means an Equation):

Question Code Relevance Question Type Question
name 1 text What is your name?
age 1 text How old are you?
badage !is_empty(age) expr {(age<16) or (age>80)}
agestop badage message Sorry, {name}, you are too {if( (age<16),'young',if( (age>80),'old','middle-aged') ) } for this test.
kids !badage yesno Do you have children?
parents 1 expr {!badage && kids=='Y'}
numKids parents text How many children do you have?
kid1 parents && numKids >= 1 text How old is your first child?
kid2 parents && numKids >= 2 text How old is your second child?
kid3 parents && numKids >= 3 text How old is your third child?
kid4 parents && numKids >= 4 text How old is your fourth child?
kid5 parents && numKids >= 5 text How old is your fifth child?
sumage 1 expr {sum(kid1.NAOK,kid2.NAOK,kid3.NAOK,kid4.NAOK,kid5.NAOK)}
report parents yesno {name}, you said you are {age} and that you have {numKids}.  The sum of ages of your first {min(numKids,5)} kids is {sumage}

All of these questions can be on a single page (e.g. in the same group), and only the relevant questions will display.  Moreover, as you enter the ages of children, the sum() expression in the last question will dynamically update on the page.

Expression Manager provides this functionality by surrounding each expression with a named <span> element.  Every time a value changes, it recomputes the expression that should appear in that <span> element and regenerates the display.  You can have dozens, or even hundreds, of such tailored expressions on the same page, and the page will re-display all of them in a single screen refresh.

Mapping of LimeSurvey 1.91+ to Expression Manager Functionality

Old Feature New Feature Comments
Conditions Relevance You can use very complex conditional equations, and access a broader range of variables
Assessments Equation Any assessment scores can be re-structured into an Equation. This both ensures that the score is written to the database, and also lets you see dynamic changes to the score value on the current page
Replacements Expression Manager The core engine takes the input string and treats everything within curly braces as an Expression - so it handles all historical replacements types.  To avoid messing up embedded JavaScript, Expression Manager only processes content between curly braces as long as (a)  there is no leading or trailing whitespace within the curly braces - e.g. {expr} is an expression, but { expr}, {expr }, and { expr } are not expressions.  Furthermore, Expression Manager does not process content within its own strings (e.g. {list('hi','there {braces}')} generates "hi there {braces}").  It also ignores escaped curly braces (e.g. \{this is not an expression\})
Validation Expression Manager The plan is to take the current min/max Question Attributes and have Expression Manager process them.  That way the min/max values can be expressions themselves

Syntax Highlighting

To help with entering and validating expressions, EM provides syntax highlighting with the following features:

Types and Meanings of Syntax Highlighting

Color Sample Meaning Tooltip Comments
tan background Sample the whole equation none Anything within curly braces that is recognized as an equation (e.g. there is no leading or trailing whitepace) will be color-coded with a tan background to help distinguish it from surrounding text
bold red text Sample An error Some explanation on error Can be an unknow variable or an error in function, .... Survey can be totally broken, this don't show to public user.
blue text Sample function name meaning and allowable syntax function names, or things that should be functions since they are followed by an opening parenthesis, are presented in bold blue text. Tooltips show the meaning and allowable syntax for the function.
grey text Sample string none single and double-quoted strings are shown in grey text
cyan text Sample variable set on the same page, [name or SGQA code]: question; value; answerList showing codes for each value Any variable that is set on the same page to the current question is shown in cyan text, showning it can be updated in javascript. The tooltip shows its name (if you used INSERTANS:xxx) or SGQA code (if you used the new naming system), the actual question, and its current value (or blank if not set). If the question type expects responses from an enumerated value set, the mapping of the codes to display values is show.
green text Sample variable set on a prior page [name or SGQA code]: question; value; answerList showing codes for each value Any variable that is set on a prior page is shown in bold green text. The tooltip shows its name (if you used INSERTANS:xxx) or SGQA code (if you used the new naming system), the actual question, and its current value (or blank if not set). If the question type expects responses from an enumerated value set, the mapping of the codes to display values is show.
bold pink text Sample variable set on a later page in general : empty at survey start, but can be filled with index or move previous [name or SGQA code]: question; value; answerList showing codes for each value Any variable that is set on a next page is shown in bold pink text. The tooltip shows its name (if you used INSERTANS:xxx) or SGQA code (if you used the new naming system), the actual question, and its current value (or blank if not set). If the question type expects responses from an enumerated value set, the mapping of the codes to display values is show.
bold tan text Sample a lime replacement value the value Lime Replacement Strings (like {TOKEN:xxx}, {PRIVACY_MESSAGE}) are shown in bold tan text.
red text Sample assignment operator (=) warning message If you use one of the assignment operator (=) that operator will be displayed in red text. This is meant to help prevent accidental re-assignment of values when you really meant to check whether a == b instead of setting the value of a = b.
normal black text Sample punctuation none All other punctuation within the expression is shown as normal black text.
red-boxed text a bold red line surrounds the error syntax error description of the error Any detected syntax errors are shown by surrounding the error with a red box. The tooltip shows the error. Examples include unmatched parentheses, use of undefined functions, passing the wrong number of arguments to functions, poorly structured expressions (e.g. missing operators between variables), trying to assign a new value to a read-only variable, trying to assign values to non-variables, or using unsupported syntax. Note that the syntax error dectection system may only report one error in an expression even if there are multiple errors; however, if any errors are detected, at least one error will be shown.

Additional Reading

Expression Manager sample surveys

Use Cases and HowTos

Step-by-Step examples

Reference for Developers

RoadMap/Status/ToDo List