Fehlerbehebung

Diese Anleitung hilft Ihnen bei der Lösung häufiger Probleme bei der Verwendung von PlemeoOCR in Ihren n8n-Workflows.

Häufige Probleme und Lösungen

API Key-Probleme

Problem: "Invalid API Key" Fehler

Symptome:

• Node gibt Authentifizierungsfehler zurück
• Verarbeitung schlägt sofort fehl
• Fehlermeldung erwähnt ungültigen oder fehlenden API Key

Lösungen:

1. API Key überprüfen

   • Gehen Sie zu plemeo.ai → Meine Apps → PlemeoOCR
   • Kopieren Sie den exakten API Key (keine zusätzlichen Leerzeichen)
   • Fügen Sie ihn in die n8n-Node-Konfiguration ein

2. App-Status überprüfen

   • Stellen Sie sicher, dass die PlemeoOCR-App in plemeo.ai aktiv ist
   • Überprüfen Sie, ob Ihr Abonnement aktuell ist
   • Bestätigen Sie, dass der App-Kauf erfolgreich war

Verbindungsprobleme

Problem: "Connection Timeout" oder "Network Error"

Symptome:

• Node kann keine Verbindung zum OCR-Service herstellen
• Lange Verarbeitungszeiten gefolgt von Timeout
• Netzwerkbezogene Fehlermeldungen

Lösungen:

1. Netzwerkkonfiguration überprüfen

   • Internetverbindung überprüfen
   • Sicherstellen, dass Firewall HTTPS-Verkehr erlaubt
   • Prüfen, ob Proxy-Einstellungen benötigt werden

2. Server-Einstellungen überprüfen

   • API Hostname: ai-test.plemeo.de
   • API Port: 8000
   • API Path: /process_ocr
   • Protokoll: HTTPS (Use HTTP: deaktiviert)

Dateivarbeitungsprobleme

Problem: Schlechte OCR-Ergebnisse oder niedrige Konfidenz

Symptome:

• Extrahierter Text ist verstümmelt oder falsch
• Niedrige Konfidenzwerte (< 0,7)
• Fehlender Text aus klaren Dokumenten

Lösungen:

1. Dateiqualität verbessern

   • Verwenden Sie höher aufgelöste Bilder (300+ DPI)
   • Stellen Sie guten Kontrast zwischen Text und Hintergrund sicher
   • Vermeiden Sie schiefe oder gedrehte Dokumente
   • Verwenden Sie klare, lesbare Schriftarten

2. Dateiformat-Optimierung

   • Konvertieren Sie Bilder zu PNG für bessere Qualität
   • Verwenden Sie PDF für mehrseitige Dokumente
   • Vermeiden Sie stark komprimierte JPEG-Dateien

Problem: "Unsupported File Format"

Unterstützte Formate:

• Bilder: PNG, JPG, JPEG, GIF, BMP
• Dokumente: PDF
• Nicht unterstützt: Word-Dokumente, Excel-Dateien, PowerPoint

Lösungen:

• Konvertieren Sie nicht unterstützte Formate zu PDF oder Bildern
• Verwenden Sie geeignete Konvertierungstools vor der OCR-Verarbeitung
• Überprüfen Sie, ob die Dateierweiterung dem tatsächlichen Dateityp entspricht

Node-Konfigurationsprobleme

Problem: Node in n8n nicht gefunden

Symptome:

• Kann "plemeo OCR" in der Node-Suche nicht finden
• Node erscheint, funktioniert aber nicht
• Fehlende Node-Funktionalität

Lösungen:

1. Community Node installieren

   • Überprüfen Sie, ob die PlemeoOCR Community Node installiert ist
   • Installieren Sie sie aus den n8n Community Packages falls nötig
   • Starten Sie n8n nach der Installation neu

2. HTTP Request Node verwenden

   • Falls Community Node nicht verfügbar, verwenden Sie generische HTTP Request
   • Konfigurieren Sie manuelle API-Aufrufe zum OCR-Endpunkt
   • Richten Sie ordnungsgemäße Header und Authentifizierung ein

Performance-Optimierung

Langsame Verarbeitung

Ursachen und Lösungen:

1. Große Dateien

   • Optimieren Sie Dateigrößen vor der Verarbeitung
   • Verarbeiten Sie Dateien außerhalb der Spitzenzeiten
   • Erwägen Sie Dateiaufteilung für sehr große Dokumente

2. Netzwerklatenz

   • Verarbeiten Sie Dateien näher zum Serverstandort
   • Bündeln Sie mehrere kleine Dateien zusammen
   • Verwenden Sie CDN für Dateispeicherung falls möglich

Hilfe erhalten

Bevor Sie den Support kontaktieren

Sammeln Sie Informationen:

• [ ] Exakte Fehlermeldungen
• [ ] Screenshots der Node-Konfiguration
• [ ] Beispieldateien, die bei der Verarbeitung fehlschlagen
• [ ] n8n-Version und Setup-Details
• [ ] Netzwerkkonfigurationsdetails

Support-Kanäle

1. plemeo.ai Support

   • Für API Key- und app-bezogene Probleme
   • Konto- und Abonnementprobleme
   • OCR-Service-Funktionalität

2. n8n Community

   • Workflow-Design-Fragen
   • Node-Konfigurationshilfe
   • Integrations-Best-Practices

Präventions-Best-Practices

Workflow-Design

• Testen Sie zuerst mit kleinen Dateien, bevor Sie große Stapel verarbeiten
• Implementieren Sie ordnungsgemäße Fehlerbehandlung für alle Szenarien
• Überwachen Sie Verarbeitungsmetriken regelmäßig
• Halten Sie API Keys sicher und rotieren Sie sie regelmäßig

Dateiverwaltung

• Standardisieren Sie Dateiformate für konsistente Ergebnisse
• Implementieren Sie Qualitätsprüfungen vor der OCR-Verarbeitung
• Archivieren Sie verarbeitete Dateien, um Wiederverarbeitung zu vermeiden
• Überwachen Sie Dateigrößen und Verarbeitungszeiten

Wie geht es weiter?

• Nutzungsleitfaden - Überprüfen Sie Node-Konfigurationsdetails
• Beispiel-Workflow - Sehen Sie eine funktionierende Implementierung
• Zurück zur Übersicht - Zurück zur PlemeoOCR-Hauptseite