Scripts

Uno script di pTabs è un file di testo con estensione .pt. Uno script contiene la definizione di uno o più report.

Un report è un blocco di codice passato al metodo ptabs.new. L’oggetto Report generato normalmente viene per comodità assegnato a una variabile.

1
2
3
 report = ptabs.new do
   ...
 end

All’interno del blocco di codice vengono definiti gli elementi del report: titolo, sottotitolo e piè di pagina del report, file di dati, pannelli, tabelle, ecc.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
 report = ptabs.new("nome_outputs") do
   title    "Titolo"
   subtitle "Sottotitolo"
   footer   "Piè di pagina"

   spss.open 'esempi_ctables'
   weight.by :peso

   panels.add :_tot, :sesso, :eta, :titolo
   panels.add :_tot, :area, :ampc

   cat :q1
   ord :q2
   md s(:d3,10)
   ...
 end

Infine una serie di metodi di Report sono disponibili per elaborare gli output.

1
2
3
4
5
6
7
8
 report = ptabs.new("nome_outputs") do
   ...
 end

 report.render :html
 report.render :pdf
 report.render :xls
 report.render :text

E’ possibile generare una bozza dello script tramite lo switch sc:

ptabs -sc scriptname

%include

L’istruzione %include nomefile permette di includere il contenuto di un file esterno. Questa istruzione viene eseguita prima di qualsiasi interpretazione del contenuto dello script, pertanto il nome del file non può essere generato dinamicamente, ma deve essere una costante. Si vedano anche le istruzioni ptabs.inc e inc.