iCal — subskrypcja i dynamiczny link

Format iCal (.ics) to standard wymiany kalendarzy między aplikacjami. Omniscol udostępnia każdy plan lekcji (indywidualny, klasy, sali, nauczyciela) w postaci linku subskrypcji iCal, który użytkownik może wkleić do Google Calendar, Apple Calendar, Outlooka, Thunderbirda albo dowolnej innej aplikacji czytającej ustandaryzowany kalendarz.

Link subskrypcji a eksport jednorazowy

Dwa bardzo różne zastosowania:

• Link subskrypcji (zalecany) — adres URL w protokole HTTPS wskazujący na Omniscol. Aplikacja kliencka odpytuje go regularnie (co godzinę, codziennie — zależnie od jej ustawień) i na bieżąco aktualizuje kalendarz użytkownika. Gdy w Omniscol lekcja zmieni pozycję, użytkownik widzi to w swoim kalendarzu, nie robiąc nic.
• Eksport jednorazowy — pobranie pliku .ics w danej chwili. Przydatny do archiwizacji, do przesłania pocztą elektroniczną albo do wprowadzenia do systemu, który nie potrafi subskrybować. Ale jest to migawka: jeśli plan lekcji się zmieni, plik nie zostanie zaktualizowany.

Proszę wybrać link subskrypcji, gdy klientem końcowym jest nowoczesna aplikacja potrafiąca odświeżać zdalny kalendarz (Google Calendar, Apple Calendar, Outlook).

Uzyskiwanie linku subskrypcji

Na ekranach, na których udostępnianie jest dostępne, przycisk Udostępnianie otwiera okno dialogowe, w którym mogą się pojawić:

• jeden lub kilka podpisanych adresów URL subskrypcji iCal,
• przycisk „Kopiuj adres URL”,
• kod QR do zeskanowania,
• pobranie pliku .ics.

Adres URL zawiera tajny token: proszę go nie udostępniać — każdy, kto go zdobędzie, może zobaczyć plan lekcji objęty zakresem linku, aż do wygaśnięcia albo unieważnienia.

Gdzie wygenerować iCal

Główne punkty wejścia to:

• U góry modułu Plany lekcji — przycisk Udostępnianie może wygenerować iCal wszystkich wyświetlanych planów lekcji, wspólny iCal, który łączy je w jedną subskrypcję, a następnie iCal osobno dla każdego z nich. Te linki są ograniczone do wyświetlanego roku szkolnego.
• Na każdym wyświetlonym planie lekcji — pasek tytułu planu daje po najechaniu kursorem dostęp do udostępnienia tego jednego planu. Link obejmuje odpowiedni rok szkolny.
• Na karcie nauczyciela — w module Administracja przycisk Udostępnianie na karcie generuje osobisty iCal nauczyciela, zaprojektowany tak, by pozostawał ważny długo — dopóki pozwalają na to sam link, konto wystawiające i wybrana data wygaśnięcia.
• W podglądzie planu lekcji w trybie kalendarzowym — w module Zarządzanie planami lekcji przycisk Udostępnianie podglądu generuje iCal tego, co jest wyświetlone, nawet jeśli ten plan nie został jeszcze opublikowany.

Przy każdym generowaniu użytkownik może ustalić datę unieważnienia. Data jest zapisana w tokenie adresu URL: później już się nie zmienia. Aby zmienić termin wygaśnięcia, należy wygenerować nowy link.

Podobnie jak pozostałe linki udostępniania, iCal jest powiązany z kontem, które go wygenerowało: zmiana hasła, dezaktywacja albo usunięcie konta wystawiającego unieważnia powiązane z nim linki.

Link publiczny dla klasy albo sali

Administrator może wygenerować link subskrypcji dla klasy albo dla sali (na przykład po to, by udostępnić plan rodzicom albo podmiotowi zewnętrznemu). Takie linki są podpisane i mają datę wygaśnięcia.

Zob. także Udostępnianie planu lekcji linkiem publicznym, gdzie opisano wszystkie opcje udostępniania (iCal, responsywna strona internetowa, JSON przez API).

Konfiguracja po stronie klienta

Google Calendar

1. W Google Calendar w panelu bocznym, obok Inne kalendarze, proszę kliknąć + > Z adresu URL.
2. Proszę wkleić adres URL subskrypcji Omniscol.
3. Kalendarz pojawia się z orientacyjną nazwą i domyślnym kolorem — jedno i drugie można zmienić.

Google odświeża subskrypcję co około 8-24 godziny. W razie pilnych zmian trzeba liczyć się z opóźnieniem.

Apple Calendar (macOS, iOS)

1. Plik > Nowa subskrypcja kalendarza.
2. Proszę wkleić adres URL Omniscol.

Link iCal Omniscol jest ustawiony na automatyczne odświeżanie co pół godziny.

Outlook (Microsoft 365)

1. Dodaj kalendarz > Z internetu.
2. Proszę wkleić adres URL Omniscol.

Outlook aktualizuje dane z częstotliwością zależną od wersji; w starej wersji na komputer trzeba liczyć się z opóźnieniami.

Ograniczenia

• Zmiany po stronie klienta (przesunięcie wydarzenia w Google Calendar) nie wracają do Omniscol — subskrypcja jest tylko do odczytu.
• Aby wygenerować swój osobisty adres URL, użytkownik musi mieć aktywne konto Omniscol.
• Termin wygaśnięcia linku jest zapisany w wygenerowanym adresie URL: później już się nie przedłuża; w razie potrzeby proszę wygenerować nowy link.
• Wydarzenia spoza planu lekcji są uwzględniane tylko wtedy, gdy obejmuje je udostępnienie albo filtr iCal.