查询课表

当前版本:

    version= V1.0

接口功能:

    用于分页获取RunLan平台课表信息。

接口地址:

    /api/v1/weekTable/queryWeekTable

请求方式:

POST

请求参数:

Body

参数名称是否必选参数类型说明/示例
selTypeInt查询类型 0:分页查询,1:列表查询
page条件必选(当isSelAll=0时必选,下同)Int页码
pageSize条件必选Int每页大小
weekOrdinalString周次(例:查询第一周,周次传入1)
timeTableIDString课表ID
classIDString班级ID
courseIDString课程ID
termIDString学期ID
departmentIDString部门ID
roomIDString教室ID
masterTeacherIDString主课教师ID
subTeacherIDString辅课教师ID

返回值说明

返回值字段类型说明
msgString提示信息
codeInt200成功,其它失败
dataObject部门信息分页结果集

result结果集返回值字段说明

返回值字段类型说明
totalInt总条数
currentInt当前页
sizeInt每页条数
rowsArray当前分页课表信息数据集
dataObject课表信息(当数据为空时为data:[])
timeTableIDString周课表ID
classIDString班级ID
classNameString班级名称
courseIDInt课程ID
courseNameInt课程名称
termID Int 学期ID
departmentIDString所属教学单位ID
departmentNameString所属教学单位名称
roomIDInt教室ID
roomNameString 教室名称
masterTeacherIDsString 主课教师IDs,多人使用半角逗号分隔
masterTeacherNamesString 主课教师姓名,多人使用半角逗号分隔
subTeacherIDsString 辅教老师IDs,多人使用半角逗号分隔
subTeacherNamesString 辅教老师姓名,多人使用半角逗号分隔
isLargeClassInt合班标识:两个相同的数字比较两个班级在一起合班上课
startWeekInt开始周
endWeekInt结束周
weekDayInt 周次,如周三- 3
sectionIndexInt 节次,如第1节课- 1
addTimeString 生成时间,格式:yyyy-MM-dd HH:mm:ss
studyTypeInt课类型:0正课1早自习2晚自习
courseDateString 上课日期,格式:yyyy-MM-dd
dataTypeInt数据类型 : 0:周课表,1:排课的课表
specialtyIDString专业ID
lessonPlanIDString原教学计划ID
applyWeekString适用周
stateInt排课状态0成功,1冲突
changeStateString操作状态:0未进行任何操作,1特殊休息日,2特殊工作日,3调课,4代课,5非工作日(周末等),6临时停课,7临时补课,8合班上课,9不在当前学期内。状态可同时存在,分割
weekOrdinalString第几周

返回结果示例(JSON)

  • 返回成功

  • 列表查询

{

    "success": true,

    "code": 200,

    "msg": "成功",

    "data": [

        {

            "timeTableID": "00022379-64D4-849B-AA83-5CD2E9E72CC7",

            "classID": "148cd798-f63b-4c03-8f3c-f4142df86396",

            "className": "2021级建筑施工五年高级1班",

            "courseID": "31370c16-2cda-4a5b-a17a-f2a0fd394260",

            "courseName": "主体结构综合实训",

            "termID": "f8634fa8-2921-45a0-805c-65e18d49b649",

            "departmentID": "c7da93b8-b676-4f9c-b386-a7680e58efa2",

            "departmentName": null,

            "roomID": "A01AF095-647A-657A-7927-78F1F045165E",

            "roomName": "3#教学楼501",

            "masterTeacherIDs": "5503b716-e741-4318-8ba2-cad31daede3d",

            "masterTeacherNames": "何润",

            "subTeacherIDs": null,

            "subTeacherNames": null,

            "isLargeClass": 0,

            "startWeek": 1,

            "endWeek": 20,

            "weekDay": 4,

            "sectionIndex": 2,

            "addTime": "2025-04-16 23:02:38",

            "studyType": null,

            "courseDate": "2025-03-06",

            "dataType": 1,

            "specialtyID": null,

            "lessonPlanID": null,

            "applyWeek": "1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20",

            "state": null,

            "changeState": "0",

            "weekOrdinal": "4"

        },

        {

            "timeTableID": "6D60AA6C-1931-80F3-D3D6-560CF3481670",

            "classID": "148cd798-f63b-4c03-8f3c-f4142df86396",

            "className": "2021级建筑施工五年高级1班",

            "courseID": "31370c16-2cda-4a5b-a17a-f2a0fd394260",

            "courseName": "主体结构综合实训",

            "termID": "f8634fa8-2921-45a0-805c-65e18d49b649",

            "departmentID": "c7da93b8-b676-4f9c-b386-a7680e58efa2",

            "departmentName": null,

            "roomID": "A01AF095-647A-657A-7927-78F1F045165E",

            "roomName": "3#教学楼501",

            "masterTeacherIDs": "5503b716-e741-4318-8ba2-cad31daede3d",

            "masterTeacherNames": "何润",

            "subTeacherIDs": null,

            "subTeacherNames": null,

            "isLargeClass": 0,

            "startWeek": 1,

            "endWeek": 20,

            "weekDay": 4,

            "sectionIndex": 1,

            "addTime": "2025-04-16 23:02:38",

            "studyType": null,

            "courseDate": "2025-03-06",

            "dataType": 1,

            "specialtyID": null,

            "lessonPlanID": null,

            "applyWeek": "1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20",

            "state": null,

            "changeState": "0",

            "weekOrdinal": "4"

        }

    ]

}

  • 分页查询

{

    "success": true,

    "code": 200,

    "msg": "成功",

    "data": {

        "total": 4,

        "current": 1,

        "size": 2,

        "rows": [

            {

                "timeTableID": "00022379-64D4-849B-AA83-5CD2E9E72CC7",

                "classID": "148cd798-f63b-4c03-8f3c-f4142df86396",

                "className": "2021级建筑施工五年高级1班",

                "courseID": "31370c16-2cda-4a5b-a17a-f2a0fd394260",

                "courseName": "主体结构综合实训",

                "termID": "f8634fa8-2921-45a0-805c-65e18d49b649",

                "departmentID": "c7da93b8-b676-4f9c-b386-a7680e58efa2",

                "departmentName": null,

                "roomID": "A01AF095-647A-657A-7927-78F1F045165E",

                "roomName": "3#教学楼501",

                "masterTeacherIDs": "5503b716-e741-4318-8ba2-cad31daede3d",

                "masterTeacherNames": "何润",

                "subTeacherIDs": null,

                "subTeacherNames": null,

                "isLargeClass": 0,

                "startWeek": 1,

                "endWeek": 20,

                "weekDay": 4,

                "sectionIndex": 2,

                "addTime": "2025-04-16 23:02:38",

                "studyType": null,

                "courseDate": "2025-03-06",

                "dataType": 1,

                "specialtyID": null,

                "lessonPlanID": null,

                "applyWeek": "1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20",

                "state": null,

                "changeState": "0",

                "weekOrdinal": "4"

            },

            {

                "timeTableID": "6D60AA6C-1931-80F3-D3D6-560CF3481670",

                "classID": "148cd798-f63b-4c03-8f3c-f4142df86396",

                "className": "2021级建筑施工五年高级1班",

                "courseID": "31370c16-2cda-4a5b-a17a-f2a0fd394260",

                "courseName": "主体结构综合实训",

                "termID": "f8634fa8-2921-45a0-805c-65e18d49b649",

                "departmentID": "c7da93b8-b676-4f9c-b386-a7680e58efa2",

                "departmentName": null,

                "roomID": "A01AF095-647A-657A-7927-78F1F045165E",

                "roomName": "3#教学楼501",

                "masterTeacherIDs": "5503b716-e741-4318-8ba2-cad31daede3d",

                "masterTeacherNames": "何润",

                "subTeacherIDs": null,

                "subTeacherNames": null,

                "isLargeClass": 0,

                "startWeek": 1,

                "endWeek": 20,

                "weekDay": 4,

                "sectionIndex": 1,

                "addTime": "2025-04-16 23:02:38",

                "studyType": null,

                "courseDate": "2025-03-06",

                "dataType": 1,

                "specialtyID": null,

                "lessonPlanID": null,

                "applyWeek": "1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20",

                "state": null,

                "changeState": "0",

                "weekOrdinal": "4"

            }

        ]

    }

}


  • 返回失败

  {

    "msg":"具体错误原因",

    "code":-999

  }

版本变更说明:

    无