iCal — abbonamento e link dinamico

Il formato iCal (.ics) è lo standard per la condivisione di calendari tra applicazioni. Omniscol espone ogni orario (individuale, di classe, di aula, di professore) sotto forma di link di abbonamento iCal che l'utente può incollare in Google Calendar, Apple Calendar, Outlook, Thunderbird o in qualsiasi altra applicazione che consumi calendari standardizzati.

Link di abbonamento vs export puntuale

Due usi molto diversi:

• Link di abbonamento (consigliato) — URL HTTPS che punta a Omniscol. L'applicazione client lo consulta regolarmente (ogni ora, ogni giorno a seconda delle impostazioni del client) e aggiorna il calendario dell'utente in modo continuo. Quando una lezione si sposta in Omniscol, l'utente la vede nel proprio calendario senza fare nulla.
• Export puntuale — download di un file .ics in un dato momento. Comodo per archiviare, condividere via e-mail, o alimentare un sistema che non è in grado di abbonarsi. Ma è statico: se l'orario cambia, il file non viene aggiornato.

Preferisca il link di abbonamento quando il client finale è un'applicazione moderna in grado di aggiornare un calendario remoto (Google Calendar, Apple Calendar, Outlook).

Recuperare il proprio link di abbonamento

Dalle schermate in cui la condivisione è disponibile, il pulsante Condivisione apre una finestra modale che può proporre:

• uno o più URL di abbonamento iCal firmati,
• un pulsante «Copia l'URL»,
• un codice QR da scansionare,
• il download di un file .ics.

L'URL contiene un token segreto: non lo condivida — chiunque lo ottenga può vedere l'orario incluso nell'ambito del link fino alla scadenza o all'invalidazione.

Dove generare un iCal

I principali punti di accesso sono:

• In alto nel modulo Orario — il pulsante Condivisione può generare un iCal di tutti gli orari visualizzati, un iCal combinato che li unisce in un unico abbonamento, e poi gli iCal individuali. Questi link sono delimitati dall'anno scolastico visualizzato.
• Su ogni orario visualizzato — la barra del titolo dell'orario dà accesso, al passaggio del mouse, a una condivisione atomica per quell'orario. Il link copre l'anno scolastico interessato.
• Sulla scheda di un professore — in Amministrazione, il pulsante Condivisione della scheda genera l'iCal personale del professore, concepito per restare valido nel tempo finché il link, l'account titolare e la scadenza scelta lo consentono.
• In anteprima di un orario calendario — in Gestione degli orari, il pulsante Condivisione dell'anteprima genera l'iCal di ciò che è visualizzato, anche se quell'orario non è ancora attivato o pubblicato.

A ogni generazione, l'utente può fissare una data di invalidazione. Questa data è codificata nel token dell'URL: non si modifica in seguito. Per cambiare la scadenza, occorre generare un nuovo link.

Come gli altri link di condivisione, l'iCal è anch'esso legato all'account che l'ha generato: il cambio di password, la disattivazione o l'eliminazione dell'account titolare invalidano i link associati.

Link pubblico per una classe o un'aula

L'amministratore può generare un link di abbonamento per una classe o un'aula (per esempio per condividerlo con i genitori o con un servizio esterno). Questi link sono firmati e portano una data di scadenza.

Vedere anche Condividere un orario tramite link pubblico che descrive l'insieme delle opzioni di condivisione (iCal, pagina web responsive, JSON tramite API).

Configurazione lato client

Google Calendar

1. In Google Calendar, a sinistra, accanto ad Altri calendari, fare clic sul + > Da URL.
2. Incollare l'URL di abbonamento Omniscol.
3. Il calendario appare con un'etichetta indicativa e un colore predefinito — modificabili.

Google aggiorna l'abbonamento all'incirca ogni 8-24 ore. Modifiche urgenti: prevedere un ritardo.

Apple Calendar (macOS, iOS)

1. File > Nuovo abbonamento a un calendario.
2. Incollare l'URL Omniscol.

Il link iCal Omniscol è impostato per un aggiornamento automatico ogni mezz'ora.

Outlook (Microsoft 365)

1. Aggiungi calendario > Da Internet.
2. Incollare l'URL Omniscol.

Outlook aggiorna con una frequenza variabile a seconda delle versioni; per il desktop più datato, prevedere ritardi.

Limitazioni

• Le modifiche lato client (spostare un evento in Google Calendar) non vengono ripercosse in Omniscol — l'abbonamento è in sola lettura.
• L'utente deve avere un account Omniscol attivo per generare il proprio URL personale.
• La scadenza del link è iscritta nell'URL generato: non si prolunga in seguito; generi un nuovo link se necessario.
• Gli eventi al di fuori dell'orario vengono inclusi solo se la condivisione o il filtro iCal li include.