Actions

Survey participants/it: Difference between revisions

From LimeSurvey Manual

(Updating to match new version of source page)
No edit summary
 
(181 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages /> __TOC__
<languages /> __TOC__


<div class="simplebox">'''Note''':  Tokens have changed alot in Version 1.85 and later. So if you are using an earlier version there will be differences between your version and the documentation. We recommend to upgrade as soon as possible.</div>
=Introduzione=


=Introduction=


On many occasions you will want to invite a group of people to participate in your survey, keep track of who has completed the survey, and ensure that each person can only participate once. The tokens feature allows you to do the following:
La funzionalità Partecipanti al sondaggio ti consente di invitare un gruppo di persone a partecipare al tuo sondaggio, tenere traccia di chi ha completato il sondaggio e garantire che ogni persona possa partecipare solo una volta. La funzione della tabella dei partecipanti al sondaggio consente di eseguire le seguenti operazioni:
*Import a list of names and email addresses for participants (from a CSV file or an LDAP query)
*Importare un elenco di nomi e indirizzi e-mail per i partecipanti da un file [[Survey_participants#Importa partecipanti da un file CSV|CSV]] o da un file [[Survey_participants#Import partecipanti da una query LDAP|Query LDAP]];
*Generate a unique token number for each participant (invitation code)
*Genera un codice token univoco per ogni partecipante (codice di invito);
*Send an email invitation to each person in your list, by group or individually
*Invia un invito via email a ogni persona nella tua lista (per gruppo o individualmente);! N!*Invia un'e-mail di promemoria a ogni persona nella tua lista che non ha ancora risposto (per gruppo o individualmente);
*Send a reminder email to each person in your list who has not yet responded, by group or individually
*Tieni traccia di chi ha risposto dalla tua lista di partecipanti al sondaggio;
*Track who from your list has responded
*Limita l'accesso per le persone che non hanno ricevuto un token e quelli con un token che hanno già risposto;
*Restrict access against people who have not got a token, and those with a token who have already responded
*Modifica/modifica qualsiasi dettaglio nel tuo elenco;
*Edit/change any details in your list
*Crea modelli di email per inviti e promemoria.
*Create email templates for invitations & reminders


Once the survey is switched to Closed-access mode (you have enabled tokens for this survey), then '''only the people with a valid token code (not already used) can access the survey'''.
Una volta che il sondaggio è passato alla modalità ''Accesso chiuso'' '''solo le persone che forniscono un codice token univoco (che non è stato già utilizzato) possono accedere al sondaggio'''. (Devi prima creare una tabella dei partecipanti al sondaggio per il rispettivo sondaggio).


If you enable ''Auto-registration'' in the survey properties, participants will be able to register for your survey to have their personal token code automatically generated.
Se abiliti l'opzione [[Impostazioni partecipanti|Consenti registrazione pubblica]] dal pannello '''Tabella dei partecipanti al sondaggio''', i partecipanti al sondaggio potranno registrarsi al tuo sondaggio ricevendo un codice token generato automaticamente.


{{Hint|Text=Some token settings are set in survey settings, see [[Creating a new survey#Tokens]]}}  
{{Nota|Alcune impostazioni relative ai token sono memorizzate nel pannello [[Participant settings|participant settings]].}}


==Can a survey using tokens ensure anonymous responses?==
=Come creare una tabella dei partecipanti al sondaggio=


The answer to this question is '''Yes'''. Tokens can be used both for anonymous and non-anonymous surveys. This is determined when creating a survey. If a survey is not anonymous (or 'tracked') then the token list can be used to find the responses that an individual has made to the survey. If the survey is anonymous, then no link (technically: foreign key relationship) is available between the tokens table and the responses.


=How to activate tokens?=
per ''inizializzare'' una tabella dei partecipanti al sondaggio: '''Impostazioni''' > '''Menu sondaggio''' > '''Partecipanti al sondaggio''':


There are two ways to activate tokens:
#After survey activation you will be asked if you want to activate tokens: [[File:Switch-to-closed-access-mode.png]]
# '''OR '''you can click on the tokens symbol [[File:tokens.png]] - even before the survey is activated.


=The token management tools=
<center>[[File:Survey_participants_settings_tab.png]]</center>


[[File:token-menu2.png]]


After creating the tokens table you can click on the tokens icon to get to the token administration. The following is a brief rundown of the menu options in the tokens screen:
Verrà visualizzato il seguente messaggio:
*'''Admin''': Returns to the main survey admin screen
*'''Summary''': Displays just the brief summary of tokens in the table (number of tokens, how many have been sent an invitation, and how many have responded). Also provides access to the Database Admin functions (see below). This is the default screen.
*'''Browse''': Displays the complete list of participants in the tokens table. From the browse screen you can edit or delete individual entries in the token table as well as perform a number of other useful functions (see browse section below)
*'''Add new token entry''': Allows you to add an entry to the tokens table
*'''Add dummy token''': Allows you to add 1 or more tokens to the token table
*'''Manage additional field attributes''': Allows you to add additional fields to the tokens table to store custom participant data
*'''Import from CSV''': Allows you to import information from a csv file
*'''Import from LDAP''': Allows you to import information from an LDAP query (tested on openLdap but should work in any LDAP compliant directory including ActiveDirectory)
*'''Export tokens to CSV file''': creates a standard CSV (comma delimited) file with a complete list of participants of your current tokens table
*'''Edit [[Email templates|email templates]]''': Used to customize the templates used for the invitations, reminders, confirmations, and registration emails
*'''Send email invitation''': Sends bulk email invitations to all participants in the tokens table who have not already been sent an invitation.
*'''Send email reminder''': Sends bulk email reminders to all participants in the tokens table who have not yet responded, but have been sent their first invitation.
*'''Generate tokens''': Creates unique tokens for all individual entries in the tokens table that do not yet have one
*'''Drop token table''': delete the token table and set the survey to Open-access mode.
*'''Bounce settings''':  Email bounce back settings.   Bounce back settings can be set at the survey level or at the system level.    This feature was added in version 1.91


=Editing/adding a token=


A typical token entry contains the following fields:
<center>[[File:Switch-to-closed-access-mode-2.png]]</center>
 
 
Se ''inizializzi una tabella dei partecipanti'', il sondaggio sarà accessibile solo a quei partecipanti che forniscono un codice token nel processo di registrazione (manualmente o tramite URL). In questo modo, il sondaggio passerà alla modalità ad accesso chiuso.
 
Una volta inizializzato, verrà visualizzata una finestra che conferma la creazione della tabella dei partecipanti al sondaggio.
 
 
==Riattivare una tabella dei partecipanti al sondaggio==
 
 
Quando elimini una tabella dei partecipanti al sondaggio, viene creato un backup. Successivamente può essere riattivato se si desidera utilizzare quella specifica tabella dei partecipanti al sondaggio in un altro sondaggio.
 
 
<center>[[File:Ripristina vecchie tabelle token.png]]</center>
 
=Gli strumenti di gestione della tabella dei partecipanti al sondaggio=
 
 
Verrà visualizzato un ''riepilogo dei partecipanti al sondaggio'' se la tabella dei partecipanti al sondaggio è stata creata in precedenza. Questa è la schermata predefinita:
 
 
<center>[[File:Sommario dei partecipanti al sondaggio.png]]</center>
 
 
*'''Record totali:''' Il numero di partecipanti al sondaggio dalla tabella dei partecipanti al sondaggio;
*'''Totale senza token univoco:''' Visualizza il numero di utenti senza un codice token assegnato;!N !*'''Totale inviti inviati:''' Mostra il numero di inviti che sono stati inviati ai partecipanti al sondaggio dalla tabella '''Partecipanti al sondaggio''' utilizzando l'opzione Inviti dal menu [[Partecipanti al sondaggio#Invitations & promemoria|Inviti e promemoria]] menu;
*'''Totale esclusi:''' Visualizza il numero totale di partecipanti al sondaggio che hanno deciso [[Email_templates#Participant opt-out|di rinunciare]] al sondaggio;
*'''Totale escluso:''' Utilizzato per filtrare ed escludere potenziali partecipanti che non soddisfano determinati criteri.
*'''Sondaggi totali completati:''' Mostra il numero di sondaggi che sono stati completati da quegli utenti che sono stati assegnato un codice token.
 
 
Sopra la tabella '''Riepilogo dei partecipanti al sondaggio''', troverai gli '''Strumenti di gestione della tabella dei partecipanti al sondaggio''':
 
 
<center>[[File:token-menu2.png]]</center>
 
 
*[[Partecipanti al sondaggio#Visualizza partecipanti|Visualizza partecipanti]]: Visualizza una tabella dei partecipanti al sondaggio con tutti i partecipanti attuali. Dalla schermata Sfoglia è possibile modificare o eliminare singole voci dalla tabella nonché eseguire una serie di altre funzioni utili (vedere la sezione [[Sondaggio partecipanti#Visualizza partecipanti|Visualizza wiki partecipanti]] di seguito per maggiori dettagli);
*[[Partecipanti al sondaggio#Crea...|Crea...]]: consente all'amministratore del sondaggio di aggiungere i rispondenti alla tabella dei partecipanti al sondaggio tramite l'opzione '''Aggiungi partecipante''' o tramite '''Importa partecipanti ''' function;
*[[Partecipanti al sondaggio#Gestisci attributi|Gestisci attributi]]: consente all'amministratore del sondaggio di aggiungere ulteriori campi alla tabella dei partecipanti al sondaggio per memorizzare i dati personalizzati dei partecipanti;
*[[Partecipanti al sondaggio# Esporta|Esporta]]: per esportare le tabelle dei token e utilizzarle in altri sondaggi, utilizzare questa funzione. Il file verrà salvato nel formato .CSV;
*[[Partecipanti al sondaggio#Inviti e promemoria|Partecipanti al sondaggio]]: ti consente di invitare o ricordare ai tuoi partecipanti dalla tabella dei partecipanti al sondaggio di compilare il tuo sondaggio online;! N!*[[Partecipanti al sondaggio#Genera token|Genera token]]: consente all'amministratore del sondaggio di assegnare rapidamente un codice token univoco casuale a ciascun utente dalla tabella dei partecipanti al sondaggio che non ne ha uno;
*[[Partecipanti al sondaggio #Visualizza in CPDB|Visualizza in CPDB]]: Fornisce un accesso rapido alla tua installazione di LimeSurvey [[Database centrale dei partecipanti|database centrale dei partecipanti]] (CPDB). Da lì puoi assegnare gli utenti CPDB come partecipanti al sondaggio a qualsiasi sondaggio.
 
 
==Visualizza partecipanti==
 
 
Mostra l'elenco delle voci dalla tabella dei partecipanti al sondaggio e consente all'utente di:
*[[Partecipanti al sondaggio#Ordina i partecipanti al sondaggio|ordina i partecipanti al sondaggio]];
*[[Partecipanti al sondaggio#Filtra i partecipanti al sondaggio| filtrare i partecipanti al sondaggio]];
*[[Partecipanti al sondaggio#Esegui determinate azioni su una singola voce|esegui determinate azioni su una singola voce]];
*[[Partecipanti al sondaggio#Esegui un'azione specifica su più di una voce|esegui determinate azioni su più di una voce]].
 
 
<center>[[File:azioni-token.png]]</center>
 
 
===Ordina i partecipanti al sondaggio===
 
 
La seconda riga della tabella include vari criteri che possono aiutare l'amministratore del sondaggio a ordinare le voci. Se fai clic su una qualsiasi delle colonne/criteri della tabella, la schermata verrà aggiornata, mostrando i partecipanti al sondaggio ordinati in base al criterio su cui hai appena fatto clic. Fare clic due volte su di esso per visualizzare i risultati in ordine decrescente.
 
 
<center>[[File:Visualizza partecipanti - sort.png]]</center>
 
 
===Filtra i partecipanti al sondaggio===
 
 
Per filtrare i partecipanti al sondaggio, scegli la colonna che vuoi filtrare. Quindi digita i valori/stringhe su cui desideri filtrare nella casella vuota sotto la colonna desiderata.
 
 
<center>[[File:Visualizza partecipanti - filter.png]]</center>
 
 
Ad esempio, digita "OK" nel campo dello stato dell'e-mail per restituire solo i partecipanti che hanno un indirizzo e-mail valido.
 
<div class="simplebox">[[File:help.png]] '''Suggerimento:''' Puoi anche utilizzare gli operatori quando filtri i partecipanti al sondaggio (ad es.: >, <, >=, <=, = ).</div>
 
{{Alert|title=Attenzione|text=Per filtrare le colonne "invito inviato", "promemoria inviato" e "sondaggio completato", utilizzare "=N" o "<>N", che significa "uguale No" e "diverso da No", rispettivamente.}}
 
===Esegui un'azione specifica su una singola voce===
 
 
La colonna '''Azione''' è dove puoi trovare tutte le azioni disponibili per ogni singola voce dalla tabella dei partecipanti al sondaggio. Le possibili azioni che possono essere eseguite sono:
 
 
<center>[[File:Visualizza partecipanti - azione partecipante.png]]</center>
 
 
*'''Visualizza i dettagli della risposta:''' Se il sondaggio è un sondaggio "tracciato" (cioè non anonimo), verrà visualizzato un altro pulsante che ti consentirà di visualizzare la risposta da questa singola voce;
*''' Avvia il sondaggio con questo token:''' Utilizzato per eseguire un sondaggio utilizzando il codice del token generato;
*'''Invia invito tramite e-mail:''' Utilizzare questa opzione per inviare un invito tramite e-mail al rispettivo partecipante a completare il sondaggio;
*'''Modifica il partecipante al sondaggio:''' Fare clic per modificare il sondaggio dati del partecipante;
*'''Elimina partecipante al sondaggio:''' Fare clic per eliminare quella particolare voce;
*'''Visualizza questa persona nel database centrale dei partecipanti''': verrà visualizzata un'icona se il la rispettiva voce si trova anche nel database centrale dei partecipanti.
 
===Esegui un'azione specifica su più di una voce===
 
 
Nella parte in basso a sinistra della tabella, troverai il pulsante '''Partecipante/i selezionato/i...''' che ti consente di eseguire determinate azioni a livello macro:
 
 
<center>[[File:Visualizza partecipanti - azioni partecipanti.png]]</center>
 
 
*'''Invia inviti via email:''' Invia inviti via email ai partecipanti al sondaggio selezionati;
*'''Invia promemoria via email:''' Invia promemoria via email ai partecipanti al sondaggio selezionati;
*''' Aggiungi partecipanti al database centrale:''' Per utilizzare alcune voci token in un altro sondaggio, aggiungi i partecipanti selezionati al [[Banca dati centrale dei partecipanti|database centrale dei partecipanti]]. Da lì, hai la possibilità di aggiungere i partecipanti a qualsiasi sondaggio desideri. Per maggiori dettagli, continua a leggere la pagina wiki [[Central_Participant_Database#Share_this_participant|Condividi questo partecipante]].
 
 
{{Box|Prima di eseguire una qualsiasi delle funzioni sopra menzionate, non dimenticare di selezionare i partecipanti al sondaggio sui quali verrà eseguita l'azione.}}
 
==Crea...==
 
 
Per avere più partecipanti elencati nella tabella dei partecipanti al sondaggio, puoi aggiungerne di nuovi o importarli da un file CSV o da una query LDAP.
 
 
<center>[[File:Partecipanti al sondaggio - Crea....png]]</center>
 
 
===Aggiungi partecipante===
 
 
Una tipica voce token contiene i seguenti campi:
 


<center>[[File:token_editing2.png]]</center>
<center>[[File:token_editing2.png]]</center>
*'''First and last name''': .. of the participant (can be used in the emails & survey)
*'''Email''': the participant's email address
*'''Email status''': a field to keep track of bad emails. For instance, if the survey administrator received email error notifications from this email, the he can set this field to anything other than 'OK' (for instance 'user unknown', or 'mailbox quota exceeded'). Marking this token with an email status other than 'OK', will help skip this entry when sending invitation or reminder emails. Note that this is completely manual, unless you decide to implement a script which does update this field automatically.
*'''Token''': this is the invitation code. It is usually automatically generated by the 'Generate tokens' button
*'''Language''': if you want to set the default language for this participant
*'''Invite sent''': defaults to 'N', otherwise would contain the date when the invitation email was sent
*'''Reminder sent''': defaults to 'N', otherwise would contain the date when the reminder email was sent
*'''Completed''': defaults to 'N', otherwise would contain the date when the survey was submitted for not anonymous survey, or 'Y' for anonymous survey
*'''Uses left''': A counter of number of times the token can be used. ''Note:'' When increasing this value (default = 1) for a user who has already filled out the survey (which sets uses left to 0), you have to add "N" at the "completed" field.
*'''Valid from''' & '''Valid until''' : You can set a date/time range where this token would be allowed to use. You can leave these empty if you don't want to limit participation time frame for certain users. Note: If the user is answering the survey and the participation time ends then the user is locked out immediately and won't be able to finish the survey.
*'''Attribute1 to Attribute x''': These are user-definable attribute fields - see the next paragraph.


=Dummy Tokens=


Dummy Tokens were added in 1.91. Here is a typical screen:
*'''ID:''' Un numero intero assegnato automaticamente a ciascun partecipante al sondaggio;
*'''Completato?''': Disabilitato per impostazione predefinita. Se abilitato, conterrà la data in cui il sondaggio è stato completato. Nessun invito o promemoria viene inviato ai rispettivi utenti se questo è abilitato. Viene abilitato automaticamente se il rispettivo partecipante al sondaggio ha completato il sondaggio utilizzando il codice token assegnatogli;
*'''Nome:''' Il nome del partecipante al sondaggio;
*'''Cognome:''' Il cognome del partecipante al sondaggio;
*'''Token :''' Questo è il codice di invito. Può essere generato manualmente o automaticamente (tramite il pulsante '''Genera token''');
*'''Lingua:''' Qui puoi selezionare la lingua predefinita del sondaggio per il rispettivo partecipante;!N !*'''Email:''' L'indirizzo email del partecipante;
*'''Stato email:''' Questo campo ti aiuta a tenere traccia degli indirizzi email non validi. Ad esempio, se l'amministratore del sondaggio ha ricevuto notifiche di errore e-mail da questa e-mail, può impostare questo campo su qualsiasi valore diverso da "OK" (ad esempio "utente sconosciuto" o "quota casella di posta superata"). Contrassegnare questo campo con uno stato e-mail diverso da "OK" aiuterà a saltare questa voce durante l'invio di e-mail di invito o promemoria. Nota che questo è completamente manuale, a meno che tu non decida di implementare uno script che aggiorni automaticamente questo campo;
*'''Invito inviato?:''' Se abilitato, contiene la data in cui è stata inviata la mail di invito;
*'''Promemoria inviato?:''' Se abilitato, contiene la data in cui è stata inviata la mail di sollecito;
*'''Usi rimasti:''' Conta il numero di volte in cui il token può essere utilizzato. ''Nota:'' Quando si aumenta questo valore (predefinito = 1) per un utente che ha già compilato il sondaggio (che imposta gli usi lasciati a 0), è necessario cambiare anche il campo '''Completato''' da " Sì" a "No";
*'''Valido da:''' & '''Fino a:'''È possibile impostare un intervallo di data/ora per quando questo token può essere utilizzato. Puoi lasciarli vuoti se non vuoi limitare l'intervallo di tempo di partecipazione per determinati utenti. Se l'utente sta rispondendo al sondaggio e il tempo di partecipazione termina, l'utente viene bloccato immediatamente e non sarà in grado di completare il sondaggio.
 
Si noti che il pannello '''Aggiungi partecipante al sondaggio''' ha due schede: la '''scheda Generale''' e la scheda '''Attributi aggiuntivi'''. La scheda degli attributi aggiuntivi ti offre l'accesso ai tuoi attributi personalizzati: leggi la seguente [[Partecipanti al sondaggio#Gestisci attributi|sezione wiki]] per maggiori dettagli.
 
 
===Crea partecipanti fittizi===
 
 
Un partecipante fittizio può essere utilizzato quando non si desidera inviare token via e-mail ai partecipanti al sondaggio, ma fornire loro codici token con altri mezzi. Ad esempio, agli studenti che effettuano le valutazioni in classe potrebbe essere consegnato un foglio con un codice di invito da inserire all'inizio del sondaggio online. In questo modo, aumenta la probabilità di ricevere più risposte e feedback.
 
Fare clic su '''''Crea partecipanti fittizi''''' e verrà visualizzata la seguente pagina:
 
 
 
<center>[[File: Partecipanti al sondaggio - crea un partecipante fittizio.png]]</center>
 
 
Il campo "Numero di partecipanti" ti consente di inserire il numero di partecipanti fittizi che desideri aggiungere alla tabella dei partecipanti al sondaggio. La spiegazione degli altri campi è disponibile nella sottosezione wiki [[Partecipanti al sondaggio#Aggiungi partecipante|Aggiungi partecipante]].
 
Dopo aver completato i campi, premere '''Salva''' situato nella parte in alto a destra dello schermo.
 
 
Per verificare se sono stati aggiunti o meno, controlla la tabella Partecipanti al sondaggio:
 
 
<center>[[File:Variabili fittizie - semplice esempio.png]]</center>
 
===Importa partecipanti da un file CSV===
 
 
La funzione di importazione consente di importare informazioni da un [[Partecipanti al sondaggio#Importa partecipanti da un file CSV|File CSV]] o [[Partecipanti al sondaggio#Importa partecipanti da una query LDAP|Query LDAP]].
 
 
<center>[[File: partecipanti al sondaggio - import csv.png]]</center>
 
 
*'''Scegli il file CSV da caricare:''' Scegli il file CSV che desideri importare. Per eliminare eventuali errori, si consiglia di importare un file CSV standard (delimitato da virgole) con virgolette doppie opzionali intorno ai valori (impostazione predefinita per OpenOffice ed Excel).
 
'''La prima riga deve contenere i nomi dei campi'''. <u>Deve</u> inoltre contenere i seguenti campi: ''nome, cognome, email''.
 
Devono contenere almeno un carattere. La semplice aggiunta di virgolette doppie e nessun carattere tra di loro non funzionerà!
 
Gli altri campi sono opzionali: ''emailstatus, token, language, validfrom, validuntil, attribute_1, attribute_2, attribute_3, usesleft, ... .''
 
 
{{Hint|Text=Per ottenere un elenco completo dei nomi dei campi token, [[Survey participant#Export|esporta una tabella dei partecipanti al sondaggio esistente]].}}
 
{{Hint|Text=Il formato della data per i campi "validfrom" e "validuntil" nel file di importazione del token CSV è "YYYY-MM-DD HH:MM".}}
 
*'''Set di caratteri del file:''' Seleziona l'opzione che si adatta ai caratteri utilizzati nel file CSV;
*'''Separatore utilizzato:''' Puoi consentire a LimeSurvey di rilevare automaticamente il separatore utilizzato nel tuo CSV o seleziona il separatore ''virgola'' o ''punto e virgola'';
*'''Filtra indirizzi email vuoti:''' Se abilitato, i partecipanti al sondaggio senza indirizzo email non verranno importati in la tabella dei partecipanti al sondaggio;
*'''Consenti indirizzi e-mail non validi:''' Se disabilitata, questa funzione esaminerà i campi degli indirizzi e-mail e verificherà se gli indirizzi hanno o meno la struttura di un'e-mail (es: a@ una rete);
*'''Visualizza avvisi attributi:''' Se abilitato, dopo il processo di importazione verranno visualizzati avvisi nel caso ci sia qualcosa che non va nei campi. Per esempio. potresti ricevere un avviso di attributo se non viene fornito nulla in nessuno dei campi obbligatori o se un'e-mail viene inserita in modo errato nel file CSV.
 
*'''Filtra record duplicati:''' Se abilitato, puoi impostare quali campi vengono utilizzati per identificare i duplicati. Per impostazione predefinita, sono preselezionati Nome, Cognome e Indirizzo e-mail. Se durante l'importazione viene trovato un duplicato, la relativa riga viene omessa.
 
*'''I duplicati sono determinati da:''' Seleziona i campi che vuoi filtrare per i duplicati.
 
 
Puoi anche importare attributi personalizzati durante l'importazione di un file CSV. Dovrai definire quali attributi verranno aggiunti. Puoi farlo in questo modo:
 
 
    <code>email,attribute_1 <Casenr>, token, attribute_2 <Title>, attribute_3 <destination>, lastname,firstname,attribute_4 <Sender></code>
 
 
Una volta che hai finito di scegliere le impostazioni di importazione desiderate, non dimenticare di fare clic sul pulsante '''Carica'''.
 
 
====Risoluzione dei problemi relativi all'importazione dei partecipanti al sondaggio====
 
 
Un errore comune quando gli utenti tentano di importare i token è un file CSV non valido. Questo è spesso causato da Microsoft Excel. Molti utenti hanno un elenco di indirizzi e-mail salvati come documento XLS. Un file può essere salvato come CSV in Excel. Tuttavia, a seconda delle impostazioni locali del sistema operativo, Microsoft Excel può utilizzare i punti e virgola (;) come separatore virgola, mentre un file CSV standard utilizza le virgole (,) come separatori. Se non sai quale utilizzare, apri il file con un editor di testo standard e verifica quale separatore è stato utilizzato.
 
Gli editor di testo raw gratuiti consigliati sono: [http://www.pspad.com/PSPad], [http://www.flos-freeware.ch/notepad2.html NotePad2] o [http://notepad-plus-plus .org/ Notepad++] per Windows e [http://www.barebones.com/products/textwrangler/ TextWrangler] per Macintosh.
 
 
{{Box|LimeSurvey dovrebbe anche rilevare i punti e virgola come separatori. Tuttavia, nel caso in cui il processo di importazione non funzioni correttamente, sostituire i punti e virgola con le virgole. Anche le virgolette doppie dovrebbero essere aggiunte intorno ai valori.}}
 
===Importa partecipanti da una query LDAP===
 
{{Alert|title=Attenzione|text=Questa opzione è consigliata solo agli utenti con conoscenze avanzate nelle query LDAP.}}


<center>[[File:dummyToken.png]]</center>
Questa funzione di importazione consente di importare informazioni da una query LDAP (testato su openLdap, ma dovrebbe funzionare in qualsiasi directory conforme a LDAP, incluso ActiveDirectory). Nella pagina ''Importa partecipanti al sondaggio da LDAP'' sono disponibili le seguenti opzioni:
*'''Number of tokens''':  Number of tokens to be added.  Default is 100.
*'''Token length''': Number of characters or length of token.  Default 15
*'''First and last name''': .. of the participant.
*'''Email''': the participant's email address
*'''Language''': If you want to set the default language for this participant
*'''Uses left''': A counter of number of times the token can be used.
*'''Valid from''' & '''Valid until''' : You can set a date/time range where this token would be allowed to use. You can leave these empty if you don't want to limit participation time frame for certain users. Note: If the user is answering the survey and the participation time ends then the user is locked out immediately and won't be able to finish the survey.
*'''Attribute1 to Attribute x''': These are user-definable attribute fields - see the next paragraph.


Note that Name, email, language will be set to the same value for all dummy Tokens


=Bounce Settings{{NewIn|1.91}}=
<center>[[File:Importa partecipanti al sondaggio da LDAP.png]]</center>


Please also check out the [[Email bounce tracking system]] page for more information how to correctly configure this feature.
* Le query sono definite manualmente dall'amministratore di sistema nel file config-ldap.php.
* I duplicati sono identificati da Nome, Cognome e Indirizzo e-mail. Se durante l'importazione viene trovato un duplicato, la relativa riga viene omessa (a meno che tu non abbia deselezionato la casella ''Filtra duplicati'').


[[File:surveyBounseSettings.png]]
{{Nota|Per maggiori dettagli sulle impostazioni LDAP in LimeSurvey, leggi la [[Impostazioni LDAP|seguente pagina wiki]].}}
*'''Survey bounce email''':  A valid email address for return mail.   For faster bounce back processing, this email box should be limited to bounce back only.
*'''Bounce settings to be used''': There are three options:  1- None (default) - no bounce back processing, 2- Use settings below - Will set bounce back processing at the survey level, or 3- Use global settings -- Settings based on the system level.
*'''Server type''': Three options: 1- Off, 2- IMAP or 3- POP
*'''Server name & port''':  Host name and port number.   Port number isn't typically needed unless the email host uses a non-standard port. Example:  mail.example.net:25 or imap.gmail.com:995
*'''User name''':  User Name or User ID of the email account
*'''Password''':  password of the email account
*'''Encryption type''':  Three options:  1- None (default), 2- SSL, or 3- TLS


=User-defined attribute fields=
==Gestisci attributi==


It is possible to add a number of additional fields to the tokens table to save additional data for a participant. By clicking on the [[File:token_manage.png]] icon you can manage these fields. You can add more attribute fields (by default they have a a length of 255 chars) and also set descriptions for each field - so they look nicer in the administration, when you browse tokens, when creating [[Setting conditions|conditions]] based on attribute fields or even when you export results for non-anonymous surveys.
Questa opzione consente di aggiungere/modificare i campi aggiuntivi della tabella dei partecipanti al sondaggio. I campi aggiuntivi vengono utilizzati per archiviare i dati dei partecipanti al sondaggio personalizzato.


Detailed instructions on how to add additional attribute fields and use conditions based on these values can be found at this blog post: "[http://www.limesurvey-consulting.com/limesurvey-conditions-based-on-token-attributes/ Conditions based on token attributes]"


=Using the browse screen and editing tokens=
<center>[[File:Partecipanti al sondaggio - Aggiungi attributi.png]]</center>


[[File:token-browse.png]]


The browse screen will show you a list of all entries in the tokens table, as well as giving you some 'action' buttons that can perform specific tasks for that individual entry.
Digita il numero di nuovi campi di attributo che desideri aggiungere alla tabella dei partecipanti al sondaggio. Fare clic sul pulsante '''Aggiungi campi'''. Verrà visualizzata la seguente pagina:


The top row of the table has three columns: The dialogue on the right gives options for displaying a number of records, and a starting point. In the middle is a search bar and the symbols on the left let you move backwards or forwards through your list.


The second row of the table (see image below) includes various criteria to sort the entries and for each a green arrow that - if clicked - will refresh the screen showing the tokens ordered by that criterion.
<center>[[File:token_manage.png]]</center>


The "Actions" column gives a list of specific tasks that can be performed on that individual entry:


[[File:token-actions.png]]
La tabella dei campi degli attributi contiene i seguenti campi:
*Do the survey using the unique token of this entry
*'''Campo attributo:''' Il valore digitato qui può essere utilizzato quando si desidera eseguire diverse operazioni con il rispettivo campo attributo personalizzato, ad esempio l'applicazione di [[Condizioni di impostazione| condizioni]] in base ai campi degli attributi o durante l'esportazione dei risultati per i sondaggi non anonimi.
*Edit this entry
*'''Descrizione del campo:''' Utilizzato per sostituire il nome '''campo degli attributi'''. Assegnando un nome personalizzato a ciascun campo attributo, questi appariranno più belli nel pannello di amministrazione, quando sfogli i token, quando crei condizioni basate sui campi attributo o quando esporti i risultati per sondaggi non anonimi.
*Delete this entry
*'''Obbligatorio ?:''' Se abilitato, il rispettivo campo attributo deve essere compilato dall'amministratore del sondaggio. In caso contrario, l'intervistato non può essere registrato nella tabella dei partecipanti al sondaggio.
*Send a invitation/reminder to this individual entry
*'''Mostra durante la registrazione?:''' Se i partecipanti al sondaggio devono registrarsi prima di completare un sondaggio, verranno loro richiesti alcuni dettagli. Se disabilitato, il rispettivo campo di attributo non verrà visualizzato nella pagina di registrazione del sondaggio.
*If the survey is a 'tracked' (ie: not anonymous) survey, another button will appear, allowing you to view the response from this individual entry.
*'''Field caption:''' Utilizzare questi campi per aggiungere ulteriori dettagli sul ruolo/utilizzo del rispettivo campo attributo.
*'''CPDB mapping:''' Mappa l'attributo per collegarlo all'attributo corrispondente dal database centrale dei partecipanti.
*'''Dati di esempio:''' Contiene esempi di stringhe da diversi campi. Ad esempio, se desideri chiedere il sesso del partecipante al sondaggio, nel campo '''Dati di esempio''' vedrai esempi come maschio, femmina, nessuna risposta ecc.


=Database Admin=


[[File:token-summary.png]][[File:token-db-mgt.png]]
Una volta che hai finito di compilare le caselle, non dimenticare di cliccare sul pulsante '''Salva''' situato nella parte in basso a sinistra dello schermo.


While the summary screen shows a brief summary of tokens in the table, it also provides access to the "Database Admin" features which include:
<div class="simplebox">[[File:help.png]] Istruzioni dettagliate su come aggiungere ulteriori campi di attributo e condizioni di utilizzo basate su questi valori possono essere trovate in questo post del blog: "[http://www.limesurvey-consulting.com/limesurvey-conditions -based-on-token-attributes/ Condizioni basate sugli attributi del token]".</div>
*Clear invites: Sets all records that an invitation has been sent out to 'N'. Obviously shouldn't normally be used.
*Clear tokens: Clears all tokens. Similarly shouldn't normally be used.
*Drop tokens: Allows you to remove the tokens feature from your script. Deletes the entire table and all records, and allows the survey to be accessed by anybody who knows the URL.


= Importing/exporting tokens=
Per aggiungere altri campi, vai in fondo alla pagina e digita nella casella '''Numero di campi attributo da aggiungere''' il numero desiderato e fai clic sul pulsante '''Aggiungi campi'''.


== CSV import==
Se desideri eliminare un attributo personalizzato, vai in fondo alla pagina e seleziona dall'elenco a discesa situato sotto il campo '''Elimina questo attributo''' l'attributo che desideri eliminare. Una volta selezionato, fai clic su '''Elimina attributo''' e conferma l'eliminazione.


When you click the icon to import tokens you will be presented with the following screen:
==Esporta==


[[File:uploadtoken.jpg]]


Your CSV file must be a standard [http://en.wikipedia.org/wiki/Comma-separated_values CSV (Comma Separated Value) file]. The first line of text is always the header information and will be used to identify the field data. Possible data fields are:
Per esportare una tabella dei partecipanti al sondaggio, fai clic sul pulsante "Esporta" situato sulla barra degli strumenti degli strumenti di gestione dei token. Prima di esportare l'elenco dei partecipanti al sondaggio, selezionare le opzioni di esportazione desiderate.


    firstname,lastname,email,emailstatus,token,language code,tid,attribute_1,attribute_2, attribute_...


To obtain a full list of token field names, export an existing token table.
<center>[[File: Partecipanti al sondaggio - export.png]]</center>


The fields can be in any order but ''firstname, lastname and email are mandatory'', and they must contain at least one character. Empty data (such as "") is not sufficient. If you would like to import data for attribute fields, you must add the desired attribute fields to the token table prior to importing token data.


A bare minimum CSV file could look like this:
*'''Stato sondaggio:'''
**''Tutti i token:'' Esporta tutti i partecipanti al sondaggio dalla tabella dei partecipanti al sondaggio;
**''Completato:'' Esporta solo i partecipanti al sondaggio che hanno ha completato il sondaggio;
**''Non completato:'' Esporta i partecipanti al sondaggio che non hanno ancora completato il sondaggio;
**''Non iniziato:'' Esporta i partecipanti al sondaggio che non hanno ancora iniziato il sondaggio ;
**''Iniziato ma non ancora completato:'' Esporta i partecipanti al sondaggio che hanno già iniziato il sondaggio, ma non l'hanno completato.
*'''Stato invito:''' Esporta i partecipanti in base al stato invito: ''tutti'', ''invitato'' e ''non invitato'';
*'''Stato promemoria:''' Esporta i partecipanti in base allo stato del promemoria: ''tutti'', ''Promemoria inviato'', ''Nessun promemoria inviato'';
*'''Filtra per lingua:''' Quando crei un sondaggio, puoi aggiungere altre lingue oltre alla lingua di base . Queste lingue aggiuntive possono essere utilizzate per esportare i partecipanti al sondaggio in base alla lingua a cui sono assegnati;
*'''Filtra per indirizzo email:''' Esporta le voci che contengono la stringa nel rispettivo indirizzo email. Ad esempio, puoi utilizzarlo se alcuni dei tuoi partecipanti al sondaggio utilizzano gli indirizzi e-mail di lavoro dell'"Azienda A". Digita ''@aziendaa.com'' ed esporta solo gli utenti che hanno ricevuto un indirizzo email di lavoro dalla rispettiva azienda;
*'''Elimina partecipanti esportati:''' Se abilitato, gli utenti esportati verranno eliminati da la tabella dei partecipanti al sondaggio.


    firstname,lastname,email
Dopo aver selezionato le opzioni di esportazione, fai clic sul pulsante '''Scarica file CSV''' situato nella parte in alto a destra dello schermo.
    John,Doe,john@doe.net


'''Date format for token import'''
<div class="simplebox">
Quando esporti i partecipanti al sondaggio, i campi vengono esportati nel seguente ordine:
<code>tid,firstname,lastname,email,emailstatus,token,language code,attribute_1,attribute_2,...</code></div>


The date format for the "validfrom" and "validuntil" fields in the CSV token inport file is "YYYY-MM-DD HH:MM", e.g.:
==Inviti e promemoria==


    2012-01-01 00:00
''Inviti e promemoria'' ti permette di gestire il sistema di inviti di LimeSurvey. Puoi inviare inviti o promemoria ai partecipanti visualizzati nella tua [[Tabella partecipanti sondaggio#Visualizza partecipanti|tabella partecipanti sondaggio]]. Un [[Sistema di monitoraggio del mancato recapito delle email|sistema di monitoraggio del mancato recapito delle email]] può essere utilizzato per aiutarti a tracciare e contrassegnare le email che non sono state consegnate ai destinatari (partecipanti al sondaggio).


--would correspond to 1st January, 2012, at 12:00 AM.


'''Filtering duplicates'''
===Invia email di invito===


If you activate the option to filter for duplicates you can set which fields are used to identify duplicates. By default First name, Last name & Email-address are pre-selected. If a duplicate is found while importing the related line is omitted.


'''Troubleshooting the token import'''
Dalla tabella dei partecipanti al sondaggio puoi inviare e-mail di invito in blocco a tutti i partecipanti a cui non ne è stato inviato uno.


A common error when users try to import tokens is an invalid CSV file. This is often caused by Microsoft Excel. Many users have a list of e-mail addresses saved as an XLS document. A file can be saved as CSV in Excel, however, Microsoft uses semi-colon (;) as the comma separator, while a standard CSV file uses comma (,) as the separator. If you try to import an Excel saved CSV file you will get an error message. A simple solution is to save your XLS document as a CSV file in Excel and then open the file in a raw text editor and replace all semi-colon characters with commas. In version 2.00 can  you select the used separator.


Recommended free raw text editors are: [http://www.pspad.com/ PSPad], [http://www.flos-freeware.ch/notepad2.html NotePad2] or [http://notepad-plus-plus.org/ Notepad++] for Windows, and [http://www.barebones.com/products/textwrangler/ TextWrangler] for Macintosh.


You can use [http://www.libreoffice.org/features/calc/ LibreOffice Calc] to export import your xls file and export your csv file.
<center>[[File:token-invito.png]]</center>


'''Add additional attributes at import'''
It is also possible to add new custom attributes when import a CSV file. It is still needed to define what attributes will be added. The way to do this is:
    firstname,lastname,email
    attribute_1 <Casenr>; token; attribute_2 <Title>; attribute_3 <destination>; lastname; firstname; attribute_4 <Sender>;


== Creating CSV file with Excel on the Mac==
Puoi ignorare i partecipanti al sondaggio che hanno uno stato e-mail diverso da "OK" abilitando l'opzione '''Ignora token con indirizzi e-mail in errore'''.


When you create a CSV file with Excel 2011 on the MAC and use the standard "save as" option, you loose special characters such as ü, &euml;, é etc. when importing into LimeSurvey Token Table.
Per superare le [[Survey_participants#Add_participant|impostazioni di validità]] di tutti i tuoi inserimenti, abilita la funzione '''Ignora controllo data prima di inviare email'''. In questo modo, la funzione email di LimeSurvey non terrà conto dell'intervallo di data/ora in cui un token può essere utilizzato.  


To make this work properly choose to save the file as a Windows text CSV file (tested on the Dutch version of Excel, saved as "Door lijstscheidingstekens gescheiden Windows tekst (.CSV)").


Then when importing the file in the LimeSurvey token table, under "character set of file" choose "Mac West European". The special characters will be imported correctly.
==== Nuovo invio degli inviti====


Tested on LimeSurvey 2.0 only.


== CSV export==
Utilizza questa funzionalità per inviare nuovamente gli inviti a determinati partecipanti al sondaggio. Quando utilizzi la funzione '''invia inviti''', solo un indirizzo email che ''non ha ricevuto in precedenza un invito'' ne riceverà uno. Ciò significa che se aggiungi nuovi indirizzi email all'elenco dei partecipanti al sondaggio dopo l'invio dei primi inviti, solo questi nuovi indirizzi riceveranno un invito la seconda volta che invii gli inviti.


When you export your tokens the following fieldorder is exported:
Ciò significa che puoi anche modificare un indirizzo e-mail in una particolare voce della tabella da cui hai ricevuto un'e-mail respinta e quindi inviarla solo a questo indirizzo modificato. Per farlo, disattiva il campo '''Invito inviato''' e fai nuovamente clic su '''invia inviti'''.


    tid,firstname,lastname,email,emailstatus,token,language code,attribute_1,attribute_2,...
===Invia promemoria via e-mail===


== LDAP import==
Invia e-mail di promemoria in blocco a tutti i partecipanti dalla tabella dei partecipanti al sondaggio che non hanno ancora risposto, ma a cui è stato inviato il primo invito.


[[File:token-Ldap-import.png]]
* Queries are manually defined by the system administrator in the config-ldap.php file
* Duplicates are identified by First Name, Last Name & Email-Address. If a duplicate is found while importing the related line is omitted, unless you have unchecked the Filter Duplicates checkbox.


== A tip for generating a large number of fake e-mail addresses==
<center>[[File:token-remind.png]]</center>


Sometimes you may need a large number of fake e-mail addresses and tokens. You can use functions in a spreadsheet (e.g. OpenOffice Calc) to generate them. Let's assume you want thousands addresses in a form: 1@test.com, 2@test.com, 3@test.com... Put consecutive numbers in column A: 1 in the A1, then insert function =A1+1 in A2, then copy A2 down as many times as you need. In B1 use concatenation function to join A1 and "@test.com", which is =CONCATENATE(A1;"@test.com"). Then copy B1 down for each copied A. You may generate fake names in a similar way. Finally, save the file as CSV for import in LS.


With the 1.91, you can use "Generate dummy token" functionnality
Quando invii promemoria puoi:
* '''Ignorare i token con indirizzi e-mail in errore:''' le voci con un indirizzo e-mail in errore verranno ignorate - non riceveranno un'e-mail;
* '''Min giorni tra promemoria:''' salta i token se un promemoria è stato inviato "recentemente";
* '''Max promemoria:''' salta i token se è già stato inviato un determinato numero di promemoria;
* '' 'Aggira controllo data prima di inviare email:''' salta quelle voci che non rientrano nel periodo di tempo in cui possono essere utilizzate.


== A tip for generating a large number of individual links which include the token already==
<div class="simplebox">[[File:help.png]] '''Nota:''' verrà inviato un promemoria solo ai partecipanti in cui il campo "Completato" è disattivato (ciò significa che l'intervistato non ha partecipato o non ha completato il sondaggio).</div>


The structure of the survey link is the following:


Limesurvey 1.x: http://url-to-your-limesurvey-installation/index.php?sid=XXXX&lang=en&token={TOKEN}
==== Invio di e-mail in batch====


Limesurvey 2.x: http://url-to-your-limesurvey-installation/index.php/survey/index/sid/xxxx/newtest/Y/lang/EN/token/{TOKEN}
Quando invii un numero elevato di email contemporaneamente, LimeSurvey invierà solo il primo batch di N email (questa soglia è impostata dall'amministratore dalle [[Impostazioni globali#Impostazioni email|impostazioni email]], che si trova nelle impostazioni globali della tua installazione di LimeSurvey).


So you proceed similar to the example above for generating email adresses.
=== Email di conferma===
*First column: http://url-to-your-limesurvey-installation/index.php?sid=XXXX&lang=en&token= (for version 1.x) OR http://url-to-your-limesurvey-installation/index.php/survey/index/sid/xxxx/newtest/Y/lang/EN/token/ (for version 2.x) (same URL for all, as long as the language is the same!)
*Second column: {TOKEN} (put your tokens here, of course they must be individual)
*Third column: use the CONCATENATE function to join the first column with the second column.


= Emailing=


== Email placeholders==
Se si utilizzano token e un partecipante compila il sondaggio, viene inviata un'e-mail di conferma al suo indirizzo e-mail.


The following field names are allowed in invitation/reminder [[Email templates|email templates]] and must be entered in the survey properties. When sending out the emails these field names will be already replaced in the preview of your invitation/reminder email.
Se non vuoi che questo messaggio venga inviato, disattiva questa funzionalità da [[Participant settings|the general settings of your survey]].


{|
==Avvia l'elaborazione del rimbalzo==
|{ADMINEMAIL}||Email of the Survey admin
|-
|{ADMINNAME}||Name of Survey Admin
|-
|{SURVEYNAME}||Title of your survey
|-
|{SURVEYDESCRIPTION}||Description of your survey
|}


The following field names are allowed in invitation/reminder emails (subject and/or body) and will be replaced while sending out the mails:
Quando si invia un'e-mail, il sistema di tracciamento del mancato recapito dell'e-mail di LimeSurvey aggiunge automaticamente un ID sondaggio e un ID token all'intestazione della posta. Queste "intestazioni personalizzate" vengono aggiunte a ciascuna e-mail di invito inviata tramite l'installazione di LimeSurvey ai partecipanti al sondaggio. Quando l'e-mail viene respinta, viene ricevuta l'intestazione originale insieme all'intestazione "''Notifica di consegna''". Il sistema quindi verifica la presenza di nuove e-mail e analizza le e-mail che hanno queste intestazioni personalizzate e contrassegna l'indirizzo e-mail errato nella tabella dei partecipanti al sondaggio.


{|
|{EMAIL}||Email of the recipient
|-
|{FIRSTNAME}||First Name
|-
|{LASTNAME}||Last Name
|-
|{SURVEYURL}||The URL pointing to the survey start - if you are sending HTML emails this will be a fully linked HTML version
|-
|@@SURVEYURL@@||The URL pointing to the survey start - this is the barebone link. Use this if you want to integrate the link in your custom HTML elements somewhere (available in v1.90 and later)
|-
|{OPTOUTURL}||The URL to deactivate sending of mail for this survey  - this will be a fully linked HTML version
|-
|{TOKEN}||Token to access the survey
|-
|{ATTRIBUTE_1}||Attribute 1
|-
|{ATTRIBUTE_2}||Attribute 2 (...and so on for more attribute fields)
|}


If your survey is NOT anonymous, the following field names are available to insert token data in survey text and javascript:
===Impostazioni rimbalzo===


{|
|{TOKEN:EMAIL}||Email of the recipient
|-
|{TOKEN:FIRSTNAME}||First Name
|-
|{TOKEN:LASTNAME}||Last Name
|-
|{TOKEN}||Token to access the survey
|-
|{TOKEN:ATTRIBUTE_1}||Attribute 1
|-
|{TOKEN:ATTRIBUTE_2}||Attribute 2 (and so on for more attribute fields)
|}


===Additional hints===
Opzioni '''Impostazioni rimbalzo''':
*If your survey is using anonymized responses then token-related placeholders will not work in notification email templates.
*You can use [[Expression Manager|Expression Manager]] to use expressions for tailoring an email{{NewIn|1.92}}. Please have a look at the [[Expression Manager HowTos|Expression Manager HowTos]] for an example.
Also have a look at the examples on using [[Adding a question#Information from tokens table|information from tokens table]].


==Emails settings==
#'''Invitation Email Subject''': The subject line for the invitation email that gets sent out when tokens are used with your survey.
#'''Invitation Email''': This is the text for the invitation email that gets sent out when tokens are used with your survey. This is initially filled by the default invitation message (from the language files) but you can modify it to suit yourself. If you are using English as your base language, the default invitation and reminder text can be found in the limesurvey/tokens.php file. Of course if you don't plan to use tokens on your survey, whatever is in this field is irrelevant.  You can use the following "form" fields to insert individualized information in each email:
**'''{FIRSTNAME}''' - gets replaced with the token table's "firstname" value
**'''{LASTNAME}''' - gets replaced with the token table's "lastname" value
**'''{SURVEYNAME}''' - gets replaced with your surveys name
**'''{SURVEYDESCRIPTION}''' - gets replaced with your surveys description
**'''{ATTRIBUTE_1}''' - gets replaced with the token table's "attribute_1" value
**'''{ATTRIBUTE_2}''' - gets replaced with the token table's "attribute_2" value and so on
**'''{SURVEYURL}''' - gets replaced with the fully qualified URL to this particular survey - in HTML emails this is a fully linked HTML link
**'''@@SURVEYURL@@''' - Gets replaced with the survey barebone link. Use this if you want to integrate the link in your custom email HTML (available in v1.90 and later)
**'''{OPTOUTURL}''' - gets replaced with the URL for a respondent to opt-out of this particular survey


Note that these "form fields" apply to the following email fields.
<center>[[File:sondaggioBounseSettings.png]]</center>
#'''Email Reminder Subject''': The subject line for the reminder email that gets sent out from the tokens tool
#'''Email Reminder''': This is the text for the reminder email that gets sent out when tokens are used with your survey. See "invitation email" for specific details on how this field is used.
#'''Confirmation Email Subject''': When tokens are used, this is the subject line of the email that gets automatically sent to participants after completion of the survey
#'''Confirmation Email''': This is the text of the email that gets sent to users after completion of the survey. Delete/blank this text remove the confirmation email sending.
#'''Public Registration Email Subject''': This is the subject line for the invitation email sent to members of the public who register for a survey.
#'''Public Registration Email''': This is the text for the invitation email sent to members of the public who register for a survey. The same "form fields" apply in this email as in the earlier ones.


==Sending emails==


=== Send invitations===
Per una breve descrizione di ogni campo, controlla [[Global settings#Bounce settings|la seguente sezione wiki]]. Per utilizzare l'installazione di LimeSurvey ''Impostazioni globali'', vai su '''Impostazioni di rimbalzo utilizzate''' e seleziona l'opzione '''Utilizza impostazioni globali'''.


[[File:token-invite.png]]
{{Nota|Per spiegazioni più approfondite, controlla il nostro wiki su [[Sistema di monitoraggio del mancato recapito delle email|Sistema di monitoraggio del mancato recapito delle email]].}}


You can skip tokens for which the email status field is different from 'OK', by choosing the 'Bypass token with failing email addresses' option.
Fai clic sul [[Email_bounce_tracking_system#Setting_up_the_system|link seguente]] per ulteriori informazioni su come configurare correttamente questa funzione.


==== Resending invitations====
==Modifica modelli email==


Sometimes you might want to send invitations again to certain token entries / persons. When you use the '''send invitations'''-function only e-mail addresses that ''has not previously received an invitation'' will get one. This means that if you add new addresses to the token list after the first time you sent invitations, only these new addresses will receive an invitation the second time you send invitations.


This means that you can also edit/change an e-mail in a particular token entry that you got a bounce from and then send to only this edited address. Just substitute the date '''Invite sent?''' for a capital '''N''' (no) and click '''send invitations''' again.
Per saperne di più su quali segnaposto puoi utilizzare o su come modificare i modelli di email di LimeSurvey, leggi la nostra sezione wiki su [[Modelli di email|modelli di email]].


==== Participant opt-out====


When you use the {OPTOUTURL} tag in your invitation/reminder email, your participants have the possibility to opt out of this particular survey by just clicking on the related URL in the email - so you don't harrass them with reminder emails. A participant that opted out of your survey will have the email status 'OptOut' set in the token.
==Genera token==


=== Send reminders===


[[File:token-remind.png]]
Con l'aiuto di questa funzione, è possibile creare token univoci per tutte le voci individuali dalla tabella dei partecipanti al sondaggio che non hanno ancora ricevuto un codice token.


When sending reminders you can:
* bypass tokens with failing email addresses
* skip tokens for which an email has been 'recently' sent
* skip tokens for which a given number of emails have already been sent


Note: A reminder will only be send to tokens where the "completed" field is not "N" (this means the respondent has either not taken or has not completed the survey).
<center>[[File: Partecipanti al sondaggio - Genera token.png]]</center>


=== Sending emails by batch===
==Visualizza in CPDB==


When you have to send a lot of emails at the same time, LimeSurvey will only send a first batch of N emails (this threshold is set by the administrator in the Global Settings).
L'ultima opzione sulla barra degli strumenti di gestione dei token è l'opzione '''Visualizza in CPDB'''. Ciò consente all'amministratore del sondaggio di vedere i partecipanti che esistono sia nel database centrale dei partecipanti che nell'elenco dei partecipanti al sondaggio.


You'll then need to click "Next" to send the next batch, and so on untill all emails have been sent.
Nell'esempio seguente, abbiamo il seguente elenco di partecipanti al sondaggio:


=== Confirmation email===


If you are using tokens and a participant fills out the survey, a confirmation email is sent to his/her email address.
<center>[[File:Elenco dei partecipanti al sondaggio - visualizza in cpdb.png]]</center>


If you don't want this message to be sent, remove all content from the "Confirmation email subject" and "Confirmation email" fields -  [[General FAQ#How can I stop the system from sending confirmation emails|see these instructions]].


=== Spam problems===
Gli utenti con ID 1 e 2 sono stati condivisi dal database centrale dei partecipanti. Per verificarlo, vai alla barra degli strumenti di gestione della tabella dei partecipanti al sondaggio e fai clic su '''Visualizza in CPDB'''


Often users complain not having received an invitation/reminder email because the user&rsquo;s spam filter treated the email as spam.


If an email is treated as spam mostly depends on the spam filter being used and its settings. A spam filter usually checks the sender address and the email subject and content, so there are ways and means to influence how they treat your LimeSurvey invitation and reminder emails.
<center>[[File:Visualizza in CPDB - filter.png]]</center>


At [http://www.limesurvey-consulting.com/how-to-prevent-limesurvey-email-invitations-or-reminders-being-treated-as-spam/ this blog post] on limesurvey-consulting.com a lot of possible issues and solutions are listed.


===Wrong domain in invitation/reminder email link===
Come puoi vedere, la funzione '''Visualizza in CPDB''' sostanzialmente applica un filtro per determinare quali utenti del CPDB sono presenti nel rispettivo sondaggio.


LimeSurvey automatically tries to determine the URL for the invitation link by looking at the URL by which you logged in to the LimeSurvey administration. However with some server (mis-)configurations this might not work properly and you will have to set this manually.
=Elimina tabella=


You can edit application/config/config.php to change the default base URL value. Add hostInfo property like this to the existing 'components' array.
Per eliminare la tabella dei partecipanti al sondaggio, fai clic sul pulsante '''Visualizza partecipanti''' e cerca il pulsante '''Elimina tabella partecipanti''' situato nella parte in alto a destra dello schermo.


<syntaxhighlight lang="php" enclose="div">    'components' => array(
 
       ...
<center>[[File:Elimina tabella dei partecipanti al sondaggio.png]]</center>
       'request' => array(
 
           'hostInfo' => 'http://www.example.com',
 
       ),
Apparirà una finestra che chiede la conferma finale.
   )
 
 
<center>[[File:Confirmation - elimina la tabella dei partecipanti al sondaggio.png]]</center>
 
 
Tieni presente che questo non eliminerà la tabella dall'installazione di LimeSurvey. Verrà creato un backup. Per accedervi sono necessari i diritti di amministratore di sistema.
 
Se desideri rimuoverlo completamente, usa l'opzione [[Controlla l'integrità dei dati|controlla l'integrità dei dati]] che si trova nella finestra di dialogo '''Configurazione'''.
 
=Suggerimenti e consigli aggiuntivi=
 
Sentiti libero di aggiungere eventuali suggerimenti e suggerimenti all'elenco sottostante. Quelli elencati sono stati pubblicati dai membri della nostra community:
*[[Partecipanti al sondaggio#Consentire la registrazione pubblica|Consentire la registrazione pubblica]]
*[[Partecipanti al sondaggio#Captcha nella registrazione pubblica|Captcha nella registrazione pubblica]]! N!*[[Partecipanti al sondaggio#Un sondaggio che utilizza i token può garantire risposte anonime?|Un sondaggio che utilizza i token può garantire risposte anonime?]]
*[[Partecipanti al sondaggio#Un consiglio per generare un gran numero di e-mail false indirizzi|Un consiglio per generare un gran numero di indirizzi e-mail falsi]]
*[[Partecipanti al sondaggio#Problemi di spam|Problemi di spam]]
*[[Partecipanti al sondaggio#Partecipazione pseudonimizzata|Partecipazione pseudonimizzata]]
 
 
==Consentire la registrazione pubblica==
 
Puoi anche aprire il tuo sondaggio al pubblico utilizzando il tipo di controllo del rispondente disponibile quando utilizzi i token. Per fare ciò, inizializza la tabella dei partecipanti al sondaggio e scegli [[Participant settings|allow public registration]] nella configurazione principale del sondaggio. Le persone che visitano l'URL della tua indagine senza un token avranno la possibilità di registrarsi. (Questa impostazione può essere successivamente modificata dalla sezione [[Participant settings|participant settings]] che si trova nel menu delle impostazioni del sondaggio).
 
Se un partecipante fornisce un indirizzo e-mail che non è già presente nel database corrente, verrà creata una voce nella tabella dei partecipanti al sondaggio e gli verrà inviato via e-mail un invito contenente il codice token univoco.
 
==CAPTCHA nella registrazione pubblica==
 
Per proteggere il tuo sondaggio dalle registrazioni dei robot, è possibile attivare una funzione CAPTCHA per tutte le schede di registrazione, salvataggio e caricamento. Per maggiori dettagli, leggi il nostro wiki su [[Participant settings|participant settings]].
 
==Un sondaggio che utilizza i token può garantire risposte anonime?==
 
'''Sì''', i token possono essere utilizzati sia per sondaggi anonimi che non anonimi. Questo viene determinato durante la creazione di un sondaggio. Se un sondaggio non è anonimo (o "tracciato"), l'elenco dei token può essere utilizzato per trovare le risposte che un individuo ha fornito al sondaggio. Se il sondaggio è anonimo, non è disponibile alcun collegamento (tecnicamente: relazione di chiave esterna) tra gli intervistati della tabella dei partecipanti al sondaggio e le risposte corrispondenti.
 
Per abilitare o disabilitare le risposte anonime, controlla la sezione wiki [[Participant settings|participant settings]].
 
==Un suggerimento per generare un gran numero di indirizzi e-mail falsi==
 
A volte potresti aver bisogno di un gran numero di indirizzi e-mail e token falsi. È possibile utilizzare le funzioni in un foglio di calcolo (ad esempio OpenOffice Calc) per generarli. Supponiamo che tu voglia migliaia di indirizzi in un formato: 1@test.com, 2@test.com, 3@test.com e così via. Digita "1" in A1. Inserisci la funzione =A1+1 in A2, quindi copia A2 tutte le volte che vuoi in modo da ottenere un elenco di numeri consecutivi. In B1 utilizzare la funzione di concatenazione per unire A1 e "@test.com", ovvero ''=CONCATENATE(A1;"@test.com")''. Quindi copia B1 in modo che ogni cella A abbia un corrispondente (puoi anche generare nomi falsi simili). Infine, salva il file come CSV per importarlo in LimeSurvey.
 
Con il lancio di LimeSurvey 1.91, puoi utilizzare la funzionalità "Genera token fittizio". Tuttavia, le voci fittizie non contengono alcun indirizzo e-mail.
 
 
==Problemi con lo spam==
 
Gli utenti spesso si lamentano di non ricevere inviti o e-mail di promemoria perché i loro filtri antispam e-mail hanno identificato il messaggio di LimeSurvey come spam.
 
Il fatto che un'e-mail venga trattata come spam dipende principalmente dal filtro antispam utilizzato e dalle sue impostazioni. Un filtro antispam di solito controlla l'indirizzo del mittente, l'oggetto e il contenuto dell'e-mail. La modifica delle sue impostazioni potrebbe risolvere il modo in cui i provider di posta elettronica degli utenti trattano i messaggi di LimeSurvey.
 
Alcuni possibili problemi e soluzioni sono elencati nel seguente [https://www.survey-consulting.com/how-to-prevent-limesurvey-email-invitations-or-reminders-being- treated-as-spam/ Limesurvey Consulting blog inviare].
 
LimeSurvey cerca automaticamente di determinare l'URL per il link di invito guardando l'URL con cui hai effettuato l'accesso all'amministrazione di LimeSurvey. Tuttavia, con alcune (errate) configurazioni del server questo potrebbe non funzionare correttamente e sarà necessario impostarlo manualmente.
 
Puoi modificare "application/config/config.php" per modificare il valore predefinito dell'URL di base. Aggiungi una proprietà ''hostInfo'', come mostrato di seguito, all'array 'components' esistente.
 
<syntaxhighlight lang="php">'components' => array(
...
'config' => array(
.......
'publicurl' => 'http://www.example. com',
........
),
)
</syntaxhighlight>
</syntaxhighlight>


Regarding the source of the problem: LimeSurvey tried to determine the domain from the server PHP variable $_SERVER<nowiki>[</nowiki>'HTTP_HOST'] or $_SERVER<nowiki>[</nowiki>'SERVER_NAME'].
<div class="simplebox">[[File:help.png]]Per maggiori dettagli su come modificare il file di configurazione della tua installazione di LimeSurvey, leggi il nostro wiki su [[Impostazioni opzionali|Impostazioni opzionali di LimeSurvey]].</div>
 
Some web server software do not properly seem to provide this information or are mis-configured.


= Public registration=
Per quanto riguarda l'origine del problema, LimeSurvey ha provato a determinare il dominio dalla variabile PHP del server: $_SERVER<nowiki> [</nowiki> 'HTTP_HOST'] o $_SERVER<nowiki> [</nowiki> 'NOME DEL SERVER'].


==Allowing public registration==
Alcuni software del server Web non sembrano fornire correttamente queste informazioni o sono configurati in modo errato.


You may want to open your survey to the public, but utilize the sort of respondent control available when using tokens. This is possible: If you initialize your tokens table, and have chosen to Allow Public Registration in the main survey setup, people who visit your survey's URL without a token, will be given the opportunity to register. If they provide an email address that is not already in the current survey's tokens table, an entry in the tokens table will be created, and they will be emailed an invitation containing their unique Token. All tokens provided to "registering" visitors will begin with the letter "R".
==Partecipazione pseudonimizzata==


==Captchas in public registration==
Con i token fittizi, puoi creare una forma di partecipazione pseudonimizzata esportando i token fittizi creati e quindi combinandoli con il tuo elenco di partecipanti esternamente. In questo modo, LimeSurvey può essere utilizzato come piattaforma di sondaggi senza inserire le informazioni personali dei partecipanti nel sistema.


To protect your survey from robot registration there is a captcha feature on all Registration, Save and Load forms. (starting from version 1.48) This feature is only available if you have GD-support activated in your PHP configuration. (see [[Installation|Installation Requirements]])
L'unico aspetto negativo è che dovrai distribuire tu stesso i token di partecipazione.

Latest revision as of 08:33, 5 December 2023

Other languages:

Introduzione

La funzionalità Partecipanti al sondaggio ti consente di invitare un gruppo di persone a partecipare al tuo sondaggio, tenere traccia di chi ha completato il sondaggio e garantire che ogni persona possa partecipare solo una volta. La funzione della tabella dei partecipanti al sondaggio consente di eseguire le seguenti operazioni:

  • Importare un elenco di nomi e indirizzi e-mail per i partecipanti da un file CSV o da un file Query LDAP;
  • Genera un codice token univoco per ogni partecipante (codice di invito);
  • Invia un invito via email a ogni persona nella tua lista (per gruppo o individualmente);! N!*Invia un'e-mail di promemoria a ogni persona nella tua lista che non ha ancora risposto (per gruppo o individualmente);
  • Tieni traccia di chi ha risposto dalla tua lista di partecipanti al sondaggio;
  • Limita l'accesso per le persone che non hanno ricevuto un token e quelli con un token che hanno già risposto;
  • Modifica/modifica qualsiasi dettaglio nel tuo elenco;
  • Crea modelli di email per inviti e promemoria.

Una volta che il sondaggio è passato alla modalità Accesso chiuso solo le persone che forniscono un codice token univoco (che non è stato già utilizzato) possono accedere al sondaggio. (Devi prima creare una tabella dei partecipanti al sondaggio per il rispettivo sondaggio).

Se abiliti l'opzione Consenti registrazione pubblica dal pannello Tabella dei partecipanti al sondaggio, i partecipanti al sondaggio potranno registrarsi al tuo sondaggio ricevendo un codice token generato automaticamente.

Template:Nota

Come creare una tabella dei partecipanti al sondaggio

per inizializzare una tabella dei partecipanti al sondaggio: Impostazioni > Menu sondaggio > Partecipanti al sondaggio:



Verrà visualizzato il seguente messaggio:



Se inizializzi una tabella dei partecipanti, il sondaggio sarà accessibile solo a quei partecipanti che forniscono un codice token nel processo di registrazione (manualmente o tramite URL). In questo modo, il sondaggio passerà alla modalità ad accesso chiuso.

Una volta inizializzato, verrà visualizzata una finestra che conferma la creazione della tabella dei partecipanti al sondaggio.


Riattivare una tabella dei partecipanti al sondaggio

Quando elimini una tabella dei partecipanti al sondaggio, viene creato un backup. Successivamente può essere riattivato se si desidera utilizzare quella specifica tabella dei partecipanti al sondaggio in un altro sondaggio.


File:Ripristina vecchie tabelle token.png

Gli strumenti di gestione della tabella dei partecipanti al sondaggio

Verrà visualizzato un riepilogo dei partecipanti al sondaggio se la tabella dei partecipanti al sondaggio è stata creata in precedenza. Questa è la schermata predefinita:


File:Sommario dei partecipanti al sondaggio.png


  • Record totali: Il numero di partecipanti al sondaggio dalla tabella dei partecipanti al sondaggio;
  • Totale senza token univoco: Visualizza il numero di utenti senza un codice token assegnato;!N !*Totale inviti inviati: Mostra il numero di inviti che sono stati inviati ai partecipanti al sondaggio dalla tabella Partecipanti al sondaggio utilizzando l'opzione Inviti dal menu Inviti e promemoria menu;
  • Totale esclusi: Visualizza il numero totale di partecipanti al sondaggio che hanno deciso di rinunciare al sondaggio;
  • Totale escluso: Utilizzato per filtrare ed escludere potenziali partecipanti che non soddisfano determinati criteri.
  • Sondaggi totali completati: Mostra il numero di sondaggi che sono stati completati da quegli utenti che sono stati assegnato un codice token.


Sopra la tabella Riepilogo dei partecipanti al sondaggio, troverai gli Strumenti di gestione della tabella dei partecipanti al sondaggio:



  • Visualizza partecipanti: Visualizza una tabella dei partecipanti al sondaggio con tutti i partecipanti attuali. Dalla schermata Sfoglia è possibile modificare o eliminare singole voci dalla tabella nonché eseguire una serie di altre funzioni utili (vedere la sezione Visualizza wiki partecipanti di seguito per maggiori dettagli);
*Crea...: consente all'amministratore del sondaggio di aggiungere i rispondenti alla tabella dei partecipanti al sondaggio tramite l'opzione Aggiungi partecipante o tramite Importa partecipanti  function;
  • Gestisci attributi: consente all'amministratore del sondaggio di aggiungere ulteriori campi alla tabella dei partecipanti al sondaggio per memorizzare i dati personalizzati dei partecipanti;
  • Esporta: per esportare le tabelle dei token e utilizzarle in altri sondaggi, utilizzare questa funzione. Il file verrà salvato nel formato .CSV;
  • Partecipanti al sondaggio: ti consente di invitare o ricordare ai tuoi partecipanti dalla tabella dei partecipanti al sondaggio di compilare il tuo sondaggio online;! N!*Genera token: consente all'amministratore del sondaggio di assegnare rapidamente un codice token univoco casuale a ciascun utente dalla tabella dei partecipanti al sondaggio che non ne ha uno;
  • Visualizza in CPDB: Fornisce un accesso rapido alla tua installazione di LimeSurvey database centrale dei partecipanti (CPDB). Da lì puoi assegnare gli utenti CPDB come partecipanti al sondaggio a qualsiasi sondaggio.


Visualizza partecipanti

Mostra l'elenco delle voci dalla tabella dei partecipanti al sondaggio e consente all'utente di:


File:Azioni-token.png


Ordina i partecipanti al sondaggio

La seconda riga della tabella include vari criteri che possono aiutare l'amministratore del sondaggio a ordinare le voci. Se fai clic su una qualsiasi delle colonne/criteri della tabella, la schermata verrà aggiornata, mostrando i partecipanti al sondaggio ordinati in base al criterio su cui hai appena fatto clic. Fare clic due volte su di esso per visualizzare i risultati in ordine decrescente.


File:Visualizza partecipanti - sort.png


Filtra i partecipanti al sondaggio

Per filtrare i partecipanti al sondaggio, scegli la colonna che vuoi filtrare. Quindi digita i valori/stringhe su cui desideri filtrare nella casella vuota sotto la colonna desiderata.


File:Visualizza partecipanti - filter.png


Ad esempio, digita "OK" nel campo dello stato dell'e-mail per restituire solo i partecipanti che hanno un indirizzo e-mail valido.

Suggerimento: Puoi anche utilizzare gli operatori quando filtri i partecipanti al sondaggio (ad es.: >, <, >=, <=, = ).
  Attenzione : Per filtrare le colonne "invito inviato", "promemoria inviato" e "sondaggio completato", utilizzare "=N" o "<>N", che significa "uguale No" e "diverso da No", rispettivamente.


Esegui un'azione specifica su una singola voce

La colonna Azione è dove puoi trovare tutte le azioni disponibili per ogni singola voce dalla tabella dei partecipanti al sondaggio. Le possibili azioni che possono essere eseguite sono:


File:Visualizza partecipanti - azione partecipante.png


  • Visualizza i dettagli della risposta: Se il sondaggio è un sondaggio "tracciato" (cioè non anonimo), verrà visualizzato un altro pulsante che ti consentirà di visualizzare la risposta da questa singola voce;
  • Avvia il sondaggio con questo token: Utilizzato per eseguire un sondaggio utilizzando il codice del token generato;
  • Invia invito tramite e-mail: Utilizzare questa opzione per inviare un invito tramite e-mail al rispettivo partecipante a completare il sondaggio;
  • Modifica il partecipante al sondaggio: Fare clic per modificare il sondaggio dati del partecipante;
  • Elimina partecipante al sondaggio: Fare clic per eliminare quella particolare voce;
  • Visualizza questa persona nel database centrale dei partecipanti: verrà visualizzata un'icona se il la rispettiva voce si trova anche nel database centrale dei partecipanti.

Esegui un'azione specifica su più di una voce

Nella parte in basso a sinistra della tabella, troverai il pulsante Partecipante/i selezionato/i... che ti consente di eseguire determinate azioni a livello macro:


File:Visualizza partecipanti - azioni partecipanti.png


  • Invia inviti via email: Invia inviti via email ai partecipanti al sondaggio selezionati;
  • Invia promemoria via email: Invia promemoria via email ai partecipanti al sondaggio selezionati;
  • Aggiungi partecipanti al database centrale: Per utilizzare alcune voci token in un altro sondaggio, aggiungi i partecipanti selezionati al database centrale dei partecipanti. Da lì, hai la possibilità di aggiungere i partecipanti a qualsiasi sondaggio desideri. Per maggiori dettagli, continua a leggere la pagina wiki Condividi questo partecipante.


Prima di eseguire una qualsiasi delle funzioni sopra menzionate, non dimenticare di selezionare i partecipanti al sondaggio sui quali verrà eseguita l'azione.


Crea...

Per avere più partecipanti elencati nella tabella dei partecipanti al sondaggio, puoi aggiungerne di nuovi o importarli da un file CSV o da una query LDAP.


File:Partecipanti al sondaggio - Crea....png


Aggiungi partecipante

Una tipica voce token contiene i seguenti campi:



  • ID: Un numero intero assegnato automaticamente a ciascun partecipante al sondaggio;
  • Completato?: Disabilitato per impostazione predefinita. Se abilitato, conterrà la data in cui il sondaggio è stato completato. Nessun invito o promemoria viene inviato ai rispettivi utenti se questo è abilitato. Viene abilitato automaticamente se il rispettivo partecipante al sondaggio ha completato il sondaggio utilizzando il codice token assegnatogli;
  • Nome: Il nome del partecipante al sondaggio;
  • Cognome: Il cognome del partecipante al sondaggio;
  • Token : Questo è il codice di invito. Può essere generato manualmente o automaticamente (tramite il pulsante Genera token);
  • Lingua: Qui puoi selezionare la lingua predefinita del sondaggio per il rispettivo partecipante;!N !*Email: L'indirizzo email del partecipante;
  • Stato email: Questo campo ti aiuta a tenere traccia degli indirizzi email non validi. Ad esempio, se l'amministratore del sondaggio ha ricevuto notifiche di errore e-mail da questa e-mail, può impostare questo campo su qualsiasi valore diverso da "OK" (ad esempio "utente sconosciuto" o "quota casella di posta superata"). Contrassegnare questo campo con uno stato e-mail diverso da "OK" aiuterà a saltare questa voce durante l'invio di e-mail di invito o promemoria. Nota che questo è completamente manuale, a meno che tu non decida di implementare uno script che aggiorni automaticamente questo campo;
  • Invito inviato?: Se abilitato, contiene la data in cui è stata inviata la mail di invito;
*Promemoria inviato?: Se abilitato, contiene la data in cui è stata inviata la mail di sollecito;
  • Usi rimasti: Conta il numero di volte in cui il token può essere utilizzato. Nota: Quando si aumenta questo valore (predefinito = 1) per un utente che ha già compilato il sondaggio (che imposta gli usi lasciati a 0), è necessario cambiare anche il campo Completato da " Sì" a "No";
  • Valido da: & Fino a:È possibile impostare un intervallo di data/ora per quando questo token può essere utilizzato. Puoi lasciarli vuoti se non vuoi limitare l'intervallo di tempo di partecipazione per determinati utenti. Se l'utente sta rispondendo al sondaggio e il tempo di partecipazione termina, l'utente viene bloccato immediatamente e non sarà in grado di completare il sondaggio.

Si noti che il pannello Aggiungi partecipante al sondaggio ha due schede: la scheda Generale e la scheda Attributi aggiuntivi. La scheda degli attributi aggiuntivi ti offre l'accesso ai tuoi attributi personalizzati: leggi la seguente sezione wiki per maggiori dettagli.


Crea partecipanti fittizi

Un partecipante fittizio può essere utilizzato quando non si desidera inviare token via e-mail ai partecipanti al sondaggio, ma fornire loro codici token con altri mezzi. Ad esempio, agli studenti che effettuano le valutazioni in classe potrebbe essere consegnato un foglio con un codice di invito da inserire all'inizio del sondaggio online. In questo modo, aumenta la probabilità di ricevere più risposte e feedback.

Fare clic su Crea partecipanti fittizi e verrà visualizzata la seguente pagina:


File:Partecipanti al sondaggio - crea un partecipante fittizio.png


Il campo "Numero di partecipanti" ti consente di inserire il numero di partecipanti fittizi che desideri aggiungere alla tabella dei partecipanti al sondaggio. La spiegazione degli altri campi è disponibile nella sottosezione wiki Aggiungi partecipante.

Dopo aver completato i campi, premere Salva situato nella parte in alto a destra dello schermo.


Per verificare se sono stati aggiunti o meno, controlla la tabella Partecipanti al sondaggio:


File:Variabili fittizie - semplice esempio.png

Importa partecipanti da un file CSV

La funzione di importazione consente di importare informazioni da un File CSV o Query LDAP.


File:Partecipanti al sondaggio - import csv.png


  • Scegli il file CSV da caricare: Scegli il file CSV che desideri importare. Per eliminare eventuali errori, si consiglia di importare un file CSV standard (delimitato da virgole) con virgolette doppie opzionali intorno ai valori (impostazione predefinita per OpenOffice ed Excel).

La prima riga deve contenere i nomi dei campi. Deve inoltre contenere i seguenti campi: nome, cognome, email.

Devono contenere almeno un carattere. La semplice aggiunta di virgolette doppie e nessun carattere tra di loro non funzionerà!

Gli altri campi sono opzionali: emailstatus, token, language, validfrom, validuntil, attribute_1, attribute_2, attribute_3, usesleft, ... .


 Hint: Per ottenere un elenco completo dei nomi dei campi token, esporta una tabella dei partecipanti al sondaggio esistente.


 Hint: Il formato della data per i campi "validfrom" e "validuntil" nel file di importazione del token CSV è "YYYY-MM-DD HH:MM".


  • Set di caratteri del file: Seleziona l'opzione che si adatta ai caratteri utilizzati nel file CSV;
  • Separatore utilizzato: Puoi consentire a LimeSurvey di rilevare automaticamente il separatore utilizzato nel tuo CSV o seleziona il separatore virgola o punto e virgola;
  • Filtra indirizzi email vuoti: Se abilitato, i partecipanti al sondaggio senza indirizzo email non verranno importati in la tabella dei partecipanti al sondaggio;
  • Consenti indirizzi e-mail non validi: Se disabilitata, questa funzione esaminerà i campi degli indirizzi e-mail e verificherà se gli indirizzi hanno o meno la struttura di un'e-mail (es: a@ una rete);
  • Visualizza avvisi attributi: Se abilitato, dopo il processo di importazione verranno visualizzati avvisi nel caso ci sia qualcosa che non va nei campi. Per esempio. potresti ricevere un avviso di attributo se non viene fornito nulla in nessuno dei campi obbligatori o se un'e-mail viene inserita in modo errato nel file CSV.
  • Filtra record duplicati: Se abilitato, puoi impostare quali campi vengono utilizzati per identificare i duplicati. Per impostazione predefinita, sono preselezionati Nome, Cognome e Indirizzo e-mail. Se durante l'importazione viene trovato un duplicato, la relativa riga viene omessa.
  • I duplicati sono determinati da: Seleziona i campi che vuoi filtrare per i duplicati.


Puoi anche importare attributi personalizzati durante l'importazione di un file CSV. Dovrai definire quali attributi verranno aggiunti. Puoi farlo in questo modo: 


   email,attribute_1 <Casenr>, token, attribute_2 <Title>, attribute_3 <destination>, lastname,firstname,attribute_4 <Sender>


Una volta che hai finito di scegliere le impostazioni di importazione desiderate, non dimenticare di fare clic sul pulsante Carica.


Risoluzione dei problemi relativi all'importazione dei partecipanti al sondaggio

Un errore comune quando gli utenti tentano di importare i token è un file CSV non valido. Questo è spesso causato da Microsoft Excel. Molti utenti hanno un elenco di indirizzi e-mail salvati come documento XLS. Un file può essere salvato come CSV in Excel. Tuttavia, a seconda delle impostazioni locali del sistema operativo, Microsoft Excel può utilizzare i punti e virgola (;) come separatore virgola, mentre un file CSV standard utilizza le virgole (,) come separatori. Se non sai quale utilizzare, apri il file con un editor di testo standard e verifica quale separatore è stato utilizzato.

Gli editor di testo raw gratuiti consigliati sono: [1], NotePad2 o .org/ Notepad++ per Windows e TextWrangler per Macintosh.


LimeSurvey dovrebbe anche rilevare i punti e virgola come separatori. Tuttavia, nel caso in cui il processo di importazione non funzioni correttamente, sostituire i punti e virgola con le virgole. Anche le virgolette doppie dovrebbero essere aggiunte intorno ai valori.


Importa partecipanti da una query LDAP

  Attenzione : Questa opzione è consigliata solo agli utenti con conoscenze avanzate nelle query LDAP.


Questa funzione di importazione consente di importare informazioni da una query LDAP (testato su openLdap, ma dovrebbe funzionare in qualsiasi directory conforme a LDAP, incluso ActiveDirectory). Nella pagina Importa partecipanti al sondaggio da LDAP sono disponibili le seguenti opzioni:


File:Importa partecipanti al sondaggio da LDAP.png
  • Le query sono definite manualmente dall'amministratore di sistema nel file config-ldap.php.
  • I duplicati sono identificati da Nome, Cognome e Indirizzo e-mail. Se durante l'importazione viene trovato un duplicato, la relativa riga viene omessa (a meno che tu non abbia deselezionato la casella Filtra duplicati).

Template:Nota

Gestisci attributi

Questa opzione consente di aggiungere/modificare i campi aggiuntivi della tabella dei partecipanti al sondaggio. I campi aggiuntivi vengono utilizzati per archiviare i dati dei partecipanti al sondaggio personalizzato.


File:Partecipanti al sondaggio - Aggiungi attributi.png


Digita il numero di nuovi campi di attributo che desideri aggiungere alla tabella dei partecipanti al sondaggio. Fare clic sul pulsante Aggiungi campi. Verrà visualizzata la seguente pagina:



La tabella dei campi degli attributi contiene i seguenti campi:

  • Campo attributo: Il valore digitato qui può essere utilizzato quando si desidera eseguire diverse operazioni con il rispettivo campo attributo personalizzato, ad esempio l'applicazione di condizioni in base ai campi degli attributi o durante l'esportazione dei risultati per i sondaggi non anonimi.
  • Descrizione del campo: Utilizzato per sostituire il nome campo degli attributi. Assegnando un nome personalizzato a ciascun campo attributo, questi appariranno più belli nel pannello di amministrazione, quando sfogli i token, quando crei condizioni basate sui campi attributo o quando esporti i risultati per sondaggi non anonimi.
  • Obbligatorio ?: Se abilitato, il rispettivo campo attributo deve essere compilato dall'amministratore del sondaggio. In caso contrario, l'intervistato non può essere registrato nella tabella dei partecipanti al sondaggio.
  • Mostra durante la registrazione?: Se i partecipanti al sondaggio devono registrarsi prima di completare un sondaggio, verranno loro richiesti alcuni dettagli. Se disabilitato, il rispettivo campo di attributo non verrà visualizzato nella pagina di registrazione del sondaggio.
  • Field caption: Utilizzare questi campi per aggiungere ulteriori dettagli sul ruolo/utilizzo del rispettivo campo attributo.
  • CPDB mapping: Mappa l'attributo per collegarlo all'attributo corrispondente dal database centrale dei partecipanti.
  • Dati di esempio: Contiene esempi di stringhe da diversi campi. Ad esempio, se desideri chiedere il sesso del partecipante al sondaggio, nel campo Dati di esempio vedrai esempi come maschio, femmina, nessuna risposta ecc.


Una volta che hai finito di compilare le caselle, non dimenticare di cliccare sul pulsante Salva situato nella parte in basso a sinistra dello schermo.

Istruzioni dettagliate su come aggiungere ulteriori campi di attributo e condizioni di utilizzo basate su questi valori possono essere trovate in questo post del blog: "-based-on-token-attributes/ Condizioni basate sugli attributi del token".

Per aggiungere altri campi, vai in fondo alla pagina e digita nella casella Numero di campi attributo da aggiungere il numero desiderato e fai clic sul pulsante Aggiungi campi.

Se desideri eliminare un attributo personalizzato, vai in fondo alla pagina e seleziona dall'elenco a discesa situato sotto il campo Elimina questo attributo l'attributo che desideri eliminare. Una volta selezionato, fai clic su Elimina attributo e conferma l'eliminazione.

Esporta

Per esportare una tabella dei partecipanti al sondaggio, fai clic sul pulsante "Esporta" situato sulla barra degli strumenti degli strumenti di gestione dei token. Prima di esportare l'elenco dei partecipanti al sondaggio, selezionare le opzioni di esportazione desiderate.


File:Partecipanti al sondaggio - export.png


  • Stato sondaggio:
    • Tutti i token: Esporta tutti i partecipanti al sondaggio dalla tabella dei partecipanti al sondaggio;
    • Completato: Esporta solo i partecipanti al sondaggio che hanno ha completato il sondaggio;
    • Non completato: Esporta i partecipanti al sondaggio che non hanno ancora completato il sondaggio;
    • Non iniziato: Esporta i partecipanti al sondaggio che non hanno ancora iniziato il sondaggio ;
    • Iniziato ma non ancora completato: Esporta i partecipanti al sondaggio che hanno già iniziato il sondaggio, ma non l'hanno completato.
  • Stato invito: Esporta i partecipanti in base al stato invito: tutti, invitato e non invitato;
  • Stato promemoria: Esporta i partecipanti in base allo stato del promemoria: tutti, Promemoria inviato, Nessun promemoria inviato;
  • Filtra per lingua: Quando crei un sondaggio, puoi aggiungere altre lingue oltre alla lingua di base . Queste lingue aggiuntive possono essere utilizzate per esportare i partecipanti al sondaggio in base alla lingua a cui sono assegnati;
  • Filtra per indirizzo email: Esporta le voci che contengono la stringa nel rispettivo indirizzo email. Ad esempio, puoi utilizzarlo se alcuni dei tuoi partecipanti al sondaggio utilizzano gli indirizzi e-mail di lavoro dell'"Azienda A". Digita @aziendaa.com ed esporta solo gli utenti che hanno ricevuto un indirizzo email di lavoro dalla rispettiva azienda;
  • Elimina partecipanti esportati: Se abilitato, gli utenti esportati verranno eliminati da la tabella dei partecipanti al sondaggio.

Dopo aver selezionato le opzioni di esportazione, fai clic sul pulsante Scarica file CSV situato nella parte in alto a destra dello schermo.

Quando esporti i partecipanti al sondaggio, i campi vengono esportati nel seguente ordine:

tid,firstname,lastname,email,emailstatus,token,language code,attribute_1,attribute_2,...

Inviti e promemoria

Inviti e promemoria ti permette di gestire il sistema di inviti di LimeSurvey. Puoi inviare inviti o promemoria ai partecipanti visualizzati nella tua tabella partecipanti sondaggio. Un sistema di monitoraggio del mancato recapito delle email può essere utilizzato per aiutarti a tracciare e contrassegnare le email che non sono state consegnate ai destinatari (partecipanti al sondaggio).


Invia email di invito

Dalla tabella dei partecipanti al sondaggio puoi inviare e-mail di invito in blocco a tutti i partecipanti a cui non ne è stato inviato uno.


File:Token-invito.png


Puoi ignorare i partecipanti al sondaggio che hanno uno stato e-mail diverso da "OK" abilitando l'opzione Ignora token con indirizzi e-mail in errore.

Per superare le impostazioni di validità di tutti i tuoi inserimenti, abilita la funzione Ignora controllo data prima di inviare email. In questo modo, la funzione email di LimeSurvey non terrà conto dell'intervallo di data/ora in cui un token può essere utilizzato.


Nuovo invio degli inviti

Utilizza questa funzionalità per inviare nuovamente gli inviti a determinati partecipanti al sondaggio. Quando utilizzi la funzione invia inviti, solo un indirizzo email che non ha ricevuto in precedenza un invito ne riceverà uno. Ciò significa che se aggiungi nuovi indirizzi email all'elenco dei partecipanti al sondaggio dopo l'invio dei primi inviti, solo questi nuovi indirizzi riceveranno un invito la seconda volta che invii gli inviti.

Ciò significa che puoi anche modificare un indirizzo e-mail in una particolare voce della tabella da cui hai ricevuto un'e-mail respinta e quindi inviarla solo a questo indirizzo modificato. Per farlo, disattiva il campo Invito inviato e fai nuovamente clic su invia inviti.

Invia promemoria via e-mail

Invia e-mail di promemoria in blocco a tutti i partecipanti dalla tabella dei partecipanti al sondaggio che non hanno ancora risposto, ma a cui è stato inviato il primo invito.



Quando invii promemoria puoi:

  • Ignorare i token con indirizzi e-mail in errore: le voci con un indirizzo e-mail in errore verranno ignorate - non riceveranno un'e-mail;
  • Min giorni tra promemoria: salta i token se un promemoria è stato inviato "recentemente";
  • Max promemoria: salta i token se è già stato inviato un determinato numero di promemoria;
  • 'Aggira controllo data prima di inviare email:' salta quelle voci che non rientrano nel periodo di tempo in cui possono essere utilizzate.
Nota: verrà inviato un promemoria solo ai partecipanti in cui il campo "Completato" è disattivato (ciò significa che l'intervistato non ha partecipato o non ha completato il sondaggio).


Invio di e-mail in batch

Quando invii un numero elevato di email contemporaneamente, LimeSurvey invierà solo il primo batch di N email (questa soglia è impostata dall'amministratore dalle impostazioni email, che si trova nelle impostazioni globali della tua installazione di LimeSurvey).

Email di conferma

Se si utilizzano token e un partecipante compila il sondaggio, viene inviata un'e-mail di conferma al suo indirizzo e-mail.

Se non vuoi che questo messaggio venga inviato, disattiva questa funzionalità da the general settings of your survey.

Avvia l'elaborazione del rimbalzo

Quando si invia un'e-mail, il sistema di tracciamento del mancato recapito dell'e-mail di LimeSurvey aggiunge automaticamente un ID sondaggio e un ID token all'intestazione della posta. Queste "intestazioni personalizzate" vengono aggiunte a ciascuna e-mail di invito inviata tramite l'installazione di LimeSurvey ai partecipanti al sondaggio. Quando l'e-mail viene respinta, viene ricevuta l'intestazione originale insieme all'intestazione "Notifica di consegna". Il sistema quindi verifica la presenza di nuove e-mail e analizza le e-mail che hanno queste intestazioni personalizzate e contrassegna l'indirizzo e-mail errato nella tabella dei partecipanti al sondaggio.


Impostazioni rimbalzo

Opzioni Impostazioni rimbalzo:


File:SondaggioBounseSettings.png


Per una breve descrizione di ogni campo, controlla la seguente sezione wiki. Per utilizzare l'installazione di LimeSurvey Impostazioni globali, vai su Impostazioni di rimbalzo utilizzate e seleziona l'opzione Utilizza impostazioni globali.

Template:Nota

Fai clic sul link seguente per ulteriori informazioni su come configurare correttamente questa funzione.

Modifica modelli email

Per saperne di più su quali segnaposto puoi utilizzare o su come modificare i modelli di email di LimeSurvey, leggi la nostra sezione wiki su modelli di email.


Genera token

Con l'aiuto di questa funzione, è possibile creare token univoci per tutte le voci individuali dalla tabella dei partecipanti al sondaggio che non hanno ancora ricevuto un codice token.


File:Partecipanti al sondaggio - Genera token.png

Visualizza in CPDB

L'ultima opzione sulla barra degli strumenti di gestione dei token è l'opzione Visualizza in CPDB. Ciò consente all'amministratore del sondaggio di vedere i partecipanti che esistono sia nel database centrale dei partecipanti che nell'elenco dei partecipanti al sondaggio.

Nell'esempio seguente, abbiamo il seguente elenco di partecipanti al sondaggio:


File:Elenco dei partecipanti al sondaggio - visualizza in cpdb.png


Gli utenti con ID 1 e 2 sono stati condivisi dal database centrale dei partecipanti. Per verificarlo, vai alla barra degli strumenti di gestione della tabella dei partecipanti al sondaggio e fai clic su Visualizza in CPDB


File:Visualizza in CPDB - filter.png


Come puoi vedere, la funzione Visualizza in CPDB sostanzialmente applica un filtro per determinare quali utenti del CPDB sono presenti nel rispettivo sondaggio.

Elimina tabella

Per eliminare la tabella dei partecipanti al sondaggio, fai clic sul pulsante Visualizza partecipanti e cerca il pulsante Elimina tabella partecipanti situato nella parte in alto a destra dello schermo.


File:Elimina tabella dei partecipanti al sondaggio.png


Apparirà una finestra che chiede la conferma finale.


File:Confirmation - elimina la tabella dei partecipanti al sondaggio.png


Tieni presente che questo non eliminerà la tabella dall'installazione di LimeSurvey. Verrà creato un backup. Per accedervi sono necessari i diritti di amministratore di sistema.

Se desideri rimuoverlo completamente, usa l'opzione controlla l'integrità dei dati che si trova nella finestra di dialogo Configurazione.

Suggerimenti e consigli aggiuntivi

Sentiti libero di aggiungere eventuali suggerimenti e suggerimenti all'elenco sottostante. Quelli elencati sono stati pubblicati dai membri della nostra community:


Consentire la registrazione pubblica

Puoi anche aprire il tuo sondaggio al pubblico utilizzando il tipo di controllo del rispondente disponibile quando utilizzi i token. Per fare ciò, inizializza la tabella dei partecipanti al sondaggio e scegli allow public registration nella configurazione principale del sondaggio. Le persone che visitano l'URL della tua indagine senza un token avranno la possibilità di registrarsi. (Questa impostazione può essere successivamente modificata dalla sezione participant settings che si trova nel menu delle impostazioni del sondaggio).

Se un partecipante fornisce un indirizzo e-mail che non è già presente nel database corrente, verrà creata una voce nella tabella dei partecipanti al sondaggio e gli verrà inviato via e-mail un invito contenente il codice token univoco.

CAPTCHA nella registrazione pubblica

Per proteggere il tuo sondaggio dalle registrazioni dei robot, è possibile attivare una funzione CAPTCHA per tutte le schede di registrazione, salvataggio e caricamento. Per maggiori dettagli, leggi il nostro wiki su participant settings.

Un sondaggio che utilizza i token può garantire risposte anonime?

Sì, i token possono essere utilizzati sia per sondaggi anonimi che non anonimi. Questo viene determinato durante la creazione di un sondaggio. Se un sondaggio non è anonimo (o "tracciato"), l'elenco dei token può essere utilizzato per trovare le risposte che un individuo ha fornito al sondaggio. Se il sondaggio è anonimo, non è disponibile alcun collegamento (tecnicamente: relazione di chiave esterna) tra gli intervistati della tabella dei partecipanti al sondaggio e le risposte corrispondenti.

Per abilitare o disabilitare le risposte anonime, controlla la sezione wiki participant settings.

Un suggerimento per generare un gran numero di indirizzi e-mail falsi

A volte potresti aver bisogno di un gran numero di indirizzi e-mail e token falsi. È possibile utilizzare le funzioni in un foglio di calcolo (ad esempio OpenOffice Calc) per generarli. Supponiamo che tu voglia migliaia di indirizzi in un formato: 1@test.com, 2@test.com, 3@test.com e così via. Digita "1" in A1. Inserisci la funzione =A1+1 in A2, quindi copia A2 tutte le volte che vuoi in modo da ottenere un elenco di numeri consecutivi. In B1 utilizzare la funzione di concatenazione per unire A1 e "@test.com", ovvero =CONCATENATE(A1;"@test.com"). Quindi copia B1 in modo che ogni cella A abbia un corrispondente (puoi anche generare nomi falsi simili). Infine, salva il file come CSV per importarlo in LimeSurvey.

Con il lancio di LimeSurvey 1.91, puoi utilizzare la funzionalità "Genera token fittizio". Tuttavia, le voci fittizie non contengono alcun indirizzo e-mail.


Problemi con lo spam

Gli utenti spesso si lamentano di non ricevere inviti o e-mail di promemoria perché i loro filtri antispam e-mail hanno identificato il messaggio di LimeSurvey come spam.

Il fatto che un'e-mail venga trattata come spam dipende principalmente dal filtro antispam utilizzato e dalle sue impostazioni. Un filtro antispam di solito controlla l'indirizzo del mittente, l'oggetto e il contenuto dell'e-mail. La modifica delle sue impostazioni potrebbe risolvere il modo in cui i provider di posta elettronica degli utenti trattano i messaggi di LimeSurvey.

Alcuni possibili problemi e soluzioni sono elencati nel seguente treated-as-spam/ Limesurvey Consulting blog inviare.

LimeSurvey cerca automaticamente di determinare l'URL per il link di invito guardando l'URL con cui hai effettuato l'accesso all'amministrazione di LimeSurvey. Tuttavia, con alcune (errate) configurazioni del server questo potrebbe non funzionare correttamente e sarà necessario impostarlo manualmente.

Puoi modificare "application/config/config.php" per modificare il valore predefinito dell'URL di base. Aggiungi una proprietà hostInfo, come mostrato di seguito, all'array 'components' esistente. 

'components' => array(
 ...
 'config' => array(
 .......
 'publicurl' => 'http://www.example. com',
 ........
 ),
 )
Per maggiori dettagli su come modificare il file di configurazione della tua installazione di LimeSurvey, leggi il nostro wiki su Impostazioni opzionali di LimeSurvey.

Per quanto riguarda l'origine del problema, LimeSurvey ha provato a determinare il dominio dalla variabile PHP del server: $_SERVER [ 'HTTP_HOST'] o $_SERVER [ 'NOME DEL SERVER'].

Alcuni software del server Web non sembrano fornire correttamente queste informazioni o sono configurati in modo errato.

Partecipazione pseudonimizzata

Con i token fittizi, puoi creare una forma di partecipazione pseudonimizzata esportando i token fittizi creati e quindi combinandoli con il tuo elenco di partecipanti esternamente. In questo modo, LimeSurvey può essere utilizzato come piattaforma di sondaggi senza inserire le informazioni personali dei partecipanti nel sistema.

L'unico aspetto negativo è che dovrai distribuire tu stesso i token di partecipazione.

Retrieved from "http://manual.limesurvey.org/index.php?title=Survey_participants/it&oldid=310053"