PHPSurveyor (V0.99RC3)
Documentazione

Localizzazione a cura di Mario Marani - IRRE Puglia - Bari

INDICE

- Installazione

  - FAQ su installazione

- Sicurezza

- Progettazione e struttura di un questionario

- Creare questionari

  - Creare un nuovo questionario

  - Importare un questionario

  - Creare un nuovo gruppo

  - Aggiungere una domanda

    - Attributi per le domande
    - Convalida

  - Impostazione delle condizioni

  - Aggiungere risposte

  - Esportare un quesrtionario

- Template

  - L'editor di Template in PHPSurveyor

- Localizzazione

- Attivare un questionario

- Compilare in sicurezza un questionario

- Sfogliare i risultati di una indagine

- Identificativi di accesso (Tokens)

- Inserire dati

- Esportare risultati

- Statistiche

- Licenza d'uso

In questo manuale d'uso di PHPSurveyor il termine survey viene tradotto con i termini italiani indagine o questionario attribuendo ad indagine una accezione più ampia di quella di questionario che, invece, sta a rappresentare la modalità operativa dell'indagine.

Installazione

1. Essere sicuri di poter usare PHPSurveyor sul proprio sito web.
E' necessario un web server su cui sia installato PHP 4.1.0 o superiore e la disponibilità di un database MySQL. Sono necessari da 2 a 2.5 MB di spazio su disco fisso per i file di programma.

2. Fare il Download del pacchetto PHPSurveyor
Per scaricare l'ultima versione disponibile di PHPSurveyor collegarsi con il sito sourceforge al seguente indirizzo http://sourceforge.net/projects/phpsurveyor/
Scaricare il file zip (circa 400 KB) e salvarlo sul disco locale.

3. Decomprimere il pacchetto PHPSurveyor
Creare una directory (si puo dare il nome phpsurveyor) e decomprimere il file zip scaricato utilizzando il programma di decompressione preferito.
Assicurarsi che il programma di decompressione decomprima il file zip mantenendo la struttura delle directory e dei file (questo avviene di default nella quasi totalità dei programmi di decompressione).
Il pacchetto decompresso avrà la seguente struttura delle directory:

/phpsurveyor* | /templates | /default |
|  | /edgyblue |
|  | /bubblegum |
| /lang |  |
| /tmp |  |
| /admin | /images |
|  | /lang | /english (e altre lingue)
|  | /classes |
*questo nome è quello dato alla directory creata

Permessi delle directory
La directory /admin deve avere il permesso di scrittura ("write") per poter creare indagini.
La directory /phpsurveyor/tmp usata per gli upload di alcuni file, deve essere impostata con permessi in lettura/scrittura/esecuzione (read/write/execute) (in ambiente linux o unix chmod 777).
Se si vuole usare PHPSurveyor per controllare la Apache Directory Security, la directory /phpsurveyor/admin deve essere impostata in lettura/scrittura/esecuzione (read/write/execute), in ambiente linux/unix chmod 777.
Se si vuole configurare la Apache Directory Security con altri metodi (ad es.: manualmente o utilizzando altri strumenti di amministrazione web) si può lasciare questa directory impostata in lettura/esecuzione (read/execute - chmod 755).
Le altre directory possono essere impostate in ambiente linux/unix con chmod 755.

4. Raccogliere informazioni circa il proprio server
Per installare correttamente PHPSurveyor sul proprio web server è' necessario conoscere le seguenti informazioni:

- L'URL del sito dove verranno allocati gli script di PHPSurveyor (ad es.: http://www.miodominio.it/phpsurveyor)

- La locazione fisica dei file sul proprio server (ad es.: /home/usr/htdocs/phpsurveyor)

- La locazione IP/net del server database MySQL (ad es.: localhost)

- Il numero della porta usata dal server del database MySQL se non è utilizzata la porta standard

- Il nome utente e la password per l'accesso al server database MySQL

- La locazione dei file binari MySQL (ad es.: c:/mysql/bin) se il web server è Microsoft IIS

5. Configurare PHPSurveyor
Modificare il file config.php nella directory /phpsurveyor/admin utilizzando un qualsiasi editor di testo.

Nel file config.php vanno configurate, se necessario, le seguenti variabili:

$databaselocation: è la locazione IP/net del server database MySQL. Nella maggior parte dei casi dovrebbe andare bene "localhost".

$databaseport: è il numero della porta del server database MySQL. Nella maggior parte dei casi dovrebbe andare bene la porta "3306" (di default per MySQL).

$databasename: rappresenta il nome del database disponibile sul server MySQL che sarà utilizzato da PHPSurveyor. Se si dispone di permessi tali da poter creare database sul server MySQL si può creare il database a partire da PHPSurveyor. In questo caso basterà indicare un nome (qualsiasi) del database che si vuole creare altrimenti si dovrà inserire il nome di quello già creato in precedenza (è il caso di quando il database è fornito direttamente dal provider che eroga il servizio database).

$databaseuser: è il nome utente per l'accesso a MySQL (è fornito dal provider internet o dall'amministratore del server)

$databasepass: è la password per accedere a MySQL (è fornito dal provider internet o dall'amministratore del server)

$databasetabletype: rappresenta il tipo di tabelle di default da creare all'interno del database - di default è "MyISAM"

$useidprefix: di default è 0 (zero). Se si imposta a 1 (uno) gli ID delle risposte saranno precedute da un prefisso indicato dalla variabile $idprefix successivamente descritta. Scegliere questa opzione quando più istanze di PHPSurveyor stanno svolgendo la stessa indagine. In questo caso i risultati rivenienti da diversi server possono essere raccolte in una unica tabella alla fine dell'indagine.

$idprefix: è il prefisso che viene aggiunto all'ID di ciascuna risposta su un determinato server (scrivere un nome qualsiasi per il prefisso se $useidprefix è posto ad 1).

$rooturl: è l'URL della locazione sul server dove si trovano i file PHPSurveyor. Di default PHPSurveyor imposta questa variabile a partire da {$_SERVER['SERVER_NAME']}. Se la directory sul server dove sono stati depositati i file di PHPSurveyor è /phpsurveyor non dovrebbe essere necessario cambiare nulla. Se si è attribuito un altro nome alla directory (ad esempio /questionario) allora è necessario cambiare /phpsurveyor con il nome /questionario. In caso di ulteriori difficoltà sarà necessario inserire manualmente il nome dell'URL (ad es. http://www.miodominio.it/nomedirectory )

$rootdir: è la locazione fisica dove si trovano i file PHPSurveyor. Di default PHPSurveyor imposta questa variabile a partire da {$_SERVER['DOCUMENT_ROOT']}. Se la directory sul server dove sono stati depositati i file di PHPSurveyor è /phpsurveyor non dovrebbe essere necessario cambiare nulla. Se si è attribuito un altro nome alla directory (ad esempio /questionario) allora è necessario cambiare /phpsurveyor con il nome /questionario. In caso di ulteriore difficoltà sarà necessario inserire lmanualmente il percorso ad es. "/home/public_html/questionario"

Le seguenti impostazioni non necessitano di alcun cambiamento a meno che, per una qualsiasi ragione, non sia stata cambiata la struttura delle directory per i file di PHPSurveyor

- $homeurl: è l'URL dei file di amministrazione che sono posti di default nella directory /phpsurveyor/admin. Di default questa URL verrà definita da PHPsurveyor a partire dalla variabile php {$_SERVER['SERVER_NAME']} producendo un indirizzo del tipo "http://www.miodominio.it/miadirectory/html/admin". Se si è cambiata la struttura delle directory cambiare i nomi opportunamente.

- $publicurl: è l'URL dei 'public scripts' che sono quelli posti nella directory phpsurveyor (o qualunque altro nome abbiate usato)

- $tempurl: è l'URL della directory temporanea di PHPSurveyor per la gestione dei file temporanei. Di default è /phpsurveyor/tmp altrimenti è quello che si è impostato. Attenzione: questa directory deve avere i permessi lettura/scrittura/esecuzione abilitati - in ambiente Linux chmod 777)

- $imagefiles: è il percorso dei file delle immagini di PHPSurveyor. Di default è /phpsurveyor/admin/images . Se si preferisce spostare le immagini è necessario cambiare questo percorso

- $homedir: è la locazione fisica dove sono allocati i file di amministrazione (ad es. /home/usr/htdocs/phpsurveyor/admin. Attenzione: non aggiungere la barra alla fine del percorso. Di default PHPSurveyor imposta questa variabile a partire da {$_SERVER['DOCUMENT_ROOT']}. Nella maggior parte dei casi sarà sufficiente cambiare solo la parte finale della stringa.

- $publicdir: è la locazione fisica dei 'public scripts'. Cambiarla opportunamente solo se necessario.

- $tempdir: è la locazione fisica della directory temporanea di PHPSurveyor /phpsurveyor/tmp. Cambiarla opportunamente solo se necessario.

$sitename: è il nome del sito che verrà visualizzato nelle pagine di amministrazione. Impostare il nome desiderato (ad es. Questionari on line - IRRE Puglia)

$scriptname: lasciare il nome di default admin.php a meno che non sia stato cambiato il suo nome. Se si desidera che il file di amministrazione si chiami index.php è necessario indicare qui questo cambio

$accesscontrol: questa variabile determina se PHPSurveyor deve cercare di applicare impostazioni di sicurezza. Se si imposta a "1" questa variabile saranno attivate le impostazioni di sicurezza, se è a "0" non saranno attivate. In quest'ultimo caso quanto impostato non significa aver modificato le capacità di sicurezza del Web server ma solo che PHPSurveyor non sarà in grado di modificarle. Se si usa un Web server non Apache è necessario impostare questa variabile a "0"

$defaultuser: se il controllo di sicurezza da PHPSurveyor è attivato il nome che si attribuisce a questa variabile sarà quello che PHPSurveyor userà come nome utente per l'accesso al programma

$defaultpass: se il controllo di sicurezza da PHPSurveyor è attivato il nome che si attribuisce a questa variabile sarà quello che PHPSurveyor userà come password per l'accesso al programma

$siteadminemail: è l'indirizzo e-mail dell'amministratore del sito

$siteadminname: è il nome dell'amministratore del sito

$surveyfaxnumber: è il numero di fax cui inviare il questionario quando si desidera una versione stampata

$dropdowns: può essere impostato a "L" o a "R". Se impostato a "R" le liste presenteranno pulsanti circolari (radio button); se impostato a "L" le liste presenteranno un menù a discesa tipo 'dropdown'.

$lwcdropdowns: simile al precedente ma si applica alla tipologia di domande "Liste con commenti".

$dropdownthreshold: se $lwcdropdowns è impostato a "R" questa variabile permette di impostare il numero massimo di opzioni che potranno essere mostrate come pulsanti circolari prima di essere convertite in liste di tipo "dropdown". Di default questa variabile è impostata a 25 il che vuol dire che domande con più di 25 opzioni saranno convertite da liste con pulsanti circolari a liste tipo "dropdown".

$repeatheaders: con domande a matrici (ad etichetta variabile) spesso si ha a che fare con numerose risposte che possono occupare più di una pagina per la loro visualizzazione. Questa variabile permette di decidere quante risposte devono essere mostrate prima di visualizzare nuovamente l'intestazione di quella domanda. E' consigliabile impostare questa variabile a 15. Se si decide di mostrare di non visualizzare mai una nuova intestazione impostare la variabile a 0 (è l'impostazione di default).

$maxemails: questa variabile serve a determinare quante e-mail di invito o di sollecito possono essere inviate agli utenti in un unico blocco. Differenti web server hanno differenti capacità di gestire le e-mail; può accadere che spedire molte e-mail in un unico blocco generi un errore di time out. La maggior parte dei server può inviare 100 e-mail alla volta in un tempo di default di 30 secondi. Se si presenta un errore di time out è necessario impostare questa variabile diminuendo il numero di e-mail inviate alla volta.

$defaultlang: è la lingua di default usata in amministrazione e per la presentazione dell'indagine agli utenti pubblici. E' possibile modificare la lingua di presentazione al pubblico del questionario dalla pagina di amministrazione.

$OS: serve a determinare il sistema operativo del server.

$apachedir: determina la locazione del file eseguibile “htpasswd”. Se il server è Linux/Unix e si lascia questa variabile blank ("") PHPSurveyor cercherà di determinare la locazione automaticamente. Per server in ambiente Windows probabilmente bisognerà impostare questa variabile (ad es.: $apachedir = “c:/program/files/apache group/apache/bin )

$mysqldir: questa variabile indica a PHPSurveyor la locazione dei file binari mysql (in particolare, mysqldump). Se il server è Linux/Unix e si lascia questa variabile blank ("") PHPSurveyor cercherà di determinare la locazione automaticamente. Per server Windows è necessario impostare questa variabile (ad es.: $mysqldir = “c:/mysql/bin)

$timeadjust: se il server su cui è installato PHPSurveyor si trova in una zona con fuso orario diverso dal luogo dove si trovano gli utenti pubblici dell'indagine con questa variabile si può tener conto di tale differenza. Se il server è in Italia e chi partecipa all'indagine si trova sulla costa orientale degli Stati Uniti bisognerà impostare il valore della variabile a 6 che rappresenta la differenza di fuso orario tra l'Italia e gli Stati Uniti.

$dbprefix: lasciare questa impostazione a blank (cioè: $dbprefix="";) se si usa un database tutto a disposizione per PHPSurveyor. Se si vuole far condividere un unico database tra PHPSurveyor ed altre applicazioni è necessario impostare un prefisso tramite questa variabile.

$allowmandbackwards: se si imposta questa variabile a 1 si permetterà agli utenti di spostarsi a domande precedenti anche se non hanno risposto ad una domanda obbligatoria. Se si imposta a 0 gli utenti dovranno necessariamente rispondere alle domande obbligatorie anche nel caso si volessero spostare ad una domanda precedente.

$deletenonvalues: Se si imposta a 0, se una domanda (chiamiamola "b") è mostrata sotto condizione (ad es. è condizionata alla risposta di una domanda precedente - chiamiamola "a"), se l'utente risponde alla domanda "b" ma poi si sposta alla domanda "a" cambiando la risposta data in modo tale che la domanda "b" non è più mostrata PHPSurveyor continuerà a mantenere la risposta data a "b". Se si desidera non mantenere la risposta alla domanda "b" allora bisognerà impostare questa variabile ad 1.

$shownoanswer: se è impostata al valore 1 quando si sarà in presenza di una domanda non obbligatoria con scelta tra una lista di risposte editabili verrà mostrata l'ulteriore risposta N/A che permette all'utente di non rispondere alla domanda. Impostare a "0" se non si desidera dare questa possibilità.

$usejpgraph: se sono disponibili le classi jpgraph correttamente impostate sul server si può attivare o meno (1=on, 0=off) la possibilità di avere i grafici dei risultati statistici.

$jpgraphdir: è la locazione delle classi jpgraph. Questa impostazione è richiesta solo se si è impostata $usejpgraph a 1.

$btstyle: determina il foglio di stile (CSS) per i pulsanti in amministrazione.

$slstyle: determina il foglio di stile (CSS) per il testo

6. Caricare i file sul server web
Per caricare i file sul server web lanciare il programma preferito per FTP, connettersi al webserver e creare una directory dove salvare i file di PHPSurveyor. Fare l'upload dei file in questa directory assicurandosi di aver mantenuto la struttura delle directory originale.

7. Lanciare gli script di amministrazione la prima volta
Dopo l'upload dei file si è pronti per fare il setup di PHPSurveyor mediante un qualunque browser web.
Lanciare il browser quindi scrivere l'URL del file admin.php. Se la directory in cui si sono salvati i file sul server è stata chiamata phpsurveyor allora l'indirizzo da immettere sarà del tipo "http://www.miodominio.it/phpsurveyor/admin/admin.php"
La prima volta che si usa PHPSurveyor lo script si collegherà al database che si è indicato nel file config.php. Se la struttura delle tabelle non esiste ancora, PHPSurveyor mostrerà un pulsante per creare nel database le tabelle necessarie (eventualmente fare clic su questo pulsante).
In caso di problemi sarà necessario usare un programma di amministrazione tipo PhpMyAdmin e lanciare il file SQL maketables.sql per creare le tabelle. Una volta create le tabelle l'installazione è completa.

8. In caso di problemi
Come per tutti i programmi la maggior parte delle volte le cose funzionano come descritto dalle istruzioni riportate sui manuali d'uso. Nel caso questo non accada vi possono essere molteplici cause impossibili da elencare qui tutte.
Se si presentano difficoltà scrivete sui forum di PHPSurveyor ospitati su http://sourceforge.net gli eventuali problemi incontrati ed i relativi messaggi di errore e probabilmente qualcuno potrà aiutarvi a risolverli.

FAQ INSTALLAZIONE
Cosa succede se il server ha la funzione "safe_mode" attivata? Se il server ha la funzione safe_mode attivata (che rappresenta una elevata opzione di sicurezza) non sarà possibile utilizzare alcune funzioni di PHPSurveyor. Tra queste vi sono la capacità di creare e gestire direttamente le impostazioni di sicurezza del server Apache e la possibilità di scaricare direttamente le risposte del questionario da MySQL. Va tenuto presente che nessuna di queste due funzionalità può essere considerata di prioritaria importanza; servono solo a rendere la vita un po' più semplice. Le impostazioni di sicurezza di Apache, infatti, si possono ovviamente inserire manualmente e, analogamente, si può usare un applicativo dedicato (tipo PhpMyAdmin) per scaricare da MySQL le risposte al questionario. Cosa succede se non posso creare un database tramite lo script di PHPSurveyor? Normalmente lo script crea un nuovo database e, succesivamente, la struttura delle tabelle. Se il Provider Internet non fornisce direttamente i permessi per creare un nuovo database in MySQL allora sarà necessario contattare l'amministratore del server per creare manualmente il database (e farsi dare il nome e il login) che dovrà avere i corretti permessi di accesso (leggi/scrivi/esegui). In questo caso bisognerà inserire il nome del database, oltre al nome utente e alla password, nel file config.php prima di lanciare il file admin.php. Solo a questo punto lo script potrà creare la struttura delle tabelle. Quali permessi attivare? La directory /phpsurveyor/tmp (questa è la directory dove vengono allocati tutti i filetemporanei) deve avere i permessi leggi/scrivi/esegui (chmod 777). Tutte le altre directory e tutti gli altri file possono essere impostati solo a leggi/esegui (chmod 755) a meno che non si desideri utilizzare gli strumenti previsti da PHPSurveyor per impostare la sicurezza per Apache (creazione dei file htpasswd e htaccess ) nel qual caso la directory admin deve essere impostata a leggi/scrivi/esegui (chmod 777). I file al suo interno, però, possono essere impostati solo a leggi/esegui (chmod 755).

Sicurezza

PHPSurveyor si appoggia sul sistema di sicurezza delle directory del web server Apache. Non è prevista alcuna ulteriore opzione di sicurezza. Questo livello di sicurezza è nella maggior parte dei casi adeguato però se il problema della sicurezza è prioritario allora è necessario leggere quanto riportato su questo tema sul sito di Apache.

Gli autori di PHPSurveyor non si assumono alcuna responsabilità sulla sicurezza di questo software. Da questo punto di vista si dovrà considerare PHPSurveyor insicuro.

Se non si usa Apache (ad es. si usa Microsoft IIS) sarà necessario disabilitare le impostazioni di sicurezza tramite PHPSurveyor ($accesscontrol = 0) nel file config.php e procedere manualmente tramite IIS alle impostazioni di sicurezza.

Permessi dei File in ambiente Linux
Se si utilizza un server Linux si devono impostare i seguenti permessi:

- per la directory phpsurveyor (o in qualunque altro modo sia stata chiamata) - chmod 755 (permessi leggi/esegui per tutti)

- per i file nella directory phpsurveyor (o in qualunque altro modo sia stata chiamata) - chmod 755 (permessi leggi/esegui per tutti)

- per la directory tmp - chmod 777. Questa directory, vuota quando viene creata, è usata per immagazzinare file uploadati, immagini create da jpgraph e i file temporanei dei template creati dall'editor dei template

- per la directory admin - chmod 777 (leggi/scrivi/esegui per tutti) o chmod 755 (leggi/esegui)
  Questa cartella necessita dei permessi di scrittura solo per la creazione dei file .htpasswd e .htaccess. Se si decide di impostare manualmente la sicurezza i permessi possono essere chmod 755

- per i file nella directory admin - chmod 755 (leggi/esegui per tutti)
  I file standard in questa cartella non necessitano di permessi di scrittura perchè non cambiano durante l'esecuzione degli script.

Permessi dei File in ambiente Windows
Se si usa un server Windows bisogna assicurarsi che il proprietario del processo webserver possa scrivere file nella cartella admin, mentre tutti gli altri file devono essere impostati a read-only e execute.

Ancora sulla sicurezza
Il file config.php contiene un nome utente ed una password per la cartella MySQL. Questo introduce una certa sicurezza particolarmente se si usa un login non semplice per l'accesso a MySQL.
Come minimo, in ogni caso, va usata una password per accedere alla directory admin di PHPSurveyor altrimenti chiunque conosca l'indirizzo della directory admin può cambiare i dati dell'indagine.
Un altro consiglio per diminuire, seppur di poco, i rischi è quello di creare un database separato da altre applicazioni per PHPSurveyor e definire un login specifico per MySQL.

Per rendere più sicura l'applicazione si potrebbe salvare il file config.php in una directory non-web. Per gli utilizzatori di Apache questo implica porlo in una directory al di sopra della cartella htdocs. Se si implementa questa modalità, sebbene ad oggi non ancora testata, sarà necessario cambiare in ogni file php l'istruzione `include ("config.php");`(presente all'inizio di ciascuno script) con una istruzione che contenga il percorso completo del file config.php (ad es.: `include("c:/program files/apache group/apache/phpsafe/config.php");`.

Progettazione e Struttura di una indagine

Un questionario in PHPSurveyor è costituito da tre elementi integrati tra loro

- un nome

- almeno un gruppo di domande

- almeno una domanda

Elementi opzionali di un questionario sono:

- la lista di possibili risposte alle domande

- etichette variabili

- eventuali condizioni che determinano se una domanda deve essere posta o meno

Il nome del questionario definisce lo "spazio" entro il quale vengono raccolte informazioni varie sulla stessa indagine (quali messaggi di “benvenuto”, la "descrizione" dell'indagine, informazioni sull'amministratore dell'indagine, quale formato deve avere l'indagine e così via).

Un questionario presuppone la suddivisione delle domande in gruppi per una logica organizzazione delle stesse. Ogni gruppo presenta un titolo ed una descrizione (opzionale). In ogni questionario deve necessariamente essere presente almeno un gruppo anche se non si desidera raggruppare le domande.

Le Domande rappresentano il cuore di un questionario. Esse possono essere raggruppate in gruppi come detto in precedenza. Non vi è alcuna limitazione tecnica al numero di domande che possono essere presenti in un questionario, o del numero delle stesse in un gruppo. Una domanda è caratterizzata dal suo testo e dalla sua tipologia. A ciascuna domanda può essere associato un breve "aiuto" per una migliore comprensione e le indicazioni di obbligatorietà o meno della risposta (cioè se è necessario dare una risposta per procedere nel questionario).

Tipi di Domande
Le tipologie di domande disponibili in PHPSurveyor sono le seguenti:

- Attribuzione punteggio (1-5):
  Permette l'attribuzione di un punteggio tra 1 e 5 alla domanda posta.
  Esempio: Quanto ti piace andare a scuola (1 per niente, 5 moltissimo)

- Data:
  Permette l'inserimento di una data
  Esempio: Qual è l tua data di nascita

- Genere:
  Offre ai partecipanti una opzione predefinita di genere :
  Esempio: Sei maschio o femmina?

- Lista (dropdown e radio)
  Permette la scelta di una sola delle possibili risposte/opzioni previste dalla domanda. Si può scegliere tra una presentazione delle possibili risposte/opzioni con modalità dropdown o pulsanti circolari (radio)
  Esempio: Dove dormi?
  Su un letto
  Su un divano
  Sul pavimento

- Lista con commenti
  Permette la scelta di una sola delle possibili risposte/opzioni previste dalla domanda ed include un campo per commentare l'opzione scelta.
  Esempio: Dove dormi? Spiega perchè dormi lì.
  Su un letto
  Su un divano
  Sul pavimento

  Commento:

- Scelta multipla
  Permette la scelta di nessuna, una o più delle possibili risposte/opzioni previste dalla domanda.
  Esempio: Dove ti piace dormire? Scegli nessuna, una o più risposte.
  Su un letto
  Su un divano
  Sul pavimento

- Scelta multipla con commento
  Permette la scelta di nessuna, una o più delle possibili risposte/opzioni previste dalla domanda .
  Esempio: Dove ti piace dormire? Scegli nessuna, una o più risposte. Spiega il perchè della scelta
  Su un letto
  Su un divano
  Sul pavimento

- Testo breve multiplo
  Permette di inserire più testi brevi in corrispondenza degli elementi di una lista prevista dalla domanda .
  Esempio: Quali sono i tuoi libri preferiti?
  Libro 1
  Libro 2
  Libro 3

- Inserimento numerico
  Sono domande che permettono l'inserimento di soli numeri. Accetta solo i caratteri numerici: 1 2 3 4 5 6 7 8 9 0.
  Esempio: Quanti anni hai?

- Classifica (Ordinamento)
  Permette l'ordinamento degli elementi di una lista di possibili risposte/opzioni in ordine di preferenza
  Esempio: Ordina le seguenti discipline di studio secondo le tue preferenze:
  Matematica
  Italiano
  Scienze

- Testo libero breve
  Permette una risposta breve (massimo 100 caratteri) alla domanda posta

- Testo libero lungo
  Permette una risposta lunga alla domanda posta

- Testo libero maxi
  Permette una risposta molto lunga alla domanda posta

- Sì/No
  Permette la risposta tra Sì e No alla domanda posta

- Scelta (Matrice a 5 punteggi)
  Permette l'attribuzione di un punteggio (tra 1 e 5) per la risposta scelta in una lista di possibili risposte/opzioni previste dalla domanda
  Esempio: Quanto sei d'accordo con i seguenti commenti (1=molto d'accordo, 5=pochissimo d'accordo)
  - Gli elefanti più belli sono quelli con le orecchie larghe 1 2 3 4 5
  - Le mie orecchie diventano rosse quando fa freddo 1 2 3 4 5

- Scelta (Matrice a 10 punteggi)
  Simile alla precedente ma con 10 punteggi

- Scelta (Matrice Sì, No, Non so)
  Permette una scelta tra Sì, No, Non so in una lista di possibili risposte/opzioni previste dalla domanda
  Esempio: Sei d'accordo con le seguenti proposte:
  - Tutti gli impiegati devono indossare una uniforme rosa Sì Non so No
  - La pausa caffè deve essere di soli 5 minuti Sì Non so No
  - Il mio capo dovrebbe essere licenziato Sì Non so No

- Scelta (Matrice in aumento, costante, in diminuzione)
  Simile alla precedente ma con le opzioni Aumenta/Uguale/Diminuisci

- Scelta (Matrice ad etichetta variabile)
  Permette di attribuire alle risposte/opzioni previste per una domanda una "etichetta" a scelta da una lista predefinita (vedi cap. 5).
  Esempio: Valuta le seguenti proposte:
  - Il braccio sinistro è più lungo di quello destro Assurdo Improbabile Possibile Certamente
  - Il clima della terra sta cambiando Assurdo Improbabile Possibile Certamente
  - I miei calzini non cadono mai durante il giorno Assurdo Improbabile Possibile Certamente

- Scelta (Matrice ad etichetta variabile per colonne)
  Simile alla precedente ma con la differenza che le risposte e le "etichette" sono visualizzate per colonne invece che per file. L'esempio precedente si configura in questo caso nel seguente modo:
  Esempio: Valuta le seguenti proposte:
  Assurdo Il braccio sinistro è più lungo di quello destro Il clima della terra sta cambiando I miei calzini non cadono mai durante il giorno
  Improbabile Il braccio sinistro è più lungo di quello destro Il clima della terra sta cambiando I miei calzini non cadono mai durante il giorno
  Possibile Il braccio sinistro è più lungo di quello destro Il clima della terra sta cambiando I miei calzini non cadono mai durante il giorno
  Certamente Il braccio sinistro è più lungo di quello destro Il clima della terra sta cambiando I miei calzini non cadono mai durante il giorno

- Boilerplate
  Questa, in realtà, non è una vera e propria domanda quanto piuttosto uno spazio con le caratteristiche di una domanda a cui non è associata alcuna risposta. Questo tipo di domanda va usata in relazione all'uso delle "condizioni" per proporre commenti o definizioni basati su risposte a precedenti domande.

Creare Indagini

1. Creare una nuova indagine

   Per creare una nuova indagine fare clic sul pulsante posto alla destra della barra Amministrazione.

   Più sotto si aprirà la finestra Crea Nuova Indagine.

   Riempire, se e come si desidera, i campi sottoelencati:

   1. Titolo: è il nome che individua l'indagine (ad esempio: "Questionario studenti a.s. 2004-2005", o "Indagine sulle preferenze delle discipline di studio"). Questo titolo verrà mostrato su ogni pagina dell'indagine visibile al pubblico.

   2. Descrizione: contiene una breve descrizione dell'indagine. (ad es.: "Indagine per creare un profilo degli studenti nell'a.s. 2004-2005" o "Indagine sulla popolarità delle discipline di studio nel Liceo Scientifico "Archimede Pitagorico" di Paperopoli". In questo campo può essere usato il linguaggio HTML per formattare al meglio la descrizione.

   3. Benvenuto: è il messaggio di benvenuto che l'utente pubblico troverà appena apre la pagina iniziale dell'indagine. (Ad es. "Grazie per il tempo che dedicherai alla compilazione di questo questionario ..."). In questo campo può essere usato il linguaggio HTML per formattare al meglio il messaggio di benvenuto.

   4. Amministratore: è il nome della persona di contatto che amministra l'indagine. Questo nome sarà indicato in ogni e-mail inviata agli utenti pubblici dell'indagine.

   5. e-mail Amministratore: è l'indirizzo e-mail dell'amministratore indicato nel campo precedente. Viene usato come indirizzo per i messaggi e-mail di risposta inviati dagli utenti all'amministratore.

   6. Fax: è il fax al quale gli utenti che non possono rispondere on line al questionario possono inviare una copia cartacea del questionario una volta completato.

   7. Formato: scegliere una delle seguenti opzioni "Visualizza per domanda", "Visualizza per gruppo" oppure "Visualizza tutto"

      - Visualizza per domanda (di default): il questionario sarà mostrato al pubblico con una domanda per pagina.

      - Visualizza per gruppo: il questionario sarà mostrato al pubblico con un gruppo di domande per pagina.

      - Visualizza tutto: il questionario sarà mostrato al pubblico con tutte le domande in una sola pagina. In questo caso il questionario non avrà una pagina di benvenuto o una pagina finale di 'invio. Il messaggio di benvenuto o il pulsante di invio saranno entrambi su un unica pagina.

   8. Template: permette la scelta di uno dei template disponibili. Il template di default di PHPSurveyor è piuttosto spartano ma funzionale. Maggiori informazioni su come creare un nuovo template personalizzato sono fornite nella pagina Guida dei Template di PHPSurveyor

   9. Uso dei Cookie: se si sceglie SI e l'indagine non prevede una tabella di identificativi di accesso all'indagine allora verrà creato un cookie sul computer client dell'utente pubblico che avrà completato ed inviato il questionario. Questo cookie impedirà all'utente di accedere nuovamente al questionario tramite lo stesso computer. Anche se con questo sistema vi sono limitazioni intrinseche alla "sicurezza" tuttavia è pur sempre una prima misura per bloccare più invii dello stesso questionario dallo stesso computer.

   10. Permetti il salvataggio: se si sceglie SI allora gli utenti possono salvare i questionari non completati e non ancora inviati in modo da poterli completare successivamente.

   11. Mostra il pulsante [Precedente]: se si sceglie NO non sarà possibile all'utente tornare alla pagina precedente durante la compilazione di un questionario.

   12. Notifica: sono le opzioni delle risposte previste via e-mail all'amministratore quando viene inviato un questionario da parte dell'utente:

       - Nessuna e-mail di notifica (di default)

       - e-mail di notifica standard viene inviata una e-mail all'amministratore informandolo che è stato inviato un questionario completato

       - e-mail di notifica con risposte invia una e-mail con tutte le risposte fornite al questionario

   13. Anonimo: permette di collegare le risposte fornite dagli utenti all'identificativo dell'utente. Se si imposta su NO, e qualora si abbia a disposizione una lista di identificativi, si potrà risalire a chi ha risposto in quel modo al contrario se si imposta su SI non sarà possibile l'associazione.

   14. Oggetto della e-mail di invito: è l'oggetto della e-mail di invito che verrà inviata agli utenti abilitati a partecipare al questionario (Vale quando si è risposto NO al campo precedente e si dispone di una elenco di e-mail).

   15. Testo della e-mail di invito: è il testo della e-mail di invito che verrà inviata agli utenti abilitati a partecipare al questionario. Di default contiene un testo scritto in precedenza ma che può essere cambiato per adattarlo alle esigenze del questionario. (Vale quando si è risposto NO al campo 13 e si dispone di un elenco di e-mail).
       Il testo del messaggio può essere personalizzato utilizzando i seguenti "form":

       - {FIRSTNAME} verrà sostituito in ciascuna e-mail con il nome dell'utente contenuto nella tabella degli identificativi

       - {LASTNAME} verrà sostituito in ciascuna e-mail con il cognome dell'utente contenuto nella tabella degli identificativi

       - {SURVEYNAME} verrà sostituito in ciascuna e-mail con il titolo dell'indagine

       - {SURVEYDESCRIPTION} verrà sostituito in ciascuna e-mail con la descrizione dell'indagine

       - {ATTRIBUTE_1} verrà sostituito in ciascuna e-mail con il contenuto dell'attributo_1 riportato nella tabella degli identificativi

       - {ATTRIBUTE_2} verrà sostituito in ciascuna e-mail con il contenuto dell'attributo_1 riportato nella tabella degli identificativi

       - {SURVEYURL} verrà sostituito in ciascuna e-mail con l'URL dell'indagine in questione

   16. Oggetto della e-mail di sollecito: è l'oggetto della e-mail di sollecito che verrà inviata agli utenti abilitati a partecipare al questionario e che alla data non lo abbiano ancora inviato. (Vale quando si è risposto NO al campo 13 e si dispone di una elenco di e-mail).

   17. Testo della e-mail di sollecito: è il testo della e-mail di sollecito che verrà inviata agli utenti abilitati a partecipare al questionario e che alla data non lo abbiano ancora inviato. Di default contiene un testo scritto in precedenza ma che può essere cambiato per adattarlo alle esigenze dell'indagine corrente. (Vale quando si è risposto NO al campo 13 e si dispone di una elenco di e-mail).

   18. Oggetto della e-mail di conferma completamento indagine: è l'oggetto della e-mail di completamento del questionario che verrà inviata agli utenti abilitati a partecipare al questionario nel momento in cui l'inviano. (Vale quando si è risposto NO al campo 13 e si dispone di una elenco di e-mail).

   19. Testo della e-mail di conferma completamento indagine: è il testo della e-mail di completamento del questionario che verrà inviata agli utenti abilitati a partecipare al questionario nel momento in cui l'inviano. (Vale quando si è risposto NO al campo 13 e si dispone di una elenco di e-mail).

   20. Permetti una registrazione pubblica?: se si prevede l'uso di identificativi per l'accesso al questionario solo gli utenti in possesso di tali identificativi possono parteciparvi. E' possibile permettere ad un visitatore anonimo della pagina iniziale del questionario una sua registrazione. Basta impostare a SI questo campo. L'utente dovrà fornire il proprio nome, cognome ed un indirizzo e-mail. PHPSurveyor creerà un nuovo record nella tabella degli identificativi per questo utente al quale sarà inviata una e-mail di invito con una password di accesso. Solo una persona con quell'indirizzo e-mail potrà partecipare all'indagine in questione.

   21. Oggetto della e-mail di risposta alla registrazione pubblica: è l'oggetto della e-mail di invito che viene spedita a coloro i quali si sono registrati ad una indagine.

   22. Testo della e-mail di risposta alla registrazione pubblica: è il testo della e-mail da inviare a coloro i quali si sono registrati ad una indagine.

   23. Nomi dei campi degli attributi degli identificativi: la tabella degli identificativi presenta due campi liberi per immettere eventuali ulteriori informazioni sugli utenti. Quando sono usati nella registrazione pubblica si possono attribuire a questi campi dei nomi. Ad esempio se ci interessa conoscere dell'utente che si sta registrando la scuola dove insegna si può etichettare con il nome Scuola questo campo.

   24. Data invio indagine: permette di impostare se deve essere indicata la data di invio del questionario completato. Se si sceglie "SI", quando verrà inviato un questionario completato verrà anche associata la data in cui questo è avvenuto. (Vedi configurazione della variabile $timeadjust)

   25. Lingua: è l'elenco di lingue tra le quali scegliere quella da utilizzare nell'indagine come lingua di default nella presentazione del questionario agli utenti (questa scelta non fa cambiare la lingua di amministrazione).

   26. Data invio questionario completato: è la data entro la quale è possibile per gli utenti partecipare all'indagine.

   27. Rinvia all'URL: è l'indirizzo web che verrà mostrato all'utente alla fine dell'indagine per farlo navigare ad una pagina che si desidera (ad esempio l'Home Page del vostro sito).

   28. Testo dell'URL: è il testo del link che rimanda ad un indirizzo web prescelto (ad es. l'Home Page di un sito).

   29. Carica automaticamente l'URL quando l'indagine è completa?: Se si sceglie SI dopo l'invio del questionario l'utente verrà rimandato direttamente all'URL definita nei campi precedenti. Attenzione: non scegliere questa opzione quando si prevedono delle valutazioni contestuali.

   Per creare la nuova indagine fare sul pulsante Crea nuova indagine

   Importare una indagine
   Se in precedenza si è esportata una indagine è possibile importarla nuovamente dalla finestra Crea nuova indagine.

   Fare clic sul pulsante Sfoglia per scegliere il relativo file SQL che verrà mostrato nel campo Seleziona File SQL, quindi fare clic sul pulsante Importa indagine.

   Il processo di importazione rinumera l'indagine, i gruppi, le domande, le risposte e le condizioni in modo che tutto funzioni correttamente. Vedi il capitolo Esportazione di una indagine per maggiori informazioni.

   (B) Creare un NUOVO GRUPPO

   Prima di aggiungere le domande è necessario creare un gruppo. Se si prevede un unico gruppo nell'indagine allora il suo nome è irrilevante; al contrario se si prevedono più gruppi le domande saranno mostrate nei loro gruppi di appartenenza mentre i gruppi saranno mostrati in ordine alfabetico. Se si desidera che i gruppi siano mostrati in un particolare ordine sarà necessario che i loro nomi incomincino con una lettera dell'alfabeto (o con un numero) ad esempio "A) domande sulla tua scuola" e "B) domande sulla tua salute" ecc.. In questo caso il primo gruppo sarà rappresentato prima del secondo per la presenza della lettera dell'alfabeto prima della frase. Se viceversa si fosse scritto "Domande sulla tua scuola" e "Domande sulla tua salute" il secondo gruppo sarebbe stato rappresentato per primo perchè il termine salute viene alfabeticamente prima di scuola. E' sempre consigliabile utilizzare questo tipo di indicizzazione in modo di poter aggiungere altri gruppi in momenti successivi fornendo un nome opportuno (ad esempio "A1) Domande sul tuo futuro").
   Si possono creare quanti gruppi si desidera.

   Ai gruppi si può associare una descrizione per spiegare agli utenti il significato del raggruppamento delle domande.

   Per creare un nuovo gruppo è necessario fare clic sull'icona sulla barra dei pulsanti Indagine quindi aggiungere il Titolo (obbligatorio) del gruppo ed eventualmente una descrizione ed infine fare clic sul pulsante Aggiungi gruppo

   Anche per i gruppi è possibile importarne uno precedentemente salvato.

   Fare clic sul pulsante Sfoglia per scegliere il relativo file SQL che verrà mostrato nel campo Seleziona File SQL, quindi fare clic sul pulsante Importa gruppo.

   (C) Aggiungere una DOMANDA

   Una volta creati i gruppi si possono aggiungere le domande in ciascun gruppo.
   Per creare una nuova domanda è necessario fare clic sull'icona sulla barra dei pulsanti Gruppo.
   Quando si aggiunge una domanda, è necessario fornire un codice per quella domanda, il testo della domanda, una nota di spiegazione ed il tipo della domanda oltre ad altre indicazioni spiegate in seguito. Tutte le domande create a partire da questo gruppo verranno assegnate al gruppo corrente anche se è sempre possibile cambiare successivamente tale assegnazione.

   Di seguito sono elencati i campi presenti nella finestra Aggiungi domanda

   1. Codice della domanda: è il codice alfanumerico della domanda. Questa assegnazione (obbligatoria) è molto importante perchè determina la posizione della domanda nell'indagine. E' necessario definire questo codice opportunamente (ad esempio q1, q2 ecc. ) affinchè le domande vengano mostrate nel corretto ordine. Anche in questo caso è possibile inserire successivamente domande avendo l'accortezza di utilizzare un codice opportuno (ad esempio q1a se si vuole che la domanda venga mostrata dopo q1 e prima di q2.

   2. Domanda: è il testo della domanda. Non vi è alcun limite alla lunghezza del testo delle domande. Se si vuole spiegare la domanda è però meglio farlo nel campo Nota di spiegazione.

      "Form" che si possono aggiungere nel testo delle domande
      Informazioni sugli identificativi
      E' possibile inserire testo/informazioni dalla tabella degli identificativi nella domanda in modo da contestualizzarla rispetto all'utente. Per utilizzare questa possibiltà è necessario impostare a NO il campo Anonimo ed avere a disposizione una tabella di identificativi.
      I campi disponibili per questa caratteristica sono:

      - {TOKEN:FIRSTNAME} - inserisce il valore corrispondente dal campo "nome" nella tabella degli identificativi

      - {TOKEN:LASTNAME} - inserisce il valore corrispondente dal campo "cognome" nella tabella degli identificativi

      - {TOKEN:EMAIL} - inserisce il valore corrispondente dal campo "e-mail" nella tabella degli identificativi

      - {TOKEN:ATTRIBUTE_1} - inserisce il valore corrispondente dal campo "attributo_1" nella tabella degli identificativi

      - {TOKEN:ATTRIBUTE_2} - inserisce il valore corrispondente dal campo "attributo_2" nella tabella degli identificativi

      Per sfruttare questa possibilità è necessario inserire nel testo della domanda questi "form" esattamente come descritto in qui sotto. Per esempio:
      Ciao {TOKENS:FIRSTNAME}. Ti abbiamo inviato una e-mail al seguente indirizzo {TOKENS:EMAIL}. L'hai ricevuta?
      Risposte precedenti
      Esiste la possibilità di inserire la risposta ad una precedente domanda nel testo delle risposte ad una domanda successiva se:

      - la domanda a cui è stata data la risposta si trova in una pagina precedente del questionario a quella in cui si trova la domanda a cui si vuole attribuire quella risposta

      - è inserito l'esatto ID dell'indagine, del gruppo e della domanda a cui si era data quella risposta - nel formato: {INSERTANS:SIDXGIDXQID} - ad esempio {INSERTANS:1X2X3}.
        Per conoscere gli esatti ID basta visualizzare le domande le cui risposte si vogliono utilizzare e vedere cosa c'è scritto nella barra indirizzi del browser ad es. se l'indirizzo è http://foobar.com/phpsurveyor/admin/admin.php?sid=1&gid=12&qid=8 allora bisognerà scrivere {INSERTANS:1X12X8} nella domanda dove si vogliono inserire le risposte già date.

      Attenzione: usare con cautela questa caratteristica in quanto è attualmenteancora in fase di sperimentazione.

   3. Nota di spiegazione: è un campo opzionale. E' utile se la domanda necessita di qualche spiegazione. Se si scrive qualcosa in questo campo verrà visualizzata una icona Punto Interrogativo sulla schermata delle domande con a fianco il testo esplicativo scritto.

   4. Tipologia: determina il tipo di risposta per quella domanda. Vedi il capitolo Tipi di domanda per una descrizione delle varie tipologie disponibili.

   5. Convalida: Questa caratteristica è disponibile per le domande a testo libero ("Testo libero breve", "Testo libero lungo", "Data" o "Numerico"). E' necessario usare espressioni Perl Regex standard per convalidare le risposte alla domanda; all'utente verrà richiesto di provare nuovamente prima di procedere.
      Le espressioni Perl Regex devono incominciare e finire con la barra ("/"). Una buona libreria di espressioni regex è disponibile all'indirizzo http://www.regxlib.net/.
      Esempi (Attenzione: più espressioni vanno messe su uno stesso rigo):

      - Email Validation:
        /(\w[-._\w]*\w@\w[-._\w]*\w\.\w{2,3})/
      - Australian Postcodes:
        /^[0-9]{4}/

   6. Altro è un campo presente solo per alcuni tipi di domande. Permette di aggiungere, impostando a SI, una risposta con testo libero nelle domande che presentano un elenco di possibili risposte.

   7. Obbligatorio: permette di indicare, impostando a SI, l'obbligatorietà di risposta a quella domanda. Se non si risponde a quella domanda non è possibile procedere nella compilazione del questionario.

   8. Attributi delle domande

      Gli attributi delle domande rappresentano un modo di aggiungere ulteriori controlli alla loro presentazione e/o alla loro gestione. Attualmente sono disponibili alcuni controlli ma se ne possono aggiungere facilmente altri avendo nozioni di programmazione in PHP.
      Differenti tipi di domanda presentano differenti possibili attributi. Ciascun attributo può avere un "valore" che indica (generalmente "1") se l'attributo è applicato o meno oppure può indicare un particolare valore usato da quell'attributo.

      - display_columns:
        Questo attributo è utilizzato per domande con liste a pulsanti circolari (radio button) o domande a scelta multipla. Permette di visualizzare le risposte in più di una colonna. Se si aggiunge questo attributo indicare il numero di colonne sulle quali distribuire le risposte.

      - hide_tip
        Questo attributo permette di nascondere i suggerimenti previsti per alcuni tipi di domande. Per esempio le domande a scelta multipla prevedono un suggerimento del tipo "Scegli una o più delle seguenti voci". Se si aggiunge l'attributo "hide_tip" con un qualunque valore il suggerimento non verrà fornito.

      - random_order
        Questo attributo è valido per qualsiasi tipo di domanda che prevede un elenco di possibili risposte. Se questo attributo è attivato PHPSurveyor ignorerà l'ordine delle risposte inserito e ne genererà uno casuale. E' importante notare che questo ordine casuale verrà generato ogni volta in modo diverso.

      - code_filter
        Questo attributo è utilizzato per mostrare le risposte di una domanda in funzione delle risposte ad una domanda precedente.

      - permission
        correntemente è un attributo non utilizzato

      - maximum_chars
        E' un attributo disponibile per le domande basate su testo libero. Permette di definire il numero massimo di caratteri che possono essere inseriti nella risposta.

      - text_input_width
        E' un attributo disponibile per domande a testo breve e domande di tipo numerico. Definisce la grandezza del box html visualizzato nella pagina ma non il numero dei caratteri che si possono inserire.

   Una volta inseriti tutte le indicazioni sopra riportate fare clic sul pulsante Aggiungi domanda.
   Si possono creare quante domande si desiderano.
   Quando si crea una domanda che prevede risposte predeterminate bisogna, ovviamente, anche inserire le risposte a quella domanda.

   Anche per le domande è possibile importarne una precedentemente salvata.

   Fare clic sul pulsante Sfoglia per scegliere il relativo file SQL che verrà mostrato nel campo Seleziona File SQL, quindi fare clic sul pulsante Importa domanda.

   (D) Impostare le Condizioni (Branching)

   E' possibile mostrare all'utente una domanda SOLO SE sono soddisfatte certe condizioni. Si possono impostare queste condizioni facendo clic sull'icona Imposta condizioni nella barra Domanda che viene mostrato quando una domanda è stata creata.

   Quando si fa clic sul pulsante Imposta condizioni comparirà una la finestra Definizione delle condizioni per creare o cancellare condizioni per la domanda corrente.

   Un esempio è mostrato di seguito.

PHP Surveyor

Definizione delle Condizioni

Mostra questa domanda con codice b06 solo SE
a05: Tipologia dell'Istituto scolas.. (qid30) | Uguaglia |
Istituto Comprensivo (a043) |
Copia condizioni
Condizione |  | Domanda
--- | --- | ---
| copia |
Aggiungi condizione
Domanda |  | Risposta
| Uguaglia |

> Condizioni esistenti
> La parte superiore della finestra mostra le condizioni già impostate per questa domanda (in questo esempio con codice b06), mentre la parte inferiore permette di creare nuove condizioni.

> Nell'esempio mostrato la domanda con codice b06 ("Il portfolio è:") viene mostrata solo se la risposta alla domanda con codice a05 ("Tipologia dell'Istituto scolastico:") è "F" (Istituto comprensivo). Si può cancellare questa condizione facendo clic sul pulsante "Cancella".

> Nuove condizioni
> Per creare nuove condizioni fare clic sulla domanda (colonna a sinistra nella sezione Aggiungi condizione) che si desidera usare per impostare una nuova condizione. Quando si sceglie una domanda, nel campo Risposta posto sulla parte destra verranno mostrate (in questa finestra non sono visualizzate) le possibili risposte a quella domanda.

> Scegliere la risposta che si vuole utilizzare quindi fare clic sul pulsante "Aggiungi condizione". Si possono scegliere più riposte tenendo premuto il tasto CTRL e facendo clic su più risposte presenti nella lista.

> Condizioni multiple
> Si possono impostare più condizioni per una domanda. Le condizioni possono essere basate su più domande precedenti. E' possibile, ad esempio, mostrare una certa domanda se la risposta alla domanda 1 (precedente) è SI e alla domanda 2 (anch'essa precedente) è NO oppure se la risposta alla domanda 1 è SI o "Nessuna risposta" e la risposta alla domanda 2 è NO /cioè si possono impostare condizioni multiple anche se non si è risposto a domande precedenti.

> Copiare Condizioni a domande successive
> E' possibile impostare una medesima condizione ad un intero gruppo di domande impostando una condizione per una domanda e copiare la stessa condizione per un'altra domanda. Una volta che una condizione è stata impostata comparirà la seguente schermata:

Copia Condizioni
Condizione |  | Domanda
--- | --- | ---
| copia a |

> Nel campo di sinistra sono mostrate le condizioni già impostate per la domanda, mentre il campo a destra mostra tutte le domande successive presenti nel questionario. Selezionare nel campo a sinistra tutte le condizioni che si desiderano copiare (usare CTRL per selezionare più opzioni) quindi fare clic sul pulsante "Copia condizioni" per copiare/incollare le condizioni. E' consigliabile fare questa operazione solo dopo aver terminato di creare tutte le domande dell'indagine.

> Suggerimenti

> Ci sono alcune semplici regole da tener presenti quando si impongono condizioni ad una domanda.

> 1. > Una volta che una condizione è stata impostata per una domanda essa NON VERRA' MOSTRATA finchè non sarà verificata quella condizione.

> 2. > Le condizioni possono essere basate solo su domande che vengono mostrate PRIMA della domanda su cui la condizione è impostata.

> 3. > Condizioni multiple basate su una sola domanda precedente sono valutate tramite l'operatore booleano "OR". Condizioni multiple basate su più domande precedenti sono valutate tramite l'operatore booleano "AND". Questo è importante perchè significa che non si può, ad esempio, impostare la condizione che una domanda sarà mostrata se la risposta alla domanda "A" è SI o (OR) la risposta alla precedente domanda "B" è NO.

> 4. > Si possono modificare condizioni anche dopo che una indagine è stata attivata; questo deve, però, essere fatto con cautela controllando i risultati.

> (E) Aggiungere RISPOSTE

> Diversi tipi di domande richiedono la presenza di un elenco di risposte tra cui l'utente è invitato a scegliere.

> Per aggiungere risposte ad una di questi tipi di domande fare clic sul pulsante nella barra Domanda.

> Quando si aggiunge una risposta verrà richiesta l'attribuzione di un "Codice" a quella risposta e se quella risposta è di default

- > Codice risposte: è il dato di riferimento della risposta che verrà esportato sul foglio di calcolo quando si esportano i risultati in un foglio di calcolo. Si può scegliere qualunque codice costituito da non più di cinque caratteri alfanumerici.

- > Risposta: è la risposta che verrà mostrata

- > Ordine di presentazione: questo è un campo nascosto Si possono usare i pulsanti SU e GIU' per cambiare la posizione delle risposte.

- > Default: una qualunque risposta tra quelle fornite può essere scelta come risposta di default (cioè quella che viene salvata direttamente se non si fa alcuna scelta. Cambiare il campo di Default a SI se si desidera che quella risposta diventi quella di default.

> (F) Esportare una indagine

> Una volta terminata la impostazione di una indagine, che può contenere anche centinaia di domande con decine di condizioni e la cui costruzione ha comportato una notevole fatica, è buona norma fare un backup dello stesso.

> Il pulsante nella barra dei pulsanti dell'indagine esporterà tutti i gruppi, le domande, le risposte e le condizioni costituenti l'indagine in un file SQL standard. Questo file può essere a sua volta reimportato in PHPSurveyor (vedi il paragrafo 'Importa Indagine').

> Nota: Benchè il file creato è un file SQL standard non è consigliabile reimportarlo direttamente (ad es. con PhpMyAdmin) su un database di PHPSurveyor già esistente in quanto alcuni puntatori interni nell'indagine devono essere resettati.

Verificare una indagine

E' possibile testare un questionario in qualunque momento durante le fasi di creazione facendo clic sul pulsante "Prova indagine" sulla barra Indagine della pagina amministrazione o sul pulsante "Data entry" della stessa barra. Questo permette di vedere come si presenterà il questionario agli utenti prima di attivarlo: Quando si testa un questionario le risposte non verranno salvate.

Valutazione (punteggi)

Con la funzione "Valutazione" è possibile attribuire dei punteggi alle risposte fornite in modo da fornire in tempo reale una prima valutazione complessiva delle risposte fornite sin dal momento in cui vengono inviate.

Il seguente esempio spiega meglio quanto detto.

Supponiamo di avere costruito una indagine per stabilire lo stato di salute dei partecipanti all'indagine con le seguenti due domande e relative risposte a ciascuna delle quali è associato un valore numerico.

Donanda n. 1. "Fumi?"
con queste tre possibili risposte:
a. "Sì, più di 10 sigarette al giorno" a cui si è associato il valore 10
b. "Sì, meno di 10 sigarette al giorno" a cui si è associato il valore 5
c. "No", a cui si è associato il valore 0

Domanda n. 2. "Fai esercizio fisico?"
con queste tre possibili risposte:
a. "Sì, almeno mezz'ora al giorno per tre giorni alla settimana" a cui si è associato il valore 0
b. "Sì, ogni tanto" a cui si è associato il valore 5
c. "No, mai", a cui si è associato il valore 10

Se un partecipante all'indagine risponde che fuma più di 10 sigarette al giorno e che non svolge alcuna attività fisica otterrà un punteggio pari a 20 (10 + 10), se, al contrario, risponde che non fuma e che svolge attività fisica regolarmente otterrà un punteggio pari a 0 (0 + 0). Con questa semplice regola di associazione di un numero alla risposta e di addizione degli stessi si può definire direttamente (e molto semplicemente) lo stato di salute del partecipante all'indagine.

Queste regole di addizione su numeri attribuiti alle risposte si possono associare a tutte le domande dell'indagine o a gruppi di domande.

Se dopo aver risposto alle domande dell'indagine si apre la sezione "Valutazioni" compare la seguente tabella:

Se crei una valutazione per l'indagine corrente questa sarà aggiornata alla fine dell'indagine dopo il suo invio
ID | SID | Campo applicazione | Gruppo | Minimo | Massimo | Intestazione | Messaggio | URL | Actions
--- | --- | --- | --- | --- | --- | --- | --- | --- | ---
11 | 35 | T | 94 | 20 | 20 | La tua salute è a rischio. | La tua salute è a rischio. Dovresti smettere di fumare e fare più attività fisica | http://www.salute.com/ |
Aggiungi/Modifica
Campo applicazione |
Gruppo |
Minimo |
Massimo |
Intestazione |
Messaggio |
URL |

Nel box Aggiungi/Modifica si possono impostare i seguenti parametri:

> Campo di applicazione: è il campo di applicazione delle regole di valutazione. "Total" indica che ci si riferisce a tutte le domande dell'indagine, mentre "Gruppo" indica che si riferisce ad un gruppo di domande (indicato nella colonna a fianco)
> Gruppo: definisce a quale gruppo di domande si associa la valutazione se si è specificato che il campo di applicazione della valutazione si riferisce ad un gruppo.
> Minimo: la somma minima di risposte a cui si applica la valutazioneis assessment will apply
> Maximum: la somma massima di risposte a cui si applica la valutazioneis assessment will apply
> Heading: l'intestazione della valutazione che verrà visualizzata
> Message: il messaggio associato alla valutazione (può includere codice html)
> URL: un URL che verrà mostrata con la valutazione

Si possono creare quante valutazioni si desiderano e si possono creare più valutazioni per un determinato punteggio.

E' importante assicurarsi che si hanno delle valutazioni non bisogna aver attivato l'indirizzamento automatico verso una URL quando si è completato il questionario.

Template

E' possibile personalizzare la modalità di presentazione al pubblico di un questionario creato in PHPSurveyor tramite la modifica (o la creazione) dei template forniti.

Questo capitolo fornisce una breve spiegazione dei template di PHPSurveyor mentre maggiori informazioni sono riportate nella Guida_Template PHPSurveyor.

L'Editor di Template
L'editor dei template di PHPSurveyor permette all'amministratore di modificare i contenuti on line dei template.

Fare clic sul pulsante "Editor dei template" nella barra di amministrazione di PHPSurveyor.

La finestra principale è simile alla finestra di amministrazione in cui sono visibili diverse barre. Sulla parte destra della barra posta più in alto compare un campo a discesa in cui sono riportati tutti i template disponibili.

La barra Template

Template: default
| Finestra:

L'icona del "semaforo" sulla sinistra indica se il template scelto è modificabile o meno. La luce rossa indica che è di sola lettura mentre la luce verde indica che può essere modificato.
Il pulsante Rinomina questo template permette di cambiare il nome al template mentre l'icona Fai una copia di questo template permette di creare un nuovo template copiando quello corrente.
Il menù a discesa Schermata sulla parte destra della barra permette di scegliere la pagina del template che si desidera visualizzare.

Sezione Controllo File

Controllo file:
| File Standard : | Modifica ora: |
Altri file:

Nel campo Standard File sulla parte sinistra della sezione è possibile scegliere uno dei file utilizzato per creare il template. Il codice html contenuto in quel file sarà mostrato nel campo Modifica ora al centro della finestra.
Se il template è modificabile (in dipendenza dei permessi impostati per la directory che li contiene) è possibile effettuare dei cambi e salvarli.

Nel campo Altri file è mostrato un elenco di tutti gli altri file (immagini ecc.) usati dal template. Si può usare questo campo per fare l'upload di tutti quei file necessari a creare il proprio template. Notare che quando si userà uno di questi file per la creazione del template invece di usare ad esempio la notazione <img src='/phpsurveyor/templates/yourtemplate/mypicture.jpg'> bisognerà usare la seguente <img src='{TEMPLATEURL}mypicture.jpg'>.

Un "anteprima" del template che si sta creando sarà visibile nella parte inferiore della schermata.

Non è possibile eliminare un template tramite l'editor ma solo cancellando via FTP la directoy che lo contiene.

Il template di "default" non può essere modificato con l'editor di template, è possibile farlo solo manualmente.

Sostituzioni / Stringhe di campo

Le seguenti stringhe saranno sostituite da PHPSurveyor quando effettuerà il parsing del file del template è lo presenterà all'utente. Queste stringhe di campo sono disponibili per tutte le pagine del template ad eccezione della Pagina completata.

Campo | Sostituito con:
{SURVEYNAME} | il titolo dell'indagine
{SURVEYDESCRIPTION} | la descrizione dell'indagine
{WELCOME} | il messaggio di benvenuto
{PERCENTCOMPLETE} | la percentuale di completamento del questionario
{GROUPNAME} | il nome del gruppo corrente
{GROUPDESCRIPTION} | la descrizione del gruppo corrente
{QUESTION} | il teesto della domanda
{QUESTION_CODE} | il codice della domanda
{ANSWER} | la/le risposta/e alla domanda corrente
{THEREAREXQUESTIONS} | con la frase "Ci sono X domande in questo questionario" - dove X è il numero totale delle domande nel questionario
{NUMBEROFQUESTIONS} | il numero totale delle domande nel questionario
{TOKEN} | l'ID dell'identificativo corrente
{SID} | l'ID dell'indagine corrente
{QUESTIONHELP} | il testo di aiuto per la domanda corrente (compare in un campo pop-up javascript)
{QUESTIONHELPPLAINTEXT} | il testo di aiuto alla domanda corrente
{NAVIGATOR} | i pulsanti "succesivo >>" e "<< precedente"
{SUBMITBUTTON} | il pulsante "invia"
{COMPLETED} | "Il questionario e completato e salvato"
{URL} | l' URL titolo per l'indagine corrente
{PRIVACY} | il contentuto del template privacy.pstpl
{PRIVACYMESSAGE} | il messaggio di privacy così come impostato nel file della lingua locale
{CLEARALL} | l'URL "Esci ed azzera risposte"
{TEMPLATEURL} | l'URL della locazione del template corrente (utile per referenziare le immagini eventualmente presenti nel template)
{SUBMITCOMPLETE} | la frase (dal file della lingua locale) che indica all'utente che ha completato il questionario e che può fare clic sul pulsante "invia"
{SUBMITREVIEW} | la frase (dal file della lingua locale) che indica all'utente che può rivedere/cambiare le risposte che ha inserito facendo clic sul pulsante "<< precedente"
{TOKEN:FIRSTNAME} | il nome dell'utilizzatore prelevato dalla tabella degli identificativi se il questionario è NON ANONIMO
{TOKEN:LASTNAME} | il cognome dell'utilizzatore prelevato dalla tabella degli identificativi se il questionario è NON ANONIMO
{TOKEN:EMAIL} | l'indirizzo e-mail dell'utilizzatore prelevato dalla tabella degli identificativi se il questionario è NON ANONIMO
{TOKEN:ATTRIBUTE_1} | l'attributo_1 dell'utilizzatore prelevato dalla tabella degli identificativi se il questionario è NON ANONIMO
{TOKEN:ATTRIBUTE_2} | l'attributo_2 dell'utilizzatore prelevato dalla tabella degli identificativi se il questionario è NON ANONIMO
{ANSWERSCLEARED} | la frase "risposte azzerate" (dal file della lingua locale)
{RESTART} | l'URL per far ripartire l'indagine
{CLOSEWINDOW} | l'URL per chiudere la finestra corrente
{REGISTERERROR} | gli eventuali messaggi di errore (ad es. : "Devi inserire un indirizzo e-mail")
{REGISTERMESSAGE1} | la frase "Devi essere registrato per partecipare all'indagine" (dal file della lingua locale)
{REGISTERMESSAGE2} | i dettagli di registrazione (dal file della lingua locale)
{REGISTERFORM} | il formato del box di registrazione in relazione ai campi atttributo_1 e attribute_2

Localizzazione

Le schermate di presentazione all'utente remoto dell'indagine possono essere presentate nella lingua desiderata. Ad esempio "yes" and "no" nella versione italiana appaiono come "SI" e "NO". Il pacchetto PHPSurveyor viene fornito in un buon numero di lingue, però possono esserne create di nuove facendo una copia dei file esistenti nella directory /phpsurveyor/lang e modificando tale file tramite un editor che permetta il salvataggio con codifica del testo UTF-8 senza firma.

Attivare una indagine

Una volta soddisfatti della struttura dell'indagine è necessario procedere alla sua attivazione.

Attivare una indagine implica un certo numero di cose.

1. viene creata una tabella MySQL in cui verranno salvate tutte le risposte fornite al questionario e tutte quelle previste ma non selezionate dall'utente.

2. si permette l'accesso dell'amministratore ai dati presenti nella tabella delle risposte

3. si permette l'accesso dell'amministratore alla tabella degli identificativi.

4. viene creata una tabella degli identificativi se l'indagine non è anonima

Prima di attivare una indagine tenere presente i seguenti punti:

- Una volta che l'indagine è attivata si possono cambiare i testi delle domande, delle risposte e del questionario ma non il tipo di domanda o il tipo delle risposte.

- Non si possono aggiungere o eliminare domande nè aggiungere risposte alle domande con matrici o a quelle a scelta multipla mentre si possono aggiungere risposte alle domande tipo liste.

Per attivare una indagine fare clic sul pulsante nella barra dei pulsanti dell'indagine.

Se questa icona non è mostrata allora l'indagine non è ancora attivabile. Facendo clic su questa icona, PHPSurveyor lancerà un breve controllo di consistenza per verificare che il questionario lavorerà correttamente.

Svolgere una indagine in sicurezza

Una volta lanciata l'indagine e incominciato ad arrivare le risposte è opportuno effettuare le seguenti operazioni:

- Esportare immediatamente la struttura del questionario e salvare il relativo file SQL.

- Aprire con regolarità la schermata "Sfoglia" per effettuare un backup dei risultati del questionario.

- Esportare con regolarità le risposte e conservare una copia del relativo file.

- Non fare cambi al questionario. Sebbene vi siano parti del questionario che possono ancora essere cambiate dopo la sua attivazione è consigliabile non farlo. Testare in modo completo il questionario prima della attivazione e successivamente non cambiare alcunchè.

- E' possibile fare il backup dell'intero database di PHPSurveyor (con tutti i questionari, domande, risposte, identificativi ecc.) facendo clic sul pulsante Backup dell'intero database della barra Amministrazione. Si otterrà un file SQL che può essere utilizzato per essere successivamente importato in un database MySQL vuoto creando, così, tutte le tabelle richieste ed i relativi dati e ripristinando l'intero database di PHPSurveyor.

- Se si ha disposizione PhpMyAdmin o un programma similare è consigliabile fare con regolarità un backup dell'intero database (tabelle e dati) anche con questi software.

Sfogliare le risposte al questionario

Una volta che l'indagine è stata attivata e le risposte sono sta inviate è possibile vedere le risposte date e, eventualmente, modificarle o cancellarle, esportarle, avere informazioni sulle risposte già pervenute e così via. Tuto ciò può essere fatto tramite il pulsante Sfoglia risposte della barra Indagine visualizzato quando l'indagine è ativa.

Facendo clic sul pulsante Sfoglia risposte si aprirà la schermata Sfoglia risposte con la barra Sfoglia risposte. Un esempio è mostrato qui sotto.

Sfoglia Risposte: CPSU EB2003 Survey

2319 risposte in questo database

La finestra principale fornisce il nunero delle risposte (utenti che hanno risposto) al momento pervenute.

Altre opzioni sono descritte qui di seguito:

- Amministrazione generale: fa ritornare alla finestra principale delle indagini

- Riepilogo: che permette di visualizzare il numero degli utenti che hanno inviato le risposte al questionario (visibile di default)

- Mostra risposte: mostra tutti i risultati del questionario (nota: viene mostrato il testo esteso di tutte le domande mentre le risposte vengono indicate nella forma abbreviata) (vedi modificare ed eliminare risposte).

- Ultime 50 risposte: mostra le risposte degli ultimi 50 utenti al questionario, ordinate dalla più recente alla meno recente.
  Quando si sfogliano le risposte la prima cella di ciascuna fila contiene il numero "ID" dotato di collegamento ipertestuale. Facendo clic su di esso verrà mostrata singolarmente quella risposta completa. Da qui è possibile modificare o cancellare la risposta vedi (modificare e cancellare risposte).

- Data entry: da qui è possibile aprire la finestra di immissione dati per simulare l'immissione delle risposte di un utente (questa opzione è disponibile anche dalla finestra di amministrazione)

- Stampa indagine: fornisce una versione a stampa del questionario per una sua compilazione manuale.

- Statistiche: da qui è possibile fare semplici elaborazioni statistiche sulle risposte fornite dagli utenti. (vedi la sezione Statistiche)

- Esporta risultati: esporta tutte le risposte fornite dagli utenti in diversi formati (Word, Excel o CSV) . (Vedi Esportare risultati)

- Backup dei risultati in file SQL: esporta la struttura della tabelle e i relativi contenuti in un file stantard .sql di MySQL

Modificare e Eliminare Risposte

Quando si fa clic sul pulsante Mostra risposte o sul pulsante Ultime 50 risposte comparirà la barra Visualizzazione dati mostrata qui sotto:

Visualizzazione dati:
| Record visualizzati: Inizio da:

e la pagina con tutte le risposte fornite dagli utenti (un esempio di sommario di questionari (con le risposte inviate solo da due utenti) è mostrato qui sotto). .

id | Qual è il tuo Tipo di impiego ? | Quante i sono le tue Ore di lavoro? | Qual è la distribuzione delle ore? | Sesso? | Qual è la tua qualifica? | Qual è il tuo settore . | Qual è la tua priorità per il prossimo contratto? Può essere qualcosa di nuovo, un miglioramento delle condizioni di lavoro. Risposta libera
1 | A | A | A | F | A | I | Più soldi.
2 | B | A | A | F | B | J | Possibilità di avere più ferie.

Facendo clic sul numero ID sarà visualizzato il sommario completo delle risposte date solo dal corrisposndente utente al questionario come mostrato qui sotto:

Vista delle risposte ID 1
id | 1
Qual è il tuo tipo di impiego | Tempo pieno [A]
Quante sono le tue ore di lavoror | 36 ore per settimana [A]
Qual è la distribuzione delle ore? | 6 per 6 [A]
Sesso? | Femmina [F]
Qual è la tua qualifica? | Docente [D]
Qual è il tuo settore ? | Formazione [H]
Qual è la tua priorità per il prossimo contratto? Può essere qualcosa di nuovo, un migliioramento delle condizioni di lavoro (risposta libera) | Più soldi

A partire da questo punto si può scegliere se modificare o cancellare una risposta utilizzando, rispettivamente, il pulsante Modifica risposta o Elimina risposta che verranno mostrati nella barra Visualizza risposta: x.

Cancellare una risposta: normalmente non è mai corretto cancellare una risposta tranne in qualche caso particolare (ad es. una doppia immissione). Se si fa clic sul pulsante Cancella risposta tutta l'immissione sarà cancellata senza possibilità di recupero.

Modificare una risposta: anche in questo caso non è corretto cambiare risposte fornite a meno che non ci siano valide ragioni. Dopo aver effettuato lemodifiche desiderate fare clic sul pulsante Aggiorna in fondo alla pagina.

Identificativi di accesso (tokens)

In molte occasioni può essere necessario restringere la partecipazione ad una indagine ad uno specifico gruppo di persone oppure tenere traccia di chi ha completato il questionario o assicurarsi che le persone partecipino all'indagine una sola volta. Tutto ciò è possibile tramite l'uso di identificativi di accesso (Tokens) che possono essere inseriti in un apposita tabella e, eventualmente, impostati anche a indagine attivata. Per identificativi di accesso qui si intende indifferentemente sia l'insieme dei dati che identificano un utente sia la password di accesso attribuita all'utente che gli permette di accedere all'indagine.

Nella gestione degli identificativi è possibile:

- Importare una lista di nomi e di indirizzi e-mail (da un file CSV) o aggiungere/rimuovere nomi ed e-mail individualmente

- Generare un unico identificativo per ciascun partecipante

- Inviare un invito via e-mail a ciascun utente sia tutti insieme che singolarmente

- Inviare un messaggio e-mail di sollecito a chi non ha ancora completato il questionario sia tutti insieme che singolarmente

- Tener traccia di chi ha già risposto al questionario

- Impedire l'accesso a chi ha già risposto al questionario

- Modificare/cambiare ogni dettaglio nella lista dei partecipanti

Una volta abilitati gli identificativi per una indagine, ad esso potranno accedervi solo le persone in possesso di quell'identificativo.

Se un questionario è non anonimo la lista degli identificativi può essere utilizzata per risalire alle risposte fornite da quell'utente al questionario.

Per creare degli identificativi è necessario attivare l'indagine. Una volta attivata compare sulla barra dei pulsanti Indagine il pulsante Genera identificativi. Facendo clic su questo pulsante si apre la finestra Gestione identificativi per creare gli identificativi i

Sulla barra dei pulsanti Gestione identificativi sono presenti i seguenti pulsanti:

- Amministrazione generale: fa ritornare alla finestra generale di amministrazione;

- Riepilogo: visualizza un breve sommario degli identificativi presenti nella tabella (numero degli identificativi, a quanti è stato inviato un invito, quanti hanno risposto). Prevede anche un accesso alle 'Funzioni di Amministrazione del Database' (vedi sotto). E' la finestra di default;

- Mostra gli identificativi: mostra in una finestra la lista completa dei partecipanti presenti nella tabella degli identificativi. Da questa finestra si possono modificare e cancellare le immissioni nella tabella degli identificativi oltre a definire un password di identificazione

- Aggiungi un identificativo: permette di aggiungere identificativi;

- Esporta gli identificativi come file csv: permette di esportare i dati degli identificativi come file csv

- Importa file CSV: permette di importare identificativi da un file csv

- Invia invito: invia un messaggio di invito via e-mail a tutti i partecipanti presenti nella tabella degli identificativi.

- Invia sollecito: invia un messaggio di invito via e-mail a tutti i partecipanti presenti nella tabella degli identificativi che nonostante l'invito non abbiano ancora risposto al questionario.

- Genera password di identificazione: permette di creare password di identificazione per tutti gli utenti presenti nella tabella degli identificativi.

- Elimina tabelle degli identificativi: elimina la tabella degli identificativi già creata.

> Amministrazione del Database
> Mediante la finestra Riepilogo è anche possibile accedere alle funzionalità di Amministrazione Database identificativi features che includono:

- Non spedire inviti: annulla la spedizione di tutti gli inviti

- Elimina codici associati agli identificativi: elimina tutti i codici

- Azzera gli identificativi: azzera tutti gli identificativi.

- Elimina le tabelle degli identificativi: rimuove la possibilità di creare identificativi. Cancella l'intera tabella e tutti i record facendo sì che possa partecipare all'indagine chiunque conosca l'indirizzo per accedervi.

> Usare la finestra Visualizzazione dati
> La finestra Visualizzazione dati mostra la lista di tutti i dati presenti nella tabella degli identificativi e mette a disposizione alcuni pulsanti che permettono alcune attività su quei dati.

> La fila superiore della tabella fornisce le opzioni per stabilire quanti record sono mostrati ed il numero del record di inizio a partire dal quale vengono visualizzati

> La seconda fila indica i nomi dei campi e permette facendo clic sulla freccia verde presente per ciascun campo di ordinare gli identificativi secondo quel campo.

Record visualizzati |  | Inizio da |  |

ID | Nome | Cognome | e-mail | Identificativo | Invito? | Fatto? | attributo_1 | attributo_2 | Azione
--- | --- | --- | --- | --- | --- | --- | --- | --- | ---
1 | Jason | Cleeland | jason@cleeland.org | 0829007266 | Y | Y | Administrator | Australia |  |
2 | Mario | Marani | mario.marani@irrepuglia.it | 1371896219 | Y |  | Docente | Italia |  |
3 | Eric | Estrada | erice@cleeland.org | R193857398 | Y | Y | Actor | USA |  |

> La colonna Funzioni indica quali azioni possono essere svolte su quell'identificativo.

- > E: Modifica

- > D: Cancella

- > S: Partecipa all'indagine con quell'identificativo

- > R: Invia un sollecito (disponibile solo è stato inviato l'invito)

- > I: Spedisce un invito (disponibile solo se l'invito non è stato ancora inviato)

- > V: Se la partecipazione non è anonima apparirà un pulsante "V" con il quale si potrà mostrare la risposta data.

> Permettere la Registrazione Pubblica
> E' possibile far partecipare chiunque ad una indagine con un controllo simile a quello fornito dagli identificativi. Se si inizializza la tabella degli identificativi e si è scelto nelle impostazioni generali dell'indagine di permettere la registrazione pubblica chiunque visiti l'URL dell'indagine senza un identificativo avrà la possibilità di parteciparvi registrandosi. Sarà sufficiente che venga fornito un indirizzo e-mail non già presente nella tabella degli identificativi per creare un record specifico nella tabella degli identificativi. Sarà inviata uan e-mail di invito contenente unna password di identificazione per l'accesso (questo identificativo sarà preceduto dalla lettera "R").

Data Entry

Questa funzione permette l'inserimento manuale dei dati da parte dell'amministratore. E' utilizzata quando le risposte al questionario pervengono in forma scritta.

Esportare Risultati

Si possono esportare le risposte pervenute facendo clic sul pulsante Esporta risultati presente nella barra Sfoglia risposte della relativa finestra.

Quando si fa clic su questo pulsante comparirà una nuova finestra con diversi campi e opzioni di esportazione.

Campo Esporta risposte:

- Titoli abbreviati: esporta l'ID della domanda, l'ID del gruppo e l'ID dell'indagine

- Titoli completi: esporta le domande in modo completo

- Codice Risposte: esporta solo i codici delle risposte pervenute

- Risposte complete: esporta le risposte con i relativo testo

- Microsoft Word: esporta i dati come documento in formato MSWord

- Microsoft Excel: esporta i dati in formato MSExcel

- CSV delimitato da virgole: esporta i dati come file csv

La finestra di esportazione permette di selezionare quali campi esportare e, se l'indagine è non anonima, permette di associare le informazioni degli identificativi con ciascuna risposta.

Esportazione e Impostazione VV (verifica verticale)

Quando incominciano ad arrivare le risposte ad una indagine vi possono essere dei casi in cui si ha bisogno di accedere ad una grande quantità di dati per poterli modificare in cui l'uso di un foglio di calcolo potrebbe essere più consigliabile rispetto agli strumenti previsti da PHPSurveyor.

L'esportazione/Importazione VV (VVExport e VVImport) in cui VV sta per verifica verticale permette di esportare la tabella delle risposte i un file tipo tsv (tab separated values). In questo modo in esportazione la struttura generale del file rimane intatta cosicchè dopo le modifiche ai dati è possibile reimportare tramite la funzionalità importazione VV immediatamente la stessa tabella.

Esportare il file VV dell'indagine
Quando si esportano dati utilizzando la funzionalità Esporta file VV indagine è possibile esportare i risultati lasciando attiva l'indagine o disattivando la stessa indagine.

Se si sceglie di disattivare l'indagine la tabella delle risposte sarà rinominata e sarà indisponibile senza un accesso diretto A MySQL (questo è dovuto alla disattivazione).

Se l'indagine utilizza degli identificativi bisogna tener presente che disattivare una indagine fa sì che anche la tabella degli identificativi verrà rinominata e resa indisponibile.

E' allora consigliabile no disattivare l'indagine se si haa che fare con tabelle di identificativi a meno che non si sappia come intevenire su MySQL manualmente.

Tuttavia la possibilità di disattivare l'indagine è importante perchè un file vv dell'indagine permette l'importazione delle risposte anche quando le combinazioni tra domande e risposte sono cambiate.

Facendo clic sul pulsante Esporta file VV indagine della barra Sfoglia risposte verrà creato un file tsv (tab separated values) che può essere letto con Excel o qualunque altro foglio di calcolo. Le prime due righe del foglio di calcolo rappresentano le etichette dei campi. A partire dalla terza riga ci saranno i risultati dell'indagine.

Non si devono cambiare le prime due righe se si desidera importare nuovamente i dati in PHPSurveyor.

Importare il file VV indagine
Se si sono lasciate invariate le prime due righe si possono importare nuovamente i dati nell'indagine di PHPSurveyor. Se si è disattivata l'indagine al momento dell'esportazione bisognerà ricordarsi di riattivare l'indagine.

Fare clic sul pulsante Importa file VV indagine, della barra Sfoglia risposte.

Si aprirà la finestra di dialogo Importa file VV indagine mediante la quale si dovrà scegliere il file, precedentemente esportato, da importare. Se si sceglie l'opzione Escludi ID dei record verranno creati nuovi ID per i record altrimenti saranno ripristinati i precedenti.

Statistiche

Le statistiche sono disponibili una volta che l'indagine è attivata a partire dalla barra pulsanti Sfoglia risposte.

Che cosa sono le statistiche in PHPSurveyor?
Per analizzare i dati delle risposte ad un questionario è possibile far ricorso ad un foglio di calcolo dopo aver esportato in questo formato tutti i dati, in alternativa è possibile sfruttare la capacità statistica di PHPSurveyor. Ovviamente le potenzialità non sono elevate quanto quelle previste in un foglio di calcolo tuttavia aiutano a fare unaprima analisi dei dati disponibili

Filtrare i dati

Quando si usano le funzionalità statistiche la prima cosa da indicare è su quali dati fare quelle analisi. Un esempio è mostrato di seguito.

Fare clic sul pulsante Statistiche della barra pulsanti Sfoglia risposte

Si aprirà la pagina Imposta filtro

In questa pagina ciascuna domanda sarà individuata dal suo codice e da un campo in cui sono riportate le possibili risposte,

Se si desidera visualizzare una statistica su una domanda fare clic sul pulsante posto a fianco del codice (eventualmente è possibile filtrare una o più delle possibili risposte selezionadole nel menù a discesa delle risposte) quindi fare clic sul pulsante Vista delle Stats posto in fondo alla pagina. Ovviamente è possibile richiedere l'analisi statistica di più domande o di tutte (in questo caso fare clic sul radio button Vista delle stats di tutti i campi disponibili posto in fondo alla pagina

Verranno mostrati, in tabelle, i risultati statistici relativi alla/alle domanda/domande selezionate. Un esempio è mostrato qui di seguito.

Risultati
Numero dei record in questa query: 146 Totale dei record nel questionario: 367 Percentuale del totale:43.32% SELECT count(*) FROM survey_4 WHERE 4X6X22 IN ('A') AND 4X6X23 IN ('A')

Vista del campo sommario
Nel campo sommario vengono forniti i dati relativi alle risposte fornite in termini assoluti e percentuali (sul totale delle risposte pervenute).

Campo sommario per Q04:
Sesso
Risposta | Conteggio | Percentuale
Nessuna risposta | 1 | 00%
Femmmina (F) | 49 | 33%
Maschio (M) | 96 | 65%

Esportare risultati

Se si desidera esportare le risposte che incrociano i criteri definiti bisogna fare clic sul pulsante Esporta posto in fondo alla pagina risultati. Verrà visualizzato la solita finestra di esportazione in cui saranno presenti i dati filtrati secondo i criteri stabiliti. Similarmente facendo clic sul pulsante Browse verranno visualizzati i dati filtrati secondo gli stessi criteri.

Licenza

Questo programma è "free software"; è possibile redistribuirlo e/o modificarlo secondo i termini della GNU General Public License così come pubblicato dalla Free Software Foundation versione 2, o versioni successive.
Questo programma è distribuito nella speranza che risulti utile, ma SENZA ALCUNA GARANZIA, senza garanzia implicita di COMMERCIABILITA' o ADATTABILITA' A SCOPI SPECIFICI. Consulta la GNU General Public License per maggiori dettagli http://www.gnu.org/licenses/gpl.html