14 PDF Maker

14 PDF Maker

Il modulo PDF Maker consente la generazione di documenti PDF che vengono generati con la logica della “stampa e unione” dei dati contenuti in vtenext e di un modello di esportazione.

14 [1].png

14.1 Creare un Template PDF

Per creare un nuovo template per il modulo PDFMaker cliccare sul tasto o sul pulsante a destra CREA TEMPLATE e indicare il nome per il template e il modulo di riferimento: il template sarà disponibile solo per il modulo indicato. Significa che lo troveremo tra le opzioni di Stampa pdf solo se posizionati in quel modulo. Ad esempio se creo un template per stampare inviti ai contatti lo troverò solo all’interno di un’anagrafica nel menù ALTRO, in alto a destra.

14.1 [1].png

Il contenuto del template è organizzato in tre diverse sezioni:

14.1 [2].png

All’interno delle tre aree è possibile inserire:

Testo fisso
E’ possibile inserire del testo fisso all’interno dell’Intestazione, Corpo o Piè di pagina posizionandosi con il cursore e iniziando a scrivere il contenuto:

testo_fisso_pdf.png

Variabili
Per inserire delle variabili, posizionare il cursore in corrispondenza del punto in cui si vuole inserire la variabile, scegliere il tipo di variabile da inserire dalla voce MODULO sopra e quindi cliccare su Inserisci nel template:

14.1 [4].png

Il sistema inserisce una stringa variabile che verrà sostituita con il valore assunto dal campo quando verrà generato il pdf/rtf:

14.1 [5].png

Una volta inserito il testo è possibile formattare il testo fisso e variabile attraverso gli strumento dell’editor.
Tutti i campi presenti sul modulo principale (Modulo) a cui è stato associato il template sono disponibili nel menù a tendina collegato.

E’ possibile inserire variabili anche sui moduli relazionati al modulo principale (Modulo). Sono distinte le variabili di:

14.1 [6].png

14.1 [7].png

Variabili in relazione 1 a 1

Variabili in relazione a molti (blocchi collegati)

Quindi è possibile selezionare uno dei blocchi già esistenti (attenzione controllare che riferiscano al modulo per cui stiamo costruendo il template) oppure attraverso Crea Blocchi collegati avviare la procedura guidata per la creazione di un nuovo blocco:

14.1 [8].pngCliccare su CREA UN BLOCCO COLLEGATO

14.1 [9].png
Scegliere il modulo relazionato del quale si vogliono visualizzare i dati nel pdf

14.1 [10].png
Scegliere i campi che si vogliono visualizzare (dalla colonna di sinistra, con la freccia, portare i campi nella colonna di destra)

14.1 [11].png
Settare, se necessario, un filtro per poter visualizzare il dato desiderato (es.: tutti gli Ordini di vendita in stato Approvato)

14.1 [12].png
Ritoccare la tabella come desiderato e dare un nome al blocco

14.1 [13].png
Terminata la configurazione, il risultato sarà come quello rappresentato in figura

N.B.: i "Campi Tabella" possono essere inseriti in un PDF utilizzando i blocchi collegati.

14.1.1 Inserire immagini nel PDF

Premere il pulsante Immagine dell’editor:

14.1.1 [1].png

URL

inserire l’url dell’immagine (se già presente), se l’URL non è già presente cliccare Cerca sul server per effettuare l’upload di un’immagine

Larghezza /

Altezza

per modificare le dimensioni dell’immagine nel template

blocca le proporzioni altezza-larghezza

reimposta la dimensione originale

Bordo

inserite un valore numerico in pixel corrispondente allo spessore del bordo per l’immagine (vuoto per non avere bordo)

HSpace / VSpace

inserite le coordinate per il posizionamento dell’immagine rispetto alla linea base del testo (vuoto per impostare la posizione di default, in linea con il testo)

 

Allienamento

definite l’allineamento del testo

 

 

14.1.1 [2].png

 

14.1.2 Inserire tabelle nel PDF

Per creare una tabella nel pdf maker, è sufficiente usare l'apposita funzione presente nell'editor ed evidenziata nell'immagine seguente:
14.1.2 [1].png

Quando viene cliccata l'icona di "creazione tabella", si aprirà una finestra di dialogo che ci permetterà di inserire i valori della specifica tabella che intendiamo creare:

14.1.2 [2].png

Dimensione bordo

mettere zero se non si vuole visualizzare il bordo, non viene visualizzato il bordo se impostato un valore superiore a 2.
N.B. Non è possibile cambiare il colore del bordo di una cella 

 

Spaziatura  celle

spazio tra una cella e l’altra

 

Padding cella

spazio tra il bordo della cella e l’inizio del contenuto (testo)

 

Cliccando su OK, la tabella compare nella tab CORPO dell'editor.

14.1.2 [3].pngPer modificare le proprietà della tabella, cliccare tasto destro del mouse. È anche possibile impostare proprietà solo per la cella in cui si trova il cursore.

14.2 Blocco prodotti all’interno dei template PDF

Per i moduli Preventivi, Ordini di vendita, Ordini di acquisto e Fatture è possibile inserire nei template il blocco prodotti. Esistono dei modelli predefiniti di blocco prodotti che possono essere inseriti rapidamente nel template.

Per inserire un blocco prodotti da modello selezionare il tipo di blocco e premere il pulsante Inserisci nel template. Verrà creata la tabella corrispondente al blocco prodotti. E’ possibile personalizzare il blocco successivamente come se si intervenisse su una tabella. E’ possibile creare della tabelle personalizzate per le righe dell’offerta; la struttura di base deve essere del tipo:

intestazione_1

intestazione_2

intestazione_3

intestazione_4

...intestazione_n

#PRODUCTBLOC_START#

       

variabile_1

variabile_2

variabile_3

variabile_4

...variabile_n

#PRODUCTBLOC_END#

       

I tag di inizio e fine blocco si trovano come variabili in:

14.2 [1].PNG

E’ possibile inserire le variabili del blocco prodotti attraverso le funzioni messe a disposizione nel tab Blocco Prodotti:

14.2 [2].png

14.3 Barcode

Attraverso il Tab "Altre informazioni" è possibile inserire dei codici a barre all’interno del template:

14.3 [1].pngE’ possibile inserire un numero fisso oppure una variabile all'interno di questa stringa. Il numero o variabile andranno inseriti al posto di "YOURCODE".

Esempio di risultato:

14.5 Esportazione in formato PDF

Per generare un PDF accedere all’anagrafica del modulo principale (es: Preventivi), cliccando il pulsante Altro, in alto a destra, apparirà il pannello PDFMaker per l’esportazione del documento. Scegliere il modello desiderato e premere Esporta in PDF.

14.5 [1].png

A questo punto il sistema genererà il documento.
E’ possibile generare un PDF unione per più entità: dalla vista elenco selezionare le entità e premere PDF Export:

14.5 [2].PNG

Quindi scegliere il template per l'esportazione massiva:

14.5 [3].PNG

14.6 Immagini prodotto nel PDF

Nei modelli di blocchi prodotto è possibile aggiungere anche le miniature relative alle immagini caricate all’interno della scheda prodotto.

14.6 [1].png

Attenzione! Deve essere inserita nel template l’apposita variabile per l’immagine del prodotto.

14.6 [2(1)].png14.6 [2(2)].png

La variabile $PRODUCTS_IMAGENAME$ deve essere inserita tra i tag #PRODUCTBLOC_START# e #PRODUCTBLOC_END#.

In fase di generazione del PDF cliccare prima sulla voce Immagini prodotto, scegliendo per ogni prodotto l’immagine da inserire nel PDF (si possono selezionare le immagini che intendiamo visualizzare nel pdf). E’ possibile definire le dimensioni dell’immagine in termini di larghezza ed altezza, se uno di questi due valori viene lasciato vuoto il sistema ridimensionerà l’immagine in maniera proporzionale alla misura specificata. Se i due valori sono lasciati vuoti l’immagine sarà stampata con le dimensioni originali.

Attenzione! Non è possibile associare immagini ai servizi.

14.6 [3].png
Seleziona immagini Prodotti ed Esporta in PDF

14.6 [4].png
Finestra di selezione immagini Prodotto

14.6 [5].png
PDF esportato con dettaglio immagini Prodotto

14.7 Funzioni personalizzate in PDF

E’ possibile definire funzioni personalizzate per il trattamento dei dati all’interno del PDF Maker. Per aggiungere una funzione personalizzata posizionare il file php con il codice della funzione all’interno della cartella modules/PDFMaker/function, il file verrà incluso automaticamente.
All’interno della cartella vi è la funzione its4you.php, non modificare questo file, eventuali modifiche verranno sovrascritte al prossimo aggiornamento dell’applicazione.

Per aggiungere una funzione personalizzata al proprio template accedere al tab Altre informazioni e scegliere la funzione desiderata e quindi cliccare su Inserisci nel template:

14.7 [1].PNG

Esempio guida: if-else:
Se si sceglie la funzione if-else verrà aggiunto nel template il seguente testo: [CUSTOMFUNCTION|its4you_if|param1|comparator|param2|return1|return2|- CUSTOMFUNCTION]

Sostituire:
param1 – campo di controllo
comparator – termine di paragone, valori possibili: = , != (diverso), >, < param2 – termine di paragone
return1 - valore da visualizzare se la condizione risulta verificata
return2 – valore da visualizzare se la condizione NON risulta verificata

Vediamo come configurare la funzione in modo che lo sconto finale nel Preventivo venga stampato solo se non nullo:

[CUSTOMFUNCTION|its4you_if|$TOTALDISCOUNT$|!=|0,00|Sconto$TOTALDISCOUNT$ €||CUSTOMFUNCTION]

14.8 Nome del file PDF

Nel tab Impostazioni del PDFMaker è possibile definire il nome del file del pdf in uscita. Questa opzione consente di definire il nome del file in base alle proprie necessità. E’ possibile combinare stringhe di testo, variabili del modulo e variabili standard come il nome del template, data corrente, ecc.

14.8 [1].png

14.9 Esporta/Importa template PDF

E’ possibile importare od esportare in formato XML i template del modulo PDF Maker attraverso gli appositi pulsanti.
Questa funzione è disponibile solamente per gli utenti amministratori del crm.

14.9 [1].PNG