iCal — подписка и динамическая ссылка

Формат iCal (.ics) — стандарт обмена календарями между приложениями. Omniscol предоставляет каждое расписание (личное, класса, кабинета, преподавателя) в виде ссылки-подписки iCal, которую пользователь может вставить в Google Calendar, Apple Calendar, Outlook, Thunderbird или любое другое приложение, работающее со стандартными календарями.

Ссылка-подписка и разовый экспорт

Два совершенно разных варианта:

• Ссылка-подписка (рекомендуется) — HTTPS-адрес, ведущий в Omniscol. Клиентское приложение регулярно обращается к нему (раз в час или раз в день, в зависимости от настроек клиента) и постоянно обновляет календарь пользователя. Когда занятие переносится в Omniscol, пользователь видит это в своём календаре без всяких действий.
• Разовый экспорт — скачивание файла .ics на определённый момент. Удобен для архива, отправки по почте или загрузки в систему, которая не умеет подписываться. Но этот файл статичен: если расписание изменится, файл не обновится.

Выбирайте ссылку-подписку, когда конечный клиент — современное приложение, умеющее обновлять удалённый календарь (Google Calendar, Apple Calendar, Outlook).

Как получить ссылку-подписку

На экранах, где доступна функция общего доступа, кнопка Общий доступ открывает окно, в котором могут быть:

• одна или несколько ссылок-подписок iCal с цифровой подписью,
• кнопка «Копировать URL»,
• QR-код для сканирования,
• скачивание файла .ics.

В URL содержится секретный токен: не передавайте его другим — любой, кто его получит, увидит расписание в пределах ссылки до истечения срока её действия или до её отзыва.

Где создать iCal

Основные точки входа:

• Вверху модуля Расписание — кнопка Общий доступ может создать iCal для всех показанных расписаний, объединённый iCal, который собирает их в одну подписку, а затем отдельные iCal для каждого. Эти ссылки ограничены показанным учебным годом.
• У каждого показанного расписания — в строке заголовка расписания при наведении курсора доступен общий доступ только к этому расписанию. Ссылка охватывает соответствующий учебный год.
• В карточке преподавателя — в модуле Администрирование кнопка Общий доступ в карточке создаёт личный iCal преподавателя. Он рассчитан на долгое использование, пока это позволяют ссылка, учётная запись-владелец и выбранный срок действия.
• В предпросмотре календарного расписания — в модуле Управление расписанием кнопка Общий доступ в предпросмотре создаёт iCal того, что показано на экране, даже если это расписание ещё не опубликовано.

При каждом создании пользователь может задать дату окончания действия. Эта дата закодирована в токене URL: изменить её позже нельзя. Чтобы изменить срок действия, нужно создать новую ссылку.

Как и другие ссылки общего доступа, iCal привязан к учётной записи, которая его создала: смена пароля, деактивация или удаление учётной записи-владельца делают связанные ссылки недействительными.

Публичная ссылка для класса или кабинета

Администратор может создать ссылку-подписку для класса или кабинета (например, чтобы поделиться с родителями или с внешней службой). Такие ссылки подписаны и имеют срок действия.

См. также страницу Общий доступ к расписанию по публичной ссылке, где описаны все варианты общего доступа (iCal, адаптивная веб-страница, JSON через API).

Настройка на стороне клиента

Google Calendar

1. В Google Calendar слева, рядом с пунктом Другие календари, нажмите + > Добавить по URL.
2. Вставьте URL-адрес подписки Omniscol.
3. Календарь появится с условным названием и цветом по умолчанию — их можно изменить.

Google обновляет подписку примерно раз в 8–24 часа. Для срочных изменений учитывайте задержку.

Apple Calendar (macOS, iOS)

1. Файл > Новая подписка на календарь.
2. Вставьте URL-адрес Omniscol.

Ссылка iCal из Omniscol настроена на автоматическое обновление каждые полчаса.

Outlook (Microsoft 365)

1. Добавить календарь > Из Интернета.
2. Вставьте URL-адрес Omniscol.

Частота обновления в Outlook зависит от версии; в старых настольных версиях учитывайте задержки.

Ограничения

• Изменения на стороне клиента (например, перенос события в Google Calendar) в Omniscol не передаются — подписка работает только на чтение.
• Чтобы создать свой личный URL, у пользователя должна быть активная учётная запись Omniscol.
• Срок действия ссылки записан в созданном URL: позже он не продлевается; при необходимости создайте новую ссылку.
• События, не входящие в расписание, включаются только в том случае, если их включает общий доступ или фильтр iCal.