Tutorial: Heimat-Info App – Fehler beim Import von Veranstaltungen per ICS-Datei beheben
Das Importieren von Veranstaltungskalendern über das Standard-Format ICS (iCalendar) spart Vereinen, Gemeinden und Organisationen in der Heimat-Info App viel Zeit. Gelegentlich kommt es jedoch zu Fehlermeldungen, Termine werden fehlerhaft dargestellt oder der Import bricht komplett ab.
In dieser Anleitung erfahren Sie Schritt für Schritt, woran der Fehler meist liegt und wie Sie Ihre ICS-Datei so anpassen, dass der Import reibungslos funktioniert.
Häufige Fehlerursachen im Überblick
- Falsche Zeichencodierung (Umlaute wie ä, ö, ü oder das ß führen zum Abbruch).
- Fehlende Pflichtfelder in der Kalenderdatei.
- Inkompatibler HTML-Code in den Terminbeschreibungen.
- Zu große Dateien (zu viele Termine auf einmal).
- Fehlerhafte Zeitzonen-Definitionen.
Schritt-für-Schritt-Anleitung zur Fehlerbehebung
Schritt 1: Datei auf UTF-8-Codierung prüfen (Der häufigste Fehler)
Die Heimat-Info App benötigt Dateien, die im Format UTF-8 codiert sind. Wurde die ICS-Datei aus älteren Programmen exportiert, liegt sie oft im Format ANSI oder ISO-8859-1 vor. Dadurch werden Sonderzeichen und deutsche Umlaute nicht erkannt und der Import scheitert.
So beheben Sie es:
- Klicken Sie mit der rechten Maustaste auf die
.ics-Datei auf Ihrem Computer. - Wählen Sie Öffnen mit > Editor (Windows) bzw. TextEdit (Mac).
- Gehen Sie auf Datei > Speichern unter….
- Wählen Sie unten bei Codierung die Option UTF-8 (nicht UTF-8 mit BOM, sondern reines UTF-8).
- Speichern Sie die Datei ab und versuchen Sie den Import erneut.
Schritt 2: Pflichtfelder im ICS-Code kontrollieren
Jeder Termin in einer ICS-Datei muss bestimmte Standard-Felder enthalten. Fehlt auch nur eines davon bei einem einzelnen Termin, schlägt der gesamte Import fehl.
Öffnen Sie die Datei im Texteditor und prüfen Sie, ob jeder Terminblock (BEGIN:VEVENT bis END:VEVENT) folgende Zeilen enthält:
UID:(Eine eindeutige Kennung für den Termin)DTSTAMP:(Erstellungszeitpunkt)DTSTART:(Startdatum und -uhrzeit)DTEND:(Enddatum und -uhrzeit)SUMMARY:(Titel der Veranstaltung)
Beispiel für einen sauberen Minimal-Termin:
BEGIN:VEVENT
UID:termin-12345@beispiel.de
DTSTAMP:DatumUndUhrzeit
DTSTART:DatumUndUhrzeit
DTEND:DatumUndUhrzeit
SUMMARY:Jahreshauptversammlung
DESCRIPTION:Beschreibung des Termins ohne Sonderzeichen
LOCATION:Bürgerhaus
END:VEVENT
Schritt 3: HTML-Formatierungen und Sonderzeichen entfernen
Einige Kalenderprogramme (wie Microsoft Outlook oder Google Calendar) packen Formatierungen wie Fettschrift, Tabellen oder Links als HTML-Code in das Feld DESCRIPTION:.
- Die Heimat-Info App erwartet in der Regel reinen Text (Plain Text).
- Lösung: Entfernen Sie HTML-Tags wie
<p>,<br>,<b>oder Link-Fragmente (<a href=...>) aus den Beschreibungen in der Textdatei oder exportieren Sie den Kalender im Quellprogramm ohne Rich-Text-Formatierung.
Schritt 4: Datei teilen (Größe reduzieren)
Wenn Sie versuchen, das komplette Jahresprogramm mit hunderten Terminen auf einmal hochzuladen, kann es zu einem Timeout (Zeitüberschreitung) der Schnittstelle kommen.
- Teilen Sie die ICS-Datei in mehrere kleinere Abschnitte auf (z. B. Quartalsweise oder Monat für Monat).
- Achten Sie darauf, dass jede geteilte Datei oben mit
BEGIN:VCALENDARbeginnt und ganz unten mitEND:VCALENDARendet.
Schritt 5: ICS-Datei online validieren
Wenn der Fehler weiterhin besteht, können Sie die Datei mit einem kostenlosen Online-Tool prüfen lassen, um die genaue Zeile des Fehlers zu finden:
- Suchen Sie im Webbrowser nach einem „iCalendar Validator“.
- Laden Sie Ihre
.ics-Datei dort hoch oder fügen Sie den Text ein. - Das Tool zeigt Ihnen exakt an, in welcher Zeile sich Syntaxfehler (z. B. ein vergessenes Komma oder ein unerlaubter Zeilenumbruch) befinden.
- Korrigieren Sie die entsprechende Zeile im Texteditor.
Schnelle Checkliste vor dem erneuten Upload:
- [ ] Ist die Datei als UTF-8 gespeichert?
- [ ] Haben alle Termine einen Titel (SUMMARY) sowie Start- und Endzeit?
- [ ] Wurden störende HTML-Befehle aus den Beschreibungen gelöscht?
- [ ] Enthält die Datei nicht zu viele Termine auf einmal?
Nach Durchführung dieser Schritte sollte der Import in der Heimat-Info App ohne Fehlermeldung funktionieren. Sollte es dennoch haken, wenden Sie sich mit der bereinigten ICS-Datei an den Support von Heimat-Info, um systemspezifische Einschränkungen abzuklären.