iCal — abonnement en dynamische link

Het formaat iCal (.ics) is de standaard voor het delen van kalenders tussen toepassingen. Omniscol stelt elk rooster (individueel, klas, lokaal, docent) beschikbaar als iCal-abonnementslink die de gebruiker kan plakken in Google Calendar, Apple Calendar, Outlook, Thunderbird of elke andere toepassing die gestandaardiseerde kalenders leest.

Abonnementslink versus eenmalige export

Twee heel verschillende manieren van gebruik:

• Abonnementslink (aanbevolen) — een HTTPS-URL die naar Omniscol verwijst. De clienttoepassing raadpleegt die regelmatig (elk uur, elke dag, afhankelijk van de instellingen van de client) en houdt de kalender van de gebruiker doorlopend bij. Verschuift een les in Omniscol, dan ziet de gebruiker dat in zijn kalender zonder daar iets voor te hoeven doen.
• Eenmalige export — download van een .ics-bestand op een bepaald moment. Handig om te archiveren, per e-mail te delen of in te voeren in een systeem dat zich niet kan abonneren. Maar het is een momentopname: verandert het rooster, dan wordt het bestand niet bijgewerkt.

Geef de voorkeur aan de abonnementslink wanneer de eindclient een moderne toepassing is die een externe kalender kan verversen (Google Calendar, Apple Calendar, Outlook).

Uw abonnementslink ophalen

Op de schermen waar delen beschikbaar is, opent de knop Delen een venster dat het volgende kan aanbieden:

• een of meer ondertekende iCal-abonnements-URL's,
• een knop “URL kopiëren”,
• een QR-code om te scannen,
• een download van een .ics-bestand.

De URL bevat een geheim token: deel hem niet — wie hem in handen krijgt, kan het rooster binnen het bereik van de link inzien tot die verloopt of ongeldig wordt gemaakt.

Waar u een iCal genereert

De belangrijkste ingangen zijn:

• Bovenaan de module Rooster — de knop Delen kan een iCal van alle getoonde roosters genereren, een gecombineerde iCal die ze in één abonnement samenbrengt, en daarna de afzonderlijke iCal's. Deze links zijn begrensd door het getoonde schooljaar.
• Op elk getoond rooster — de titelbalk van het rooster geeft, bij het zweven met de muis, toegang tot een losse deellink voor dat rooster. De link dekt het betreffende schooljaar.
• Op de fiche van een docent — in Beheer genereert de knop Delen van de fiche de persoonlijke iCal van de docent, opgezet om op de lange termijn geldig te blijven zolang de link, het houderaccount en de gekozen vervaldatum dat toelaten.
• In de voorbeeldweergave van een kalenderrooster — in Roosterbeheer genereert de knop Delen van de voorbeeldweergave de iCal van wat wordt getoond, ook als dat rooster nog niet gepubliceerd is.

Bij elke generatie kan de gebruiker een vervaldatum vastleggen. Die datum staat gecodeerd in het token van de URL: hij verandert achteraf niet meer. Om de vervaldatum te wijzigen, moet u een nieuwe link genereren.

Net als de andere deellinks is ook de iCal gekoppeld aan het account dat hem heeft gegenereerd: een wachtwoordwijziging, een deactivering of een verwijdering van het houderaccount maakt de bijbehorende links ongeldig.

Openbare link voor een klas of een lokaal

De beheerder kan een abonnementslink genereren voor een klas of een lokaal (bijvoorbeeld om te delen met de ouders of met een externe dienst). Deze links zijn ondertekend en hebben een vervaldatum.

Zie ook Een rooster delen via een openbare link, waarin alle deelopties worden beschreven (iCal, responsieve webpagina, JSON via API).

Configuratie aan clientzijde

Google Calendar

1. Klik in Google Calendar links, naast Andere agenda's, op de + > Via URL.
2. Plak de Omniscol-abonnements-URL.
3. De kalender verschijnt met een indicatief label en een standaardkleur — beide te wijzigen.

Google ververst het abonnement ongeveer elke 8-24 uur. Bij dringende wijzigingen: houd rekening met een vertraging.

Apple Calendar (macOS, iOS)

1. Archief > Nieuw agenda-abonnement.
2. Plak de Omniscol-URL.

De iCal-link van Omniscol is ingesteld op een automatische verversing om het halfuur.

Outlook (Microsoft 365)

1. Agenda toevoegen > Van internet.
2. Plak de Omniscol-URL.

Outlook werkt bij met een frequentie die per versie verschilt; houd bij oudere desktopversies rekening met vertragingen.

Beperkingen

• Wijzigingen aan clientzijde (een evenement verplaatsen in Google Calendar) komen niet terug in Omniscol — het abonnement is alleen-lezen.
• De gebruiker moet een actief Omniscol-account hebben om zijn persoonlijke URL te genereren.
• De vervaldatum van de link staat in de gegenereerde URL: die wordt achteraf niet verlengd; genereer zo nodig een nieuwe link.
• Evenementen die niet in het rooster staan, worden alleen opgenomen als de deellink of het iCal-filter ze meeneemt.