这个品类的数据长什么样
培训机构教务排课与消课场景,材料主要有课表、消课记录、调课申请三类。课表来自教务系统排课导出,字段含课程、班级、教师、教室、周次、节次、生效日期;消课记录来自签到或教师确认,字段含学员、课程、消课日期、课时数、签字或回执;调课申请来自审批流,字段含原课次、目标日期、原因、审批状态与签字。更新节奏上,课表按周或按调课结果刷新,消课记录按次产生,调课申请随审批节点推进。材料进入问答受理与缺项补问功能时,课表用于核对排课事实,消课记录用于核对已消课时与签字,调课申请用于核对日期与审批回执。三类材料字段口径需对齐,同一记录的名称、数量、日期要能互相印证。
配置怎么定
这一环由工作流里的 HTTP 节点执行,输出响应体、状态码与返回字段。「受理记录与补齐的问项」由后续节点解析响应,或外部系统按约定处理接着完成。HTTP 模块向目标地址发请求,路径参数、请求体与请求头三处都能用变量占位,变量来自全局变量、系统变量或前方节点输出。
| 对象 | 判断 | 核验动作 |
|---|---|---|
| 课表 | 课程、班级、教师、教室、周次、节次、生效日期与签字是否齐全,同一课次在调课申请与课表中的日期是否一致 | 在请求预览里看渲染后的完整地址,核对路径参数与请求体字段,用一条样例请求比对返回 |
| 消课记录 | 学员、课程、消课日期、课时数、签字或回执是否完整,同一记录在消课记录与课表中的名称、数量、日期是否对得上 | 核对请求头名称与取值来源,确认 Authorization 按外部系统要求传入,检查 variables 中每个占位的出处 |
| 调课申请 | 原课次、目标日期、原因、审批状态与签字是否齐全,版本是否与最新课表同步 | 用一条样例请求比对返回,检查 responseData 返回字段是否覆盖受理记录与补齐的问项所需字段 |
| 变量来源 | 每个占位都能追到具体出处,请求体字段与外部接口约定一致 | 在变量面板核对每个占位的来源,确认全局变量、系统变量或前方节点输出可解析成实际值 |
容易做错的三处
- 现象:请求返回 401。原因:
Authorization取值来源与外部系统要求不一致,鉴权信息未按约定传入。 - 现象:外部系统收到空字段。原因:同一记录在课表与消课记录里的名称、数量、日期对不上,占位变量未解析成实际值。
- 现象:请求超时。原因:调课申请版本未同步,目标地址或路径参数指向了过期接口,返回字段无法覆盖受理记录与补齐的问项。
怎么确认配好了
本功能验收:预览渲染后的请求,核状态码与返回字段,再对一条样例比对结果;检查 variables 中每个占位的来源,确认 Authorization 与 responseData 的取值符合外部接口约定。
业务测试:提一个缺关键信息的问句,看是否先追问再作答。
- 在请求预览里看渲染后的完整地址,核对路径参数、请求头与请求体字段是否与外部接口约定一致。
- 在变量面板核对每个占位的来源,确认全局变量、系统变量或前方节点输出可解析成实际值。