获取课表数据

整合流程说明

• RunLan平台提供的课表获取接口是按周次获取当前学期的课表，支持教师、学生、教室、教学行政班四类课表。所涉及的接口及流程如下：

1. 鉴权认证接口

2. 获取组织机构信息

3. 获取学生信息

4. 获取教职工信息

5. 获取行政班信息

6. 获取教室及办公场地信息

7. 获取专业信息

8. 获取学期信息

9. 获取教学周历信息

10. 根据日期获取教学周及学期信息

11. 按周次查询课表信息

获取课表流程说明：
第一步：先根据实际需求确认通过课表接口获取那种对象类型的课表数据。

• 示例：获取教室课表数据。

第二步：在线上接口文档中找到对应的信息获取接口，接口具体调用及说明请参考开发者中心->接口文档中的相关步骤与接口说明。

• 示例：以教室为例，则需要在接口文档中找到获取教室及办公室场地信息接口，并根据接口要求传入相关参数获取到学校平台的教室信息。

第三步：在线上接口文档中找到根据日期获取教学周及学期信息接口，通过传入的日期获取周次，注意此接口是根据传入的日期获取该日期的对应的学期及周次信息，而课表接口只能获取当前学期的课表信息，所以注意传入的日期要在当前学期开始及结束时间范围内，避免出现传入日期没有获取到对应信息的情况；如果要知道每个学期的时间范围，可以通过调用获取学期信息的接口来了解各学期的时间范围。

• 示例：假如当前学期的开始时间是2019-09-02，结束日期为2010-01-10；则可传入2019-9-3，获取到的周次为1，表示第一周。

第四步：在线上接口文档中找到对应的按周次查询课表信息获取接口，根据接口说明传入对应的对象类型、对象具体值、周次等信息，获取所查询周次课表信息。

• 示例：以教室为例，因为课表接口一次只能获取一个具体对象的课表信息，如果我们要获取第一周所有教室课表数据，则可以在获取到教室信息及周次后，通过循环遍历的方式来获取所有教室的课表信息，再从返回的数据中获取自己所需的相关课表信息。

注意事项说明：

• 课表查询参数中的对象类型有一种是按教学行政班查询课表，这里的教学行政班并不是通常所说的行政班或课表展示的教学班，而是系统为了更好的适应部分学校存在同一个行政班下相同专业下分了不同专业方向，日常管理是按同一个班级管理，但上课又根据专业方向不同需要分开排课，而建立教学行政班以便更好的进行排课管理，所以要查询班级课表，是通过教学行政班来查询的，教学行政班是通过行政班信息获取接口来获取的，通过该接口可以获取到行政班信息及对应的教学行政班信息，如果一个班级只有一个专业及方向，则教学行政班也只有一个，当一个班级同一个专业存在多个专业方向时，获取到的教学行政班也是多个。

• 课表查询接口只能获取当前学期所在周次的课表信息，无法通过该接口获取历史课表信息，目前平台未提供历史课表获取接口。