ESEMPI TAG/TEMPLATE - 1 - newbe

Procediamo

Abbiamo 5 clienti, i primi tre (Gastone, Pluto, Pippo) posseggono una tessera di fedeltà che concede loro particolari sconti, gli altri due (Clarabella e Paperino) sono nuovi clienti e ancora non hanno la tessera.

L'esercitazione che presentiamo si compone di 3 fasi:

• 1 - Preparazione di una fonte di dati
• • 1.1 - Utilizzando 'Microsoft Excel'
  • 1.2 - Utilizzando 'Calc' di OpenOffice.org
• 2 - Preparazione del template
• • 2.1 - Utilizzando 'Microsoft Word'
  • 2.2 - Utilizzando 'Writer' di OpenOffice.org
• 3 - Creazione dei file pdf
• • 3.1 - Utilizzando ZAP PDF Client

1 - Preparazione di una fonte dati

Per testare le funzionalità di ZAP PDF abbiamo bisogno, per prima cosa, di una fonte dati dalla quale estrarre i valori che si sostituiranno poi ai tag della nostra lettera su carta intestata.

ZAP PDF supporta svariati tipi di fonte dati (database, fogli di calcolo, csv, ecc.)* per il nostro primo esercizio utilizzeremo un file .xls di Microsoft Excel, che andiamo a preparare:

1.1 - Utilizzando 'Microsoft Excel':
Aprite Microsoft Excel, aprite un nuovo file cliccando sull'icona 'nouvo file' (segnalata con '1A'), compilate 5 righe della tabella come nella figura qui a lato. Attenzione: riportate anche i nomi delle colonne; sono importanti! Salvate il file con nome "fontedati.xls".

1.2 - Utilizzando 'Calc' di OpenOffice.org:
Per i meno esperti e per coloro i quali non abbiano a disposizione 'Microsoft Excel', presentiamo la stessa soluzione con l'utilizzo di 'Calc', il foglio elettronico (spreadsheet) di OpenOffice.org.** Aprite 'Calc' di OpenOffice.org, aprite un nuovo file cliccando sull'icona 'nuovo file' (2A), compilate 5 righe della tabella come nella figura qui a lato. Attenzione: riportate anche i nomi delle colonne; sono importanti!
Salvate il file con nome "fontedati.xls", seguendo questa procedura: Cliccando sull'icona salva, si aprirà una finestra come quella nell'immagine qui di lato. Inseriamo nella casella 'nome file' (3A)il nome del nostro file: ' fontedati '. Nel menu di scelta 'salva come' (3B) selezioniamo la voce 'Microsoft Excel 97/2000/XP (.xls)' e clicchiamo su 'Salva'.
Il programma potrebbe mostrarvi un'avviso in cui vi si dice che: Alcune formattazioni e stili applicate al file potrebbero non essere rispettate nella creazione di un file in formato '.xls'... ...Siccome a noi, oggi, interessano solo i valori nelle celle del foglio di calcolo, clicchiamo sul bottone 'Yes'.

Abbiamo appena creato la nostra prima fonte di dati !

* ZAP PDF FREE Client supporta solo fonti dati in formato .xls
** Ricordiamo che l'installazione di OpenOffice.org (scaricabile gratuitamente al sito: www.openoffice.org), è indispensabile al funzionamento dei prodotti ZAP PDF.

2 - Preparazione del template

ATENZIONE: questo paragrafo fa riferimento al linguaggio di tag/tamplate per versioni precedenti alla 2.2;
Per le versioni ZapPDF Client 2.2 e successive, fare riferimento al manuale d'uso incluso nella distribuzione.

2.1 - Utilizzando 'Microsoft Word'

Aprite Microsoft Word scegliete 'nuovo file' (4A).

In questa prima fase creiamo una lettera di invito per ognuno dei nostri clienti.

Come avrete notato, in rosso al centro della pagina abbiamo inserito una serie di caratteri particolari: <@cliente@> è il nostro primo tag.

Il tag che abbiamo preso in considerazione è il più semplice da integrare ed è composto da:

• 2 carattere di apertura: '<@' (minore e chiocciola)
• Seguito dal nome del nostro tag (in questo caso 'cliente').
• 2 carattere di chiusura: '@>' (chiocciola e maggiore)

In fase di creazione dei nostri inviti in formato pdf, l'applicazione si occuperà di sostituire, volta per volta, un nuovo valore della colonna 'cliente' al posto del tag <@cliente@>.

Abbiamo fatto il nostro primo template!

Prima di passare alla generazione dei file, vorremmo però introdurre altro due tipi di tag:

• Un tag per gestire le date.
• Il tag condizionales.

Quello che ci proponiamo di fare è un documento, basato su un template (ancora la nostra carta intestata) con il quale comunicare informazioni personalizzate a seconda del destinatario:

Abbiamo visto che solo tre dei nostri cinque clienti hanno la tesserà fedeltà della nostra catena di negozi, e per questo vorremmo premiarli con un regalo; E' vero però, che potremmo approfittare di questa comunicazione per convincere anche gli altri due clienti ad acquistare la tessera fedeltà. Come fare?

In questa immagine il nuovo template con i tag per gestire le date e i tag condizionali, vediamolo nel dettaglio:

Tag Data

Le parentesi graffe ('{}') all'interno dei delimitatori del tag ('<@' per l'apertura, '@>' per la chiusura) racchiudono le chiamate a funzioni interne al motore tag/template di ZAP PDF.

In questo caso, la funzione 'date:dd/MM/yyyy' restituirà la data di creazione del file nel formato:
giorno(2 cifre)/mese(2 cifre)/anno(4 cifre).

Tag condizionale

La struttura di questo tag è molto diversa da quello precedentemente descritto:

• 3 caratteri di apertura: '<?@' (minore, punto interrogativo e chiocciola).
• Seguiti dal nome del nostro tag, in questo caso 'tessera'.
• L'espressione di verifica. Se l'espressione risulta 'vera' il testo condizionale viene scritto sul pdf.
• La frase soggetta al risultato condizionale del tag, racchiusa tra due caratteri '@' (in verde nell'immagine; in questo caso abbiamo voluto inserire, come testo condizionale, il valore del tag 'tessera').
• Di nuovo il nome del tag (per la chiusura).
• 3 caratteri di chiusura: '@?>' (chiocciola, punto interrogativo e maggiore)

Cosa significa?
Significa che, quando il template sarà processato per la creazione dei file pdf, sulla base dei dati provenienti dalla tabella del punto 1, la frase 'numero tessera: <@tessera@>' comparirà solo in quei documenti dove la variabile 'tessera' sarà maggiore di 0; nel nostro caso: negli inviti per Clarabella, Gastone e Pippo.

Il tag successivo amplia le possibilità dei tag condizionali:

L'utilizzo dei tag condizionali ci permette di definire l'inclusione alternativa di due frasi.
La prima frase, racchiusa tra i primi due caratteri '@' (in verde), quando l'espressione di verifica restituisce 'vero'; la seconda, racchiusa tra il terzo e il quarto tag (in verde), quando l'espressione restituisce falso.

Quando la condizione 'numero tessera maggiore di 0' risulterà vera, la frase integrata nel documento sarà 'Un regalo personale per te!'.
Altrimenti 'Acquista la tessera fedeltà, riceverai un fantastico regalo'.

Abbiamo creato il nostro primo template. Pronto per l'utilizzo!

Ora possiamo salvare il documento.
Scegliamo un nome significativo "template.doc" e salviamo.

2.2 -Utilizzando 'Writer' di OpenOffice.org

Potete scrivere un file di template prendendo ad esempio quello descritto al punto 2.1;

ZAP PDF può utilizzare template realizzati con i più diffusi programmi di office automation.

Quindi, create il vostro file con 'Writer' di Openoffice.org e salvatelo in formato .odt o in un qualsiasi formato supportato.

3 - Creazione dei file pdf

Ancora non abbiamo visto l'interfaccia ed i modi d'uso propri del vostro prodotto ZAP PDF.

3.1 - L'interfaccia Windows

vedi ZAP PDF Client uso avanzato:tag/template