Text-Formatierungen, Zahlen-Formatierungen und Standardwerte

Du kannst Text und Zahlen formatieren und Ersatzwerte direkt in deinen Platzhaltern festlegen. Dies hilft dir zu kontrollieren, wie Daten in deinen Dokumenten erscheinen, ohne die Quelldaten zu ändern.

Einheitliche Syntax

Alle Modifikatoren verwenden ein Pipe-Trennzeichen (|) für einfaches Verketten:

{{property | modifier}}
{{property | modifier:argument}}
{{property | modifier1 | modifier2 | default:'fallback'}}

Text-Formatierungen

Transformiere Textwerte in deinen Dokumenten.

Großbuchstaben

Konvertiere Text in Großbuchstaben.

{{firstname | uppercase}}

Beispiel:

Eingabe: john
Ausgabe: JOHN

Kleinbuchstaben

Konvertiere Text in Kleinbuchstaben.

{{lastname | lowercase}}

Beispiel:

Eingabe: DOE
Ausgabe: doe

Titelschreibweise

Schreibe den ersten Buchstaben jedes Wortes groß.

{{company | titlecase}}

Beispiel:

Eingabe: acme corporation
Ausgabe: Acme Corporation

Abschneiden

Kürze Text auf eine bestimmte Anzahl von Zeichen. Fügt drei Punkte (...) am Ende hinzu.

{{description | truncate:100}}

Die Zahl nach truncate: ist die maximale Zeichenanzahl.

Beispiel:

Eingabe: Dies ist eine sehr lange Beschreibung, die immer weitergeht...
Mit truncate:20: Dies ist eine sehr ...

Wenn dein Text kürzer als die Abschneidegrenze ist, bleibt er unverändert. Es werden keine Punkte hinzugefügt.

Zahlen-Formatierungen

Formatiere numerische Werte als Währung, Prozentsätze, Ordnungszahlen oder Telefonnummern.

Währung

Formatiere eine Zahl als Währung mit richtigem Symbol und Tausendertrennzeichen.

{{amount | currency:USD}}
{{revenue | currency:EUR}}
{{price | currency:GBP}}

Der Währungscode folgt dem ISO 4217-Standard (USD, EUR, GBP, etc.).

Beispiele:

1500 mit currency:USD → $1,500.00
1234.56 mit currency:EUR → €1,234.56

Die Währungsformatierung verwendet die Locale-Einstellungen deiner Organisation, um die Symbolposition und Zahlenformatierung (Kommas vs. Punkte) zu bestimmen.

Ordnungszahl

Konvertiere eine Zahl in ihre ordinale Form (1., 2., 3., etc.).

{{position | ordinal}}
{{rank | ordinal}}

Beispiele:

1 → 1st
2 → 2nd
3 → 3rd
11 → 11th
21 → 21st

Prozent

Formatiere einen Dezimalwert als Prozentsatz.

{{rate | percent}}
{{discount | percent}}

Beispiele:

0.25 → 25%
0.075 → 7.5%
1.5 → 150%

Die Prozent-Formatierung erwartet einen Dezimalwert. Also sollten 25% als 0.25 gespeichert werden, nicht als 25.

Telefon

Formatiere eine Telefonnummer für bessere Lesbarkeit.

{{phone | phone}}
{{mobile | phone}}

Beispiele:

5551234567 → (555) 123-4567
+14155551234 → +1 (415) 555-1234

Bild-Formatierungen

Kontrolliere die Abmessungen von Bildern aus HubSpot-Datei-Properties in deinen generierten Dokumenten.

Breite und Höhe

Setze benutzerdefinierte Abmessungen für Datei-Properties, die Bilder enthalten.

{{image_property | width:200}}
{{logo_file | height:150}}
{{photo | width:300 | height:200}}

Parameter:

width: Setze Bildbreite in Pixeln (10-2000)
height: Setze Bildhöhe in Pixeln (10-2000)

Beispiele:

{{company_logo | width:250}} - Setzt Logo-Breite auf 250px, Höhe skaliert automatisch
{{product_image | width:400 | height:300}} - Setzt sowohl Breite als auch Höhe
{{headshot | height:200}} - Setzt Höhe auf 200px, Breite skaliert automatisch

Wenn du nur Breite oder Höhe setzt, behält das Bild sein Seitenverhältnis bei. Das Setzen von sowohl Breite als auch Höhe erzwingt exakte Abmessungen, was das Bild verzerren kann.

Wie es funktioniert

Template Builder: Konfiguriere Breite und Höhe in Schritt 2 bei der Auswahl einer Datei-Property
Platzhalter generiert: Der Builder erstellt {{property | width:X | height:Y}}
Dokumentengenerierung: Bilder werden mit deinen angegebenen Abmessungen eingebettet

Anwendungsfälle

Firmenlogos

{{company_logo | width:200}}

Stelle sicher, dass alle Logos in einer einheitlichen Größe erscheinen, unabhängig von den Quelldatei-Abmessungen.

Produktbilder

{{product_photo | width:300 | height:300}}

Erstelle einheitliche Bildraster in Katalogen oder Produktblättern.

Profilfotos

{{contact_photo | height:150}}

Behalte konsistente Höhen für Kontaktprofile bei, während das Seitenverhältnis erhalten bleibt.

Bildabmessungen überschreiben alle in der Datenbank gespeicherten Standard-Abmessungen. Wenn beide existieren, haben die Platzhalter-Abmessungen Vorrang.

Rückwärtskompatibilität

Templates, die vor diesem Feature erstellt wurden, funktionieren weiterhin ohne Änderungen:

Alte Templates verwenden datenbankgespeicherte Abmessungen (falls konfiguriert)
Neue Templates verwenden Platzhalter-Syntax für Abmessungen
Du kannst beide Ansätze in derselben Organisation mischen

Standardwerte

Setze einen Ersatzwert, wenn eine Property leer ist oder fehlt. Verwende das Pipe-Symbol gefolgt von default:.

Festen Text verwenden

Setze deinen Ersatztext in Anführungszeichen (einfach oder doppelt).

{{phone | default:'N/V'}}
{{email | default:"Nicht angegeben"}}

Beispiel:

Wenn phone leer ist: Zeigt N/V
Wenn phone einen Wert hat: Zeigt die Telefonnummer

Eine andere Property verwenden

Verweise auf eine andere Property als Ersatz (keine Anführungszeichen erforderlich).

{{company | default:firstname}}

Beispiel:

Wenn company leer ist, aber firstname ist John: Zeigt John
Wenn beide leer sind: Zeigt nichts

Property-Referenzen sind hilfreich, wenn du Backup-Felder hast. Verwende zum Beispiel einen Spitznamen, wenn der Vorname fehlt.

Mehrere Modifikatoren verketten

Du kannst mehrere Modifikatoren mit Pipes kombinieren. Sie werden von links nach rechts in der Reihenfolge angewendet.

{{name | uppercase | truncate:50 | default:'UNBEKANNTER KUNDE'}}

Wie es funktioniert (von links nach rechts):

uppercase wird auf den Wert von name angewendet
truncate:50 kürzt das Ergebnis bei Bedarf
default:'UNBEKANNTER KUNDE' liefert einen Ersatzwert, wenn der Wert leer ist

Beispiele:

name ist john doe: Ergebnis ist JOHN DOE
name ist leer: Ergebnis ist UNBEKANNTER KUNDE

{{revenue | currency:USD | default:'$0.00'}}

Syntax-Optionen

Neue einheitliche Pipe-Syntax (Empfohlen)

{{firstname | uppercase}}
{{phone | default:'N/V'}}
{{amount | currency:EUR}}
{{text | uppercase | truncate:100}}

Legacy-Doppelpunkt-Syntax (Noch unterstützt)

Aus Kompatibilitätsgründen funktioniert die ältere Doppelpunkt-Syntax noch für Text-Formatierungen:

{{firstname:uppercase}}
{{description:truncate:100}}

Beide Syntaxen können gemischt werden:

{{name:uppercase | default:'N/V'}}

Häufige Anwendungsfälle

Geschäftsdokumente

Formatiere Firmennamen konsistent:

{{company | titlecase | default:'Privatkunde'}}

Kontaktinformationen

Behandle fehlende Telefonnummern mit Formatierung:

{{phone | phone | default:'Keine Telefonnummer hinterlegt'}}

Finanzdokumente

Zeige Beträge als Währung an:

Gesamt: {{amount | currency:USD}}
Rabatt: {{discount_rate | percent}}

Ranglisten und Positionen

Zeige Ordnungszahlen an:

{{position | ordinal}} Platz Gewinner

Etiketten und Versand

Stelle Großbuchstaben für Postanschriften sicher:

{{city | uppercase}}, {{state | uppercase}} {{zip}}

Produktbeschreibungen

Halte Beschreibungen auf lesbare Länge:

{{product_description | truncate:150}}

Häufig gestellte Fragen

F: Was passiert, wenn ich eine unbekannte Formatierung verwende? A: Unbekannte Formatierungen werden ignoriert. Dein Text erscheint unverändert.

F: Kann ich mehrere Formatierungen verwenden? A: Ja! Verkette sie mit Pipes: {{name | uppercase | truncate:50}}

F: Wird die Formatierung auch auf den Standardwert angewendet? A: Ja. Bei Verwendung von Formatierung und Standard wird die Formatierung auf den verwendeten Wert angewendet (das Original oder der Standard).

F: Kann ich Formatierungen mit QR Codes oder Barcodes verwenden? A: QR Codes und Barcodes haben ihre eigenen Modifikatoren (size und format). Text-/Zahlen-Formatierungen gelten nicht für sie, aber du kannst die Pipe-Syntax für die Größe verwenden: {{qr:property | size:200}}

F: Kann ich Text-Formatierungen auf Datei-Properties anwenden? A: Nein. Datei-Properties unterstützen nur die Formatierungen width und height zur Kontrolle der Bildabmessungen. Text-/Zahlen-Formatierungen werden für Datei-Properties ignoriert.

F: Wie behandelt die Währungsformatierung unterschiedliche Locales? A: Die Währungssymbolposition und Zahlenformatierung (Kommas vs. Punkte) werden durch die Locale-Einstellungen deiner Organisation bestimmt.

F: Kann ich eine Zahl formatieren, die als Text gespeichert ist? A: Ja, die Zahlen-Formatierungen versuchen, Textwerte als Zahlen zu parsen. Werte wie "1500" oder "1,500" werden erkannt.