Guide de mise en forme dans les modèles Word
Lors de la génération de documents, vous devrez peut-être appliquer une mise en forme spécifique au contenu généré dynamiquement, comme la mise en forme des dates, la transformation de la casse du texte ou l'application de formats numériques. PDF4me offre des fonctionnalités de mise en forme puissantes permettant de contrôler l'apparence des données dans les documents générés.
Syntaxe de formatage de base
La syntaxe fondamentale pour appliquer une mise en forme aux champs de fusion :
<<[token]:"format">>La spécification de format est placée après le nom du champ, séparée par un deux-points et placée entre guillemets.
Formatage de chaînes
Transformez et mettez en forme le contenu textuel à l'aide des options de mise en forme de chaînes suivantes :
Transformation de la casse du texte
Haut de casse - Convertit la chaîne entière en majuscules
Syntaxe: <<[token]:upper>>
Exemple: <<[name]:upper>> → "JOHN SMITH"
Mettre les mots en majuscules - Met une majuscule à la première lettre de chaque mot
Syntaxe: <<[token]:caps>>
Exemple: <<[companyName]:caps>> → « Solutions PDF4ME »
Majuscule à la première lettre - Ne met en majuscule que la première lettre de la chaîne
Syntaxe: <<[token]:firstCap>>
Exemple: <<[sentence]:firstCap>> → "Ceci est une phrase."
Exemples de formatage de chaînes de caractères
Modèle:
Customer Name: <<[customerName]:upper>>
Product Title: <<[productName]:caps>>
Description: <<[description]:firstCap>>
Données:
{
"customerName": "john smith",
"productName": "premium software package",
"description": "this is a premium product."
}
Sortir:
Customer Name: JOHN SMITH
Product Title: Premium Software Package
Description: This is a premium product.
Formatage de la date et de l'heure
Mettez en forme les valeurs de date et d'heure à l'aide de modèles personnalisés pour afficher les dates dans le format de votre choix.
Modèles courants de format de date
Date complète avec heure
Syntaxe: <<[token]:"dd MMM yy H:mm:ss">>
Exemple: <<[date]:"dd MMM yy H:mm:ss">> → "15 déc. 12 10:10:21"
Format de date standard
Syntaxe: <<[token]:"dd-MM-yyyy">>
Exemple: <<[invoiceDate]:"dd-MM-yyyy">> → "15-12-2022"
Format de date européen
Syntaxe: <<[token]:"dd.MM.yyyy">>
Exemple: <<[invoiceDate]:"dd.MM.yyyy">> → "15.12.2022"
Format de date américain
Syntaxe: <<[token]:"MM/dd/yyyy">>
Exemple: <<[date]:"MM/dd/yyyy">> → "15/12/2022"
Format de date ISO
Syntaxe: <<[token]:"yyyy-MM-dd">>
Exemple: <<[date]:"yyyy-MM-dd">> → "2022-12-15"
Format de date longue
Syntaxe: <<[token]:"MMMM dd, yyyy">>
Exemple: <<[date]:"MMMM dd, yyyy">> → "15 décembre 2022"
Rendez-vous court avec l'heure
Syntaxe: <<[token]:"dd/MM/yyyy HH:mm">>
Exemple: <<[timestamp]:"dd/MM/yyyy HH:mm">> → "15/12/2022 14:30"
Exemple de formatage de date
Modèle:
Invoice Date: <<[invoiceDate]:"dd.MM.yyyy">>
Due Date: <<[dueDate]:"MMMM dd, yyyy">>
Timestamp: <<[createdAt]:"dd MMM yy H:mm:ss">>
Données:
{
"invoiceDate": "2022/09/12",
"dueDate": "2022/10/12",
"createdAt": "2022/09/12 10:30:45"
}
Sortir:
Invoice Date: 12.09.2022
Due Date: October 12, 2022
Timestamp: 12 Sep 22 10:30:45
Composants du format de date
Comprendre les composants d'un format de date vous aide à créer des formats de date personnalisés :
| Composant | Description | Exemple |
|---|---|---|
d | Jour (1-31) | 5, 15, 28 |
dd | Jour (01-31) | 05, 15, 28 |
M | Mois (1-12) | 3, 9, 12 |
MM | Mois (01-12) | 03, 09, 12 |
MMM | Abréviation du mois | Jan, Sep, Dec |
MMMM | Nom complet du mois | January, September, December |
yy | Année (2 chiffres) | 22, 23 |
yyyy | Année (4 chiffres) | 2022, 2023 |
H | Heure (0-23) | 0, 14, 23 |
HH | Heure (00-23) | 00, 14, 23 |
h | Heure (1-12) | 1, 6, 12 |
hh | Heure (01-12) | 01, 06, 12 |
m | Minute (0-59) | 5, 30, 59 |
mm | Minute (00-59) | 05, 30, 59 |
s | Deuxième (0-59) | 5, 30, 59 |
ss | Deuxième (00-59) | 05, 30, 59 |
tt | AM/PM | AM, PM |
Formatage des nombres
Bien que cela ne soit pas explicitement montré dans les exemples de base, la mise en forme des nombres suit des modèles similaires :
Format de la devise :
Amount: <<[amount]:"C2">>
Nombre de décimales :
Value: <<[value]:"F2">>
Pourcentage:
Rate: <<[rate]:"P1">>
Combinaison de formats et d'expressions
La mise en forme peut être combinée avec des méthodes d'énumération et des expressions :
Exemple:
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">>
Cas d'utilisation pratiques
Exemple de facture
Modèle:
Invoice #: <<[invoiceNumber]:upper>>
Date: <<[invoiceDate]:"dd.MM.yyyy">>
Company: <<[companyName]:caps>>
Total Amount: $<<[totalAmount]:"F2">>
Exemple d'en-tête de rapport
Modèle:
Report Generated: <<[generatedDate]:"MMMM dd, yyyy 'at' HH:mm:ss">>
Generated By: <<[userName]:caps>>
Period: <<[startDate]:"MMM yyyy">> - <<[endDate]:"MMM yyyy">>
Meilleures pratiques
- Formats de date cohérents - Utilisez le même format de date dans tout le document.
- Considérations relatives au lieu - Choisissez des formats de date adaptés à votre public
- Formatage de test - Vérifier les formats avec les données réelles avant la production
- Transformations de chaînes - Appliquez judicieusement la mise en forme des chaînes de caractères pour en préserver la lisibilité.
- Précision numérique - Utilisez le nombre de décimales approprié pour les valeurs monétaires et numériques
:::conseil Test de formatage
Testez toujours votre formatage avec des exemples de données incluant des cas limites tels que des valeurs nulles, des chaînes de caractères très longues ou des dates dans différents formats afin de garantir un résultat cohérent.
:::