管理日历接入指南 nbsp;.pdf

管理日历接入指南 钉钉供微应用接入管理日历的能力。目前处于测试阶段，为了 保证接入的质量以及良好的用户体验，接入方需要与钉钉管理日历团 队协商接入方案。 由于不同接入方的业务不完全一致，如果接入方希望以与本文档 不同的形式接入，可以向我们出合作邀请，我们也供定制化接入 支持。（联系邮箱：pstar.zhangp@ ） 管理日历目前已接入多个微应用，例如：签到、审批、考勤、日 志、拜访计划等。 1 管理日历模块 管理日历目前包括4 个主要模块： 1 、 按部门维度的数据统计 2 、 按部门维度的数据统计接入控制 3 、 按个人维度的日历 4 、 按个人维度的日历接入控制 1.1 按部门维度的数据统计 管理日历部门维度的数据模型核心思想是：事件+快照。即 某公司的某人，从A 时间开始到B 时间结束，发生了某个事件, 例如： 1. 钉钉有限公司的张三，从2015.11.10 到2015.11.12 发 生一次请假3 天的事件。 2. 钉钉有限公司的李四，在 2015.11.10 早上 8 点整发生 一次签到事件。 按部门维度的数据统计示意图如下： 图中红色框内是用户在该公司的所有部门，点击可切换（如 果该用户是企业 OA 后台管理员、管理日历微应用管理员、企 业老板，则默认展示根部门的数据）； 图中绿色框是固定的样式和展示，所有接入的微应用都以 该样式展示，点击“进入首页”会跳转到微应用首页； 图中橙色框是接入方和管理日历约定好的展示样式。目前 管理日历支持5 类固定的展示样式，参考第2 小节 （如果接入 方需要其他方式的展示，可以向钉钉团队出）： 1.2 按部门维度的数据统计接入控制 管理日历中有2 个属性：appId 和subAppId，其中appId 述某个微应用，subAppId 述该微应用下的某种数据类型。 举例说明：对于内勤打卡微应用而言，appId 是”1”，它在 管理日历中接入了 4 种子类型的数据：已打卡/未打卡/迟到/ 早退，那么就对应4 个subAppId 。 接入方需要向管理日历出接入申请，subAppId 由管理日 历分配给接入方。 1.3 按个人维度的日历 个人维度的日历是参考 RFC2445 icalendar 国际标准的简 易实现版。其主要包括3 个部分：事件+重复+醒。 数据模型如下： userid 用户身份标识 summary 标题 location 地点 starttime 起始时间 endtime 结束时间 url 跳转的url appId 微应用的标识 subAppId 子数据类型 originId 事件在接入方内的唯一id description 备注 1.4 按个人维度的日历接入控制 个人日历中也有appId 和subAppId 的概念。参考1.2 小节。 2 管理日历客户端样式规范 目前管理日历支持5 类固定的展示样式，如果接入方需要其 他方式的展示，可以向钉钉团队出。 3