Report

Il report è definito dal blocco di codice passato al metodo ptabs.new("name"). All’interno del blocco è possibile definire il titolo, il sottotitolo e il piè di pagina del report. Il nome passato al metodo new viene usato come nome di file per i vari output, altrimenti viene utilizzato lo stesso nome dello script (senza estensione). Il metodo name permette di ridefinire il nome dei file di output.

 report = ptabs.new("nome") do
   title    "Titolo"
   subtitle "Sottotitolo"
   footer   "Piè di pagina"
   name     "nuovo_nome"
   ...
 end

inc

All’interno della definizione di un report è possibile utilizzare il comando inc per includere un file di istruzioni pTabs nello script che si sta eseguendo. Il file deve contenere un blocco di codice sintatticamente corretto. [1] L’estensione predefinita è .pt. [2] Si vedano anche le istruzioni %include e ptabs.inc.

 # File d6.pt
 se!
 scale s(:d6_, 10), "D6. Valori medi (anche standard error)" do
   weights nil, 25, 50, 75, 100
   autonote
   sort :d, :mean
 end
 se_

 # Script principale
 ...
 inc 'd6'

Output

Una serie di metodi di Report sono disponibili per elaborare l’output. I metodi ritornano sempre l’oggetto Report e quindi possono essere concatenati.

 report = ptabs.new("nome") do
   ...
 end.print.save(:r)

 report.render(:html).render(:pdf)

print

Stampa nel log le istruzioni R.

save

save(:r) salva la sintassi R in un file.

render

render genera i file con le tavole del report nei vari formati disponibili: HTML, Pdf, Excel, Testo e come matrice di dati.

Note

[1]	Eventuali definizioni di variabili saranno visibili solo all’interno del file che si include.

[2]	Per includere un file con istruzioni Ruby generiche (non pTabs) usare i metodi load o require.