# 电子班牌
# 业务场景
学校安装的电子班牌，希望与校宝智慧校园对接，从而实现在电子班牌中查看班级人员、课表、学生考勤、学生请假等数据。
# 对接流程
# 1、接入前准备
# 2、从校宝智慧校园获取通迅录数据并绑定
学校在校宝智慧校园中维护班级、学生、教师等通迅录信息，硬件系统调用校宝智慧校园开放接口，从校宝智慧校园中获取这些通迅录数据，并建立绑定关系，从而实现通迅录数据的自动同步，避免学校在两个系统中重复维护通迅录数据。
通迅录接口：
通过订阅事件，实时同步通讯录信息：
# 3、从校宝智慧校园获取课表数据
学校在校宝智慧校园中排课，电子班牌系统调用校宝智慧校园开放接口，从校宝智慧校园中获取班级课表、教师课表、学生课表、场地课表数据，从而实现在电子班牌中显示这些课表。
以获取班级课表为例，主要对接流程如下：
1）调用获取班级课表列表接口，接口将返回所请求的班级当前学期“已生效”状态的课表
在校宝智慧校园中，是允许每个班级排多张课表的，因此你有可能通过这个接口获取某个班级课表时不止返回了一张课表，如何确认这个班级当前在用哪一张课表呢？推荐按以下流程来判断：
- 确认学校在校宝智慧校园中如何使用排课功能，如果学校正常使用时每个班级“已生效”状态的课表应当只有一张，那么请学校在校宝智慧校园中将其他不应该生效的课表操作取消生效，这样直接通过接口取每个班级“已生效”状态的课表来做同步就行了
- 如果学校在校宝智慧校园中某个班级“已生效”状态的课表确实就需要有多张，那么根据学校具体情况，你可以通过以下两种方式来判断该班级当前在用哪张课表：
- 一是可以让学校在校宝智慧校园中将当前在用的课表设置为“默认课表”，那么你可以通过接口返回的“是否默认课表”参数来判断
- 二是比如学校9月1日至10月31日用一张课表，11月1日至12月31日用另一张课表，那么你可以通过接口返回的“生效开始日期”和“生效结束日期”来判断
2）调用获取作息时间表接口，接口将返回所请求的课表使用的作息时间表数据，那么你就可以“绘制”出课表格子了
3）调用获取班级课表详情接口，接口将返回所请求班级、所请求课表的每个“课表格子”的课程信息，这样你就已经获取到具体班级在用的完整课表数据了
需要注意的是，每个“课表格子”有可能会返回不止一个课程信息，比如学校某节课统一开兴趣课，所有行政班的学生打乱到各个兴趣班中上课，那么获取某个行政班的课表时，这个“课程格子”将返回这节课在开的所有兴趣课信息，同时也将返回这个“课程格子”的名称（一般学校会直接命名为“兴趣课”），那么你可以根据班牌系统中的需要，显示这节课所有兴趣课信息，或只显示这个“课程格子”的名称。
课表接口：
通过订阅事件，实时同步课表信息：
# 4、电子班牌中还有以下功能可以通过对接校宝智慧校园实现
在电子班牌中显示学校在校宝智慧校园中创建的校历、活动信息。
校历接口：
活动接口：
在电子班牌中显示学校在校宝智慧校园中创建的学生考勤、学生请假信息。
考勤接口：
请假接口：
通过订阅事件，实时同步考勤、请销假信息：