Generazione Report Sondaggi tramite Modello ODT
Nota: Il report è utilizzabile solo per i Sondaggi e non per i Quiz.
IMPORTANTE: il file deve essere in formato .odt e non .doc, si sconsiglia dunque l’uso di word. E’ bensì altamente consigliato l’uso di Openoffice.
Questa guida sulla creazione del Report custom sui Sondaggi è suddivisa nei seguenti paragrafi:
- INTRODUZIONE
- CARICAMENTO A SISTEMA DEL MODELLO
- ELENCO SEGNAPOSTI DISPONIBILI
- BLOCCHI CONDIZIONALI
- FILTRI
- MODELLI DI ESEMPIO
- COLLEGARE IL REPORT AL SONDAGGIO
- UTILIZZO DEL REPORT
1. INTRODUZIONE
Un modello di contratto ODT è un file in formato odt che caricato a gestionale nella sezione Configurazione → Contratti & Report permette di generare documenti in formato PDF contenenti informazioni dinamiche, utilizzando un file .odt, chiamato modello, nel quale sono inseriti degli appositi segnaposti, che, nel documento finale generato, verranno sostituiti dal valore indicato dal segnaposto.
ATTENZIONE: modello si riferisce, nel contesto di questa documentazione, ad un normale file .odt contente dei segnaposti, il file deve essere in formato documento di testo ODF, estensione .odt.
I segnaposti possono essere inseriti in un contesto di scrittura normale. Possono essere inseriti anche in tabelle e possono essere mostrati con blocchi condizionali o filtri.
2. CARICAMENTO A SISTEMA DEL MODELLO
Per inserire il modello di report nel sistema navigare su Configurazione → Contratti & Report e cliccare il pulsante “Aggiungi report“:
La schermata che si apre conterrà tutte le informazioni necessarie per il caricamento del Report:
Compilare i seguenti campi:
- Nome*: il nome del report .
- Descrizione: eventuale descrizione del report.
- Tipo di report: scegliere l’opzione “Da modello ODT” per poter caricare il proprio modello.
- Sezione in cui mostrare il report *: Sondaggi.
- Modello del report: caricare il modello con estensione odt del proprio report.
- Seleziona tipo: selezionare il tipo di estensione del file tra Pdf e Odt.
- Ordine *: l’ordine di elencazione dei report (es. 1, 2, 3, etc).
Finita la configurazione cliccare il pulsante “Aggiungi report” per salvare l’operazione:
3. ELENCO SEGNAPOSTI DISPONIBILI PER I MODELLI DI CONTRATTO
Alcuni dei segnaposti indicati necessitano dell’indicazione [domanda1], [domanda2] ecc.. questa indicazione fa riferimento al nome della domanda che si può visualizzare nel box di destra quando si clicca nel riquadro di una domanda:
Segnaposti survey sezione Sondaggi
Segnaposti per i report Sondaggi| SEGNAPOSTO | VALORE | NOTE |
|---|---|---|
| {survey.name} | Nome del Sondaggio | |
| {survey.questionsnumber} | Numero delle domande presenti nel sondaggio | |
| {survey.surveyquestions[domanda1]} | Riporta la domanda del sondaggio selezionata | Tra parentesi quadre andrà inserito il nome della domanda da visualizzare, di default: [domandaX] |
| {survey.surveyanswers[domanda1]} | Riporta la risposta della domanda selezionata | Tra parentesi quadre andrà inserito il nome della domanda da visualizzare, di default: [domandaX] |
| CONDIZIONE | VALORE | NOTE |
| {survey.isanonymous} | Vero se il Sondaggio è anonimo | |
| {survey.isforstudents} | Vero se il Sondaggio è per Studenti | |
| {survey.isforteachers} | Vero se il Sondaggio è per Docenti | |
| {survey.isforcompanies} | Vero se il Sondaggio è per Aziende | |
| {survey.isforeachstudent} | Vero se il Sondaggio è per singolo Studente |
Segnaposto assignee sezione Sondaggi
Dati dello studente/docente disponibili nella sezione Anagrafiche → Studenti/Docenti.| SEGNAPOSTO | VALORE | NOTE |
|---|---|---|
| {assignee.address} | indirizzo | |
| {assignee.birthdate} | data di nascita | |
| {assignee.birthday} | compleanno | |
| {assignee.birthplace} | luogo di nascita | |
| {assignee.birthprovince} | provincia di nascita | |
| {assignee.birthcountry} | paese di nascita | |
| {assignee.cap} | codice di avviamento postale | |
| {assignee.city} | città | |
| {assignee.country} | nazione | |
| {assignee.countryCode} | nazione | |
| {assignee.citizenship} | cittadinanza | |
| {assignee.passport} | passaporto | |
| {assignee.profession} | professione | |
| {assignee.qualification} | qualifica | |
| {assignee.customfields[]} | campo personalizzato | tra le parentesi quadre deve essere indicato il codice del campo personalizzato |
| {assignee.email} | ||
| {assignee.fullName} | nominativo | |
| {assignee.gender} | genere | |
| {assignee.maritalstatus} | stato civile | |
| {assignee.id} | identificativo | |
| {assignee.mobile} | telefono mobile | |
| {assignee.name} | nome | |
| {assignee.phone} | telefono fisso | |
| {assignee.province} | provincia | |
| {assignee.surname} | cognome | |
| {assignee.taxcode} | codice fiscale | |
| {assignee.vatnumber} | partita iva | |
| {assignee.cardnumber} | numero dalla eventuale tessera | |
| {assignee.notes} | note | |
| CONDIZIONE | VALORE | NOTE |
| assignee.isAdult | vero se lo studente è maggiorenne, falso altrimenti | |
| assignee.isNotAdult | vero se lo studente è minorenne, falso altrimenti |
Segnaposto student sezione Sondaggi
Dati dello studente disponibili nella sezione Anagrafiche → Studenti.Valorizzato solo se il Sondaggio è per singolo Studente. Riporta il segnaposto riferito allo Studente a cui è rivolto il Sondaggio.
| SEGNAPOSTO | VALORE | NOTE |
|---|---|---|
| {student.address} | indirizzo | |
| {student.birthdate} | data di nascita | |
| {student.birthday} | compleanno | |
| {student.birthplace} | luogo di nascita | |
| {student.birthprovince} | provincia di nascita | |
| {student.birthcountry} | paese di nascita | |
| {student.cap} | codice di avviamento postale | |
| {student.city} | città | |
| {student.country} | nazione | |
| {student.countryCode} | nazione | |
| {student.citizenship} | cittadinanza | |
| {student.passport} | passaporto | |
| {student.profession} | professione | |
| {student.qualification} | qualifica | |
| {student.customfields[]} | campo personalizzato | tra le parentesi quadre deve essere indicato il codice del campo personalizzato |
| {student.email} | ||
| {student.fullName} | nominativo | |
| {student.gender} | genere | |
| {student.maritalstatus} | stato civile | |
| {student.id} | identificativo | |
| {student.mobile} | telefono mobile | |
| {student.name} | nome | |
| {student.phone} | telefono fisso | |
| {student.province} | provincia | |
| {student.surname} | cognome | |
| {student.taxcode} | codice fiscale | |
| {student.vatnumber} | partita iva | |
| {student.cardnumber} | numero dalla eventuale tessera | |
| {student.notes} | note | |
| CONDIZIONE | VALORE | NOTE |
| student.isAdult | vero se lo studente è maggiorenne, falso altrimenti | |
| student.isNotAdult | vero se lo studente è minorenne, falso altrimenti |
4. BLOCCHI CONDIZIONALI
Il blocco condizionale è una parte del documento, delimitato da appositi marcatori, al quale è associato una condizione che può essere vera o falsa, se è vera il contenuto del blocco viene mostrato nel documento finale, se falsa il contenuto del blocco viene eliminato dal documento finale.
Come condizione per il blocco può essere usato uno dei campi personalizzati definiti o le condizioni indicate nella sezione CONDIZIONE dell’elenco dei segnaposti disponibili.
La condizione che usa un campo personalizzato è vera se il campo è valorizzato, è falsa se è vuoto.
La sintassi per definire il blocco condizionale prevede di indicare l’inizio e la fine del blocco, indicando la condizione associata, ad esempio per definire un blocco condizionale da mostrare solo se l’ordine è scontato:
[!-- IF survey.isanonymous --]
“Il sondaggio è anonimo”
[!-- ENDIF survey.isanonymous --]
survey.isanonymous è la condizione, se è vera la dicitura viene mostrata, se è false la scritta non verrà mostrata.
Si può invertire il controllo della condizione aggiungendo NOT alla sintassi per definire il blocco condizionale, ad esempio per definire un blocco condizionale da mostrare solo se il sondaggio non è anonimo:
[!-- IF NOT survey.isanonymous --]
“Il sondaggio non è anonimo”
[!-- ENDIF NOT survey.isanonymous --]
survey.isanonymous è la condizione, se è vera la dicitura non viene mostrata, se è false la scritta verrà mostrata.
5. FILTRI
I Filtri permettono di eseguire un’operazione che modifica il valore del singolo segnaposto inserito nel documento e sono disponibili per ogni tipo di report odt, indipendentemente dalla sezione.
I filtri disponibili sono i seguenti:
- cut permette di limitare la lunghezza di un testo entro il valore indicato, ad esempio per limitare la lunghezza del nome dello Studente ad un massimo di 5 caratteri possiamo usare il segnaposto {student.name|cut[5]}
- daysbefore permette di calcolare una data anteriore alla data del segnaposto valorizzato, ad esempio se vogliamo ottenere la data corrispondente a 2 settimane prima dell’inizio del corso possiamo usare il segnaposto {course.startDate|daysbefore[14]}
- daysafter permette di calcolare una data posteriore alla data del segnaposto valorizzato, ad esempio se vogliamo ottenere la data corrispondente a 1 settimana dopo l’inizio del corso possiamo usare il segnaposto {course.startDate|daysafter[7]}
- lowercase cambia il valore del segnaposto in minuscolo, ad esempio per mostrare il nome del corso tutto in minuscolo usare il segnaposto {course.name|lowercase}
- uppercase cambia il valore del segnaposto in maiuscolo, ad esempio per mostrare il nome del corso tutto in maiuscolo usare il segnaposto {course.name|uppercase}
- uppercasefirst cambia il valore del segnaposto mettendo in maiuscolo la prima lettera, ad esempio per mostrare il nome del corso con la prima lettera in maiuscolo usare il segnaposto {course.name|uppercasefirst}
Se nel documento dovessero essere necessarie due versioni dello stesso segnaposto, una filtrata ed una non filtrata, basterà aggiungere un _ (trattino basso) alla seconda occorrenza del segnaposto, ad esempio usare {student.name|cut[5]} per mostrare il nome del corso abbreviato e {student_.name} per mostrare successivamente il nome del corso completo.
6. MODELLI DI ESEMPIO
7. COLLEGARE IL REPORT AL SONDAGGIO
Per collegare il Report al Sondaggio desiderato occorre andare nella sezione Quiz e Sondaggi, entrare in modifica del Sondaggio e selezionare nel campo Report dei risultati il Report creato in precedenza:
8. UTILIZZO DEL REPORT
Per poter utilizzare il Report appena caricato sarà sufficiente navigare all’interno di un Corso con il Sondaggio compilato e sotto la sezione Quiz e Sondaggi cliccare sull’icona a forma di occhio:
Di seguito cliccare il pulsante Download accanto al nome del Docente/Studente di cui si vuole scaricare il Sondaggio.