Terminformate
Auf dieser Seite

Terminformate

Kalenderquellen werden über HTTPS oder webcal:// abgerufen. Unterstützt werden iCalendar/ICS, jCal, xCal und RSS 2.0 mit Veranstaltungszeiten sowie die unten beschriebenen JSON- und CSV-Feeds. Außerdem lassen sich bestimmte Schema.org-Events als JSON-LD einlesen. Das Format wird am Inhalt erkannt; eine bestimmte Dateiendung ist nicht notwendig. Ein Feed muss über seine Adresse lesbar sein. Lokale Dateiuploads und die Anmeldung an CalDAV-Servern werden nicht unterstützt. Hinweise zu Netzwerkzugriff, Synchronisation und Geheimhaltung stehen in Betrieb.

ICS, jCal und xCal unterstützen Serien und Ausnahmen im dokumentierten Umfang. Das eigene JSON- und CSV-Schema sowie Schema.org-JSON-LD beschreiben einzelne Termine; Serien müssen darin als einzelne Termine geliefert werden. Die Kennung id muss pro Quelle eindeutig sein und bei späteren Änderungen des Termins gleich bleiben, damit Antworten zugeordnet bleiben. Der Server validiert den gesamten Feed. Bei einem Fehler bleibt der bisherige Datenstand erhalten.

jCal und xCal

jCal (RFC 7265) und xCal (RFC 6321) sind JSON- und XML-Darstellungen von iCalendar. Der Import unterstützt einen begrenzten Teilumfang, einschließlich Terminen, unterstützten Serien und Ausnahmen. Der bestehende ICS-Parser bestimmt die Grenzen für Serien und Zeitzonen. Nicht unterstützte terminrelevante Konstrukte führen zu einem Fehler statt zu einem teilweisen Import. iCalendar-Eigenschaften ohne Entsprechung im Terminmodell werden nicht übernommen.

Schema.org-Events als JSON-LD

Der Import akzeptiert einzelne Schema.org-Events, Arrays oder @graph-Listen mit unterstützten Event-Typen. Erwartet werden eine stabile Kennung (@id, identifier oder url), name, startDate und endDate. Uhrzeiten benötigen einen Zeitzonenoffset. Für reine Datumsangaben gilt das Enddatum als letzter Veranstaltungstag; intern wird es in ein exklusives Ganztagsende umgerechnet. EventScheduled und EventCancelled werden unterstützt; Ortsangaben können als Text oder einfacher Place mit Adresse vorliegen.

EventSeries, Terminpläne, untergeordnete Termine, verschobene oder vertagte Veranstaltungen und andere nicht eindeutig abbildbare Zeitangaben werden abgewiesen. Externe JSON-LD-Kontexte und Referenzen werden nicht geladen. Es wird JSON-LD selbst als Feed erwartet, keine HTML-Seite mit eingebettetem Markup.

RSS 2.0 mit Terminen

RSS beschreibt üblicherweise Beiträge. Damit ein RSS-Eintrag eindeutig als Termin übernommen werden kann, benötigt er eine stabile guid (alternativ link), einen title und Veranstaltungsbeginn und -ende. Diese stehen in der Erweiterung urn:terminverwaltung:event:1 als startDate und endDate mit RFC-3339-Zeitstempel oder als Datum YYYY-MM-DD. Zusätzlich werden startdate, enddate und location aus den Event-Namensräumen http://purl.org/rss/1.0/modules/event/ und http://purl.org/rss/2.0/modules/event/ unterstützt, sofern Anfang und Ende eindeutig sind. Ein Ganztags-Enddatum ist exklusiv. zone, allDay, status, location und description in diesem Namensraum sind optional; für status gelten confirmed und cancelled. Beispiel:

<rss version="2.0" xmlns:event="urn:terminverwaltung:event:1">
  <channel><title>Verein</title><link>https://example.org/</link><description>Termine</description>
    <item><guid isPermaLink="false">fest-2028</guid><title>Vereinsfest</title>
      <event:startDate>2028-06-10</event:startDate><event:endDate>2028-06-11</event:endDate>
    </item>
  </channel>
</rss>

pubDate bezeichnet den Veröffentlichungszeitpunkt und wird nicht als Veranstaltungszeit interpretiert. Fehlt eine Veranstaltungszeit bei einem Eintrag, schlägt der gesamte Abgleich fehl und der bisherige Stand bleibt erhalten. Der RSS-Export enthält dieselbe Erweiterung für den erneuten Import; gewöhnliche RSS-Reader zeigen Titel, Terminzeit und Beschreibung an.

JSON als Quelle

Ein JSON-Objekt mit events oder ein Array solcher Termine wird akzeptiert:

{
  "events": [
    {
      "id": "training-2027-06-10",
      "title": "Training",
      "start": "2027-06-10T18:00:00+02:00",
      "end": "2027-06-10T20:00:00+02:00",
      "location": "Vereinsheim",
      "description": "Bitte Hallenschuhe mitbringen",
      "status": "confirmed"
    }
  ]
}

id, title, start und end sind erforderlich. description, location, zone, status und allDay sind optional. status ist confirmed oder cancelled und standardmäßig confirmed. Uhrzeiten werden als RFC-3339-Zeitstempel mit Zeitzone angegeben. Ganztagstermine verwenden für Beginn und Ende YYYY-MM-DD; das Enddatum ist exklusiv. Optional bezeichnet zone eine IANA-Zeitzone wie Europe/Berlin; bei Ganztagsterminen ist dies auch der Standard, bei Uhrzeiten ist der Standard UTC. allDay, falls angegeben, muss zum Datumsformat passen.

CSV als Quelle

UTF-8-CSV verwendet Komma als Trennzeichen, eine Kopfzeile und die gleichen Feldnamen. Felder mit Komma oder Zeilenumbruch müssen nach CSV-Regeln in doppelte Anführungszeichen gesetzt werden.

id,title,start,end,location
training-2027-06-10,Training,2027-06-10T18:00:00+02:00,2027-06-10T20:00:00+02:00,Vereinsheim
fest-2027-06-12,Vereinsfest,2027-06-12,2027-06-13,Vereinsheim

Neben den Pflichtspalten sind allDay, zone, status, description und location zulässig. Eine leere Terminliste besteht aus der Kopfzeile ohne Datenzeilen.

Ausgabe

Öffentliche und persönliche Feeds stehen als ICS, jCal, xCal, RSS, JSON und CSV zur Verfügung. Auf der Seite Kalenderabo können jCal, xCal, RSS, JSON und CSV heruntergeladen werden. Angemeldete Mitglieder können ihre sichtbaren Termine herunterladen, ohne ein Kalenderabo zu erzeugen oder zu erneuern. Ein persönlicher Link gewährt Zugriff auf die für das Mitglied sichtbaren Termine und ist wie der persönliche ICS-Link geheim zu halten. Ein neuer persönlicher Abolink entwertet alle Formate des vorherigen Links. Rückmeldungen und private Nachrichten sind in keinem der Formate enthalten.

Die eigenen JSON- und CSV-Formate verwenden das oben beschriebene Schema und können als Quelle für eine andere Installation dienen. CSV-Ausgaben entschärfen Felder, die von Tabellenprogrammen als Formel interpretiert werden könnten; dadurch kann sich ihr Text beim erneuten Import unterscheiden. Für einen verlustärmeren Austausch eignet sich JSON.