È possibile creare manualmente i campi o i token di unione utilizzando la seguente sintassi.
<<[NomeCampo]>>
Sarà inoltre possibile aggiungere espressioni condizionali per valutare e aggiungere una particolare opzione di dati in base al risultato della condizione. Vediamo brevemente come queste opzioni possono essere utilizzate per la progettazione di modelli Word per la generazione di documenti.
Espressioni condizionali
L'azione "Genera documenti" in PDF4me consente di utilizzare espressioni condizionali per inserire dati nei modelli. In base allo stato di una condizione, è possibile aggiungere dati dinamici a un documento. È anche possibile combinare espressioni per soddisfare più condizioni prima che vengano inseriti determinati dati.
Sintassi della condizione If else
Sintassi di base di come utilizzare una condizione if-else in un documento -
<<if [condizione1]>> Aggiungi il primo dato <<elseif [condizione2]>> Aggiungi il secondo dato <<else>> Aggiungi il terzo dato <</if>>
Esistono condizioni più avanzate che è possibile applicare. Per saperne di più sulle dichiarazioni condizionali, consulta la sezione dedicata.
Formattazione nei modelli
Durante la generazione di documenti, potrebbe essere necessario applicare una formattazione a un risultato popolato dinamicamente, come ad esempio il valore risultante da un'espressione. Con PDF4me, è possibile applicare facilmente la formattazione ai risultati della condizione o dell'espressione.
La sintassi di base per applicare la formattazione -
<<[token]:"format">>
Per esempio-
Data fattura: <<[invoiceDate]:"gg.MM.aaaa">>
Per conoscere tutte le funzionalità di formattazione , leggi di più sulla formattazione dei modelli Word.
Tabelle nei modelli
Le tabelle sono una componente molto comune della maggior parte dei documenti. Aiutano a visualizzare i dati in modo efficace per facilitarne il confronto, la consultazione o i calcoli. Il generatore di documenti PDF4me è in grado di inserire tabelle nei documenti in base ai dati presenti.
Vediamo alcuni esempi di come si può creare la sintassi della tabella.
Possiamo creare un elenco di prodotti per comprenderlo meglio.
Colonna 1: <<foreach [prodotto in prodotti]>><<[prodotto.nomeprodotto]>> Colonna 2: <<[prodotto.prodotto]:"aaaa.MM.gg">> Colonna 3: <<[prodotto.prezzo]>><</foreach>>
Puoi trovare maggiori informazioni sulle varie strutture delle tabelle nella documentazione relativa alle tabelle.
Aggiungere immagini nei modelli
PDF4me consente anche di inserire immagini nei documenti. La sintassi per le immagini può essere aggiunta durante la fase di progettazione del modello.
Le immagini possono essere aggiunte in due modi.
Utilizzo di un URL di immagine pubblica
<<immagine [imageUrl]>>
I dati possono essere passati alla sintassi sopra riportata nei seguenti modi, rispettivamente:
Con una stringa Base64 di un'immagine
<<immagine [imageBase64]>>
Consulta la documentazione per i dettagli su come aggiungere immagini ai modelli Word, con esempi inclusi.
Inserisci frammenti HTML nei modelli
Ora puoi anche aggiungere direttamente sezioni HTML e formattazione ai modelli per popolare i dati. Puoi utilizzare la seguente sintassi per inserire l'HTML
<<[token] -html>>
Per vedere un esempio , consultare la documentazione sull'inserimento di codice HTML nei modelli Word.
Modello di esempio
Vediamo un esempio rapido da provare. Di seguito è riportato un modello Word di esempio con i relativi dati per provare rapidamente l'azione di generazione del documento. È possibile scaricare il modello Word e utilizzare il file JSON per il modello a scopo di test.
Dati di esempio
{ "VendorName": "PDF4me", "VendorCity":Zurich", "VendorCountry":Switzerland", "VendorCip":8630", "VendorContact":123456", "InvoiceDate":22-08-2022", "CustomerName":John Doe", "CustomerCity":Start City", "CustomerCountry":US", "CustomerCip":3214", "products": [ { "prodctName": "PDF Converter", "value": 2000, "expires": "01/08/2025" }, { "productName": "PDF API", "value": 1250, "expires": "18/02/2029" }, { "productName": "PDF Editor", "value": 1999, "expires": "12/12/2027" } ], "comment":Questo documento è <b>computer generato</b> e non richiede una firma.", }