iCal — assinatura e link dinâmico

O formato iCal (.ics) é o padrão de compartilhamento de calendários entre aplicativos. O Omniscol expõe cada horário (individual, de turma, de sala, de professor) na forma de link de assinatura iCal que o usuário pode colar no Google Calendar, no Apple Calendar, no Outlook, no Thunderbird ou em qualquer outro aplicativo que consuma calendários padronizados.

Link de assinatura vs exportação pontual

Dois usos bem diferentes:

• Link de assinatura (recomendado) — URL HTTPS que aponta para o Omniscol. O aplicativo cliente a consulta regularmente (a cada hora, todos os dias conforme os parâmetros do cliente) e mantém o calendário do usuário atualizado continuamente. Quando uma aula é deslocada no Omniscol, o usuário a vê na sua agenda sem fazer nada.
• Exportação pontual — download de um arquivo .ics em um instante determinado. Prático para arquivar, compartilhar por e-mail ou injetar em um sistema que não sabe assinar. Mas fica congelado: se o horário muda, o arquivo não é atualizado.

Prefira o link de assinatura quando o cliente final é um aplicativo moderno que sabe atualizar um calendário remoto (Google Calendar, Apple Calendar, Outlook).

Recuperar o seu link de assinatura

A partir das telas em que o compartilhamento está disponível, o botão Compartilhamento abre uma janela modal que pode oferecer:

• uma ou mais URLs de assinatura iCal assinadas,
• um botão «Copiar a URL»,
• um QR code para escanear,
• um download de arquivo .ics.

A URL contém um token secreto: não a compartilhe — quem quer que a obtenha pode ver o horário incluído no escopo do link até a expiração ou a invalidação.

Onde gerar um iCal

Os principais pontos de entrada são:

• No topo do módulo Horário — o botão Compartilhamento pode gerar um iCal de todos os horários exibidos, um iCal combinado que os reúne em uma única assinatura e, em seguida, os iCals individuais. Esses links são limitados pelo ano letivo exibido.
• Em cada horário exibido — a barra de título do horário dá acesso, ao passar o cursor, a um compartilhamento atômico desse horário. O link cobre o ano letivo em questão.
• Na ficha de um professor — em Administração, o botão Compartilhamento da ficha gera o iCal pessoal do professor, concebido para permanecer válido ao longo do tempo enquanto o link, a conta portadora e a expiração escolhida o permitirem.
• Na pré-visualização de um horário calendário — em Gestão de horários letivos, o botão Compartilhamento da pré-visualização gera o iCal do que está exibido, mesmo que esse horário ainda não esteja ativado ou publicado.

A cada geração, o usuário pode definir uma data de invalidação. Essa data é codificada no token da URL: ela não se altera depois. Para mudar a expiração, é preciso gerar um novo link.

Como os outros links de compartilhamento, o iCal também está vinculado à conta que o gerou: mudança de senha, desativação ou exclusão da conta portadora invalidam os links associados.

Link público para uma turma ou uma sala

O administrador pode gerar um link de assinatura para uma turma ou uma sala (por exemplo, para compartilhar com os pais ou com um serviço externo). Esses links são assinados e portam uma data de expiração.

Consulte também Compartilhar um horário por link público que descreve o conjunto das opções de compartilhamento (iCal, página web responsiva, JSON via API).

Configuração no lado do cliente

Google Calendar

1. No Google Calendar, à esquerda, ao lado de Outras agendas, clique no + > Usar URL.
2. Cole a URL de assinatura do Omniscol.
3. O calendário aparece com um rótulo indicativo e uma cor padrão — modificáveis.

O Google atualiza a assinatura aproximadamente a cada 8-24 horas. Modificações urgentes: prever um atraso.

Apple Calendar (macOS, iOS)

1. Arquivo > Nova assinatura de calendário.
2. Cole a URL do Omniscol.

O link iCal do Omniscol está parametrizado para uma atualização automática a cada meia hora.

Outlook (Microsoft 365)

1. Adicionar calendário > Da Internet.
2. Cole a URL do Omniscol.

O Outlook atualiza em frequência variável conforme as versões; para o desktop antigo, prever atrasos.

Limitações

• As modificações no lado do cliente (deslocar um evento no Google Calendar) não são refletidas no Omniscol — a assinatura é somente leitura.
• O usuário deve ter uma conta ativa no Omniscol para gerar a sua URL pessoal.
• A expiração do link está inscrita na URL gerada: ela não se prolonga depois; gere um novo link se necessário.
• Os eventos fora do horário são incluídos somente se o compartilhamento ou o filtro iCal os incluir.