Avrei voluto aspettare il rilascio della prima
versione definitiva di P4A3,
ma non ce l'ho fatta... Era troppa la curiosità! Così ho pensato di provare
il porting del codice dell'applicazione invoices
manager per cominciare a comprendere le novità del nuovo framework,
nonostante la versione di rilascio attuale sia una "preview". Le differenze
sono numerose, anche se l'aspetto esteriore è rimasto sostanzialmente
invariato. La prima cosa che salta all'occhio è la differenza nell'utilizzo
delle classi. Poiché il nuovo framework si è liberato della compatibilità
con il vecchio PHP4, ha guadagnato tutti i benefici della struttura realmente
orientata agli oggetti del PHP5. Quindi, per esempio, il
costruttore di una classe non prendera più il nome della classe stessa ma
sarà definito con: public function __construct(). Con PHP5
inoltre viene finalmente risolto il problema
dell'assegnazione nelle variabili oggetto, che avviene sempre per
riferimento senza dover anteporre l'operatore &. Infine,
adesso c'è la possibilità di definire proprietà e metodi pubblici, privati
e protetti. Sono comunque tantissime le novità e vi rimando al sito di Fabrizio
Balliano per la lunga lista di cambiamenti!
Tralasciando il codice di index.php che rimane sostanzialmente
invariato se non per la riga di codice che richiama la classe base che
diventa: $app = p4a::singleton("Invoices_Manager"); Si nota che
non richiede più l'utilizzo di & per l'assegnazione per
riferimento all'oggetto. Passiamo a vedere il codice della classe iniziale,
quella dove viene definito il menù comune a tutte le maschere:
class Invoices_Manager extends P4A
{
/**
* @var P4A_Menu
*/
public $menu = null;
/**
* @var P4A_DB_Source
*/
public $clienti = null;
public function __construct()
{
parent::__construct();
$this->setTitle("Gestione Fatture");
// Menu
$this->build("p4a_menu", "menu");
$this->menu->addItem("anagrafiche", "Anagrafiche");
$this->menu->items->anagrafiche->addItem("ditta")
->implement("onclick", $this, "menuClick");
$this->menu->items->anagrafiche->addItem("clienti")
->implement("onclick", $this, "menuClick");
$this->menu->addItem("fatture", "Fatture")
->implement("onclick", $this, "menuClick");
$this->menu->addItem("report", "Report");
$this->menu->items->report->addItem("lista", "Lista fatture")
->implement("onclick", $this, "menuClick");
// Data sources
$this->build("p4a_db_source", "clienti")
->setTable("clienti")
->addOrder("Ragione_sociale")
->setPageLimit(5)
->load();
// Primary action
$this->openMask("P4A_Default_Mask");
}
public function menuClick()
{
$this->openMask($this->active_object->getName());
}
}
Si può subito notare la possibilità di utilizzare la sintassi di
concatenazione delle istruzioni (chainability, tipo jQuery), la
possibilità di utilizzare il metodo implement() senza dover
ricorrere prima al metodo addAction() che viene richiamato
automaticamente quando l'azione è riconosciuta come evento del browser,
infine la possibilità di definire una variabile oggetto pubblica per
riutilizzare in più maschere, ad esempio una definizione di sorgente
dati.
Per non rendere eccessivamente lungo questo post, mostrerò solo il codice relativo alla maschera che riguarda la fattura, il resto del codice è scaricabile come pacchetto completo in fondo all'articolo.
class fatture extends P4A_Base_Mask
{
public $fs_search = null;
public $txt_search = null;
public $cmd_search = null;
public $toolbar = null;
public $table = null;
public $fs_details = null;
public function __construct()
{
parent::__construct();
$p4a = P4A::singleton();
$this->setTitle('Gestione fatture');
// DB Source
$this->build("p4a_db_source", "fatture")
->setTable("fatture")
->addJoin("clienti", "fatture.ID_cliente = clienti.ID",
array('Ragione_sociale'=>'cliente'))
->addOrder("Num_fattura",P4A_ORDER_DESCENDING)
->setPageLimit(5)
->load();
$this->setSource($this->fatture);
$this->firstRow();
//Create detail source. Detail table should be in a different class
$dett_prestazioni = $this->build("prestazioni", "dett_prestazioni");
$dett_prestazioni->source->addFilter("ID_fattura = ?",
$this->fatture->fields->ID);
// Customizing fields properties
$this->setFieldsProperties();
// Search Fieldset
$this->build("p4a_field", "txt_search")
->setLabel("Numero fattura")
->implement("onreturnpress", $this, "search");
$this->build("p4a_button", "cmd_search")
->setLabel("Cerca")
->implement("onClick", $this, "search");
$this->build("p4a_fieldset", "fs_search")
->setLabel("Ricerca per numero fattura")
->setWidth(800)
->anchor($this->txt_search)
->anchorLeft($this->cmd_search);
// Build Tab pane
$tab_pane = $this->build("p4a_tab_pane","tab_pane");
// Toolbar
$this->build("p4a_simple_toolbar", "toolbar")
->setMask($this);
// Hide original print screen button
$this->toolbar->buttons->print->setInvisible();
// Add new button to print pdf
$this->toolbar->addButton('stampafattura','print');
// Intercept onClick and override with our own method
$this->intercept($this->toolbar->buttons->stampafattura,
'onClick','print_doc');
// Join toolbar with this mask
// Table
$this->build("p4a_table", "table")
->setWidth(700)
->setSource($this->fatture)
->setVisibleCols(array("Num_fattura", "Data_fattura", "cliente",
"Pagamento", "Pagata"))
->showNavigationBar();
$this->table->cols->Num_fattura->setLabel("N. fattura");
//Fieldset con l'elenco dei campi
$this->build("p4a_fieldset", "fs_details")
->setLabel("Dati fattura")
->setWidth(700)
->anchor($this->fields->Num_fattura)
->anchorLeft($this->fields->Data_fattura)
->anchor($this->fields->ID_cliente)
->anchorLeft($this->fields->Pagamento)
->anchor($this->fields->Pagata);
$this
->setRequiredField("Num_fattura")
->setRequiredField("Data_fattura");
// events onChange
// Intercept change page on the tab pane
$tab_pane->implement("afterSetActivePage",$this,"ChangePage");
// tabpane settings
$tab_pane->setWidth(750);
$tab1 = $tab_pane->pages->build("p4a_frame","tab1");
$tab2 = $tab_pane->pages->build("p4a_frame","tab2");
$tab1->setLabel("Fatture");
$tab2->setLabel("Dettaglio fattura");
// anchor tab pane
$this->frame->anchor($tab_pane);
// tab1 - Anchor master table
$tab1
->anchor($this->fs_search)
->anchor($this->table)
->anchor($this->fs_details)
->newRow();
// tab2 - Anchor detail table
$tab2
->anchor($dett_prestazioni->toolbar)
->anchor($dett_prestazioni->table)
->anchor($dett_prestazioni->fs_details);
// Display
$this
->display("menu", P4A::singleton()->menu)
->display("top", $this->toolbar)
->setFocus($this->fields->Num_fattura);
}
private function setFieldsProperties()
{
$this->fields->ID_cliente
->setType("select")
->setSource(P4A::singleton()->clienti)
->setSourceDescriptionField("Ragione_sociale")
->setLabel("Cliente")
->setWidth(200);
}
public function search()
{
$value = $this->txt_search->getSQLNewValue();
$this->fatture
->setWhere(P4A_DB::singleton()->getCaseInsensitiveLikeSQL('Num_fattura',
"%{$value}%"))
->firstRow();
if (!$this->fatture->getNumRows()) {
$this->warning("Nessuna fattura trovata");
$this->fatture->setWhere(null);
$this->fatture->firstRow();
}
}
public function ChangePage()
{
$newpage = $this->tab_pane->getActivePageName();
switch ($newpage)
{
case "tab1":
// If display master, enable all toolbar buttons
$this->toolbar->buttons->new->enable();
$this->toolbar->buttons->save->enable();
$this->toolbar->buttons->delete->enable();
$this->toolbar->buttons->print->enable();
// force to redesign toolbar
$this->toolbar->redesign();
break;
case "tab2":
// If display detail, disable some master table buttons
$this->toolbar->buttons->new->disable();
$this->toolbar->buttons->save->disable();
$this->toolbar->buttons->delete->disable();
$this->toolbar->buttons->print->disable();
// force to redesign toolbar
$this->toolbar->redesign();
// Go to first row and fill fieldset
$this->setFocus($this->dett_prestazioni->fields->Descrizione);
$this->dett_prestazioni->firstRow();
break;
}
}
public function print_doc()
// Function to print selected invoice with ezPdf class
{
require('class.ezpdf.php');
$pdf = new Cezpdf('a4','portrait');
// Select font family
$pdf->selectFont($_SERVER['DOCUMENT_ROOT'].P4A_APPLICATION_PATH.
'/libraries/fonts/Helvetica.afm');
// Define some usefull styling tags (like html)
$tmp = array(
'b'=>'Helvetica-Bold.afm'
,'i'=>'Helvetica-Oblique.afm'
,'bi'=>'Helvetica-BoldOblique.afm'
,'ib'=>'Helvetica-BoldOblique.afm'
,'bb'=>'Helvetica-Bold.afm');
$pdf->setFontFamily("Helvetica.afm",$tmp);
$db = p4a_db::singleton();
// Get from db header information
$headerpdf=$db->getAll("SELECT Ragione_sociale, Indirizzo,
CONCAT('Tel: ',Telefono),
CONCAT('Fax: ',Fax),
CONCAT('Email: ',email),
CONCAT('C.F.: ',CF),
CONCAT('P.IVA: ',PIVA),
CONCAT('Banca: ',Dati_bancari)
FROM intestazione");
// Define xy init set up values
$x=65;
$y=820;
$pdf->ezSetY($y);
// Cycle through fields and print header
foreach($headerpdf[0] as $key => $value){
$pdf->ezSetY($y);
$pdf->ezText($value,10,array('aleft'=>$x,'justification'=>'left'));
$y-=10;
}
// Retrieve actual customer's id
$actualIdCliente = $this->fatture->fields->ID_cliente->getNewValue();
// Get customer's data from db
$invoiceData = $db->getAll("SELECT Ragione_sociale, indirizzo,
CONCAT_WS(' - ', CAP, Citta, Provincia),
PIVA, CF
FROM clienti
WHERE ID = '$actualIdCliente'");
$y-=20;
$pdf->ezSetY($y);
$pdf->ezText("Spett.le ",10,array('aleft'=>'300',
'justification'=>'left'));
$x=350;
// Cycle through fields and print data
foreach($invoiceData[0] as $key => $value){
$pdf->ezSetY($y);
$pdf->ezText($value,10,array('aleft'=>$x,'justification'=>'left'));
$y-=10;
}
// Print invoice number and date (we have it!)
$numDateInvoice = "Fattura n. <b>".
$this->fields->Num_fattura->getValue().
"</b> del <b><i>".
$this->fields->Data_fattura->getNewValue().
"</i></b>";
$x=65;
$y-=20;
$pdf->ezSetY($y);
$pdf->ezText($numDateInvoice,10,array('aleft'=>$x,
'justification'=>'left'));
// Retrieve actual invoice id
$actualIdFattura = $this->fatture->fields->ID->getNewValue();
// Get invoice detail items from db
$detInvoiceData = $db->getAll("SELECT Descrizione, Importo,
CONCAT(Aliquota_IVA,'%')
FROM prestazioni
WHERE ID_Fattura = '$actualIdFattura'");
// Print header fields name
$y-=30;
$pdf->ezSetY($y);
$pdf->ezText("Descrizione",12,array('aleft'=>'65',
'justification'=>'left'));
$pdf->ezSetY($y);
$pdf->ezText("Importo",12,array('aleft'=>'415', 'aright'=>'485',
'justification'=>'right'));
$pdf->ezSetY($y);
$pdf->ezText("IVA",12,array('aleft'=>'515',
'justification'=>'left'));
$y-=15;
$pdf->line(65,$y,540,$y);
$x=65;
$y-=10;
// Cycle through records and fields and print data
foreach($detInvoiceData as $row){
foreach($row as $key => $value){
$pdf->ezSetY($y);
if($key=="Importo"){
//format price with 2 decimals
$formattedValue = sprintf("%01.2f", $value);
$pdf->ezText($formattedValue,10,array('aleft'=>$x,
'aright'=>$x+70,'justification'=>'right'));
}
else{
$pdf->ezText($value,10,array('aleft'=>$x,
'justification'=>'left'));
}
if($x==65)
$x+=350;
else
$x+=100;
}
$x=65;
$y-=10;
}
// Get total amount price and tax with an aggregation query
$totPriceInvoice = $db->getAll( "SELECT fatture.ID,
SUM( prestazioni.importo) AS TotaleImponibile,
SUM( prestazioni.importo * (prestazioni.Aliquota_IVA /100)) AS TotaleIVA,
SUM(prestazioni.importo * (1 + (prestazioni.Aliquota_IVA /100))) AS Totale
FROM fatture
RIGHT JOIN prestazioni ON fatture.ID = prestazioni.ID_fattura
GROUP BY fatture.ID HAVING fatture.ID='$actualIdFattura'");
$y-=25;
$pdf->line(65,$y,540,$y);
// Print a summary with total price without tax, total tax,
// and total price including tax.
$y-=50;
$pdf->ezSetY($y);
$pdf->ezText('<b>Totale imponibile</b>',
10,array('aleft'=>'300',
'justification'=>'left'));
$pdf->ezSetY($y);
$formattedValue = sprintf("%01.2f",$totPriceInvoice[0]['TotaleImponibile']);
$pdf->ezText("<b>".$formattedValue."</b>",10,
array('aleft'=>'415','aright'=>'485',
'justification'=>'right'));
$y-=12;
$pdf->ezSetY($y);
$pdf->ezText('<b>Totale IVA</b>',10,array('aleft'=>'300',
'justification'=>'left'));
$pdf->ezSetY($y);
$formattedValue = sprintf("%01.2f",$totPriceInvoice[0]['TotaleIVA']);
$pdf->ezText("<b>".$formattedValue."</b>",10,
array('aleft'=>'415','aright'=>'485',
'justification'=>'right'));
$y-=12;
$pdf->ezSetY($y);
$pdf->ezText('<b>Totale fattura</b>',10,
array('aleft'=>'300',
'justification'=>'left'));
$pdf->ezSetY($y);
$formattedValue = sprintf("%01.2f",$totPriceInvoice[0]['Totale']);
$pdf->ezText("<b>".$formattedValue."</b>",10,
array('aleft'=>'415','aright'=>'485',
'justification'=>'right'));
// Send pdf to file
$filename = 'fattura.pdf';
$pdfcode = $pdf->output(1); // data stream without header
P4A_Output_File($pdfcode,$filename);
}
}
Come è possibile notare ho potuto lasciare gran parte del codice
invariato, però sono riuscito a diminuire le istruzioni. Ho eliminato gran
parte della formattazione degli output in tabella e nei fieldset grazie ad un
più facile riconoscimento dei tipi del db source. Per questo motivo ho anche
cambiato, nell'archivio MySQL, il tipo della data da timestamp a
date . Altra facilitazione è data dalla costruzione automatica
del frame principale. Infine, è interessante la possibilità di utilizzare
la funzione P4A_Output_File() che permette di generare un file
temporaneo e reinderizzarlo al browser in un processo separato, davvero
comodo per generare i report PDF!
Note:
L'utilizzo della funzione P4A_Output_File() generava un
piccolo problema sui server Windows, a causa di una incorretta traduzione
degli slash in controslash. Il problema è stato già risolto nell'attuale versione 2.99.9. Per ottenere il corretto
funzionamento però, è necessario prelevare anche il seguente sorgente
dal SVN: p4a_db.php rev. 1762 che risolve un problema relativo agli apici usati nelle query, che affligge la 2.99.9. In alternativa si deve aspettare il nuovo imminente rilascio. E' importante sottolineare che si tratta di versioni "preview", ovviamente non sono ancora perfette e si consiglia di monitorare il forum per eventuali bugs e relative correzioni. Le "preview" servono proprio a questo!
Un ultimo piccolo particolare che non sono riuscito per ora a risolvere: il file PDF temporaneo non viene cancellato alla fine della sessione, probabilmente ho sbagliato qualcosa io... cercherò di risolverlo presto!
Download
Il pacchetto completo delle librerie per la generazione del PDF, i file .sql per il database e tutti i sorgenti e l'albero delle directory è scaricabile qui.
Conclusioni:
Lungi da me pensare di aver imparato a lavorare con il nuovo framework, il primo approccio è stato molto più semplice del previsto! Bisogna comunque studiarlo ancora bene, e generare tanta documentazione. Credo che sia uno sforzo al quale tutti gli utilizzatori del lavoro di Balliano e Giardina debbano fare. Ho approcciato la vecchia versione quando ormai c'era già parecchia documentazione sul forum e ho imparato in fretta parecchie cose. Adesso però, è necessario ricominciare, non da capo... diciamo da tre (citando l'indimenticabile Troisi!) e produrre codice e documentazione, tutti insieme per la crescita del framework.
Riferimenti ed approfondimenti:
Scrivi un commento