这个品类的数据长什么样
培训机构教务排课与消课场景中,进度记录与统计核对依赖三类材料:课表、消课记录、调课申请。课表由教务在排课环节生成,含课程名称、教师、教室、上课日期与时段;消课记录由任课教师或教务在课后登记,含学员、课程、消课日期与数量;调课申请由申请方发起,含原课次、目标课次、调课原因与签字或回执。材料按周更新,月末汇总进周报或月报。三类材料进入 HTTP 接口与外部系统时角色不同:课表作为基准数据提供课次与日期口径,消课记录作为发生数据提供实际消课数量,调课申请作为例外数据提供调整依据。字段特征上,同一课次在三份材料中的名称、数量、日期需能对齐,签字或回执需齐全,版本需同步。
配置怎么定
这一环由工作流里的 HTTP 节点执行,输出响应体、状态码与返回字段。进度表与统计口径说明由后续节点解析响应,或外部系统按约定处理接着完成。
| 对象 | 判断 | 核验动作 |
|---|---|---|
| 课表 | 课程名称、教师、教室、上课日期与时段是否与消课记录、调课申请逐项对齐,签字或回执是否齐全 | 在请求预览里看渲染后的完整地址,核对路径参数与请求体字段,确认课表字段与外部接口约定一致 |
| 消课记录 | 消课日期、消课数量与学员信息是否与课表课次对应,同一记录在两份材料里的名称、数量、日期是否对得上 | 核对 variables 面板中每个占位的来源,确认消课记录字段取自前方节点输出,再用一条样例请求比对返回 |
| 调课申请 | 原课次与目标课次是否与课表、消课记录一致,调课原因与签字或回执是否写清,版本是否同步 | 核对请求头名称与取值来源,确认 Authorization 按外部系统要求传入,检查调课申请字段是否随请求体发出 |
| 变量来源 | 每个占位都能追到具体出处,responseData 返回字段与统计口径说明所需字段一致 | 在变量面板核对每个占位的来源,确认全局变量、系统变量或前方节点输出可解析成实际值 |
容易做错的三处
- 现象:同一课次在课表与消课记录中的名称、数量、日期对不上。原因:两份材料各自登记,未按同一口径核对,字段未对齐。
- 现象:调课申请缺签字或回执,统计时无法确认例外。原因:申请流程未闭环,签字或回执未随材料同步。
- 现象:请求返回 401,外部系统收到空字段。原因:
Authorization取值来源有误,或请求体字段未按接口约定传入。
怎么确认配好了
本功能验收:预览渲染后的请求,核状态码与返回字段,再对一条样例比对结果。
业务测试:用一周记录核对合计,看口径与例外是否写清。
- 在请求预览里看渲染后的完整地址,核对路径参数、请求头与请求体中的占位变量能否解析成实际值。
- 在变量面板核对每个占位的来源,确认
variables与responseData的取值出处可追溯。