Fehlerbehebung

Häufige Probleme

Diese Seite behandelt Lösungen für die am häufigsten auftretenden Probleme bei der Verwendung von PDF CreateMate.

Eigenschaften werden nicht ersetzt

Problem: Deine Platzhalter wie {{firstname}} erscheinen im generierten PDF anstelle von tatsächlichen Werten.

Lösungen:

  1. Platzhalter-Syntax überprüfen

    • Verwende doppelte geschweifte Klammern {{propertyname}} oder Dollar-Syntax ${propertyname}
    • Beide Formate unterstützen flexible Leerzeichen: {{ firstname }} und ${ firstname } funktionieren
  2. Versteckte Zeichen entfernen

    • Manchmal werden versteckte Formatierungszeichen in dein Dokument kopiert
    • Wenn ein Platzhalter nicht ersetzt wird, lösche ihn vollständig und tippe ihn neu ein
    • Kopiere Eigenschafts-Platzhalter direkt von der Properties-Seite in PDF CreateMate
    • Verwende beim Einfügen "Als einfachen Text einfügen" (Strg+Umschalt+V), um versteckte Formatierung zu vermeiden
  3. Eigenschaftsnamen verifizieren

    • Eigenschaftsnamen müssen exakt mit internen HubSpot-Namen übereinstimmen
    • Verwende HubSpots Eigenschaftseinstellungen, um den genauen internen Namen zu finden
    • Eigenschaftsnamen unterscheiden Groß-/Kleinschreibung
  4. Eigenschaftszuordnung überprüfen

    • Gehe zu deinen Template-Einstellungen in PDF CreateMate
    • Verifiziere, dass jeder Platzhalter der richtigen HubSpot-Eigenschaft zugeordnet ist
  5. Sicherstellen, dass der Datensatz Daten hat

    • Der HubSpot-Datensatz muss einen Wert für die Eigenschaft haben
    • Leere Eigenschaften bleiben als Platzhalter oder werden als leer angezeigt
Verwende die Vorschaufunktion, um dein Template mit Beispieldaten zu testen, bevor du finale Dokumente generierst.

Styling- oder Bildanzeigeprobleme

Problem: Dein PDF sieht anders aus als dein Word-Template - Schriften, Bilder oder Formatierung erscheinen falsch.

Lösungen:

  1. Schriftprobleme

  2. Bildprobleme

    • Stelle sicher, dass Bilder eingebettet sind, nicht verknüpft
    • Verwende Standardformate: PNG, JPG oder GIF
    • Überprüfe die Bildauflösung (300 DPI empfohlen für Druck)
  3. Layout-Probleme

    • Vermeide komplexe Layouts mit mehreren Spalten
    • Verwende Tabellen für strukturierte Layouts
    • Halte Ränder konsistent
  4. Template erneut hochladen

    • Speichere deine DOCX mit allen Änderungen
    • Lade eine frische Kopie in PDF CreateMate hoch

Workflow-Probleme

Problem: PDFs werden nicht generiert, wenn Kontakte durch Workflows gehen.

Lösungen:

  1. Erneute Einschreibung in HubSpot aktivieren

    • Wenn ein erster Test fehlgeschlagen ist, löst der Kontakt den Workflow möglicherweise nicht erneut aus
    • HubSpot-Workflows verarbeiten jeden Datensatz standardmäßig nur einmal
    • Aktiviere Auslöser für erneute Einschreibung, damit Datensätze den Workflow erneut betreten können
    • Erfahre, wie du Auslöser für erneute Einschreibung hinzufügst →
  2. Workflow-Einschreibung überprüfen

    • Verifiziere, dass Kontakte tatsächlich in den Workflow eintreten
    • Überprüfe HubSpot-Workflow-Analysen
    • Suche nach Einschreibungsfehlern im Workflow-Verlauf
  3. Aktionskonfiguration überprüfen

    • Stelle sicher, dass die PDF CreateMate-Aktion korrekt platziert ist
    • Verifiziere die Template-Auswahl in der Aktion
  4. Berechtigungen prüfen

    • Bestätige, dass PDF CreateMate die richtigen HubSpot-Berechtigungen hat
    • Autorisiere bei Bedarf in den Einstellungen neu
  5. Credit-Guthaben überprüfen

    • Stelle sicher, dass du verfügbare Credits hast
    • Die Generierung pausiert, wenn die Credits aufgebraucht sind
Workflow-Aktionen werden asynchron ausgeführt. Gib der Dokumentengenerierung ein paar Minuten zum Abschließen.
Testtipp: Beim wiederholten Testen von Workflows mit demselben Kontakt stelle sicher, dass die erneute Einschreibung aktiviert ist, oder verwende jedes Mal einen anderen Test-Kontakt.

PDF-Dateinamen ändern

Problem: Du möchtest den generierten PDF-Dateinamen anpassen.

Lösung: PDF CreateMate unterstützt dynamische Dateibenennung:

  1. Gehe zu deinen Template-Einstellungen
  2. Finde den Abschnitt Dateibenennung
  3. Konfiguriere mit HubSpot-Eigenschaften und Text

Beispiel: Rechnung_{{dealname}}_{{closedate}}

Siehe Dateibenennung für detaillierte Anweisungen.

Template-Namen ändern

Problem: Du möchtest ein bestehendes Template umbenennen.

Lösung:

  1. Gehe zu Templates
  2. Klicke auf das Template, das du umbenennen möchtest
  3. Klicke auf den Template-Namen oder das Bearbeiten-Symbol
  4. Gib den neuen Namen ein
  5. Speichere die Änderungen

Ein Template aktualisieren

Problem: Du hast Änderungen an deiner DOCX-Datei vorgenommen und musst das Template aktualisieren.

Lösung:

  1. Nimm Änderungen an deiner lokalen DOCX-Datei vor
  2. Gehe zu Templates in PDF CreateMate
  3. Klicke auf das Template, um den Template Builder zu öffnen
  4. Gehe zum Schritt Document Source
  5. Klicke auf Change, um die Datei zu ersetzen
  6. Wähle deine aktualisierte DOCX-Datei
  7. Überprüfe Eigenschaftszuordnungen (sie werden normalerweise beibehalten)
  8. Speichere das Template
Das Hochladen einer neuen Version behält deine Eigenschaftskonfigurationen und -zuordnungen bei.

Mehrfachauswahl-Werte

So werden Mehrfachauswahl-Eigenschaften angezeigt:

Mehrfachauswahl-HubSpot-Eigenschaften (z. B. Checkboxen und Multi-Select-Felder) werden automatisch als kommaseparierte Werte im PDF formatiert. Zum Beispiel:

  • HubSpot speichert: Option1;Option2;Option3
  • PDF zeigt: Option1, Option2, Option3

Mehrfachauswahl-Werte verwenden immer Kommas mit Leerzeichen als Trennzeichen. Es gibt keine UI-Option, das Trennformat anzupassen.

Allgemeine Fehlerbehebungsschritte

Wenn du ein Problem hast:

  1. Seite aktualisieren - Beseitige temporäre Störungen
  2. HubSpot-Verbindung überprüfen - Gehe zu Einstellungen und verifiziere den Verbindungsstatus
  3. Einen anderen Browser ausprobieren - Schließe browserspezifische Probleme aus
  4. Aktuelle Änderungen überprüfen - Begann das Problem nach einer bestimmten Änderung?
  5. Unsere Statusseite überprüfen - Verifiziere keine Dienstunterbrechungen
  6. Support kontaktieren - Wenn nichts anderes funktioniert, sind wir hier, um zu helfen