Fehlerbehebung
Fehlerprotokolle Neu
Wenn ein Dokument nicht generiert werden kann, zeichnet PDF CreateMate detaillierte Fehlerinformationen auf, die dir bei der Diagnose des Problems helfen. Du kannst die Fehlerprotokolle für jede Vorlage direkt in der App einsehen.
Fehlerprotokolle anzeigen
- Gehe zu Vorlagen und öffne die Vorlage
- Klicke auf die Registerkarte Fehlerprotokolle
- Durchsuche die Liste der Fehler, sortiert nach den neuesten
Jeder Fehlereintrag zeigt:
| Detail | Beschreibung |
|---|---|
| Fehlercode | Eindeutige Kennung (z. B. E5001, E6001) |
| Schritt | In welchem Generierungsschritt der Fehler aufgetreten ist (z. B. „PDF-Konvertierung", „HubSpot-Upload") |
| Schweregrad | Entweder Fehler (Generierung fehlgeschlagen) oder Warnung (Generierung mit Problemen fortgesetzt) |
| Meldung | Benutzerfreundliche Beschreibung des Problems |
| Dokument | Der HubSpot-Datensatz, der den Fehler ausgelöst hat (mit Datensatz-ID und Status) |
| Zeitstempel | Wann der Fehler aufgetreten ist |
Fehler filtern
Nutze die Filter oben in der Registerkarte Fehlerprotokolle, um Ergebnisse einzugrenzen:
- Nach Schweregrad — Nur Fehler oder nur Warnungen anzeigen
- Nach Schritt — Fehler aus einem bestimmten Generierungsschritt anzeigen
- Aktualisieren — Klicke auf die Aktualisieren-Schaltfläche, um die neuesten Fehler zu laden
Die Registerkarte zeigt auch die Anzahl der Fehler in den letzten 24 Stunden für schnelle Statusüberprüfungen.
Fehler-Stufen
Die Dokumentengenerierung durchläuft mehrere Stufen. Fehler werden danach kategorisiert, wo sie aufgetreten sind:
| Stufe | Was passiert | Häufige Fehler |
|---|---|---|
| Jobinitialisierung | Template- und Konto-Validierung | Template nicht gefunden, HubSpot-Konto inaktiv |
| HubSpot-Datenabruf | Datensatz-Eigenschaften abrufen | Datensatz nicht gefunden, API-Rate limitiert, fehlende Eigenschaften |
| Kreditprüfung | Prüfung auf ausreichende Credits | Nicht genügend Credits |
| Dokumenterstellung | Dokumenten-Datensatz erstellen | Erstellung fehlgeschlagen |
| DOCX-Verarbeitung | Platzhalter ersetzen, Bilder verarbeiten | Datei nicht gefunden, Platzhalter-Ersetzung fehlgeschlagen, Bildfehler |
| PDF-Konvertierung | Konvertierung ins PDF-Format | Konvertierung fehlgeschlagen, Timeout, Datei beschädigt |
| Wasserzeichenanwendung | Wasserzeichen anwenden | Wasserzeichen-Bild nicht gefunden |
| HubSpot-Upload | Upload zu HubSpot | Upload fehlgeschlagen, Eigenschaft-Aktualisierung fehlgeschlagen |
| Signaturablauf | Signatur-Ablauf einrichten | Signatur-URL-Generierung fehlgeschlagen |
| Cloud-Synchronisierung | Upload zu Google Drive | Authentifizierung fehlgeschlagen, Ordner nicht gefunden |
Häufige Fehler und Lösungen
E2001 — HubSpot-Datensatz nicht gefunden
Ursache: Die für die Generierung verwendete HubSpot-Datensatz-ID existiert nicht oder wurde gelöscht.
Lösung: Überprüfe, ob der Datensatz in HubSpot existiert und ob der Workflow für den richtigen Objekttyp ausgelöst wird.
E3001 — Nicht genügend Credits
Ursache: Deine Organisation hat nicht genügend Credits zur Dokumentengenerierung.
Lösung: Kaufe mehr Credits unter Abrechnung in der Seitenleiste oder richte Budget-Benachrichtigungen ein, um rechtzeitig informiert zu werden.
E5001 — Vorlagendatei nicht gefunden
Ursache: Die Vorlagendatei konnte im Speicher nicht gefunden werden.
Lösung: Lade deine Vorlagendatei im Template-Builder erneut hoch.
E6001 — PDF-Konvertierung fehlgeschlagen
Ursache: Das Dokument konnte nicht in PDF konvertiert werden. Dies kann bei komplexer Formatierung oder sehr großen Dateien passieren.
Lösung: Vereinfache die Template-Formatierung, reduziere die Dateigröße oder prüfe auf nicht unterstützte Word-Funktionen. Siehe Einschränkungen für Details.
E8001 — HubSpot-Upload fehlgeschlagen
Ursache: Die generierte Datei konnte nicht zu HubSpot hochgeladen werden.
Lösung: Überprüfe deine HubSpot-Verbindung und stelle sicher, dass die Speicher-Eigenschaft noch existiert.
E10001 — Cloud-Sync-Authentifizierung fehlgeschlagen
Ursache: Die Google Drive-Authentifizierung ist fehlgeschlagen, meist weil das Service-Konto keinen Zugriff mehr hat.
Lösung: Teile deinen Google Drive-Ordner erneut mit dem Service-Konto. Siehe Cloud-Sync-Einrichtung.
Fehler vs. Warnungen
- Fehler bedeuten, dass die Dokumentengenerierung fehlgeschlagen ist. Das Problem muss behoben werden, bevor das Dokument erstellt werden kann.
- Warnungen bedeuten, dass das Dokument generiert wurde, aber etwas Unerwartetes aufgetreten ist (z. B. eine unkritische Eigenschaft konnte nicht aktualisiert werden). Das Dokument kann trotzdem nutzbar sein.
Tipps
- Überprüfe die Fehlerprotokolle nach Massengenerierungen — Wenn einige Dokumente in einem Batch fehlschlagen, zeigen die Fehlerprotokolle genau, welche Datensätze Probleme hatten und warum
- Verwende Fehlercodes beim Kontaktieren des Supports — Fehlercodes (z. B. E6001) helfen unserem Team, Probleme schneller zu diagnostizieren
- Überwache die 24-Stunden-Anzahl — Ein plötzlicher Anstieg der Fehler kann auf ein HubSpot-API-Problem oder eine Konfigurationsänderung hinweisen
Verwandte Dokumentation
- Häufige Probleme — Lösungen für häufig auftretende Probleme
- FAQ — Schnelle Antworten auf häufige Fragen
- HubSpot-Verbindung — HubSpot-Verbindung prüfen und verwalten
- Support — Unser Support-Team kontaktieren