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 Eigenschaften-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 Vorlageneinstellungen 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-Vorlage - 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

PDF-Layout weicht von Word ab

Problem: Das PDF stimmt nicht mit deiner Word-Datei überein: Eine Tabelle sitzt an der falschen Stelle, Spalten sind nicht ausgerichtet, Text fehlt oder das Dokument läuft auf eine zusätzliche Seite.

Warum das passiert: Word-Dateien werden von einer Konvertierungs-Engine in PDF umgewandelt, die manche Layouts etwas anders darstellen kann als Word: komplexe Tabellen, frei schwebende Textfelder und Seiten ohne unteren Rand.

Was du versuchen kannst:

  1. Gib der Seite einen kleinen unteren Rand, damit ein kleiner Unterschied keine Inhalte auf die nächste Seite schiebt.
  2. Stelle Textfelder und Bilder auf Mit Text in Zeile statt schwebend.
  3. Verwende einfache Tabellen für das Layout statt verschachtelter Tabellen oder Textfelder.
  4. Lade die aktualisierte Datei hoch und generiere einen neuen Test.
Immer noch anders? Wende dich an den Support. Wir können deine Vorlage oder dein gesamtes Konto auf eine alternative Konvertierungs-Engine auf Basis von Microsoft Office umstellen, die komplexe Word-Layouts originalgetreuer verarbeitet.

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 →
Jedes Mal, wenn ein Datensatz den Workflow erneut betritt, wird ein neues Dokument generiert und berechnet. Deaktiviere die erneute Einschreibung wieder, sobald du sie nicht mehr brauchst, und siehe Unerwarteten Credit-Verbrauch vermeiden.
  1. Workflow-Einschreibung überprüfen

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

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

    • Bestätige, dass PDF CreateMate die richtigen HubSpot-Berechtigungen hat
    • Autorisiere bei Bedarf in den Einstellungen neu
  4. 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 Vorlageneinstellungen
  2. Finde den Abschnitt Dateibenennung
  3. Konfiguriere mit HubSpot-Eigenschaften und Text

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

Siehe Dateibenennung für detaillierte Anweisungen.

Vorlagennamen ändern

Problem: Du möchtest ein bestehendes Template umbenennen.

Lösung:

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

Ein Vorlage aktualisieren

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

Lösung:

  1. Nimm Änderungen an deiner lokalen DOCX-Datei vor
  2. Gehe zu Vorlagen in PDF CreateMate
  3. Klicke auf die Vorlage, um den Vorlagen-Builder zu öffnen
  4. Gehe zum Schritt Dokumentquelle
  5. Klicke auf Ändern, um die Datei zu ersetzen
  6. Wähle deine aktualisierte DOCX-Datei
  7. Überprüfe die Eigenschaftszuordnungen (sie werden normalerweise beibehalten).
  8. Generiere im Schritt Test einen neuen Test, um das Ergebnis zu prüfen. Änderungen an einer veröffentlichten Vorlage gelten für das nächste generierte Dokument.

Google-Docs-Vorlagen: PDF CreateMate speichert eine Kopie deines Google Docs. Öffne nach dem Bearbeiten in Google Docs den Schritt Dokument der Vorlage und klicke in der Karte Dokumentquelle auf die Schaltfläche zum Neuladen (↻). PDF CreateMate lädt die aktuelle Version und aktualisiert die Platzhalter.

Schritt Dokument - die Karte Dokumentquelle mit der Schaltfläche zum Neuladen einer Google-Docs-Vorlage
Bildbeschreibung
Der Schritt Dokument einer Google-Docs-Vorlage zeigt:
- Die Platzhalteranalyse mit ungültigen, zugeordneten und nicht zugeordneten Platzhaltern
- Rechts die Karte Dokumentquelle mit einem Link zum Google Doc
- Die Schaltfläche zum Neuladen (↻) unter dem Link
- Den Hinweis, dass ein Klick das Dokument neu lädt und die Platzhalter aktualisiert

Bereits generierte Dokumente: Eine Änderung der Vorlage ändert bestehende Dokumente nicht. Um eines mit der neuen Vorlage oder den aktuellen HubSpot-Daten zu aktualisieren, generiere es neu.

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