Actions

ExpressionScript examples/it: Difference between revisions

From LimeSurvey Manual

(Created page with "Per emettere il testo della sottodomanda, è necessario aggiungere l'ID della scala al segnaposto (sebbene i testi siano gli stessi per entrambe le scale). Quindi invece di {q...")
(Created page with "'''Dettagli di implementazione:''' * per il primo array: array a scelta singola ** Il codice della domanda è ARRAY ** Il codice della sottodomanda è SQ01,SQ02,SQ03 e SQ04 *...")
 
(27 intermediate revisions by the same user not shown)
Line 297: Line 297:
Per emettere il testo della sottodomanda, è necessario aggiungere l'ID della scala al segnaposto (sebbene i testi siano gli stessi per entrambe le scale). Quindi invece di {q4_SQ001.question} dobbiamo usare {q4_SQ001_0.question} o {q4_SQ001_1.question}.
Per emettere il testo della sottodomanda, è necessario aggiungere l'ID della scala al segnaposto (sebbene i testi siano gli stessi per entrambe le scale). Quindi invece di {q4_SQ001.question} dobbiamo usare {q4_SQ001_0.question} o {q4_SQ001_1.question}.


If you want to export/display the results of subquestions with at least one answer only, use this syntax for each subquestion:
Se vuoi esportare/visualizzare i risultati delle sottodomande con almeno una sola risposta, usa questa sintassi per ogni sottodomanda:


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


===Question with X and Y scales===
===Domanda con scale X e Y===




This applies to all matrix questions which allow an answer for every cell (not just every row as shown previously):
Questo vale per tutte le domande sulla matrice che consentono una risposta per ogni cella (non solo per ogni riga come mostrato in precedenza):
*Array Texts
*Testi matrice
*Array Numbers
*Numeri matrice




Assumed codes used:
Codici ipotizzati utilizzati:
*Question code: q5
*Codice domanda: q5
*Subquestion codes: SQ001, SQ002, ...
*Codici sottodomanda: SQ001, SQ002, ...
*Answer codes: A1, A2, ...
*Codici risposta: A1, A2, ...


To refer to the result of a certain subquestion from a certain column, you need to use QuestionCode . '_' . SubQuestionCode . '_' . AnswerCode. Example for referring to the answer of the third subquestion and second column: q5_SQ003_A2.
Per fare riferimento al risultato di una determinata sottodomanda da una determinata colonna, è necessario utilizzare QuestionCode . '_'. SubQuestionCode . '_'. RispostaCodice. Esempio di riferimento alla risposta della terza sottodomanda e della seconda colonna: q5_SQ003_A2.


Let's output the results for columns 1-3 of the first two subquestions:
Produciamo i risultati per le colonne 1-3 delle prime due domande secondarie:


- {q5_SQ001_A1.question}: {q5_SQ001_A1.shown} | {q5_SQ001_A2.shown} | {q5_SQ001_A3.shown}
- {q5_SQ001_A1.domanda}: {q5_SQ001_A1.mostrato} | {q5_SQ001_A2.mostrato} | {q5_SQ001_A3.mostrato}


- {q5_SQ002_A1.question}: {q5_SQ002_A1.shown} | {q5_SQ002_A2.shown} | {q5_SQ002_A3.shown}
- {q5_SQ002_A1.domanda}: {q5_SQ002_A1.mostrato} | {q5_SQ002_A2.mostrato} | {q5_SQ002_A3.mostrato}




Since for these question types each cell (combination of X axes and Y axes) equals one answer option, a test for existing data needs to be done for each cell. Example:
Poiché per questi tipi di domande ogni cella (combinazione di assi X e assi Y) equivale a un'opzione di risposta, è necessario eseguire un test per i dati esistenti per ogni cella. Esempio:


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




{{Note|To output the subquestion text you need to add the answer code to the placeholder (though the texts are the same for all answer options). So instead of {q5_SQ001.question} we have to use {q5_SQ001_A1.question} or {q5_SQ001_A2.question}.}}
{{Nota|Per emettere il testo della sottodomanda è necessario aggiungere il codice di risposta al segnaposto (sebbene i testi siano gli stessi per tutte le opzioni di risposta). Quindi invece di {q5_SQ001.question} dobbiamo usare {q5_SQ001_A1.question} o {q5_SQ001_A2.question}.}}


==Hide question if answer from previous question is empty==
==Nascondi la domanda se la risposta della domanda precedente è vuota==




{|class="wikitable"
{|class="wikitable"
|Purpose||Hide question if answer from previous question is empty
|Scopo||Nascondi la domanda se la risposta della domanda precedente è vuota
|-
|-
|Type||Question Relevance
|Tipo||Rilevanza della domanda
|-
|-
|Example||Question one: question code "name", question text "What's your name?" <br /> Question two: question text "{name}, how old are you?" <br /> To do: Hide question two if the textfield of question one is empty
|Esempio||Domanda uno: codice domanda "nome", testo domanda "Come ti chiami?"<br /> Domanda due: testo della domanda "{name}, quanti anni hai?"<br /> Da fare: nascondere la domanda due se il campo di testo della domanda uno è vuoto
|-
|-
|Expression||!is_empty(name)
|Expression||!is_empty(name)
|-
|-
|Description||is_empty() determines whether a variable is considered to be empty. The "!" negates the result. So if the variable is not empty the Expression will be true and the question is shown
|Description||is_empty() determina se una variabile è considerato vuoto. IL "!" nega il risultato. Quindi se la variabile non è vuota l'Espressione sarà vera e la domanda sarà mostrata
|-
|-
|Steps||Create/edit question two <br /> Insert "!is_empty(name)" into "Relevance equation:"
|Passaggi||Crea/modifica domanda due<br /> Inserisci "!is_empty(nome)" in "Equazione di rilevanza:"
|-
|-
|Sample File||[[Media:Hide_question_if_empty_question_group.zip|Hide_question_if_empty_question_group.zip]]
|File di esempio||[[Media:Hide_question_if_empty_question_group.zip|Hide_question_if_empty_question_group.zip]]
|-
|-
|colspan="2" align="center"|[[File:Hide question if empty 1.png]][[File:Hide question if empty 2.png]]
|colspan ="2" align="center"|[[File:Nascondi domanda se vuoto 1.png]][[File:Nascondi domanda se vuoto 2.png]]
|}
|}




==Hide question group if answer from previous question is Yes or No==
==Nascondi il gruppo di domande se la risposta della domanda precedente è Sì o No==




{|class="wikitable"
{|class="wikitable"
|Purpose||Hide question group if answer from previous question is Yes or No
|Scopo||Nascondi il gruppo di domande se la risposta alla domanda precedente è Sì o No
|-
|-
|Type||Question group Relevance
|Tipo||Gruppo di domande Rilevanza
|-
|-
|Example||Page one, Question Group one, Question one: question code "PET", question text "Do you have a pet?" -Yes -No <br /> Page two, Question Group two: Title "About your pet(s)" <br /> To do: Show/Hide question group two if answer from question one is Yes/No
| Esempio||Pagina uno, Gruppo di domande uno, Domanda uno: codice domanda "ANIMALE DOMESTICO", testo domanda "Hai un animale domestico?" -Si No<br /> Pagina due, Gruppo di domande due: Titolo "Informazioni sui tuoi animali domestici"<br /> Da fare: mostra/nascondi il gruppo di domande due se la risposta alla domanda uno è Sì/No
|-
|-
|Expression||PET == "Y"
|Espressione||ANIMALE DOMESTICO == "S"
|-
|-
|Description||PET is the question code for the question you want to check the answer. If you don't use a suffix EM will use "Qcode.code". So you compare the answer code from the PET question to the value "Y". If the participant answers "Yes" the Expression is true and the question group "About your pet(s)" will be shown.
|Descrizione||ANIMALE DOMESTICO è il codice della domanda per la domanda di cui vuoi controllare la risposta. Se non si utilizza un suffisso, EM utilizzerà "Qcode.code". Quindi confronti il codice di risposta della domanda PET con il valore "Y". Se il partecipante risponde "Sì", l'espressione è vera e verrà visualizzato il gruppo di domande "Informazioni sui tuoi animali domestici".
|-
|-
|Steps||Create/edit question group two <br /> Insert "PET == "Y"" into "Relevance equation:"
|Passi||Crea/modifica gruppo di domande due<br /> Inserisci "PET == "Y"" in "Equazione di rilevanza:"
|-
|-
|Sample File||[[Media:Hide question group if answer from previous question is Yes or No.zip|Hide_question group_if_answer_from_previous_question_is_Yes_or_No.zip]]
|File di esempio||[[Media:Nascondi gruppo di domande se la risposta della domanda precedente è Sì o No.zip|Nascondi_gruppo_domanda_se_risposta_da_domanda_precedente_è_Sì_o_No. zip]]
|-
|-
|colspan="2" align="center"|[[File:Hide question group if answer from previous question is Yes or No 1.png]][[File:Hide question group if answer from previous question is Yes or No 2.png]]
|colspan="2" align="center"|[[File:Nascondi gruppo di domande se la risposta della domanda precedente è Sì o No 1.png]][[File:Nascondi domanda gruppo se la risposta alla domanda precedente è Sì o No 2.png]]
|}
|}




==Display value of a multiple answer input question field==
==Visualizza il valore di un campo di domanda di input a risposta multipla==




{|class="wikitable"
{|class="wikitable"
|Purpose||Display value of a multiple answer input question field
|Scopo||Visualizza il valore di un campo di domanda di input a risposta multipla
|-
|-
|Type||Reference
|Tipo||Riferimento
|-
|-
|Example||Question one: question code "AskChildAge", question text "How old are your children?". Subquestions codes -Child1 -Child2 -Child3 - ChildXXX <br /> Question two: question code "ReportChildAge" question text "About your first child: - CHILD1 is AGE1."
|Esempio||Domanda uno : codice domanda "AskChildAge", testo domanda "Quanti anni hanno i tuoi figli?". Codici delle sottodomande -Child1 -Child2 -Child3 - ChildXXX<br /> Domanda due: codice della domanda "ReportChildAge" testo della domanda "Informazioni sul tuo primo figlio: - CHILD1 ha 1 ANNI."
|-
|-
|Expression||{AskChildAge_Child1.question}, {AskChildAge_Child1.value}
|Expression||{AskChildAge_Child1.question}, {AskChildAge_Child1.value}
|-
|Descrizione||Si desidera utilizzare il valore di una sottodomanda in una domanda successiva. Puoi accedere al valore della sottodomanda con questo tipo di espressione: QcodeQuestion_QcodeSubquestion.value
|-
|-
|Description||You want to use the value of a subquestion in a following question. You can access the subquestion value with this kind of expression: QcodeQuestion_QcodeSubquestion.value
|Steps||Crea/modifica la seconda domanda<br /> Inserisci questo testo nella descrizione: "Informazioni sul tuo primo figlio: - {AskChildAge_Child1.question} è {AskChildAge_Child1.value}."
|-
|-
|Steps||Create/edit the second question <br /> Insert this text in the description: "About your first child: - {AskChildAge_Child1.question} is {AskChildAge_Child1.value}."
|File di esempio||[[Media:Display_value_of_a_multiple_answer_input_question_field.zip|Display_value_of_a_multiple_answer_input_question_field. zip]]
|-
|Sample File||[[Media:Display_value_of_a_multiple_answer_input_question_field.zip|Display_value_of_a_multiple_answer_input_question_field.zip]]
|-
|-
|colspan="2" align="center"|[[File:Display value of a multiple answer input question field 1.png]]
|colspan="2" align="center"|[[File:Display value of a multiple answer input question field 1.png]]
|}
|}


==Validate number of boxes ticked per row for an "Array (Numbers) Checkbox" question==
==Convalida il numero di caselle spuntate per riga per una domanda "Casella di controllo matrice (numeri)"==




{|class="wikitable"
{|class="wikitable"
|Purpose||Validate number of boxes ticked per row
|Scopo||Convalidare il numero di caselle spuntate per riga
|-
|-
|Type||Validation
|Tipo||Convalida
|-
|-
|Example||Question of type "Array Numbers (Checkbox Layout)"
|Esempio||Domanda di tipo " Numeri matrice (layout casella di controllo)"
|-
|-
|Expression||sum(...)
|Espressione||sum(...)
|-
|-
|Description||(sum(Test_A_1, Test_A_2, Test_A_3, Test_A_4, Test_A_5) <= X) determines whether at least X checkboxes in row A are checked. <br />If you want to check all three rows (A, B, C), you can connect the expression using "&&": <br />(sum(Test_A_1, Test_A_2, Test_A_3, Test_A_4, Test_A_5) <= X) <br />&& (sum(Test_B_1, Test_B_2, Test_B_3, Test_B_4, Test_B_5) <= X) <br />&& (sum(Test_C_1, Test_C_2, Test_C_3, Test_C_4, Test_C_5) <= X)
|Descrizione||(sum(Test_A_1, Test_A_2, Test_A_3, Test_A_4, Test_A_5) <= X) determina se almeno X caselle di controllo nella riga A sono selezionate.<br /> Se vuoi controllare tutte e tre le righe (A, B, C), puoi collegare l'espressione usando "&&":<br /> (sum(Test_A_1, Test_A_2, Test_A_3, Test_A_4, Test_A_5) <= X)<br /> && (somma(Test_B_1, Test_B_2, Test_B_3, Test_B_4, Test_B_5) <= X)<br /> && (sum(Test_C_1, Test_C_2, Test_C_3, Test_C_4, Test_C_5) <= X)
|-
|-
|Steps||Create/edit question of type "Array Numbers (Checkbox Layout)".<br /> Insert the above expression into "Question validation equation" at the advanced question settings (you might have to adjust variable namings!).
|Steps||Crea/modifica domanda di tipo "Numeri matrice (layout casella di controllo)".<br /> Inserisci l'espressione precedente in "Equazione di convalida della domanda" nelle impostazioni avanzate della domanda (potresti dover modificare i nomi delle variabili!)
|-
|-
|Sample File||[[Media:limesurvey_survey_53654.lss|Validate number of boxes ticker per row for an Array (Numbers) Checkbox.lss]]
|File di esempio||[[Media:limesurvey_survey_53654.lss|Convalida numero di ticker di caselle per riga per un Array (Numbers) Checkbox.lss]]
|-
|-
|colspan="2" align="center"|[[File:Validate number of boxes ticker per row for an Array (Numbers) Checkbox 05.png]][[File:Validate number of boxes ticker per row for an Array (Numbers) Checkbox 1.png]]
|colspan="2" align="center"|[[File:Convalida il numero di ticker di caselle per riga per un Array ( Numbers) Casella di controllo 05.png]][[File: Convalida il numero di caselle ticker per riga per una casella di controllo Array (Numbers) 1.png]]
|}
|}


==Calculate difference between two dates==
==Calcola la differenza tra due date==




{| class="wikitable"
{| class="wikitable"
|Purpose||Calculate difference between two dates
|Scopo||Calcola la differenza tra due date
|-
|-
|Type||Relevance / Equation question type / Validation
|Tipo||Rilevanza / Equazione tipo di domanda / Convalida
|-
|-
|Example||Question one (date/time, code: DOB): What is your date of birth? <br /> Question two (date/time, code: datetoday): What is the date today? <br /> Question three (boilerplate): You are XXXX days old. <br /> To do: Calculate and display the number of days between the date given in question 1 and the question 2.
|Esempio||Domanda uno (data/ora, codice: DOB): Qual è la tua data di nascita?<br /> Domanda due (data/ora, codice: datetoday): qual è la data di oggi?<br /> Domanda tre (piatto): hai XXXX giorni.<br /> Da fare: calcola e visualizza il numero di giorni tra la data indicata nella domanda 1 e la domanda 2.
|-
|-
|Expression||{(strtotime(datetoday)-strtotime(DOB))/60/60/24}<br>
|Expression||{(strtotime(datetoday)-strtotime(DOB))/60/60 /24}<br>  
|-
|-
|Description|| strtotime calculates the number of seconds between the 1st of January 1970 and the given date. The above expression calculates the number of seconds between the two given dates. The term "/60/60/24" just calculates the number of days from the number of seconds. <br /> Instead of asking for the "datetoday", you can also use strtotime('now') or simply time(), which directly returns the number of seconds from January 1970 until now (i.e. the time the survey was taken). Thus you could quickly figure out the age of a person in years with  the equation {(time() - strtotime(DOB)) / 60 / 60 / 24 / 365.25} In any of these cases, it is critical that the date is entered in a proper format, otherwise the strtotime() function will not work right.
|Descrizione|| strtotime calcola il numero di secondi tra il 1 gennaio 1970 e la data specificata. L'espressione precedente calcola il numero di secondi tra le due date specificate. Il termine "/60/60/24" calcola semplicemente il numero di giorni dal numero di secondi.<br /> Invece di chiedere "datetoday", puoi anche usare strtotime('now') o semplicemente time(), che restituisce direttamente il numero di secondi dal gennaio 1970 ad oggi (cioè l'ora in cui è stato effettuato il sondaggio). Quindi puoi calcolare rapidamente l'età di una persona in anni con l'equazione {(time() - strtotime(DOB)) / 60 / 60 / 24 / 365.25} In ognuno di questi casi, è fondamentale inserire la data in un formato appropriato, altrimenti la funzione strtotime() non funzionerà correttamente.  
|-
|-
|Steps||Create two date questions (for the date of birth and for today's date) and a boilerplate question. <br /> In the question text of the boilerplate question insert: "On {datetoday} you were {(strtotime(today)-strtotime(dob))/60/60/24} days days old." <br /><br /> Please note: The function strtotime can work with MANY but not all date formats. If you run into problems set your survey's date format to mm/dd/yyyy or yyyy-mm-dd or dd.mm.yyyy"
|Passaggi||Crea due domande sulla data (per la data di nascita e per la data odierna) e una domanda standard.<br /> Nel testo della domanda della domanda standard inserire: "Il {datetoday} avevi {(strtotime(today)-strtotime(dob))/60/60/24} giorni giorni."<br /><br /> Nota: la funzione strtotime può funzionare con MOLTI ma non con tutti i formati di data. In caso di problemi, imposta il formato della data del sondaggio su mm/gg/aaaa o aaaa-mm-gg o gg.mm.aaaa"
|-
|-
|Sample File||[[Media:TestSurvey_Working_with_Dates.zip|Date_difference.zip]]
|File di esempio||[[Media:TestSurvey_Working_with_Dates.zip| Date_difference.zip]]
|-
|-
|colspan="2" align="center"|[[File:Date_difference_example.png]]
|colspan="2" align="center"|[[File:Date_difference_example.png]]
|}
|}


==Using ExpressionScript for Assessments==
==Utilizzo di ExpressionScript per le valutazioni==




Here comes another example on how to use the ExpressionScript with [[Question type - Array|Array type questions]] and assessments:</ br>
Ecco un altro esempio su come utilizzare ExpressionScript con [[Tipo di domanda - Array|Domande di tipo Array]] e valutazioni:</ br>


Let's say you have 2 array questions and you want to save the results of the calculation data to your database. It is actually simple, you will need to create and test your arrays and submit a dummy response to see if it works and gives you the results in the completed page.
Supponiamo che tu abbia 2 domande sull'array e desideri salvare i risultati dei dati di calcolo nel tuo database. In realtà è semplice, dovrai creare e testare i tuoi array e inviare una risposta fittizia per vedere se funziona e ti dà i risultati nella pagina completata.




'''Implementation details:'''
'''Dettagli di implementazione:'''
*add a question of type equation
*aggiungi una domanda di tipo equazione
*add the following line assuming that Q1 is your array question code while Q2 is the second one:
*aggiungi la seguente riga supponendo che Q1 sia il codice della domanda dell'array mentre Q2 sia il secondo:
** <pre>{sum(Q1_SQ001.value,Q2_SQ001.value)}</pre>
**<pre> {sum(Q1_SQ001.value,Q2_SQ001.value)}</pre>


Note that SQ001 is the default code for any subquestion. If you change the subquestion code, adjust the equation above accordingly.
Si noti che SQ001 è il codice predefinito per qualsiasi domanda secondaria. Se modifichi il codice della sottodomanda, modifica l'equazione sopra di conseguenza.




==Using em_validation_q in array==
==Utilizzando em_validation_q nell'array==




You can use the [[QS:Em_validation_q|question validation equation]] to control an array with any condition.
È possibile utilizzare l'[[QS:Em_validation_q|equazione di convalida della domanda]] per controllare un array con qualsiasi condizione.




'''Implementation details:'''
'''Dettagli di implementazione:'''
* for the first array : array of single choice
* per il primo array: array a scelta singola
** Question code is ARRAY
** Il codice della domanda è ARRAY
** Sub question code are SQ01,SQ02,SQ03 and SQ04
** Il codice della sottodomanda è SQ01,SQ02,SQ03 e SQ04
** update the Whole question validation equation and put <pre>!is_empty(ARRAY_SQ01) and !is_empty(ARRAY_SQ03) </pre>
** aggiorna l'equazione di convalida dell'intera domanda e metti<pre> !is_empty(ARRAY_SQ01) e !is_empty(ARRAY_SQ03)</pre>  
* for the second array : array of text
* per il secondo array: array di testo
** Question code is ARRAYTEXT
** Il codice della domanda è ARRAYTEXT
** Sub question at Y axis code are SY01,SY02,SY03, and SY04
** La sottodomanda al codice dell'asse Y è SY01, SY02, SY03 e SY04
** Update the Whole question validation equation and put <pre>count(self.sq_SY01 >= 1) and count(self.sq_SY03 >= 3)</pre>
** Aggiorna l'intera domanda equazione di validazione e put<pre> count(self.sq_SY01 >= 1) e count(self.sq_SY03 >= 3)</pre>

Latest revision as of 08:21, 26 July 2023

Other languages:

Template:Nota


Struttura

La prima parte dell'articolo descriverà per cosa possono essere utilizzate le espressioni e dove trovare/aggiungere un'espressione. La seconda parte fornisce esempi su come utilizzare Expression.


Categorie di espressioni

LimeSurvey utilizza le espressioni per i seguenti scopi:


Pertinenza

Scopo: Nascondere gruppi di domande/domande

La pertinenza controlla se un gruppo di domande o una domanda viene mostrato o nascosto. Se il risultato dell'Espressione è "vero" (cioè 1), l'elemento verrà mostrato. Altrimenti (se il risultato dell'Espressione è "falso" (cioè 0)), l'elemento sarà nascosto.

Digita Mostra/nascondi Dove trovarlo Screenshot
Gruppo di domande Rilevanza Gruppo di domande Crea/Modifica gruppo di domande -> "Equazione di rilevanza:" File:Equazione di rilevanza del gruppo screenshot.png
Rilevanza della domanda domanda Crea/Modifica domanda -> "Equazione di rilevanza:" File:Schermata equazione rilevanza domanda.png
Pertinenza sottodomanda domanda secondaria Modifica domande secondarie -> "Equazione rilevanza:" File:Schermata equazione rilevanza sottodomanda. png


Convalida

Scopo: convalida input/azioni su domande/sottodomande/risposte

La convalida controlla se l'input del rispondente in una domanda o in un'azione è valido o meno. Se il risultato dell'espressione è "true" (cioè 1), la classe "good" verrà applicata all'elemento e al messaggio di validazione. Altrimenti, se il risultato dell'espressione è "false" (cioè 0)), la classe "error" verrà applicata all'elemento e al messaggio di validazione. Puoi dichiarare uno stile per queste classi nel template.css.

Digita Convalida Dove trovarlo Screenshot
Convalida domanda domanda Crea/Modifica domanda -> "Scheda Logica" - > "Equazione convalida domanda" File:Equazione convalida domanda.png
Convalida sottodomanda sottodomande Crea/Modifica domanda -> "Scheda Logica" -> " Equazione di convalida della sottodomanda" File:Schermata di convalida della sottodomanda.png ‎

Emissione di testo

Scopo: (fare qualcosa) e scrivere del testo

Un'espressione può essere utilizzata per scrivere del testo. Ad esempio, puoi testare o calcolare qualcosa e specificare l'output in base al risultato del test o del calcolo. Può anche essere utilizzato per inserire il testo della domanda, le risposte, i tipi di domanda, ... di una domanda utilizzata prima dell'utilizzo dell'Espressione. L'output di testo può essere utilizzato ovunque venga visualizzato un testo e può restituire qualsiasi tipo di risultato.

Caso d'uso Descrizione
Micro sartoria Regola un testo, ad esempio, scrivi "Mr" o "Mrs" a seconda di una domanda di genere posta in precedenza
Calcolo Calcola un valore e scrivilo, ad es. "Il tuo reddito familiare è xxx"
Riferimento Inserisci un testo da un elemento, ad es. "Ti chiami xxx. Quanti anni hai?"


Memorizzazione risposte

Scopi: (Fare qualcosa,) (scrivere del testo) e memorizzare qualcosa nel database

Il tipo di domanda Equazione può essere utilizzato per memorizzare qualcosa nel database. Puoi fare qualcosa con un'Espressione, mostrare la domanda Equazione (che è simile a una visualizzazione testo) e memorizzare il risultato dell'Espressione nel database. Memorizza la risposta nella tabella delle risposte. Quindi, il risultato può essere utilizzato all'interno della funzione statistica o può anche essere importato in uno dei formati forniti dalla funzionalità di esportazione di LimeSurvey.

Esempi per espressioni

Inserisci una risposta da una domanda precedente

Scopo Inserisci una risposta da una domanda precedente
Tipo Riferimento
Esempio Domanda uno (codice domanda " Q00"): In quale città vivi?
Domanda due (codice domanda "Q01") Da quanto tempo vivi a CITY?
Da fare: la risposta della prima domanda dovrebbe essere usata al posto di "CITTÀ" della seconda domanda.
Espressione {QOO}
Descrizione La risposta fornita in Q00 sostituisce il campo Q00 della seconda domanda
Passaggi Crea/Modifica domanda due
Inserisci "Quanto tempo hai vissuto in {QOO} (anni)?" nel campo di testo della domanda

Utilizzo della domanda di equazione nascosta per compilare automaticamente una risposta

Problema: Immagina di avere due domande Q1 e Q2. Q1 chiede agli intervistati la loro età. Q2 divide gli intervistati in tre gruppi: l'età è inferiore a 20 anni, l'età è 20 anni, l'età è maggiore di 20. Quindi, Q2 dovrebbe utilizzare i valori "1", "2", "3", che corrispondono a le condizioni di cui sopra. Inoltre, non dobbiamo dimenticare di rendere invisibile Q2 (la domanda non verrà visualizzata nel sondaggio, ma i valori verranno visualizzati tramite il "processo in background" all'interno della tabella delle risposte).

Per compilare il database utilizzando la domanda Equazione, digitare:

  • Innanzitutto, creare una domanda con il codice Q1 come domanda di input numerico.
  • Quindi creare un'altra domanda con il codice Q2 come domanda sull'equazione .
  • Nel capitolo "Impostazioni di visualizzazione" di Q2:
    • imposta il campo "Nascondi sempre questa domanda" come "On"
    • digita nel campo "Equazione" l'espressione:
 {if(Q1.NAOK < 20, "1", if(Q1.NAOK > 20, "3", "2"))}

Crea una pagina di riepilogo utilizzando i segnaposto

Questo tutorial mostra come creare una panoramica alla fine del sondaggio, elencando tutte le domande e le risposte tramite segnaposto ExpressionScript. Mostra anche come limitare tale panoramica solo alle domande con risposta.

Il nostro esempio può essere scaricato da qui: Esempio di sondaggio segnaposto sondaggio.


Tipi di domanda utilizzati qui:

1. Domande a scelta singola / domande testuali/numeriche

  • Lista (dropdown)
  • Lista (radio) [L]
  • Si/No [S]
  • Testo libero lungo [T ]
  • Testo libero breve [S]
  • Immissione numerica [N]
  • Equazione [*]


2. Domanda con sottodomande

  • Testo breve multiplo [Q]
  • Scelta multipla [M]
  • Array [F]
  • Array (Sì/No/Incerto) [C]!N !*Array (10 punti a scelta) [B]


3. Domande con 2 scale

  • Array doppia scala [1]


4. Domande con scale X e Y

  • Array (Numbers) [:]


5. Maschera domande

  • Visualizzazione testo [X]


In questo semplice esempio, la nostra panoramica sarà un semplice elenco con:

- Testo della domanda: Risposta dell'utente


Domande a scelta singola/domande a testo singolo/numeriche

Per tutti questi tipi di domande, Limesurvey memorizzerà un'unica risposta:

  • Lista (dropdown)
  • Lista (radio)
  • Lista con commento
  • Scelta 5 punti
  • Si/No
  • Testo libero breve
  • Testo libero lungo!N !*Enorme testo libero
  • Immissione numerica
  • Equazione
  • Data
  • Sesso

Supponendo che il codice della domanda della domanda sia q1, possiamo fare riferimento al testo della domanda e alla risposta usando:

- {q1.domanda}: {q1.mostrato}

Esempio:

- Quanti anni hai?: 25


Se vuoi verificare se a questa domanda è stata data una risposta, puoi inserire un'istruzione IF attorno al tuo output: 

{if(!è_vuoto(q1),join("- ",q1.domanda,": ",q1.mostrato),"")}

Questo "si traduce" in: SE la domanda con il codice q1 non è vuota, restituisce "- " E il testo della domanda E ": " E il testo della risposta (la funzione join() unisce gli elementi come una nuova stringa; ALTRIMENTI: restituisce niente (" " significa stringa vuota).

Domanda con sottodomande

Per tutti questi tipi di domande LimeSurvey utilizza sottodomande:

  • Testo breve multiplo
  • Scelta multipla
  • Scelta multipla con commenti
  • Array
  • Array (scelta 5 punti)
  • Array (scelta 10 punti)
  • Array (Sì /No/Incerto)
  • Matrice (Incremento/Uguale/Diminuzione)
  • Matrice per colonna

Supponendo che il codice della domanda sia q2 e le domande secondarie siano numerate SQ001, SQ002 (numerazione automatica effettuata da LimeSurvey), possiamo fare riferimento al testo della domanda e alla risposta utilizzando:

- {q2_SQ001.domanda}: {q2_SQ001.mostrato}

- {q2_SQ002.domanda}: {q2_SQ002.mostrato}

Per le domande a scelta multipla ha senso ora mostrare il testo della sottodomanda spuntata ma mostrare una Y per ogni opzione selezionata:

- {q2_SQ001.domanda}: {q2_SQ001}

- {q2_SQ002.domanda}: {q2_SQ002}

...

Si noti che al momento non è possibile visualizzare il testo delle domande con domande secondarie, vedere richiesta di questa funzione.


Esempio 1 (supponendo che il tipo di domanda sia a scelta multipla)

- Conosci queste marche di auto?

--Mercedes: Y

--Audi: n

--Volvo: Y


Se si desidera emettere solo gli elementi selezionati, è possibile inserire un'istruzione IF attorno all'output e verificare il valore della casella di controllo: 

{ if( q2_SQ001=="Y", join( "- ", q2_SQ001.domanda, ": ", q2_SQ001.mostrato ), "" ) }


Utilizzare la funzione listifop se si desidera generare un elenco dei soli elementi selezionati, ad esempio: Mercedes, Volvo 

{ listifop( 'value', '==', 'Y', 'question', ', ', that.q2.sgqa ) }


Dove that.q2 si espande a tutte le sottodomande di q2. Vedere self, this and that per maggiori dettagli.


Esempio 2 (supponendo che il tipo di domanda sia Array (scelta di 10 punti))

- Si prega di valutare la qualità delle marche automobilistiche di seguito su una scala da 1=pessima a 10=molto buona?

--Mercedes: 7

-- Audi: 9

-- Volvo: 9


Se si desidera produrre solo elementi valutati, è possibile inserire un'istruzione IF attorno all'output e verificare se la domanda secondaria corrente ha ricevuto risposta utilizzando: 

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


Utilizzare la funzione listifop se, ad esempio, si desidera produrre solo un elenco degli elementi selezionati maggiore di otto, ad esempio: Audi / Volvo 

{ listifop( 'value', '>', 8, 'question', ' / ', that.q3.sgqa ) }


Domanda con due scale

Template:Nota


Supponiamo di utilizzare i seguenti codici:

  • Codice domanda: q4
  • Codici sottodomanda: SQ001, SQ002, ...
  • Codici risposta scala 1: A1, A2, ...!N !*Codici di risposta scala 2: B1, B2, ...


Template:Nota


Produciamo i risultati per entrambe le scale e le prime due domande secondarie:

- {q4_SQ001_0.domanda}: {q4_SQ001_0.mostrato} / {q4_SQ001_1.mostrato}

- {q4_SQ002_0.domanda}: {q4_SQ002_0.mostrato} / {q4_SQ002_1.mostrato}

Per emettere il testo della sottodomanda, è necessario aggiungere l'ID della scala al segnaposto (sebbene i testi siano gli stessi per entrambe le scale). Quindi invece di {q4_SQ001.question} dobbiamo usare {q4_SQ001_0.question} o {q4_SQ001_1.question}.

Se vuoi esportare/visualizzare i risultati delle sottodomande con almeno una sola risposta, usa questa sintassi per ogni sottodomanda: 

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

Domanda con scale X e Y

Questo vale per tutte le domande sulla matrice che consentono una risposta per ogni cella (non solo per ogni riga come mostrato in precedenza):

  • Testi matrice
  • Numeri matrice


Codici ipotizzati utilizzati:

  • Codice domanda: q5
  • Codici sottodomanda: SQ001, SQ002, ...
  • Codici risposta: A1, A2, ...

Per fare riferimento al risultato di una determinata sottodomanda da una determinata colonna, è necessario utilizzare QuestionCode . '_'. SubQuestionCode . '_'. RispostaCodice. Esempio di riferimento alla risposta della terza sottodomanda e della seconda colonna: q5_SQ003_A2.

Produciamo i risultati per le colonne 1-3 delle prime due domande secondarie:

- {q5_SQ001_A1.domanda}: {q5_SQ001_A1.mostrato} | {q5_SQ001_A2.mostrato} | {q5_SQ001_A3.mostrato}

- {q5_SQ002_A1.domanda}: {q5_SQ002_A1.mostrato} | {q5_SQ002_A2.mostrato} | {q5_SQ002_A3.mostrato}


Poiché per questi tipi di domande ogni cella (combinazione di assi X e assi Y) equivale a un'opzione di risposta, è necessario eseguire un test per i dati esistenti per ogni cella. Esempio: 

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


Template:Nota

Nascondi la domanda se la risposta della domanda precedente è vuota

Scopo Nascondi la domanda se la risposta della domanda precedente è vuota
Tipo Rilevanza della domanda
Esempio Domanda uno: codice domanda "nome", testo domanda "Come ti chiami?"
Domanda due: testo della domanda "{name}, quanti anni hai?"
Da fare: nascondere la domanda due se il campo di testo della domanda uno è vuoto
Expression !is_empty(name)
Description is_empty() determina se una variabile è considerato vuoto. IL "!" nega il risultato. Quindi se la variabile non è vuota l'Espressione sarà vera e la domanda sarà mostrata
Passaggi Crea/modifica domanda due
Inserisci "!is_empty(nome)" in "Equazione di rilevanza:"
File di esempio Hide_question_if_empty_question_group.zip
File:Nascondi domanda se vuoto 1.pngFile:Nascondi domanda se vuoto 2.png


Nascondi il gruppo di domande se la risposta della domanda precedente è Sì o No

Scopo Nascondi il gruppo di domande se la risposta alla domanda precedente è Sì o No
Tipo Gruppo di domande Rilevanza
Esempio Pagina uno, Gruppo di domande uno, Domanda uno: codice domanda "ANIMALE DOMESTICO", testo domanda "Hai un animale domestico?" -Si No
Pagina due, Gruppo di domande due: Titolo "Informazioni sui tuoi animali domestici"
Da fare: mostra/nascondi il gruppo di domande due se la risposta alla domanda uno è Sì/No
Espressione ANIMALE DOMESTICO == "S"
Descrizione ANIMALE DOMESTICO è il codice della domanda per la domanda di cui vuoi controllare la risposta. Se non si utilizza un suffisso, EM utilizzerà "Qcode.code". Quindi confronti il codice di risposta della domanda PET con il valore "Y". Se il partecipante risponde "Sì", l'espressione è vera e verrà visualizzato il gruppo di domande "Informazioni sui tuoi animali domestici".
Passi Crea/modifica gruppo di domande due
Inserisci "PET == "Y"" in "Equazione di rilevanza:"
File di esempio Nascondi_gruppo_domanda_se_risposta_da_domanda_precedente_è_Sì_o_No. zip
File:Nascondi gruppo di domande se la risposta della domanda precedente è Sì o No 1.pngFile:Nascondi domanda gruppo se la risposta alla domanda precedente è Sì o No 2.png


Visualizza il valore di un campo di domanda di input a risposta multipla

Scopo Visualizza il valore di un campo di domanda di input a risposta multipla
Tipo Riferimento
Esempio Domanda uno : codice domanda "AskChildAge", testo domanda "Quanti anni hanno i tuoi figli?". Codici delle sottodomande -Child1 -Child2 -Child3 - ChildXXX
Domanda due: codice della domanda "ReportChildAge" testo della domanda "Informazioni sul tuo primo figlio: - CHILD1 ha 1 ANNI."
Expression {AskChildAge_Child1.question}, {AskChildAge_Child1.value}
Descrizione Si desidera utilizzare il valore di una sottodomanda in una domanda successiva. Puoi accedere al valore della sottodomanda con questo tipo di espressione: QcodeQuestion_QcodeSubquestion.value
Steps Crea/modifica la seconda domanda
Inserisci questo testo nella descrizione: "Informazioni sul tuo primo figlio: - {AskChildAge_Child1.question} è {AskChildAge_Child1.value}."
File di esempio Display_value_of_a_multiple_answer_input_question_field. zip

Convalida il numero di caselle spuntate per riga per una domanda "Casella di controllo matrice (numeri)"

Scopo Convalidare il numero di caselle spuntate per riga
Tipo Convalida
Esempio Domanda di tipo " Numeri matrice (layout casella di controllo)"
Espressione sum(...)
Descrizione (sum(Test_A_1, Test_A_2, Test_A_3, Test_A_4, Test_A_5) <= X) determina se almeno X caselle di controllo nella riga A sono selezionate.
Se vuoi controllare tutte e tre le righe (A, B, C), puoi collegare l'espressione usando "&&":
(sum(Test_A_1, Test_A_2, Test_A_3, Test_A_4, Test_A_5) <= X)
&& (somma(Test_B_1, Test_B_2, Test_B_3, Test_B_4, Test_B_5) <= X)
&& (sum(Test_C_1, Test_C_2, Test_C_3, Test_C_4, Test_C_5) <= X)
Steps Crea/modifica domanda di tipo "Numeri matrice (layout casella di controllo)".
Inserisci l'espressione precedente in "Equazione di convalida della domanda" nelle impostazioni avanzate della domanda (potresti dover modificare i nomi delle variabili!)
File di esempio Convalida numero di ticker di caselle per riga per un Array (Numbers) Checkbox.lss
File:Convalida il numero di ticker di caselle per riga per un Array ( Numbers) Casella di controllo 05.pngFile:Convalida il numero di caselle ticker per riga per una casella di controllo Array (Numbers) 1.png

Calcola la differenza tra due date

Scopo Calcola la differenza tra due date
Tipo Rilevanza / Equazione tipo di domanda / Convalida
Esempio Domanda uno (data/ora, codice: DOB): Qual è la tua data di nascita?
Domanda due (data/ora, codice: datetoday): qual è la data di oggi?
Domanda tre (piatto): hai XXXX giorni.
Da fare: calcola e visualizza il numero di giorni tra la data indicata nella domanda 1 e la domanda 2.
Expression {(strtotime(datetoday)-strtotime(DOB))/60/60 /24}
Descrizione strtotime calcola il numero di secondi tra il 1 gennaio 1970 e la data specificata. L'espressione precedente calcola il numero di secondi tra le due date specificate. Il termine "/60/60/24" calcola semplicemente il numero di giorni dal numero di secondi.
Invece di chiedere "datetoday", puoi anche usare strtotime('now') o semplicemente time(), che restituisce direttamente il numero di secondi dal gennaio 1970 ad oggi (cioè l'ora in cui è stato effettuato il sondaggio). Quindi puoi calcolare rapidamente l'età di una persona in anni con l'equazione {(time() - strtotime(DOB)) / 60 / 60 / 24 / 365.25} In ognuno di questi casi, è fondamentale inserire la data in un formato appropriato, altrimenti la funzione strtotime() non funzionerà correttamente.
Passaggi Crea due domande sulla data (per la data di nascita e per la data odierna) e una domanda standard.
Nel testo della domanda della domanda standard inserire: "Il {datetoday} avevi {(strtotime(today)-strtotime(dob))/60/60/24} giorni giorni."

Nota: la funzione strtotime può funzionare con MOLTI ma non con tutti i formati di data. In caso di problemi, imposta il formato della data del sondaggio su mm/gg/aaaa o aaaa-mm-gg o gg.mm.aaaa"
File di esempio Date_difference.zip

Utilizzo di ExpressionScript per le valutazioni

Ecco un altro esempio su come utilizzare ExpressionScript con Domande di tipo Array e valutazioni:</ br>

Supponiamo che tu abbia 2 domande sull'array e desideri salvare i risultati dei dati di calcolo nel tuo database. In realtà è semplice, dovrai creare e testare i tuoi array e inviare una risposta fittizia per vedere se funziona e ti dà i risultati nella pagina completata.


Dettagli di implementazione:

  • aggiungi una domanda di tipo equazione
  • aggiungi la seguente riga supponendo che Q1 sia il codice della domanda dell'array mentre Q2 sia il secondo: 
    •  {sum(Q1_SQ001.value,Q2_SQ001.value)}

Si noti che SQ001 è il codice predefinito per qualsiasi domanda secondaria. Se modifichi il codice della sottodomanda, modifica l'equazione sopra di conseguenza.


Utilizzando em_validation_q nell'array

È possibile utilizzare l'equazione di convalida della domanda per controllare un array con qualsiasi condizione.


Dettagli di implementazione:

  • per il primo array: array a scelta singola
    • Il codice della domanda è ARRAY
    • Il codice della sottodomanda è SQ01,SQ02,SQ03 e SQ04

** aggiorna l'equazione di convalida dell'intera domanda e metti

 !is_empty(ARRAY_SQ01) e !is_empty(ARRAY_SQ03)
  • per il secondo array: array di testo
    • Il codice della domanda è ARRAYTEXT
    • La sottodomanda al codice dell'asse Y è SY01, SY02, SY03 e SY04
    • Aggiorna l'intera domanda equazione di validazione e put
       count(self.sq_SY01 >= 1) e count(self.sq_SY03 >= 3)
Retrieved from "http://manual.limesurvey.org/index.php?title=ExpressionScript_examples/it&oldid=184749"