Formatierung in Word-Vorlagen – Gestaltungsleitfaden
Während der Dokumentenerstellung müssen Sie möglicherweise bestimmte Formatierungen auf dynamisch generierte Inhalte anwenden, z. B. Datumsangaben formatieren, die Groß-/Kleinschreibung ändern oder Zahlenformate anwenden. PDF4me bietet leistungsstarke Formatierungsfunktionen, um zu steuern, wie Daten in generierten Dokumenten dargestellt werden.
Grundlegende Formatierungssyntax
Die grundlegende Syntax zum Anwenden von Formatierungen auf Seriendruckfelder:
<<[token]:"format">>Die Formatangabe steht nach dem Feldnamen, getrennt durch einen Doppelpunkt und in Anführungszeichen eingeschlossen.
Zeichenkettenformatierung
Textinhalte mithilfe der folgenden Zeichenkettenformatierungsoptionen transformieren und formatieren:
Textumwandlung
Großbuchstabe - Wandelt die gesamte Zeichenkette in Großbuchstaben um
Syntax: <<[token]:upper>>
Beispiel: <<[name]:upper>> → "JOHN SMITH"
Wörter großschreiben - Der erste Buchstabe jedes Wortes wird großgeschrieben
Syntax: <<[token]:caps>>
Beispiel: <<[companyName]:caps>> → "Pdf4me-Lösungen"
Ersten Buchstaben großschreiben - Schreibt nur den ersten Buchstaben der Zeichenkette groß.
Syntax: <<[token]:firstCap>>
Beispiel: <<[sentence]:firstCap>> → "Dies ist ein Satz."
Beispiele für die Formatierung von Zeichenketten
Vorlage:
Customer Name: <<[customerName]:upper>>
Product Title: <<[productName]:caps>>
Description: <<[description]:firstCap>>
Daten:
{
"customerName": "john smith",
"productName": "premium software package",
"description": "this is a premium product."
}
Ausgabe:
Customer Name: JOHN SMITH
Product Title: Premium Software Package
Description: This is a premium product.
Datums- und Zeitformatierung
Formatieren Sie Datums- und Zeitwerte mithilfe benutzerdefinierter Muster, um Datumsangaben im gewünschten Format anzuzeigen.
Gängige Datumsformatmuster
Vollständiges Datum mit Uhrzeit
Syntax: <<[token]:"dd MMM yy H:mm:ss">>
Beispiel: <<[date]:"dd MMM yy H:mm:ss">> → "15. Dez. 12 10:10:21"
Standard-Datumsformat
Syntax: <<[token]:"dd-MM-yyyy">>
Beispiel: <<[invoiceDate]:"dd-MM-yyyy">> → "15.12.2022"
Europäisches Datumsformat
Syntax: <<[token]:"dd.MM.yyyy">>
Beispiel: <<[invoiceDate]:"dd.MM.yyyy">> → "15.12.2022"
US-Datumsformat
Syntax: <<[token]:"MM/dd/yyyy">>
Beispiel: <<[date]:"MM/dd/yyyy">> → "15.12.2022"
ISO-Datumsformat
Syntax: <<[token]:"yyyy-MM-dd">>
Beispiel: <<[date]:"yyyy-MM-dd">> → "15.12.2022"
Langes Datumsformat
Syntax: <<[token]:"MMMM dd, yyyy">>
Beispiel: <<[date]:"MMMM dd, yyyy">> → „15. Dezember 2022“
Kurzes Date mit Zeit
Syntax: <<[token]:"dd/MM/yyyy HH:mm">>
Beispiel: <<[timestamp]:"dd/MM/yyyy HH:mm">> → "15.12.2022 14:30"
Beispiel für die Datumsformatierung
Vorlage:
Invoice Date: <<[invoiceDate]:"dd.MM.yyyy">>
Due Date: <<[dueDate]:"MMMM dd, yyyy">>
Timestamp: <<[createdAt]:"dd MMM yy H:mm:ss">>
Daten:
{
"invoiceDate": "2022/09/12",
"dueDate": "2022/10/12",
"createdAt": "2022/09/12 10:30:45"
}
Ausgabe:
Invoice Date: 12.09.2022
Due Date: October 12, 2022
Timestamp: 12 Sep 22 10:30:45
Datumsformatkomponenten
Das Verständnis der Komponenten von Datumsformaten hilft Ihnen bei der Erstellung benutzerdefinierter Datumsformate:
| Komponente | Beschreibung | Beispiel |
|---|---|---|
d | Tag (1-31) | 5, 15, 28 |
dd | Tag (01-31) | 05, 15, 28 |
M | Monat (1-12) | 3, 9, 12 |
MM | Monat (01-12) | 03, 09, 12 |
MMM | Monatsabkürzung | Jan, Sep, Dec |
MMMM | vollständiger Monatsname | January, September, December |
yy | Jahr (2-stellig) | 22, 23 |
yyyy | Jahr (4-stellig) | 2022, 2023 |
H | Stunde (0-23) | 0, 14, 23 |
HH | Stunde (00-23) | 00, 14, 23 |
h | Stunde (1-12) | 1, 6, 12 |
hh | Stunde (01-12) | 01, 06, 12 |
m | Minute (0-59) | 5, 30, 59 |
mm | Minute (00-59) | 05, 30, 59 |
s | Zweiter (0-59) | 5, 30, 59 |
ss | Zweite (00-59) | 05, 30, 59 |
tt | AM/PM | AM, PM |
Zahlenformatierung
Auch wenn es in den grundlegenden Beispielen nicht explizit gezeigt wird, folgt die Zahlenformatierung ähnlichen Mustern:
Währungsformat:
Amount: <<[amount]:"C2">>
Dezimalstellen:
Value: <<[value]:"F2">>
Prozentsatz:
Rate: <<[rate]:"P1">>
Formate mit Ausdrücken kombinieren
Formatierungen können mit Aufzählungsmethoden und Ausdrücken kombiniert werden:
Beispiel:
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">>
Praktische Anwendungsfälle
Rechnungsbeispiel
Vorlage:
Invoice #: <<[invoiceNumber]:upper>>
Date: <<[invoiceDate]:"dd.MM.yyyy">>
Company: <<[companyName]:caps>>
Total Amount: $<<[totalAmount]:"F2">>
Beispiel für einen Berichtskopf
Vorlage:
Report Generated: <<[generatedDate]:"MMMM dd, yyyy 'at' HH:mm:ss">>
Generated By: <<[userName]:caps>>
Period: <<[startDate]:"MMM yyyy">> - <<[endDate]:"MMM yyyy">>
Bewährte Verfahren
- Einheitliche Datumsformate - Verwenden Sie im gesamten Dokument dasselbe Datumsformat.
- Lokale Gegebenheiten Wählen Sie Datumsformate, die für Ihre Zielgruppe geeignet sind.
- Testformatierung - Formate vor der Produktion mit realen Daten überprüfen
- String-Transformationen - Setzen Sie die Zeichenkettenformatierung mit Bedacht ein, um die Lesbarkeit zu erhalten.
- Genauigkeit der Zahlen - Verwenden Sie für Geld- und Zahlenwerte die entsprechende Anzahl an Dezimalstellen.
:::Tipp: Formatprüfung Testen Sie Ihre Formatierung immer mit Beispieldaten, die Sonderfälle wie Nullwerte, sehr lange Zeichenketten oder Datumsangaben in verschiedenen Formaten enthalten, um eine konsistente Ausgabe zu gewährleisten.
:::