选课排课与教室资源调度的问答受理与缺项补问:HTTP 接口

围绕选课排课与教室资源调度的问答受理与缺项补问,说明HTTP 接口与外部系统的配置前提与核对动作,结合开课计划、排课表确认结果传递与生效状态,附上线前的验证步骤。

这个品类的数据长什么样

选课排课与教室资源调度场景里,进入问答受理与缺项补问环节的材料主要有三类:开课计划、排课表、选课规则。开课计划给出课程名称、班级数量、开课日期与院系签字;排课表给出教室、时段、周次与调停课记录;选课规则给出容量、优先级、冲突判定与生效版本。材料通常由教务或院系按学期批次提交,开学前集中更新,学期中按调课、补选节奏增量同步,字段以课程代码、教室编号、日期区间、版本号、签字与回执为主。三类材料在功能里角色不同:开课计划与选课规则作为受理依据与追问来源,排课表作为教室资源占用的比对底稿,缺项与不一致在此处被识别并形成待补问项。

配置怎么定

这一环由工作流里的 HTTP 节点执行,输出响应体、状态码与返回字段。「受理记录与补齐的问项」由后续节点解析响应,或外部系统按约定处理接着完成。请求地址、路径参数、请求头与请求体中的占位变量,来自全局变量、系统变量或前方节点输出;鉴权信息按外部系统要求放入请求头。

对象判断核验动作
开课计划课程名称、班级数量、开课日期与签字是否与排课表、选课规则对得上取同一课程代码在两份材料中的名称、数量、日期逐项比对,缺签字或回执的记为待补项
排课表教室、时段、周次与版本是否同步,调停课是否留痕核教室编号与周次区间,比对版本号与调课回执,不一致的转承办人处理
选课规则容量、优先级与生效版本是否与当前学期一致核生效日期与版本号,确认规则字段与外部接口约定一致,缺项先追问再作答
HTTP 请求请求地址、请求头与请求体中的占位变量能否解析成实际值在请求预览里看渲染后的完整地址,用 variables 面板追每个占位来源,核 Authorization 与 responseData 返回字段

容易做错的三处

  • 现象:同一课程在两份材料里的名称或班级数量对不上。原因:开课计划与排课表各自维护,未按同一课程代码核对。
  • 现象:选课规则版本未同步,按旧容量受理。原因:新版规则未带生效日期与版本号,追问时未比对。
  • 现象:调课缺签字或回执,教室占用对不上。原因:调停课记录只在一侧留痕,另一侧未回执确认。

怎么确认配好了

本功能验收:预览渲染后的请求,核状态码与返回字段,再对一条样例比对结果,确认 variables、Authorization、responseData 与约定一致。

业务测试:提一个缺关键信息的问句,看是否先追问再作答。

  • 在请求预览里核对渲染后的完整地址、请求头名称与取值来源,确认占位变量能解析成实际值。
  • 用一条样例请求比对返回字段与外部接口约定,把缺项与不一致整理成受理记录,转承办人处理。