Render

Genera gli output in vari formati.

E’ possibile generare nello stesso batch più file di formato diverso o anche dello stesso formato.

html

Genera il report in formato HTML.

• il layout è modificabile atraverso fogli stili CSS
• indice con link alle tabelle

 report.render :html

pdf

Genera il report in formato PDF. [1]

• il layout è modificabile atraverso fogli stili CSS
• intestazione e piè di pagina modificabile
• numerazione pagine e pagine totali
• impaginazione tabelle lunghe su più pagine
• indice delle tabelle nei segnalibri
• logo nella prima pagina e nel piè di pagina

 report.render :pdf
 report.render :pdf, :file => "altro_nome"

Excel

xls

Genera il report in formato Excel 97-2003.

Parametri:

• single_panel: pannelli originari (false) o unione in un pannello unico (true)
• multiple_sheets: tabelle in un unico foglio (false) o un foglio per tabella (true)
• file: nome del file di ouput (se diverso dal nome del repor)
• stat_col*: permette di aggiungere (true) una colonna con le etichette delle statistiche
• stats: array delle statistiche da includere nelle tabelle. :all per includerle tutte. Se il valore è :all o il parametro non è specificato verranno incluse tutte le statistiche.
• sheet: nome del foglio. Se non specificato è uguale al nome del file.
• sheets: permette di specificare più fogli in uno stesso file. Hash con i nomi dei fogli e gli array delle statistiche da includere nelle tabelle
• :xhp1: (in punti) forza l’altezza della prima riga del pannello (etichette delle variabili)
• :xhp2: (in punti) forza l’altezza della seconda riga del pannello (etichette dei valori)
• :xhnote: (in punti) forza l’altezza della riga delle note

 report.render :xls, :single_panel => true, :stats => [:colpct, :base, :mean, :sd]
 report.render :xls, :single_panel => true, :multiple_sheets => true, :stats => :all, :file => "altro_nome"
 report.render :xls, :single_panel => true, :xhp2 => 60,
               :sheets => { "VA %" => [:all],
                            "%"    => [:tcount, :trowcol,         :rowpct, :colpct, :mresp, :base, :mean, :sd],
                            "VA"   => [:tcount, :trowcol, :count,                   :mresp, :base, :mean     ] }

xlsx

Genera il report in formato Excel Open XML Format Spreadsheet.

Accetta gli stessi parametri di xls.

 report.render :xlsx

• xls
  • generazione del report più veloce
  • fino a 256 colonne
  • fino a 65.536 righe
  • file di dimensioni più grandi
  • numero limitato di colori
  • richiede l’installazione del JDK
• xlsx
  • generazione del report più lenta
  • fino a 16.384 colonne
  • fino a 1.048.576 righe
  • file di dimensioni più piccole
  • consente di utilizzare gli stessi colori utilizzati nell’output HTML e PDF
  • non richiede l’installazione del JDK

ptweb

Esporta le tabelle nel formato utilizzato da pTabsWeb.

 # genera il file <nome_report.db>
 report.render :ptweb, :file => "nome_report"

All’interno dello script sono disponibili le istruzioni period e stratum per etichettare e raggrupare le tabelle (vedi Selezione delle osservazioni).

db

Esporta le tabelle come matrice di dati. I formati di dati disponibili sono: Access, csv, xlsx e xls.

Utilizzando il formato Access, viene creato un database con interfaccia grafica (pTabsDB) per la navigazione delle tabelle, la produzione e l’aggiornamento di grafici e tabelle in Power Point.

Utilizzando i formati csv, xlsx e xls viene generata solo la matrice di dati.

Parametri:

• id: una stringa di testo che identifica i dati, se non specificato utilizza l’id del report (corrisponde al campo matrix)
• period: una stringa di testo che identifica il periodo (corrisponde al campo period)
• db o file: il nome del file o del database
• append: accoda i dati in una tabella esistente altrimenti sostituisce la tabella; default: false
• clear: prima di caricare i nuovi dati, elimina dal database i dati con stesso id e stesso period. Permette di ricaricare un set di dati. Solo in unione con append. Default: false
• company: nome dell’azienda che deve comparire nell’interfaccia
• version o v: genera un db nella versione dell’interfaccia specificata
• format: il formato del file di output: :access|:csv|:xlsx|:xls. Il default è :access.

L’estensione per il formato Access è accdb. E’ necessario Access 2010 per utilizzare l’interfaccia del database. Il file Access se non esiste viene creato.

 report.render :db, :id => "Main sample", :period => "2012 trim 1", :append => true

La struttura della tabella è fissa, non dipende dai pannelli o dal tipo di tabelle prodotte. I dati sono identificati attraverso una serie di campi che costituiscono una chiave univoca. Pertanto, oltre all’utilizzo con interfaccia grafica, è possibile utilizzare programmaticamente il database estraendo i dati attraverso attraverso delle query SQL. Questo formato può costituire una solida base per report e presentazioni.

Struttura della tabella:

Campo	Chiave	Tipo	Descrizione
matrix	x	string	identificativo della matrice di dati
period	( x )	string	identificativo del periodo (defauld vuoto)
stratum	x	string	identificativo dello strato/selezione (default vuoto) [2]
table	x	string	identificativo della tabella [3]
subtable	x	integer	indice sottotabella
rvar	x	string	nome variabile di riga
rid	x	integer	indice riga
rlabel		string	etichetta riga
net		integer	distingue gli item normali (0) dai net (1)
cvarid	x	integer	identificativo progressivo della variabile di colonna
cvar	x	string	nome variabile di colonna
cvarlabel		string	etichetta variabile riga
cid	x	integer	indice colonna
clabel		string	etichetta colonna
stat	x	string	tipo statistica: count o summary
count		float	conteggio casi
rpct		float	percentuale di riga
cpct		float	percentuale di colonna
base		float	base casi
base_u		float	base casi non ponderati
mean		float	media
sd		float	deviazione standard
se		float	errore standard della media
nresp		float	numero totale risposte multiple
mresp		float	numero medio risposte multiple
coord		float	coordinate
i_conc		float	indice concentrazione
accent		integer	flag accentuazioni

Il campo periodo quando usato, diventa parte della chiave primaria della tabella Access.

Opzioni

Alcune opzioni disponibili nella generazione degli output:

Parametro	T/F	Descrizione
file		nome del file di output (senza estensione)
single_panel	x	genera un unico pannello
multiple_sheets	x	mette ogni tabella in un foglio distinto (Excel)
matrix_id	x	nell’output Excel, aggiunge gli identificativi della matrice
rtotal	x	attiva/disattiva totale di riga
tcount	x	attiva/disattiva valori assoluti totale
trowpct	x	percentuali riga totale
tcolpct	x	percentuali colonna totale
count	x	attiva/disattiva valori assoluti
rowpct	x	attiva/disattiva percentuali riga
colpct	x	attiva/disattiva percentuali colonna
base_u	x	attiva/disattiva base non pesata
base	x	attiva/disattiva base
mean	x	attiva/disattiva media
sd	x	attiva/disattiva deviazione standard
se	x	attiva/disattiva errore standard della media

Note

[1]	I file PDF sono generatti attraverso wkhtmltopdf.

[2]	Viene utilizzato il valore di id impostato dalle dalle struzioni filter, select e all.

[3]	pTabs genera un identificativo automatico per ciascuna tabella che dipende dall’ordine di generazione. E’ possibile fornire un identificativo esplicito nella definizione della tabella tramite il sottocomando id.