Kalenderfreigaben

Kalenderfreigaben ermöglichen es, Datensätze aus Listen als Termine in persönlichen Kalendern anzuzeigen. Die Funktion ist auch als Kalender-Abonnement bekannt. Da Kalenderfreigaben Daten ohne zusätzliche Authentifizierung bereitstellen, können sie nur von Besitzern und Administratoren eingerichtet werden.

Kompatibilität

Kalenderfreigaben werden von allen gängigen Kalenderanwendungen unterstützt:

Anwendung Aktualisierung Manuelle Aktualisierung
Apple Kalender Intervall einstellbar (5 min – wöchentlich) ja¹
Outlook Automatisch + manuell ja
Google Kalender Automatisch nein

¹ Über Ansicht → Kalender aktualisieren werden alle Kalender gemeinsam aktualisiert, inklusive abonnierter — ein separater Button pro Kalender existiert nicht. (Quelle: Apple Support)

Als Richtwert kann davon ausgegangen werden, dass Kalenderfreigaben ein- bis zweimal täglich aktualisiert werden.

Offizielle Einrichtungsanleitungen:

Event-Eigenschaften

Für jede Kalenderfreigabe können folgende Eigenschaften konfiguriert werden. Als Eingabe werden technische Namen von Bausteinen oder Formeln erwartet.

  1. Event Startzeit (Pflicht, Datum) — Startzeitpunkt des Events
  2. Event Endzeit (Pflicht, Datum) — Endzeitpunkt des Events
  3. Event Titel (Pflicht, Text) — Titel des Events
  4. Ganztages-Event (Ja/Nein/Formel) — bei Formel muss true oder false zurückgegeben werden
  5. Event Beschreibung (optional, Text) — Beschreibung des Events
  6. Event Standort (optional, Text) — Ort des Events

Events, bei denen Startzeit, Endzeit oder Titel keinen Wert zurückgeben, werden nicht im Kalender angezeigt. Die Endzeit darf nicht vor der Startzeit liegen.

Credits und Limitierungen

Für das Abrufen von Kalenderfreigaben wird der gleiche Credit-Satz berechnet wie für die REST-API V2. Da jeder Nutzer, der die Freigabe eingebunden hat, regelmäßige Abrufe auslöst, sollte die Anzahl der zurückgegebenen Datensätze möglichst gering gehalten werden.

Ein empfohlener Filter, der nur die aktuelle, vorherige und nächste Woche zurückgibt:

Startzeit - Woche in [subtractWeeks(currentWeek,1),currentWeek,addWeeks(currentWeek,1)]

Technisches Limit: maximal 3000 Datensätze pro Kalenderfreigabe.

Weiterlesen: Import und Export