Wie behebe ich Fehler beim Importieren von Kalenderdaten in "Structured"?
- Fehlerbild verstehen und erste Fehlersuche
- Dateiformat und Struktur prüfen
- Kollisionsprüfungen und Duplikate
- Zeitzonen- und Datumsprobleme lösen
- Zeichencodierung und Sonderzeichen
- Berechtigungen und API-/Systemlimits
- Logs, Fehlermeldungen und Support nutzen
- Vorbeugung und Best Practices
Fehlerbild verstehen und erste Fehlersuche
Wenn beim Importieren von Kalenderdaten in Structured Fehler auftreten, beginnen Sie damit, das genaue Fehlersymbol, die Fehlermeldung oder das Verhalten zu notieren. Prüfen Sie, ob der Importvorgang vollständig abbricht oder nur einzelne Einträge überspringt. Prüfen Sie außerdem, ob das Problem nur bei einer bestimmten Datei, einem bestimmten Format (z. B. .ics, .csv) oder bei allen Importen auftritt. Diese Informationen helfen, die Ursache einzugrenzen.
Dateiformat und Struktur prüfen
Viele Importfehler entstehen durch Formatabweichungen. Öffnen Sie die zu importierende Datei in einem Texteditor (bei .ics) oder Tabellenprogramm (bei .csv) und vergleichen Sie Struktur, Feldnamen und Trennzeichen mit den Anforderungen von Structured. Achten Sie auf korrekte Datums-/Uhrzeitformate (ISO-Format empfohlen), Zeitzonenangaben, fehlende Pflichtfelder und auf nicht-escaped Sonderzeichen (Kommas, Semikolons). Entfernen oder korrigieren Sie leere Spalten und Zeilen mit unvollständigen Einträgen.
Kollisionsprüfungen und Duplikate
Ein häufiger Grund für abgewiesene Einträge sind Konflikte mit bereits vorhandenen Terminen (gleiche ID oder gleicher Zeitstempel). Prüfen Sie, ob Structured eine Option zum Überschreiben, Zusammenführen oder Überspringen von Duplikaten anbietet. Wenn möglich, normalisieren Sie Eintrags-IDs oder entfernen Sie Identifikatoren aus der Importdatei, damit neue Einträge neu erzeugt werden.
Zeitzonen- und Datumsprobleme lösen
Unstimmige oder fehlende Zeitzonenangaben führen zu verschobenen Zeiten oder Fehlern. Stellen Sie sicher, dass alle Zeitangaben entweder in einer einheitlichen Zeitzone vorliegen oder UTC verwenden. Achten Sie auf Sommerzeit-Übergänge und auf korrekte Formatierung von Datumsfeldern (z. B. YYYY-MM-DD vs. DD.MM.YYYY). Konvertieren Sie bei Bedarf die Zeiten vor dem Import.
Zeichencodierung und Sonderzeichen
Probleme mit Umlauten oder anderen Sonderzeichen resultieren oft aus falscher Zeichencodierung (z. B. ANSI statt UTF-8). Speichern Sie die Datei in UTF-8 ohne BOM. Entfernen oder escapen Sie nicht druckbare Steuerzeichen und überprüfen Sie Felder wie Beschreibungen und Orte auf HTML/Markdown, das eventuell nicht unterstützt wird.
Berechtigungen und API-/Systemlimits
Wenn Sie über eine Schnittstelle importieren, prüfen Sie, ob Ihr API-Schlüssel ausreichend Rechte besitzt und ob Ratenlimits oder Größenbeschränkungen die Übertragung stoppen. Bei großen Dateien splitten Sie den Import in kleinere Chargen. Prüfen Sie außerdem Serverseitige Einstellungen wie Upload-Limits oder Timeout-Werte.
Logs, Fehlermeldungen und Support nutzen
Sammeln Sie relevante Log-Einträge und die exakte Fehlermeldung — diese sind essentiell zur Diagnose. Viele Systeme geben Zeilennummern oder Feldnamen an, die den fehlerhaften Eintrag lokalisieren. Nutzen Sie die Dokumentation von Structured für genaue Feldbeschreibungen. Wenn sich das Problem nicht lösen lässt, erstellen Sie ein minimales reproduzierbares Beispiel (kleine Datei mit einem oder zwei problematischen Einträgen) und wenden Sie sich an den Support mit dieser Datei, Screenshots und Logauszügen.
Vorbeugung und Best Practices
Validieren Sie Exporte vor dem Import mit einem Validator-Tool oder einem Schema-Check. Legen Sie ein Standardformat (Datumsformat, Zeitzone, UTF-8) in Ihrem Workflow fest. Führen Sie regelmäßige Testimporte in einer Sandbox durch und automatisieren Sie vorverarbeitende Schritte (Normalisierung, Duplikatprüfung, Encoding-Konvertierung), um wiederkehrende Fehler zu vermeiden.