LimeSurvey Manual - User contributions [en]

Using regular expressions

2025-10-14T10:46:57Z

Ritapas: http->https

<languages /> <translate>


__TOC__


Regular Expressions must start and finish with a forward slash ("/"). You can find a good library of regular expressions at https://www.regexlib.net/. These patterns will almost always work if they are surrounded by forward slashes.


To test your regex you can [https://regex101.com/ use this regex tester].


{{Note|To improve this wiki section, we kindly ask you to add your successfully tested regular expression(s) to provide a better understanding of this feature to the new LimeSurvey (potential) users.}}


{{Alert|title=Attention|text= Please note that all the below examples are written on one line!}}

=Important: Regular Expressions in conditions= 


Note that when using regular expressions in the condition editor, do NOT include the beginning and ending slash.

=Email validation= 


Update (12/2018): Since these days domain names cannot only hold special characters like “ü” but also use more than 3 characters as domain name like .''tech'' or .''company'', the below email regex only checks if “@” and “.” exists within the entered email address.
<source lang="html">
/^.+?@.+?\..+$/
</source>


If you want to validate one address per line, in a multiline long text field:
<source lang="html">
/^(((\w+([-+.']\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*(\r\n)?\n?)+)*)$/
</source>


At this outdated regex the domain name is limited to 3 characters which doesn't cover all available domains:
<source lang="html">
/^(\w[-._+\w]*\w@\w[-._\w]*\w\.\w{2,3})$/
</source>

=Postcodes= 

==Australian postcodes:== 


<source lang="html">/^[0-9]{4}/</source>

==Brazilian postcodes== 


<source lang="html">/^[0-9]{2}\.[0-9]{3}-[0-9]{3}$/</source>

==Canadian postcodes== 


<source lang="html">/^[a-zA-Z]\d{1}[a-zA-Z](\-| |)\d{1}[a-zA-Z]\d{1}$/</source>

==US postal codes== 


<source lang="html">/^[0-9]{5}([- /]?[0-9]{4})?$/</source>


For the postal code to start with zero, use:


<source lang="html">/^[0-9]{5}(?:-[0-9]{4})?$/</source>

==UK postcodes== 


<source lang="html">/^[A-Z][A-Z]?[0-9][A-Z0-9]? ?[0-9][ABDEFGHJLNPQRSTUWXYZ]{2}$/i</source>


Note that this is not very exact, and a more exact validation is much more complex. For example, see [https://stackoverflow.com/questions/164979/uk-postcode-regex-comprehensive StackOverflow answer] and [https://en.wikipedia.org/wiki/Talk:Postcodes_in_the_United_Kingdom#Regular_Expressions Wikipedia] for more information.

==French postcodes== 


<source lang="html">/(^[0-8]\d\d{3}$)|(^9[0-5]\d{3}$)|(^97[1-6]\d{2}$)|(^98[46-8]\d{2}$)/</source>


The above expression is very precise and it will check whether or not the French Department exists (first two digits), including overseas Departments and overseas Territories (DOM-TOM).

=Phone numbers= 

==US phone numbers== 


<source lang="html">/^(?:$[2-9]\d{2}$\ ?|[2-9]\d{2}(?:\-?|\ ?))[2-9]\d{2}[- ]?\d{4}$/</source>


or


<source lang="html">/^[\.\- ]{0,}[0-9]{3}[\.\- ]{0,}[0-9]{3}[\.\- ]{0,}[0-9]{4}[\.\- ]{0,}$/</source>


This second option will match all phone Canadian and US phone numbers that include non-digit symbols including:


<source lang="html"> . ( ) - (space)</source>


This will allow you to match phone numbers which resemble below:
*(555)555 5555
*555.555.5555
*555 555 5555
*(555)-555-5555
*555-555-5555
*555555555

==Australian phone numbers== 


The following patterns match all various Australian mobile and landline phone numbers including with "+61" country prefix:
*(02) 9123 6535
*03 1234-5345
*0412 345 678
*+61 2 3456 789


But not:
* 234 3450 234
*a234 534 3432
*134567
*123456789013


Brackets, white space and hypens are ignored.


The 'Very precise:' versions listed here match against the first four or five digits in a number to ensure that they are valid Australian numbers.


The 'Not very precise:' only match against the first and second digit so may allow invaid numbers.

===All Australian phone numbers (mobile and landline - area code required)=== 


Very precise:


<source lang="html">/^$?(?:\+?61|0)(?:(?:2$?[ -]?(?:3[ -]?[38]|[46-9][ -]?[0-9]|5[ -]?[0-35-9])|3\)?(?:4[ -]?[0-57-9]|[57-9][ -]?[0-9]|6[ -]?[1-67])|7\)?[ -]?(?:[2-4][ -]?[0-9]|5[ -]?[2-7]|7[ -]?6)|8\)?[ -]?(?:5[ -]?[1-4]|6[ -]?[0-8]|[7-9][ -]?[0-9]))(?:[ -]?[0-9]){6}|4\)?[ -]?(?:(?:[01][ -]?[0-9]|2[ -]?[0-57-9]|3[ -]?[1-9]|4[ -]?[7-9]|5[ -]?[018])[ -]?[0-9]|3[ -]?0[ -]?[0-5])(?:[ -]?[0-9]){5})$/
</source>


Not very precise:


<source lang="html">/^(?:\+?61|0)[2-478](?:[ -]?[0-9]){8}$/</source>

===All Australian phone numbers (landlines only - area code required)=== 


Very precise:


<source lang="html">/^$?(?:\+?61|0)(?:2$?[ -]?(?:3[ -]?[38]|[46-9][ -]?[0-9]|5[ -]?[0-35-9])|3\)?(?:4[ -]?[0-57-9]|[57-9][ -]?[0-9]|6[ -]?[1-67])|7\)?[ -]?(?:[2-4][ -]?[0-9]|5[ -]?[2-7]|7[ -]?6)|8\)?[ -]?(?:5[ -]?[1-4]|6[ -]?[0-8]|[7-9][ -]?[0-9]))(?:[ -]?[0-9]){6}$/</source>


Not very precise:


<source lang="html">/^(?:\+?61|$?0)[2378]$?(?:[ -]?[0-9]){8}$/</source>

===New South Wales landline phone numbers (area code optional)=== 


Very precise:


<source lang="html">/^(?:$?(?:\+?61|0)2$?[ -]?)?(?:3[ -]?[38]|[46-9][ -]?[0-9]|5[ -]?[0-35-9])(?:[ -]?[0-9]){6}$/</source>


Not very precise:


<source lang="html">/^(?:$?(?:\+?61|0)2$?(?:[ -]?[0-9]){7}[0-9]$/</source>

===Victorian and Tasmanian landline phone numbers (area code optional)=== 


Very precise:


<source lang="html">/^(?:$?(?:\+?61|0)3$?[ -]?)?(?:4[ -]?[0-57-9]|[57-9][ -]?[0-9]|6[ -]?[1-67])(?:[ -]?[0-9]){6}$/</source>


Not very precise:


<source lang="html">/^(?:$?(?:\+?61|0)3$?(?:[ -]?[0-9]){7}[0-9]$/</source>

===Queensland landline phone numbers (area code optional)=== 


Very precise:


<source lang="html">/^(?:$?(?:\+?61|0)7$?[ -]?)?(?:[2-4][ -]?[0-9]|5[ -]?[2-7]|7[ -]?6)(?:[ -]?[0-9]){6}$/</source>


Not very precise:


<source lang="html">/^(?:$?(?:\+?61|0)7$?(?:[ -]?[0-9]){7}[0-9]$/</source>

===South Australia, Northern Territory, Western Australia landline phone numbers (area code optional)=== 


Very precise:


<source lang="html">/^(?:$?(?:\+?61|0)8$?[ -]?)?(?:5[1-4]|6[0-8]|[7-9][0-9])$/</source>


Not very precise:


<source lang="html">/^(?:$?(?:\+?61|0)8$?(?:[ -]?[0-9]){7}[0-9]$/</source>

===Australian mobile phone numbers only=== 


Very precise:


<source lang="html">/^(?:\+?61|0)4 ?(?:(?:[01] ?[0-9]|2 ?[0-57-9]|3 ?[1-9]|4 ?[7-9]|5 ?[018]) ?[0-9]|3 ?0 ?[0-5])(?: ?[0-9]){5}$/</source>


Not very precise:


<source lang="html">/^(?:$?(?:\+?61|0)4$?(?:[ -]?[0-9]){7}[0-9]$/</source>

==Belgian phone number== 
<source lang="html">/^((\+|00)32\s?|0)(\d\s?\d{3}|\d{2}\s?\d{2})(\s?\d{2}){2}$/</source>
==Belgian mobile phone number==
<source lang="html">/^((\+|00)32\s?|0)4(60|[789]\d)(\s?\d{2}){3}$/</source>
==French phone number==
<source lang="html">/^((\+|00)33\s?|0)[1-59](\s?\d{2}){4}$/</source>
==French mobile phone number==
<source lang="html">/^((\+|00)33\s?|0)[67](\s?\d{2}){4}$/</source>
==Luxemburg phone number==
<source lang="html">/^((\+|00\s?)352)?(\s?\d{2}){3,4}$/</source>
==Luxemburg mobile phone number==
<source lang="html">/^((\+|00\s?)352)?\s?6[269]1(\s?\d{3}){2}$/</source>
=German marks (with optional plus or minus)=
<source lang="html">/^[1-6]{1}[\+|\-]?$/</source>

=Age validation= 


Example: Age 20-99
<source lang="html">/([2-9][0-9])/</source>


Example: Age 18-35
<source lang="html">/(1[8-9]|2[0-9]|3[0-5])/</source>


Example: Age 19-65
<source lang="html">/^(1[8-9]|[2-5][0-9]|6[0-5])$/</source>

=Number validation= 

==Numbers from 1 to 99999== 
<source lang="html">/^([1-9]|[1-9][0-9]|[1-9][0-9][0-9]|[1-9][0-9][0-9][0-9]|[1-9][0-9][0-9][0-9][0-9])$/</source>
<source lang="html">/^[1-9][0-9]{0,4}$/ does the same as above but should run a little faster</source>
==Numbers from 1 to 999, 1.000 to 999.999 to 999.999.999==
<source lang="html">/^[1-9][0-9]{0,2}(?:\.[0-9]{3}){0,2}$/</source>
Accepts numbers from 1 to 999, 1.000 to 999.999 to 999.999.999 but
rejects numbers like 999.1.1 , 94.22.22, 999.1.22, 999.11.1, 999.1.333

==Number validation with optional decimal (for price)== 
Accepts numbers from 0 to 199, with 2 decimal optional:
<source lang="html">/^([1][0-9][0-9]|[1-9][0-9]|[0-9])((\.)[0-9][0-9])?$/</source>

==Number validation with thousand separator== 
Space as separator, no minus
<source lang="html">/^(?!0)\d{1,3}(\ \d{3})*$/</source>
Dot as separator, minus allowed
<source lang="html">/^-?(?!0)\d{1,3}(\.\d{3})*$/</source>


It forces two decimal points and accepts numbers from 1.00 to 999,999,999.00 with an optional comma delimiting thousands/millions
including all of the following: 1.00, 1,000.00, 12,345.67, 12345,02, 123,456,468.00, 1234566.00, 123456789.00
but not 1,23.00, 12,3.4 or 1234,43.04
<source lang="html">/^[1-9][0-9]{0,2}(?:,?[0-9]{3}){0,3}\.[0-9]{2}$/</source>

Similar to the above: Forces two decimal points but accepts a "0" before decimal separator ",".
<source lang="html">/[0-9]{0,2}(?:,?[0-9]{3}){0,3}\.[0-9]{2}$/</source>


Same as above, but the two decimal points are optional:
<source lang="html">/^[1-9][0-9]{0,2}(?:,?[0-9]{3}){0,3}(?:\.[0-9]{2})?$/ </source>

==Month (1-12)== 


If you want to ask for the month a person was born you can validate the input as follows:


<source lang="html">/^[0]*[1-9]$|^[0]*1[0-2]$/</source>

=Minimum width (set to 3 in this example)= 


<source lang="html">/^.{3,}$/</source>

=Currency= 

==US currency (dollar sign and cents optional)== 


<source lang="html">/^\$?\d+(\.(\d{2}))?$/</source>


Check for comma usage:
<source lang="html">/^\$?\d{1,3}(\d+(?!,))?(,\d{3})*(\.\d{2})?$/</source>

==Swiss price== 


A number with two decimal numbers after the decimal point of which the last one is either a 5 or a 0:


<source lang="html">/^(\d+)(\.\d(05)?)?$/</source>

=Validate score= 

==1-10== 


<source lang="html">/^[1-9]{1}$|^10$/</source>

==1-100== 


<source lang="html">/^[1-9]?[0-9]{1}$|^100$/</source>

=Text validation= 


The [[Question type - Multiple short text|multiple short text question type]] doesn't support minimum or maximum answers at the moment. One way around this is to use a [[Question type - Long free text|long free text question type]] with a regular expression.


The below expression tests for at least one word per line for at least 3 lines and no more than 10 lines:


<source lang="html">/(?:[^,.;:?!& \n\r]+(?: [^,.;:?!& \n\r]+)*)(?:[,.;:?!& \n\r]?(?:\n|\r|\n\r|\r\n)(?:[^,.;:?!& \n\r]+(?: [^,.;:?!& \n\r]+)*)){2,10}/is</source>


If you want, say five words per line, you could change the first and last star/asterisk to {4,}:


<source lang="html">/(?:[^,.;:?!& \n\r]+(?: [^,.;:?!& \n\r]+){4,})(?:[,.;:?!& \n\r]?(?:\n|\r|\n\r|\r\n)(?:[^,.;:?!& \n\r]+(?: [^,.;:?!& \n\r]+){4,})){2,10}/is</source>


If you wanted one or more words per line (between line 1 and line 5), you can change the content located within the last curly braces to '''0,4''' (note you use 0 because you're already matching the first line).


<source lang="html">/(?:[^,.;:?!& \n\r]+(?: [^,.;:?!& \n\r]+)*)(?:[,.;:?!& \n\r]?(?:\n|\r|\n\r|\r\n)(?:[^,.;:?!& \n\r]+(?: [^,.;:?!& \n\r]+)*)){0,4}/is</source>

==Word count== 


The following restricts the number of words allowed to a minimum of 1 and a maximum of 200:


<source lang="html">/^[-\w]+(?:\W+[-\w]+){0,199}\W*$/</source>


To increase the minimum change the zero part of {0,199}.


To increase or decrease the maximum change the "199" part of {0,199}.

=Time validation= 


There are a number of ways to write time formats. Some of the possible options are 12 hour or 24 hour, with seconds or without. Although it is an option to use the [[Question type - Date|date question type]] (it can also capture time) you can use the [[Question type - Short free text|short free text question type]] with one of the below validation regular expressions.


The following three validation strings test for 24 hour time (in order of appearances) without seconds, with optional seconds lastly with seconds required:


<source lang="html">/^(?:[01][0-9]|2[0-3]):[0-5][0-9]$/</source>


<source lang="html">/^(?:[01][0-9]|2[0-3]):[0-5][0-9](?::[0-5][0-9])?$/</source>


<source lang="html">/^(?:[01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]$/</source>


The following three match 12 hour time, as above with seconds, optional seconds and with seconds required:


<source lang="html">/^(?">00:[0-5][0-9] (?:am|AM)|(?:0[1-9]|1[01]):[0-5][0-9] (?:[ap]m|[AP]M)|12:[0-5][0-9] (?:pm|PM))$/</source>


<source lang="html">/^(?:00:[0-5][0-9](?::[0-5][0-9])? (?:am|AM)|(?:0[1-9]|1[01]):[0-5][0-9](?::[0-5][0-9])? (?:[ap]m|[AP]M)|12:[0-5][0-9](?::[0-5][0-9])? (?:pm|PM))$/</source>


<source lang="html">/^(?:00:[0-5][0-9]:[0-5][0-9] (?:am|AM)|(?:0[1-9]|1[01]):[0-5][0-9]:[0-5][0-9] (?:[ap]m|[AP]M)|12:[0-5][0-9]:[0-5][0-9] (?:pm|PM))$/</source>


The following three match either 12 or 24 hour time as above with seconds, optional seconds and with seconds required:


<source lang="html">/^(?:(?:00:[0-5][0-9] (?:am|AM)|(?:0[1-9]|1[01]):[0-5][0-9] (?:[ap]m|[AP]M)|12:[0-5][0-9] (?:pm|PM))|(?:[01][0-9]|2[0-3]):[0-5][0-9])$/</source>


<source lang="html">/^(?:(?:00:[0-5][0-9](?[0-5][0-9])? (?:am|AM)|(?:0[1-9]|1[01]):[0-5][0-9](?[0-5][0-9])? (?:[ap]m|[AP]M)|12:[0-5][0-9](?[0-5][0-9])? (?:pm|PM))|(?:[01][0-9]|2[0-3]):[0-5][0-9](?[0-5][0-9])?)$/</source>


<source lang="html">/^(?:(?:00:[0-5][0-9]:[0-5][0-9] (?:am|AM)|(?:0[1-9]|1[01]):[0-5][0-9]:[0-5][0-9] (?:[ap]m|[AP]M)|12:[0-5][0-9]:[0-5][0-9] (?:pm|PM))|(?:[01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9])$/</source>

=US states= 


To validate for one state use the following (example is Texas):
*TX uppercase only: <source lang="html">/^(TX)$/</source>
*tx lowercase only: <source lang="html">/^(tx)$/</source>
*TX upper or lowercase: <source lang="html">/^([T|t][X|x])$/</source>

=Profanity Filter= 


To filter profanity words from an answer:


<source lang="html">/^(?i)((?!\bENTERPROFANITYHERE\b).)*$(?-i)/</source>


Replace "ENTERPROFANITYHERE" with your bad word.


The \b will allow passing of words such as "assassination" and "hello" if you enter "ass" or "hell" as your profanity word. This also works if you are trying to omit other words, names etc. from answers.

=Helpful links= 


In the beginning of this wiki section, we recommend you to use https://regex101.com/ to test/create regular expressions. You can also use https://www.regextester.com/ to create expressions in case you are unhappy about the first option. You can use https://extendsclass.com/regex-tester.html to visualize regular expressions.

</translate>

Talk:Using regular expressions/en

2024-11-14T11:25:43Z

Ritapas: RegExp to validate email addresses

I see that in this page it is advised to use the following RegExp to validate email addresses:
Code:

/^.+?@.+?\..+$/

However, this would validate an email address containing whitespace, and also lists of email addresses separated by puctuation.
I've found this RegExp would validate correctly an email address:
^([^\x00-\x20\x22\x28\x29\x2c\x2e\x3a-\x3c\x3e\x40\x5b-\x5d\x7f-\xff]+|\x22([^\x0d\x22\x5c\x80-\xff]|\x5c[\x00-\x7f])*\x22)(\x2e([^\x00-\x20\x22\x28\x29\x2c\x2e\x3a-\x3c\x3e\x40\x5b-\x5d\x7f-\xff]+|\x22([^\x0d\x22\x5c\x80-\xff]|\x5c[\x00-\x7f])*\x22))*\x40([^\x00-\x20\x22\x28\x29\x2c\x2e\x3a-\x3c\x3e\x40\x5b-\x5d\x7f-\xff]+|\x5b([^\x0d\x5b-\x5d\x80-\xff]|\x5c[\x00-\x7f])*\x5d)(\x2e([^\x00-\x20\x22\x28\x29\x2c\x2e\x3a-\x3c\x3e\x40\x5b-\x5d\x7f-\xff]+|\x5b([^\x0d\x5b-\x5d\x80-\xff]|\x5c[\x00-\x7f])*\x5d))*$

As far as I know, there is not a neater option.
How about changing the page content?

Data policy settings

2021-01-15T08:18:36Z

Ritapas: added note to mark an important caveat. See https://bugs.limesurvey.org/view.php?id=15025

<languages /> <translate>

=Introduction= 


The following panel allows you to add your own survey policy text, which, if enabled, must be accepted by your respondents in order to continue filling in the survey.


The ''Data policy setting'' is located under the '''Settings''' tab, as it can be observed in the next screenshot:


<center>[[File:Data policy settings location.png]]</center>

=Data policy settings= 


The following options can be edited from the ''Data policy settings'' panel:


<center>[[File:Data policy settings panel.png]]</center>


*'''Show survey policy text with mandatory checkbox:''' If enabled, a policy notice (e.g., regarding the protection of personal data) will be displayed on the welcome page to the survey respondents. The following options are available:
**''Don't show'' : If chosen, no policy notice will be displayed to your survey respondents.
**''Show as text'' : If enabled, the whole data security/policy text will be displayed after the welcome message. The checkbox will be displayed at the bottom of the text.
**''Collapsible text'' : If enabled, only the checkbox text will be displayed. To access the full policy/data security text, the survey respondents will have to click on the '''Show policy''' button located under the checkbox text.


*'''Survey data policy checkbox label:''' Fill in the following box to add the text you wish to be displayed next to the checkbox that needs to be ticked by your respondents to continue filling in your survey. If empty, the default text is: "To continue please first accept our survey data policy".


*'''Survey data policy message:''' Fill in the textbox to add all the information related to your survey data policy (e.g., where the data is stored, for how long, and so on).


*'''Survey data policy error message:''' In the case in which a respondent forgets to tick the survey data policy checkbox, the message from this textbox will be displayed on the screen.


*'''Survey legal notice:''' Fill in the textbox to add all the information related to your legal notice (e.g., rights, duties obligations).


*'''Show data policy in survey:''' Whether to display the "data policy" button on all survey page. On click this will display a button that shows a popup box(modal) with the "data policy" message.


*'''Show legal notice in survey:''' Whether to display the "legal notice" button on all survey page. On click this will display a button that shows a popup box(modal) with the "legal notice".


<div class="simplebox">[[File:help.png]] If you want to specify a link to the survey data policy, set "''Show survey policy text with mandatory checkbox''" to "''Collapsible text''" and use the placeholders {STARTPOLICYLINK} and {ENDPOLICYLINK} in the "''Survey data policy checkbox label''" field to define the link that opens the policy popup. If there is no placeholder given, there will be an appendix.</div>


<div class="simplebox">[[File:help.png]] '''Note:''' If questions are displayed 'All in one' page, the 'Survey data policy checkbox' is not shown and the survey is displayed.</div>

</translate>

Translations:QS:Relevance/14/it

2020-10-19T04:45:42Z

Ritapas: Created page with "Category:Question SettingsCategory:General Question Options"

[[Category:Question Settings]][[Category:General Question Options]]

Translations:QS:Relevance/10/it

2020-10-19T04:45:34Z

Ritapas: Created page with "</onlyinclude>"

</onlyinclude>

QS:Relevance/it

2020-10-19T04:45:31Z

Ritapas: Created page with "Ecco alcuni buoni esempi di syntax highlighting."

<languages />

<onlyinclude>
===Equazione di rilevanza===

'''Descrizione'''

Se il valore dell'equazione di rilevanza è "1" o "vero", la domanda è "rilevante" nel contesto del sondaggio, ovvero viene mostrata al partecipante al sondaggio. In caso contrario, la domanda è nascosta. Per qualsiasi domanda del sondaggio è possibile specificare un'equazione di rilevanza. Questa funzione è il successore di [[Setting_conditions|condizioni]] e supporta una logica condizionale molto più complessa.

'''Syntax Highlighting'''

Ogni volta che si salva l'equazione di rilevanza, questa viene valutata ed evidenziata nella sintassi. Eventuali errori verranno codificati a colori in modo da poterli rilevare e correggere rapidamente.

{{Hint|Text =Per verificare se tutte le equazioni di rilevanza del sondaggio sono corrette, vedere la funzione [[Show_logic_file |show logic file]].}}

'''Valori validi'''

* Qualsiasi equazione che utilizzi la sintassi [[ExpressionScript - Presentation|ExpressionScript]], senza le parentesi graffe circostanti.

'''Esempi'''

Ecco alcuni buoni esempi di [[ExpressionScript How-tos#Syntax_Highlighting|syntax highlighting]].

</onlyinclude>

[[Category:Question Settings]][[Category:General Question Options]]

Translations:QS:Relevance/12/it

2020-10-19T04:45:30Z

Ritapas: Created page with "Ecco alcuni buoni esempi di syntax highlighting."

Ecco alcuni buoni esempi di [[ExpressionScript How-tos#Syntax_Highlighting|syntax highlighting]].

QS:Relevance/it

2020-10-19T04:45:12Z

Ritapas: Created page with "'''Esempi'''"

<languages />

<onlyinclude>
===Equazione di rilevanza===

'''Descrizione'''

Se il valore dell'equazione di rilevanza è "1" o "vero", la domanda è "rilevante" nel contesto del sondaggio, ovvero viene mostrata al partecipante al sondaggio. In caso contrario, la domanda è nascosta. Per qualsiasi domanda del sondaggio è possibile specificare un'equazione di rilevanza. Questa funzione è il successore di [[Setting_conditions|condizioni]] e supporta una logica condizionale molto più complessa.

'''Syntax Highlighting'''

Ogni volta che si salva l'equazione di rilevanza, questa viene valutata ed evidenziata nella sintassi. Eventuali errori verranno codificati a colori in modo da poterli rilevare e correggere rapidamente.

{{Hint|Text =Per verificare se tutte le equazioni di rilevanza del sondaggio sono corrette, vedere la funzione [[Show_logic_file |show logic file]].}}

'''Valori validi'''

* Qualsiasi equazione che utilizzi la sintassi [[ExpressionScript - Presentation|ExpressionScript]], senza le parentesi graffe circostanti.

'''Esempi'''

Here are good examples of [[ExpressionScript How-tos#Syntax_Highlighting|syntax highlighting]].

</onlyinclude>

[[Category:Question Settings]][[Category:General Question Options]]

Translations:QS:Relevance/9/it

2020-10-19T04:45:10Z

Ritapas: Created page with "'''Esempi'''"

'''Esempi'''

QS:Relevance/it

2020-10-19T04:45:01Z

Ritapas: Created page with "* Qualsiasi equazione che utilizzi la sintassi ExpressionScript, senza le parentesi graffe circostanti."

<languages />

<onlyinclude>
===Equazione di rilevanza===

'''Descrizione'''

Se il valore dell'equazione di rilevanza è "1" o "vero", la domanda è "rilevante" nel contesto del sondaggio, ovvero viene mostrata al partecipante al sondaggio. In caso contrario, la domanda è nascosta. Per qualsiasi domanda del sondaggio è possibile specificare un'equazione di rilevanza. Questa funzione è il successore di [[Setting_conditions|condizioni]] e supporta una logica condizionale molto più complessa.

'''Syntax Highlighting'''

Ogni volta che si salva l'equazione di rilevanza, questa viene valutata ed evidenziata nella sintassi. Eventuali errori verranno codificati a colori in modo da poterli rilevare e correggere rapidamente.

{{Hint|Text =Per verificare se tutte le equazioni di rilevanza del sondaggio sono corrette, vedere la funzione [[Show_logic_file |show logic file]].}}

'''Valori validi'''

* Qualsiasi equazione che utilizzi la sintassi [[ExpressionScript - Presentation|ExpressionScript]], senza le parentesi graffe circostanti.

'''Examples'''

Here are good examples of [[ExpressionScript How-tos#Syntax_Highlighting|syntax highlighting]].

</onlyinclude>

[[Category:Question Settings]][[Category:General Question Options]]

Translations:QS:Relevance/11/it

2020-10-19T04:45:00Z

Ritapas: Created page with "* Qualsiasi equazione che utilizzi la sintassi ExpressionScript, senza le parentesi graffe circostanti."

* Qualsiasi equazione che utilizzi la sintassi [[ExpressionScript - Presentation|ExpressionScript]], senza le parentesi graffe circostanti.

QS:Relevance/it

2020-10-19T04:44:40Z

Ritapas: Created page with "'''Valori validi'''"

<languages />

<onlyinclude>
===Equazione di rilevanza===

'''Descrizione'''

Se il valore dell'equazione di rilevanza è "1" o "vero", la domanda è "rilevante" nel contesto del sondaggio, ovvero viene mostrata al partecipante al sondaggio. In caso contrario, la domanda è nascosta. Per qualsiasi domanda del sondaggio è possibile specificare un'equazione di rilevanza. Questa funzione è il successore di [[Setting_conditions|condizioni]] e supporta una logica condizionale molto più complessa.

'''Syntax Highlighting'''

Ogni volta che si salva l'equazione di rilevanza, questa viene valutata ed evidenziata nella sintassi. Eventuali errori verranno codificati a colori in modo da poterli rilevare e correggere rapidamente.

{{Hint|Text =Per verificare se tutte le equazioni di rilevanza del sondaggio sono corrette, vedere la funzione [[Show_logic_file |show logic file]].}}

'''Valori validi'''

*Any equation that makes use of the [[ExpressionScript - Presentation|ExpressionScript]] syntax, without surrounding curly braces.

'''Examples'''

Here are good examples of [[ExpressionScript How-tos#Syntax_Highlighting|syntax highlighting]].

</onlyinclude>

[[Category:Question Settings]][[Category:General Question Options]]

Translations:QS:Relevance/8/it

2020-10-19T04:44:38Z

Ritapas: Created page with "'''Valori validi'''"

'''Valori validi'''

QS:Relevance/it

2020-10-19T04:44:27Z

Ritapas: Created page with "{{Hint|Text =Per verificare se tutte le equazioni di rilevanza del sondaggio sono corrette, vedere la funzione show logic file.}}"

<languages />

<onlyinclude>
===Equazione di rilevanza===

'''Descrizione'''

Se il valore dell'equazione di rilevanza è "1" o "vero", la domanda è "rilevante" nel contesto del sondaggio, ovvero viene mostrata al partecipante al sondaggio. In caso contrario, la domanda è nascosta. Per qualsiasi domanda del sondaggio è possibile specificare un'equazione di rilevanza. Questa funzione è il successore di [[Setting_conditions|condizioni]] e supporta una logica condizionale molto più complessa.

'''Syntax Highlighting'''

Ogni volta che si salva l'equazione di rilevanza, questa viene valutata ed evidenziata nella sintassi. Eventuali errori verranno codificati a colori in modo da poterli rilevare e correggere rapidamente.

{{Hint|Text =Per verificare se tutte le equazioni di rilevanza del sondaggio sono corrette, vedere la funzione [[Show_logic_file |show logic file]].}}

'''Valid values'''

*Any equation that makes use of the [[ExpressionScript - Presentation|ExpressionScript]] syntax, without surrounding curly braces.

'''Examples'''

Here are good examples of [[ExpressionScript How-tos#Syntax_Highlighting|syntax highlighting]].

</onlyinclude>

[[Category:Question Settings]][[Category:General Question Options]]

Translations:QS:Relevance/13/it

2020-10-19T04:44:25Z

Ritapas: Created page with "{{Hint|Text =Per verificare se tutte le equazioni di rilevanza del sondaggio sono corrette, vedere la funzione show logic file.}}"

{{Hint|Text =Per verificare se tutte le equazioni di rilevanza del sondaggio sono corrette, vedere la funzione [[Show_logic_file |show logic file]].}}

QS:Relevance/it

2020-10-19T04:42:03Z

Ritapas: Created page with "Ogni volta che si salva l'equazione di rilevanza, questa viene valutata ed evidenziata nella sintassi. Eventuali errori verranno codificati a colori in modo da poterli rilevar..."

<languages />

<onlyinclude>
===Equazione di rilevanza===

'''Descrizione'''

Se il valore dell'equazione di rilevanza è "1" o "vero", la domanda è "rilevante" nel contesto del sondaggio, ovvero viene mostrata al partecipante al sondaggio. In caso contrario, la domanda è nascosta. Per qualsiasi domanda del sondaggio è possibile specificare un'equazione di rilevanza. Questa funzione è il successore di [[Setting_conditions|condizioni]] e supporta una logica condizionale molto più complessa.

'''Syntax Highlighting'''

Ogni volta che si salva l'equazione di rilevanza, questa viene valutata ed evidenziata nella sintassi. Eventuali errori verranno codificati a colori in modo da poterli rilevare e correggere rapidamente.

{{Hint|Text=To check if all the relevance equations are used correctly within your survey, read about our [[Show_logic_file|show logic file]] feature.}}

'''Valid values'''

*Any equation that makes use of the [[ExpressionScript - Presentation|ExpressionScript]] syntax, without surrounding curly braces.

'''Examples'''

Here are good examples of [[ExpressionScript How-tos#Syntax_Highlighting|syntax highlighting]].

</onlyinclude>

[[Category:Question Settings]][[Category:General Question Options]]

Translations:QS:Relevance/7/it

2020-10-19T04:42:02Z

Ogni volta che si salva l'equazione di rilevanza, questa viene valutata ed evidenziata nella sintassi. Eventuali errori verranno codificati a colori in modo da poterli rilevare e correggere rapidamente.

Translations:QS:Relevance/6/it

2020-10-19T04:41:38Z

Ritapas: Created page with "'''Syntax Highlighting'''"

'''Syntax Highlighting'''

QS:Relevance/it

2020-10-19T04:41:34Z

Ritapas: Created page with "Se il valore dell'equazione di rilevanza è "1" o "vero", la domanda è "rilevante" nel contesto del sondaggio, ovvero viene mostrata al partecipante al sondaggio. In caso con..."

<languages />

<onlyinclude>
===Equazione di rilevanza===

'''Descrizione'''

Se il valore dell'equazione di rilevanza è "1" o "vero", la domanda è "rilevante" nel contesto del sondaggio, ovvero viene mostrata al partecipante al sondaggio. In caso contrario, la domanda è nascosta. Per qualsiasi domanda del sondaggio è possibile specificare un'equazione di rilevanza. Questa funzione è il successore di [[Setting_conditions|condizioni]] e supporta una logica condizionale molto più complessa.

'''Syntax Highlighting'''

Whenever you save the relevance equation, it is evaluated and syntax-highlighted. Any errors will be color coded so that you can quickly detect and fix them.

{{Hint|Text=To check if all the relevance equations are used correctly within your survey, read about our [[Show_logic_file|show logic file]] feature.}}

'''Valid values'''

*Any equation that makes use of the [[ExpressionScript - Presentation|ExpressionScript]] syntax, without surrounding curly braces.

'''Examples'''

Here are good examples of [[ExpressionScript How-tos#Syntax_Highlighting|syntax highlighting]].

</onlyinclude>

[[Category:Question Settings]][[Category:General Question Options]]

Translations:QS:Relevance/5/it

2020-10-19T04:41:32Z

Se il valore dell'equazione di rilevanza è "1" o "vero", la domanda è "rilevante" nel contesto del sondaggio, ovvero viene mostrata al partecipante al sondaggio. In caso contrario, la domanda è nascosta. Per qualsiasi domanda del sondaggio è possibile specificare un'equazione di rilevanza. Questa funzione è il successore di [[Setting_conditions|condizioni]] e supporta una logica condizionale molto più complessa.

QS:Relevance/it

2020-10-19T04:39:56Z

Ritapas: Created page with "'''Descrizione'''"

<languages />

<onlyinclude>
===Equazione di rilevanza===

'''Descrizione'''

If the value of the relevance equation is "1" or "true", the question is "relevant" in the survey context, i.e. it is shown to the survey participant. If not, the question is hidden. Any survey question allows you to specify a relevance equation. This function is the successor of [[Setting_conditions|conditions]] and supports much more complex conditional logic.

'''Syntax Highlighting'''

Whenever you save the relevance equation, it is evaluated and syntax-highlighted. Any errors will be color coded so that you can quickly detect and fix them.

{{Hint|Text=To check if all the relevance equations are used correctly within your survey, read about our [[Show_logic_file|show logic file]] feature.}}

'''Valid values'''

*Any equation that makes use of the [[ExpressionScript - Presentation|ExpressionScript]] syntax, without surrounding curly braces.

'''Examples'''

Here are good examples of [[ExpressionScript How-tos#Syntax_Highlighting|syntax highlighting]].

</onlyinclude>

[[Category:Question Settings]][[Category:General Question Options]]

Translations:QS:Relevance/4/it

2020-10-19T04:39:54Z

Ritapas: Created page with "'''Descrizione'''"

'''Descrizione'''

QS:Relevance/it

2020-10-19T04:39:49Z

Ritapas: Created page with "<onlyinclude> ===Equazione di rilevanza==="

<languages />

<onlyinclude>
===Equazione di rilevanza===

'''Description'''

If the value of the relevance equation is "1" or "true", the question is "relevant" in the survey context, i.e. it is shown to the survey participant. If not, the question is hidden. Any survey question allows you to specify a relevance equation. This function is the successor of [[Setting_conditions|conditions]] and supports much more complex conditional logic.

'''Syntax Highlighting'''

Whenever you save the relevance equation, it is evaluated and syntax-highlighted. Any errors will be color coded so that you can quickly detect and fix them.

{{Hint|Text=To check if all the relevance equations are used correctly within your survey, read about our [[Show_logic_file|show logic file]] feature.}}

'''Valid values'''

*Any equation that makes use of the [[ExpressionScript - Presentation|ExpressionScript]] syntax, without surrounding curly braces.

'''Examples'''

Here are good examples of [[ExpressionScript How-tos#Syntax_Highlighting|syntax highlighting]].

</onlyinclude>

[[Category:Question Settings]][[Category:General Question Options]]

Translations:QS:Relevance/2/it

2020-10-19T04:39:48Z

Ritapas: Created page with "<onlyinclude> ===Equazione di rilevanza==="

<onlyinclude>
===Equazione di rilevanza===

Translations:QS:Relevance/1/it

2020-10-19T04:39:31Z

Ritapas: Created page with "<languages />"

QS:Relevance/it

2020-10-19T04:39:29Z

Ritapas: Created page with "QS:Rilevanza"

<languages />

<onlyinclude>
===Relevance equation===

'''Description'''

If the value of the relevance equation is "1" or "true", the question is "relevant" in the survey context, i.e. it is shown to the survey participant. If not, the question is hidden. Any survey question allows you to specify a relevance equation. This function is the successor of [[Setting_conditions|conditions]] and supports much more complex conditional logic.

'''Syntax Highlighting'''

Whenever you save the relevance equation, it is evaluated and syntax-highlighted. Any errors will be color coded so that you can quickly detect and fix them.

{{Hint|Text=To check if all the relevance equations are used correctly within your survey, read about our [[Show_logic_file|show logic file]] feature.}}

'''Valid values'''

*Any equation that makes use of the [[ExpressionScript - Presentation|ExpressionScript]] syntax, without surrounding curly braces.

'''Examples'''

Here are good examples of [[ExpressionScript How-tos#Syntax_Highlighting|syntax highlighting]].

</onlyinclude>

[[Category:Question Settings]][[Category:General Question Options]]

Translations:QS:Relevance/Page display title/it

2020-10-19T04:39:27Z

Ritapas: Created page with "QS:Rilevanza"

QS:Rilevanza

ExpressionScript sample surveys/it

2020-10-19T03:22:33Z

Ritapas: Created page with "Per scaricare l'esempio del sondaggio precedente, fare clic sul link seguente: Media:Rating_User-Entered_List_of_Products_Survey.zip|Esempio di valutazione di una lista di p..."

<languages />

__TOC__

=Introduzione=

il modo migliore per imparare ad usare ExpressionScript è provare esempi funzionanti e modificarli secondo le proprie esigenze.

Nel testo seguente sono disponibili alcuni sondaggi di esempi per valutare come si può usare EM per migliorare i propri sondaggi. Questi sondaggi sono anche disponibili nella directory /docs/demosurvey della distribuzione.

=Rilevanza, Adattamento ed Equazioni=

==Panoramica==

L'esempio seguente calcola l'IMC (Indice di Massa Corporea, in inglese Body Mass Index) del partecipante. L'esempio mostra diverse caratteristiche, illustrate più avanti.

==Dimostrazione delle caratteristiche dell'EM==

#'''Rilevanza''' - supporto per logica condizionale "potente";
#'''Piping / Tailoring''' - offre la possibilità di concatenare o adattare le risposte e i metadati delle domande;
#'''Adattamento Dinamico''' - report che cambiano sulla pagina stesas mentre si digitano le risposte.
#'''Micro-Tailoring''' - adattamento condizionale all'interno di frasi e report con l'utilizzo di istruzioni if()
#'''Equazioni''' - un nuovo [[Question type - Equation|tipo di domanda]] che consente l'esecuzione di calcoli, anche nascosti, e la conservazione dei risultati sul database
#'''Convalida dondizionale''' - criteri di convalida, come ad esempio il valore minimo accettabile, possono essere ora condizionali, vale a dire basati su equazioni.

==Screenshot==

Questo esempio calcola l'Indice di Massa Corporea, un indice basato sul peso e l'altezza che determina se si è sottopeso, normopeso, sovrappeso o obesi. All'inizio, sono mostrate solo le quattro domande obbligatorie.

<center>[[File:tailoring1.jpg]]</center>

Dopo aver inserito le informazioni (ed aver scelto se si desidera utilizzare unità metriche o meno), è mostrato un report personalizzato che riassume i dati inseriti e mostra l'indicatore dello stato di peso forma.

<center>[[File:tailoring2.jpg]]</center>

Ecco un altro esempio, che utilizza unità non metriche per mostrare come i risultati cambiano dinamicamente:

<center>[[File:tailoring3.jpg]]</center>

Sono state inserite [[Question type - Equation|domande nascoste di tipo Equazione]] per convertire i dati nel sistema metrico, quando appropriato. In queste domande sono conservati altezza e peso in unità metriche, che confluiscono nella base dati, con l'indice IMC e lo stato di peso forma, senza che si debba creare codice JavaScript personalizzato.

Negli esempi successivi è mostrato come mostrare funzioni, matematiche o d'altro tipo, all'interno di report personalizzati.
Prima dell'inserimento di dati, la pagina appare in questo modo.
Grazie alla logica condizionale, se non sono presenti dati numerici le celle restano vuote invece di mostrare "NaN" o "Divide by Zero".

<center>[[File:tailoring4.jpg]]</center>

Dopo che sono stati inseriti i numeri, il report della pagina è modificato e mostra il calcolo eseguito e il suo risultato.

<center>[[File:tailoring5.jpg]]</center>

Nel sondaggio di esempio sono presenti molti altri esempi. Ad esempio, nella schermata seguente è mostrata una delle tante maniere nelle quali è possibile compilare la pagina Dynamic Relevance.
Come illustrato nelle note, è possibile provare a inserite diverse età e, in particolare, all'inserimento di combinazioni incompatibili di risposte sono mostrati messaggi divertenti.
Si noti anche che se si dichiara di avere più di un figlio, il messaggio dirà "I hope you enjoy playing with your X children" ("spero che ti diverta a giocare con i tuoi X bambini"), piuttosto che declinare la frase al singolare. Con questo si mostra come si possono personalizzare singole frasi per adattarle al genere e/o al numero dei sostantivi utilizzati, come anche si possono anche coniugare facilmente verbi.

<center>[[File:tailoring6.jpg]]</center>

==Download==

Per scaricare il sondaggio di esempio, utilizzare il link seguente: [[Media:LS3_em_tailoring.zip|LS3_em_tailoring.zip]].

=Sample Census=

=Introduzione=

Questo è un esempio di censimento nel quale si chiede quante persone costituiscono il nucleo familiare.

Mostra in che modo è possibile utilizzare la rilevanza a livello di gruppo per implementare facilmente la ripetizione ciclica di domande ("loop"). Dopo aver creato il gruppo per "Person 1", questo è stato esportato. Avendo utilizzato nomi di variabile qcode del tipo p1_name, si è potuto utilizzare un editor di testo per modificare velocemente e re-importare i gruppi più volte: sono stati sufficienti 10 secondi per modificare e re-importare ogni nuovo gruppo mantenendo nomi unici per le variabili e logica corretta a livello di gruppo.

Sarebbe stato possibile utilizzare anche l'opzione [[Copy question|copia domanda]] ma l'opzione mostrata è più rapida.

Si vede anche come evitare che il messaggio di Fine compilazione appaia solo quando il sondaggio è effettivamente terminato (vale a dire, quando tutti i gruppi obbligatori sono completati).

==Dimostrazione delle caratteristiche di EM==

#'''Rilevanza a livello di gruppi''' - I gruppi successivi ("Person 1-5") sono mostrati solo fino al numero di conviventi specificati;
#'''Adattamento''' - Il report finale riassume i dati demografici di ciascun convivente;
#'''Visualizzazione progressiva delle domande''' - Sia in gruppo che in modalità pagina singola, le domande successive sono mostrate mano a mano che le precedenti ricevono una risposta.

==Screenshot==

Il sondaggio produce un report dinamico nel quale sono mostrati i dati demografici dello specifico numero di conviventi:

<center>[[File:census.jpg]]</center>

Se il sondaggio è mostrato una domanda alla volta, si vede che l'indice si adatta alle domande. Dal momento che l'utente ha scritto che la persona è una donna, la domanda (in inglese) è declinata al femminile. E visto che è stato inserito il suo nome, "Mary", la domanda successiva chiede "How old is Mary?" ("Quanti anni ha Mary?").

<center>[[File:census2.jpg]]</center>

==Download==

Usare il link seguente per scaricare il sondaggio di esempio: [[Media:LS3_group_relevance.zip|LS3_group_relevance.zip]].

=Filtri concatenati per Array=

==Panoramica==

Il sondaggio seguente si basa su un originale gentilmente concesso da Joy Lane Research, LLC.

==Screenshot==

Nelle immagini seguenti, notare che.
*Q2 mostra solo i prodotti selezionati (con array_filter) in Q01
*Q02 mostra anche "Another product", ovvero il testo inserito nel campo "Other electronic" di Q01
*Q04 mostra solo prodotti in Q02 che sono stati selezionati (filtraggio concatenato)
*Q05 mostra solo prodotti in Q02 che NON sono stati selezioati in Q02 (filtraggio concatenato che utilizza array_filter_exclude)

<center>[[File:cascading_array_filter.jpg]]</center>

<center>[[File:cascading_array_filter2.jpg]]</center>

==Download==

Utilizzare il seguente link per scaricare l'esempio precedente:[[Media:ls2_cascading_array_filter.lss|LS2_cascading_array_filter sondaggio di esempio]].

=Adattamento/Piping utilizzando tutti i tipi di domanda e attributi=

==Panoramica==

Se siete confusi su come nominare le vostre variabili (SGQA o Qcode), non siete soli. Anche se la documentazione descrive [[ExpressionScript - Presentation#Access to Variables|come comporre nomi di variabile Qcode]], niente è meglio che osservare una demo funzionante. Il sondaggio seguente mostra come accedere ad attributi di domanda e risposte utilizzando ExpressionScript.

{{Note|Per questo esempio, si consiglia di disattivare l'editor HTML integrato (o di convertirlo in modalità popup) durante la modifica di questo sondaggio. L'editor HTML può impiegare un minuto o più per eseguire il rendering dei rapporti HTML di grandi dimensioni in modalità di modifica.}}

==Contenuto==

*Esempi per ogni tipo di domanda
*Sono inclusi tutti i tipi di domande che utilizzano "altro", in modo da mostrare come ciò influisca sulla denominazione delle variabili
*Valori predefiniti per tutti i tipi di domanda che accettano valori predefiniti
*Adattamento - Rapporti in pagina e fuori pagina che mostrano tutti i 16 suffissi disponibilil per EM.
*Questi report mostrano tutti i dati attualmente inseriti (quindi mostrano come generare i propri rapporti stampabili per gli utenti al posto della stampa diretta della schermata delle risposte)
*Qcode corretto e denominazione SGQA di tutte le variabili

==Screenshot==

Questo è un sondaggio enorme, quindi abbiamo scelto di non includere schermate. Consigliamo piuttosto di scaricarlo e giocarci un po'.

==Download==

Fare clic sul collegamento seguente per scaricare il sondaggio: [[Media:ls2_EM_question_attributes.lss|LS3_EM_question_attributes.lss]]

=Validazione tradizionale, rivisitata=

==Panoramica==

Dimostrazione di tutti i tipi di convalida che fanno uso di espressioni e di come esse influiscono su ciascuno dei tipi di domanda che supportano la convalida. In molti casi, i suggerimenti di convalida sono inizialmente nascosti e vengono visualizzati solo se una domanda non soddisfa i criteri di convalida (scomparendo, pertanto, una volta che la domanda superi i criteri di convalida).

==Dimostrazione dei tipi di convalida==

#[[QS:Min_num_value_n|min_num_value_n]] - valore minimo per una risposta#[[QS:Max_num_value_n|max_num_value_n]] - valore massimo per una risposta
#[[QS:Min_answers|min_answers]] - numero minimo di risposte obbligatorie
#[[QS:Max_answers|max_answers]] - numero massimo di risposte consentite
#[[QS:Multiflexible_min|multiflexible_min]] - numero minimo consentito per una risposta (per il tipo di domanda con numeri multiflexi)
#[[QS:Multiflexible_max|multiflexible_max]] - valore massimo consentito per una risposta (per il tipo di domanda con numeri multiflexi)
#[[QS:Min_num_value|min_num_value]] - valore minimo consentito per la somma di tutte le risposte alla domanda
#[[QS:Max_num_value|max_num_value]] - valore massimo consentito per la somma di tutte le risposte alla domanda
#[[QS:Equals_num_value|equals_num_value]] - la somma di tutte le risposte alla domanda deve essere pari a questo valore
#[[QS:Preg_validation|validation]] - espressione regolare di convalida per la domanda - può essere applicata a singole celle

==Screenshot==

Utilizzando nuovi stili CSS, ogni tipo di convalida mostra un suggerimento separato. Se vengono visualizzati, possono essere nascosti tramite l'opzione hide_tip. L'opzione predefinita è mostrarli con un carattere rosso se la domanda non soddisfa i criteri di convalida e verde se li supera:

<center>[[File:validation1.jpg]]</center>

Un utente non può inviare una pagina con errori di convalida. Verrà immediatamente avvertito se ha inserito informazioni errate:

<center>[[File:validation3.jpg]]</center>

La convalida può essere applicata a singole celle all'interno di un array, come in questo esempio, in cui le convalide delle espressioni regolari assicurano che ogni voce sia un numero di telefono statunitense formattato correttamente, incluso il prefisso.

<center>[[File:validation4.jpg]]</center>

==Download==

Per scaricare l'esempio precedente, fare clic sul seguente collegamento: [[Media:LS3_Validation_tests.zip|LS3_Validation_tests.zip]].

=Equazioni di convalida=

==Panoramica==

A volte è necessaria una convalida personalizzata che non può essere ottenuta utilizzando i tradizionali criteri minino/massimo. Per questo, sarà necessario utilizzare le opzioni em_validation_q e em_validation_sq, che consentono di costruire equazioni di convalida complesse rispettivamente a livello di domanda e sottodomanda.

{{Nota|A livello di sottodomanda, introduciamo anche la variabile "this" per semplificare la convalida di ogni cella in un array senza dover conoscere il nome della variabile. Per maggiori dettagli su questo aspetto, fare clic qui.}}

==Dimostrazione delle caratteristiche di EM==

#[[QS:Em_validation_q|em_validation_q]] - questa equazione determina se l'intera domanda è valida
#[[QS:Em_validation_q_tip|em_validation_q_tip]] - questo è il messaggio da mostrare se la domanda non supera i criteri di convalida em_validation_q
#[[QS:Em_validation_sq|em_validation_sq]] - questa equazione determina se ogni sottodomanda (o cella dell'array) è valida
#[[QS:Em_validation_sq_tip|em_validation_sq_tip]] - questo messaggio è mostrato se esistono sottodomande non valide.

In generale, quando si utilizza em_validation_sq, se una cella non è valida il colore di sfondo di quella cella diventa rosso per indicare che c'è un errore.

==Screenshot==

<center>[[File:sqvalidation.jpg]]</center>

Questa domanda assicura che l'età dei tuoi figli sia inserita in ordine decrescente applicando questa equazione di convalida:

<syntaxhighlight lang="php" enclose="div">q1_sq1 >= q1_sq2 && q1_sq2 >= q1_sq3 && q1_sq3 >= q1_sq4</syntaxhighlight>

<center>[[File:sqvalidation2.jpg]]</center>

<hr width="50%" style="margin:auto">

Nell'esempio seguente, la convalida garantisce che non venga data risposta a più di 3 domande su una determinata riga applicando questa equazione di convalida:

<syntaxhighlight lang="php" enclose="div">(sum(Test_A_1, Test_A_2, Test_A_3, Test_A_4, Test_A_5) <= 3) && (sum(Test_B_1, Test_B_2, Test_B_3, Test_B_4, Test_B_5) <= 3) && (sum(Test_C_1, Test_C_2, Test_C_3, Test_C_4, Test_C_5) <= 3)</syntaxhighlight>

Si può anche scrivere come segue e Limesurvey convertirà il tutto automaticamente a run-time nella espressione elencata sopra.

<syntaxhighlight lang="php" enclose="div">(sum(self.sq_A) <= 3) && (sum(self.sq_B) <= 3) && (sum(self.sq_C) <= 3)</syntaxhighlight>

<center>[[File:sqvalidation3.jpg]]</center>

==Download==

Per scaricare il sondaggio di esempio utilizzato negli esempi precedenti, agire sul link seguente: [[Media:ls2_test_em_sq_validation.lss|ls2_test_em_sq_validation.lss]].

=Rilevanza per sottodomande=

==Panoramica==

Questa sezione mostra come possono interagire array_filter e criteri di convalida. Per le convalide che si applicano alle somme, vengono considerati solo i valori rilevanti (visibili).

==Dimostrazione delle caratteristiche di EM==

#[[QS:Array_filter|array_filter]]
#[[QS:Array filter exclude|array_filter_exclude]]
#[[QS:Min_num_value|min_num_value]]
#[[QS:Max num value|max_num_value]]
#[[QS:equals_num_value|equals_num_value]]

Mostra anche il reporting dinamico del numero di domande a cui è stata data risposta nelle domande principali.

==Screenshot==

La modifica del numero di righe visibili cambia dinamicamente la somma. Contrassegnare una sottodomanda come non rilevante non ne cancella il valore. Piuttosto, se non è rilevante, i suoi valori non contribuiscono a nessuna equazione.

<center>[[File:sqrel1.jpg]][[File:Sqrelver12.png]]</center>

Si noti cosa accade quando si seleziona l'opzione "Fifth subquestion" per la prima domanda '''"Which rows should appear below"'''. La somma della seconda domanda "Enter some numbers" ora è 5. Anche se la sottodomanda 5 ha ancora il vaore 14 (cioè, se si deseleziona la quinda sottodomanda, si vedrà nuovamente il valore 14), quel valore non contribuisce alla somma perché considerato non rilevante. Tutti i dati non rilevanti sono cancellati (segnati nel database come NULL) al momento dell'invio, ma il valore resta disponibile sulla pagina nel caso gli utenti vogliano o debbano cambiare idea sulle risposte.

<center>[[File:sqrel2.jpg]]</center>

==Download==

Utilizzare il seguente link per scaricare il nostro esempio: [[Media:ls2_subquestion_relevance.lss|ls2_subquestion_relevance.lss]].

=Utilizzo della virgola come separatore di radice (punto decimale)=

==Panoramica==

ExpressionScript garantisce che solo i numeri validi possano essere inseriti nei campi numerici. Se si inserisce un numero non valido, si viene avvisati che qualcosa non va (ad esempio, nel caso del tema "fruity", l'intera domanda viene scritta in carattere rosso).

Si noti che i valori numerici vengono sempre convertiti utilizzando un punto come separatore all'interno del database. In questo modo, le analisi statistiche funzioneranno in modo appropriato.

Per cambiare il separatore decimale, accedere alle opzioni [[Text elements|Elementi di testo]] che si trovano nel menù [[Survey_settings|Impostazioni]] e cercare la funzionalità [[Text_elements#Survey_text_elements_panel|Simbolo del decimale]].

{{Note|Per ulteriori informazioni sul punto decimale, si veda la pagina wiki [https://en.wikipedia.org/wiki/Radix_point|Radix_point] (in inglese).}}

==Tipi di domande che utilizzano il punto decimale==

#[[Question type - Numerical input|Inserimento numerico]] <nowiki>[</nowiki>N]
#[[Question type - Multiple numerical input|Inserimento numerico multiplo]] <nowiki>[</nowiki>K]
#[[Question type - Array (Numbers)|Array (Numeri)]] <nowiki>[</nowiki>:]
#[[Question type - Array (Texts)|Array (Testo)]] <nowiki>[</nowiki>;], utilizzando l'attributo [[QS:Numbers_only|numbers_only]]
#[[Question type - List (Radio)|List (radio)]] <nowiki>[</nowiki>L], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Short free text|Testo breve]] <nowiki>[</nowiki>S], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Multiple short text|Testo breve multiplo]] <nowiki>[</nowiki>Q], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Multiple choice|Scelta multipla]] <nowiki>[</nowiki>M], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Multiple choice with comments|Scelta multipla con commenti]] <nowiki>[</nowiki>P], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]

==Screenshot==

Si può notare negli screenshot qui sotto che la virgola può essere utilizzata come punto decimale.

<center>[[File:radix1.jpg]]</center>

==Download==

Per scaricare l'esempio precedente, fare clic sul link seguente: [[Media:ls2_comma_as_radix_separator.lss|ls2_comma_as_radix_separator.lss]].

=Gruppi di randomizzazione=

==Panoramica==

Questo sondaggio mostra come utilizzare l'attributo '''random_group'''.

Se viene utilizzato questo attributo, ogni volta che si avvia il sondaggio l'ordine delle domande viene randomizzato. Tuttavia, una volta avviato il sondaggio, l'ordine di randomizzazione rimane fisso, anche se si cambia lingua.

==Screenshot==

Guardiamo insieme l'esempio seguente. La prima domanda casuale sulla pagina sarà Q1, Q4 o Q7. La seconda domanda randomizzata sulla pagina sarà Q2, Q5 o Q8.

<center>[[File:random1.jpg]]</center>

Ecco la randomizzazione generata la prima volta che ho testato questo sondaggio.

<center>[[File:random2.jpg]]</center>

La seconda volta che ho testato il sondaggio è stata generata una diversa randomizzazione.

<center>[[File:random3.jpg]]</center>

Ma, quando sono passato al francese (senza ricominciare il sondaggio), l'ordine di randomizzazione è rimasto intatto.

<center>[[File:random4.jpg]]</center>

==Download==

Per scaricare l'esempio precedente, fare clic sul link seguente: [[Media:Randomization_Group_Test.lss|Randomization_Group_Test.lss]]

=Presentare una sola domanda a caso per gruppo=

==Panoramica==

Questo sondaggio mostra come configurare un sondaggio per visualizzare in modo casuale una domanda per gruppo. In esso ci sono 5 gruppi di 6 domande ciascuno. All'inizio, nel Gruppo 0, vengono compilate cinque domande nascoste di equazioni, chiamate ask1-ask5. Ognuna ha il valore di {floor(rand(1,6.9999))} nel campo di testo della domanda, il che significa che le variabili ask1-ask5 avranno ciascuna un valore compreso tra 1 e 6. Quindi, ogni domanda nel gruppo ha un equazione di rilevanza come "ask1 == N", dove N è l'ennesima domanda nel gruppo (quindi la terza domanda nel gruppo 1 ha l'equazione di rilevanza "ask1 == 3").

Questo sondaggio funziona altrettanto bene nelle modalità "un sondaggio alla volta", "gruppo per gruppo" e "domanda per domanda". Poiché la randomizzazione è impostata nel primo gruppo e quel gruppo è effettivamente nascosto (dal momento che tutte le domande ask1-ask5 sono nascoste), la randomizzazione rimane la stessa per ciascun soggetto; ma ogni soggetto diverso avrà una randomizzazione distinta.

==Dimostrazione delle caratteristiche==

#[[Question type - Equation|Tipo di domanda dell'equazione]]
#Funzioni di randomizzazione
#Funzione condizionale (if)

==Screenshot==

Questo è il Gruppo0, che utilizza il [[Question type - Equation|Tipo di domanda equazione]] per selezionare valori casuali da 1 a 6 per ogni gruppo (eccetto l'ultimo gruppo, che ha solo 4 domande). Nota che la funzione "if()" controlla prima se ask1 è già stato impostato e, in tal caso, utilizza quel valore. Se il valore non è stato impostato, utilizza un valore casuale per impostare il valore di ask1.

<center>[[File:randq3.jpg]]</center>

Questo gruppo mostra come la variabile (ask4) del Gruppo0 viene utilizzata per controllare quale domanda è visibile all'interno del quarto gruppo.

<center>[[File:randq2.jpg]]</center>

==Download==

Per scaricare il sondaggio di esempio precedente, fare clic qui: [[Media: limesurvey_survey_55164.lss|Esempio di domande casuali all'interno di un gruppo]].

=Porre a caso un numero specifico di domande in un gruppo (un sottoinsieme delle domande)=

{{Avviso|Questo si applica solo a tutte le domande casuali di un gruppo e solo se viene utilizzato il formato [[General_settings # General_settings_panel |Un gruppo per pagina oppure Tutte le domande in una pagina]].}}

==Panoramica==

Questo sondaggio mostra come porre un sottoinsieme casuale di domande in un gruppo. Ad esempio, mostra 5 domande casuali su 10 domande situate all'interno di un gruppo.

Il sondaggio ha un gruppo contenente 10 domande. A tutte le domande viene assegnato lo stesso [[QS: Random_group|nome del gruppo di randomizzazione]]. Di conseguenza, verranno visualizzate in ordine casuale al caricamento della pagina. A ogni domanda viene assegnata un'equazione di rilevanza secondo cui la somma di "[[ExpressionScript - Presentation#Access to Variables|relevanceStatus]]" di tutte le altre domande nel gruppo è inferiore al numero di domande che si desidera mostrare. Poiché "[[ExpressionScript - Presentation#Access to Variables|relevanceStatus]]" viene assegnato durante il rendering delle domande, questo corrisponde effettivamente al numero di domande precedenti.

Quindi, nel nostro esempio "5 su 10", l'equazione per Q1 sarebbe:

<syntaxhighlight lang="php" enclose="div">sum(Q2.relevanceStatus, Q3.relevanceStatus, Q4.relevanceStatus, Q5.relevanceStatus, Q6.relevanceStatus, Q7.relevanceStatus, Q8.relevanceStatus, Q9.relevanceStatus, Q10.relevanceStatus) LT 5</syntaxhighlight>

Per Q2, sarebbe:

<syntaxhighlight lang="php" enclose="div">sum(Q1.relevanceStatus, Q3.relevanceStatus, Q4.relevanceStatus, Q5.relevanceStatus, Q6.relevanceStatus, Q7.relevanceStatus, Q8.relevanceStatus, Q9.relevanceStatus, Q10.relevanceStatus) LT 5</syntaxhighlight>

E così via...

==Dimostrazione delle caratteristiche==

#[[ExpressionScript - Presentation#Access to variables|variabile relevanceStatus]]
#[[QS:Random group|Randomizzazione]]

==Download==

Per scaricare l'esempio precedente, fare clic sul link seguente: [[Media:Random_5_out_of_10.lss|Random 5 out of 10 survey example]].

=Classificazione di un elenco di prodotti inserito dall'utente=

==Panoramica==

L'esempio seguente mostra come chiedere agli utenti di elencare una serie di prodotti che li interessano e quindi chiedere loro di valutarli.

==Dimostrazione delle caratteristiche di ES==

#'''Personalizzazione delle risposte''' - quando si valutano i prodotti, le etichette provengono dal campo dei commenti della precedente domanda a scelta multipla
# '''Scale personalizzate''' - molte opzioni avanzate delle domande, come i titoli delle scale, possono essere anche personalizzate.

==Screenshot==

Questa immagine mostra che, essendo stati selezionati solo i prodotti 1,3 e 5, vengono visualizzati solo quei tre (utilizzando l'attributo [[QS: Array_filter|array_filter]]). Inoltre, le etichette delle righe nella seconda domanda sono i numeri di prodotto (se non viene inserito nulla nel campo dei commenti) o il contenuto dei campi dei commenti.

<center>[[File:mcc_filter1.jpg]]</center>

Questa immagine mostra come vengono specificate le risposte su misura:

<center>[[File:mcc_filter2.jpg]]</center>

Ecco il File della logica per quella domanda, che ci consente di verificare che la logica condizionale funzioni come desiderato (ad esempio, per vedere se ci sono errori di sintassi):

<center>[[File:mcc_filter3.jpg]]</center>

L'immagine successiva mostra un gruppo in cui si specifica una scala di valutazione a 5 punti (Opzioni 1-5), il titolo della scala e i prodotti che si desidera valutare. L'ultima domanda mostra che ciascuna delle parti della domanda di tipo array può essere adattata:

<center>[[File:mcc_filter4.jpg]]</center>

L'immagine successiva mostra la visualizzazione del File della logica per l'ultima domanda. Come si può osservare, le domande secondarie, le risposte e le intestazioni di scala possono essere personalizzate.

<center>[[File:mcc_filter5.jpg]]</center>

==Download==

Per scaricare l'esempio del sondaggio precedente, fare clic sul link seguente: [[Media:Rating_User-Entered_List_of_Products_Survey.zip|Esempio di valutazione di una lista di prodotti inserita dall' utente]].

Translations:ExpressionScript sample surveys/179/it

2020-10-19T03:22:31Z

Per scaricare l'esempio del sondaggio precedente, fare clic sul link seguente: [[Media:Rating_User-Entered_List_of_Products_Survey.zip|Esempio di valutazione di una lista di prodotti inserita dall' utente]].

Translations:ExpressionScript sample surveys/178/it

2020-10-19T03:21:24Z

Ritapas: Created page with "==Download=="

==Download==

Translations:ExpressionScript sample surveys/177/it

2020-10-19T03:21:22Z

Ritapas: Created page with "<center>File:mcc_filter5.jpg</center>"

<center>[[File:mcc_filter5.jpg]]</center>

ExpressionScript sample surveys/it

2020-10-19T03:21:21Z

Ritapas: Created page with "L'immagine successiva mostra la visualizzazione del File della logica per l'ultima domanda. Come si può osservare, le domande secondarie, le risposte e le intestazioni di sca..."

<languages />

__TOC__

=Introduzione=

il modo migliore per imparare ad usare ExpressionScript è provare esempi funzionanti e modificarli secondo le proprie esigenze.

Nel testo seguente sono disponibili alcuni sondaggi di esempi per valutare come si può usare EM per migliorare i propri sondaggi. Questi sondaggi sono anche disponibili nella directory /docs/demosurvey della distribuzione.

=Rilevanza, Adattamento ed Equazioni=

==Panoramica==

L'esempio seguente calcola l'IMC (Indice di Massa Corporea, in inglese Body Mass Index) del partecipante. L'esempio mostra diverse caratteristiche, illustrate più avanti.

==Dimostrazione delle caratteristiche dell'EM==

#'''Rilevanza''' - supporto per logica condizionale "potente";
#'''Piping / Tailoring''' - offre la possibilità di concatenare o adattare le risposte e i metadati delle domande;
#'''Adattamento Dinamico''' - report che cambiano sulla pagina stesas mentre si digitano le risposte.
#'''Micro-Tailoring''' - adattamento condizionale all'interno di frasi e report con l'utilizzo di istruzioni if()
#'''Equazioni''' - un nuovo [[Question type - Equation|tipo di domanda]] che consente l'esecuzione di calcoli, anche nascosti, e la conservazione dei risultati sul database
#'''Convalida dondizionale''' - criteri di convalida, come ad esempio il valore minimo accettabile, possono essere ora condizionali, vale a dire basati su equazioni.

==Screenshot==

Questo esempio calcola l'Indice di Massa Corporea, un indice basato sul peso e l'altezza che determina se si è sottopeso, normopeso, sovrappeso o obesi. All'inizio, sono mostrate solo le quattro domande obbligatorie.

<center>[[File:tailoring1.jpg]]</center>

Dopo aver inserito le informazioni (ed aver scelto se si desidera utilizzare unità metriche o meno), è mostrato un report personalizzato che riassume i dati inseriti e mostra l'indicatore dello stato di peso forma.

<center>[[File:tailoring2.jpg]]</center>

Ecco un altro esempio, che utilizza unità non metriche per mostrare come i risultati cambiano dinamicamente:

<center>[[File:tailoring3.jpg]]</center>

Sono state inserite [[Question type - Equation|domande nascoste di tipo Equazione]] per convertire i dati nel sistema metrico, quando appropriato. In queste domande sono conservati altezza e peso in unità metriche, che confluiscono nella base dati, con l'indice IMC e lo stato di peso forma, senza che si debba creare codice JavaScript personalizzato.

Negli esempi successivi è mostrato come mostrare funzioni, matematiche o d'altro tipo, all'interno di report personalizzati.
Prima dell'inserimento di dati, la pagina appare in questo modo.
Grazie alla logica condizionale, se non sono presenti dati numerici le celle restano vuote invece di mostrare "NaN" o "Divide by Zero".

<center>[[File:tailoring4.jpg]]</center>

Dopo che sono stati inseriti i numeri, il report della pagina è modificato e mostra il calcolo eseguito e il suo risultato.

<center>[[File:tailoring5.jpg]]</center>

Nel sondaggio di esempio sono presenti molti altri esempi. Ad esempio, nella schermata seguente è mostrata una delle tante maniere nelle quali è possibile compilare la pagina Dynamic Relevance.
Come illustrato nelle note, è possibile provare a inserite diverse età e, in particolare, all'inserimento di combinazioni incompatibili di risposte sono mostrati messaggi divertenti.
Si noti anche che se si dichiara di avere più di un figlio, il messaggio dirà "I hope you enjoy playing with your X children" ("spero che ti diverta a giocare con i tuoi X bambini"), piuttosto che declinare la frase al singolare. Con questo si mostra come si possono personalizzare singole frasi per adattarle al genere e/o al numero dei sostantivi utilizzati, come anche si possono anche coniugare facilmente verbi.

<center>[[File:tailoring6.jpg]]</center>

==Download==

Per scaricare il sondaggio di esempio, utilizzare il link seguente: [[Media:LS3_em_tailoring.zip|LS3_em_tailoring.zip]].

=Sample Census=

=Introduzione=

Questo è un esempio di censimento nel quale si chiede quante persone costituiscono il nucleo familiare.

Mostra in che modo è possibile utilizzare la rilevanza a livello di gruppo per implementare facilmente la ripetizione ciclica di domande ("loop"). Dopo aver creato il gruppo per "Person 1", questo è stato esportato. Avendo utilizzato nomi di variabile qcode del tipo p1_name, si è potuto utilizzare un editor di testo per modificare velocemente e re-importare i gruppi più volte: sono stati sufficienti 10 secondi per modificare e re-importare ogni nuovo gruppo mantenendo nomi unici per le variabili e logica corretta a livello di gruppo.

Sarebbe stato possibile utilizzare anche l'opzione [[Copy question|copia domanda]] ma l'opzione mostrata è più rapida.

Si vede anche come evitare che il messaggio di Fine compilazione appaia solo quando il sondaggio è effettivamente terminato (vale a dire, quando tutti i gruppi obbligatori sono completati).

==Dimostrazione delle caratteristiche di EM==

#'''Rilevanza a livello di gruppi''' - I gruppi successivi ("Person 1-5") sono mostrati solo fino al numero di conviventi specificati;
#'''Adattamento''' - Il report finale riassume i dati demografici di ciascun convivente;
#'''Visualizzazione progressiva delle domande''' - Sia in gruppo che in modalità pagina singola, le domande successive sono mostrate mano a mano che le precedenti ricevono una risposta.

==Screenshot==

Il sondaggio produce un report dinamico nel quale sono mostrati i dati demografici dello specifico numero di conviventi:

<center>[[File:census.jpg]]</center>

Se il sondaggio è mostrato una domanda alla volta, si vede che l'indice si adatta alle domande. Dal momento che l'utente ha scritto che la persona è una donna, la domanda (in inglese) è declinata al femminile. E visto che è stato inserito il suo nome, "Mary", la domanda successiva chiede "How old is Mary?" ("Quanti anni ha Mary?").

<center>[[File:census2.jpg]]</center>

==Download==

Usare il link seguente per scaricare il sondaggio di esempio: [[Media:LS3_group_relevance.zip|LS3_group_relevance.zip]].

=Filtri concatenati per Array=

==Panoramica==

Il sondaggio seguente si basa su un originale gentilmente concesso da Joy Lane Research, LLC.

==Screenshot==

Nelle immagini seguenti, notare che.
*Q2 mostra solo i prodotti selezionati (con array_filter) in Q01
*Q02 mostra anche "Another product", ovvero il testo inserito nel campo "Other electronic" di Q01
*Q04 mostra solo prodotti in Q02 che sono stati selezionati (filtraggio concatenato)
*Q05 mostra solo prodotti in Q02 che NON sono stati selezioati in Q02 (filtraggio concatenato che utilizza array_filter_exclude)

<center>[[File:cascading_array_filter.jpg]]</center>

<center>[[File:cascading_array_filter2.jpg]]</center>

==Download==

Utilizzare il seguente link per scaricare l'esempio precedente:[[Media:ls2_cascading_array_filter.lss|LS2_cascading_array_filter sondaggio di esempio]].

=Adattamento/Piping utilizzando tutti i tipi di domanda e attributi=

==Panoramica==

Se siete confusi su come nominare le vostre variabili (SGQA o Qcode), non siete soli. Anche se la documentazione descrive [[ExpressionScript - Presentation#Access to Variables|come comporre nomi di variabile Qcode]], niente è meglio che osservare una demo funzionante. Il sondaggio seguente mostra come accedere ad attributi di domanda e risposte utilizzando ExpressionScript.

{{Note|Per questo esempio, si consiglia di disattivare l'editor HTML integrato (o di convertirlo in modalità popup) durante la modifica di questo sondaggio. L'editor HTML può impiegare un minuto o più per eseguire il rendering dei rapporti HTML di grandi dimensioni in modalità di modifica.}}

==Contenuto==

*Esempi per ogni tipo di domanda
*Sono inclusi tutti i tipi di domande che utilizzano "altro", in modo da mostrare come ciò influisca sulla denominazione delle variabili
*Valori predefiniti per tutti i tipi di domanda che accettano valori predefiniti
*Adattamento - Rapporti in pagina e fuori pagina che mostrano tutti i 16 suffissi disponibilil per EM.
*Questi report mostrano tutti i dati attualmente inseriti (quindi mostrano come generare i propri rapporti stampabili per gli utenti al posto della stampa diretta della schermata delle risposte)
*Qcode corretto e denominazione SGQA di tutte le variabili

==Screenshot==

Questo è un sondaggio enorme, quindi abbiamo scelto di non includere schermate. Consigliamo piuttosto di scaricarlo e giocarci un po'.

==Download==

Fare clic sul collegamento seguente per scaricare il sondaggio: [[Media:ls2_EM_question_attributes.lss|LS3_EM_question_attributes.lss]]

=Validazione tradizionale, rivisitata=

==Panoramica==

Dimostrazione di tutti i tipi di convalida che fanno uso di espressioni e di come esse influiscono su ciascuno dei tipi di domanda che supportano la convalida. In molti casi, i suggerimenti di convalida sono inizialmente nascosti e vengono visualizzati solo se una domanda non soddisfa i criteri di convalida (scomparendo, pertanto, una volta che la domanda superi i criteri di convalida).

==Dimostrazione dei tipi di convalida==

#[[QS:Min_num_value_n|min_num_value_n]] - valore minimo per una risposta#[[QS:Max_num_value_n|max_num_value_n]] - valore massimo per una risposta
#[[QS:Min_answers|min_answers]] - numero minimo di risposte obbligatorie
#[[QS:Max_answers|max_answers]] - numero massimo di risposte consentite
#[[QS:Multiflexible_min|multiflexible_min]] - numero minimo consentito per una risposta (per il tipo di domanda con numeri multiflexi)
#[[QS:Multiflexible_max|multiflexible_max]] - valore massimo consentito per una risposta (per il tipo di domanda con numeri multiflexi)
#[[QS:Min_num_value|min_num_value]] - valore minimo consentito per la somma di tutte le risposte alla domanda
#[[QS:Max_num_value|max_num_value]] - valore massimo consentito per la somma di tutte le risposte alla domanda
#[[QS:Equals_num_value|equals_num_value]] - la somma di tutte le risposte alla domanda deve essere pari a questo valore
#[[QS:Preg_validation|validation]] - espressione regolare di convalida per la domanda - può essere applicata a singole celle

==Screenshot==

Utilizzando nuovi stili CSS, ogni tipo di convalida mostra un suggerimento separato. Se vengono visualizzati, possono essere nascosti tramite l'opzione hide_tip. L'opzione predefinita è mostrarli con un carattere rosso se la domanda non soddisfa i criteri di convalida e verde se li supera:

<center>[[File:validation1.jpg]]</center>

Un utente non può inviare una pagina con errori di convalida. Verrà immediatamente avvertito se ha inserito informazioni errate:

<center>[[File:validation3.jpg]]</center>

La convalida può essere applicata a singole celle all'interno di un array, come in questo esempio, in cui le convalide delle espressioni regolari assicurano che ogni voce sia un numero di telefono statunitense formattato correttamente, incluso il prefisso.

<center>[[File:validation4.jpg]]</center>

==Download==

Per scaricare l'esempio precedente, fare clic sul seguente collegamento: [[Media:LS3_Validation_tests.zip|LS3_Validation_tests.zip]].

=Equazioni di convalida=

==Panoramica==

A volte è necessaria una convalida personalizzata che non può essere ottenuta utilizzando i tradizionali criteri minino/massimo. Per questo, sarà necessario utilizzare le opzioni em_validation_q e em_validation_sq, che consentono di costruire equazioni di convalida complesse rispettivamente a livello di domanda e sottodomanda.

{{Nota|A livello di sottodomanda, introduciamo anche la variabile "this" per semplificare la convalida di ogni cella in un array senza dover conoscere il nome della variabile. Per maggiori dettagli su questo aspetto, fare clic qui.}}

==Dimostrazione delle caratteristiche di EM==

#[[QS:Em_validation_q|em_validation_q]] - questa equazione determina se l'intera domanda è valida
#[[QS:Em_validation_q_tip|em_validation_q_tip]] - questo è il messaggio da mostrare se la domanda non supera i criteri di convalida em_validation_q
#[[QS:Em_validation_sq|em_validation_sq]] - questa equazione determina se ogni sottodomanda (o cella dell'array) è valida
#[[QS:Em_validation_sq_tip|em_validation_sq_tip]] - questo messaggio è mostrato se esistono sottodomande non valide.

In generale, quando si utilizza em_validation_sq, se una cella non è valida il colore di sfondo di quella cella diventa rosso per indicare che c'è un errore.

==Screenshot==

<center>[[File:sqvalidation.jpg]]</center>

Questa domanda assicura che l'età dei tuoi figli sia inserita in ordine decrescente applicando questa equazione di convalida:

<syntaxhighlight lang="php" enclose="div">q1_sq1 >= q1_sq2 && q1_sq2 >= q1_sq3 && q1_sq3 >= q1_sq4</syntaxhighlight>

<center>[[File:sqvalidation2.jpg]]</center>

<hr width="50%" style="margin:auto">

Nell'esempio seguente, la convalida garantisce che non venga data risposta a più di 3 domande su una determinata riga applicando questa equazione di convalida:

<syntaxhighlight lang="php" enclose="div">(sum(Test_A_1, Test_A_2, Test_A_3, Test_A_4, Test_A_5) <= 3) && (sum(Test_B_1, Test_B_2, Test_B_3, Test_B_4, Test_B_5) <= 3) && (sum(Test_C_1, Test_C_2, Test_C_3, Test_C_4, Test_C_5) <= 3)</syntaxhighlight>

Si può anche scrivere come segue e Limesurvey convertirà il tutto automaticamente a run-time nella espressione elencata sopra.

<syntaxhighlight lang="php" enclose="div">(sum(self.sq_A) <= 3) && (sum(self.sq_B) <= 3) && (sum(self.sq_C) <= 3)</syntaxhighlight>

<center>[[File:sqvalidation3.jpg]]</center>

==Download==

Per scaricare il sondaggio di esempio utilizzato negli esempi precedenti, agire sul link seguente: [[Media:ls2_test_em_sq_validation.lss|ls2_test_em_sq_validation.lss]].

=Rilevanza per sottodomande=

==Panoramica==

Questa sezione mostra come possono interagire array_filter e criteri di convalida. Per le convalide che si applicano alle somme, vengono considerati solo i valori rilevanti (visibili).

==Dimostrazione delle caratteristiche di EM==

#[[QS:Array_filter|array_filter]]
#[[QS:Array filter exclude|array_filter_exclude]]
#[[QS:Min_num_value|min_num_value]]
#[[QS:Max num value|max_num_value]]
#[[QS:equals_num_value|equals_num_value]]

Mostra anche il reporting dinamico del numero di domande a cui è stata data risposta nelle domande principali.

==Screenshot==

La modifica del numero di righe visibili cambia dinamicamente la somma. Contrassegnare una sottodomanda come non rilevante non ne cancella il valore. Piuttosto, se non è rilevante, i suoi valori non contribuiscono a nessuna equazione.

<center>[[File:sqrel1.jpg]][[File:Sqrelver12.png]]</center>

Si noti cosa accade quando si seleziona l'opzione "Fifth subquestion" per la prima domanda '''"Which rows should appear below"'''. La somma della seconda domanda "Enter some numbers" ora è 5. Anche se la sottodomanda 5 ha ancora il vaore 14 (cioè, se si deseleziona la quinda sottodomanda, si vedrà nuovamente il valore 14), quel valore non contribuisce alla somma perché considerato non rilevante. Tutti i dati non rilevanti sono cancellati (segnati nel database come NULL) al momento dell'invio, ma il valore resta disponibile sulla pagina nel caso gli utenti vogliano o debbano cambiare idea sulle risposte.

<center>[[File:sqrel2.jpg]]</center>

==Download==

Utilizzare il seguente link per scaricare il nostro esempio: [[Media:ls2_subquestion_relevance.lss|ls2_subquestion_relevance.lss]].

=Utilizzo della virgola come separatore di radice (punto decimale)=

==Panoramica==

ExpressionScript garantisce che solo i numeri validi possano essere inseriti nei campi numerici. Se si inserisce un numero non valido, si viene avvisati che qualcosa non va (ad esempio, nel caso del tema "fruity", l'intera domanda viene scritta in carattere rosso).

Si noti che i valori numerici vengono sempre convertiti utilizzando un punto come separatore all'interno del database. In questo modo, le analisi statistiche funzioneranno in modo appropriato.

Per cambiare il separatore decimale, accedere alle opzioni [[Text elements|Elementi di testo]] che si trovano nel menù [[Survey_settings|Impostazioni]] e cercare la funzionalità [[Text_elements#Survey_text_elements_panel|Simbolo del decimale]].

{{Note|Per ulteriori informazioni sul punto decimale, si veda la pagina wiki [https://en.wikipedia.org/wiki/Radix_point|Radix_point] (in inglese).}}

==Tipi di domande che utilizzano il punto decimale==

#[[Question type - Numerical input|Inserimento numerico]] <nowiki>[</nowiki>N]
#[[Question type - Multiple numerical input|Inserimento numerico multiplo]] <nowiki>[</nowiki>K]
#[[Question type - Array (Numbers)|Array (Numeri)]] <nowiki>[</nowiki>:]
#[[Question type - Array (Texts)|Array (Testo)]] <nowiki>[</nowiki>;], utilizzando l'attributo [[QS:Numbers_only|numbers_only]]
#[[Question type - List (Radio)|List (radio)]] <nowiki>[</nowiki>L], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Short free text|Testo breve]] <nowiki>[</nowiki>S], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Multiple short text|Testo breve multiplo]] <nowiki>[</nowiki>Q], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Multiple choice|Scelta multipla]] <nowiki>[</nowiki>M], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Multiple choice with comments|Scelta multipla con commenti]] <nowiki>[</nowiki>P], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]

==Screenshot==

Si può notare negli screenshot qui sotto che la virgola può essere utilizzata come punto decimale.

<center>[[File:radix1.jpg]]</center>

==Download==

Per scaricare l'esempio precedente, fare clic sul link seguente: [[Media:ls2_comma_as_radix_separator.lss|ls2_comma_as_radix_separator.lss]].

=Gruppi di randomizzazione=

==Panoramica==

Questo sondaggio mostra come utilizzare l'attributo '''random_group'''.

Se viene utilizzato questo attributo, ogni volta che si avvia il sondaggio l'ordine delle domande viene randomizzato. Tuttavia, una volta avviato il sondaggio, l'ordine di randomizzazione rimane fisso, anche se si cambia lingua.

==Screenshot==

Guardiamo insieme l'esempio seguente. La prima domanda casuale sulla pagina sarà Q1, Q4 o Q7. La seconda domanda randomizzata sulla pagina sarà Q2, Q5 o Q8.

<center>[[File:random1.jpg]]</center>

Ecco la randomizzazione generata la prima volta che ho testato questo sondaggio.

<center>[[File:random2.jpg]]</center>

La seconda volta che ho testato il sondaggio è stata generata una diversa randomizzazione.

<center>[[File:random3.jpg]]</center>

Ma, quando sono passato al francese (senza ricominciare il sondaggio), l'ordine di randomizzazione è rimasto intatto.

<center>[[File:random4.jpg]]</center>

==Download==

Per scaricare l'esempio precedente, fare clic sul link seguente: [[Media:Randomization_Group_Test.lss|Randomization_Group_Test.lss]]

=Presentare una sola domanda a caso per gruppo=

==Panoramica==

Questo sondaggio mostra come configurare un sondaggio per visualizzare in modo casuale una domanda per gruppo. In esso ci sono 5 gruppi di 6 domande ciascuno. All'inizio, nel Gruppo 0, vengono compilate cinque domande nascoste di equazioni, chiamate ask1-ask5. Ognuna ha il valore di {floor(rand(1,6.9999))} nel campo di testo della domanda, il che significa che le variabili ask1-ask5 avranno ciascuna un valore compreso tra 1 e 6. Quindi, ogni domanda nel gruppo ha un equazione di rilevanza come "ask1 == N", dove N è l'ennesima domanda nel gruppo (quindi la terza domanda nel gruppo 1 ha l'equazione di rilevanza "ask1 == 3").

Questo sondaggio funziona altrettanto bene nelle modalità "un sondaggio alla volta", "gruppo per gruppo" e "domanda per domanda". Poiché la randomizzazione è impostata nel primo gruppo e quel gruppo è effettivamente nascosto (dal momento che tutte le domande ask1-ask5 sono nascoste), la randomizzazione rimane la stessa per ciascun soggetto; ma ogni soggetto diverso avrà una randomizzazione distinta.

==Dimostrazione delle caratteristiche==

#[[Question type - Equation|Tipo di domanda dell'equazione]]
#Funzioni di randomizzazione
#Funzione condizionale (if)

==Screenshot==

Questo è il Gruppo0, che utilizza il [[Question type - Equation|Tipo di domanda equazione]] per selezionare valori casuali da 1 a 6 per ogni gruppo (eccetto l'ultimo gruppo, che ha solo 4 domande). Nota che la funzione "if()" controlla prima se ask1 è già stato impostato e, in tal caso, utilizza quel valore. Se il valore non è stato impostato, utilizza un valore casuale per impostare il valore di ask1.

<center>[[File:randq3.jpg]]</center>

Questo gruppo mostra come la variabile (ask4) del Gruppo0 viene utilizzata per controllare quale domanda è visibile all'interno del quarto gruppo.

<center>[[File:randq2.jpg]]</center>

==Download==

Per scaricare il sondaggio di esempio precedente, fare clic qui: [[Media: limesurvey_survey_55164.lss|Esempio di domande casuali all'interno di un gruppo]].

=Porre a caso un numero specifico di domande in un gruppo (un sottoinsieme delle domande)=

{{Avviso|Questo si applica solo a tutte le domande casuali di un gruppo e solo se viene utilizzato il formato [[General_settings # General_settings_panel |Un gruppo per pagina oppure Tutte le domande in una pagina]].}}

==Panoramica==

Questo sondaggio mostra come porre un sottoinsieme casuale di domande in un gruppo. Ad esempio, mostra 5 domande casuali su 10 domande situate all'interno di un gruppo.

Il sondaggio ha un gruppo contenente 10 domande. A tutte le domande viene assegnato lo stesso [[QS: Random_group|nome del gruppo di randomizzazione]]. Di conseguenza, verranno visualizzate in ordine casuale al caricamento della pagina. A ogni domanda viene assegnata un'equazione di rilevanza secondo cui la somma di "[[ExpressionScript - Presentation#Access to Variables|relevanceStatus]]" di tutte le altre domande nel gruppo è inferiore al numero di domande che si desidera mostrare. Poiché "[[ExpressionScript - Presentation#Access to Variables|relevanceStatus]]" viene assegnato durante il rendering delle domande, questo corrisponde effettivamente al numero di domande precedenti.

Quindi, nel nostro esempio "5 su 10", l'equazione per Q1 sarebbe:

<syntaxhighlight lang="php" enclose="div">sum(Q2.relevanceStatus, Q3.relevanceStatus, Q4.relevanceStatus, Q5.relevanceStatus, Q6.relevanceStatus, Q7.relevanceStatus, Q8.relevanceStatus, Q9.relevanceStatus, Q10.relevanceStatus) LT 5</syntaxhighlight>

Per Q2, sarebbe:

<syntaxhighlight lang="php" enclose="div">sum(Q1.relevanceStatus, Q3.relevanceStatus, Q4.relevanceStatus, Q5.relevanceStatus, Q6.relevanceStatus, Q7.relevanceStatus, Q8.relevanceStatus, Q9.relevanceStatus, Q10.relevanceStatus) LT 5</syntaxhighlight>

E così via...

==Dimostrazione delle caratteristiche==

#[[ExpressionScript - Presentation#Access to variables|variabile relevanceStatus]]
#[[QS:Random group|Randomizzazione]]

==Download==

Per scaricare l'esempio precedente, fare clic sul link seguente: [[Media:Random_5_out_of_10.lss|Random 5 out of 10 survey example]].

=Classificazione di un elenco di prodotti inserito dall'utente=

==Panoramica==

L'esempio seguente mostra come chiedere agli utenti di elencare una serie di prodotti che li interessano e quindi chiedere loro di valutarli.

==Dimostrazione delle caratteristiche di ES==

#'''Personalizzazione delle risposte''' - quando si valutano i prodotti, le etichette provengono dal campo dei commenti della precedente domanda a scelta multipla
# '''Scale personalizzate''' - molte opzioni avanzate delle domande, come i titoli delle scale, possono essere anche personalizzate.

==Screenshot==

Questa immagine mostra che, essendo stati selezionati solo i prodotti 1,3 e 5, vengono visualizzati solo quei tre (utilizzando l'attributo [[QS: Array_filter|array_filter]]). Inoltre, le etichette delle righe nella seconda domanda sono i numeri di prodotto (se non viene inserito nulla nel campo dei commenti) o il contenuto dei campi dei commenti.

<center>[[File:mcc_filter1.jpg]]</center>

Questa immagine mostra come vengono specificate le risposte su misura:

<center>[[File:mcc_filter2.jpg]]</center>

Ecco il File della logica per quella domanda, che ci consente di verificare che la logica condizionale funzioni come desiderato (ad esempio, per vedere se ci sono errori di sintassi):

<center>[[File:mcc_filter3.jpg]]</center>

L'immagine successiva mostra un gruppo in cui si specifica una scala di valutazione a 5 punti (Opzioni 1-5), il titolo della scala e i prodotti che si desidera valutare. L'ultima domanda mostra che ciascuna delle parti della domanda di tipo array può essere adattata:

<center>[[File:mcc_filter4.jpg]]</center>

L'immagine successiva mostra la visualizzazione del File della logica per l'ultima domanda. Come si può osservare, le domande secondarie, le risposte e le intestazioni di scala possono essere personalizzate.

<center>[[File:mcc_filter5.jpg]]</center>

==Download==

To download the survey example from above, click on the following link: [[Media:Rating_User-Entered_List_of_Products_Survey.zip|Rating user-entered list of products survey example]].

Translations:ExpressionScript sample surveys/176/it

2020-10-19T03:21:19Z

L'immagine successiva mostra la visualizzazione del File della logica per l'ultima domanda. Come si può osservare, le domande secondarie, le risposte e le intestazioni di scala possono essere personalizzate.

Translations:ExpressionScript sample surveys/175/it

2020-10-19T03:20:47Z

Ritapas: Created page with "<center>File:mcc_filter4.jpg</center>"

<center>[[File:mcc_filter4.jpg]]</center>

ExpressionScript sample surveys/it

2020-10-19T03:20:47Z

Ritapas: Created page with "L'immagine successiva mostra un gruppo in cui si specifica una scala di valutazione a 5 punti (Opzioni 1-5), il titolo della scala e i prodotti che si desidera valutare. L'ult..."

<languages />

__TOC__

=Introduzione=

il modo migliore per imparare ad usare ExpressionScript è provare esempi funzionanti e modificarli secondo le proprie esigenze.

Nel testo seguente sono disponibili alcuni sondaggi di esempi per valutare come si può usare EM per migliorare i propri sondaggi. Questi sondaggi sono anche disponibili nella directory /docs/demosurvey della distribuzione.

=Rilevanza, Adattamento ed Equazioni=

==Panoramica==

L'esempio seguente calcola l'IMC (Indice di Massa Corporea, in inglese Body Mass Index) del partecipante. L'esempio mostra diverse caratteristiche, illustrate più avanti.

==Dimostrazione delle caratteristiche dell'EM==

#'''Rilevanza''' - supporto per logica condizionale "potente";
#'''Piping / Tailoring''' - offre la possibilità di concatenare o adattare le risposte e i metadati delle domande;
#'''Adattamento Dinamico''' - report che cambiano sulla pagina stesas mentre si digitano le risposte.
#'''Micro-Tailoring''' - adattamento condizionale all'interno di frasi e report con l'utilizzo di istruzioni if()
#'''Equazioni''' - un nuovo [[Question type - Equation|tipo di domanda]] che consente l'esecuzione di calcoli, anche nascosti, e la conservazione dei risultati sul database
#'''Convalida dondizionale''' - criteri di convalida, come ad esempio il valore minimo accettabile, possono essere ora condizionali, vale a dire basati su equazioni.

==Screenshot==

Questo esempio calcola l'Indice di Massa Corporea, un indice basato sul peso e l'altezza che determina se si è sottopeso, normopeso, sovrappeso o obesi. All'inizio, sono mostrate solo le quattro domande obbligatorie.

<center>[[File:tailoring1.jpg]]</center>

Dopo aver inserito le informazioni (ed aver scelto se si desidera utilizzare unità metriche o meno), è mostrato un report personalizzato che riassume i dati inseriti e mostra l'indicatore dello stato di peso forma.

<center>[[File:tailoring2.jpg]]</center>

Ecco un altro esempio, che utilizza unità non metriche per mostrare come i risultati cambiano dinamicamente:

<center>[[File:tailoring3.jpg]]</center>

Sono state inserite [[Question type - Equation|domande nascoste di tipo Equazione]] per convertire i dati nel sistema metrico, quando appropriato. In queste domande sono conservati altezza e peso in unità metriche, che confluiscono nella base dati, con l'indice IMC e lo stato di peso forma, senza che si debba creare codice JavaScript personalizzato.

Negli esempi successivi è mostrato come mostrare funzioni, matematiche o d'altro tipo, all'interno di report personalizzati.
Prima dell'inserimento di dati, la pagina appare in questo modo.
Grazie alla logica condizionale, se non sono presenti dati numerici le celle restano vuote invece di mostrare "NaN" o "Divide by Zero".

<center>[[File:tailoring4.jpg]]</center>

Dopo che sono stati inseriti i numeri, il report della pagina è modificato e mostra il calcolo eseguito e il suo risultato.

<center>[[File:tailoring5.jpg]]</center>

Nel sondaggio di esempio sono presenti molti altri esempi. Ad esempio, nella schermata seguente è mostrata una delle tante maniere nelle quali è possibile compilare la pagina Dynamic Relevance.
Come illustrato nelle note, è possibile provare a inserite diverse età e, in particolare, all'inserimento di combinazioni incompatibili di risposte sono mostrati messaggi divertenti.
Si noti anche che se si dichiara di avere più di un figlio, il messaggio dirà "I hope you enjoy playing with your X children" ("spero che ti diverta a giocare con i tuoi X bambini"), piuttosto che declinare la frase al singolare. Con questo si mostra come si possono personalizzare singole frasi per adattarle al genere e/o al numero dei sostantivi utilizzati, come anche si possono anche coniugare facilmente verbi.

<center>[[File:tailoring6.jpg]]</center>

==Download==

Per scaricare il sondaggio di esempio, utilizzare il link seguente: [[Media:LS3_em_tailoring.zip|LS3_em_tailoring.zip]].

=Sample Census=

=Introduzione=

Questo è un esempio di censimento nel quale si chiede quante persone costituiscono il nucleo familiare.

Mostra in che modo è possibile utilizzare la rilevanza a livello di gruppo per implementare facilmente la ripetizione ciclica di domande ("loop"). Dopo aver creato il gruppo per "Person 1", questo è stato esportato. Avendo utilizzato nomi di variabile qcode del tipo p1_name, si è potuto utilizzare un editor di testo per modificare velocemente e re-importare i gruppi più volte: sono stati sufficienti 10 secondi per modificare e re-importare ogni nuovo gruppo mantenendo nomi unici per le variabili e logica corretta a livello di gruppo.

Sarebbe stato possibile utilizzare anche l'opzione [[Copy question|copia domanda]] ma l'opzione mostrata è più rapida.

Si vede anche come evitare che il messaggio di Fine compilazione appaia solo quando il sondaggio è effettivamente terminato (vale a dire, quando tutti i gruppi obbligatori sono completati).

==Dimostrazione delle caratteristiche di EM==

#'''Rilevanza a livello di gruppi''' - I gruppi successivi ("Person 1-5") sono mostrati solo fino al numero di conviventi specificati;
#'''Adattamento''' - Il report finale riassume i dati demografici di ciascun convivente;
#'''Visualizzazione progressiva delle domande''' - Sia in gruppo che in modalità pagina singola, le domande successive sono mostrate mano a mano che le precedenti ricevono una risposta.

==Screenshot==

Il sondaggio produce un report dinamico nel quale sono mostrati i dati demografici dello specifico numero di conviventi:

<center>[[File:census.jpg]]</center>

Se il sondaggio è mostrato una domanda alla volta, si vede che l'indice si adatta alle domande. Dal momento che l'utente ha scritto che la persona è una donna, la domanda (in inglese) è declinata al femminile. E visto che è stato inserito il suo nome, "Mary", la domanda successiva chiede "How old is Mary?" ("Quanti anni ha Mary?").

<center>[[File:census2.jpg]]</center>

==Download==

Usare il link seguente per scaricare il sondaggio di esempio: [[Media:LS3_group_relevance.zip|LS3_group_relevance.zip]].

=Filtri concatenati per Array=

==Panoramica==

Il sondaggio seguente si basa su un originale gentilmente concesso da Joy Lane Research, LLC.

==Screenshot==

Nelle immagini seguenti, notare che.
*Q2 mostra solo i prodotti selezionati (con array_filter) in Q01
*Q02 mostra anche "Another product", ovvero il testo inserito nel campo "Other electronic" di Q01
*Q04 mostra solo prodotti in Q02 che sono stati selezionati (filtraggio concatenato)
*Q05 mostra solo prodotti in Q02 che NON sono stati selezioati in Q02 (filtraggio concatenato che utilizza array_filter_exclude)

<center>[[File:cascading_array_filter.jpg]]</center>

<center>[[File:cascading_array_filter2.jpg]]</center>

==Download==

Utilizzare il seguente link per scaricare l'esempio precedente:[[Media:ls2_cascading_array_filter.lss|LS2_cascading_array_filter sondaggio di esempio]].

=Adattamento/Piping utilizzando tutti i tipi di domanda e attributi=

==Panoramica==

Se siete confusi su come nominare le vostre variabili (SGQA o Qcode), non siete soli. Anche se la documentazione descrive [[ExpressionScript - Presentation#Access to Variables|come comporre nomi di variabile Qcode]], niente è meglio che osservare una demo funzionante. Il sondaggio seguente mostra come accedere ad attributi di domanda e risposte utilizzando ExpressionScript.

{{Note|Per questo esempio, si consiglia di disattivare l'editor HTML integrato (o di convertirlo in modalità popup) durante la modifica di questo sondaggio. L'editor HTML può impiegare un minuto o più per eseguire il rendering dei rapporti HTML di grandi dimensioni in modalità di modifica.}}

==Contenuto==

*Esempi per ogni tipo di domanda
*Sono inclusi tutti i tipi di domande che utilizzano "altro", in modo da mostrare come ciò influisca sulla denominazione delle variabili
*Valori predefiniti per tutti i tipi di domanda che accettano valori predefiniti
*Adattamento - Rapporti in pagina e fuori pagina che mostrano tutti i 16 suffissi disponibilil per EM.
*Questi report mostrano tutti i dati attualmente inseriti (quindi mostrano come generare i propri rapporti stampabili per gli utenti al posto della stampa diretta della schermata delle risposte)
*Qcode corretto e denominazione SGQA di tutte le variabili

==Screenshot==

Questo è un sondaggio enorme, quindi abbiamo scelto di non includere schermate. Consigliamo piuttosto di scaricarlo e giocarci un po'.

==Download==

Fare clic sul collegamento seguente per scaricare il sondaggio: [[Media:ls2_EM_question_attributes.lss|LS3_EM_question_attributes.lss]]

=Validazione tradizionale, rivisitata=

==Panoramica==

Dimostrazione di tutti i tipi di convalida che fanno uso di espressioni e di come esse influiscono su ciascuno dei tipi di domanda che supportano la convalida. In molti casi, i suggerimenti di convalida sono inizialmente nascosti e vengono visualizzati solo se una domanda non soddisfa i criteri di convalida (scomparendo, pertanto, una volta che la domanda superi i criteri di convalida).

==Dimostrazione dei tipi di convalida==

#[[QS:Min_num_value_n|min_num_value_n]] - valore minimo per una risposta#[[QS:Max_num_value_n|max_num_value_n]] - valore massimo per una risposta
#[[QS:Min_answers|min_answers]] - numero minimo di risposte obbligatorie
#[[QS:Max_answers|max_answers]] - numero massimo di risposte consentite
#[[QS:Multiflexible_min|multiflexible_min]] - numero minimo consentito per una risposta (per il tipo di domanda con numeri multiflexi)
#[[QS:Multiflexible_max|multiflexible_max]] - valore massimo consentito per una risposta (per il tipo di domanda con numeri multiflexi)
#[[QS:Min_num_value|min_num_value]] - valore minimo consentito per la somma di tutte le risposte alla domanda
#[[QS:Max_num_value|max_num_value]] - valore massimo consentito per la somma di tutte le risposte alla domanda
#[[QS:Equals_num_value|equals_num_value]] - la somma di tutte le risposte alla domanda deve essere pari a questo valore
#[[QS:Preg_validation|validation]] - espressione regolare di convalida per la domanda - può essere applicata a singole celle

==Screenshot==

Utilizzando nuovi stili CSS, ogni tipo di convalida mostra un suggerimento separato. Se vengono visualizzati, possono essere nascosti tramite l'opzione hide_tip. L'opzione predefinita è mostrarli con un carattere rosso se la domanda non soddisfa i criteri di convalida e verde se li supera:

<center>[[File:validation1.jpg]]</center>

Un utente non può inviare una pagina con errori di convalida. Verrà immediatamente avvertito se ha inserito informazioni errate:

<center>[[File:validation3.jpg]]</center>

La convalida può essere applicata a singole celle all'interno di un array, come in questo esempio, in cui le convalide delle espressioni regolari assicurano che ogni voce sia un numero di telefono statunitense formattato correttamente, incluso il prefisso.

<center>[[File:validation4.jpg]]</center>

==Download==

Per scaricare l'esempio precedente, fare clic sul seguente collegamento: [[Media:LS3_Validation_tests.zip|LS3_Validation_tests.zip]].

=Equazioni di convalida=

==Panoramica==

A volte è necessaria una convalida personalizzata che non può essere ottenuta utilizzando i tradizionali criteri minino/massimo. Per questo, sarà necessario utilizzare le opzioni em_validation_q e em_validation_sq, che consentono di costruire equazioni di convalida complesse rispettivamente a livello di domanda e sottodomanda.

{{Nota|A livello di sottodomanda, introduciamo anche la variabile "this" per semplificare la convalida di ogni cella in un array senza dover conoscere il nome della variabile. Per maggiori dettagli su questo aspetto, fare clic qui.}}

==Dimostrazione delle caratteristiche di EM==

#[[QS:Em_validation_q|em_validation_q]] - questa equazione determina se l'intera domanda è valida
#[[QS:Em_validation_q_tip|em_validation_q_tip]] - questo è il messaggio da mostrare se la domanda non supera i criteri di convalida em_validation_q
#[[QS:Em_validation_sq|em_validation_sq]] - questa equazione determina se ogni sottodomanda (o cella dell'array) è valida
#[[QS:Em_validation_sq_tip|em_validation_sq_tip]] - questo messaggio è mostrato se esistono sottodomande non valide.

In generale, quando si utilizza em_validation_sq, se una cella non è valida il colore di sfondo di quella cella diventa rosso per indicare che c'è un errore.

==Screenshot==

<center>[[File:sqvalidation.jpg]]</center>

Questa domanda assicura che l'età dei tuoi figli sia inserita in ordine decrescente applicando questa equazione di convalida:

<syntaxhighlight lang="php" enclose="div">q1_sq1 >= q1_sq2 && q1_sq2 >= q1_sq3 && q1_sq3 >= q1_sq4</syntaxhighlight>

<center>[[File:sqvalidation2.jpg]]</center>

<hr width="50%" style="margin:auto">

Nell'esempio seguente, la convalida garantisce che non venga data risposta a più di 3 domande su una determinata riga applicando questa equazione di convalida:

<syntaxhighlight lang="php" enclose="div">(sum(Test_A_1, Test_A_2, Test_A_3, Test_A_4, Test_A_5) <= 3) && (sum(Test_B_1, Test_B_2, Test_B_3, Test_B_4, Test_B_5) <= 3) && (sum(Test_C_1, Test_C_2, Test_C_3, Test_C_4, Test_C_5) <= 3)</syntaxhighlight>

Si può anche scrivere come segue e Limesurvey convertirà il tutto automaticamente a run-time nella espressione elencata sopra.

<syntaxhighlight lang="php" enclose="div">(sum(self.sq_A) <= 3) && (sum(self.sq_B) <= 3) && (sum(self.sq_C) <= 3)</syntaxhighlight>

<center>[[File:sqvalidation3.jpg]]</center>

==Download==

Per scaricare il sondaggio di esempio utilizzato negli esempi precedenti, agire sul link seguente: [[Media:ls2_test_em_sq_validation.lss|ls2_test_em_sq_validation.lss]].

=Rilevanza per sottodomande=

==Panoramica==

Questa sezione mostra come possono interagire array_filter e criteri di convalida. Per le convalide che si applicano alle somme, vengono considerati solo i valori rilevanti (visibili).

==Dimostrazione delle caratteristiche di EM==

#[[QS:Array_filter|array_filter]]
#[[QS:Array filter exclude|array_filter_exclude]]
#[[QS:Min_num_value|min_num_value]]
#[[QS:Max num value|max_num_value]]
#[[QS:equals_num_value|equals_num_value]]

Mostra anche il reporting dinamico del numero di domande a cui è stata data risposta nelle domande principali.

==Screenshot==

La modifica del numero di righe visibili cambia dinamicamente la somma. Contrassegnare una sottodomanda come non rilevante non ne cancella il valore. Piuttosto, se non è rilevante, i suoi valori non contribuiscono a nessuna equazione.

<center>[[File:sqrel1.jpg]][[File:Sqrelver12.png]]</center>

Si noti cosa accade quando si seleziona l'opzione "Fifth subquestion" per la prima domanda '''"Which rows should appear below"'''. La somma della seconda domanda "Enter some numbers" ora è 5. Anche se la sottodomanda 5 ha ancora il vaore 14 (cioè, se si deseleziona la quinda sottodomanda, si vedrà nuovamente il valore 14), quel valore non contribuisce alla somma perché considerato non rilevante. Tutti i dati non rilevanti sono cancellati (segnati nel database come NULL) al momento dell'invio, ma il valore resta disponibile sulla pagina nel caso gli utenti vogliano o debbano cambiare idea sulle risposte.

<center>[[File:sqrel2.jpg]]</center>

==Download==

Utilizzare il seguente link per scaricare il nostro esempio: [[Media:ls2_subquestion_relevance.lss|ls2_subquestion_relevance.lss]].

=Utilizzo della virgola come separatore di radice (punto decimale)=

==Panoramica==

ExpressionScript garantisce che solo i numeri validi possano essere inseriti nei campi numerici. Se si inserisce un numero non valido, si viene avvisati che qualcosa non va (ad esempio, nel caso del tema "fruity", l'intera domanda viene scritta in carattere rosso).

Si noti che i valori numerici vengono sempre convertiti utilizzando un punto come separatore all'interno del database. In questo modo, le analisi statistiche funzioneranno in modo appropriato.

Per cambiare il separatore decimale, accedere alle opzioni [[Text elements|Elementi di testo]] che si trovano nel menù [[Survey_settings|Impostazioni]] e cercare la funzionalità [[Text_elements#Survey_text_elements_panel|Simbolo del decimale]].

{{Note|Per ulteriori informazioni sul punto decimale, si veda la pagina wiki [https://en.wikipedia.org/wiki/Radix_point|Radix_point] (in inglese).}}

==Tipi di domande che utilizzano il punto decimale==

#[[Question type - Numerical input|Inserimento numerico]] <nowiki>[</nowiki>N]
#[[Question type - Multiple numerical input|Inserimento numerico multiplo]] <nowiki>[</nowiki>K]
#[[Question type - Array (Numbers)|Array (Numeri)]] <nowiki>[</nowiki>:]
#[[Question type - Array (Texts)|Array (Testo)]] <nowiki>[</nowiki>;], utilizzando l'attributo [[QS:Numbers_only|numbers_only]]
#[[Question type - List (Radio)|List (radio)]] <nowiki>[</nowiki>L], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Short free text|Testo breve]] <nowiki>[</nowiki>S], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Multiple short text|Testo breve multiplo]] <nowiki>[</nowiki>Q], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Multiple choice|Scelta multipla]] <nowiki>[</nowiki>M], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Multiple choice with comments|Scelta multipla con commenti]] <nowiki>[</nowiki>P], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]

==Screenshot==

Si può notare negli screenshot qui sotto che la virgola può essere utilizzata come punto decimale.

<center>[[File:radix1.jpg]]</center>

==Download==

Per scaricare l'esempio precedente, fare clic sul link seguente: [[Media:ls2_comma_as_radix_separator.lss|ls2_comma_as_radix_separator.lss]].

=Gruppi di randomizzazione=

==Panoramica==

Questo sondaggio mostra come utilizzare l'attributo '''random_group'''.

Se viene utilizzato questo attributo, ogni volta che si avvia il sondaggio l'ordine delle domande viene randomizzato. Tuttavia, una volta avviato il sondaggio, l'ordine di randomizzazione rimane fisso, anche se si cambia lingua.

==Screenshot==

Guardiamo insieme l'esempio seguente. La prima domanda casuale sulla pagina sarà Q1, Q4 o Q7. La seconda domanda randomizzata sulla pagina sarà Q2, Q5 o Q8.

<center>[[File:random1.jpg]]</center>

Ecco la randomizzazione generata la prima volta che ho testato questo sondaggio.

<center>[[File:random2.jpg]]</center>

La seconda volta che ho testato il sondaggio è stata generata una diversa randomizzazione.

<center>[[File:random3.jpg]]</center>

Ma, quando sono passato al francese (senza ricominciare il sondaggio), l'ordine di randomizzazione è rimasto intatto.

<center>[[File:random4.jpg]]</center>

==Download==

Per scaricare l'esempio precedente, fare clic sul link seguente: [[Media:Randomization_Group_Test.lss|Randomization_Group_Test.lss]]

=Presentare una sola domanda a caso per gruppo=

==Panoramica==

Questo sondaggio mostra come configurare un sondaggio per visualizzare in modo casuale una domanda per gruppo. In esso ci sono 5 gruppi di 6 domande ciascuno. All'inizio, nel Gruppo 0, vengono compilate cinque domande nascoste di equazioni, chiamate ask1-ask5. Ognuna ha il valore di {floor(rand(1,6.9999))} nel campo di testo della domanda, il che significa che le variabili ask1-ask5 avranno ciascuna un valore compreso tra 1 e 6. Quindi, ogni domanda nel gruppo ha un equazione di rilevanza come "ask1 == N", dove N è l'ennesima domanda nel gruppo (quindi la terza domanda nel gruppo 1 ha l'equazione di rilevanza "ask1 == 3").

Questo sondaggio funziona altrettanto bene nelle modalità "un sondaggio alla volta", "gruppo per gruppo" e "domanda per domanda". Poiché la randomizzazione è impostata nel primo gruppo e quel gruppo è effettivamente nascosto (dal momento che tutte le domande ask1-ask5 sono nascoste), la randomizzazione rimane la stessa per ciascun soggetto; ma ogni soggetto diverso avrà una randomizzazione distinta.

==Dimostrazione delle caratteristiche==

#[[Question type - Equation|Tipo di domanda dell'equazione]]
#Funzioni di randomizzazione
#Funzione condizionale (if)

==Screenshot==

Questo è il Gruppo0, che utilizza il [[Question type - Equation|Tipo di domanda equazione]] per selezionare valori casuali da 1 a 6 per ogni gruppo (eccetto l'ultimo gruppo, che ha solo 4 domande). Nota che la funzione "if()" controlla prima se ask1 è già stato impostato e, in tal caso, utilizza quel valore. Se il valore non è stato impostato, utilizza un valore casuale per impostare il valore di ask1.

<center>[[File:randq3.jpg]]</center>

Questo gruppo mostra come la variabile (ask4) del Gruppo0 viene utilizzata per controllare quale domanda è visibile all'interno del quarto gruppo.

<center>[[File:randq2.jpg]]</center>

==Download==

Per scaricare il sondaggio di esempio precedente, fare clic qui: [[Media: limesurvey_survey_55164.lss|Esempio di domande casuali all'interno di un gruppo]].

=Porre a caso un numero specifico di domande in un gruppo (un sottoinsieme delle domande)=

{{Avviso|Questo si applica solo a tutte le domande casuali di un gruppo e solo se viene utilizzato il formato [[General_settings # General_settings_panel |Un gruppo per pagina oppure Tutte le domande in una pagina]].}}

==Panoramica==

Questo sondaggio mostra come porre un sottoinsieme casuale di domande in un gruppo. Ad esempio, mostra 5 domande casuali su 10 domande situate all'interno di un gruppo.

Il sondaggio ha un gruppo contenente 10 domande. A tutte le domande viene assegnato lo stesso [[QS: Random_group|nome del gruppo di randomizzazione]]. Di conseguenza, verranno visualizzate in ordine casuale al caricamento della pagina. A ogni domanda viene assegnata un'equazione di rilevanza secondo cui la somma di "[[ExpressionScript - Presentation#Access to Variables|relevanceStatus]]" di tutte le altre domande nel gruppo è inferiore al numero di domande che si desidera mostrare. Poiché "[[ExpressionScript - Presentation#Access to Variables|relevanceStatus]]" viene assegnato durante il rendering delle domande, questo corrisponde effettivamente al numero di domande precedenti.

Quindi, nel nostro esempio "5 su 10", l'equazione per Q1 sarebbe:

<syntaxhighlight lang="php" enclose="div">sum(Q2.relevanceStatus, Q3.relevanceStatus, Q4.relevanceStatus, Q5.relevanceStatus, Q6.relevanceStatus, Q7.relevanceStatus, Q8.relevanceStatus, Q9.relevanceStatus, Q10.relevanceStatus) LT 5</syntaxhighlight>

Per Q2, sarebbe:

<syntaxhighlight lang="php" enclose="div">sum(Q1.relevanceStatus, Q3.relevanceStatus, Q4.relevanceStatus, Q5.relevanceStatus, Q6.relevanceStatus, Q7.relevanceStatus, Q8.relevanceStatus, Q9.relevanceStatus, Q10.relevanceStatus) LT 5</syntaxhighlight>

E così via...

==Dimostrazione delle caratteristiche==

#[[ExpressionScript - Presentation#Access to variables|variabile relevanceStatus]]
#[[QS:Random group|Randomizzazione]]

==Download==

Per scaricare l'esempio precedente, fare clic sul link seguente: [[Media:Random_5_out_of_10.lss|Random 5 out of 10 survey example]].

=Classificazione di un elenco di prodotti inserito dall'utente=

==Panoramica==

L'esempio seguente mostra come chiedere agli utenti di elencare una serie di prodotti che li interessano e quindi chiedere loro di valutarli.

==Dimostrazione delle caratteristiche di ES==

#'''Personalizzazione delle risposte''' - quando si valutano i prodotti, le etichette provengono dal campo dei commenti della precedente domanda a scelta multipla
# '''Scale personalizzate''' - molte opzioni avanzate delle domande, come i titoli delle scale, possono essere anche personalizzate.

==Screenshot==

Questa immagine mostra che, essendo stati selezionati solo i prodotti 1,3 e 5, vengono visualizzati solo quei tre (utilizzando l'attributo [[QS: Array_filter|array_filter]]). Inoltre, le etichette delle righe nella seconda domanda sono i numeri di prodotto (se non viene inserito nulla nel campo dei commenti) o il contenuto dei campi dei commenti.

<center>[[File:mcc_filter1.jpg]]</center>

Questa immagine mostra come vengono specificate le risposte su misura:

<center>[[File:mcc_filter2.jpg]]</center>

Ecco il File della logica per quella domanda, che ci consente di verificare che la logica condizionale funzioni come desiderato (ad esempio, per vedere se ci sono errori di sintassi):

<center>[[File:mcc_filter3.jpg]]</center>

L'immagine successiva mostra un gruppo in cui si specifica una scala di valutazione a 5 punti (Opzioni 1-5), il titolo della scala e i prodotti che si desidera valutare. L'ultima domanda mostra che ciascuna delle parti della domanda di tipo array può essere adattata:

<center>[[File:mcc_filter4.jpg]]</center>

The next image shows the logic file view of the last question. As you can observe, the subquestions, answers, and scale headers can be tailored.

<center>[[File:mcc_filter5.jpg]]</center>

==Download==

To download the survey example from above, click on the following link: [[Media:Rating_User-Entered_List_of_Products_Survey.zip|Rating user-entered list of products survey example]].

Translations:ExpressionScript sample surveys/174/it

2020-10-19T03:20:45Z

L'immagine successiva mostra un gruppo in cui si specifica una scala di valutazione a 5 punti (Opzioni 1-5), il titolo della scala e i prodotti che si desidera valutare. L'ultima domanda mostra che ciascuna delle parti della domanda di tipo array può essere adattata:

Translations:ExpressionScript sample surveys/173/it

2020-10-19T03:20:26Z

Ritapas: Created page with "<center>File:mcc_filter3.jpg</center>"

<center>[[File:mcc_filter3.jpg]]</center>

ExpressionScript sample surveys/it

2020-10-19T03:20:25Z

Ritapas: Created page with "Ecco il File della logica per quella domanda, che ci consente di verificare che la logica condizionale funzioni come desiderato (ad esempio, per vedere se ci sono errori di si..."

<languages />

__TOC__

=Introduzione=

il modo migliore per imparare ad usare ExpressionScript è provare esempi funzionanti e modificarli secondo le proprie esigenze.

Nel testo seguente sono disponibili alcuni sondaggi di esempi per valutare come si può usare EM per migliorare i propri sondaggi. Questi sondaggi sono anche disponibili nella directory /docs/demosurvey della distribuzione.

=Rilevanza, Adattamento ed Equazioni=

==Panoramica==

L'esempio seguente calcola l'IMC (Indice di Massa Corporea, in inglese Body Mass Index) del partecipante. L'esempio mostra diverse caratteristiche, illustrate più avanti.

==Dimostrazione delle caratteristiche dell'EM==

#'''Rilevanza''' - supporto per logica condizionale "potente";
#'''Piping / Tailoring''' - offre la possibilità di concatenare o adattare le risposte e i metadati delle domande;
#'''Adattamento Dinamico''' - report che cambiano sulla pagina stesas mentre si digitano le risposte.
#'''Micro-Tailoring''' - adattamento condizionale all'interno di frasi e report con l'utilizzo di istruzioni if()
#'''Equazioni''' - un nuovo [[Question type - Equation|tipo di domanda]] che consente l'esecuzione di calcoli, anche nascosti, e la conservazione dei risultati sul database
#'''Convalida dondizionale''' - criteri di convalida, come ad esempio il valore minimo accettabile, possono essere ora condizionali, vale a dire basati su equazioni.

==Screenshot==

Questo esempio calcola l'Indice di Massa Corporea, un indice basato sul peso e l'altezza che determina se si è sottopeso, normopeso, sovrappeso o obesi. All'inizio, sono mostrate solo le quattro domande obbligatorie.

<center>[[File:tailoring1.jpg]]</center>

Dopo aver inserito le informazioni (ed aver scelto se si desidera utilizzare unità metriche o meno), è mostrato un report personalizzato che riassume i dati inseriti e mostra l'indicatore dello stato di peso forma.

<center>[[File:tailoring2.jpg]]</center>

Ecco un altro esempio, che utilizza unità non metriche per mostrare come i risultati cambiano dinamicamente:

<center>[[File:tailoring3.jpg]]</center>

Sono state inserite [[Question type - Equation|domande nascoste di tipo Equazione]] per convertire i dati nel sistema metrico, quando appropriato. In queste domande sono conservati altezza e peso in unità metriche, che confluiscono nella base dati, con l'indice IMC e lo stato di peso forma, senza che si debba creare codice JavaScript personalizzato.

Negli esempi successivi è mostrato come mostrare funzioni, matematiche o d'altro tipo, all'interno di report personalizzati.
Prima dell'inserimento di dati, la pagina appare in questo modo.
Grazie alla logica condizionale, se non sono presenti dati numerici le celle restano vuote invece di mostrare "NaN" o "Divide by Zero".

<center>[[File:tailoring4.jpg]]</center>

Dopo che sono stati inseriti i numeri, il report della pagina è modificato e mostra il calcolo eseguito e il suo risultato.

<center>[[File:tailoring5.jpg]]</center>

Nel sondaggio di esempio sono presenti molti altri esempi. Ad esempio, nella schermata seguente è mostrata una delle tante maniere nelle quali è possibile compilare la pagina Dynamic Relevance.
Come illustrato nelle note, è possibile provare a inserite diverse età e, in particolare, all'inserimento di combinazioni incompatibili di risposte sono mostrati messaggi divertenti.
Si noti anche che se si dichiara di avere più di un figlio, il messaggio dirà "I hope you enjoy playing with your X children" ("spero che ti diverta a giocare con i tuoi X bambini"), piuttosto che declinare la frase al singolare. Con questo si mostra come si possono personalizzare singole frasi per adattarle al genere e/o al numero dei sostantivi utilizzati, come anche si possono anche coniugare facilmente verbi.

<center>[[File:tailoring6.jpg]]</center>

==Download==

Per scaricare il sondaggio di esempio, utilizzare il link seguente: [[Media:LS3_em_tailoring.zip|LS3_em_tailoring.zip]].

=Sample Census=

=Introduzione=

Questo è un esempio di censimento nel quale si chiede quante persone costituiscono il nucleo familiare.

Mostra in che modo è possibile utilizzare la rilevanza a livello di gruppo per implementare facilmente la ripetizione ciclica di domande ("loop"). Dopo aver creato il gruppo per "Person 1", questo è stato esportato. Avendo utilizzato nomi di variabile qcode del tipo p1_name, si è potuto utilizzare un editor di testo per modificare velocemente e re-importare i gruppi più volte: sono stati sufficienti 10 secondi per modificare e re-importare ogni nuovo gruppo mantenendo nomi unici per le variabili e logica corretta a livello di gruppo.

Sarebbe stato possibile utilizzare anche l'opzione [[Copy question|copia domanda]] ma l'opzione mostrata è più rapida.

Si vede anche come evitare che il messaggio di Fine compilazione appaia solo quando il sondaggio è effettivamente terminato (vale a dire, quando tutti i gruppi obbligatori sono completati).

==Dimostrazione delle caratteristiche di EM==

#'''Rilevanza a livello di gruppi''' - I gruppi successivi ("Person 1-5") sono mostrati solo fino al numero di conviventi specificati;
#'''Adattamento''' - Il report finale riassume i dati demografici di ciascun convivente;
#'''Visualizzazione progressiva delle domande''' - Sia in gruppo che in modalità pagina singola, le domande successive sono mostrate mano a mano che le precedenti ricevono una risposta.

==Screenshot==

Il sondaggio produce un report dinamico nel quale sono mostrati i dati demografici dello specifico numero di conviventi:

<center>[[File:census.jpg]]</center>

Se il sondaggio è mostrato una domanda alla volta, si vede che l'indice si adatta alle domande. Dal momento che l'utente ha scritto che la persona è una donna, la domanda (in inglese) è declinata al femminile. E visto che è stato inserito il suo nome, "Mary", la domanda successiva chiede "How old is Mary?" ("Quanti anni ha Mary?").

<center>[[File:census2.jpg]]</center>

==Download==

Usare il link seguente per scaricare il sondaggio di esempio: [[Media:LS3_group_relevance.zip|LS3_group_relevance.zip]].

=Filtri concatenati per Array=

==Panoramica==

Il sondaggio seguente si basa su un originale gentilmente concesso da Joy Lane Research, LLC.

==Screenshot==

Nelle immagini seguenti, notare che.
*Q2 mostra solo i prodotti selezionati (con array_filter) in Q01
*Q02 mostra anche "Another product", ovvero il testo inserito nel campo "Other electronic" di Q01
*Q04 mostra solo prodotti in Q02 che sono stati selezionati (filtraggio concatenato)
*Q05 mostra solo prodotti in Q02 che NON sono stati selezioati in Q02 (filtraggio concatenato che utilizza array_filter_exclude)

<center>[[File:cascading_array_filter.jpg]]</center>

<center>[[File:cascading_array_filter2.jpg]]</center>

==Download==

Utilizzare il seguente link per scaricare l'esempio precedente:[[Media:ls2_cascading_array_filter.lss|LS2_cascading_array_filter sondaggio di esempio]].

=Adattamento/Piping utilizzando tutti i tipi di domanda e attributi=

==Panoramica==

Se siete confusi su come nominare le vostre variabili (SGQA o Qcode), non siete soli. Anche se la documentazione descrive [[ExpressionScript - Presentation#Access to Variables|come comporre nomi di variabile Qcode]], niente è meglio che osservare una demo funzionante. Il sondaggio seguente mostra come accedere ad attributi di domanda e risposte utilizzando ExpressionScript.

{{Note|Per questo esempio, si consiglia di disattivare l'editor HTML integrato (o di convertirlo in modalità popup) durante la modifica di questo sondaggio. L'editor HTML può impiegare un minuto o più per eseguire il rendering dei rapporti HTML di grandi dimensioni in modalità di modifica.}}

==Contenuto==

*Esempi per ogni tipo di domanda
*Sono inclusi tutti i tipi di domande che utilizzano "altro", in modo da mostrare come ciò influisca sulla denominazione delle variabili
*Valori predefiniti per tutti i tipi di domanda che accettano valori predefiniti
*Adattamento - Rapporti in pagina e fuori pagina che mostrano tutti i 16 suffissi disponibilil per EM.
*Questi report mostrano tutti i dati attualmente inseriti (quindi mostrano come generare i propri rapporti stampabili per gli utenti al posto della stampa diretta della schermata delle risposte)
*Qcode corretto e denominazione SGQA di tutte le variabili

==Screenshot==

Questo è un sondaggio enorme, quindi abbiamo scelto di non includere schermate. Consigliamo piuttosto di scaricarlo e giocarci un po'.

==Download==

Fare clic sul collegamento seguente per scaricare il sondaggio: [[Media:ls2_EM_question_attributes.lss|LS3_EM_question_attributes.lss]]

=Validazione tradizionale, rivisitata=

==Panoramica==

Dimostrazione di tutti i tipi di convalida che fanno uso di espressioni e di come esse influiscono su ciascuno dei tipi di domanda che supportano la convalida. In molti casi, i suggerimenti di convalida sono inizialmente nascosti e vengono visualizzati solo se una domanda non soddisfa i criteri di convalida (scomparendo, pertanto, una volta che la domanda superi i criteri di convalida).

==Dimostrazione dei tipi di convalida==

#[[QS:Min_num_value_n|min_num_value_n]] - valore minimo per una risposta#[[QS:Max_num_value_n|max_num_value_n]] - valore massimo per una risposta
#[[QS:Min_answers|min_answers]] - numero minimo di risposte obbligatorie
#[[QS:Max_answers|max_answers]] - numero massimo di risposte consentite
#[[QS:Multiflexible_min|multiflexible_min]] - numero minimo consentito per una risposta (per il tipo di domanda con numeri multiflexi)
#[[QS:Multiflexible_max|multiflexible_max]] - valore massimo consentito per una risposta (per il tipo di domanda con numeri multiflexi)
#[[QS:Min_num_value|min_num_value]] - valore minimo consentito per la somma di tutte le risposte alla domanda
#[[QS:Max_num_value|max_num_value]] - valore massimo consentito per la somma di tutte le risposte alla domanda
#[[QS:Equals_num_value|equals_num_value]] - la somma di tutte le risposte alla domanda deve essere pari a questo valore
#[[QS:Preg_validation|validation]] - espressione regolare di convalida per la domanda - può essere applicata a singole celle

==Screenshot==

Utilizzando nuovi stili CSS, ogni tipo di convalida mostra un suggerimento separato. Se vengono visualizzati, possono essere nascosti tramite l'opzione hide_tip. L'opzione predefinita è mostrarli con un carattere rosso se la domanda non soddisfa i criteri di convalida e verde se li supera:

<center>[[File:validation1.jpg]]</center>

Un utente non può inviare una pagina con errori di convalida. Verrà immediatamente avvertito se ha inserito informazioni errate:

<center>[[File:validation3.jpg]]</center>

La convalida può essere applicata a singole celle all'interno di un array, come in questo esempio, in cui le convalide delle espressioni regolari assicurano che ogni voce sia un numero di telefono statunitense formattato correttamente, incluso il prefisso.

<center>[[File:validation4.jpg]]</center>

==Download==

Per scaricare l'esempio precedente, fare clic sul seguente collegamento: [[Media:LS3_Validation_tests.zip|LS3_Validation_tests.zip]].

=Equazioni di convalida=

==Panoramica==

A volte è necessaria una convalida personalizzata che non può essere ottenuta utilizzando i tradizionali criteri minino/massimo. Per questo, sarà necessario utilizzare le opzioni em_validation_q e em_validation_sq, che consentono di costruire equazioni di convalida complesse rispettivamente a livello di domanda e sottodomanda.

{{Nota|A livello di sottodomanda, introduciamo anche la variabile "this" per semplificare la convalida di ogni cella in un array senza dover conoscere il nome della variabile. Per maggiori dettagli su questo aspetto, fare clic qui.}}

==Dimostrazione delle caratteristiche di EM==

#[[QS:Em_validation_q|em_validation_q]] - questa equazione determina se l'intera domanda è valida
#[[QS:Em_validation_q_tip|em_validation_q_tip]] - questo è il messaggio da mostrare se la domanda non supera i criteri di convalida em_validation_q
#[[QS:Em_validation_sq|em_validation_sq]] - questa equazione determina se ogni sottodomanda (o cella dell'array) è valida
#[[QS:Em_validation_sq_tip|em_validation_sq_tip]] - questo messaggio è mostrato se esistono sottodomande non valide.

In generale, quando si utilizza em_validation_sq, se una cella non è valida il colore di sfondo di quella cella diventa rosso per indicare che c'è un errore.

==Screenshot==

<center>[[File:sqvalidation.jpg]]</center>

Questa domanda assicura che l'età dei tuoi figli sia inserita in ordine decrescente applicando questa equazione di convalida:

<syntaxhighlight lang="php" enclose="div">q1_sq1 >= q1_sq2 && q1_sq2 >= q1_sq3 && q1_sq3 >= q1_sq4</syntaxhighlight>

<center>[[File:sqvalidation2.jpg]]</center>

<hr width="50%" style="margin:auto">

Nell'esempio seguente, la convalida garantisce che non venga data risposta a più di 3 domande su una determinata riga applicando questa equazione di convalida:

<syntaxhighlight lang="php" enclose="div">(sum(Test_A_1, Test_A_2, Test_A_3, Test_A_4, Test_A_5) <= 3) && (sum(Test_B_1, Test_B_2, Test_B_3, Test_B_4, Test_B_5) <= 3) && (sum(Test_C_1, Test_C_2, Test_C_3, Test_C_4, Test_C_5) <= 3)</syntaxhighlight>

Si può anche scrivere come segue e Limesurvey convertirà il tutto automaticamente a run-time nella espressione elencata sopra.

<syntaxhighlight lang="php" enclose="div">(sum(self.sq_A) <= 3) && (sum(self.sq_B) <= 3) && (sum(self.sq_C) <= 3)</syntaxhighlight>

<center>[[File:sqvalidation3.jpg]]</center>

==Download==

Per scaricare il sondaggio di esempio utilizzato negli esempi precedenti, agire sul link seguente: [[Media:ls2_test_em_sq_validation.lss|ls2_test_em_sq_validation.lss]].

=Rilevanza per sottodomande=

==Panoramica==

Questa sezione mostra come possono interagire array_filter e criteri di convalida. Per le convalide che si applicano alle somme, vengono considerati solo i valori rilevanti (visibili).

==Dimostrazione delle caratteristiche di EM==

#[[QS:Array_filter|array_filter]]
#[[QS:Array filter exclude|array_filter_exclude]]
#[[QS:Min_num_value|min_num_value]]
#[[QS:Max num value|max_num_value]]
#[[QS:equals_num_value|equals_num_value]]

Mostra anche il reporting dinamico del numero di domande a cui è stata data risposta nelle domande principali.

==Screenshot==

La modifica del numero di righe visibili cambia dinamicamente la somma. Contrassegnare una sottodomanda come non rilevante non ne cancella il valore. Piuttosto, se non è rilevante, i suoi valori non contribuiscono a nessuna equazione.

<center>[[File:sqrel1.jpg]][[File:Sqrelver12.png]]</center>

Si noti cosa accade quando si seleziona l'opzione "Fifth subquestion" per la prima domanda '''"Which rows should appear below"'''. La somma della seconda domanda "Enter some numbers" ora è 5. Anche se la sottodomanda 5 ha ancora il vaore 14 (cioè, se si deseleziona la quinda sottodomanda, si vedrà nuovamente il valore 14), quel valore non contribuisce alla somma perché considerato non rilevante. Tutti i dati non rilevanti sono cancellati (segnati nel database come NULL) al momento dell'invio, ma il valore resta disponibile sulla pagina nel caso gli utenti vogliano o debbano cambiare idea sulle risposte.

<center>[[File:sqrel2.jpg]]</center>

==Download==

Utilizzare il seguente link per scaricare il nostro esempio: [[Media:ls2_subquestion_relevance.lss|ls2_subquestion_relevance.lss]].

=Utilizzo della virgola come separatore di radice (punto decimale)=

==Panoramica==

ExpressionScript garantisce che solo i numeri validi possano essere inseriti nei campi numerici. Se si inserisce un numero non valido, si viene avvisati che qualcosa non va (ad esempio, nel caso del tema "fruity", l'intera domanda viene scritta in carattere rosso).

Si noti che i valori numerici vengono sempre convertiti utilizzando un punto come separatore all'interno del database. In questo modo, le analisi statistiche funzioneranno in modo appropriato.

Per cambiare il separatore decimale, accedere alle opzioni [[Text elements|Elementi di testo]] che si trovano nel menù [[Survey_settings|Impostazioni]] e cercare la funzionalità [[Text_elements#Survey_text_elements_panel|Simbolo del decimale]].

{{Note|Per ulteriori informazioni sul punto decimale, si veda la pagina wiki [https://en.wikipedia.org/wiki/Radix_point|Radix_point] (in inglese).}}

==Tipi di domande che utilizzano il punto decimale==

#[[Question type - Numerical input|Inserimento numerico]] <nowiki>[</nowiki>N]
#[[Question type - Multiple numerical input|Inserimento numerico multiplo]] <nowiki>[</nowiki>K]
#[[Question type - Array (Numbers)|Array (Numeri)]] <nowiki>[</nowiki>:]
#[[Question type - Array (Texts)|Array (Testo)]] <nowiki>[</nowiki>;], utilizzando l'attributo [[QS:Numbers_only|numbers_only]]
#[[Question type - List (Radio)|List (radio)]] <nowiki>[</nowiki>L], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Short free text|Testo breve]] <nowiki>[</nowiki>S], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Multiple short text|Testo breve multiplo]] <nowiki>[</nowiki>Q], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Multiple choice|Scelta multipla]] <nowiki>[</nowiki>M], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Multiple choice with comments|Scelta multipla con commenti]] <nowiki>[</nowiki>P], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]

==Screenshot==

Si può notare negli screenshot qui sotto che la virgola può essere utilizzata come punto decimale.

<center>[[File:radix1.jpg]]</center>

==Download==

Per scaricare l'esempio precedente, fare clic sul link seguente: [[Media:ls2_comma_as_radix_separator.lss|ls2_comma_as_radix_separator.lss]].

=Gruppi di randomizzazione=

==Panoramica==

Questo sondaggio mostra come utilizzare l'attributo '''random_group'''.

Se viene utilizzato questo attributo, ogni volta che si avvia il sondaggio l'ordine delle domande viene randomizzato. Tuttavia, una volta avviato il sondaggio, l'ordine di randomizzazione rimane fisso, anche se si cambia lingua.

==Screenshot==

Guardiamo insieme l'esempio seguente. La prima domanda casuale sulla pagina sarà Q1, Q4 o Q7. La seconda domanda randomizzata sulla pagina sarà Q2, Q5 o Q8.

<center>[[File:random1.jpg]]</center>

Ecco la randomizzazione generata la prima volta che ho testato questo sondaggio.

<center>[[File:random2.jpg]]</center>

La seconda volta che ho testato il sondaggio è stata generata una diversa randomizzazione.

<center>[[File:random3.jpg]]</center>

Ma, quando sono passato al francese (senza ricominciare il sondaggio), l'ordine di randomizzazione è rimasto intatto.

<center>[[File:random4.jpg]]</center>

==Download==

Per scaricare l'esempio precedente, fare clic sul link seguente: [[Media:Randomization_Group_Test.lss|Randomization_Group_Test.lss]]

=Presentare una sola domanda a caso per gruppo=

==Panoramica==

Questo sondaggio mostra come configurare un sondaggio per visualizzare in modo casuale una domanda per gruppo. In esso ci sono 5 gruppi di 6 domande ciascuno. All'inizio, nel Gruppo 0, vengono compilate cinque domande nascoste di equazioni, chiamate ask1-ask5. Ognuna ha il valore di {floor(rand(1,6.9999))} nel campo di testo della domanda, il che significa che le variabili ask1-ask5 avranno ciascuna un valore compreso tra 1 e 6. Quindi, ogni domanda nel gruppo ha un equazione di rilevanza come "ask1 == N", dove N è l'ennesima domanda nel gruppo (quindi la terza domanda nel gruppo 1 ha l'equazione di rilevanza "ask1 == 3").

Questo sondaggio funziona altrettanto bene nelle modalità "un sondaggio alla volta", "gruppo per gruppo" e "domanda per domanda". Poiché la randomizzazione è impostata nel primo gruppo e quel gruppo è effettivamente nascosto (dal momento che tutte le domande ask1-ask5 sono nascoste), la randomizzazione rimane la stessa per ciascun soggetto; ma ogni soggetto diverso avrà una randomizzazione distinta.

==Dimostrazione delle caratteristiche==

#[[Question type - Equation|Tipo di domanda dell'equazione]]
#Funzioni di randomizzazione
#Funzione condizionale (if)

==Screenshot==

Questo è il Gruppo0, che utilizza il [[Question type - Equation|Tipo di domanda equazione]] per selezionare valori casuali da 1 a 6 per ogni gruppo (eccetto l'ultimo gruppo, che ha solo 4 domande). Nota che la funzione "if()" controlla prima se ask1 è già stato impostato e, in tal caso, utilizza quel valore. Se il valore non è stato impostato, utilizza un valore casuale per impostare il valore di ask1.

<center>[[File:randq3.jpg]]</center>

Questo gruppo mostra come la variabile (ask4) del Gruppo0 viene utilizzata per controllare quale domanda è visibile all'interno del quarto gruppo.

<center>[[File:randq2.jpg]]</center>

==Download==

Per scaricare il sondaggio di esempio precedente, fare clic qui: [[Media: limesurvey_survey_55164.lss|Esempio di domande casuali all'interno di un gruppo]].

=Porre a caso un numero specifico di domande in un gruppo (un sottoinsieme delle domande)=

{{Avviso|Questo si applica solo a tutte le domande casuali di un gruppo e solo se viene utilizzato il formato [[General_settings # General_settings_panel |Un gruppo per pagina oppure Tutte le domande in una pagina]].}}

==Panoramica==

Questo sondaggio mostra come porre un sottoinsieme casuale di domande in un gruppo. Ad esempio, mostra 5 domande casuali su 10 domande situate all'interno di un gruppo.

Il sondaggio ha un gruppo contenente 10 domande. A tutte le domande viene assegnato lo stesso [[QS: Random_group|nome del gruppo di randomizzazione]]. Di conseguenza, verranno visualizzate in ordine casuale al caricamento della pagina. A ogni domanda viene assegnata un'equazione di rilevanza secondo cui la somma di "[[ExpressionScript - Presentation#Access to Variables|relevanceStatus]]" di tutte le altre domande nel gruppo è inferiore al numero di domande che si desidera mostrare. Poiché "[[ExpressionScript - Presentation#Access to Variables|relevanceStatus]]" viene assegnato durante il rendering delle domande, questo corrisponde effettivamente al numero di domande precedenti.

Quindi, nel nostro esempio "5 su 10", l'equazione per Q1 sarebbe:

<syntaxhighlight lang="php" enclose="div">sum(Q2.relevanceStatus, Q3.relevanceStatus, Q4.relevanceStatus, Q5.relevanceStatus, Q6.relevanceStatus, Q7.relevanceStatus, Q8.relevanceStatus, Q9.relevanceStatus, Q10.relevanceStatus) LT 5</syntaxhighlight>

Per Q2, sarebbe:

<syntaxhighlight lang="php" enclose="div">sum(Q1.relevanceStatus, Q3.relevanceStatus, Q4.relevanceStatus, Q5.relevanceStatus, Q6.relevanceStatus, Q7.relevanceStatus, Q8.relevanceStatus, Q9.relevanceStatus, Q10.relevanceStatus) LT 5</syntaxhighlight>

E così via...

==Dimostrazione delle caratteristiche==

#[[ExpressionScript - Presentation#Access to variables|variabile relevanceStatus]]
#[[QS:Random group|Randomizzazione]]

==Download==

Per scaricare l'esempio precedente, fare clic sul link seguente: [[Media:Random_5_out_of_10.lss|Random 5 out of 10 survey example]].

=Classificazione di un elenco di prodotti inserito dall'utente=

==Panoramica==

L'esempio seguente mostra come chiedere agli utenti di elencare una serie di prodotti che li interessano e quindi chiedere loro di valutarli.

==Dimostrazione delle caratteristiche di ES==

#'''Personalizzazione delle risposte''' - quando si valutano i prodotti, le etichette provengono dal campo dei commenti della precedente domanda a scelta multipla
# '''Scale personalizzate''' - molte opzioni avanzate delle domande, come i titoli delle scale, possono essere anche personalizzate.

==Screenshot==

Questa immagine mostra che, essendo stati selezionati solo i prodotti 1,3 e 5, vengono visualizzati solo quei tre (utilizzando l'attributo [[QS: Array_filter|array_filter]]). Inoltre, le etichette delle righe nella seconda domanda sono i numeri di prodotto (se non viene inserito nulla nel campo dei commenti) o il contenuto dei campi dei commenti.

<center>[[File:mcc_filter1.jpg]]</center>

Questa immagine mostra come vengono specificate le risposte su misura:

<center>[[File:mcc_filter2.jpg]]</center>

Ecco il File della logica per quella domanda, che ci consente di verificare che la logica condizionale funzioni come desiderato (ad esempio, per vedere se ci sono errori di sintassi):

<center>[[File:mcc_filter3.jpg]]</center>

The next image shows a group in which you specify a 5 point rating scale (Options 1-5), the title of the scale, and the products you want to rate. The final question shows that each of the parts of the array question can be tailored:

<center>[[File:mcc_filter4.jpg]]</center>

The next image shows the logic file view of the last question. As you can observe, the subquestions, answers, and scale headers can be tailored.

<center>[[File:mcc_filter5.jpg]]</center>

==Download==

To download the survey example from above, click on the following link: [[Media:Rating_User-Entered_List_of_Products_Survey.zip|Rating user-entered list of products survey example]].

Translations:ExpressionScript sample surveys/172/it

2020-10-19T03:20:24Z

Ecco il File della logica per quella domanda, che ci consente di verificare che la logica condizionale funzioni come desiderato (ad esempio, per vedere se ci sono errori di sintassi):

Translations:ExpressionScript sample surveys/171/it

2020-10-19T03:19:53Z

Ritapas: Created page with "<center>File:mcc_filter2.jpg</center>"

<center>[[File:mcc_filter2.jpg]]</center>

ExpressionScript sample surveys/it

2020-10-19T03:19:53Z

Ritapas: Created page with "Questa immagine mostra come vengono specificate le risposte su misura:"

<languages />

__TOC__

=Introduzione=

il modo migliore per imparare ad usare ExpressionScript è provare esempi funzionanti e modificarli secondo le proprie esigenze.

Nel testo seguente sono disponibili alcuni sondaggi di esempi per valutare come si può usare EM per migliorare i propri sondaggi. Questi sondaggi sono anche disponibili nella directory /docs/demosurvey della distribuzione.

=Rilevanza, Adattamento ed Equazioni=

==Panoramica==

L'esempio seguente calcola l'IMC (Indice di Massa Corporea, in inglese Body Mass Index) del partecipante. L'esempio mostra diverse caratteristiche, illustrate più avanti.

==Dimostrazione delle caratteristiche dell'EM==

#'''Rilevanza''' - supporto per logica condizionale "potente";
#'''Piping / Tailoring''' - offre la possibilità di concatenare o adattare le risposte e i metadati delle domande;
#'''Adattamento Dinamico''' - report che cambiano sulla pagina stesas mentre si digitano le risposte.
#'''Micro-Tailoring''' - adattamento condizionale all'interno di frasi e report con l'utilizzo di istruzioni if()
#'''Equazioni''' - un nuovo [[Question type - Equation|tipo di domanda]] che consente l'esecuzione di calcoli, anche nascosti, e la conservazione dei risultati sul database
#'''Convalida dondizionale''' - criteri di convalida, come ad esempio il valore minimo accettabile, possono essere ora condizionali, vale a dire basati su equazioni.

==Screenshot==

Questo esempio calcola l'Indice di Massa Corporea, un indice basato sul peso e l'altezza che determina se si è sottopeso, normopeso, sovrappeso o obesi. All'inizio, sono mostrate solo le quattro domande obbligatorie.

<center>[[File:tailoring1.jpg]]</center>

Dopo aver inserito le informazioni (ed aver scelto se si desidera utilizzare unità metriche o meno), è mostrato un report personalizzato che riassume i dati inseriti e mostra l'indicatore dello stato di peso forma.

<center>[[File:tailoring2.jpg]]</center>

Ecco un altro esempio, che utilizza unità non metriche per mostrare come i risultati cambiano dinamicamente:

<center>[[File:tailoring3.jpg]]</center>

Sono state inserite [[Question type - Equation|domande nascoste di tipo Equazione]] per convertire i dati nel sistema metrico, quando appropriato. In queste domande sono conservati altezza e peso in unità metriche, che confluiscono nella base dati, con l'indice IMC e lo stato di peso forma, senza che si debba creare codice JavaScript personalizzato.

Negli esempi successivi è mostrato come mostrare funzioni, matematiche o d'altro tipo, all'interno di report personalizzati.
Prima dell'inserimento di dati, la pagina appare in questo modo.
Grazie alla logica condizionale, se non sono presenti dati numerici le celle restano vuote invece di mostrare "NaN" o "Divide by Zero".

<center>[[File:tailoring4.jpg]]</center>

Dopo che sono stati inseriti i numeri, il report della pagina è modificato e mostra il calcolo eseguito e il suo risultato.

<center>[[File:tailoring5.jpg]]</center>

Nel sondaggio di esempio sono presenti molti altri esempi. Ad esempio, nella schermata seguente è mostrata una delle tante maniere nelle quali è possibile compilare la pagina Dynamic Relevance.
Come illustrato nelle note, è possibile provare a inserite diverse età e, in particolare, all'inserimento di combinazioni incompatibili di risposte sono mostrati messaggi divertenti.
Si noti anche che se si dichiara di avere più di un figlio, il messaggio dirà "I hope you enjoy playing with your X children" ("spero che ti diverta a giocare con i tuoi X bambini"), piuttosto che declinare la frase al singolare. Con questo si mostra come si possono personalizzare singole frasi per adattarle al genere e/o al numero dei sostantivi utilizzati, come anche si possono anche coniugare facilmente verbi.

<center>[[File:tailoring6.jpg]]</center>

==Download==

Per scaricare il sondaggio di esempio, utilizzare il link seguente: [[Media:LS3_em_tailoring.zip|LS3_em_tailoring.zip]].

=Sample Census=

=Introduzione=

Questo è un esempio di censimento nel quale si chiede quante persone costituiscono il nucleo familiare.

Mostra in che modo è possibile utilizzare la rilevanza a livello di gruppo per implementare facilmente la ripetizione ciclica di domande ("loop"). Dopo aver creato il gruppo per "Person 1", questo è stato esportato. Avendo utilizzato nomi di variabile qcode del tipo p1_name, si è potuto utilizzare un editor di testo per modificare velocemente e re-importare i gruppi più volte: sono stati sufficienti 10 secondi per modificare e re-importare ogni nuovo gruppo mantenendo nomi unici per le variabili e logica corretta a livello di gruppo.

Sarebbe stato possibile utilizzare anche l'opzione [[Copy question|copia domanda]] ma l'opzione mostrata è più rapida.

Si vede anche come evitare che il messaggio di Fine compilazione appaia solo quando il sondaggio è effettivamente terminato (vale a dire, quando tutti i gruppi obbligatori sono completati).

==Dimostrazione delle caratteristiche di EM==

#'''Rilevanza a livello di gruppi''' - I gruppi successivi ("Person 1-5") sono mostrati solo fino al numero di conviventi specificati;
#'''Adattamento''' - Il report finale riassume i dati demografici di ciascun convivente;
#'''Visualizzazione progressiva delle domande''' - Sia in gruppo che in modalità pagina singola, le domande successive sono mostrate mano a mano che le precedenti ricevono una risposta.

==Screenshot==

Il sondaggio produce un report dinamico nel quale sono mostrati i dati demografici dello specifico numero di conviventi:

<center>[[File:census.jpg]]</center>

Se il sondaggio è mostrato una domanda alla volta, si vede che l'indice si adatta alle domande. Dal momento che l'utente ha scritto che la persona è una donna, la domanda (in inglese) è declinata al femminile. E visto che è stato inserito il suo nome, "Mary", la domanda successiva chiede "How old is Mary?" ("Quanti anni ha Mary?").

<center>[[File:census2.jpg]]</center>

==Download==

Usare il link seguente per scaricare il sondaggio di esempio: [[Media:LS3_group_relevance.zip|LS3_group_relevance.zip]].

=Filtri concatenati per Array=

==Panoramica==

Il sondaggio seguente si basa su un originale gentilmente concesso da Joy Lane Research, LLC.

==Screenshot==

Nelle immagini seguenti, notare che.
*Q2 mostra solo i prodotti selezionati (con array_filter) in Q01
*Q02 mostra anche "Another product", ovvero il testo inserito nel campo "Other electronic" di Q01
*Q04 mostra solo prodotti in Q02 che sono stati selezionati (filtraggio concatenato)
*Q05 mostra solo prodotti in Q02 che NON sono stati selezioati in Q02 (filtraggio concatenato che utilizza array_filter_exclude)

<center>[[File:cascading_array_filter.jpg]]</center>

<center>[[File:cascading_array_filter2.jpg]]</center>

==Download==

Utilizzare il seguente link per scaricare l'esempio precedente:[[Media:ls2_cascading_array_filter.lss|LS2_cascading_array_filter sondaggio di esempio]].

=Adattamento/Piping utilizzando tutti i tipi di domanda e attributi=

==Panoramica==

Se siete confusi su come nominare le vostre variabili (SGQA o Qcode), non siete soli. Anche se la documentazione descrive [[ExpressionScript - Presentation#Access to Variables|come comporre nomi di variabile Qcode]], niente è meglio che osservare una demo funzionante. Il sondaggio seguente mostra come accedere ad attributi di domanda e risposte utilizzando ExpressionScript.

{{Note|Per questo esempio, si consiglia di disattivare l'editor HTML integrato (o di convertirlo in modalità popup) durante la modifica di questo sondaggio. L'editor HTML può impiegare un minuto o più per eseguire il rendering dei rapporti HTML di grandi dimensioni in modalità di modifica.}}

==Contenuto==

*Esempi per ogni tipo di domanda
*Sono inclusi tutti i tipi di domande che utilizzano "altro", in modo da mostrare come ciò influisca sulla denominazione delle variabili
*Valori predefiniti per tutti i tipi di domanda che accettano valori predefiniti
*Adattamento - Rapporti in pagina e fuori pagina che mostrano tutti i 16 suffissi disponibilil per EM.
*Questi report mostrano tutti i dati attualmente inseriti (quindi mostrano come generare i propri rapporti stampabili per gli utenti al posto della stampa diretta della schermata delle risposte)
*Qcode corretto e denominazione SGQA di tutte le variabili

==Screenshot==

Questo è un sondaggio enorme, quindi abbiamo scelto di non includere schermate. Consigliamo piuttosto di scaricarlo e giocarci un po'.

==Download==

Fare clic sul collegamento seguente per scaricare il sondaggio: [[Media:ls2_EM_question_attributes.lss|LS3_EM_question_attributes.lss]]

=Validazione tradizionale, rivisitata=

==Panoramica==

Dimostrazione di tutti i tipi di convalida che fanno uso di espressioni e di come esse influiscono su ciascuno dei tipi di domanda che supportano la convalida. In molti casi, i suggerimenti di convalida sono inizialmente nascosti e vengono visualizzati solo se una domanda non soddisfa i criteri di convalida (scomparendo, pertanto, una volta che la domanda superi i criteri di convalida).

==Dimostrazione dei tipi di convalida==

#[[QS:Min_num_value_n|min_num_value_n]] - valore minimo per una risposta#[[QS:Max_num_value_n|max_num_value_n]] - valore massimo per una risposta
#[[QS:Min_answers|min_answers]] - numero minimo di risposte obbligatorie
#[[QS:Max_answers|max_answers]] - numero massimo di risposte consentite
#[[QS:Multiflexible_min|multiflexible_min]] - numero minimo consentito per una risposta (per il tipo di domanda con numeri multiflexi)
#[[QS:Multiflexible_max|multiflexible_max]] - valore massimo consentito per una risposta (per il tipo di domanda con numeri multiflexi)
#[[QS:Min_num_value|min_num_value]] - valore minimo consentito per la somma di tutte le risposte alla domanda
#[[QS:Max_num_value|max_num_value]] - valore massimo consentito per la somma di tutte le risposte alla domanda
#[[QS:Equals_num_value|equals_num_value]] - la somma di tutte le risposte alla domanda deve essere pari a questo valore
#[[QS:Preg_validation|validation]] - espressione regolare di convalida per la domanda - può essere applicata a singole celle

==Screenshot==

Utilizzando nuovi stili CSS, ogni tipo di convalida mostra un suggerimento separato. Se vengono visualizzati, possono essere nascosti tramite l'opzione hide_tip. L'opzione predefinita è mostrarli con un carattere rosso se la domanda non soddisfa i criteri di convalida e verde se li supera:

<center>[[File:validation1.jpg]]</center>

Un utente non può inviare una pagina con errori di convalida. Verrà immediatamente avvertito se ha inserito informazioni errate:

<center>[[File:validation3.jpg]]</center>

La convalida può essere applicata a singole celle all'interno di un array, come in questo esempio, in cui le convalide delle espressioni regolari assicurano che ogni voce sia un numero di telefono statunitense formattato correttamente, incluso il prefisso.

<center>[[File:validation4.jpg]]</center>

==Download==

Per scaricare l'esempio precedente, fare clic sul seguente collegamento: [[Media:LS3_Validation_tests.zip|LS3_Validation_tests.zip]].

=Equazioni di convalida=

==Panoramica==

A volte è necessaria una convalida personalizzata che non può essere ottenuta utilizzando i tradizionali criteri minino/massimo. Per questo, sarà necessario utilizzare le opzioni em_validation_q e em_validation_sq, che consentono di costruire equazioni di convalida complesse rispettivamente a livello di domanda e sottodomanda.

{{Nota|A livello di sottodomanda, introduciamo anche la variabile "this" per semplificare la convalida di ogni cella in un array senza dover conoscere il nome della variabile. Per maggiori dettagli su questo aspetto, fare clic qui.}}

==Dimostrazione delle caratteristiche di EM==

#[[QS:Em_validation_q|em_validation_q]] - questa equazione determina se l'intera domanda è valida
#[[QS:Em_validation_q_tip|em_validation_q_tip]] - questo è il messaggio da mostrare se la domanda non supera i criteri di convalida em_validation_q
#[[QS:Em_validation_sq|em_validation_sq]] - questa equazione determina se ogni sottodomanda (o cella dell'array) è valida
#[[QS:Em_validation_sq_tip|em_validation_sq_tip]] - questo messaggio è mostrato se esistono sottodomande non valide.

In generale, quando si utilizza em_validation_sq, se una cella non è valida il colore di sfondo di quella cella diventa rosso per indicare che c'è un errore.

==Screenshot==

<center>[[File:sqvalidation.jpg]]</center>

Questa domanda assicura che l'età dei tuoi figli sia inserita in ordine decrescente applicando questa equazione di convalida:

<syntaxhighlight lang="php" enclose="div">q1_sq1 >= q1_sq2 && q1_sq2 >= q1_sq3 && q1_sq3 >= q1_sq4</syntaxhighlight>

<center>[[File:sqvalidation2.jpg]]</center>

<hr width="50%" style="margin:auto">

Nell'esempio seguente, la convalida garantisce che non venga data risposta a più di 3 domande su una determinata riga applicando questa equazione di convalida:

<syntaxhighlight lang="php" enclose="div">(sum(Test_A_1, Test_A_2, Test_A_3, Test_A_4, Test_A_5) <= 3) && (sum(Test_B_1, Test_B_2, Test_B_3, Test_B_4, Test_B_5) <= 3) && (sum(Test_C_1, Test_C_2, Test_C_3, Test_C_4, Test_C_5) <= 3)</syntaxhighlight>

Si può anche scrivere come segue e Limesurvey convertirà il tutto automaticamente a run-time nella espressione elencata sopra.

<syntaxhighlight lang="php" enclose="div">(sum(self.sq_A) <= 3) && (sum(self.sq_B) <= 3) && (sum(self.sq_C) <= 3)</syntaxhighlight>

<center>[[File:sqvalidation3.jpg]]</center>

==Download==

Per scaricare il sondaggio di esempio utilizzato negli esempi precedenti, agire sul link seguente: [[Media:ls2_test_em_sq_validation.lss|ls2_test_em_sq_validation.lss]].

=Rilevanza per sottodomande=

==Panoramica==

Questa sezione mostra come possono interagire array_filter e criteri di convalida. Per le convalide che si applicano alle somme, vengono considerati solo i valori rilevanti (visibili).

==Dimostrazione delle caratteristiche di EM==

#[[QS:Array_filter|array_filter]]
#[[QS:Array filter exclude|array_filter_exclude]]
#[[QS:Min_num_value|min_num_value]]
#[[QS:Max num value|max_num_value]]
#[[QS:equals_num_value|equals_num_value]]

Mostra anche il reporting dinamico del numero di domande a cui è stata data risposta nelle domande principali.

==Screenshot==

La modifica del numero di righe visibili cambia dinamicamente la somma. Contrassegnare una sottodomanda come non rilevante non ne cancella il valore. Piuttosto, se non è rilevante, i suoi valori non contribuiscono a nessuna equazione.

<center>[[File:sqrel1.jpg]][[File:Sqrelver12.png]]</center>

Si noti cosa accade quando si seleziona l'opzione "Fifth subquestion" per la prima domanda '''"Which rows should appear below"'''. La somma della seconda domanda "Enter some numbers" ora è 5. Anche se la sottodomanda 5 ha ancora il vaore 14 (cioè, se si deseleziona la quinda sottodomanda, si vedrà nuovamente il valore 14), quel valore non contribuisce alla somma perché considerato non rilevante. Tutti i dati non rilevanti sono cancellati (segnati nel database come NULL) al momento dell'invio, ma il valore resta disponibile sulla pagina nel caso gli utenti vogliano o debbano cambiare idea sulle risposte.

<center>[[File:sqrel2.jpg]]</center>

==Download==

Utilizzare il seguente link per scaricare il nostro esempio: [[Media:ls2_subquestion_relevance.lss|ls2_subquestion_relevance.lss]].

=Utilizzo della virgola come separatore di radice (punto decimale)=

==Panoramica==

ExpressionScript garantisce che solo i numeri validi possano essere inseriti nei campi numerici. Se si inserisce un numero non valido, si viene avvisati che qualcosa non va (ad esempio, nel caso del tema "fruity", l'intera domanda viene scritta in carattere rosso).

Si noti che i valori numerici vengono sempre convertiti utilizzando un punto come separatore all'interno del database. In questo modo, le analisi statistiche funzioneranno in modo appropriato.

Per cambiare il separatore decimale, accedere alle opzioni [[Text elements|Elementi di testo]] che si trovano nel menù [[Survey_settings|Impostazioni]] e cercare la funzionalità [[Text_elements#Survey_text_elements_panel|Simbolo del decimale]].

{{Note|Per ulteriori informazioni sul punto decimale, si veda la pagina wiki [https://en.wikipedia.org/wiki/Radix_point|Radix_point] (in inglese).}}

==Tipi di domande che utilizzano il punto decimale==

#[[Question type - Numerical input|Inserimento numerico]] <nowiki>[</nowiki>N]
#[[Question type - Multiple numerical input|Inserimento numerico multiplo]] <nowiki>[</nowiki>K]
#[[Question type - Array (Numbers)|Array (Numeri)]] <nowiki>[</nowiki>:]
#[[Question type - Array (Texts)|Array (Testo)]] <nowiki>[</nowiki>;], utilizzando l'attributo [[QS:Numbers_only|numbers_only]]
#[[Question type - List (Radio)|List (radio)]] <nowiki>[</nowiki>L], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Short free text|Testo breve]] <nowiki>[</nowiki>S], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Multiple short text|Testo breve multiplo]] <nowiki>[</nowiki>Q], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Multiple choice|Scelta multipla]] <nowiki>[</nowiki>M], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Multiple choice with comments|Scelta multipla con commenti]] <nowiki>[</nowiki>P], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]

==Screenshot==

Si può notare negli screenshot qui sotto che la virgola può essere utilizzata come punto decimale.

<center>[[File:radix1.jpg]]</center>

==Download==

Per scaricare l'esempio precedente, fare clic sul link seguente: [[Media:ls2_comma_as_radix_separator.lss|ls2_comma_as_radix_separator.lss]].

=Gruppi di randomizzazione=

==Panoramica==

Questo sondaggio mostra come utilizzare l'attributo '''random_group'''.

Se viene utilizzato questo attributo, ogni volta che si avvia il sondaggio l'ordine delle domande viene randomizzato. Tuttavia, una volta avviato il sondaggio, l'ordine di randomizzazione rimane fisso, anche se si cambia lingua.

==Screenshot==

Guardiamo insieme l'esempio seguente. La prima domanda casuale sulla pagina sarà Q1, Q4 o Q7. La seconda domanda randomizzata sulla pagina sarà Q2, Q5 o Q8.

<center>[[File:random1.jpg]]</center>

Ecco la randomizzazione generata la prima volta che ho testato questo sondaggio.

<center>[[File:random2.jpg]]</center>

La seconda volta che ho testato il sondaggio è stata generata una diversa randomizzazione.

<center>[[File:random3.jpg]]</center>

Ma, quando sono passato al francese (senza ricominciare il sondaggio), l'ordine di randomizzazione è rimasto intatto.

<center>[[File:random4.jpg]]</center>

==Download==

Per scaricare l'esempio precedente, fare clic sul link seguente: [[Media:Randomization_Group_Test.lss|Randomization_Group_Test.lss]]

=Presentare una sola domanda a caso per gruppo=

==Panoramica==

Questo sondaggio mostra come configurare un sondaggio per visualizzare in modo casuale una domanda per gruppo. In esso ci sono 5 gruppi di 6 domande ciascuno. All'inizio, nel Gruppo 0, vengono compilate cinque domande nascoste di equazioni, chiamate ask1-ask5. Ognuna ha il valore di {floor(rand(1,6.9999))} nel campo di testo della domanda, il che significa che le variabili ask1-ask5 avranno ciascuna un valore compreso tra 1 e 6. Quindi, ogni domanda nel gruppo ha un equazione di rilevanza come "ask1 == N", dove N è l'ennesima domanda nel gruppo (quindi la terza domanda nel gruppo 1 ha l'equazione di rilevanza "ask1 == 3").

Questo sondaggio funziona altrettanto bene nelle modalità "un sondaggio alla volta", "gruppo per gruppo" e "domanda per domanda". Poiché la randomizzazione è impostata nel primo gruppo e quel gruppo è effettivamente nascosto (dal momento che tutte le domande ask1-ask5 sono nascoste), la randomizzazione rimane la stessa per ciascun soggetto; ma ogni soggetto diverso avrà una randomizzazione distinta.

==Dimostrazione delle caratteristiche==

#[[Question type - Equation|Tipo di domanda dell'equazione]]
#Funzioni di randomizzazione
#Funzione condizionale (if)

==Screenshot==

Questo è il Gruppo0, che utilizza il [[Question type - Equation|Tipo di domanda equazione]] per selezionare valori casuali da 1 a 6 per ogni gruppo (eccetto l'ultimo gruppo, che ha solo 4 domande). Nota che la funzione "if()" controlla prima se ask1 è già stato impostato e, in tal caso, utilizza quel valore. Se il valore non è stato impostato, utilizza un valore casuale per impostare il valore di ask1.

<center>[[File:randq3.jpg]]</center>

Questo gruppo mostra come la variabile (ask4) del Gruppo0 viene utilizzata per controllare quale domanda è visibile all'interno del quarto gruppo.

<center>[[File:randq2.jpg]]</center>

==Download==

Per scaricare il sondaggio di esempio precedente, fare clic qui: [[Media: limesurvey_survey_55164.lss|Esempio di domande casuali all'interno di un gruppo]].

=Porre a caso un numero specifico di domande in un gruppo (un sottoinsieme delle domande)=

{{Avviso|Questo si applica solo a tutte le domande casuali di un gruppo e solo se viene utilizzato il formato [[General_settings # General_settings_panel |Un gruppo per pagina oppure Tutte le domande in una pagina]].}}

==Panoramica==

Questo sondaggio mostra come porre un sottoinsieme casuale di domande in un gruppo. Ad esempio, mostra 5 domande casuali su 10 domande situate all'interno di un gruppo.

Il sondaggio ha un gruppo contenente 10 domande. A tutte le domande viene assegnato lo stesso [[QS: Random_group|nome del gruppo di randomizzazione]]. Di conseguenza, verranno visualizzate in ordine casuale al caricamento della pagina. A ogni domanda viene assegnata un'equazione di rilevanza secondo cui la somma di "[[ExpressionScript - Presentation#Access to Variables|relevanceStatus]]" di tutte le altre domande nel gruppo è inferiore al numero di domande che si desidera mostrare. Poiché "[[ExpressionScript - Presentation#Access to Variables|relevanceStatus]]" viene assegnato durante il rendering delle domande, questo corrisponde effettivamente al numero di domande precedenti.

Quindi, nel nostro esempio "5 su 10", l'equazione per Q1 sarebbe:

<syntaxhighlight lang="php" enclose="div">sum(Q2.relevanceStatus, Q3.relevanceStatus, Q4.relevanceStatus, Q5.relevanceStatus, Q6.relevanceStatus, Q7.relevanceStatus, Q8.relevanceStatus, Q9.relevanceStatus, Q10.relevanceStatus) LT 5</syntaxhighlight>

Per Q2, sarebbe:

<syntaxhighlight lang="php" enclose="div">sum(Q1.relevanceStatus, Q3.relevanceStatus, Q4.relevanceStatus, Q5.relevanceStatus, Q6.relevanceStatus, Q7.relevanceStatus, Q8.relevanceStatus, Q9.relevanceStatus, Q10.relevanceStatus) LT 5</syntaxhighlight>

E così via...

==Dimostrazione delle caratteristiche==

#[[ExpressionScript - Presentation#Access to variables|variabile relevanceStatus]]
#[[QS:Random group|Randomizzazione]]

==Download==

Per scaricare l'esempio precedente, fare clic sul link seguente: [[Media:Random_5_out_of_10.lss|Random 5 out of 10 survey example]].

=Classificazione di un elenco di prodotti inserito dall'utente=

==Panoramica==

L'esempio seguente mostra come chiedere agli utenti di elencare una serie di prodotti che li interessano e quindi chiedere loro di valutarli.

==Dimostrazione delle caratteristiche di ES==

#'''Personalizzazione delle risposte''' - quando si valutano i prodotti, le etichette provengono dal campo dei commenti della precedente domanda a scelta multipla
# '''Scale personalizzate''' - molte opzioni avanzate delle domande, come i titoli delle scale, possono essere anche personalizzate.

==Screenshot==

Questa immagine mostra che, essendo stati selezionati solo i prodotti 1,3 e 5, vengono visualizzati solo quei tre (utilizzando l'attributo [[QS: Array_filter|array_filter]]). Inoltre, le etichette delle righe nella seconda domanda sono i numeri di prodotto (se non viene inserito nulla nel campo dei commenti) o il contenuto dei campi dei commenti.

<center>[[File:mcc_filter1.jpg]]</center>

Questa immagine mostra come vengono specificate le risposte su misura:

<center>[[File:mcc_filter2.jpg]]</center>

Here is the Show Logic File for that question, which lets us verify that the conditional logic works as desired (e.g., to see whether there are any syntax errors):

<center>[[File:mcc_filter3.jpg]]</center>

The next image shows a group in which you specify a 5 point rating scale (Options 1-5), the title of the scale, and the products you want to rate. The final question shows that each of the parts of the array question can be tailored:

<center>[[File:mcc_filter4.jpg]]</center>

The next image shows the logic file view of the last question. As you can observe, the subquestions, answers, and scale headers can be tailored.

<center>[[File:mcc_filter5.jpg]]</center>

==Download==

To download the survey example from above, click on the following link: [[Media:Rating_User-Entered_List_of_Products_Survey.zip|Rating user-entered list of products survey example]].

Translations:ExpressionScript sample surveys/170/it

2020-10-19T03:19:51Z

Ritapas: Created page with "Questa immagine mostra come vengono specificate le risposte su misura:"

Questa immagine mostra come vengono specificate le risposte su misura:

Translations:ExpressionScript sample surveys/169/it

2020-10-19T03:19:46Z

Ritapas: Created page with "<center>File:mcc_filter1.jpg</center>"

<center>[[File:mcc_filter1.jpg]]</center>

ExpressionScript sample surveys/it

2020-10-19T03:19:41Z

Ritapas: Created page with "Questa immagine mostra che, essendo stati selezionati solo i prodotti 1,3 e 5, vengono visualizzati solo quei tre (utilizzando l'attributo array_filter)...."

<languages />

__TOC__

=Introduzione=

il modo migliore per imparare ad usare ExpressionScript è provare esempi funzionanti e modificarli secondo le proprie esigenze.

Nel testo seguente sono disponibili alcuni sondaggi di esempi per valutare come si può usare EM per migliorare i propri sondaggi. Questi sondaggi sono anche disponibili nella directory /docs/demosurvey della distribuzione.

=Rilevanza, Adattamento ed Equazioni=

==Panoramica==

L'esempio seguente calcola l'IMC (Indice di Massa Corporea, in inglese Body Mass Index) del partecipante. L'esempio mostra diverse caratteristiche, illustrate più avanti.

==Dimostrazione delle caratteristiche dell'EM==

#'''Rilevanza''' - supporto per logica condizionale "potente";
#'''Piping / Tailoring''' - offre la possibilità di concatenare o adattare le risposte e i metadati delle domande;
#'''Adattamento Dinamico''' - report che cambiano sulla pagina stesas mentre si digitano le risposte.
#'''Micro-Tailoring''' - adattamento condizionale all'interno di frasi e report con l'utilizzo di istruzioni if()
#'''Equazioni''' - un nuovo [[Question type - Equation|tipo di domanda]] che consente l'esecuzione di calcoli, anche nascosti, e la conservazione dei risultati sul database
#'''Convalida dondizionale''' - criteri di convalida, come ad esempio il valore minimo accettabile, possono essere ora condizionali, vale a dire basati su equazioni.

==Screenshot==

Questo esempio calcola l'Indice di Massa Corporea, un indice basato sul peso e l'altezza che determina se si è sottopeso, normopeso, sovrappeso o obesi. All'inizio, sono mostrate solo le quattro domande obbligatorie.

<center>[[File:tailoring1.jpg]]</center>

Dopo aver inserito le informazioni (ed aver scelto se si desidera utilizzare unità metriche o meno), è mostrato un report personalizzato che riassume i dati inseriti e mostra l'indicatore dello stato di peso forma.

<center>[[File:tailoring2.jpg]]</center>

Ecco un altro esempio, che utilizza unità non metriche per mostrare come i risultati cambiano dinamicamente:

<center>[[File:tailoring3.jpg]]</center>

Sono state inserite [[Question type - Equation|domande nascoste di tipo Equazione]] per convertire i dati nel sistema metrico, quando appropriato. In queste domande sono conservati altezza e peso in unità metriche, che confluiscono nella base dati, con l'indice IMC e lo stato di peso forma, senza che si debba creare codice JavaScript personalizzato.

Negli esempi successivi è mostrato come mostrare funzioni, matematiche o d'altro tipo, all'interno di report personalizzati.
Prima dell'inserimento di dati, la pagina appare in questo modo.
Grazie alla logica condizionale, se non sono presenti dati numerici le celle restano vuote invece di mostrare "NaN" o "Divide by Zero".

<center>[[File:tailoring4.jpg]]</center>

Dopo che sono stati inseriti i numeri, il report della pagina è modificato e mostra il calcolo eseguito e il suo risultato.

<center>[[File:tailoring5.jpg]]</center>

Nel sondaggio di esempio sono presenti molti altri esempi. Ad esempio, nella schermata seguente è mostrata una delle tante maniere nelle quali è possibile compilare la pagina Dynamic Relevance.
Come illustrato nelle note, è possibile provare a inserite diverse età e, in particolare, all'inserimento di combinazioni incompatibili di risposte sono mostrati messaggi divertenti.
Si noti anche che se si dichiara di avere più di un figlio, il messaggio dirà "I hope you enjoy playing with your X children" ("spero che ti diverta a giocare con i tuoi X bambini"), piuttosto che declinare la frase al singolare. Con questo si mostra come si possono personalizzare singole frasi per adattarle al genere e/o al numero dei sostantivi utilizzati, come anche si possono anche coniugare facilmente verbi.

<center>[[File:tailoring6.jpg]]</center>

==Download==

Per scaricare il sondaggio di esempio, utilizzare il link seguente: [[Media:LS3_em_tailoring.zip|LS3_em_tailoring.zip]].

=Sample Census=

=Introduzione=

Questo è un esempio di censimento nel quale si chiede quante persone costituiscono il nucleo familiare.

Mostra in che modo è possibile utilizzare la rilevanza a livello di gruppo per implementare facilmente la ripetizione ciclica di domande ("loop"). Dopo aver creato il gruppo per "Person 1", questo è stato esportato. Avendo utilizzato nomi di variabile qcode del tipo p1_name, si è potuto utilizzare un editor di testo per modificare velocemente e re-importare i gruppi più volte: sono stati sufficienti 10 secondi per modificare e re-importare ogni nuovo gruppo mantenendo nomi unici per le variabili e logica corretta a livello di gruppo.

Sarebbe stato possibile utilizzare anche l'opzione [[Copy question|copia domanda]] ma l'opzione mostrata è più rapida.

Si vede anche come evitare che il messaggio di Fine compilazione appaia solo quando il sondaggio è effettivamente terminato (vale a dire, quando tutti i gruppi obbligatori sono completati).

==Dimostrazione delle caratteristiche di EM==

#'''Rilevanza a livello di gruppi''' - I gruppi successivi ("Person 1-5") sono mostrati solo fino al numero di conviventi specificati;
#'''Adattamento''' - Il report finale riassume i dati demografici di ciascun convivente;
#'''Visualizzazione progressiva delle domande''' - Sia in gruppo che in modalità pagina singola, le domande successive sono mostrate mano a mano che le precedenti ricevono una risposta.

==Screenshot==

Il sondaggio produce un report dinamico nel quale sono mostrati i dati demografici dello specifico numero di conviventi:

<center>[[File:census.jpg]]</center>

Se il sondaggio è mostrato una domanda alla volta, si vede che l'indice si adatta alle domande. Dal momento che l'utente ha scritto che la persona è una donna, la domanda (in inglese) è declinata al femminile. E visto che è stato inserito il suo nome, "Mary", la domanda successiva chiede "How old is Mary?" ("Quanti anni ha Mary?").

<center>[[File:census2.jpg]]</center>

==Download==

Usare il link seguente per scaricare il sondaggio di esempio: [[Media:LS3_group_relevance.zip|LS3_group_relevance.zip]].

=Filtri concatenati per Array=

==Panoramica==

Il sondaggio seguente si basa su un originale gentilmente concesso da Joy Lane Research, LLC.

==Screenshot==

Nelle immagini seguenti, notare che.
*Q2 mostra solo i prodotti selezionati (con array_filter) in Q01
*Q02 mostra anche "Another product", ovvero il testo inserito nel campo "Other electronic" di Q01
*Q04 mostra solo prodotti in Q02 che sono stati selezionati (filtraggio concatenato)
*Q05 mostra solo prodotti in Q02 che NON sono stati selezioati in Q02 (filtraggio concatenato che utilizza array_filter_exclude)

<center>[[File:cascading_array_filter.jpg]]</center>

<center>[[File:cascading_array_filter2.jpg]]</center>

==Download==

Utilizzare il seguente link per scaricare l'esempio precedente:[[Media:ls2_cascading_array_filter.lss|LS2_cascading_array_filter sondaggio di esempio]].

=Adattamento/Piping utilizzando tutti i tipi di domanda e attributi=

==Panoramica==

Se siete confusi su come nominare le vostre variabili (SGQA o Qcode), non siete soli. Anche se la documentazione descrive [[ExpressionScript - Presentation#Access to Variables|come comporre nomi di variabile Qcode]], niente è meglio che osservare una demo funzionante. Il sondaggio seguente mostra come accedere ad attributi di domanda e risposte utilizzando ExpressionScript.

{{Note|Per questo esempio, si consiglia di disattivare l'editor HTML integrato (o di convertirlo in modalità popup) durante la modifica di questo sondaggio. L'editor HTML può impiegare un minuto o più per eseguire il rendering dei rapporti HTML di grandi dimensioni in modalità di modifica.}}

==Contenuto==

*Esempi per ogni tipo di domanda
*Sono inclusi tutti i tipi di domande che utilizzano "altro", in modo da mostrare come ciò influisca sulla denominazione delle variabili
*Valori predefiniti per tutti i tipi di domanda che accettano valori predefiniti
*Adattamento - Rapporti in pagina e fuori pagina che mostrano tutti i 16 suffissi disponibilil per EM.
*Questi report mostrano tutti i dati attualmente inseriti (quindi mostrano come generare i propri rapporti stampabili per gli utenti al posto della stampa diretta della schermata delle risposte)
*Qcode corretto e denominazione SGQA di tutte le variabili

==Screenshot==

Questo è un sondaggio enorme, quindi abbiamo scelto di non includere schermate. Consigliamo piuttosto di scaricarlo e giocarci un po'.

==Download==

Fare clic sul collegamento seguente per scaricare il sondaggio: [[Media:ls2_EM_question_attributes.lss|LS3_EM_question_attributes.lss]]

=Validazione tradizionale, rivisitata=

==Panoramica==

Dimostrazione di tutti i tipi di convalida che fanno uso di espressioni e di come esse influiscono su ciascuno dei tipi di domanda che supportano la convalida. In molti casi, i suggerimenti di convalida sono inizialmente nascosti e vengono visualizzati solo se una domanda non soddisfa i criteri di convalida (scomparendo, pertanto, una volta che la domanda superi i criteri di convalida).

==Dimostrazione dei tipi di convalida==

#[[QS:Min_num_value_n|min_num_value_n]] - valore minimo per una risposta#[[QS:Max_num_value_n|max_num_value_n]] - valore massimo per una risposta
#[[QS:Min_answers|min_answers]] - numero minimo di risposte obbligatorie
#[[QS:Max_answers|max_answers]] - numero massimo di risposte consentite
#[[QS:Multiflexible_min|multiflexible_min]] - numero minimo consentito per una risposta (per il tipo di domanda con numeri multiflexi)
#[[QS:Multiflexible_max|multiflexible_max]] - valore massimo consentito per una risposta (per il tipo di domanda con numeri multiflexi)
#[[QS:Min_num_value|min_num_value]] - valore minimo consentito per la somma di tutte le risposte alla domanda
#[[QS:Max_num_value|max_num_value]] - valore massimo consentito per la somma di tutte le risposte alla domanda
#[[QS:Equals_num_value|equals_num_value]] - la somma di tutte le risposte alla domanda deve essere pari a questo valore
#[[QS:Preg_validation|validation]] - espressione regolare di convalida per la domanda - può essere applicata a singole celle

==Screenshot==

Utilizzando nuovi stili CSS, ogni tipo di convalida mostra un suggerimento separato. Se vengono visualizzati, possono essere nascosti tramite l'opzione hide_tip. L'opzione predefinita è mostrarli con un carattere rosso se la domanda non soddisfa i criteri di convalida e verde se li supera:

<center>[[File:validation1.jpg]]</center>

Un utente non può inviare una pagina con errori di convalida. Verrà immediatamente avvertito se ha inserito informazioni errate:

<center>[[File:validation3.jpg]]</center>

La convalida può essere applicata a singole celle all'interno di un array, come in questo esempio, in cui le convalide delle espressioni regolari assicurano che ogni voce sia un numero di telefono statunitense formattato correttamente, incluso il prefisso.

<center>[[File:validation4.jpg]]</center>

==Download==

Per scaricare l'esempio precedente, fare clic sul seguente collegamento: [[Media:LS3_Validation_tests.zip|LS3_Validation_tests.zip]].

=Equazioni di convalida=

==Panoramica==

A volte è necessaria una convalida personalizzata che non può essere ottenuta utilizzando i tradizionali criteri minino/massimo. Per questo, sarà necessario utilizzare le opzioni em_validation_q e em_validation_sq, che consentono di costruire equazioni di convalida complesse rispettivamente a livello di domanda e sottodomanda.

{{Nota|A livello di sottodomanda, introduciamo anche la variabile "this" per semplificare la convalida di ogni cella in un array senza dover conoscere il nome della variabile. Per maggiori dettagli su questo aspetto, fare clic qui.}}

==Dimostrazione delle caratteristiche di EM==

#[[QS:Em_validation_q|em_validation_q]] - questa equazione determina se l'intera domanda è valida
#[[QS:Em_validation_q_tip|em_validation_q_tip]] - questo è il messaggio da mostrare se la domanda non supera i criteri di convalida em_validation_q
#[[QS:Em_validation_sq|em_validation_sq]] - questa equazione determina se ogni sottodomanda (o cella dell'array) è valida
#[[QS:Em_validation_sq_tip|em_validation_sq_tip]] - questo messaggio è mostrato se esistono sottodomande non valide.

In generale, quando si utilizza em_validation_sq, se una cella non è valida il colore di sfondo di quella cella diventa rosso per indicare che c'è un errore.

==Screenshot==

<center>[[File:sqvalidation.jpg]]</center>

Questa domanda assicura che l'età dei tuoi figli sia inserita in ordine decrescente applicando questa equazione di convalida:

<syntaxhighlight lang="php" enclose="div">q1_sq1 >= q1_sq2 && q1_sq2 >= q1_sq3 && q1_sq3 >= q1_sq4</syntaxhighlight>

<center>[[File:sqvalidation2.jpg]]</center>

<hr width="50%" style="margin:auto">

Nell'esempio seguente, la convalida garantisce che non venga data risposta a più di 3 domande su una determinata riga applicando questa equazione di convalida:

<syntaxhighlight lang="php" enclose="div">(sum(Test_A_1, Test_A_2, Test_A_3, Test_A_4, Test_A_5) <= 3) && (sum(Test_B_1, Test_B_2, Test_B_3, Test_B_4, Test_B_5) <= 3) && (sum(Test_C_1, Test_C_2, Test_C_3, Test_C_4, Test_C_5) <= 3)</syntaxhighlight>

Si può anche scrivere come segue e Limesurvey convertirà il tutto automaticamente a run-time nella espressione elencata sopra.

<syntaxhighlight lang="php" enclose="div">(sum(self.sq_A) <= 3) && (sum(self.sq_B) <= 3) && (sum(self.sq_C) <= 3)</syntaxhighlight>

<center>[[File:sqvalidation3.jpg]]</center>

==Download==

Per scaricare il sondaggio di esempio utilizzato negli esempi precedenti, agire sul link seguente: [[Media:ls2_test_em_sq_validation.lss|ls2_test_em_sq_validation.lss]].

=Rilevanza per sottodomande=

==Panoramica==

Questa sezione mostra come possono interagire array_filter e criteri di convalida. Per le convalide che si applicano alle somme, vengono considerati solo i valori rilevanti (visibili).

==Dimostrazione delle caratteristiche di EM==

#[[QS:Array_filter|array_filter]]
#[[QS:Array filter exclude|array_filter_exclude]]
#[[QS:Min_num_value|min_num_value]]
#[[QS:Max num value|max_num_value]]
#[[QS:equals_num_value|equals_num_value]]

Mostra anche il reporting dinamico del numero di domande a cui è stata data risposta nelle domande principali.

==Screenshot==

La modifica del numero di righe visibili cambia dinamicamente la somma. Contrassegnare una sottodomanda come non rilevante non ne cancella il valore. Piuttosto, se non è rilevante, i suoi valori non contribuiscono a nessuna equazione.

<center>[[File:sqrel1.jpg]][[File:Sqrelver12.png]]</center>

Si noti cosa accade quando si seleziona l'opzione "Fifth subquestion" per la prima domanda '''"Which rows should appear below"'''. La somma della seconda domanda "Enter some numbers" ora è 5. Anche se la sottodomanda 5 ha ancora il vaore 14 (cioè, se si deseleziona la quinda sottodomanda, si vedrà nuovamente il valore 14), quel valore non contribuisce alla somma perché considerato non rilevante. Tutti i dati non rilevanti sono cancellati (segnati nel database come NULL) al momento dell'invio, ma il valore resta disponibile sulla pagina nel caso gli utenti vogliano o debbano cambiare idea sulle risposte.

<center>[[File:sqrel2.jpg]]</center>

==Download==

Utilizzare il seguente link per scaricare il nostro esempio: [[Media:ls2_subquestion_relevance.lss|ls2_subquestion_relevance.lss]].

=Utilizzo della virgola come separatore di radice (punto decimale)=

==Panoramica==

ExpressionScript garantisce che solo i numeri validi possano essere inseriti nei campi numerici. Se si inserisce un numero non valido, si viene avvisati che qualcosa non va (ad esempio, nel caso del tema "fruity", l'intera domanda viene scritta in carattere rosso).

Si noti che i valori numerici vengono sempre convertiti utilizzando un punto come separatore all'interno del database. In questo modo, le analisi statistiche funzioneranno in modo appropriato.

Per cambiare il separatore decimale, accedere alle opzioni [[Text elements|Elementi di testo]] che si trovano nel menù [[Survey_settings|Impostazioni]] e cercare la funzionalità [[Text_elements#Survey_text_elements_panel|Simbolo del decimale]].

{{Note|Per ulteriori informazioni sul punto decimale, si veda la pagina wiki [https://en.wikipedia.org/wiki/Radix_point|Radix_point] (in inglese).}}

==Tipi di domande che utilizzano il punto decimale==

#[[Question type - Numerical input|Inserimento numerico]] <nowiki>[</nowiki>N]
#[[Question type - Multiple numerical input|Inserimento numerico multiplo]] <nowiki>[</nowiki>K]
#[[Question type - Array (Numbers)|Array (Numeri)]] <nowiki>[</nowiki>:]
#[[Question type - Array (Texts)|Array (Testo)]] <nowiki>[</nowiki>;], utilizzando l'attributo [[QS:Numbers_only|numbers_only]]
#[[Question type - List (Radio)|List (radio)]] <nowiki>[</nowiki>L], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Short free text|Testo breve]] <nowiki>[</nowiki>S], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Multiple short text|Testo breve multiplo]] <nowiki>[</nowiki>Q], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Multiple choice|Scelta multipla]] <nowiki>[</nowiki>M], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Multiple choice with comments|Scelta multipla con commenti]] <nowiki>[</nowiki>P], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]

==Screenshot==

Si può notare negli screenshot qui sotto che la virgola può essere utilizzata come punto decimale.

<center>[[File:radix1.jpg]]</center>

==Download==

Per scaricare l'esempio precedente, fare clic sul link seguente: [[Media:ls2_comma_as_radix_separator.lss|ls2_comma_as_radix_separator.lss]].

=Gruppi di randomizzazione=

==Panoramica==

Questo sondaggio mostra come utilizzare l'attributo '''random_group'''.

Se viene utilizzato questo attributo, ogni volta che si avvia il sondaggio l'ordine delle domande viene randomizzato. Tuttavia, una volta avviato il sondaggio, l'ordine di randomizzazione rimane fisso, anche se si cambia lingua.

==Screenshot==

Guardiamo insieme l'esempio seguente. La prima domanda casuale sulla pagina sarà Q1, Q4 o Q7. La seconda domanda randomizzata sulla pagina sarà Q2, Q5 o Q8.

<center>[[File:random1.jpg]]</center>

Ecco la randomizzazione generata la prima volta che ho testato questo sondaggio.

<center>[[File:random2.jpg]]</center>

La seconda volta che ho testato il sondaggio è stata generata una diversa randomizzazione.

<center>[[File:random3.jpg]]</center>

Ma, quando sono passato al francese (senza ricominciare il sondaggio), l'ordine di randomizzazione è rimasto intatto.

<center>[[File:random4.jpg]]</center>

==Download==

Per scaricare l'esempio precedente, fare clic sul link seguente: [[Media:Randomization_Group_Test.lss|Randomization_Group_Test.lss]]

=Presentare una sola domanda a caso per gruppo=

==Panoramica==

Questo sondaggio mostra come configurare un sondaggio per visualizzare in modo casuale una domanda per gruppo. In esso ci sono 5 gruppi di 6 domande ciascuno. All'inizio, nel Gruppo 0, vengono compilate cinque domande nascoste di equazioni, chiamate ask1-ask5. Ognuna ha il valore di {floor(rand(1,6.9999))} nel campo di testo della domanda, il che significa che le variabili ask1-ask5 avranno ciascuna un valore compreso tra 1 e 6. Quindi, ogni domanda nel gruppo ha un equazione di rilevanza come "ask1 == N", dove N è l'ennesima domanda nel gruppo (quindi la terza domanda nel gruppo 1 ha l'equazione di rilevanza "ask1 == 3").

Questo sondaggio funziona altrettanto bene nelle modalità "un sondaggio alla volta", "gruppo per gruppo" e "domanda per domanda". Poiché la randomizzazione è impostata nel primo gruppo e quel gruppo è effettivamente nascosto (dal momento che tutte le domande ask1-ask5 sono nascoste), la randomizzazione rimane la stessa per ciascun soggetto; ma ogni soggetto diverso avrà una randomizzazione distinta.

==Dimostrazione delle caratteristiche==

#[[Question type - Equation|Tipo di domanda dell'equazione]]
#Funzioni di randomizzazione
#Funzione condizionale (if)

==Screenshot==

Questo è il Gruppo0, che utilizza il [[Question type - Equation|Tipo di domanda equazione]] per selezionare valori casuali da 1 a 6 per ogni gruppo (eccetto l'ultimo gruppo, che ha solo 4 domande). Nota che la funzione "if()" controlla prima se ask1 è già stato impostato e, in tal caso, utilizza quel valore. Se il valore non è stato impostato, utilizza un valore casuale per impostare il valore di ask1.

<center>[[File:randq3.jpg]]</center>

Questo gruppo mostra come la variabile (ask4) del Gruppo0 viene utilizzata per controllare quale domanda è visibile all'interno del quarto gruppo.

<center>[[File:randq2.jpg]]</center>

==Download==

Per scaricare il sondaggio di esempio precedente, fare clic qui: [[Media: limesurvey_survey_55164.lss|Esempio di domande casuali all'interno di un gruppo]].

=Porre a caso un numero specifico di domande in un gruppo (un sottoinsieme delle domande)=

{{Avviso|Questo si applica solo a tutte le domande casuali di un gruppo e solo se viene utilizzato il formato [[General_settings # General_settings_panel |Un gruppo per pagina oppure Tutte le domande in una pagina]].}}

==Panoramica==

Questo sondaggio mostra come porre un sottoinsieme casuale di domande in un gruppo. Ad esempio, mostra 5 domande casuali su 10 domande situate all'interno di un gruppo.

Il sondaggio ha un gruppo contenente 10 domande. A tutte le domande viene assegnato lo stesso [[QS: Random_group|nome del gruppo di randomizzazione]]. Di conseguenza, verranno visualizzate in ordine casuale al caricamento della pagina. A ogni domanda viene assegnata un'equazione di rilevanza secondo cui la somma di "[[ExpressionScript - Presentation#Access to Variables|relevanceStatus]]" di tutte le altre domande nel gruppo è inferiore al numero di domande che si desidera mostrare. Poiché "[[ExpressionScript - Presentation#Access to Variables|relevanceStatus]]" viene assegnato durante il rendering delle domande, questo corrisponde effettivamente al numero di domande precedenti.

Quindi, nel nostro esempio "5 su 10", l'equazione per Q1 sarebbe:

<syntaxhighlight lang="php" enclose="div">sum(Q2.relevanceStatus, Q3.relevanceStatus, Q4.relevanceStatus, Q5.relevanceStatus, Q6.relevanceStatus, Q7.relevanceStatus, Q8.relevanceStatus, Q9.relevanceStatus, Q10.relevanceStatus) LT 5</syntaxhighlight>

Per Q2, sarebbe:

<syntaxhighlight lang="php" enclose="div">sum(Q1.relevanceStatus, Q3.relevanceStatus, Q4.relevanceStatus, Q5.relevanceStatus, Q6.relevanceStatus, Q7.relevanceStatus, Q8.relevanceStatus, Q9.relevanceStatus, Q10.relevanceStatus) LT 5</syntaxhighlight>

E così via...

==Dimostrazione delle caratteristiche==

#[[ExpressionScript - Presentation#Access to variables|variabile relevanceStatus]]
#[[QS:Random group|Randomizzazione]]

==Download==

Per scaricare l'esempio precedente, fare clic sul link seguente: [[Media:Random_5_out_of_10.lss|Random 5 out of 10 survey example]].

=Classificazione di un elenco di prodotti inserito dall'utente=

==Panoramica==

L'esempio seguente mostra come chiedere agli utenti di elencare una serie di prodotti che li interessano e quindi chiedere loro di valutarli.

==Dimostrazione delle caratteristiche di ES==

#'''Personalizzazione delle risposte''' - quando si valutano i prodotti, le etichette provengono dal campo dei commenti della precedente domanda a scelta multipla
# '''Scale personalizzate''' - molte opzioni avanzate delle domande, come i titoli delle scale, possono essere anche personalizzate.

==Screenshot==

Questa immagine mostra che, essendo stati selezionati solo i prodotti 1,3 e 5, vengono visualizzati solo quei tre (utilizzando l'attributo [[QS: Array_filter|array_filter]]). Inoltre, le etichette delle righe nella seconda domanda sono i numeri di prodotto (se non viene inserito nulla nel campo dei commenti) o il contenuto dei campi dei commenti.

<center>[[File:mcc_filter1.jpg]]</center>

This image shows how the tailored answers are specified:

<center>[[File:mcc_filter2.jpg]]</center>

Here is the Show Logic File for that question, which lets us verify that the conditional logic works as desired (e.g., to see whether there are any syntax errors):

<center>[[File:mcc_filter3.jpg]]</center>

The next image shows a group in which you specify a 5 point rating scale (Options 1-5), the title of the scale, and the products you want to rate. The final question shows that each of the parts of the array question can be tailored:

<center>[[File:mcc_filter4.jpg]]</center>

The next image shows the logic file view of the last question. As you can observe, the subquestions, answers, and scale headers can be tailored.

<center>[[File:mcc_filter5.jpg]]</center>

==Download==

To download the survey example from above, click on the following link: [[Media:Rating_User-Entered_List_of_Products_Survey.zip|Rating user-entered list of products survey example]].

Translations:ExpressionScript sample surveys/168/it

2020-10-19T03:19:40Z

Ritapas: Created page with "Questa immagine mostra che, essendo stati selezionati solo i prodotti 1,3 e 5, vengono visualizzati solo quei tre (utilizzando l'attributo array_filter)...."

Questa immagine mostra che, essendo stati selezionati solo i prodotti 1,3 e 5, vengono visualizzati solo quei tre (utilizzando l'attributo [[QS: Array_filter|array_filter]]). Inoltre, le etichette delle righe nella seconda domanda sono i numeri di prodotto (se non viene inserito nulla nel campo dei commenti) o il contenuto dei campi dei commenti.

ExpressionScript sample surveys

2020-10-19T03:18:43Z

Ritapas:

<languages />
<translate>


__TOC__

=Introduction= 


The best way to learn how to use the ExpressionScript is to play with working examples and modify them to your needs.


You may find below a set of sample surveys to demonstrate (and test) how the EM can be used to enhance your survey. These surveys can be found in the distribution's /docs/demosurveys folder.

=Relevance, Tailoring and Equations= 

==Overview== 


The following example computes the BMI (Body Mass Index) of each respondent. See below the features that are demonstrated within this example.

==EM Features Demonstrated== 


#'''Relevance''' - support for powerful conditional logic;
#'''Piping / Tailoring''' - offers the ability to pipe or tailor answers and question metadata;
#'''Dynamic Tailoring''' - note that reports are changed on the page as you answer questions.
#'''Micro-Tailoring''' - conditional tailoring within sentences and reports using if() statements
#'''Equations''' - a new [[Question type - Equation|question type]] that lets you do calculations and store the results in the database, even if the calculation is hidden
#'''Conditional Validation''' - validation criteria, such as the minimum allowable value, can be conditional - e.g., based upon equations.

==Screenshots== 


This example computes the Body Mass Index, a calculation of your weight and height to determine whether you are underweight, normal weight, overweight, or obese. Note that initially, all you see are the four mandatory questions:


<center>[[File:tailoring1.jpg]]</center>


Once you enter your information (and you get to choose whether to use metric or non-metric units), you see a tailored report that summarizes what you entered, telling you your weight status:


<center>[[File:tailoring2.jpg]]</center>


Here is a different example, using non-metric units to show how the result changes dynamically:


<center>[[File:tailoring3.jpg]]</center>


There are hidden [[Question type - Equation|Equation-type questions]] at the internal level that converts the data to metric (if needed), storing the metric height, weight, BMI, and weight status in the database without needing custom JavaScript.


You can see in the next set of examples how you can use mathematical and other functions within tailored reports. This is how the page looks like before you enter any data. There is conditional logic to show blank cells if no (or non-numeric) data is entered, rather than showing "NaN" or "Divide by Zero".


<center>[[File:tailoring4.jpg]]</center>


As numbers are entered, the on-page report changes to show the computation being performed, and its result.


<center>[[File:tailoring5.jpg]]</center>


There are many other examples in this sample survey. For example, the below screenshot shows one of the dozens of ways you can fill out the Dynamic Relevance page. As the help text notes, try different ages, and especially illogical combinations of responses to see the amusing messages generated at the bottom. Also note that if you say that you have more than one child, the message will say "I hope you enjoy playing with your X children", rather than saying "I hope you enjoy playing with your child". This shows how you can easily micro-tailor sentences to make them match the gender and/or number of your subjects. You can even easily conjugate verbs and decline nouns based upon gender and number.


<center>[[File:tailoring6.jpg]]</center>

==Download== 


To access the survey sample, please click on the following link: [[Media:LS3_em_tailoring.zip|LS3_em_tailoring.zip]].

=Sample Census= 

==Overview== 


This is a census example that asks how many people are in your household.


It demonstrates how group-level relevance can make it easier to implement a "loop" of questions. After creating the group for Person 1, I exported the group. Since I used qcode variable names like p1_name instead of the SGQA code, I could use a text editor to quickly edit and re-import the group several times (e.g., it took about 10 seconds to edit and re-import each repeating group, ensuring that all variables had unique variables names and that the group-level logic was correct).


You can also the [[Copy question|copy question]] feature, but it won't be as fast as the option suggested above.


This also shows how you can prevent the Finished message from appearing until the survey is truly finished (e.g., when all needed groups are completed).

==EM Features Demonstrated== 


#'''Group-level relevance''' - The follow-up groups (Person 1-5) only show for up to the number of cohabitants specified;
#'''Tailoring''' - The final report summarizes the demographic data for each cohabitant;
#'''Progressive question display''' - Whether in group or all-in-one mode, subsequent questions only show as soon as the preceding ones are answered.

==Screenshots== 


The survey generates a tailored report showing the demographics of the specified number of cohabitants:


<center>[[File:census.jpg]]</center>


If you switch to question-at-a-time mode, you see that the index tailors the questions. Since the user said that the person is a woman, it asks "What is her name". And since we answered "Mary", the next question says "How old is Mary"?


<center>[[File:census2.jpg]]</center>

==Download== 


To download the survey sample, click here: [[Media:LS3_group_relevance.zip|LS3_group_relevance.zip]].

=Cascading Array Filters= 

==Overview== 


This survey is based on the design of a survey courtesy of Joy Lane Research, LLC.

==Screenshots== 


In the following, note that:
*Q02 only shows the set of products checked in Q01 (by using array_filter)
*Q02 also shows "Another product", the text entered into the "Other electronic" field in Q01
*Q04 only shows products from Q02 that were checked (so the array filter cascades)
*Q05 only shows products from Q02 that were not checked in Q02 (using a cascaded array_filter_exclude)


<center>[[File:cascading_array_filter.jpg]]</center>


<center>[[File:cascading_array_filter2.jpg]]</center>

==Download== 


Click on the following link to download the above example: [[Media:ls2_cascading_array_filter.lss|LS2_cascading_array_filter survey example]].

=Piping/Tailoring Using All Question Types and Attributes= 

==Overview== 


If you are confused about how to name your variables (SGQA vs Qcodes), you are not alone. Although the main documentation describes [[ExpressionScript - Presentation#Access to Variables|how to compose Qcode variable names]], nothing beats seeing it in a working demo. This survey shows how you can access question attributes and responses using the ExpressionScript.


{{Note|For this example, we recommend turning off the built-in HTML editor (or converting it to the pop-up mode) when editing this survey. It can take a minute or more for the HTML editor to render the large HTML reports in edit mode.}}

==Content== 


*Examples of every question type
*All questions types that can use "other" are included so that you can see how that affects variable naming
*Default values for all the question types that accepts defaults
*Tailoring - On- and off-page reports showing all 16 available EM dot notation suffixes.
*These reports show all of the currently entered data (so show you how you could generate your own printable reports for users in lieu of the print-answers screen)
*Proper Qcode and SGQA naming of all variables

==Screenshots== 


This is a huge survey, so we chose not to include screen shots. Instead, please download and play with it.

==Download== 


Click on the following link to download the survey: [[Media:ls2_EM_question_attributes.lss|LS3_EM_question_attributes.lss]]

=Traditional validation, re-envisioned= 

==Overview== 


This demonstrates all the validation types that make use of expressions and how they affect each of the question types that support validation. In many cases, the validation tips start hidden and only appear if a question fails validation criteria (thus also disappearing once the question passes the validation criteria).

==Validation Types Demonstrated== 


#[[QS:Min_num_value_n|min_num_value_n]] - minimum value for an answer
#[[QS:Max_num_value_n|max_num_value_n]] - max value for an answer
#[[QS:Min_answers|min_answers]] - minimum number of answers required
#[[QS:Max_answers|max_answers]] maximum number of answers allowed
#[[QS:Multiflexible_min|multiflexible_min]] - minimum value allowed for an answer (for multiflexi numbers question type)
#[[QS:Multiflexible_max|multiflexible_max]] - maximum value allowed for an answer (for multiflexi numbers question type)
#[[QS:Min_num_value|min_num_value]] - minimum allowed sum across all answers for the question
#[[QS:Max_num_value|max_num_value]] - maximum allowed sum across all answers for the question
#[[QS:Equals_num_value|equals_num_value]] - the sum across all answers for the question must equal this value
#[[QS:Preg_validation|validation]] - this is the regular expression validation for the question - it can apply to individual cells

==Screenshots== 


Using new CSS styles, each validation type shows up a separate tip. If they are shown, they can be hidden via the hide_tip option. The default option is to show them with red font if the question fails the validation criteria, and green if it passes them:


<center>[[File:validation1.jpg]]</center>


A user cannot submit a page with validation errors. He will be immediately warned if he entered wrong information:


<center>[[File:validation3.jpg]]</center>


Validation can be applied to individual cells within an array, such as in this example where regular expression validations ensure that each entry is a properly formatted US phone number including area code.


<center>[[File:validation4.jpg]]</center>

==Download== 


To download the above example, click on the following link: [[Media:LS3_Validation_tests.zip|LS3_Validation_tests.zip]].

=Validation Equations= 

==Overview== 


Sometimes you need custom validation that cannot be achieved using the traditional min/max criteria. For this, you will need to use the em_validation_q and em_validation_sq options which let you construct complex validation equations at the question and subquestion level, respectively.


{{Note|At the subquestion level, we also introduce the "this" variable to make it easy to validate each cell in an array without needing to know its variable name. For more details about it, click here.}}

==EM Features Demonstrated== 


#[[QS:Em_validation_q|em_validation_q]] - this is an equation that determines whether the whole question is valid
#[[QS:Em_validation_q_tip|em_validation_q_tip]] - this is the message to show if the question fails em_validation_q criteria
#[[QS:Em_validation_sq|em_validation_sq]] - this is the equation that determines whether each subquestion (array cell) is valid
#[[QS:Em_validation_sq_tip|em_validation_sq_tip]] - this is the message to show if any of the subquestions is invalid.


In general, when em_validation_sq is used, if any cell is invalid, the background color for that cell turns red to indicate that there is an error.

==Screenshots== 


<center>[[File:sqvalidation.jpg]]</center>


This question ensures that you enter the ages of your children in descending order by applying this validation equation:


<syntaxhighlight lang="php" enclose="div">q1_sq1 >= q1_sq2 && q1_sq2 >= q1_sq3 && q1_sq3 >= q1_sq4</syntaxhighlight>


<center>[[File:sqvalidation2.jpg]]</center>


<hr width="50%" style="margin:auto">


In the below example, the validation ensures that no more than 3 questions are answered on any given row by applying this validation equation:


<syntaxhighlight lang="php" enclose="div">(sum(Test_A_1, Test_A_2, Test_A_3, Test_A_4, Test_A_5) <= 3) && (sum(Test_B_1, Test_B_2, Test_B_3, Test_B_4, Test_B_5) <= 3) && (sum(Test_C_1, Test_C_2, Test_C_3, Test_C_4, Test_C_5) <= 3)</syntaxhighlight>


You can also write this as follows, LimeSurvey automatically converting it at run-time to the above-listed expression.


<syntaxhighlight lang="php" enclose="div">(sum(self.sq_A) <= 3) && (sum(self.sq_B) <= 3) && (sum(self.sq_C) <= 3)</syntaxhighlight>


<center>[[File:sqvalidation3.jpg]]</center>

==Download== 


To download the survey sample used in the above examples, click on the following link: [[Media:ls2_test_em_sq_validation.lss|ls2_test_em_sq_validation.lss]].

=Subquestion relevance= 

==Overview== 


This shows how array_filter and validation criteria can interact. For validations that apply to sums, only relevant (visible) values are considered.

==EM Features Demonstrated== 


#[[QS:Array_filter|array_filter]]
#[[QS:Array filter exclude|array_filter_exclude]]
#[[QS:Min_num_value|min_num_value]]
#[[QS:Max num value|max_num_value]]
#[[QS:equals_num_value|equals_num_value]]


It also shows dynamic reporting of the numbers of questions answered in the core questions.

==Screenshots== 


Changing the number of visible rows dynamically changes the sum. Marking a subquestion as being irrelevant doesn't clear its value. Rather, if it is irrelevant, its values don't contribute to any equation.


<center>[[File:sqrel1.jpg]][[File:Sqrelver12.png]]</center>


Note what happens when we check the "Fifth subquestion" for the first question '''"Which rows should appear below"'''. Note that the sum for the second "Enter some numbers" question is now 5. Even though subquestion 5 for that question still has the value 14 (e.g., if you un-check the fifth subquestion, you will see the value of 14 again), that value does not contribute to the sum since it is currently irrelevant. All irrelevant data is cleared (NULLed in the database) on submit, but it stays available on the page in case users want or need to change their minds about answers.


<center>[[File:sqrel2.jpg]]</center>

==Download== 


To download our example, click here: [[Media:ls2_subquestion_relevance.lss|ls2_subquestion_relevance.lss]].

=Using Comma as Radix Separator (Decimal Point)= 

==Overview== 


The ExpressionScript ensures that only valid numbers can be entered into numeric fields. If you enter an invalid number, you will be warned that something is wrong (e.g., in the case of the fruity theme, the whole question is "red-ed").


Note that the numeric values are always converted to using a period as the radix separator within the database. In this way, the statistical analyses will work appropriately.


To change the radix separator, access the [[Text elements]] options located under the [[Survey_settings|Settings]] tab, and look for the [[Text_elements#Survey_text_elements_panel|decimal mark]] functionality.


{{Note|For more information on what a radix separator is, click [https://en.wikipedia.org/wiki/Radix_point|here].}}

==Question Types Using Radix Separator== 


#[[Question type - Numerical input|Numerical input]] <nowiki>[</nowiki>N]
#[[Question type - Multiple numerical input|Multiple numerical input]] <nowiki>[</nowiki>K]
#[[Question type - Array (Numbers)|Array (Numbers)]] <nowiki>[</nowiki>:]
#[[Question type - Array (Texts)|Array (Texts)]] <nowiki>[</nowiki>;], when using the [[QS:Numbers_only|numbers_only]] attribute
#[[Question type - List (Radio)|List (radio)]] <nowiki>[</nowiki>L], when using the [[QS:Other_numbers_only|other_numbers_only]] attribute
#[[Question type - Short free text|Short free text]] <nowiki>[</nowiki>S], when using the [[QS:Numbers_only|numbers_only]] attribute
#[[Question type - Multiple short text|Multiple short text]] <nowiki>[</nowiki>Q], when using the [[QS:Numbers_only|numbers_only]] attribute
#[[Question type - Multiple choice|Multiple choice]] <nowiki>[</nowiki>M], when using the [[QS:Other_numbers_only|other_numbers_only]] attribute
#[[Question type - Multiple choice with comments|Multiple choice with comments]] <nowiki>[</nowiki>P], when using the [[QS:Other_numbers_only|other_numbers_only]] attribute

==Screenshots== 


You may note in the below screenshots that comma can be used as a radix separator.


<center>[[File:radix1.jpg]]</center>

==Download== 


To download the above example, click on the following link: [[Media:ls2_comma_as_radix_separator.lss|ls2_comma_as_radix_separator.lss]].

=Randomization Groups= 

==Overview== 


This survey demonstrates how to make use of the '''random_group''' attribute.


If this attribute is used, each time you start the survey, the question order is randomized. However, once the survey is started, the randomization order remains fixed, even if you change languages.

==Screenshots== 


Let's check together the below example. The first random question on the page will either be Q1 , Q4, or Q7. The second randomized question on the page will either be Q2, Q5, or Q8.


<center>[[File:random1.jpg]]</center>


Here is the randomization generated the first time I tested this survey.


<center>[[File:random2.jpg]]</center>


A different randomization was generated the second time I tested the survey.


<center>[[File:random3.jpg]]</center>


But, when I switched to French (without re-starting the survey), the randomization order remained intact.


<center>[[File:random4.jpg]]</center>

==Download== 


To download the above example, click on the following link: [[Media:Randomization_Group_Test.lss|Randomization_Group_Test.lss]]

=Randomly Ask One Question Per Group= 

==Overview== 


This survey shows how you can configure a survey to randomly display one question per group. In it, there are 5 groups of 6 questions each. At the outset, in Group 0, five hidden Equation questions, called ask1-ask5, are populated. Each one has the value of {floor(rand(1,6.9999))} in the question text field, which means that the variables ask1-ask5 will each have a value between 1 and 6. Then, each question in the group has a relevance equation like "ask1==N" where N is the Nth question in the group (so the third question in group 1 has the relevance equation "ask1==3").


This survey works equally well in survey-at-a-time, group-by-group, and question-by-question modes. Since the randomization is set in the first group, and that group is effectively hidden (since all of the ask1-ask5 questions are hidden), the randomization stays the same for the subject; but each different subject will have a distinct randomization.

==Features Demonstrated== 


#[[Question type - Equation|Equation question type]]
#Randomization functions
#Conditional (if) function

==Screenshots== 


This is Group0, which uses the [[Question type - Equation|Equation question type]] to select random values from 1 to 6 for each group (except the last group, which has only 4 questions). Note that the "if()" function first checks whether ask1 has already been set, and if so, uses that value. If the value hasn't been set, then it uses a random value to set the value of ask1.


<center>[[File:randq3.jpg]]</center>


This Group shows how the variable (ask4) from Group0 is used to control which question is visible within the fourth group.


<center>[[File:randq2.jpg]]</center>

==Download== 


To download the above survey example, click here: [[Media:limesurvey_survey_55164.lss|Random questions within a group survey example]].

=Randomly Ask A Specific Number Of Questions In A Group (a subset of the questions)= 


{{Alert|This applies only to all random questions from one group and only if the [[General_settings#General_settings_panel|Group by group or All in one]] format is used.}}

==Overview== 


This survey shows how to ask a random subset of questions in a group. For example, show 5 random questions out of 10 questions located within a group.


The survey has one group containing 10 questions. All questions are assigned the same [[QS:Random_group|randomization group name]]. As a result, they will be displayed in a random order on page load. Each question is given a relevance equation that the sum of the "[[ExpressionScript - Presentation#Access to Variables|relevanceStatus]]" of all other questions in the group is less than the number of questions you want to show. Since [[ExpressionScript - Presentation#Access to Variables|relevanceStatus]] is assigned as questions are rendered, this effectively totals the number of preceding questions.


So, in our 5 out of 10 example, the equation for Q1 would be:


<syntaxhighlight lang="php" enclose="div">sum(Q2.relevanceStatus, Q3.relevanceStatus, Q4.relevanceStatus, Q5.relevanceStatus, Q6.relevanceStatus, Q7.relevanceStatus, Q8.relevanceStatus, Q9.relevanceStatus, Q10.relevanceStatus) LT 5</syntaxhighlight>


For Q2, it would be:


<syntaxhighlight lang="php" enclose="div">sum(Q1.relevanceStatus, Q3.relevanceStatus, Q4.relevanceStatus, Q5.relevanceStatus, Q6.relevanceStatus, Q7.relevanceStatus, Q8.relevanceStatus, Q9.relevanceStatus, Q10.relevanceStatus) LT 5</syntaxhighlight>


And so on...

==Features Demonstrated== 


#[[ExpressionScript - Presentation#Access to variables|relevanceStatus variable]]
#[[QS:Random group|Randomizing]]

==Download== 


To download the above example, click on the following link: [[Media:Random_5_out_of_10.lss|Random 5 out of 10 survey example]].

=Rating User-Entered List of Products= 

==Overview== 


The below example shows how you can ask users to list a set of products that interest them, and then have them rate those products.

==ES Features Demonstrated== 


#'''Tailoring answers''' - when rating products, the labels come from the comment field of the preceding multiple choice question
#'''Tailoring scales''' - many advanced questions options, like scale headings, can also be tailored.

==Screenshots== 


This image shows that since only products 1,3, and 5 were selected, only those 3 are displayed (using the [[QS:Array_filter|array_filter]] attribute). Moreover, the row labels in the second question are either the product numbers (if nothing is entered into the comment field) or the contents of the comment fields.


<center>[[File:mcc_filter1.jpg]]</center>


This image shows how the tailored answers are specified:


<center>[[File:mcc_filter2.jpg]]</center>


Here is the Show Logic File for that question, which lets us verify that the conditional logic works as desired (e.g., to see whether there are any syntax errors):


<center>[[File:mcc_filter3.jpg]]</center>


The next image shows a group in which you specify a 5 point rating scale (Options 1-5), the title of the scale, and the products you want to rate. The final question shows that each of the parts of the array question can be tailored:


<center>[[File:mcc_filter4.jpg]]</center>


The next image shows the logic file view of the last question. As you can observe, the subquestions, answers, and scale headers can be tailored.


<center>[[File:mcc_filter5.jpg]]</center>

==Download== 


To download the survey example from above, click on the following link: [[Media:Rating_User-Entered_List_of_Products_Survey.zip|Rating user-entered list of products survey example]].

</translate>

ExpressionScript sample surveys/it

2020-10-19T03:17:29Z

Ritapas: Created page with "==Screenshot=="

<languages />

__TOC__

=Introduzione=

il modo migliore per imparare ad usare ExpressionScript è provare esempi funzionanti e modificarli secondo le proprie esigenze.

Nel testo seguente sono disponibili alcuni sondaggi di esempi per valutare come si può usare EM per migliorare i propri sondaggi. Questi sondaggi sono anche disponibili nella directory /docs/demosurvey della distribuzione.

=Rilevanza, Adattamento ed Equazioni=

==Panoramica==

L'esempio seguente calcola l'IMC (Indice di Massa Corporea, in inglese Body Mass Index) del partecipante. L'esempio mostra diverse caratteristiche, illustrate più avanti.

==Dimostrazione delle caratteristiche dell'EM==

#'''Rilevanza''' - supporto per logica condizionale "potente";
#'''Piping / Tailoring''' - offre la possibilità di concatenare o adattare le risposte e i metadati delle domande;
#'''Adattamento Dinamico''' - report che cambiano sulla pagina stesas mentre si digitano le risposte.
#'''Micro-Tailoring''' - adattamento condizionale all'interno di frasi e report con l'utilizzo di istruzioni if()
#'''Equazioni''' - un nuovo [[Question type - Equation|tipo di domanda]] che consente l'esecuzione di calcoli, anche nascosti, e la conservazione dei risultati sul database
#'''Convalida dondizionale''' - criteri di convalida, come ad esempio il valore minimo accettabile, possono essere ora condizionali, vale a dire basati su equazioni.

==Screenshot==

Questo esempio calcola l'Indice di Massa Corporea, un indice basato sul peso e l'altezza che determina se si è sottopeso, normopeso, sovrappeso o obesi. All'inizio, sono mostrate solo le quattro domande obbligatorie.

<center>[[File:tailoring1.jpg]]</center>

Dopo aver inserito le informazioni (ed aver scelto se si desidera utilizzare unità metriche o meno), è mostrato un report personalizzato che riassume i dati inseriti e mostra l'indicatore dello stato di peso forma.

<center>[[File:tailoring2.jpg]]</center>

Ecco un altro esempio, che utilizza unità non metriche per mostrare come i risultati cambiano dinamicamente:

<center>[[File:tailoring3.jpg]]</center>

Sono state inserite [[Question type - Equation|domande nascoste di tipo Equazione]] per convertire i dati nel sistema metrico, quando appropriato. In queste domande sono conservati altezza e peso in unità metriche, che confluiscono nella base dati, con l'indice IMC e lo stato di peso forma, senza che si debba creare codice JavaScript personalizzato.

Negli esempi successivi è mostrato come mostrare funzioni, matematiche o d'altro tipo, all'interno di report personalizzati.
Prima dell'inserimento di dati, la pagina appare in questo modo.
Grazie alla logica condizionale, se non sono presenti dati numerici le celle restano vuote invece di mostrare "NaN" o "Divide by Zero".

<center>[[File:tailoring4.jpg]]</center>

Dopo che sono stati inseriti i numeri, il report della pagina è modificato e mostra il calcolo eseguito e il suo risultato.

<center>[[File:tailoring5.jpg]]</center>

Nel sondaggio di esempio sono presenti molti altri esempi. Ad esempio, nella schermata seguente è mostrata una delle tante maniere nelle quali è possibile compilare la pagina Dynamic Relevance.
Come illustrato nelle note, è possibile provare a inserite diverse età e, in particolare, all'inserimento di combinazioni incompatibili di risposte sono mostrati messaggi divertenti.
Si noti anche che se si dichiara di avere più di un figlio, il messaggio dirà "I hope you enjoy playing with your X children" ("spero che ti diverta a giocare con i tuoi X bambini"), piuttosto che declinare la frase al singolare. Con questo si mostra come si possono personalizzare singole frasi per adattarle al genere e/o al numero dei sostantivi utilizzati, come anche si possono anche coniugare facilmente verbi.

<center>[[File:tailoring6.jpg]]</center>

==Download==

Per scaricare il sondaggio di esempio, utilizzare il link seguente: [[Media:LS3_em_tailoring.zip|LS3_em_tailoring.zip]].

=Sample Census=

=Introduzione=

Questo è un esempio di censimento nel quale si chiede quante persone costituiscono il nucleo familiare.

Mostra in che modo è possibile utilizzare la rilevanza a livello di gruppo per implementare facilmente la ripetizione ciclica di domande ("loop"). Dopo aver creato il gruppo per "Person 1", questo è stato esportato. Avendo utilizzato nomi di variabile qcode del tipo p1_name, si è potuto utilizzare un editor di testo per modificare velocemente e re-importare i gruppi più volte: sono stati sufficienti 10 secondi per modificare e re-importare ogni nuovo gruppo mantenendo nomi unici per le variabili e logica corretta a livello di gruppo.

Sarebbe stato possibile utilizzare anche l'opzione [[Copy question|copia domanda]] ma l'opzione mostrata è più rapida.

Si vede anche come evitare che il messaggio di Fine compilazione appaia solo quando il sondaggio è effettivamente terminato (vale a dire, quando tutti i gruppi obbligatori sono completati).

==Dimostrazione delle caratteristiche di EM==

#'''Rilevanza a livello di gruppi''' - I gruppi successivi ("Person 1-5") sono mostrati solo fino al numero di conviventi specificati;
#'''Adattamento''' - Il report finale riassume i dati demografici di ciascun convivente;
#'''Visualizzazione progressiva delle domande''' - Sia in gruppo che in modalità pagina singola, le domande successive sono mostrate mano a mano che le precedenti ricevono una risposta.

==Screenshot==

Il sondaggio produce un report dinamico nel quale sono mostrati i dati demografici dello specifico numero di conviventi:

<center>[[File:census.jpg]]</center>

Se il sondaggio è mostrato una domanda alla volta, si vede che l'indice si adatta alle domande. Dal momento che l'utente ha scritto che la persona è una donna, la domanda (in inglese) è declinata al femminile. E visto che è stato inserito il suo nome, "Mary", la domanda successiva chiede "How old is Mary?" ("Quanti anni ha Mary?").

<center>[[File:census2.jpg]]</center>

==Download==

Usare il link seguente per scaricare il sondaggio di esempio: [[Media:LS3_group_relevance.zip|LS3_group_relevance.zip]].

=Filtri concatenati per Array=

==Panoramica==

Il sondaggio seguente si basa su un originale gentilmente concesso da Joy Lane Research, LLC.

==Screenshot==

Nelle immagini seguenti, notare che.
*Q2 mostra solo i prodotti selezionati (con array_filter) in Q01
*Q02 mostra anche "Another product", ovvero il testo inserito nel campo "Other electronic" di Q01
*Q04 mostra solo prodotti in Q02 che sono stati selezionati (filtraggio concatenato)
*Q05 mostra solo prodotti in Q02 che NON sono stati selezioati in Q02 (filtraggio concatenato che utilizza array_filter_exclude)

<center>[[File:cascading_array_filter.jpg]]</center>

<center>[[File:cascading_array_filter2.jpg]]</center>

==Download==

Utilizzare il seguente link per scaricare l'esempio precedente:[[Media:ls2_cascading_array_filter.lss|LS2_cascading_array_filter sondaggio di esempio]].

=Adattamento/Piping utilizzando tutti i tipi di domanda e attributi=

==Panoramica==

Se siete confusi su come nominare le vostre variabili (SGQA o Qcode), non siete soli. Anche se la documentazione descrive [[ExpressionScript - Presentation#Access to Variables|come comporre nomi di variabile Qcode]], niente è meglio che osservare una demo funzionante. Il sondaggio seguente mostra come accedere ad attributi di domanda e risposte utilizzando ExpressionScript.

{{Note|Per questo esempio, si consiglia di disattivare l'editor HTML integrato (o di convertirlo in modalità popup) durante la modifica di questo sondaggio. L'editor HTML può impiegare un minuto o più per eseguire il rendering dei rapporti HTML di grandi dimensioni in modalità di modifica.}}

==Contenuto==

*Esempi per ogni tipo di domanda
*Sono inclusi tutti i tipi di domande che utilizzano "altro", in modo da mostrare come ciò influisca sulla denominazione delle variabili
*Valori predefiniti per tutti i tipi di domanda che accettano valori predefiniti
*Adattamento - Rapporti in pagina e fuori pagina che mostrano tutti i 16 suffissi disponibilil per EM.
*Questi report mostrano tutti i dati attualmente inseriti (quindi mostrano come generare i propri rapporti stampabili per gli utenti al posto della stampa diretta della schermata delle risposte)
*Qcode corretto e denominazione SGQA di tutte le variabili

==Screenshot==

Questo è un sondaggio enorme, quindi abbiamo scelto di non includere schermate. Consigliamo piuttosto di scaricarlo e giocarci un po'.

==Download==

Fare clic sul collegamento seguente per scaricare il sondaggio: [[Media:ls2_EM_question_attributes.lss|LS3_EM_question_attributes.lss]]

=Validazione tradizionale, rivisitata=

==Panoramica==

Dimostrazione di tutti i tipi di convalida che fanno uso di espressioni e di come esse influiscono su ciascuno dei tipi di domanda che supportano la convalida. In molti casi, i suggerimenti di convalida sono inizialmente nascosti e vengono visualizzati solo se una domanda non soddisfa i criteri di convalida (scomparendo, pertanto, una volta che la domanda superi i criteri di convalida).

==Dimostrazione dei tipi di convalida==

#[[QS:Min_num_value_n|min_num_value_n]] - valore minimo per una risposta#[[QS:Max_num_value_n|max_num_value_n]] - valore massimo per una risposta
#[[QS:Min_answers|min_answers]] - numero minimo di risposte obbligatorie
#[[QS:Max_answers|max_answers]] - numero massimo di risposte consentite
#[[QS:Multiflexible_min|multiflexible_min]] - numero minimo consentito per una risposta (per il tipo di domanda con numeri multiflexi)
#[[QS:Multiflexible_max|multiflexible_max]] - valore massimo consentito per una risposta (per il tipo di domanda con numeri multiflexi)
#[[QS:Min_num_value|min_num_value]] - valore minimo consentito per la somma di tutte le risposte alla domanda
#[[QS:Max_num_value|max_num_value]] - valore massimo consentito per la somma di tutte le risposte alla domanda
#[[QS:Equals_num_value|equals_num_value]] - la somma di tutte le risposte alla domanda deve essere pari a questo valore
#[[QS:Preg_validation|validation]] - espressione regolare di convalida per la domanda - può essere applicata a singole celle

==Screenshot==

Utilizzando nuovi stili CSS, ogni tipo di convalida mostra un suggerimento separato. Se vengono visualizzati, possono essere nascosti tramite l'opzione hide_tip. L'opzione predefinita è mostrarli con un carattere rosso se la domanda non soddisfa i criteri di convalida e verde se li supera:

<center>[[File:validation1.jpg]]</center>

Un utente non può inviare una pagina con errori di convalida. Verrà immediatamente avvertito se ha inserito informazioni errate:

<center>[[File:validation3.jpg]]</center>

La convalida può essere applicata a singole celle all'interno di un array, come in questo esempio, in cui le convalide delle espressioni regolari assicurano che ogni voce sia un numero di telefono statunitense formattato correttamente, incluso il prefisso.

<center>[[File:validation4.jpg]]</center>

==Download==

Per scaricare l'esempio precedente, fare clic sul seguente collegamento: [[Media:LS3_Validation_tests.zip|LS3_Validation_tests.zip]].

=Equazioni di convalida=

==Panoramica==

A volte è necessaria una convalida personalizzata che non può essere ottenuta utilizzando i tradizionali criteri minino/massimo. Per questo, sarà necessario utilizzare le opzioni em_validation_q e em_validation_sq, che consentono di costruire equazioni di convalida complesse rispettivamente a livello di domanda e sottodomanda.

{{Nota|A livello di sottodomanda, introduciamo anche la variabile "this" per semplificare la convalida di ogni cella in un array senza dover conoscere il nome della variabile. Per maggiori dettagli su questo aspetto, fare clic qui.}}

==Dimostrazione delle caratteristiche di EM==

#[[QS:Em_validation_q|em_validation_q]] - questa equazione determina se l'intera domanda è valida
#[[QS:Em_validation_q_tip|em_validation_q_tip]] - questo è il messaggio da mostrare se la domanda non supera i criteri di convalida em_validation_q
#[[QS:Em_validation_sq|em_validation_sq]] - questa equazione determina se ogni sottodomanda (o cella dell'array) è valida
#[[QS:Em_validation_sq_tip|em_validation_sq_tip]] - questo messaggio è mostrato se esistono sottodomande non valide.

In generale, quando si utilizza em_validation_sq, se una cella non è valida il colore di sfondo di quella cella diventa rosso per indicare che c'è un errore.

==Screenshot==

<center>[[File:sqvalidation.jpg]]</center>

Questa domanda assicura che l'età dei tuoi figli sia inserita in ordine decrescente applicando questa equazione di convalida:

<syntaxhighlight lang="php" enclose="div">q1_sq1 >= q1_sq2 && q1_sq2 >= q1_sq3 && q1_sq3 >= q1_sq4</syntaxhighlight>

<center>[[File:sqvalidation2.jpg]]</center>

<hr width="50%" style="margin:auto">

Nell'esempio seguente, la convalida garantisce che non venga data risposta a più di 3 domande su una determinata riga applicando questa equazione di convalida:

<syntaxhighlight lang="php" enclose="div">(sum(Test_A_1, Test_A_2, Test_A_3, Test_A_4, Test_A_5) <= 3) && (sum(Test_B_1, Test_B_2, Test_B_3, Test_B_4, Test_B_5) <= 3) && (sum(Test_C_1, Test_C_2, Test_C_3, Test_C_4, Test_C_5) <= 3)</syntaxhighlight>

Si può anche scrivere come segue e Limesurvey convertirà il tutto automaticamente a run-time nella espressione elencata sopra.

<syntaxhighlight lang="php" enclose="div">(sum(self.sq_A) <= 3) && (sum(self.sq_B) <= 3) && (sum(self.sq_C) <= 3)</syntaxhighlight>

<center>[[File:sqvalidation3.jpg]]</center>

==Download==

Per scaricare il sondaggio di esempio utilizzato negli esempi precedenti, agire sul link seguente: [[Media:ls2_test_em_sq_validation.lss|ls2_test_em_sq_validation.lss]].

=Rilevanza per sottodomande=

==Panoramica==

Questa sezione mostra come possono interagire array_filter e criteri di convalida. Per le convalide che si applicano alle somme, vengono considerati solo i valori rilevanti (visibili).

==Dimostrazione delle caratteristiche di EM==

#[[QS:Array_filter|array_filter]]
#[[QS:Array filter exclude|array_filter_exclude]]
#[[QS:Min_num_value|min_num_value]]
#[[QS:Max num value|max_num_value]]
#[[QS:equals_num_value|equals_num_value]]

Mostra anche il reporting dinamico del numero di domande a cui è stata data risposta nelle domande principali.

==Screenshot==

La modifica del numero di righe visibili cambia dinamicamente la somma. Contrassegnare una sottodomanda come non rilevante non ne cancella il valore. Piuttosto, se non è rilevante, i suoi valori non contribuiscono a nessuna equazione.

<center>[[File:sqrel1.jpg]][[File:Sqrelver12.png]]</center>

Si noti cosa accade quando si seleziona l'opzione "Fifth subquestion" per la prima domanda '''"Which rows should appear below"'''. La somma della seconda domanda "Enter some numbers" ora è 5. Anche se la sottodomanda 5 ha ancora il vaore 14 (cioè, se si deseleziona la quinda sottodomanda, si vedrà nuovamente il valore 14), quel valore non contribuisce alla somma perché considerato non rilevante. Tutti i dati non rilevanti sono cancellati (segnati nel database come NULL) al momento dell'invio, ma il valore resta disponibile sulla pagina nel caso gli utenti vogliano o debbano cambiare idea sulle risposte.

<center>[[File:sqrel2.jpg]]</center>

==Download==

Utilizzare il seguente link per scaricare il nostro esempio: [[Media:ls2_subquestion_relevance.lss|ls2_subquestion_relevance.lss]].

=Utilizzo della virgola come separatore di radice (punto decimale)=

==Panoramica==

ExpressionScript garantisce che solo i numeri validi possano essere inseriti nei campi numerici. Se si inserisce un numero non valido, si viene avvisati che qualcosa non va (ad esempio, nel caso del tema "fruity", l'intera domanda viene scritta in carattere rosso).

Si noti che i valori numerici vengono sempre convertiti utilizzando un punto come separatore all'interno del database. In questo modo, le analisi statistiche funzioneranno in modo appropriato.

Per cambiare il separatore decimale, accedere alle opzioni [[Text elements|Elementi di testo]] che si trovano nel menù [[Survey_settings|Impostazioni]] e cercare la funzionalità [[Text_elements#Survey_text_elements_panel|Simbolo del decimale]].

{{Note|Per ulteriori informazioni sul punto decimale, si veda la pagina wiki [https://en.wikipedia.org/wiki/Radix_point|Radix_point] (in inglese).}}

==Tipi di domande che utilizzano il punto decimale==

#[[Question type - Numerical input|Inserimento numerico]] <nowiki>[</nowiki>N]
#[[Question type - Multiple numerical input|Inserimento numerico multiplo]] <nowiki>[</nowiki>K]
#[[Question type - Array (Numbers)|Array (Numeri)]] <nowiki>[</nowiki>:]
#[[Question type - Array (Texts)|Array (Testo)]] <nowiki>[</nowiki>;], utilizzando l'attributo [[QS:Numbers_only|numbers_only]]
#[[Question type - List (Radio)|List (radio)]] <nowiki>[</nowiki>L], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Short free text|Testo breve]] <nowiki>[</nowiki>S], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Multiple short text|Testo breve multiplo]] <nowiki>[</nowiki>Q], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Multiple choice|Scelta multipla]] <nowiki>[</nowiki>M], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Multiple choice with comments|Scelta multipla con commenti]] <nowiki>[</nowiki>P], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]

==Screenshot==

Si può notare negli screenshot qui sotto che la virgola può essere utilizzata come punto decimale.

<center>[[File:radix1.jpg]]</center>

==Download==

Per scaricare l'esempio precedente, fare clic sul link seguente: [[Media:ls2_comma_as_radix_separator.lss|ls2_comma_as_radix_separator.lss]].

=Gruppi di randomizzazione=

==Panoramica==

Questo sondaggio mostra come utilizzare l'attributo '''random_group'''.

Se viene utilizzato questo attributo, ogni volta che si avvia il sondaggio l'ordine delle domande viene randomizzato. Tuttavia, una volta avviato il sondaggio, l'ordine di randomizzazione rimane fisso, anche se si cambia lingua.

==Screenshot==

Guardiamo insieme l'esempio seguente. La prima domanda casuale sulla pagina sarà Q1, Q4 o Q7. La seconda domanda randomizzata sulla pagina sarà Q2, Q5 o Q8.

<center>[[File:random1.jpg]]</center>

Ecco la randomizzazione generata la prima volta che ho testato questo sondaggio.

<center>[[File:random2.jpg]]</center>

La seconda volta che ho testato il sondaggio è stata generata una diversa randomizzazione.

<center>[[File:random3.jpg]]</center>

Ma, quando sono passato al francese (senza ricominciare il sondaggio), l'ordine di randomizzazione è rimasto intatto.

<center>[[File:random4.jpg]]</center>

==Download==

Per scaricare l'esempio precedente, fare clic sul link seguente: [[Media:Randomization_Group_Test.lss|Randomization_Group_Test.lss]]

=Presentare una sola domanda a caso per gruppo=

==Panoramica==

Questo sondaggio mostra come configurare un sondaggio per visualizzare in modo casuale una domanda per gruppo. In esso ci sono 5 gruppi di 6 domande ciascuno. All'inizio, nel Gruppo 0, vengono compilate cinque domande nascoste di equazioni, chiamate ask1-ask5. Ognuna ha il valore di {floor(rand(1,6.9999))} nel campo di testo della domanda, il che significa che le variabili ask1-ask5 avranno ciascuna un valore compreso tra 1 e 6. Quindi, ogni domanda nel gruppo ha un equazione di rilevanza come "ask1 == N", dove N è l'ennesima domanda nel gruppo (quindi la terza domanda nel gruppo 1 ha l'equazione di rilevanza "ask1 == 3").

Questo sondaggio funziona altrettanto bene nelle modalità "un sondaggio alla volta", "gruppo per gruppo" e "domanda per domanda". Poiché la randomizzazione è impostata nel primo gruppo e quel gruppo è effettivamente nascosto (dal momento che tutte le domande ask1-ask5 sono nascoste), la randomizzazione rimane la stessa per ciascun soggetto; ma ogni soggetto diverso avrà una randomizzazione distinta.

==Dimostrazione delle caratteristiche==

#[[Question type - Equation|Tipo di domanda dell'equazione]]
#Funzioni di randomizzazione
#Funzione condizionale (if)

==Screenshot==

Questo è il Gruppo0, che utilizza il [[Question type - Equation|Tipo di domanda equazione]] per selezionare valori casuali da 1 a 6 per ogni gruppo (eccetto l'ultimo gruppo, che ha solo 4 domande). Nota che la funzione "if()" controlla prima se ask1 è già stato impostato e, in tal caso, utilizza quel valore. Se il valore non è stato impostato, utilizza un valore casuale per impostare il valore di ask1.

<center>[[File:randq3.jpg]]</center>

Questo gruppo mostra come la variabile (ask4) del Gruppo0 viene utilizzata per controllare quale domanda è visibile all'interno del quarto gruppo.

<center>[[File:randq2.jpg]]</center>

==Download==

Per scaricare il sondaggio di esempio precedente, fare clic qui: [[Media: limesurvey_survey_55164.lss|Esempio di domande casuali all'interno di un gruppo]].

=Porre a caso un numero specifico di domande in un gruppo (un sottoinsieme delle domande)=

{{Avviso|Questo si applica solo a tutte le domande casuali di un gruppo e solo se viene utilizzato il formato [[General_settings # General_settings_panel |Un gruppo per pagina oppure Tutte le domande in una pagina]].}}

==Panoramica==

Questo sondaggio mostra come porre un sottoinsieme casuale di domande in un gruppo. Ad esempio, mostra 5 domande casuali su 10 domande situate all'interno di un gruppo.

Il sondaggio ha un gruppo contenente 10 domande. A tutte le domande viene assegnato lo stesso [[QS: Random_group|nome del gruppo di randomizzazione]]. Di conseguenza, verranno visualizzate in ordine casuale al caricamento della pagina. A ogni domanda viene assegnata un'equazione di rilevanza secondo cui la somma di "[[ExpressionScript - Presentation#Access to Variables|relevanceStatus]]" di tutte le altre domande nel gruppo è inferiore al numero di domande che si desidera mostrare. Poiché "[[ExpressionScript - Presentation#Access to Variables|relevanceStatus]]" viene assegnato durante il rendering delle domande, questo corrisponde effettivamente al numero di domande precedenti.

Quindi, nel nostro esempio "5 su 10", l'equazione per Q1 sarebbe:

<syntaxhighlight lang="php" enclose="div">sum(Q2.relevanceStatus, Q3.relevanceStatus, Q4.relevanceStatus, Q5.relevanceStatus, Q6.relevanceStatus, Q7.relevanceStatus, Q8.relevanceStatus, Q9.relevanceStatus, Q10.relevanceStatus) LT 5</syntaxhighlight>

Per Q2, sarebbe:

<syntaxhighlight lang="php" enclose="div">sum(Q1.relevanceStatus, Q3.relevanceStatus, Q4.relevanceStatus, Q5.relevanceStatus, Q6.relevanceStatus, Q7.relevanceStatus, Q8.relevanceStatus, Q9.relevanceStatus, Q10.relevanceStatus) LT 5</syntaxhighlight>

E così via...

==Dimostrazione delle caratteristiche==

#[[ExpressionScript - Presentation#Access to variables|variabile relevanceStatus]]
#[[QS:Random group|Randomizzazione]]

==Download==

Per scaricare l'esempio precedente, fare clic sul link seguente: [[Media:Random_5_out_of_10.lss|Random 5 out of 10 survey example]].

=Classificazione di un elenco di prodotti inserito dall'utente=

==Panoramica==

L'esempio seguente mostra come chiedere agli utenti di elencare una serie di prodotti che li interessano e quindi chiedere loro di valutarli.

==Dimostrazione delle caratteristiche di ES==

#'''Personalizzazione delle risposte''' - quando si valutano i prodotti, le etichette provengono dal campo dei commenti della precedente domanda a scelta multipla
# '''Scale personalizzate''' - molte opzioni avanzate delle domande, come i titoli delle scale, possono essere anche personalizzate.

==Screenshot==

This image shows that even though only products 1,3, and 5 were selected, only those 3 are displayed (using the [[QS:Array_filter|array_filter]] attribute). Moreover, the row labels in the second question are either the product numbers (if nothing is entered into the comment field) or the contents of the comment fields.

<center>[[File:mcc_filter1.jpg]]</center>

This image shows how the tailored answers are specified:

<center>[[File:mcc_filter2.jpg]]</center>

Here is the Show Logic File for that question, which lets us verify that the conditional logic works as desired (e.g., to see whether there are any syntax errors):

<center>[[File:mcc_filter3.jpg]]</center>

The next image shows a group in which you specify a 5 point rating scale (Options 1-5), the title of the scale, and the products you want to rate. The final question shows that each of the parts of the array question can be tailored:

<center>[[File:mcc_filter4.jpg]]</center>

The next image shows the logic file view of the last question. As you can observe, the subquestions, answers, and scale headers can be tailored.

<center>[[File:mcc_filter5.jpg]]</center>

==Download==

To download the survey example from above, click on the following link: [[Media:Rating_User-Entered_List_of_Products_Survey.zip|Rating user-entered list of products survey example]].

Translations:ExpressionScript sample surveys/167/it

2020-10-19T03:17:28Z

Ritapas: Created page with "==Screenshot=="

==Screenshot==

ExpressionScript sample surveys/it

2020-10-19T03:17:26Z

Ritapas: Created page with "#'''Personalizzazione delle risposte''' - quando si valutano i prodotti, le etichette provengono dal campo dei commenti della precedente domanda a scelta multipla # '''Scale p..."

<languages />

__TOC__

=Introduzione=

il modo migliore per imparare ad usare ExpressionScript è provare esempi funzionanti e modificarli secondo le proprie esigenze.

Nel testo seguente sono disponibili alcuni sondaggi di esempi per valutare come si può usare EM per migliorare i propri sondaggi. Questi sondaggi sono anche disponibili nella directory /docs/demosurvey della distribuzione.

=Rilevanza, Adattamento ed Equazioni=

==Panoramica==

L'esempio seguente calcola l'IMC (Indice di Massa Corporea, in inglese Body Mass Index) del partecipante. L'esempio mostra diverse caratteristiche, illustrate più avanti.

==Dimostrazione delle caratteristiche dell'EM==

#'''Rilevanza''' - supporto per logica condizionale "potente";
#'''Piping / Tailoring''' - offre la possibilità di concatenare o adattare le risposte e i metadati delle domande;
#'''Adattamento Dinamico''' - report che cambiano sulla pagina stesas mentre si digitano le risposte.
#'''Micro-Tailoring''' - adattamento condizionale all'interno di frasi e report con l'utilizzo di istruzioni if()
#'''Equazioni''' - un nuovo [[Question type - Equation|tipo di domanda]] che consente l'esecuzione di calcoli, anche nascosti, e la conservazione dei risultati sul database
#'''Convalida dondizionale''' - criteri di convalida, come ad esempio il valore minimo accettabile, possono essere ora condizionali, vale a dire basati su equazioni.

==Screenshot==

Questo esempio calcola l'Indice di Massa Corporea, un indice basato sul peso e l'altezza che determina se si è sottopeso, normopeso, sovrappeso o obesi. All'inizio, sono mostrate solo le quattro domande obbligatorie.

<center>[[File:tailoring1.jpg]]</center>

Dopo aver inserito le informazioni (ed aver scelto se si desidera utilizzare unità metriche o meno), è mostrato un report personalizzato che riassume i dati inseriti e mostra l'indicatore dello stato di peso forma.

<center>[[File:tailoring2.jpg]]</center>

Ecco un altro esempio, che utilizza unità non metriche per mostrare come i risultati cambiano dinamicamente:

<center>[[File:tailoring3.jpg]]</center>

Sono state inserite [[Question type - Equation|domande nascoste di tipo Equazione]] per convertire i dati nel sistema metrico, quando appropriato. In queste domande sono conservati altezza e peso in unità metriche, che confluiscono nella base dati, con l'indice IMC e lo stato di peso forma, senza che si debba creare codice JavaScript personalizzato.

Negli esempi successivi è mostrato come mostrare funzioni, matematiche o d'altro tipo, all'interno di report personalizzati.
Prima dell'inserimento di dati, la pagina appare in questo modo.
Grazie alla logica condizionale, se non sono presenti dati numerici le celle restano vuote invece di mostrare "NaN" o "Divide by Zero".

<center>[[File:tailoring4.jpg]]</center>

Dopo che sono stati inseriti i numeri, il report della pagina è modificato e mostra il calcolo eseguito e il suo risultato.

<center>[[File:tailoring5.jpg]]</center>

Nel sondaggio di esempio sono presenti molti altri esempi. Ad esempio, nella schermata seguente è mostrata una delle tante maniere nelle quali è possibile compilare la pagina Dynamic Relevance.
Come illustrato nelle note, è possibile provare a inserite diverse età e, in particolare, all'inserimento di combinazioni incompatibili di risposte sono mostrati messaggi divertenti.
Si noti anche che se si dichiara di avere più di un figlio, il messaggio dirà "I hope you enjoy playing with your X children" ("spero che ti diverta a giocare con i tuoi X bambini"), piuttosto che declinare la frase al singolare. Con questo si mostra come si possono personalizzare singole frasi per adattarle al genere e/o al numero dei sostantivi utilizzati, come anche si possono anche coniugare facilmente verbi.

<center>[[File:tailoring6.jpg]]</center>

==Download==

Per scaricare il sondaggio di esempio, utilizzare il link seguente: [[Media:LS3_em_tailoring.zip|LS3_em_tailoring.zip]].

=Sample Census=

=Introduzione=

Questo è un esempio di censimento nel quale si chiede quante persone costituiscono il nucleo familiare.

Mostra in che modo è possibile utilizzare la rilevanza a livello di gruppo per implementare facilmente la ripetizione ciclica di domande ("loop"). Dopo aver creato il gruppo per "Person 1", questo è stato esportato. Avendo utilizzato nomi di variabile qcode del tipo p1_name, si è potuto utilizzare un editor di testo per modificare velocemente e re-importare i gruppi più volte: sono stati sufficienti 10 secondi per modificare e re-importare ogni nuovo gruppo mantenendo nomi unici per le variabili e logica corretta a livello di gruppo.

Sarebbe stato possibile utilizzare anche l'opzione [[Copy question|copia domanda]] ma l'opzione mostrata è più rapida.

Si vede anche come evitare che il messaggio di Fine compilazione appaia solo quando il sondaggio è effettivamente terminato (vale a dire, quando tutti i gruppi obbligatori sono completati).

==Dimostrazione delle caratteristiche di EM==

#'''Rilevanza a livello di gruppi''' - I gruppi successivi ("Person 1-5") sono mostrati solo fino al numero di conviventi specificati;
#'''Adattamento''' - Il report finale riassume i dati demografici di ciascun convivente;
#'''Visualizzazione progressiva delle domande''' - Sia in gruppo che in modalità pagina singola, le domande successive sono mostrate mano a mano che le precedenti ricevono una risposta.

==Screenshot==

Il sondaggio produce un report dinamico nel quale sono mostrati i dati demografici dello specifico numero di conviventi:

<center>[[File:census.jpg]]</center>

Se il sondaggio è mostrato una domanda alla volta, si vede che l'indice si adatta alle domande. Dal momento che l'utente ha scritto che la persona è una donna, la domanda (in inglese) è declinata al femminile. E visto che è stato inserito il suo nome, "Mary", la domanda successiva chiede "How old is Mary?" ("Quanti anni ha Mary?").

<center>[[File:census2.jpg]]</center>

==Download==

Usare il link seguente per scaricare il sondaggio di esempio: [[Media:LS3_group_relevance.zip|LS3_group_relevance.zip]].

=Filtri concatenati per Array=

==Panoramica==

Il sondaggio seguente si basa su un originale gentilmente concesso da Joy Lane Research, LLC.

==Screenshot==

Nelle immagini seguenti, notare che.
*Q2 mostra solo i prodotti selezionati (con array_filter) in Q01
*Q02 mostra anche "Another product", ovvero il testo inserito nel campo "Other electronic" di Q01
*Q04 mostra solo prodotti in Q02 che sono stati selezionati (filtraggio concatenato)
*Q05 mostra solo prodotti in Q02 che NON sono stati selezioati in Q02 (filtraggio concatenato che utilizza array_filter_exclude)

<center>[[File:cascading_array_filter.jpg]]</center>

<center>[[File:cascading_array_filter2.jpg]]</center>

==Download==

Utilizzare il seguente link per scaricare l'esempio precedente:[[Media:ls2_cascading_array_filter.lss|LS2_cascading_array_filter sondaggio di esempio]].

=Adattamento/Piping utilizzando tutti i tipi di domanda e attributi=

==Panoramica==

Se siete confusi su come nominare le vostre variabili (SGQA o Qcode), non siete soli. Anche se la documentazione descrive [[ExpressionScript - Presentation#Access to Variables|come comporre nomi di variabile Qcode]], niente è meglio che osservare una demo funzionante. Il sondaggio seguente mostra come accedere ad attributi di domanda e risposte utilizzando ExpressionScript.

{{Note|Per questo esempio, si consiglia di disattivare l'editor HTML integrato (o di convertirlo in modalità popup) durante la modifica di questo sondaggio. L'editor HTML può impiegare un minuto o più per eseguire il rendering dei rapporti HTML di grandi dimensioni in modalità di modifica.}}

==Contenuto==

*Esempi per ogni tipo di domanda
*Sono inclusi tutti i tipi di domande che utilizzano "altro", in modo da mostrare come ciò influisca sulla denominazione delle variabili
*Valori predefiniti per tutti i tipi di domanda che accettano valori predefiniti
*Adattamento - Rapporti in pagina e fuori pagina che mostrano tutti i 16 suffissi disponibilil per EM.
*Questi report mostrano tutti i dati attualmente inseriti (quindi mostrano come generare i propri rapporti stampabili per gli utenti al posto della stampa diretta della schermata delle risposte)
*Qcode corretto e denominazione SGQA di tutte le variabili

==Screenshot==

Questo è un sondaggio enorme, quindi abbiamo scelto di non includere schermate. Consigliamo piuttosto di scaricarlo e giocarci un po'.

==Download==

Fare clic sul collegamento seguente per scaricare il sondaggio: [[Media:ls2_EM_question_attributes.lss|LS3_EM_question_attributes.lss]]

=Validazione tradizionale, rivisitata=

==Panoramica==

Dimostrazione di tutti i tipi di convalida che fanno uso di espressioni e di come esse influiscono su ciascuno dei tipi di domanda che supportano la convalida. In molti casi, i suggerimenti di convalida sono inizialmente nascosti e vengono visualizzati solo se una domanda non soddisfa i criteri di convalida (scomparendo, pertanto, una volta che la domanda superi i criteri di convalida).

==Dimostrazione dei tipi di convalida==

#[[QS:Min_num_value_n|min_num_value_n]] - valore minimo per una risposta#[[QS:Max_num_value_n|max_num_value_n]] - valore massimo per una risposta
#[[QS:Min_answers|min_answers]] - numero minimo di risposte obbligatorie
#[[QS:Max_answers|max_answers]] - numero massimo di risposte consentite
#[[QS:Multiflexible_min|multiflexible_min]] - numero minimo consentito per una risposta (per il tipo di domanda con numeri multiflexi)
#[[QS:Multiflexible_max|multiflexible_max]] - valore massimo consentito per una risposta (per il tipo di domanda con numeri multiflexi)
#[[QS:Min_num_value|min_num_value]] - valore minimo consentito per la somma di tutte le risposte alla domanda
#[[QS:Max_num_value|max_num_value]] - valore massimo consentito per la somma di tutte le risposte alla domanda
#[[QS:Equals_num_value|equals_num_value]] - la somma di tutte le risposte alla domanda deve essere pari a questo valore
#[[QS:Preg_validation|validation]] - espressione regolare di convalida per la domanda - può essere applicata a singole celle

==Screenshot==

Utilizzando nuovi stili CSS, ogni tipo di convalida mostra un suggerimento separato. Se vengono visualizzati, possono essere nascosti tramite l'opzione hide_tip. L'opzione predefinita è mostrarli con un carattere rosso se la domanda non soddisfa i criteri di convalida e verde se li supera:

<center>[[File:validation1.jpg]]</center>

Un utente non può inviare una pagina con errori di convalida. Verrà immediatamente avvertito se ha inserito informazioni errate:

<center>[[File:validation3.jpg]]</center>

La convalida può essere applicata a singole celle all'interno di un array, come in questo esempio, in cui le convalide delle espressioni regolari assicurano che ogni voce sia un numero di telefono statunitense formattato correttamente, incluso il prefisso.

<center>[[File:validation4.jpg]]</center>

==Download==

Per scaricare l'esempio precedente, fare clic sul seguente collegamento: [[Media:LS3_Validation_tests.zip|LS3_Validation_tests.zip]].

=Equazioni di convalida=

==Panoramica==

A volte è necessaria una convalida personalizzata che non può essere ottenuta utilizzando i tradizionali criteri minino/massimo. Per questo, sarà necessario utilizzare le opzioni em_validation_q e em_validation_sq, che consentono di costruire equazioni di convalida complesse rispettivamente a livello di domanda e sottodomanda.

{{Nota|A livello di sottodomanda, introduciamo anche la variabile "this" per semplificare la convalida di ogni cella in un array senza dover conoscere il nome della variabile. Per maggiori dettagli su questo aspetto, fare clic qui.}}

==Dimostrazione delle caratteristiche di EM==

#[[QS:Em_validation_q|em_validation_q]] - questa equazione determina se l'intera domanda è valida
#[[QS:Em_validation_q_tip|em_validation_q_tip]] - questo è il messaggio da mostrare se la domanda non supera i criteri di convalida em_validation_q
#[[QS:Em_validation_sq|em_validation_sq]] - questa equazione determina se ogni sottodomanda (o cella dell'array) è valida
#[[QS:Em_validation_sq_tip|em_validation_sq_tip]] - questo messaggio è mostrato se esistono sottodomande non valide.

In generale, quando si utilizza em_validation_sq, se una cella non è valida il colore di sfondo di quella cella diventa rosso per indicare che c'è un errore.

==Screenshot==

<center>[[File:sqvalidation.jpg]]</center>

Questa domanda assicura che l'età dei tuoi figli sia inserita in ordine decrescente applicando questa equazione di convalida:

<syntaxhighlight lang="php" enclose="div">q1_sq1 >= q1_sq2 && q1_sq2 >= q1_sq3 && q1_sq3 >= q1_sq4</syntaxhighlight>

<center>[[File:sqvalidation2.jpg]]</center>

<hr width="50%" style="margin:auto">

Nell'esempio seguente, la convalida garantisce che non venga data risposta a più di 3 domande su una determinata riga applicando questa equazione di convalida:

<syntaxhighlight lang="php" enclose="div">(sum(Test_A_1, Test_A_2, Test_A_3, Test_A_4, Test_A_5) <= 3) && (sum(Test_B_1, Test_B_2, Test_B_3, Test_B_4, Test_B_5) <= 3) && (sum(Test_C_1, Test_C_2, Test_C_3, Test_C_4, Test_C_5) <= 3)</syntaxhighlight>

Si può anche scrivere come segue e Limesurvey convertirà il tutto automaticamente a run-time nella espressione elencata sopra.

<syntaxhighlight lang="php" enclose="div">(sum(self.sq_A) <= 3) && (sum(self.sq_B) <= 3) && (sum(self.sq_C) <= 3)</syntaxhighlight>

<center>[[File:sqvalidation3.jpg]]</center>

==Download==

Per scaricare il sondaggio di esempio utilizzato negli esempi precedenti, agire sul link seguente: [[Media:ls2_test_em_sq_validation.lss|ls2_test_em_sq_validation.lss]].

=Rilevanza per sottodomande=

==Panoramica==

Questa sezione mostra come possono interagire array_filter e criteri di convalida. Per le convalide che si applicano alle somme, vengono considerati solo i valori rilevanti (visibili).

==Dimostrazione delle caratteristiche di EM==

#[[QS:Array_filter|array_filter]]
#[[QS:Array filter exclude|array_filter_exclude]]
#[[QS:Min_num_value|min_num_value]]
#[[QS:Max num value|max_num_value]]
#[[QS:equals_num_value|equals_num_value]]

Mostra anche il reporting dinamico del numero di domande a cui è stata data risposta nelle domande principali.

==Screenshot==

La modifica del numero di righe visibili cambia dinamicamente la somma. Contrassegnare una sottodomanda come non rilevante non ne cancella il valore. Piuttosto, se non è rilevante, i suoi valori non contribuiscono a nessuna equazione.

<center>[[File:sqrel1.jpg]][[File:Sqrelver12.png]]</center>

Si noti cosa accade quando si seleziona l'opzione "Fifth subquestion" per la prima domanda '''"Which rows should appear below"'''. La somma della seconda domanda "Enter some numbers" ora è 5. Anche se la sottodomanda 5 ha ancora il vaore 14 (cioè, se si deseleziona la quinda sottodomanda, si vedrà nuovamente il valore 14), quel valore non contribuisce alla somma perché considerato non rilevante. Tutti i dati non rilevanti sono cancellati (segnati nel database come NULL) al momento dell'invio, ma il valore resta disponibile sulla pagina nel caso gli utenti vogliano o debbano cambiare idea sulle risposte.

<center>[[File:sqrel2.jpg]]</center>

==Download==

Utilizzare il seguente link per scaricare il nostro esempio: [[Media:ls2_subquestion_relevance.lss|ls2_subquestion_relevance.lss]].

=Utilizzo della virgola come separatore di radice (punto decimale)=

==Panoramica==

ExpressionScript garantisce che solo i numeri validi possano essere inseriti nei campi numerici. Se si inserisce un numero non valido, si viene avvisati che qualcosa non va (ad esempio, nel caso del tema "fruity", l'intera domanda viene scritta in carattere rosso).

Si noti che i valori numerici vengono sempre convertiti utilizzando un punto come separatore all'interno del database. In questo modo, le analisi statistiche funzioneranno in modo appropriato.

Per cambiare il separatore decimale, accedere alle opzioni [[Text elements|Elementi di testo]] che si trovano nel menù [[Survey_settings|Impostazioni]] e cercare la funzionalità [[Text_elements#Survey_text_elements_panel|Simbolo del decimale]].

{{Note|Per ulteriori informazioni sul punto decimale, si veda la pagina wiki [https://en.wikipedia.org/wiki/Radix_point|Radix_point] (in inglese).}}

==Tipi di domande che utilizzano il punto decimale==

#[[Question type - Numerical input|Inserimento numerico]] <nowiki>[</nowiki>N]
#[[Question type - Multiple numerical input|Inserimento numerico multiplo]] <nowiki>[</nowiki>K]
#[[Question type - Array (Numbers)|Array (Numeri)]] <nowiki>[</nowiki>:]
#[[Question type - Array (Texts)|Array (Testo)]] <nowiki>[</nowiki>;], utilizzando l'attributo [[QS:Numbers_only|numbers_only]]
#[[Question type - List (Radio)|List (radio)]] <nowiki>[</nowiki>L], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Short free text|Testo breve]] <nowiki>[</nowiki>S], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Multiple short text|Testo breve multiplo]] <nowiki>[</nowiki>Q], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Multiple choice|Scelta multipla]] <nowiki>[</nowiki>M], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]
#[[Question type - Multiple choice with comments|Scelta multipla con commenti]] <nowiki>[</nowiki>P], utilizzando l'attributo [[QS:Other_numbers_only|other_numbers_only]]

==Screenshot==

Si può notare negli screenshot qui sotto che la virgola può essere utilizzata come punto decimale.

<center>[[File:radix1.jpg]]</center>

==Download==

Per scaricare l'esempio precedente, fare clic sul link seguente: [[Media:ls2_comma_as_radix_separator.lss|ls2_comma_as_radix_separator.lss]].

=Gruppi di randomizzazione=

==Panoramica==

Questo sondaggio mostra come utilizzare l'attributo '''random_group'''.

Se viene utilizzato questo attributo, ogni volta che si avvia il sondaggio l'ordine delle domande viene randomizzato. Tuttavia, una volta avviato il sondaggio, l'ordine di randomizzazione rimane fisso, anche se si cambia lingua.

==Screenshot==

Guardiamo insieme l'esempio seguente. La prima domanda casuale sulla pagina sarà Q1, Q4 o Q7. La seconda domanda randomizzata sulla pagina sarà Q2, Q5 o Q8.

<center>[[File:random1.jpg]]</center>

Ecco la randomizzazione generata la prima volta che ho testato questo sondaggio.

<center>[[File:random2.jpg]]</center>

La seconda volta che ho testato il sondaggio è stata generata una diversa randomizzazione.

<center>[[File:random3.jpg]]</center>

Ma, quando sono passato al francese (senza ricominciare il sondaggio), l'ordine di randomizzazione è rimasto intatto.

<center>[[File:random4.jpg]]</center>

==Download==

Per scaricare l'esempio precedente, fare clic sul link seguente: [[Media:Randomization_Group_Test.lss|Randomization_Group_Test.lss]]

=Presentare una sola domanda a caso per gruppo=

==Panoramica==

Questo sondaggio mostra come configurare un sondaggio per visualizzare in modo casuale una domanda per gruppo. In esso ci sono 5 gruppi di 6 domande ciascuno. All'inizio, nel Gruppo 0, vengono compilate cinque domande nascoste di equazioni, chiamate ask1-ask5. Ognuna ha il valore di {floor(rand(1,6.9999))} nel campo di testo della domanda, il che significa che le variabili ask1-ask5 avranno ciascuna un valore compreso tra 1 e 6. Quindi, ogni domanda nel gruppo ha un equazione di rilevanza come "ask1 == N", dove N è l'ennesima domanda nel gruppo (quindi la terza domanda nel gruppo 1 ha l'equazione di rilevanza "ask1 == 3").

Questo sondaggio funziona altrettanto bene nelle modalità "un sondaggio alla volta", "gruppo per gruppo" e "domanda per domanda". Poiché la randomizzazione è impostata nel primo gruppo e quel gruppo è effettivamente nascosto (dal momento che tutte le domande ask1-ask5 sono nascoste), la randomizzazione rimane la stessa per ciascun soggetto; ma ogni soggetto diverso avrà una randomizzazione distinta.

==Dimostrazione delle caratteristiche==

#[[Question type - Equation|Tipo di domanda dell'equazione]]
#Funzioni di randomizzazione
#Funzione condizionale (if)

==Screenshot==

Questo è il Gruppo0, che utilizza il [[Question type - Equation|Tipo di domanda equazione]] per selezionare valori casuali da 1 a 6 per ogni gruppo (eccetto l'ultimo gruppo, che ha solo 4 domande). Nota che la funzione "if()" controlla prima se ask1 è già stato impostato e, in tal caso, utilizza quel valore. Se il valore non è stato impostato, utilizza un valore casuale per impostare il valore di ask1.

<center>[[File:randq3.jpg]]</center>

Questo gruppo mostra come la variabile (ask4) del Gruppo0 viene utilizzata per controllare quale domanda è visibile all'interno del quarto gruppo.

<center>[[File:randq2.jpg]]</center>

==Download==

Per scaricare il sondaggio di esempio precedente, fare clic qui: [[Media: limesurvey_survey_55164.lss|Esempio di domande casuali all'interno di un gruppo]].

=Porre a caso un numero specifico di domande in un gruppo (un sottoinsieme delle domande)=

{{Avviso|Questo si applica solo a tutte le domande casuali di un gruppo e solo se viene utilizzato il formato [[General_settings # General_settings_panel |Un gruppo per pagina oppure Tutte le domande in una pagina]].}}

==Panoramica==

Questo sondaggio mostra come porre un sottoinsieme casuale di domande in un gruppo. Ad esempio, mostra 5 domande casuali su 10 domande situate all'interno di un gruppo.

Il sondaggio ha un gruppo contenente 10 domande. A tutte le domande viene assegnato lo stesso [[QS: Random_group|nome del gruppo di randomizzazione]]. Di conseguenza, verranno visualizzate in ordine casuale al caricamento della pagina. A ogni domanda viene assegnata un'equazione di rilevanza secondo cui la somma di "[[ExpressionScript - Presentation#Access to Variables|relevanceStatus]]" di tutte le altre domande nel gruppo è inferiore al numero di domande che si desidera mostrare. Poiché "[[ExpressionScript - Presentation#Access to Variables|relevanceStatus]]" viene assegnato durante il rendering delle domande, questo corrisponde effettivamente al numero di domande precedenti.

Quindi, nel nostro esempio "5 su 10", l'equazione per Q1 sarebbe:

<syntaxhighlight lang="php" enclose="div">sum(Q2.relevanceStatus, Q3.relevanceStatus, Q4.relevanceStatus, Q5.relevanceStatus, Q6.relevanceStatus, Q7.relevanceStatus, Q8.relevanceStatus, Q9.relevanceStatus, Q10.relevanceStatus) LT 5</syntaxhighlight>

Per Q2, sarebbe:

<syntaxhighlight lang="php" enclose="div">sum(Q1.relevanceStatus, Q3.relevanceStatus, Q4.relevanceStatus, Q5.relevanceStatus, Q6.relevanceStatus, Q7.relevanceStatus, Q8.relevanceStatus, Q9.relevanceStatus, Q10.relevanceStatus) LT 5</syntaxhighlight>

E così via...

==Dimostrazione delle caratteristiche==

#[[ExpressionScript - Presentation#Access to variables|variabile relevanceStatus]]
#[[QS:Random group|Randomizzazione]]

==Download==

Per scaricare l'esempio precedente, fare clic sul link seguente: [[Media:Random_5_out_of_10.lss|Random 5 out of 10 survey example]].

=Classificazione di un elenco di prodotti inserito dall'utente=

==Panoramica==

L'esempio seguente mostra come chiedere agli utenti di elencare una serie di prodotti che li interessano e quindi chiedere loro di valutarli.

==Dimostrazione delle caratteristiche di ES==

#'''Personalizzazione delle risposte''' - quando si valutano i prodotti, le etichette provengono dal campo dei commenti della precedente domanda a scelta multipla
# '''Scale personalizzate''' - molte opzioni avanzate delle domande, come i titoli delle scale, possono essere anche personalizzate.

==Screenshots==

This image shows that even though only products 1,3, and 5 were selected, only those 3 are displayed (using the [[QS:Array_filter|array_filter]] attribute). Moreover, the row labels in the second question are either the product numbers (if nothing is entered into the comment field) or the contents of the comment fields.

<center>[[File:mcc_filter1.jpg]]</center>

This image shows how the tailored answers are specified:

<center>[[File:mcc_filter2.jpg]]</center>

Here is the Show Logic File for that question, which lets us verify that the conditional logic works as desired (e.g., to see whether there are any syntax errors):

<center>[[File:mcc_filter3.jpg]]</center>

The next image shows a group in which you specify a 5 point rating scale (Options 1-5), the title of the scale, and the products you want to rate. The final question shows that each of the parts of the array question can be tailored:

<center>[[File:mcc_filter4.jpg]]</center>

The next image shows the logic file view of the last question. As you can observe, the subquestions, answers, and scale headers can be tailored.

<center>[[File:mcc_filter5.jpg]]</center>

==Download==

To download the survey example from above, click on the following link: [[Media:Rating_User-Entered_List_of_Products_Survey.zip|Rating user-entered list of products survey example]].

Translations:ExpressionScript sample surveys/166/it

2020-10-19T03:17:24Z

#'''Personalizzazione delle risposte''' - quando si valutano i prodotti, le etichette provengono dal campo dei commenti della precedente domanda a scelta multipla
# '''Scale personalizzate''' - molte opzioni avanzate delle domande, come i titoli delle scale, possono essere anche personalizzate.