iCal——订阅与动态链接

iCal（.ics）格式是各应用之间共享日历的标准。Omniscol可将每份课表 （个人、班级、教室、教师）生成iCal订阅链接，用户可将其粘贴到 Google Calendar、Apple Calendar、Outlook、Thunderbird 或任何支持标准日历的应用中。

订阅链接与一次性导出

两种用法差别很大：

• 订阅链接（推荐）——指向Omniscol的HTTPS网址。客户端应用会定期访问它 （每小时或每天，取决于客户端设置），并持续更新用户的日历。 Omniscol中的课时一旦调整，用户无需任何操作即可在日历中看到变化。
• 一次性导出——在某一时刻下载一份 .ics 文件。适合存档、通过邮件分享， 或导入不支持订阅的系统。但它是固定不变的：课表变化后，文件不会更新。

当最终使用的客户端是能刷新远程日历的现代应用 （Google Calendar、Apple Calendar、Outlook）时，请优先选择订阅链接。

获取您的订阅链接

在支持分享的界面中，点击分享按钮， 会打开一个窗口，其中可能提供：

• 一个或多个带签名的iCal订阅网址，
• “复制网址”按钮，
• 可扫描的二维码，
• .ics 文件下载。

网址中包含保密令牌：请勿分享——任何获得该网址的人， 在链接到期或失效之前，都能看到链接范围内的课表。

在哪里生成iCal

主要入口有：

• 课表模块顶部——分享按钮 可为所有显示的课表生成iCal，包括把它们合并到同一个订阅中的合并iCal， 以及各份课表单独的iCal。这些链接的范围限定在当前显示的学年内。
• 每份显示的课表上——将鼠标悬停在课表标题栏上，即可为该份课表单独分享。 链接涵盖相应的学年。
• 教师详情中——在管理中，教师详情里的 分享按钮可生成该教师的个人iCal， 只要链接、所属账户和所选有效期允许，它就会长期有效。
• 预览日历课表时——在课表管理中，预览里的 分享按钮可为当前显示的内容生成iCal， 即使该课表尚未发布也可以。

每次生成时，用户都可以设置失效日期。该日期已编码在网址的令牌中： 事后无法修改。若要更改有效期，需要重新生成链接。

与其他分享链接一样，iCal也与生成它的账户绑定： 所属账户修改密码、被停用或被删除，相关链接都会失效。

班级或教室的公开链接

管理员可以为班级或教室生成订阅链接（例如分享给家长或外部部门）。 这些链接带有签名和有效期。

另请参见通过公开链接分享课表，其中介绍了全部分享方式 （iCal、自适应网页、通过API获取JSON）。

客户端设置

Google Calendar

1. 在Google Calendar的侧边栏中，点击其他日历旁的 + > 通过网址添加。
2. 粘贴Omniscol订阅网址。
3. 日历会以一个提示性名称和默认颜色显示，二者都可修改。

Google大约每8至24小时刷新一次订阅。 紧急的修改需要预留一段延迟。

Apple Calendar（macOS、iOS）

1. 文件 > 新建日历订阅。
2. 粘贴Omniscol网址。

Omniscol的iCal链接设置为每半小时自动刷新一次。

Outlook（Microsoft 365）

1. 添加日历 > 从Internet订阅。
2. 粘贴Omniscol网址。

Outlook的更新频率因版本而异；旧版桌面客户端需要预留延迟。

限制

• 在客户端所做的修改（例如在Google Calendar中移动事件） 不会同步回Omniscol——订阅是只读的。
• 用户必须拥有有效的Omniscol账户，才能生成个人网址。
• 链接的有效期写在生成的网址中：事后无法延长； 如有需要，请重新生成链接。
• 课表以外的事件，仅在分享或iCal筛选条件包含它们时才会出现。