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 jedes Template direkt in der App einsehen.
Fehlerprotokolle anzeigen
- Gehe zu Templates und öffne das Template
- 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-Properties abrufen | Datensatz nicht gefunden, API-Rate limitiert, fehlende Properties |
| 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, Property-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 — Template-Datei nicht gefunden
Ursache: Die Template-Datei konnte im Speicher nicht gefunden werden.
Lösung: Lade deine Template-Datei 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-Property 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 Property 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