🔁 Vorlagen auf die v6-Platzhalter-Syntax migrieren

Mit v6 haben wir die Owner- und User-Platzhalter neu benannt, damit sie direkt den internen HubSpot-Property-Namen entsprechen. Deine bestehenden Vorlagen funktionieren weiterhin – aber ein einmaliges Umstellen lohnt sich, weil die neue Syntax konsistenter und flexibler ist.

✅ Mapping der Platzhalter

<object>.ownerfirstname → <object>.owner.hs_given_name
<object>.ownerlastname → <object>.owner.hs_family_name
<object>.owneremail → <object>.owner.hs_email
<object>.ownerphone → <object>.owner.hs_main_phone
<object>.ownerjobtitle → <object>.owner.hs_job_title
currentuser.firstname/lastname/email/phone/jobtitle → currentuser.hs_given_name/hs_family_name/hs_email/hs_main_phone/hs_job_title

Labels und Formatierungen bleiben erhalten – z. B. wird aus [company(Primary).owneremail(format:upper)] einfach [company(Primary).owner.hs_email(format:upper)].

✅ Bestehende Vorlagen bleiben lauffähig

Beim Generieren eines Dokuments werden alte Platzhalter nur für dieses Dokument übersetzt – die Vorlagendatei selbst wird nicht verändert. Du kannst also in Ruhe entscheiden, wann du umstellst.

🔁 Automatische Migration über den "Migrate templates"-Banner

Sobald die Card erkennt, dass Vorlagen mit alter Owner- oder User-Syntax existieren, erscheint auf der Card ein "Migrate templates"-Banner.

Klick auf "Migrate templates".
ChiliDocs schreibt die betroffenen .docx-Dateien im HubSpot-Filemanager neu – gleiche Datei, gleicher Link, nur mit aktualisierten Platzhaltern.
Die Originale werden in einem Unterordner "Archive_YYYYMMDD" des ChiliDocs-Verzeichnisses abgelegt. Dieser Archiv-Ordner erscheint nicht in der Vorlagen-Auswahl.
Am Ende meldet die Card die Anzahl der migrierten und (falls vorhanden) fehlgeschlagenen Dateien.

💡 Hinweise

Der Banner migriert nur die Vorlagen, die auf der aktuellen Record-Art sichtbar sind. Vorlagen in Pipeline-Ordnern anderer Objekte migrierst du jeweils von einem Record dieses Objekts aus.
Grosse Bibliotheken brauchen eventuell mehrere Klicks – die Migration stoppt nach ca. 90 Sekunden und du startest sie einfach erneut.
Wenn eine einzelne Vorlage fehlschlägt, wird sie nicht verändert. Öffne die Datei und passe die aufgelisteten Platzhalter manuell an.

➡️ Verwandte Artikel

🔁 Vorlagen auf die v6-Platzhalter-Syntax migrieren

In v6 wurden die Owner- und User-Platzhalter neu benannt. Deine bestehenden Vorlagen funktionieren weiter – mit einem Klick migrierst du sie dauerhaft auf die neue Syntax.