Formattazione nei modelli di Word - Guida allo stile
Durante la generazione del documento, potrebbe essere necessario applicare una formattazione specifica ai contenuti inseriti dinamicamente, come la formattazione delle date, la conversione del maiuscolo/minuscolo del testo o l'applicazione di formati numerici. PDF4me Offre potenti funzionalità di formattazione per controllare l'aspetto dei dati nei documenti generati.
Sintassi di formattazione di base
La sintassi fondamentale per applicare la formattazione all'unione dei campi:
<<[token]:"format">>La specifica del formato viene inserita dopo il nome del campo, separata da due punti e racchiusa tra virgolette.
Formattazione delle stringhe
Trasforma e formatta il contenuto testuale utilizzando le seguenti opzioni di formattazione delle stringhe:
Trasformazione del testo in maiuscolo/minuscolo
Maiuscolo - Converte l'intera stringa in maiuscolo
Sintassi: <<[token]:upper>>
Esempio: <<[name]:upper>> → "JOHN SMITH"
Scrivere le parole con la lettera maiuscola - Mette in maiuscolo la prima lettera di ogni parola
Sintassi: <<[token]:caps>>
Esempio: <<[companyName]:caps>> → "Soluzioni Pdf4me"
Inizia con la lettera maiuscola - Mette in maiuscolo solo la prima lettera della stringa
Sintassi: <<[token]:firstCap>>
Esempio: <<[sentence]:firstCap>> → "Questa è una frase."
Esempi di formattazione delle stringhe
Modello:
Customer Name: <<[customerName]:upper>>
Product Title: <<[productName]:caps>>
Description: <<[description]:firstCap>>
Dati:
{
"customerName": "john smith",
"productName": "premium software package",
"description": "this is a premium product."
}
Produzione:
Customer Name: JOHN SMITH
Product Title: Premium Software Package
Description: This is a premium product.
Formattazione di data e ora
Formatta i valori di data e ora utilizzando modelli personalizzati per visualizzare le date nel formato che preferisci.
Modelli comuni di formato data
Data completa con orario
Sintassi: <<[token]:"dd MMM yy H:mm:ss">>
Esempio: <<[date]:"dd MMM yy H:mm:ss">> → "15 dic 12 10:10:21"
Formato data standard
Sintassi: <<[token]:"dd-MM-yyyy">>
Esempio: <<[invoiceDate]:"dd-MM-yyyy">> → "15-12-2022"
Formato data europeo
Sintassi: <<[token]:"dd.MM.yyyy">>
Esempio: <<[invoiceDate]:"dd.MM.yyyy">> → "15.12.2022"
Formato data USA
Sintassi: <<[token]:"MM/dd/yyyy">>
Esempio: <<[date]:"MM/dd/yyyy">> → "15/12/2022"
Formato data ISO
Sintassi: <<[token]:"yyyy-MM-dd">>
Esempio: <<[date]:"yyyy-MM-dd">> → "2022-12-15"
Formato data esteso
Sintassi: <<[token]:"MMMM dd, yyyy">>
Esempio: <<[date]:"MMMM dd, yyyy">> → "15 dicembre 2022"
Appuntamento breve con orario
Sintassi: <<[token]:"dd/MM/yyyy HH:mm">>
Esempio: <<[timestamp]:"dd/MM/yyyy HH:mm">> → "15/12/2022 14:30"
Esempio di formattazione della data
Modello:
Invoice Date: <<[invoiceDate]:"dd.MM.yyyy">>
Due Date: <<[dueDate]:"MMMM dd, yyyy">>
Timestamp: <<[createdAt]:"dd MMM yy H:mm:ss">>
Dati:
{
"invoiceDate": "2022/09/12",
"dueDate": "2022/10/12",
"createdAt": "2022/09/12 10:30:45"
}
Produzione:
Invoice Date: 12.09.2022
Due Date: October 12, 2022
Timestamp: 12 Sep 22 10:30:45
Componenti del formato data
Comprendere i componenti del formato data ti aiuta a creare formati data personalizzati:
| Componente | Descrizione | Esempio |
|---|---|---|
d | Giorno (1-31) | 5, 15, 28 |
dd | Giorno (01-31) | 05, 15, 28 |
M | Mese (1-12) | 3, 9, 12 |
MM | Mese (01-12) | 03, 09, 12 |
MMM | Abbreviazione del mese | Jan, Sep, Dec |
MMMM | Nome completo del mese | January, September, December |
yy | Anno (2 cifre) | 22, 23 |
yyyy | Anno (4 cifre) | 2022, 2023 |
H | Ora (0-23) | 0, 14, 23 |
HH | Ora (00-23) | 00, 14, 23 |
h | Ora (1-12) | 1, 6, 12 |
hh | Ora (01-12) | 01, 06, 12 |
m | Minuto (0-59) | 5, 30, 59 |
mm | Minuto (00-59) | 05, 30, 59 |
s | Secondo (0-59) | 5, 30, 59 |
ss | Secondo (00-59) | 05, 30, 59 |
tt | AM/PM | AM, PM |
Formattazione dei numeri
Sebbene non siano mostrati esplicitamente negli esempi di base, la formattazione dei numeri segue schemi simili:
Formato valuta:
Amount: <<[amount]:"C2">>
Cifre decimali:
Value: <<[value]:"F2">>
Percentuale:
Rate: <<[rate]:"P1">>
Combinazione di formati ed espressioni
La formattazione può essere combinata con metodi di enumerazione ed espressioni:
Esempio:
Average Age: <<[employees.Average(p => p.Age)]:"F1">> years
Total Revenue: <<[orders.Sum(o => o.Total)]:"C2">>
Last Update: <<[updateDate]:"MMMM dd, yyyy 'at' HH:mm">>
Casi d'uso pratici
Esempio di fattura
Modello:
Invoice #: <<[invoiceNumber]:upper>>
Date: <<[invoiceDate]:"dd.MM.yyyy">>
Company: <<[companyName]:caps>>
Total Amount: $<<[totalAmount]:"F2">>
Esempio di intestazione del report
Modello:
Report Generated: <<[generatedDate]:"MMMM dd, yyyy 'at' HH:mm:ss">>
Generated By: <<[userName]:caps>>
Period: <<[startDate]:"MMM yyyy">> - <<[endDate]:"MMM yyyy">>
migliori pratiche
- Formati data coerenti - Utilizzare lo stesso formato data in tutto il documento
- Considerazioni locali - Scegli i formati di data più adatti al tuo pubblico
- Formattazione di prova - Verificare i formati con i dati reali prima della produzione
- Trasformazioni di stringhe - Applicare la formattazione delle stringhe con attenzione per mantenere la leggibilità
- Precisione numerica - Utilizzare il numero di cifre decimali appropriato per i valori monetari e numerici.
:::Suggerimento per il test del formato Verifica sempre la formattazione con dati di esempio che includano casi limite come valori nulli, stringhe molto lunghe o date in formati diversi, per garantire un output coerente.
:::